Struct NetworkApiConfig 

pub struct NetworkApiConfig {

    pub address: IpAddr,
    pub port: u16,
    pub public_address: Option<IpAddr>,
    pub public_port: Option<u16>,
    pub ignore_protocol_version: bool,
    pub bandwidth_limit: Option<usize>,
    pub total_bandwidth_limit: Option<usize>,
    pub min_bandwidth_per_connection: Option<usize>,
    pub blocked_addresses: Option<HashSet<SocketAddr>>,
    pub transient_budget: usize,
    pub transient_ttl_secs: u64,
    pub min_connections: usize,
    pub max_connections: usize,
    pub streaming_enabled: bool,
    pub streaming_threshold: usize,
    pub ledbat_min_ssthresh: Option<usize>,
}

Fields

address: IpAddr

Address to listen to locally

port: u16

Port to expose api on

public_address: Option<IpAddr>

Public external address for the network, mandatory for gateways.

public_port: Option<u16>

Public external port for the network, mandatory for gateways.

ignore_protocol_version: bool

Whether to ignore protocol version compatibility routine while initiating connections.

bandwidth_limit: Option<usize>

Bandwidth limit per connection for data transfers (in bytes per second). NOTE: This applies to each connection independently - N connections may use N * bandwidth_limit total. Each connection uses LEDBAT congestion control to yield to foreground traffic. Default: 10 MB/s (10,000,000 bytes/second)

If total_bandwidth_limit is set, this field is ignored and per-connection rates are derived from: total_bandwidth_limit / active_connections.

total_bandwidth_limit: Option<usize>

Total bandwidth limit across ALL connections (in bytes per second). When set, individual connection rates are computed as: total / active_connections. This overrides the per-connection bandwidth_limit.

Example: With 50 MB/s total and 5 connections, each gets 10 MB/s. Default: None (use per-connection bandwidth_limit instead)

min_bandwidth_per_connection: Option<usize>

Minimum bandwidth per connection when using total_bandwidth_limit (bytes/sec). Prevents connection starvation when many connections are active.

If total / N < min, each connection gets min (exceeding total is possible). Default: 1 MB/s (1,000,000 bytes/second)

blocked_addresses: Option<HashSet<SocketAddr>>

List of IP:port addresses to refuse connections to/from.

transient_budget: usize

Maximum number of concurrent transient connections accepted by a gateway.

transient_ttl_secs: u64

Time (in seconds) before an unpromoted transient connection is dropped.

min_connections: usize

Minimum desired connections for the ring topology.

max_connections: usize

Maximum allowed connections for the ring topology.

streaming_enabled: bool

Enable streaming transport for large transfers (experimental). When enabled, transfers larger than streaming_threshold use streaming instead of atomic messages. Default: false

streaming_threshold: usize

Threshold in bytes above which streaming transport is used. Only applies when streaming_enabled is true. Default: 65536 (64KB)

ledbat_min_ssthresh: Option<usize>

Minimum ssthresh floor for LEDBAT timeout recovery (bytes).

On high-latency paths (>100ms RTT), repeated timeouts can cause ssthresh to collapse to ~5KB, severely limiting throughput recovery. Setting a higher floor prevents this “ssthresh death spiral”.

Default: 102400 (100KB) - suitable for intercontinental connections. Set to None for LAN-only deployments.

Trait Implementations

impl Clone for NetworkApiConfig

fn clone(&self) -> NetworkApiConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NetworkApiConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for NetworkApiConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for NetworkApiConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.