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) -> AuditTrail

Create a new audit trail with the given maximum entry count.

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: String, action: AuditAction, resource: String, ) -> String

Append an audit entry. Computes hash chain automatically.

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

Append an audit entry with optional metadata.

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

Verify the integrity of the hash chain.

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

Get entries within a sequence range (inclusive).

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

Get all entries.

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

Query entries by agent ID.

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

Query entries by exact action match.

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

Query entries by action discriminant name (e.g., “ToolCall”, “AgentSpawn”).

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

Export entries from a sequence number as pretty JSON.

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

Export all entries as pretty JSON.

pub fn flush_to(&self, store: &dyn AuditPersistence) -> Result<(), Error>

Flush entries to a persistence backend.

pub fn restore_from_store( &self, store: &dyn AuditPersistence, ) -> Result<(), Error>

Restore entries from a persistence backend.

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

Restore previously persisted entries directly.

Sets seq_counter to max(entries.seq) + 1 so new entries don’t collide with restored ones. Trims to max_entries if needed.

Trait Implementations

impl Debug for AuditTrail

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

Formats the value using the given formatter.

impl Default for AuditTrail

fn default() -> AuditTrail

Returns the “default value” for a type.