package p2p

Get desktop application:
View/edit binary Protocol Buffers messages

Announces that a piece is available to other peers.

Used in: Message

• int32 index = 2

Binary set of all pieces that peer has downloaded so far. Also serves as a handshaking message, which each peer sends once at the beginning of the connection to declare what their peer id is and what info hash they want to transmit.

Used in: Message

• string infoHash = 2

• string name = 3

  TODO: Torrent name is the content hash. Current torrent storage is content addressable. Adding name as a part of handshake makes looking up torrents faster. If storage supports addressing torrent by infohash, this extra field should removed. XXX(codyg): We rely on this name field for announcing too, so tracker can look up origins that have this content. We currently treat infohash as verification of torrents.

• string peerID = 4

• bytes bitfieldBytes = 5

• string namespace = 6

• map<string, bytes> remoteBitfieldBytes = 7

  remoteBitfieldBytes contains the binary sets of pieces downloaded of all peers that the sender is currently connected to.

Unused.

Used in: Message

• int32 index = 2

Notifies other peers that the torrent has completed and all pieces are available.

Used in: Message

(message has no fields)

General purpose error message. Receivers may check the error code to determine the origin of the message.

Used in: Message

• string error = 2

• int32 index = 3

• ErrorMessage.ErrorCode code = 4

Used in: ErrorMessage

• PIECE_REQUEST_FAILED = 0

• string version = 1

• Message.Type type = 2

• optional BitfieldMessage bitfield = 3

• optional PieceRequestMessage pieceRequest = 4

• optional PiecePayloadMessage piecePayload = 5

• optional AnnouncePieceMessage announcePiece = 6

• optional CancelPieceMessage cancelPiece = 7

• optional ErrorMessage error = 8

• optional CompleteMessage complete = 9

Used in: Message

• BITFIELD = 0

• PIECE_REQUEST = 1

• PIECE_PAYLOAD = 2

• ANNOUCE_PIECE = 3

• CANCEL_PIECE = 4

• ERROR = 5

• COMPLETE = 6

Provides binary payload response to a peer request. Always immediately followed by a binary blob sent over socket, so the receiver should be ready to treat the blob as a non-protobuf message.

Used in: Message

• int32 index = 2

• int32 offset = 3

  Unused.

• int32 length = 4

  Unused.

• string digest = 5

  Cryptographic signature of a piece content (sha1, md5).

Requests a piece of the given index. Note: offset and length are unused fields and if set, will be rejected.

Used in: Message

• int32 index = 2

• int32 offset = 3

  Unused.

• int32 length = 4

  Unused.