Struct ServeArgs 

pub struct ServeArgs {

    pub host: String,
    pub port: u16,
    pub tls_cert: Option<PathBuf>,
    pub tls_key: Option<PathBuf>,
    pub mtls_allowlist: Option<PathBuf>,
    pub shutdown_grace_secs: u64,
    pub quorum_writes: usize,
    pub quorum_peers: Vec<String>,
    pub quorum_timeout_ms: u64,
    pub quorum_client_cert: Option<PathBuf>,
    pub quorum_client_key: Option<PathBuf>,
    pub quorum_ca_cert: Option<PathBuf>,
    pub catchup_interval_secs: u64,
}

Fields

host: String

port: u16

tls_cert: Option<PathBuf>

Path to PEM-encoded TLS certificate (may include the full chain). Passing both --tls-cert and --tls-key switches serve to HTTPS. rustls under the hood — no OpenSSL dep. Absent both flags = plain HTTP (same as every previous release).

tls_key: Option<PathBuf>

Path to PEM-encoded TLS private key (PKCS#8 or RSA).

mtls_allowlist: Option<PathBuf>

Path to a file containing SHA-256 fingerprints of trusted client certificates, one per line (case-insensitive hex, optionally with : separators; comments start with #). When set, serve demands client-cert mTLS on every connection and refuses any peer whose cert fingerprint is not on the list. Requires --tls-cert and --tls-key. This is the peer-mesh identity gate — a peer without an authorised cert can’t even open a TCP connection, let alone hit /sync/push. Layer 2 of the peer-mesh crypto stack; attested agent_id extraction (Layer 2b) lands post-v0.6.0.

shutdown_grace_secs: u64

Seconds to wait for in-flight requests to complete on graceful shutdown (SIGINT). Default 30. Bumped from 10 in v0.6.0 because large /sync/push batches can take longer than 10s under load (red-team #233).

quorum_writes: usize

W-of-N write quorum. When >=1 and --quorum-peers is non-empty, every HTTP write fans out to every peer and returns OK only after the local commit + W-1 peer acks land within --quorum-timeout-ms. Default 0 = federation disabled, daemon behaves exactly like v0.6.0.

quorum_peers: Vec<String>

Comma-separated list of peer base URLs. Each peer is assumed to expose POST /api/v1/sync/push — the same endpoint the sync-daemon already uses.

quorum_timeout_ms: u64

Deadline for quorum-ack collection. After this many ms the write returns 503 quorum_not_met. Default 2000.

quorum_client_cert: Option<PathBuf>

Optional mTLS client cert for outbound federation POSTs. Same cert material the sync-daemon’s --client-cert accepts.

quorum_client_key: Option<PathBuf>

Optional mTLS client key for outbound federation POSTs.

quorum_ca_cert: Option<PathBuf>

Optional root CA cert to trust for outbound federation HTTPS. Required whenever peers present a cert NOT rooted in Mozilla’s webpki-roots bundle (self-signed, private CA, ephemeral test CA, etc.) — without this, the reqwest rustls-tls client rejects peer certs and every quorum write times out as quorum_not_met. See #333.

catchup_interval_secs: u64

v0.6.0.1 (#320) — how often, in seconds, the daemon pulls peers for any updates it missed while offline or partitioned. 0 disables the catchup loop entirely. Default 30s keeps a post-partition node convergent within one interval after resume.

Trait Implementations

impl Args for ServeArgs

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl FromArgMatches for ServeArgs

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.