Struct NetworkConfiguration

pub struct NetworkConfiguration {

    pub net_config_path: Option<PathBuf>,
    pub listen_addresses: Vec<Multiaddr>,
    pub public_addresses: Vec<Multiaddr>,
    pub boot_nodes: Vec<MultiaddrWithPeerId>,
    pub node_key: NodeKeyConfig,
    pub default_peers_set: SetConfig,
    pub default_peers_set_num_full: u32,
    pub client_version: String,
    pub node_name: String,
    pub transport: TransportConfig,
    pub max_parallel_downloads: u32,
    pub max_blocks_per_request: u32,
    pub sync_mode: SyncMode,
    pub enable_dht_random_walk: bool,
    pub allow_non_globals_in_dht: bool,
    pub kademlia_disjoint_query_paths: bool,
    pub kademlia_replication_factor: NonZero<usize>,
    pub ipfs_server: bool,
    pub network_backend: Option<NetworkBackendType>,
}

Network service configuration.

Fields

net_config_path: Option<PathBuf>

Directory path to store network-specific configuration. None means nothing will be saved.

listen_addresses: Vec<Multiaddr>

Multiaddresses to listen for incoming connections.

public_addresses: Vec<Multiaddr>

Multiaddresses to advertise. Detected automatically if empty.

boot_nodes: Vec<MultiaddrWithPeerId>

List of initial node addresses

node_key: NodeKeyConfig

The node key configuration, which determines the node’s network identity keypair.

default_peers_set: SetConfig

Configuration for the default set of nodes used for block syncing and transactions.

default_peers_set_num_full: u32

Number of substreams to reserve for full nodes for block syncing and transactions. Any other slot will be dedicated to light nodes.

This value is implicitly capped to default_set.out_peers + default_set.in_peers.

client_version: String

Client identifier. Sent over the wire for debugging purposes.

node_name: String

Name of the node. Sent over the wire for debugging purposes.

transport: TransportConfig

Configuration for the transport layer.

max_parallel_downloads: u32

Maximum number of peers to ask the same blocks in parallel.

max_blocks_per_request: u32

Maximum number of blocks per request.

sync_mode: SyncMode

Initial syncing mode.

enable_dht_random_walk: bool

True if Kademlia random discovery should be enabled.

If true, the node will automatically randomly walk the DHT in order to find new peers.

allow_non_globals_in_dht: bool

Should we insert non-global addresses into the DHT?

kademlia_disjoint_query_paths: bool

Require iterative Kademlia DHT queries to use disjoint paths for increased resiliency in the presence of potentially adversarial nodes.

kademlia_replication_factor: NonZero<usize>

Kademlia replication factor determines to how many closest peers a record is replicated to.

Discovery mechanism requires successful replication to all kademlia_replication_factor peers to consider record successfully put.

ipfs_server: bool

Enable serving block data over IPFS bitswap.

network_backend: Option<NetworkBackendType>

Networking backend used for P2P communication.

Implementations

impl NetworkConfiguration

pub fn new<SN, SV>( node_name: SN, client_version: SV, node_key: NodeKeyConfig, net_config_path: Option<PathBuf>, ) -> NetworkConfiguration

where SN: Into<String>, SV: Into<String>,

Create new default configuration

pub fn new_local() -> NetworkConfiguration

Create new default configuration for localhost-only connection with random port (useful for testing)

pub fn new_memory() -> NetworkConfiguration

Create new default configuration for localhost-only connection with random port (useful for testing)

Trait Implementations

impl Clone for NetworkConfiguration

fn clone(&self) -> NetworkConfiguration

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for NetworkConfiguration

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

Formats the value using the given formatter.