Lighthouse REST API: /network

The /network endpoints provide information about the p2p network that Lighthouse uses to communicate with other beacon nodes.

Endpoints

HTTP PathDescription
/network/peer_idGet a node's libp2p PeerId.
/network/peersList a node's libp2p peers (as PeerIds).
/network/enrGet a node's discovery ENR address.

/network/peer_id

Requests the beacon node's local PeerId.

HTTP Specification

PropertySpecification
Path/network/peer_id
MethodGET
JSON EncodingString (base58)
Query ParametersNone
Typical Responses200

Example Response

"QmVFcULBYZecPdCKgGmpEYDqJLqvMecfhJadVBtB371Avd"

/network/peers

Requests one MultiAddr for each peer connected to the beacon node.

HTTP Specification

PropertySpecification
Path/network/peers
MethodGET
JSON Encoding[String] (base58)
Query ParametersNone
Typical Responses200

Example Response

[
	"QmaPGeXcfKFMU13d8VgbnnpeTxcvoFoD9bUpnRGMUJ1L9w",
	"QmZt47cP8V96MgiS35WzHKpPbKVBMqr1eoBNTLhQPqpP3m"
]

network/enr

Requests the beacon node for its listening ENR address.

HTTP Specification

PropertySpecification
Path/network/enr
MethodGET
JSON EncodingString (base64)
Query ParametersNone
Typical Responses200

Example Response

"-IW4QPYyGkXJSuJ2Eji8b-m4PTNrW4YMdBsNOBrYAdCk8NLMJcddAiQlpcv6G_hdNjiLACOPTkqTBhUjnC0wtIIhyQkEgmlwhKwqAPqDdGNwgiMog3VkcIIjKIlzZWNwMjU2azGhA1sBKo0yCfw4Z_jbggwflNfftjwKACu-a-CoFAQHJnrm"