Enum ExternalReceiptVerifyError 

pub enum ExternalReceiptVerifyError {
    ReadHistory {
        path: PathBuf,
        source: Error,
    },
    Parse {
        path: PathBuf,
        source: ExternalReceiptParseError,
    },
    Anchor {
        path: PathBuf,
        receipt_index: usize,
        source: AnchorParseError,
    },
    AnchorVerify {
        path: PathBuf,
        receipt_index: usize,
        source: Box<AnchorVerifyError>,
    },
    AnchorTextHashMismatch {
        invariant: &'static str,
        path: PathBuf,
        receipt_index: usize,
        declared: String,
        observed: String,
    },
    TrustedRootStale {
        invariant: &'static str,
        trust_root_status: &'static str,
        cache_path: Option<PathBuf>,
        signed_at: Option<DateTime<Utc>>,
        now: DateTime<Utc>,
        max_age: Duration,
    },
    TrustedRootIo {
        invariant: &'static str,
        path: PathBuf,
        source: Box<TrustedRootIoError>,
    },
}

Verification errors for an external receipt history checked against a JSONL ledger.

Variants

ReadHistory

The receipt history file could not be read.

Fields

path: PathBuf

Receipt history path that was being read.

source: Error

I/O failure.

Parse

The receipt history did not parse as repeated v1 records.

Fields

path: PathBuf

Receipt history path that was being parsed.

source: ExternalReceiptParseError

Parse failure.

Anchor

One receipt referenced a chain-head hash that does not validate as a canonical LedgerAnchor.

Fields

path: PathBuf

Receipt history path that was being verified.

receipt_index: usize

1-based receipt record index.

source: AnchorParseError

Anchor field validation failure.

AnchorVerify

The receipt’s position-bound anchor failed to verify against the local ledger.

Fields

path: PathBuf

Receipt history path that was being verified.

receipt_index: usize

1-based receipt record index.

source: Box<AnchorVerifyError>

Local-ledger anchor verification failure.

AnchorTextHashMismatch

The recomputed anchor_text_sha256 did not match the receipt-declared value.

Fields

invariant: &'static str

Stable invariant token, equal to ANCHOR_TEXT_HASH_MISMATCH_INVARIANT.

path: PathBuf

Receipt history path that was being verified.

receipt_index: usize

1-based receipt record index.

declared: String

Anchor-text hash declared by the receipt.

observed: String

Anchor-text hash recomputed from the local ledger.

TrustedRootStale

The cached or embedded trusted_root.json is older than the operator-configured staleness window. Emits the stable TRUSTED_ROOT_STALE_INVARIANT.

Fields

invariant: &'static str

Stable invariant token, equal to TRUSTED_ROOT_STALE_INVARIANT.

trust_root_status: &'static str

Provenance token: EMBEDDED_ROOT_STATUS or CACHED_ROOT_STATUS.

cache_path: Option<PathBuf>

Cache path that was inspected, if any.

signed_at: Option<DateTime<Utc>>

Latest validFor.start observed in the active trust root.

now: DateTime<Utc>

Wall-clock used to compute staleness.

max_age: Duration

Maximum age permitted by the operator policy.

TrustedRootIo

The cached trusted_root.json could not be loaded — I/O or parse failure on the operator-supplied path. The embedded fallback path is selected by passing None for the cache; this variant only fires when a cache path was supplied AND the file existed.

Fields

invariant: &'static str

Stable invariant token, equal to TRUSTED_ROOT_PARSE_INVARIANT.

path: PathBuf

Cache path that was being inspected.

source: Box<TrustedRootIoError>

Underlying I/O / parse failure.

Trait Implementations

impl Debug for ExternalReceiptVerifyError

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

Formats the value using the given formatter.

impl Display for ExternalReceiptVerifyError

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

Formats the value using the given formatter.

impl Error for ExternalReceiptVerifyError

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.