Struct AuditTrail 

pub struct AuditTrail { /* private fields */ }

A tamper-evident audit trail with cryptographic hash chain.

Each entry is cryptographically linked to the previous entry using blake3 hashing. This makes it possible to detect any tampering with historical entries.

Implementations

impl AuditTrail

pub fn new(max_entries: usize) -> Self

Create a new audit trail.

pub fn len(&self) -> usize

Get the current number of entries.

pub fn is_empty(&self) -> bool

Check if the trail is empty.

pub fn append( &self, actor: AgentId, action: AuditAction, resource: String, ) -> HashDigest

Append an audit entry. Computes hash chain automatically.

pub fn append_with_meta( &self, actor: AgentId, action: AuditAction, resource: String, metadata: Option<Value>, ) -> HashDigest

Append an audit entry with optional metadata.

pub fn verify(&self) -> Result<bool, AuditError>

Verify the integrity of the hash chain.

The chain is valid if:

• The first entry has prev_hash “genesis” or “pruned” (after auto-pruning)
• Every subsequent entry’s prev_hash matches the previous entry’s hash
• Every entry’s hash can be independently recomputed

pub fn entries(&self, from_seq: u64, to_seq: u64) -> Vec<AuditEntry>

Get entries within a sequence range (inclusive).

pub fn all_entries(&self) -> Vec<AuditEntry>

Get all entries.

pub fn by_agent(&self, agent_id: &str) -> Vec<AuditEntry>

Query entries by agent ID.

pub fn by_action(&self, action: &AuditAction) -> Vec<AuditEntry>

Query entries by action type.

pub fn by_action_type(&self, type_name: &str) -> Vec<AuditEntry>

Query entries by action discriminant (for faster lookup).

pub fn export_json(&self, from_seq: u64) -> Result<String, AuditError>

Export entries from a sequence number as JSON.

pub fn export_all_json(&self) -> Result<String, AuditError>

Export all entries as JSON.

pub fn flush(&self, state_store: &StateStore) -> Result<(), AuditError>

Flush entries to the state store for persistence.

pub fn restore_from(&self, entries: Vec<AuditEntry>)

Restore previously persisted entries.

Sets seq_counter to max(entries.seq) + 1 so new entries don’t collide with restored ones. Trims to max_entries if the restored set is larger, re-linking the hash chain.

Trait Implementations

impl Debug for AuditTrail

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

Formats the value using the given formatter.

impl Default for AuditTrail

fn default() -> Self

Returns the “default value” for a type.