Struct WitnessQuorumPolicy 

#[non_exhaustive]
pub struct WitnessQuorumPolicy {
    pub trusted_witnesses: BTreeSet<String>,
    pub pinned_documents: BTreeMap<String, Value>,
    pub witness: WitnessPolicy,
    pub enforcement: WitnessEnforcement,
}

Witness corroboration of the checkpoint carried in log_inclusion (RFC-ACDP-0015 §8).

Cosignatures are read from the retrieval’s top-level witness_signatures member (§6.1). Witness trust is deployment policy, bootstrapped out of band (§13). Only the trusted_witnesses can count toward the quorum. Each witness’s DID document comes from one of two places:

• pinned_documents, for a direct-from-witness deployment that already holds it (§6.2);
• otherwise it is resolved: did:web through the verification’s WebResolver (with its SSRF protections), did:key offline.

A witness whose document cannot be obtained does not count, and the reason is recorded in WitnessQuorumReport::failures.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

trusted_witnesses: BTreeSet<String>

Witness DIDs the consumer trusts.

pinned_documents: BTreeMap<String, Value>

Witness DID documents held out of band, by witness DID. These take precedence over resolution.

witness: WitnessPolicy

Quorum size, freshness bound and clock skew. Defaults to WitnessPolicy::default: one witness, 300 s, 120 s.

enforcement: WitnessEnforcement

Whether a shortfall fails verification. Default WitnessEnforcement::Report.

Implementations

impl WitnessQuorumPolicy

pub fn new<I, S>(witnesses: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Trust witnesses, with the default quorum (one witness), report-only.

pub fn with_document( self, witness_id: impl Into<String>, document: Value, ) -> Self

Use document for witness_id instead of resolving it.

pub fn with_min_witnesses(self, n: u32) -> Self

Require n distinct trusted witnesses.

pub fn with_witness_policy(self, witness: WitnessPolicy) -> Self

Replace the quorum, freshness and skew settings.

pub fn enforce(self, enforcement: WitnessEnforcement) -> Self

Set when a shortfall fails verification.

Trait Implementations

impl Clone for WitnessQuorumPolicy

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WitnessQuorumPolicy

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

Formats the value using the given formatter.

impl Eq for WitnessQuorumPolicy

impl PartialEq for WitnessQuorumPolicy

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for WitnessQuorumPolicy