diff --git a/docs/vocs/docs/pages/sdk/node-components/network.mdx b/docs/vocs/docs/pages/sdk/node-components/network.mdx index f9af6f5ddc0..210a3af965f 100644 --- a/docs/vocs/docs/pages/sdk/node-components/network.mdx +++ b/docs/vocs/docs/pages/sdk/node-components/network.mdx @@ -41,15 +41,28 @@ The network uses multiple discovery mechanisms to find and connect to peers: ### Protocol Support - **ETH Protocol**: Core Ethereum wire protocol for blocks and transactions - + +### Network Mode +- **PoS networks**: Block broadcasting is disabled and considered a protocol violation. New blocks are obtained from the consensus layer and requested over devp2p. +- **PoW networks**: Block announcements are enabled to help propagate new blocks quickly. + ### Message Broadcasting The network efficiently propagates new blocks and transactions to peers using: - Transaction pooling and deduplication - Block announcement strategies - Bandwidth management +Note: In PoS networks, block broadcasting is disabled and considered a protocol violation. New blocks are obtained via the consensus layer (CL) and requested over devp2p. In PoW mode, block announcements are enabled. + +### Transaction Gossip Control +- A `tx_gossip_disabled` flag can be used to disable transaction gossip end-to-end. +- This is useful for private nodes, bandwidth-constrained deployments, or setups that rely on out-of-band transaction ingestion. + +### NAT and External IP Resolution +- Optional NAT resolver support helps determine and advertise the correct external IP and port for discovery and inbound connectivity. + ## Next Steps - Learn about the [Transaction Pool](/sdk/node-components/pool) - Understand [Consensus](/sdk/node-components/consensus) integration -- Explore [RPC](/sdk/node-components/rpc) server setup \ No newline at end of file +- Explore [RPC](/sdk/node-components/rpc) server setup