Protocols¶

• Protocol core-core
• Protocol core-GUI

There is two main protocols, one between cores and one between GUI and core. Both used protocol buffers for describing the exchanged messages.

Each data sent over the network (using TCP or UDP) are formatted like this :

<messageType:uint32><size:uint32><serializedMessage>

• messageType is a number which determine the message type, more information in the proto files.
• size is the size of the following serialized message.
• serializedMessage is the data serialized by protocol buffer.

Links to resource¶

Links can be shared across peers. It locates a remote resource like folder or file from a specific peer. It doesn't contain any chunk hash, thus the peer must be online to download a file or a folder.

ayb://[<peer name>][:<file id>][:<shared id>/<folder>/<file>]

• <peer name> : Not required and not used to locate the resource, just an information for the user.
• <file id> : its the n first group of nibble of the m first chunk where n * m = 40 nibbles (20 octets).
  • 20,87cace382f7371cd3fab3cb0a53b93b7cd9719f6 : 20 chunks of 2 nibbles.
  • 8,05649bcbf065e0d032ada540d4a749d98db055cf : 8 chunks of 5 nibbles.
• <shared id> : Contains only the beginning of the hash.

Character encoding¶

TODO..

Examples¶

• ayb://20,87cace382f7371cd3fab3cb0a53b93b7cd9719f6
• ayb://pierre:20,87cace382f7371cd3fab3cb0a53b93b7cd9719f6
• ayb://pierre:20,87cace382f7371cd3fab3cb0a53b93b7cd9719f6:dac4f75c/my%20movies/LOLCat.avi
• ayb://pierre:dac4f75c/my%20movies/LOLCat.avi
• ayb://pierre:dac4f75c/my%20movies