Enum AuditChainDefect 

pub enum AuditChainDefect {
    DoesNotStartAtTheBeginning {
        found: AuditSequence,
    },
    DigestAltered {
        at: AuditSequence,
    },
    UnexpectedRoot {
        at: AuditSequence,
    },
    SequenceBroken {
        expected: AuditSequence,
        found: AuditSequence,
    },
    LinkBroken {
        at: AuditSequence,
    },
    ForeignCeremony {
        at: AuditSequence,
    },
}

How a journal failed verification.

Each variant names a distinct way a chain can be attacked, because “the audit is broken” is not actionable and “the record at position 7 no longer matches its digest” is.

Variants

DoesNotStartAtTheBeginning

The journal does not open at the first position — records were removed from the front.

Fields

found: AuditSequence

DigestAltered

A record’s content no longer produces its own digest.

Fields

at: AuditSequence

UnexpectedRoot

The opening record claims a predecessor, or a later record claims none. Either way a link was rewritten.

Fields

at: AuditSequence

SequenceBroken

A position was skipped or repeated — records were removed from the middle, or reordered.

Fields

expected: AuditSequence

found: AuditSequence

LinkBroken

A record names a predecessor digest that is not the digest of the record before it. Something was substituted.

Fields

at: AuditSequence

ForeignCeremony

A record belongs to a different ceremony — journals were grafted together.

Fields

at: AuditSequence

Implementations

impl AuditChainDefect

pub fn explain(self) -> String

What went wrong, in words an operator can act on.

Written once here rather than at each surface: the same defect has to read the same whether it was found over gRPC, in process, or by a host running the verifier itself.

pub fn at(self) -> AuditSequence

Where the journal stopped being trustworthy.

Trait Implementations

impl Clone for AuditChainDefect

fn clone(&self) -> AuditChainDefect

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for AuditChainDefect

impl Debug for AuditChainDefect

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AuditChainDefect

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for AuditChainDefect

impl PartialEq for AuditChainDefect

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for AuditChainDefect

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AuditChainDefect