Enum ReceiptsMode 

pub enum ReceiptsMode {
    BestEffort,
    Durable,
}

Controls what happens to audit traces when the background writer channel is full.

• BestEffort — try_send drops the trace and increments firstpass_traces_dropped_total; bounded memory, zero added latency. The hash chain over persisted traces stays valid; a dropped trace is simply absent.
• Durable — on TrySendError::Full the trace is serialised as a JSON line and appended (with sync_data) to <db_path>.spill.jsonl. The background writer drains the spill file at startup and whenever the channel empties, inserting spilled traces BEFORE new channel arrivals so the hash chain remains append-only and valid. The blocking fs append on the hot path is the DELIBERATE tradeoff of durable mode — it only fires under sustained backpressure; switch to best_effort if disk latency under load is unacceptable.

Variants

BestEffort

Drop traces when the writer channel is full (default — bounded memory, zero latency impact).

Durable

Spill traces to disk when the writer channel is full; drain and recover on the next boot or whenever the channel empties.

Trait Implementations

impl Clone for ReceiptsMode

fn clone(&self) -> ReceiptsMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ReceiptsMode

impl Debug for ReceiptsMode

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

Formats the value using the given formatter.

impl Default for ReceiptsMode

fn default() -> ReceiptsMode

Returns the “default value” for a type.

impl Eq for ReceiptsMode

impl PartialEq for ReceiptsMode

fn eq(&self, other: &ReceiptsMode) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ReceiptsMode