Struct NodeConfig 

pub struct NodeConfig {

    pub local: bool,
    pub port: u16,
    pub ipv6: bool,
    pub bootstrap_peers: Vec<MultiAddr>,
    pub connection_timeout: Duration,
    pub max_connections: usize,
    pub dht_config: DHTConfig,
    pub bootstrap_cache_config: Option<BootstrapConfig>,
    pub diversity_config: Option<IPDiversityConfig>,
    pub max_message_size: Option<usize>,
    pub node_identity: Option<Arc<NodeIdentity>>,
    pub mode: NodeMode,
    pub custom_user_agent: Option<String>,
    pub allow_loopback: bool,
    pub adaptive_dht_config: AdaptiveDhtConfig,
}

Configuration for a P2P node

Fields

local: bool

Bind to loopback only (127.0.0.1 / ::1).

When true, the node listens on loopback addresses suitable for local development and testing. When false (the default), the node listens on all interfaces (0.0.0.0 / ::).

port: u16

Listen port. 0 means OS-assigned ephemeral port.

ipv6: bool

Enable IPv6 dual-stack binding.

When true (the default), both an IPv4 and an IPv6 address are bound. When false, only IPv4 is used.

bootstrap_peers: Vec<MultiAddr>

Bootstrap peers to connect to on startup.

connection_timeout: Duration

Connection timeout duration

max_connections: usize

Maximum number of concurrent connections

dht_config: DHTConfig

DHT configuration

bootstrap_cache_config: Option<BootstrapConfig>

Bootstrap cache configuration

diversity_config: Option<IPDiversityConfig>

Optional IP diversity configuration for Sybil protection tuning.

When set, this configuration is used by bootstrap peer discovery and other diversity-enforcing subsystems. If None, defaults are used.

max_message_size: Option<usize>

Optional override for the maximum application-layer message size.

When None, the underlying saorsa-transport default is used.

node_identity: Option<Arc<NodeIdentity>>

Optional node identity for app-level message signing.

When set, outgoing messages are signed with the node’s ML-DSA-65 key and incoming signed messages are verified at the transport layer.

mode: NodeMode

Operating mode of this node.

Determines the default user agent and DHT participation:

• Node → user agent "node/<version>", added to DHT routing tables.
• Client → user agent "client/<version>", treated as ephemeral.

custom_user_agent: Option<String>

Optional custom user agent override.

When Some, this value is used instead of the mode-derived default. When None, the user agent is derived from NodeConfig::mode.

allow_loopback: bool

Allow loopback addresses (127.0.0.1, ::1) in the transport layer.

In production, loopback addresses are rejected because they are not routable. Enable this for local devnets and testnets where all nodes run on the same machine.

Default: false

adaptive_dht_config: AdaptiveDhtConfig

Adaptive DHT configuration (trust-based blocking and eviction).

Controls whether peers with low trust scores are evicted from the routing table and blocked from DHT operations. Use [NodeConfigBuilder::trust_enforcement] for a simple on/off toggle.

Default: enabled with a block threshold of 0.15.

Implementations

impl NodeConfig

pub fn user_agent(&self) -> String

Returns the effective user agent string.

If a custom user agent was set, returns that. Otherwise, derives the user agent from the node’s NodeMode.

pub fn listen_addrs(&self) -> Vec<MultiAddr>

Compute the listen addresses from the configuration fields.

The returned addresses are derived from local, port, and ipv6.

pub fn new() -> Result<Self, P2PError>

Create a new NodeConfig with default values

Errors

Returns an error if default addresses cannot be parsed

pub fn builder() -> NodeConfigBuilder

Create a builder for customized NodeConfig construction

Trait Implementations

impl Clone for NodeConfig

fn clone(&self) -> NodeConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NodeConfig

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

Formats the value using the given formatter.

impl Default for NodeConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for NodeConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for NodeConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.