Struct sc_service::config::NetworkConfiguration[][src]

pub struct NetworkConfiguration {
    pub net_config_path: Option<PathBuf>,
    pub listen_addresses: Vec<Multiaddr, Global>,
    pub public_addresses: Vec<Multiaddr, Global>,
    pub boot_nodes: Vec<MultiaddrWithPeerId, Global>,
    pub node_key: NodeKeyConfig,
    pub request_response_protocols: Vec<ProtocolConfig, Global>,
    pub default_peers_set: SetConfig,
    pub extra_sets: Vec<NonDefaultSetConfig, Global>,
    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.


net_config_path: Option<PathBuf>

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

listen_addresses: Vec<Multiaddr, Global>

Multiaddresses to listen for incoming connections.

public_addresses: Vec<Multiaddr, Global>

Multiaddresses to advertise. Detected automatically if empty.

boot_nodes: Vec<MultiaddrWithPeerId, Global>

List of initial node addresses

node_key: NodeKeyConfig

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

request_response_protocols: Vec<ProtocolConfig, Global>

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, Global>

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.


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.


impl NetworkConfiguration[src]

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[src]

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

pub fn new_memory() -> NetworkConfiguration[src]

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

Trait Implementations

impl Clone for NetworkConfiguration[src]

impl Debug for NetworkConfiguration[src]

Auto Trait Implementations

impl !RefUnwindSafe for NetworkConfiguration

impl Send for NetworkConfiguration

impl Sync for NetworkConfiguration

impl Unpin for NetworkConfiguration

impl !UnwindSafe for NetworkConfiguration

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized

impl<T> Borrow<T> for T where
    T: ?Sized

impl<T> BorrowMut<T> for T where
    T: ?Sized

impl<T> CheckedConversion for T[src]

impl<T> DynClone for T where
    T: Clone

impl<T> Erased for T

impl<T> From<T> for T[src]

impl<T> Instrument for T[src]

impl<T> Instrument for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 

impl<T, Outer> IsWrappedBy<Outer> for T where
    T: From<Outer>,
    Outer: AsRef<T> + AsMut<T> + From<T>, 

pub fn from_ref(outer: &Outer) -> &T[src]

Get a reference to the inner from the outer.

pub fn from_mut(outer: &mut Outer) -> &mut T[src]

Get a mutable reference to the inner from the outer.

impl<T> MaybeDebug for T where
    T: Debug

impl<T> MaybeDebug for T where
    T: Debug

impl<T> Pointable for T

type Init = T

The type for initializers.

impl<T> Same<T> for T

type Output = T

Should always be Self

impl<T> SaturatedConversion for T[src]

impl<T> ToOwned for T where
    T: Clone

type Owned = T

The resulting type after obtaining ownership.

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<S, T> UncheckedInto<T> for S where
    T: UncheckedFrom<S>, 

impl<T, S> UniqueSaturatedInto<T> for S where
    T: Bounded,
    S: TryInto<T>, 

impl<V, T> VZip<V> for T where
    V: MultiLane<T>, 

impl<T> WithSubscriber for T[src]