Struct Checkpoint 

pub struct Checkpoint {
    pub created_at: u64,
    pub segment_seq: u64,
    pub record_count: u64,
    pub tree_size: u64,
    pub merkle_root: Hash,
    pub key_version: u32,
    pub signature: Vec<u8>,
}

One signed integrity checkpoint of the audit-log Merkle tree. See the module docs for the threat it addresses.

Fields

created_at: u64

UTC micros at signing time.

segment_seq: u64

Sequence number of the logs segment that was active at checkpoint time.

record_count: u64

Log records on disk at checkpoint time (decreases after retention).

tree_size: u64

Total records ever appended at checkpoint time — the Merkle tree size the merkle_root is taken over. Never decreases (the spine is not purged), so the current tree is always an extension of any past checkpoint.

merkle_root: Hash

Merkle root over the first tree_size leaves at checkpoint time.

key_version: u32

crate::crypto::KeyVersion of the RSA key that signed this checkpoint — after a rotation, old checkpoints still verify against the retained public key of their own version.

signature: Vec<u8>

RSA PKCS#1 v1.5 / SHA-256 signature over the fields above.

Implementations

impl Checkpoint

pub fn verify(&self, keys: &KeyRing) -> Result<()>

Verify the signature with the ring’s public key.

pub fn merkle_root_hex(&self) -> String

Hex form of the Merkle root — the value to hand to external anchors.

Trait Implementations

impl Clone for Checkpoint

fn clone(&self) -> Checkpoint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Checkpoint

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

Formats the value using the given formatter.

impl Eq for Checkpoint

impl PartialEq for Checkpoint

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Checkpoint