Struct NodeConfig 

pub struct NodeConfig {

    pub root_dir: PathBuf,
    pub port: u16,
    pub ipv4_only: bool,
    pub bootstrap: Vec<SocketAddr>,
    pub network_mode: NetworkMode,
    pub testnet: TestnetConfig,
    pub upgrade: UpgradeConfig,
    pub payment: PaymentConfig,
    pub bootstrap_cache: BootstrapCacheConfig,
    pub storage: StorageConfig,
    pub close_group_cache_dir: Option<PathBuf>,
    pub max_message_size: usize,
    pub log_level: String,
}

Node configuration.

Fields

root_dir: PathBuf

Root directory for node data.

port: u16

Listening port (0 for auto-select).

ipv4_only: bool

Force IPv4-only mode.

When true, the node binds only on IPv4 instead of dual-stack. Use this on hosts without working IPv6 to avoid advertising unreachable addresses to the DHT.

bootstrap: Vec<SocketAddr>

Bootstrap peer addresses.

network_mode: NetworkMode

Network mode (production, testnet, or development).

testnet: TestnetConfig

Testnet-specific configuration. Only used when network_mode is Testnet.

upgrade: UpgradeConfig

Upgrade configuration.

payment: PaymentConfig

Payment verification configuration.

bootstrap_cache: BootstrapCacheConfig

Bootstrap cache configuration for persistent peer storage.

storage: StorageConfig

Storage configuration for chunk persistence.

close_group_cache_dir: Option<PathBuf>

Directory for persisting the close group cache.

When None (default), the node’s root_dir is used — the cache file lands alongside node_identity.key.

max_message_size: usize

Maximum application-layer message size in bytes.

Tunes the QUIC stream receive window and per-stream read buffer. Default: MAX_WIRE_MESSAGE_SIZE (5 MiB — sufficient for 4 MiB data chunks plus serialization envelope overhead).

log_level: String

Log level.

Implementations

impl NodeConfig

pub fn testnet() -> Self

Create a testnet configuration preset.

This is a convenience method for setting up a testnet node with relaxed anti-Sybil protection, suitable for single-provider deployments. Includes default bootstrap nodes for the Autonomi testnet.

pub fn development() -> Self

Create a development configuration preset.

This has minimal restrictions and is only suitable for local testing.

pub fn is_relaxed(&self) -> bool

Check if this configuration is using relaxed security settings.

pub fn from_file(path: &Path) -> Result<Self>

Load configuration from a TOML file.

Errors

Returns an error if the file cannot be read or parsed.

pub fn to_file(&self, path: &Path) -> Result<()>

Save configuration to a TOML file.

Errors

Returns an error if the file cannot be written.

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.