Struct Event 

pub struct Event<P> {
    pub header: EventHeader,
    pub payload: P,
    pub hash_chain: Option<HashChain>,
}

A complete event with header and payload.

The payload is generic to allow different event types to have different payload structures while sharing the same header format.

Fields

header: EventHeader

payload: P

hash_chain: Option<HashChain>

Hash chain for tamper-evident audit trail (Blake3 hash of parent + self). None for genesis events.

Implementations

impl<P> Event<P>

pub fn new(header: EventHeader, payload: P) -> Self

Create a new event with the given header and payload (genesis event, no hash chain).

pub fn with_hash_chain( header: EventHeader, payload: P, hash_chain: HashChain, ) -> Self

Create a new event with the given header, payload, and hash chain.

pub fn event_id(&self) -> EventId

Get the event ID.

pub fn event_kind(&self) -> EventKind

Get the event kind.

pub fn correlation_id(&self) -> EventId

Get the correlation ID.

pub fn position(&self) -> DagPosition

Get the DAG position.

pub fn map_payload<Q, F: FnOnce(P) -> Q>(self, f: F) -> Event<Q>

Map the payload to a different type.

impl<P: Serialize> Event<P>

pub fn compute_hash(&self) -> [u8; 32]

Compute Blake3 hash of this event’s content (header + payload).

Hashes only header and payload — the hash_chain field is excluded to avoid a circular dependency (event_hash cannot include itself).

pub fn verify(&self, parent_hash: &[u8; 32]) -> bool

Verify this event against a parent hash using Blake3. Returns true for genesis events (no hash chain).

pub fn is_genesis(&self) -> bool

Check if this is a genesis event (no parent).

Trait Implementations

impl<P: Clone> Clone for Event<P>

fn clone(&self) -> Event<P>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P> ComposeSchema for Event<P>

where P: ToSchema,

fn compose(generics: Vec<RefOr<Schema>>) -> RefOr<Schema>

impl<P: Debug> Debug for Event<P>

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

Formats the value using the given formatter.

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

where P: Deserialize<'de>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<P: PartialEq> PartialEq for Event<P>

fn eq(&self, other: &Event<P>) -> 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<P> Serialize for Event<P>

where P: Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<P> ToSchema for Event<P>

where P: ToSchema,

fn name() -> Cow<'static, str>

Return name of the schema.

fn schemas(schemas: &mut Vec<(String, RefOr<Schema>)>)

Implement reference [utoipa::openapi::schema::Schema]s for this type.

impl<P: Eq> Eq for Event<P>

impl<P> StructuralPartialEq for Event<P>