Struct ProvenanceLedger 

pub struct ProvenanceLedger {
    pub events: Vec<ProvenanceEvent>,
    pub lineage: Vec<LineageRecord>,
}

Validated immutable provenance participant content.

Fields

events: Vec<ProvenanceEvent>

Events ordered by (recorded_at, provenance_uuid).

lineage: Vec<LineageRecord>

Lineage ordered by event time and public history sort key.

Implementations

impl ProvenanceLedger

pub fn new( events: Vec<ProvenanceEvent>, lineage: Vec<LineageRecord>, ) -> Result<Self, ProvenanceError>

Validate, sort, and construct ledger content.

Errors

Rejects row limits, invalid versions/identities, duplicate IDs, dangling lineage, duplicate role ordinals, and non-canonical derived UUIDs.

pub fn merge(&self, staged: &Self) -> Result<Self, ProvenanceError>

Merge a staged ledger idempotently into an existing ledger.

Errors

Identical operation event-sets are idempotent. Reuse of an operation UUID with a different complete event-set, or reuse of an event, lineage, or role/ordinal identity with different canonical content conflicts.

pub fn event_batch(&self) -> Result<RecordBatch, ProvenanceError>

Build the authoritative event Arrow batch.

Errors

Returns a structured Arrow construction failure.

pub fn lineage_batch(&self) -> Result<RecordBatch, ProvenanceError>

Build the authoritative lineage Arrow batch.

Errors

Returns a structured Arrow construction failure.

pub fn from_batches( event_batches: &[RecordBatch], lineage_batches: &[RecordBatch], ) -> Result<Self, ProvenanceError>

Decode authoritative Arrow batches and re-run every domain invariant.

Errors

Rejects schema drift, nulls, malformed UUIDs, unknown closed values, unsupported versions, duplicates, dangling references, and row limits.

Trait Implementations

impl Clone for ProvenanceLedger

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProvenanceLedger

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

Formats the value using the given formatter.

impl Default for ProvenanceLedger

fn default() -> Self

Returns the “default value” for a type.

impl Eq for ProvenanceLedger

impl PartialEq for ProvenanceLedger

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ProvenanceLedger