Struct ClusterConfig 

pub struct ClusterConfig {
    pub listen: SocketAddr,
    pub root_pubkeys: Vec<String>,
    pub seeds: Vec<String>,
    pub join_token: Option<String>,
    pub store_dir: Option<PathBuf>,
    pub mesh: Option<MeshConfig>,
}

cluster section — self-hosted cluster mode. Parsed in every build so config files stay portable; only consumed when the cluster feature is compiled in (boatramp serve --mode cluster).

Fields

listen: SocketAddr

Address to bind this node’s Raft peer mesh on (the /raft/* + /stream/* endpoints) — distinct from the public serve.addr.

root_pubkeys: Vec<String>

The cluster root anchor set — the es256:/ed25519:-tagged public keys that define this cluster’s identity (a cluster is its root key). Every join/trust decision verifies against this set. Empty ⇒ falls back to serve.auth_root_public_key (the single-anchor default). A set enables make-before-break root rotation.

seeds: Vec<String>

Seeds — control-plane addresses of existing cluster members (host:port), any of which can admit this node. Present ⇒ this node joins (redeems its join_token); absent + no durable state + explicit --cluster-init ⇒ it founds. There is no peer map: members are learned from the root-signed join response.

join_token: Option<String>

The single-use bearer join token used when seeds are set. Keeps the secret out of the file via a prefix: env:VAR, path:/file, or an inline literal. Usually supplied via serve --cluster-join <ticket> instead.

store_dir: Option<PathBuf>

Directory for this node’s durable Raft log/state store (node-local; distinct from the replicated control plane). Default <data-dir>/raft.

mesh: Option<MeshConfig>

Mesh identity + TLS settings. Absent ⇒ defaults (identity key auto-generated under <data-dir>/mesh/identity.key).

Trait Implementations

impl Clone for ClusterConfig

fn clone(&self) -> ClusterConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClusterConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ClusterConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.