Struct AuditStore 

pub struct AuditStore { /* private fields */ }

Persistent, capacity-bounded store of execution traces.

Implementations

impl AuditStore

pub fn new() -> Self

Create a new store with the default capacity of 1 000 traces.

pub fn with_merkle_chain() -> Self

Create a new store with Merkle chain integrity verification enabled.

pub fn add_trace(&mut self, trace: ExecutionTrace)

Add a trace to the store, evicting the oldest trace when capacity is reached. If the Merkle chain is enabled, the serialized trace is appended to the chain for tamper-evident integrity.

pub fn verify_integrity(&self) -> Option<VerificationResult>

Verify the integrity of the Merkle chain.

Returns Some(VerificationResult) if the chain is enabled, or None.

pub fn merkle_root_hash(&self) -> Option<String>

Return the root hash of the Merkle chain, if enabled.

pub fn merkle_chain(&self) -> Option<&MerkleChain>

Access the underlying Merkle chain, if present.

pub fn traces(&self) -> &[ExecutionTrace]

Get a slice of all stored traces.

pub fn get_trace(&self, trace_id: Uuid) -> Option<&ExecutionTrace>

Look up a trace by its trace_id.

pub fn query(&self, query: &AuditQuery) -> Vec<&ExecutionTrace>

Run a structured query against the store and return matching traces.

pub fn latest(&self, n: usize) -> Vec<&ExecutionTrace>

Return the n most recently added traces (most recent last).

pub fn save(&self, path: &Path) -> Result<(), AuditError>

Persist the store to a JSON file at the given path.

pub fn load(path: &Path) -> Result<Self, AuditError>

Load a store from a JSON file at the given path.

pub fn load_with_merkle(path: &Path) -> Result<Self, AuditError>

Load a store from a JSON file and rebuild the Merkle chain from the loaded traces.

pub fn len(&self) -> usize

Return the number of stored traces.

pub fn is_empty(&self) -> bool

Check whether the store is empty.

Trait Implementations

impl Default for AuditStore

fn default() -> Self

Returns the “default value” for a type.