Skip to content

drafted extra network troubleshooting - #779

Merged
rolfyone merged 2 commits into
Consensys-Incorporated:mainfrom
rolfyone:troubleshoot-network
Aug 7, 2026
Merged

rolfyone merged 2 commits into
Consensys-Incorporated:mainfrom
rolfyone:troubleshoot-network

Conversation

@rolfyone

@rolfyone rolfyone commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

I'm not sure if this is the best way to represent this information but at least as a placeholder, having the query here to get the ports in use by a node at runtime can be particularly useful when debugging, so I feel like we should add it to this documentation.

I've left as draft because I don't feel like its exactly what we want, and I think someone may have cleaner ideas.


Note

Low Risk
Documentation-only changes with no runtime or security impact.

Overview
Improves P2P port documentation and network troubleshooting for operators debugging connectivity.

In p2p-networking.md, the port table now includes default ports (9000 TCP/discovery, 9001 QUIC) plus short guidance on listen vs advertised options, how discovery tracks --p2p-port, and IPv6 defaults (9090 / 9091).

In network.md, peering troubleshooting adds a Check ports flow using GET /eth/v1/node/identity (curl/jq), sample p2p_addresses / discovery_addresses, and how multiaddr paths map to --p2p-port, --p2p-quic-port, and --p2p-udp-port, including advertised-port vs listen-port behavior. Inbound/outbound peer checks are split into their own section (still via /eth/v1/node/peers), with firewall guidance moved after that and default port numbers called out explicitly.

Reviewed by Cursor Bugbot for commit df8c117. Bugbot is set up for automated code reviews on this repo. Configure here.

@vercel

vercel Bot commented Aug 6, 2026

Copy link
Copy Markdown

@rolfyone is attempting to deploy a commit to the Consensys Team on Vercel.

A member of the Team first needs to authorize it.

@alexandratran alexandratran self-assigned this Aug 6, 2026
@vercel

vercel Bot commented Aug 6, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
doc-teku Ready Ready Preview Aug 6, 2026 11:33pm

Request Review

@alexandratran
alexandratran marked this pull request as ready for review August 6, 2026 23:34
@alexandratran
alexandratran requested a review from a team as a code owner August 6, 2026 23:34
@alexandratran

Copy link
Copy Markdown
Contributor

@rolfyone

rolfyone commented Aug 7, 2026

Copy link
Copy Markdown
Contributor Author

Thats a lot better, thankyou for that!

@rolfyone
rolfyone merged commit fd18893 into Consensys-Incorporated:main Aug 7, 2026
12 checks passed
@rolfyone
rolfyone deleted the troubleshoot-network branch August 7, 2026 08:37
@github-actions github-actions Bot locked and limited conversation to collaborators Aug 7, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants