pub struct WalAuditStore<S: AuditSigner> { /* private fields */ }Expand description
The authoritative tamper-evident audit store. Append-only journal + content-addressed CAS blobs, each record signed. WAL-durable on write.
§On-disk layout
<root>/
journal.log # append-only: one signed record per line (newline-framed
# <seq>\t<sig_hex>\t<payload_b64>\n)
checkpoint # signed head anchor, rewritten after every append:
# <seq>\t<head_hash_hex>\t<sig_hex>\n
cas/<ab>/<cdef…> # content-addressed blob per record: the canonical bytes,
# named by their BLAKE3 hex (name==bytes tamper check).The CAS layer gives a second tamper-evidence check (the blob’s name is its
hash). The journal is an append-only hash chain (each record carries its
predecessor’s hash), and the signed checkpoint anchors the head so a
truncated tail is detected on open (see the module docs).
§What is NOT here (deferred)
- TODO(S7-followup): cross-host replication (gossip / OTLP log export to a central collector). The local store is tamper-evident; remote collection is a transport concern.
- TODO(S7-followup): retention / rotation. The journal grows unbounded today; a rotating appender + remote archival is a follow-up.
- TODO(S7-followup): policy-evolution feedback (denial bucketing → PolicyService). The records are here; the consumer is not.
Implementations§
Source§impl<S: AuditSigner> WalAuditStore<S>
impl<S: AuditSigner> WalAuditStore<S>
Sourcepub fn open(root: impl AsRef<Path>, signer: S) -> Result<Self, AuditError>
pub fn open(root: impl AsRef<Path>, signer: S) -> Result<Self, AuditError>
Open (or create) a store at root. The journal and CAS dir are created
if missing. The chain head (next seq + head_hash) is seeded from the
journal’s last record so a restart continues the chain monotonically.
Fail-closed truncation check: if a signed checkpoint exists and its
sequence is ahead of the journal’s last record, the tail was truncated
since the last durable write — open refuses to start
(AuditError::Truncation) rather than silently continuing on a shortened
log (which would re-seed the seq counter from the truncated head and
erase the evidence). Full cryptographic verification of the chain and the
checkpoint signature is verify_journal.
Sourcepub fn verify_journal<V: AuditVerifier>(
&self,
verifier: &V,
) -> Result<Vec<AuditRecord>, AuditError>
pub fn verify_journal<V: AuditVerifier>( &self, verifier: &V, ) -> Result<Vec<AuditRecord>, AuditError>
Read the whole journal back and verify it end-to-end: every signature
against verifier, the sequence gap-free, the prev_hash chain
intact, and — if present — the signed checkpoint’s signature and that it
anchors the journal’s actual head. Returns the records in order.
This is the offline/cryptographic counterpart to open’s
cheap runtime check: it catches tampering, reordering, and middle
deletion (chain break) as well as tail truncation and checkpoint
rollback (checkpoint vs. head mismatch).
Trait Implementations§
Source§impl<S: AuditSigner> AuditSink for WalAuditStore<S>
impl<S: AuditSigner> AuditSink for WalAuditStore<S>
Source§fn record(&self, record: &AuditRecord) -> Result<(), AuditError>
fn record(&self, record: &AuditRecord) -> Result<(), AuditError>
record. Returns Ok(()) only after the write is
durable (fsynced). The caller MUST treat Err as fail-closed.Auto Trait Implementations§
impl<S> !Freeze for WalAuditStore<S>
impl<S> !RefUnwindSafe for WalAuditStore<S>
impl<S> Send for WalAuditStore<S>
impl<S> Sync for WalAuditStore<S>
impl<S> Unpin for WalAuditStore<S>where
S: Unpin,
impl<S> UnsafeUnpin for WalAuditStore<S>where
S: UnsafeUnpin,
impl<S> UnwindSafe for WalAuditStore<S>where
S: UnwindSafe,
Blanket Implementations§
§impl<T> AnySync for T
impl<T> AnySync for T
§impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
§impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> FutureExt for T
impl<T> FutureExt for T
§fn with_context(self, otel_cx: Context) -> WithContext<Self>
fn with_context(self, otel_cx: Context) -> WithContext<Self>
§fn with_current_context(self) -> WithContext<Self>
fn with_current_context(self) -> WithContext<Self>
§impl<T> Identity for Twhere
T: ?Sized,
impl<T> Identity for Twhere
T: ?Sized,
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> IntoRequest<T> for T
impl<T> IntoRequest<T> for T
Source§fn into_request(self) -> Request<T>
fn into_request(self) -> Request<T>
T in a tonic::Request