NetworkArgs in reth_node_core::args

NetworkArgs in reth_node_core::args - Rust

Struct NetworkArgs

pub struct NetworkArgs {Show 32 fields
    pub discovery: DiscoveryArgs,
    pub trusted_peers: Vec<TrustedPeer>,
    pub trusted_only: bool,
    pub bootnodes: Option<Vec<TrustedPeer>>,
    pub dns_retries: usize,
    pub peers_file: Option<PathBuf>,
    pub identity: String,
    pub p2p_secret_key: Option<PathBuf>,
    pub p2p_secret_key_hex: Option<B256>,
    pub no_persist_peers: bool,
    pub nat: NatResolver,
    pub addr: IpAddr,
    pub port: u16,
    pub max_outbound_peers: Option<usize>,
    pub max_inbound_peers: Option<usize>,
    pub max_peers: Option<usize>,
    pub max_concurrent_tx_requests: u32,
    pub max_concurrent_tx_requests_per_peer: u8,
    pub max_seen_tx_history: u32,
    pub max_pending_pool_imports: usize,
    pub soft_limit_byte_size_pooled_transactions_response: usize,
    pub soft_limit_byte_size_pooled_transactions_response_on_pack_request: usize,
    pub max_capacity_cache_txns_pending_fetch: u32,
    pub net_if: Option<String>,
    pub tx_propagation_policy: TransactionPropagationKind,
    pub tx_ingress_policy: TransactionIngressPolicy,
    pub disable_tx_gossip: bool,
    pub propagation_mode: TransactionPropagationMode,
    pub required_block_hashes: Vec<BlockNumHash>,
    pub network_id: Option<u64>,
    pub netrestrict: Option<String>,
    pub enforce_enr_fork_id: bool,
}

Expand description

Parameters for configuring the network more granularity via CLI

Arguments to setup discovery service.

Comma separated enode URLs of trusted peers for P2P connections.

–trusted-peers enode://abcd@192.168.0.1:30303

Connect to or accept from trusted peers only

Comma separated enode URLs for P2P discovery bootstrap.

Will fall back to a network-specific default if not specified.

Amount of DNS resolution requests retries to perform when peering.

The path to the known peers file. Connected peers are dumped to this file on nodes shutdown, and read on startup. Cannot be used with --no-persist-peers.

Custom node identity

Secret key to use for this node.

This will also deterministically set the peer ID. If not specified, it will be set in the data dir for the chain being used.

Hex encoded secret key to use for this node.

This will also deterministically set the peer ID. Cannot be used together with --p2p-secret-key.

Do not persist peers.

NAT resolution method (any|none|upnp|publicip|extip:<IP>)

Network listening address

Network listening port

Maximum number of outbound peers. default: 100

Maximum number of inbound peers. default: 30

Maximum number of total peers (inbound + outbound).

Splits peers using approximately 2:1 inbound:outbound ratio. Cannot be used together with --max-outbound-peers or --max-inbound-peers.

Max concurrent GetPooledTransactions requests.

Max concurrent GetPooledTransactions requests per peer.

Max number of seen transactions to remember per peer.

Default is 320 transaction hashes.

Max number of transactions to import concurrently.

Experimental, for usage in research. Sets the max accumulated byte size of transactions to pack in one response. Spec’d at 2MiB.

Experimental, for usage in research. Sets the max accumulated byte size of transactions to request in one request.

Since RLPx protocol version 68, the byte size of a transaction is shared as metadata in a transaction announcement (see RLPx specs). This allows a node to request a specific size response.

By default, nodes request only 128 KiB worth of transactions, but should a peer request more, up to 2 MiB, a node will answer with more than 128 KiB.

Default is 128 KiB.

Max capacity of cache of hashes for transactions pending fetch.

Name of network interface used to communicate with peers.

If flag is set, but no value is passed, the default interface for docker eth0 is tried.

Transaction Propagation Policy

The policy determines which peers transactions are gossiped to.

Transaction ingress policy

Determines which peers’ transactions are accepted over P2P.

Disable transaction pool gossip

Disables gossiping of transactions in the mempool to peers. This can be omitted for personal nodes, though providers should always opt to enable this flag.

Sets the transaction propagation mode by determining how new pending transactions are propagated to other peers in full.

Examples: sqrt, all, max:10

Comma separated list of required block hashes or block number=hash pairs. Peers that don’t have these blocks will be filtered out. Format: hash or block_number=hash (e.g., 23115201=0x1234…)

Optional network ID to override the chain specification’s network ID for P2P connections

Restrict network communication to the given IP networks (CIDR masks).

Comma separated list of CIDR network specifications. Only peers with IP addresses within these ranges will be allowed to connect.

Example: –netrestrict “192.168.0.0/16,10.0.0.0/8”

Enforce EIP-868 ENR fork ID validation for discovered peers.

When enabled, peers discovered without a confirmed fork ID are not added to the peer set until their fork ID is verified via EIP-868 ENR request. This filters out peers from other networks that pollute the discovery table.

Struct NetworkArgs

§Panics