Struct sc_network::config::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 request_response_protocols: Vec<RequestResponseConfig>,
    pub default_peers_set: SetConfig,
    pub extra_sets: Vec<NonDefaultSetConfig>,
    pub client_version: String,
    pub node_name: String,
    pub transport: TransportConfig,
    pub max_parallel_downloads: u32,
    pub enable_dht_random_walk: bool,
    pub allow_non_globals_in_dht: bool,
    pub kademlia_disjoint_query_paths: bool,
    pub ipfs_server: bool,
    pub yamux_window_size: Option<u32>,
}

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.

request_response_protocols: Vec<RequestResponseConfig>

List of request-response protocols that the node supports.

default_peers_set: SetConfig

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

extra_sets: Vec<NonDefaultSetConfig>

Configuration for extra sets of nodes.

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.

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.

ipfs_server: bool

Enable serving block data over IPFS bitswap.

yamux_window_size: Option<u32>

Size of Yamux receive window of all substreams. None for the default (256kiB). Any value less than 256kiB is invalid.

Context

By design, notifications substreams on top of Yamux connections only allow up to N bytes to be transferred at a time, where N is the Yamux receive window size configurable here. This means, in practice, that every N bytes must be acknowledged by the receiver before the sender can send more data. The maximum bandwidth of each notifications substream is therefore N / round_trip_time.

It is recommended to leave this to None, and use a request-response protocol instead if a large amount of data must be transferred. The reason why the value is configurable is that some Substrate users mis-use notification protocols to send large amounts of data. As such, this option isn't designed to stay and will likely get removed in the future.

Note that configuring a value here isn't a modification of the Yamux protocol, but rather a modification of the way the implementation works. Different nodes with different configured values remain compatible with each other.

Implementations

impl NetworkConfiguration

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

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.

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

Performs copy-assignment from source.

impl Debug for NetworkConfiguration

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

Formats the value using the given formatter.