Struct Witness 

pub struct Witness {
    pub witness_id: String,
    /* private fields */
}

A witness that monitors a transparency log.

Stores all known tree heads and verifies consistency between successive heads. Heads that fail consistency are rejected.

Fields

witness_id: String

Witness identity.

Implementations

impl Witness

pub fn new(witness_id: &str) -> Self

Create a new witness with the given identity.

pub fn receive_head( &mut self, head: TreeHead, tree: &MerkleTree, ) -> Result<(), WitnessError>

Receive a new tree head. If the witness already knows a head at a smaller tree size, consistency_proof must be provided to verify the transition.

tree is the current tree state (used to brute-force verify consistency via root recomputation).

pub fn latest_head(&self) -> Option<&TreeHead>

Get the latest known head (largest tree_size).

pub fn known_heads(&self) -> Vec<&TreeHead>

Get all known heads sorted by tree_size.

pub fn head_at(&self, tree_size: u64) -> Option<&TreeHead>

Get a specific head by tree_size.

pub fn head_count(&self) -> usize

Number of known heads.

pub fn gossip_to( &self, peer: &mut Witness, tree_size: u64, tree: &MerkleTree, ) -> Result<(), WitnessError>

Gossip a head to another witness. The peer verifies and stores the head.

Trait Implementations

impl Debug for Witness

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

Formats the value using the given formatter.

impl Default for Witness

fn default() -> Witness

Returns the “default value” for a type.