Peer Exchange

Channels

Pex has one channel. The channel identifier is listed below.

Name	Number
PexChannel	0

Message Types

The current PEX service has two versions. The first uses IP/port pair but since the p2p stack is moving towards a transport agnostic approach, node endpoints require a Protocol and Path hence the V2 version uses a url instead.

PexRequest

PexRequest is an empty message requesting a list of peers.

EmptyRequest

PexResponse

PexResponse is an list of net addresses provided to a peer to dial.

Name	Type	Description	Field Number
addresses	repeated PexAddress	List of peer addresses available to dial	1

PexAddress

PexAddress provides needed information for a node to dial a peer.

Name	Type	Description	Field Number
id	string	NodeID of a peer	1
ip	string	The IP of a node	2
port	port	Port of a peer	3

PexRequestV2

PexRequest is an empty message requesting a list of peers.

EmptyRequest

PexResponseV2

PexResponse is an list of net addresses provided to a peer to dial.

Name	Type	Description	Field Number
addresses	repeated PexAddressV2	List of peer addresses available to dial	1

PexAddressV2

PexAddress provides needed information for a node to dial a peer.

Name	Type	Description	Field Number
url	string	See golang url	1

Message

Message is a oneof protobuf type. The one of consists of two messages.

Name	Type	Description	Field Number
pex_request	PexRequest	Empty request asking for a list of addresses to dial	1
pex_response	PexResponse	List of addresses to dial	2
pex_request_v2	PexRequestV2	Empty request asking for a list of addresses to dial	3
pex_response_v2	PexRespinseV2	List of addresses to dial	4