Struct FederationConfig 

pub struct FederationConfig {
    pub policy: QuorumPolicy,
    pub peers: Vec<PeerEndpoint>,
    pub client: Client,
    pub sender_agent_id: String,
    pub api_key: Option<String>,
    pub signing_key: Option<Arc<SigningKey>>,
}

Configured-at-serve federation state. Parsed from --quorum-writes + --quorum-peers + --quorum-timeout-ms.

Fields

policy: QuorumPolicy

peers: Vec<PeerEndpoint>

client: Client

sender_agent_id: String

api_key: Option<String>

v0.7.0 fold-A2A1.4 (#702) — the operator-configured [api] api_key from the local daemon’s AppConfig, threaded here so outbound federation POSTs can attach the x-api-key header. Without this, a peer that itself runs with api_key set rejects every fanout with 401 and quorum can never converge across hosts. None means the local daemon doesn’t run with api-key auth — outbound headers stay unmodified (backwards-compatible with mTLS-only deployments and the v0.6.x default-off auth posture).

signing_key: Option<Arc<SigningKey>>

v0.7.0 #791 — Ed25519 signing key the outbound post_once uses to compute the X-Memory-Sig: ed25519=<base64> header. None = no header attached (legacy peers + receivers that opted out via AI_MEMORY_FED_REQUIRE_SIG=0 keep working).

Implementations

impl FederationConfig

pub fn build( quorum_writes: usize, peer_urls: &[String], timeout: Duration, client_cert_path: Option<&Path>, client_key_path: Option<&Path>, ca_cert_path: Option<&Path>, sender_agent_id: String, api_key: Option<String>, ) -> Result<Option<Self>>

Build a FederationConfig from the serve-time CLI flags. Returns None when federation is disabled (quorum_writes == 0 or the peer list is empty).

api_key carries the local daemon’s configured [api] api_key (issue #702, v0.7.0 fold-A2A1.4). When Some, every outbound federation POST attaches an x-api-key header so peers that themselves run with api-key auth accept the request. None preserves the backwards-compatible header set used by mTLS-only deployments — outbound POSTs stay unauthenticated at the application layer and rely on the TLS layer for trust.

Errors

Returns an error if the reqwest client cannot be constructed with the supplied certificate material.

pub fn peer_count(&self) -> usize

Count of peers in the mesh (excludes the local node). Useful for metrics labels.

Trait Implementations

impl Clone for FederationConfig

fn clone(&self) -> FederationConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.