diff --git a/docs/PEERING_GUIDE.md b/docs/PEERING_GUIDE.md new file mode 100644 index 00000000..57b5aea5 --- /dev/null +++ b/docs/PEERING_GUIDE.md @@ -0,0 +1,20 @@ +# Peering configuration guide + +This guide provides tips on configuring peer connections for Base nodes. + +## Finding peers + +- Use `admin_peers` on the execution client to see current peers. +- Share your node's ENR with trusted peers to establish direct connections. + +## Adjusting peer limits + +- The `maxpeers` flag controls the maximum number of peers your node will accept. +- Lower values reduce bandwidth usage; higher values improve network robustness. + +## NAT and firewalls + +- Open TCP/UDP ports 30303–30305 on your router for inbound connections. +- Ensure your node advertises the correct public IP by setting `--nat extip:`. + +Keep this document updated as the network evolves.