Struct IdentityLedger 

pub struct IdentityLedger { /* private fields */ }

In-memory attribution ledger grouped by the strongest available identity key.

Implementations

impl IdentityLedger

pub fn new() -> Self

Creates an empty identity ledger.

pub fn record( &mut self, identity: &CallerIdentity, consumed: usize, saved: usize, accepted: bool, )

Records token usage, savings, and outcome acceptance for a caller.

pub fn attribution_for(&self, key: &str) -> Option<&IdentityAttribution>

Returns attribution recorded under an identity key.

pub fn top_consumers(&self, limit: usize) -> Vec<&IdentityAttribution>

Returns up to limit entries ordered by descending token consumption.

pub fn top_savers(&self, limit: usize) -> Vec<&IdentityAttribution>

Returns up to limit entries ordered by descending token savings.

pub fn total_tokens(&self) -> usize

Returns total tokens consumed across all identities.

pub fn total_savings(&self) -> usize

Returns total tokens saved across all identities.

pub fn summary(&self) -> IdentityLedgerSummary

Summarizes distinct identities and aggregate token efficiency.

Trait Implementations

impl Clone for IdentityLedger

fn clone(&self) -> IdentityLedger

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IdentityLedger

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

Formats the value using the given formatter.

impl Default for IdentityLedger

fn default() -> IdentityLedger

Returns the “default value” for a type.