Enum PostingError 

pub enum PostingError {
    Sqlx(Error),
    DuplicateKey(Box<dyn DatabaseError>),
    TxTemplateError(TxTemplateError),
    VelocityError(VelocityError),
    AccountSetError(AccountSetError),
    BalanceError(BalanceError),
    Rejected {
        index: usize,
        tx_id: TransactionId,
        reason: Box<RejectionReason>,
    },
    BatchTooManyAccounts {
        distinct: usize,
        max: usize,
    },
}

The posting module’s error — nested under crate::ledger::error::LedgerError, never the other way around, exactly like every other domain error.

Domain errors the flow passes through keep their own granularity via #[from]; failures specific to the posting path get their own variants here. Self::Rejected additionally attributes a failure to one posting of the submitted batch.

Variants

Sqlx(Error)

DuplicateKey(Box<dyn DatabaseError>)

TxTemplateError(TxTemplateError)

VelocityError(VelocityError)

AccountSetError(AccountSetError)

BalanceError(BalanceError)

Rejected

A failure attributed to a specific posting within a batch.

The batch API is all-or-nothing: the whole operation aborts on the first failure. index and tx_id identify which posting of the submitted batch caused it, so a caller can eject the offender and retry the remainder without correlating an opaque error against its input. Every reason is detected client-side, before the apply statement runs, which is what keeps the failure attributable: nothing has been written when it surfaces. Infrastructure failures (constraint races, deadlocks, connection loss) are not attributable and surface through the other variants.

Fields

index: usize

tx_id: TransactionId

reason: Box<RejectionReason>

BatchTooManyAccounts

The batch would hold more advisory locks than the shared lock table can be relied on to provide. Refused up front, because the alternative is a bare out of shared memory from Postgres that names neither the cause nor the fix — and that can strike unrelated concurrent transactions too.

Fields

distinct: usize

max: usize

Trait Implementations

impl Debug for PostingError

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

Formats the value using the given formatter.

impl Display for PostingError

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

Formats the value using the given formatter.

impl Error for PostingError

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<AccountSetError> for PostingError

fn from(source: AccountSetError) -> Self

Converts to this type from the input type.

impl From<BalanceError> for PostingError

fn from(source: BalanceError) -> Self

Converts to this type from the input type.

impl From<Error> for PostingError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<PostingError> for LedgerError

fn from(source: PostingError) -> Self

Converts to this type from the input type.

impl From<TxTemplateError> for PostingError

fn from(source: TxTemplateError) -> Self

Converts to this type from the input type.

impl From<VelocityError> for PostingError

fn from(source: VelocityError) -> Self

Converts to this type from the input type.