Enum WalError 

#[non_exhaustive]
pub enum WalError {
    SerializeFailed(String),
    DeserializeFailed(String),
    ChainBroken {
        at_record: usize,
    },
    HashMismatch {
        at_record: usize,
    },
    HeaderIncompatible(String),
    InvalidVerifyingKey,
    MissingSignature {
        at_record: usize,
    },
    SignatureMismatch {
        at_record: usize,
    },
    MissingPqcSignature {
        at_record: usize,
    },
    PqcSignatureMismatch {
        at_record: usize,
    },
    PqcWithoutEd25519,
}

WAL operation failures. #[non_exhaustive] — adding variants is not a breaking change for external matchers.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

SerializeFailed(String)

Postcard refused to encode (carries the upstream message).

DeserializeFailed(String)

Postcard refused to decode (carries the upstream message).

ChainBroken

Record at_record’s prev_chain_hash doesn’t match the running expected hash from the previous record.

Fields

at_record: usize

Index of the offending record.

HashMismatch

Record at_record’s this_chain_hash doesn’t match the recomputed BLAKE3 keyed hash.

Fields

at_record: usize

Index of the offending record.

HeaderIncompatible(String)

Header pinning rejected (semver / abi / world / manifest mismatch).

InvalidVerifyingKey

Header pins a verifying_key (Ed25519 or PQC) that fails to parse.

MissingSignature

Header pins a verifying_key but a record carries no signature.

Fields

at_record: usize

Index of the offending record.

SignatureMismatch

Signature does not validate against the header’s verifying key.

Fields

at_record: usize

Index of the offending record.

MissingPqcSignature

Header pins a Hybrid envelope (verifying_key_pqc=Some) but a record carries no PQC signature (signature_pqc=None).

Fields

at_record: usize

Index of the offending record.

PqcSignatureMismatch

PQC signature does not validate against the header’s PQC verifying key (Hybrid AND-mode failure).

Fields

at_record: usize

Index of the offending record.

PqcWithoutEd25519

Invalid Hybrid envelope — verifying_key_pqc=Some without verifying_key=Some. Ed25519 is the chain-anchor companion; PQC-only envelope is rejected.

Trait Implementations

impl Clone for WalError

fn clone(&self) -> WalError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WalError

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

Formats the value using the given formatter.

impl Display for WalError

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

Formats the value using the given formatter.

impl Error for WalError

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 From<WalError> for ReplayError

fn from(e: WalError) -> Self

Converts to this type from the input type.