Struct OriginTrail 

pub struct OriginTrail { /* private fields */ }

The derivation walk from producing material toward one generated unit.

Edges are held in walk order, and there is always at least one of them.

Implementations

impl OriginTrail

pub fn encode_into(&self, into: &mut Vec<u8>)

Appends this trail’s canonical bytes: the edge count, then every edge in walk order.

impl OriginTrail

pub fn from_edge(edge: OriginEdge) -> Self

The one-edge trail, for a unit whose origin is a single act.

pub fn drawn(offered: Vec<OriginEdge>) -> Result<Self, TrailError>

Draws the walk these edges make, in the order they are offered.

Errors

The two questions are dependent, and continuity is settled first: the ceiling is a fact about how long a WALK may be, so measuring a sequence that is not one would be measuring the wrong thing. Returns TrailError::Discontinuous naming the first edge that does not start where its predecessor ended, then TrailError::Empty or TrailError::Overflow when a joined walk does not fit the trail. A walk that does not fit refuses rather than truncating, because a truncated walk is how an origin silently becomes a span.

pub fn first(&self) -> &OriginEdge

The edge the walk starts at, which every trail has.

pub fn edges(&self) -> &NonEmpty<OriginEdge, ORIGIN_EDGE_LIMIT>

The edges, in the order the trail walks them.

Ordering

Walk order is the trail’s own meaning — it is the derivation path from producing material toward the generated unit — so an identity may be derived from it.

Trait Implementations

impl Clone for OriginTrail

fn clone(&self) -> OriginTrail

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OriginTrail

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

Formats the value using the given formatter.

impl Eq for OriginTrail

impl Hash for OriginTrail

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for OriginTrail

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for OriginTrail