Enum BookingError 

pub enum BookingError {
    AmbiguousMatch {
        num_matches: usize,
        currency: Currency,
    },
    NoMatchingLot {
        currency: Currency,
        cost_spec: CostSpec,
    },
    InsufficientUnits {
        currency: Currency,
        requested: Decimal,
        available: Decimal,
    },
    CurrencyMismatch {
        expected: Currency,
        got: Currency,
    },
    MergeMismatch {
        currency: Currency,
        expected: Amount,
        got: Amount,
    },
    Overflow(OverflowError),
}

Error that can occur during booking.

Variants

AmbiguousMatch

Multiple lots match but booking method requires unambiguous match.

Fields

num_matches: usize

Number of lots that matched.

currency: Currency

The currency being reduced.

NoMatchingLot

No lots match the cost specification.

Fields

currency: Currency

The currency being reduced.

cost_spec: CostSpec

The cost spec that didn’t match.

InsufficientUnits

Not enough units in matching lots.

Fields

currency: Currency

The currency being reduced.

requested: Decimal

Units requested.

available: Decimal

Units available.

CurrencyMismatch

Currency mismatch between reduction and inventory.

Fields

expected: Currency

Expected currency.

got: Currency

Got currency.

MergeMismatch

A {*} merge produced a different pool than booking recorded (#2068).

{*} is an OPERATION, not a filter: unlike every other cost spec it restructures the lots before selecting from them. Booking therefore carries the marker into application rather than resolving it into a per-unit cost, because the lot it would name does not exist until the merge runs.

The consequence is that a booked posting carrying {*} re-executes the merge when applied, so it is only meaningful against the state it was booked against. Booking also records the pool cost it computed, and application checks it here — turning “applied against different state, silently different answer” into a reported error.

Fields

currency: Currency

The commodity being reduced (e.g. AAPL).

expected: Amount

The per-unit pool cost booking recorded, in the cost currency.

got: Amount

The per-unit pool cost the merge would produce, in the cost currency.

Carried as an Amount rather than a bare number so the message reads 110.00 USD: the pool cost is denominated in the COST currency, which is not the commodity in currency.

Overflow(OverflowError)

The arithmetic left rust_decimal’s ~±7.9e28 range (#1863).

Reported rather than clamped: Decimal::MIN == -Decimal::MAX, so clamped debits and credits cancel to a residual of exactly zero and an arbitrarily unbalanced ledger certifies as clean. Reported rather than panicked because ledger input must never abort the CLI.

Implementations

impl BookingError

pub const fn with_account(self, account: Account) -> AccountedBookingError

Wrap this booking error with the account context that produced it.

Inventory itself doesn’t know which account it belongs to, so the raw BookingError carries no account field. The caller (booking engine, validator) knows the account and uses this constructor to produce the user-facing error.

The resulting AccountedBookingError is the single canonical rendering of an inventory failure for user-facing output. Both the booking layer and the validator format errors via this type so the wording cannot drift between them — the failure mode that produced #748.

Trait Implementations

impl Clone for BookingError

fn clone(&self) -> BookingError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BookingError

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

Formats the value using the given formatter.

impl Display for BookingError

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

Formats the value using the given formatter.

impl Eq for BookingError

impl Error for BookingError

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<OverflowError> for BookingError

fn from(e: OverflowError) -> Self

Converts to this type from the input type.

impl PartialEq for BookingError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for BookingError