* "transaction_id" (string): the unique id of the transaction, generated by node making the request (a.k.a the querying node). Same transaction_id is echoed back by responding nodes. Usually a short string of binary numbers.
* "client_version" (string): string which identifies the type and version of the bittorrent-dht client. Some implementations may be missing this field.
Extra fields:
~~~~~~~~~~~~~
Packets should also contain one of either the fields:
| error
* "error": details of an error which occurred while processing the request
* "error.num" (num): the error code
* "error.msg" (string): the error message
| request_type and request
* "request_type" (string): the type of the request (a.k.a. the query). Included if this packet was a request
* "request": a request (a.k.a. a query) sent by the bittorrent-dht client
* "request.id" (string): the node ID of the node which sent the request (20-byte string in network byte order)
* "request.target" (string): the target node ID. Used by the find_node request_type
* "request.info_hash" (string): info hash of target torrent (20-byte string). Used by the get_peers and announce_peer request_types
* "request.token" (string): token key received from previous get_peers request. Used by the announce_peer request type
* "request.implied_port" (num): 0 or 1, if 1 ignore provided port and use source port of UDP packet. Used by the announce_peer request_type
* "request.port" (num): port on which peer will download torrent. Used by the announce_peer request_type
| response
* "response": a response to the client's request
* "response.id" (string): the node ID of the node which sent the response (20-byte string in network byte order)
* "response.nodes" (string): find_node/get_peers - compact node info for target node or K(8) closest good nodes in routing table
* "response.values" (array): list of compact peer info strings. Used by the get_peers request_type
Aaron Bungay
4 years ago
committed by
Victor Julien