Struct Event 

pub struct Event(/* private fields */);

An immutable event whose parent membership and derivation laws were checked.

Implementations

impl Event

pub fn new( body: EventBody, parents: impl IntoIterator<Item = ContentId>, resolve: impl Fn(&ContentId) -> Option<Event>, ) -> Result<Self, EventError>

Construct an event through the same boundary used for foreign bytes.

resolve supplies already admitted, authorized events. Root and payload resolution remain the storage layer’s job; see the module’s limits.

Errors

Returns EventError for missing/substituted links or invalid derivation.

pub fn admit( raw: RawEvent, resolve: impl Fn(&ContentId) -> Option<Event>, ) -> Result<Self, EventError>

Admit a decoded event after resolving and re-addressing every parent.

This checks one event against admitted parents, not an unbounded graph traversal. A durable reader must restore the closure in dependency order. An intervention with no derivation sources is generated from its explicit root at depth one; causal predecessors do not become its evidence.

Errors

Returns EventError if links, origins, source relations, or depth fail.

pub fn body(&self) -> &EventBody

The event’s admitted body, borrowed immutably.

pub fn parents(&self) -> &BTreeSet<ContentId>

Causal parents, separate from the publication packet’s predecessor.

pub fn depth(&self) -> u32

The depth established by admission.

pub fn id(&self) -> Result<ContentId, ContentError>

Address of the complete event body and causal parent set.

Errors

Propagates canonical encoding errors.

pub fn to_raw(&self) -> RawEvent

Clone the transparent encoding; modifications must pass admission again.

pub fn verify_elision( &self, unit: &Unit, source: &Event, bytes: &[u8], ) -> Result<Verified, EventError>

Verify an elision’s existing unit proof against its linked source event.

The unit proves the addressed byte span. The event adds inherited origin and depth, which v0’s byte-only unit cannot determine. This checks neither the pointer’s rendering nor the root’s authority; the consumer owns both.

Errors

Refuses mismatched unit/source/root links, then propagates verify_unit.

Trait Implementations

impl Clone for Event

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ContentAddressable for Event

fn canonical_form(&self) -> Result<Vec<u8>, ContentError>

Produce the deterministic byte representation of this value.

fn content_id(&self) -> Result<ContentId, ContentError>

Compute this value’s ContentId.

fn verify(&self, expected: &ContentId) -> Result<bool, ContentError>

Check whether this value’s content id matches an expected id.

fn ensure_content_id(&self, expected: &ContentId) -> Result<(), ContentError>

Verify, returning an error on mismatch instead of Ok(false).

impl Debug for Event

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

Formats the value using the given formatter.

impl Eq for Event

impl PartialEq for Event

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

Equality operator ==.

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

Inequality operator !=.

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.

impl StructuralPartialEq for Event