Enum ChainError 

pub enum ChainError {
    MalformedHash,
    Mismatch {
        index: u64,
    },
    Unverifiable,
    KeyUnavailable,
}

Errors from computing or verifying a hash chain.

Variants

MalformedHash

A stored hex-encoded chain hash was not exactly 64 hex characters.

Mismatch

A chain link recomputed under a known key (current or a previous rotation-window epoch) did not match the stored value at index within the chained region — this is a definite tamper verdict: the key resolved correctly at the first chained entry, so a later mismatch means the content itself was altered, reordered, or deleted-and-replaced.

Fields

index: u64

Zero-based index within the chained region (not the file’s physical line number).

Unverifiable

Neither the current epoch’s key nor any previous-epoch key in the rotation window produced a valid link for the first chained entry. This is genuinely ambiguous — it could be tamper under an unknown key, or a legitimate session that predates the rotation window — so it fails closed without asserting either. Per NFR-004 this is never downgraded to trusted-legacy: only a file with no chain metadata anywhere is legacy.

KeyUnavailable

No chain key is available at all (e.g. the vault key was never provisioned, or the vault is unreachable) for a file that carries chain metadata. Per NFR-004 this is a failure, never a silent skip.

Trait Implementations

impl Debug for ChainError

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

Formats the value using the given formatter.

impl Display for ChainError

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

Formats the value using the given formatter.

impl Eq for ChainError

impl Error for ChainError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for ChainError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ChainError