Struct Usage 

pub struct Usage {
    pub schema_version: u32,
    pub period: String,
    pub created_at: String,
    pub agent_id: String,
    pub metered_events: usize,
    pub net_saved_tokens: u64,
    pub saved_usd: f64,
    pub last_entry_hash: String,
    pub chain_valid: bool,
    pub signed: bool,
}

A billable usage record for a metering period. Carries only counts, sums, and provenance hashes — no paths, prompts, or content (inherited from RoiReport’s privacy guarantee).

Fields

schema_version: u32

Schema version of the metering record.

period: String

Coverage window ("all" today).

created_at: String

When the record was produced.

agent_id: String

The agent/machine identity the ledger belongs to.

metered_events: usize

Number of metered events (tool invocations that produced savings).

net_saved_tokens: u64

Net tokens saved over the period — the primary usage signal.

saved_usd: f64

USD value of the savings over the period.

last_entry_hash: String

Chain head committing the full event history.

chain_valid: bool

Whether the SHA-256 chain verified intact.

signed: bool

Whether the source aggregate was Ed25519-signed.

Implementations

impl Usage

pub const SCHEMA_VERSION: u32 = 1

Schema version emitted by this build.

pub fn from_roi(roi: &RoiReport) -> Self

Derive a usage record from an ROI report.

pub fn is_billable(&self) -> bool

Whether this usage record is safe to bill on: it must derive from an intact, signed chain. Unsigned/broken aggregates are observable locally but are not billable (fail-closed for billing, never for the user).

pub fn headline(&self) -> String

Compact one-line metering headline.

Trait Implementations

impl Clone for Usage

fn clone(&self) -> Usage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Usage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Usage

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Usage

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Usage

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 Usage