Enum UsageSource 

pub enum UsageSource {
    Leased {
        lease_id: LeaseId,
        fencing_token: FencingToken,
    },
    Overage,
}

What funded the units in a UsageEvent.

Two variants, because two things fund spend and they are validated by opposite rules. A leased charge arrives with a capability the sink checks before it touches the ledger; an overage charge has no capability to check, because no lease existed to issue one.

Making this a sum type rather than a pair of Options is deliberate. A half-formed capability — a lease id with no token, or a token naming no lease — is the shape a sink would have to defend against, and here it cannot be written down. The storage schema mirrors the same constraint.

Variants

Leased

Spent from a lease. The sink requires the stored (lease_id, account_id, fencing_token) triple to match before the event may change either ledger; token age relative to another active lease is irrelevant (INVARIANTS.md GL-4).

Fields

lease_id: LeaseId

fencing_token: FencingToken

Overage

Admitted under EnforcementMode::Elastic with no lease behind it.

It carries no lease id on purpose, and must never be given one. Attributing unfunded spend to a real lease drives that lease’s used past its granted, which makes reclaim’s granted - used credit negative — a panic in the memory backend and a permanently failing transaction in Postgres, so the account’s expired leases would never be reclaimed again. Overage stands outside lease accounting entirely and is funded by its own ledger term.

Implementations

impl UsageSource

pub const fn lease_id(self) -> Option<LeaseId>

The lease this charge was spent from, or None for overage.

pub const fn fencing_token(self) -> Option<FencingToken>

The referenced lease’s capability token, or None for overage.

Trait Implementations

impl Clone for UsageSource

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for UsageSource

impl Debug for UsageSource

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UsageSource

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for UsageSource

impl PartialEq for UsageSource

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for UsageSource

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for UsageSource