Struct AuditEvent 

pub struct AuditEvent {
    pub ts: String,
    pub action: AuditAction,
    pub coordinate: Option<String>,
    pub environment: Option<String>,
    pub result: String,
    pub origin: Option<String>,
    pub fingerprint: Option<String>,
    pub requester_note: Option<String>,
}

One append-only audit entry. No field ever holds a value (I12); any fingerprint is the truncated form (§10.4).

Fields

ts: String

RFC-3339 UTC timestamp.

action: AuditAction

What happened.

coordinate: Option<String>

The coordinate acted on (an address, never a value).

environment: Option<String>

Environment.

result: String

Outcome / result text (e.g. allowed, denied:McpCriticalForbidden).

origin: Option<String>

Who initiated it (agent / human).

fingerprint: Option<String>

Truncated fingerprint (§10.4); never the full hash, never the value.

requester_note: Option<String>

Requester-supplied note, segregated as untrusted (mirrors I16).

Implementations

impl AuditEvent

pub fn new( clock: &dyn Clock, action: AuditAction, result: impl Into<String>, ) -> Self

Start an event stamped now by the clock.

pub fn at( self, coordinate: impl Into<String>, environment: impl Into<String>, ) -> Self

Record which coordinate (address) and environment the event concerns.

pub fn by(self, origin: Origin) -> Self

Record the initiating origin.

pub fn with_fingerprint(self, truncated: impl Into<String>) -> Self

Record a truncated fingerprint (callers must pass the truncated form from [crate::fingerprint], never a full hash or a value).

pub fn with_note(self, note: &Untrusted) -> Self

Attach a requester note, stored as the (untrusted) text.

Trait Implementations

impl Clone for AuditEvent

fn clone(&self) -> AuditEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AuditEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AuditEvent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AuditEvent

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AuditEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AuditEvent