Struct NetworkConfig 

pub struct NetworkConfig {

    pub data_dir: Option<PathBuf>,
    pub listen_addresses: Vec<Multiaddr>,
    pub boot_nodes: Vec<Multiaddr>,
    pub max_inbound_peers: u32,
    pub max_outbound_peers: u32,
    pub gossip_topics: Vec<String>,
    pub enable_dht: bool,
    pub enable_mdns: bool,
    pub connection_idle_timeout: Duration,
    pub gossip_heartbeat_interval: Duration,
    pub protocol_version: String,
    pub user_agent: String,
    pub enable_hole_punching: bool,
    pub enable_relay: bool,
    pub external_addresses: Vec<Multiaddr>,
}

Network configuration

Fields

data_dir: Option<PathBuf>

Data directory for persistent state (keypair, etc.)

listen_addresses: Vec<Multiaddr>

Listen addresses (multiaddr format)

boot_nodes: Vec<Multiaddr>

Bootstrap nodes to connect to on startup

max_inbound_peers: u32

Maximum number of inbound peers

max_outbound_peers: u32

Maximum number of outbound peers

gossip_topics: Vec<String>

Topics to subscribe to on startup

enable_dht: bool

Enable DHT for peer discovery

enable_mdns: bool

Enable mDNS for local peer discovery

connection_idle_timeout: Duration

Connection idle timeout

gossip_heartbeat_interval: Duration

Heartbeat interval for gossipsub

protocol_version: String

Protocol version

user_agent: String

User agent string

enable_hole_punching: bool

Enable hole punching for NAT traversal

enable_relay: bool

Enable relay server

external_addresses: Vec<Multiaddr>

Statically-configured external addresses this node advertises to peers via Identify. Required on cloud deployments where the host binds to 0.0.0.0 and Identify’s listen-addr enumeration is hidden (see behaviour.rs::hide_listen_addrs). Each multiaddr listed here is passed to Swarm::add_external_address at startup.

For validator-0 in the live GCE testnet this is set to /ip4/<external-ip>/tcp/9000 from the per-VM Terraform output. For nodes whose external address must be discovered (community joiners behind NAT), leave this empty and rely on AutoNAT v2 + Relay v2 + DCUtR to confirm a reachable address dynamically.

Implementations

impl NetworkConfig

pub fn testnet() -> Self

Creates a testnet configuration

pub fn mainnet() -> Self

Creates a mainnet configuration

pub fn local() -> Self

Creates a local development configuration

pub fn validate(&self) -> Result<()>

Validates the configuration

Trait Implementations

impl Clone for NetworkConfig

fn clone(&self) -> NetworkConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NetworkConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for NetworkConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for NetworkConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for NetworkConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.