Struct Event 

pub struct Event {
    pub kind: EventKind,
    pub actor: String,
    pub subject: String,
    pub payload: Value,
}

The input half of an audit entry — everything the caller supplies.

Once persisted, the audit log attaches position, prev_hash, and this_hash, producing a StoredEvent.

Fields

kind: EventKind

actor: String

Agent that triggered this event (sender, org admin, scanner). Empty string is permitted for system-level events.

subject: String

Logical subject of the event: transfer_id, agent_id, etc. Empty means the actor itself is the subject.

payload: Value

Structured payload. Must be a JSON object; arrays/primitives at the top level are rejected to avoid ambiguous canonical output.

Implementations

impl Event

pub fn new( kind: EventKind, actor: impl Into<String>, subject: impl Into<String>, payload: Value, ) -> Self

pub fn canonical_bytes( &self, ts: OffsetDateTime, prev_hash: &str, ) -> AuditResult<Vec<u8>>

Produce the canonical byte string that will be hashed into the chain. Format:

{"kind":"...","actor":"...","subject":"...","payload":<canonical>,"ts":"RFC3339","prev":"..."}

Key order is fixed; payload is canonicalized recursively (sorted object keys, no whitespace). This bytestring uniquely determines this_hash given a stable input.

pub fn compute_hash( &self, ts: OffsetDateTime, prev_hash: &str, ) -> AuditResult<String>

Compute the hash an event would carry given timestamp + previous chain head.

Trait Implementations

impl Clone for Event

fn clone(&self) -> Event

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Event

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Event

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Event

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

where __S: Serializer,

Serialize this value into the given Serde serializer.