Struct LedgerEntry 

pub struct LedgerEntry {
    pub timestamp: DateTime<Utc>,
    pub tool_id: String,
    pub args_hash: Digest256,
    pub idempotency_key: String,
    pub result_hash: Digest256,
    pub side_effect_class: SideEffectClass,
    pub session_hmac: String,
}

A single ledger entry. Wire format effects.entry.v1.

Fields

timestamp: DateTime<Utc>

Wall-clock timestamp at the moment the tool call was issued.

tool_id: String

Tool identifier as registered with the crate::ToolProxy.

args_hash: Digest256

SHA-256 of the canonical-JSON-serialized tool args.

idempotency_key: String

Per-call idempotency key. ULID-shaped for sortability; the proxy mints these and persists them so a re-issued call after restore reuses the key and is therefore safe under Idempotent semantics.

result_hash: Digest256

SHA-256 of the canonical-JSON-serialized tool result.

side_effect_class: SideEffectClass

Tool author’s declared side-effect class.

session_hmac: String

HMAC chain: HMAC(session_secret, prev_entry_hash || this_entry_minus_hmac). Hex-encoded.

Implementations

impl LedgerEntry

pub fn entry_hash_without_hmac(&self) -> Result<Digest256>

SHA-256 of the canonical-JSON serialization of this entry with session_hmac = "". Used both for chaining and for storage CAS.

Trait Implementations

impl Clone for LedgerEntry

fn clone(&self) -> LedgerEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LedgerEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LedgerEntry

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LedgerEntry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.