Skip to content

Commit

Permalink
docs: update networking page
Browse files Browse the repository at this point in the history
  • Loading branch information
nflaig committed Jan 12, 2024
1 parent aa87c54 commit 9fe07d8
Showing 1 changed file with 15 additions and 13 deletions.
28 changes: 15 additions & 13 deletions docs/pages/beacon-management/networking.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Networking

Starting up Lodestar will automatically connect it to peers on the network. Peers are found through the discv5 protocol and once peers are established communications happen via gossipsub over libp2p. While not necessary, having a basic understanding of how the various protocols and transport work will help with debugging and troubleshooting as some of the more common challenges come up with [firewalls](#firewall-management) and [NAT traversal](#nat-traversal).
Lodestar will automatically start connecting to peers on startup. Those peers are found through the discv5 protocol and once peers are established communications happen via gossipsub over libp2p. While not necessary, having a basic understanding of how the various protocols and transports work will help with debugging and troubleshooting as some of the more common challenges come up with [firewalls](#firewall-management) and [NAT traversal](#nat-traversal).

## Networking Flags

Expand Down Expand Up @@ -42,6 +42,10 @@ The primary purpose of ENRs is to facilitate node discovery and connectivity in

Note that bootnodes are announced via ENR.

Lodestar prints out its own ENR on startup, or it can alternatively be retrieved from the beacon node API by querying the [getNetworkIdentity](https://ethereum.github.io/beacon-APIs/#/Node/getNetworkIdentity) endpoint.

[ENR Viewer](https://enr-viewer.com/) provides a simple and convenient option to decode and inspect ENRs.

## Peer Communication (gossipsub and ReqResp)

Gossipsub and ReqResp are the two mechanisms that beacon nodes use to exchange chain data. Gossipsub is used disseminate the most recent relevant data proactively throughout the network. ReqResp is used to directly ask specific peers for specific information (eg: during syncing).
Expand Down Expand Up @@ -70,20 +74,18 @@ If your setup is behind a firewall there are a few ports that will need to be op

Ports that should be opened:

- 30303/TCP+UDP - Execution layer p2p communication port
- 9000/TCP+UDP - Beacon Node P2P communication port
- 9090/TCP - Lodestar IPv6 P2P communication port
- 13000/TCP - Prysm P2P communication port
- 12000/UDP - Prysm P2P communication port
- 30303/TCP+UDP - Execution layer P2P communication port
- 9000/TCP+UDP - Beacon node IPv4 P2P communication port
- 9090/TCP+UDP - Beacon node IPv6 P2P communication port

Ports that should be inbound protected:
Ports that should be protected:

- 9596/TCP - Lodestar Beacon-Node JSON RPC api calls
- 5062/TCP - Lodestar validator key manager api calls
- 18550/TCP - Lodestar MEV Boost/Builder port
- 8008/TCP - Lodestar Metrics
- 5064/TCP - Validator Metrics
- 8545/TCP - Execution client JSON RPC port api calls
- 9596/TCP - Beacon node API port
- 5062/TCP - Validator key manager API port
- 18550/TCP - MEV-boost/Builder port
- 8008/TCP - Beacon node metrics port
- 5064/TCP - Validator metrics port
- 8545/TCP - Execution client JSON RPC port
- 8551/TCP - Execution engine port for Lodestar to communicate with the execution client

## NAT Traversal
Expand Down

0 comments on commit 9fe07d8

Please sign in to comment.