Struct NodeConfig 

pub struct NodeConfig {
    pub bind_addr: Option<TransportAddr>,
    pub known_peers: Vec<TransportAddr>,
    pub keypair: Option<(MlDsaPublicKey, MlDsaSecretKey)>,
    pub transport_providers: Vec<Arc<dyn TransportProvider>>,
}

Minimal configuration for P2P nodes

All fields are optional - the node will auto-configure everything.

• bind_addr: Defaults to 0.0.0.0:0 (random port)
• known_peers: Defaults to empty (node can still accept connections)
• keypair: Defaults to fresh generated keypair
• transport_providers: Defaults to UDP transport only

Example

// Zero configuration
let config = NodeConfig::default();

// Or with known peers
let config = NodeConfig::builder()
    .known_peer("peer1.example.com:9000".parse()?)
    .build();

// Or with additional transport providers
#[cfg(feature = "ble")]
let config = NodeConfig::builder()
    .transport_provider(Arc::new(BleTransport::new().await?))
    .build();

Fields

bind_addr: Option<TransportAddr>

Bind address. Default: 0.0.0.0:0 (random port)

known_peers: Vec<TransportAddr>

Known peers for initial discovery. Default: empty When empty, node can still accept incoming connections.

keypair: Option<(MlDsaPublicKey, MlDsaSecretKey)>

Identity keypair (ML-DSA-65). Default: fresh generated Provide for persistent identity across restarts.

transport_providers: Vec<Arc<dyn TransportProvider>>

Additional transport providers beyond the default UDP transport.

The UDP transport is always included by default. Use this to add additional transports like BLE, LoRa, serial, etc.

Transport capabilities are propagated to peer advertisements and used for routing decisions.

Implementations

impl NodeConfig

pub fn new() -> Self

Create a new config with defaults

pub fn builder() -> NodeConfigBuilder

Create a builder for fluent construction

pub fn with_bind_addr(addr: impl Into<TransportAddr>) -> Self

Create config with a specific bind address

pub fn with_known_peers( peers: impl IntoIterator<Item = impl Into<TransportAddr>>, ) -> Self

Create config with known peers

pub fn with_keypair( public_key: MlDsaPublicKey, secret_key: MlDsaSecretKey, ) -> Self

Create config with a specific ML-DSA-65 keypair

impl NodeConfig

pub fn build_transport_registry(&self) -> TransportRegistry

Build a transport registry from this configuration

Creates a registry containing all configured transport providers. If no providers are configured, returns an empty registry (UDP should be added by the caller based on bind_addr).

pub fn has_constrained_transports(&self) -> bool

Check if this configuration has any non-UDP transport providers

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() -> NodeConfig

Returns the “default value” for a type.