Struct RaftNodeConfig 

pub struct RaftNodeConfig {
    pub cluster: ClusterConfig,
    pub network: NetworkConfig,
    pub raft: RaftConfig,
    pub retry: RetryPolicies,
    pub tls: TlsConfig,
}

Main configuration container for Raft consensus engine components

Combines all subsystem configurations with hierarchical override support:

1. Default values from code implementation
2. Configuration file specified by CONFIG_PATH
3. Environment variables (highest priority)

Fields

cluster: ClusterConfig

Cluster topology and node configuration

network: NetworkConfig

Network communication parameters

raft: RaftConfig

Core Raft algorithm parameters

retry: RetryPolicies

Retry policies for distributed operations

tls: TlsConfig

TLS/SSL security configuration

Implementations

impl RaftNodeConfig

pub fn new() -> Result<Self>

Creates a new configuration with hierarchical override support:

Configuration sources are merged in the following order (later sources override earlier ones):

1. Type defaults (lowest priority)
2. Configuration file from CONFIG_PATH environment variable
3. Environment variables with RAFT__ prefix (highest priority)

Returns

Merged configuration instance or error if:

• Config file parsing fails
• Validation rules are violated

Example

// Load with default values only
let cfg = RaftNodeConfig::new()?;

// Load with config file and environment variables
std::env::set_var("CONFIG_PATH", "config/cluster.toml");
std::env::set_var("RAFT__CLUSTER__NODE_ID", "100");
let cfg = RaftNodeConfig::new()?;

pub fn with_override_config(&self, path: &str) -> Result<Self>

Creates a new configuration with additional overrides:

Merging order (later sources override earlier ones):

1. Current configuration values
2. New configuration file
3. Latest environment variables (highest priority)

Example

// Initial configuration
let base = RaftNodeConfig::new()?;

// Apply runtime overrides
let final_cfg = base.with_override_config("runtime_overrides.toml")?;

pub fn validate(&self) -> Result<()>

Validates cross-component configuration rules

Returns

Ok(()) if all configurations are valid, or Err(Error) containing validation failure details

Errors

Returns validation errors from any subsystem:

• Invalid port bindings
• Conflicting node IDs
• Expired certificates
• Retry policy conflicts

pub fn is_learner(&self) -> bool

Checks if this node is configured as a learner (not a voter)

A learner node has role=Learner. Only learners can join via JoinCluster RPC. Voters have role=Follower/Candidate/Leader and are added via config change (AddNode).

Note: Status (Promotable/ReadOnly/Active) is separate from role. This method checks role only.

Trait Implementations

impl Clone for RaftNodeConfig

fn clone(&self) -> RaftNodeConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RaftNodeConfig

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

Formats the value using the given formatter.

impl Default for RaftNodeConfig

fn default() -> RaftNodeConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RaftNodeConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RaftNodeConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.