Enum LedgerError 

#[non_exhaustive]
pub enum LedgerError {
    Io {
        path: String,
        err: String,
    },
    Serde(String),
    Tamper {
        seq: u64,
        why: String,
    },
    TornTail {
        healed_entries: u64,
        healed_root: Option<String>,
        torn_path: String,
        torn_from_offset: u64,
    },
}

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.

Io

Fields

path: String

err: String

Serde(String)

Tamper

Fields

seq: u64

why: String

TornTail

The log’s FINAL physical line is structurally incomplete — the file does not end in a newline, so the trailing record was only partially written (a crash between/mid the single append write and its flush/sync). DISTINCT from Tamper on purpose: a benign crash-during-append must never be reported as an attack. The verified PREFIX — every fully-terminated, chain-valid, signature-valid record — is intact and is the ledger; healed_entries is its length and healed_root its head hash. The open path HEALS this (truncates the torn fragment at torn_from_offset in torn_path) after first confirming the prefix still extends any persisted anchor — because a crash can only ever drop an un-acked tail, whereas a shorter-than-anchor prefix means acked history was deleted and stays Tamper. The read-only verify* entry points surface this variant rather than healing.

Fields

healed_entries: u64

healed_root: Option<String>

torn_path: String

torn_from_offset: u64

Trait Implementations

impl Debug for LedgerError

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

Formats the value using the given formatter.

impl Display for LedgerError

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

Formats the value using the given formatter.

impl Error for LedgerError

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.