Enum LedgerError 

#[non_exhaustive]
pub enum LedgerError {
    ChainUnreadable {
        table: String,
        record_id: i64,
        detail: String,
    },
    HardDeleteCascade {
        table: String,
        record_id: i64,
    },
    OutOfBandWrite {
        table: String,
        path: &'static str,
    },
    TenantChange {
        table: String,
        record_id: i64,
    },
    NonFiniteValue {
        table: String,
        record_id: i64,
        column: String,
    },
    SnapshotNotCanonical {
        table: String,
        record_id: i64,
        seq: i64,
    },
    SnapshotSchemaMismatch {
        table: String,
        record_id: i64,
        seq: i64,
        detail: String,
    },
    ChainBroken {
        table: String,
        record_id: i64,
        seq: i64,
        detail: String,
    },
}

A ledgered write that the repository seam refused.

Every guardrail Autumn can enforce at compile time is enforced there — a ledgered repository without soft_delete does not compile, and purge is not generated for one. This error covers what only the runtime can see.

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.

ChainUnreadable

A revision could not be appended because the record’s chain could not be read — the ledger table is missing, or its migration has not been applied.

Fields

table: String

Table of the ledgered model.

record_id: i64

Primary key of the record being written.

detail: String

Underlying reason.

HardDeleteCascade

A hard-deleting parent’s dependent(..., on_delete = destroy) cascade reached a ledgered child.

Neither outcome is available: erasing the child destroys the record its ledger reconstructs, and soft-deleting it leaves a live foreign key pointing at a parent row that is about to be deleted, which the database rejects and rolls back. The parent’s macro cannot see that the child is ledgered — they are separate #[repository] invocations — so this is refused at runtime with a typed error rather than at compile time.

Fields

table: String

Table of the ledgered child.

record_id: i64

Primary key of the child the cascade reached.

OutOfBandWrite

A framework write path that records no revision reached a ledgered table.

Counter-cache upkeep, dependent(.., delete_all | nullify) cascades, #[votable] and #[commentable] writes, has_many(through) link writes and portability imports run raw SQL. On a ledgered table, that SQL would change or erase rows and record no revision. Autumn refuses the write (#2319).

Fields

table: String

The ledgered table the write targeted.

path: &'static str

The write path, for example counter cache or dependent delete_all.

TenantChange

A ledgered write moved a record to another tenant (#2319).

A chain belongs to one (tenant, record). A move would leave the old chain without a live row and start a new chain in the other tenant.

Fields

table: String

Table of the ledgered model.

record_id: i64

Primary key of the record being written.

NonFiniteValue

A ledgered write carried a NaN or infinite float (#2326).

JSON cannot hold either value. A snapshot would store null and could not be read back. The write is refused before the hash.

Fields

table: String

Table of the ledgered model.

record_id: i64

Primary key of the record being written.

column: String

The offending column.

SnapshotNotCanonical

A stored snapshot is not the canonical text that was hashed (#2326).

The text parses, but it is not byte-identical to its canonical form. Someone re-encoded it, reordered its keys, or added a duplicate key.

Fields

table: String

Table of the ledgered model.

record_id: i64

Primary key of the record.

seq: i64

Sequence number of the revision.

SnapshotSchemaMismatch

A stored snapshot does not decode into the model’s current shape (#2326).

The model schema probably changed after the revision was written. This is not proof of an edit: ledger_verify shows the difference.

Fields

table: String

Table of the ledgered model.

record_id: i64

Primary key of the record.

seq: i64

Sequence number of the revision.

detail: String

The decode failure.

ChainBroken

A record’s stored chain is broken, so its past state cannot be trusted.

Fields

table: String

Table of the ledgered model.

record_id: i64

Primary key of the record.

seq: i64

Sequence number of the first broken link.

detail: String

What kind of break, and why.

Trait Implementations

impl Clone for LedgerError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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 Eq for LedgerError

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.

impl PartialEq for LedgerError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for LedgerError