Struct AuditEvent 

pub struct AuditEvent {

    pub event_id: String,
    pub timestamp_unix: u64,
    pub outcome: AuditOutcome,
    pub principal_pk_hex: String,
    pub executor_pk_hex: String,
    pub chain_depth: usize,
    pub chain_fingerprint: Option<String>,
    pub intent_hex: String,
    pub error_message: Option<String>,
    pub policy_name: Option<String>,
    pub request_id: Option<String>,
    pub trace_id: Option<String>,
    pub span_id: Option<String>,
    pub batch_size: Option<usize>,
    pub batch_outcomes: Option<Vec<AuditOutcome>>,
}

A structured record of a single authorization attempt.

Every call to [DyoloChain::authorize] or [DyoloChain::authorize_async] produces an AuditEvent. Pass an AuditSink implementation to [DyoloChain::authorize_with_audit] to capture these events.

The wire format is NDJSON-compatible: each event serializes to a single JSON object on one line. Feed directly into Splunk, Datadog Logs, Elasticsearch, or any SIEM that accepts NDJSON.

NDJSON example

{"event_id":"a1b2c3d4...","timestamp_unix":1700000000,"outcome":"AUTHORIZED","principal_pk":"...","executor_pk":"...","chain_depth":2,"chain_fingerprint":"...","intent":"...","policy_name":"fintech-trading"}

Fields

event_id: String

timestamp_unix: u64

outcome: AuditOutcome

principal_pk_hex: String

executor_pk_hex: String

chain_depth: usize

chain_fingerprint: Option<String>

intent_hex: String

error_message: Option<String>

policy_name: Option<String>

request_id: Option<String>

trace_id: Option<String>

span_id: Option<String>

batch_size: Option<usize>

batch_outcomes: Option<Vec<AuditOutcome>>

Implementations

impl AuditEvent

pub fn new( outcome: AuditOutcome, principal_pk_hex: String, executor_pk_hex: String, chain_depth: usize, intent: &IntentHash, timestamp_unix: u64, ) -> Self

pub fn with_fingerprint(self, fp: [u8; 32]) -> Self

pub fn with_error(self, msg: impl Into<String>) -> Self

pub fn with_policy(self, name: impl Into<String>) -> Self

pub fn with_request_id(self, id: impl Into<String>) -> Self

pub fn with_trace( self, trace_id: impl Into<String>, span_id: impl Into<String>, ) -> Self

pub fn with_batch_info(self, size: usize, outcomes: Vec<AuditOutcome>) -> Self

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 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.