Struct NodeConfig 

pub struct NodeConfig {

    pub transport_enabled: bool,
    pub identity: Option<Identity>,
    pub interfaces: Vec<InterfaceConfig>,
    pub share_instance: bool,
    pub instance_name: String,
    pub shared_instance_port: u16,
    pub rpc_port: u16,
    pub cache_dir: Option<PathBuf>,
    pub management: ManagementConfig,
    pub probe_port: Option<u16>,
    pub probe_addrs: Vec<SocketAddr>,
    pub probe_protocol: ProbeProtocol,
    pub device: Option<String>,
    pub hooks: Vec<ParsedHook>,
    pub discover_interfaces: bool,
    pub discovery_required_value: Option<u8>,
    pub respond_to_probes: bool,
    pub prefer_shorter_path: bool,
    pub max_paths_per_destination: usize,
    pub registry: Option<InterfaceRegistry>,
    pub panic_on_interface_error: bool,
}

Top-level node configuration.

Fields

transport_enabled: bool

identity: Option<Identity>

interfaces: Vec<InterfaceConfig>

Interface configurations (parsed via registry factories).

share_instance: bool

Enable shared instance server for local clients (rns-ctl, etc.)

instance_name: String

Instance name for Unix socket namespace (default: “default”).

shared_instance_port: u16

Shared instance port for local client connections (default 37428).

rpc_port: u16

RPC control port (default 37429). Only used when share_instance is true.

cache_dir: Option<PathBuf>

Cache directory for announce cache. If None, announce caching is disabled.

management: ManagementConfig

Remote management configuration.

probe_port: Option<u16>

Port to run the STUN probe server on (for facilitator nodes).

probe_addrs: Vec<SocketAddr>

Addresses of STUN/RNSP probe servers (tried sequentially with failover).

probe_protocol: ProbeProtocol

Protocol for endpoint discovery: “rnsp” (default) or “stun”.

device: Option<String>

Network interface to bind outbound sockets to (e.g. “usb0”).

hooks: Vec<ParsedHook>

Hook configurations loaded from the config file.

discover_interfaces: bool

Enable interface discovery.

discovery_required_value: Option<u8>

Minimum stamp value for accepting discovered interfaces (default: 14).

respond_to_probes: bool

Respond to probe packets with automatic proof (like Python’s respond_to_probes).

prefer_shorter_path: bool

Accept an announce with strictly fewer hops even when the random_blob is a duplicate of the existing path entry. Default false preserves Python-compatible anti-replay behaviour.

max_paths_per_destination: usize

Maximum number of alternative paths stored per destination. Default 1 (single path, backward-compatible).

registry: Option<InterfaceRegistry>

Custom interface registry. If None, uses InterfaceRegistry::with_builtins().

panic_on_interface_error: bool

If true, a single interface failing to start will abort the entire node. If false (default), the error is logged and remaining interfaces continue.