Struct Packet 

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

One sealed packet: an ordered list of units, rooted in a predecessor.

Identity is over the whole node — payload and parent links together — so a packet cannot be re-parented without changing its id.

Implementations

impl Packet

pub fn genesis(units: Vec<UnitId>) -> Self

A packet with no predecessor.

pub fn following(prior: PacketId, units: Vec<UnitId>) -> Self

A packet linking prior as its predecessor.

pub fn units(&self) -> &[UnitId]

The units this packet seals, in order.

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

The predecessor links.

pub fn prior(&self) -> Option<PacketId>

The single predecessor, when there is exactly one.

v0 mints chains, so a packet has zero parents (genesis) or one.

pub fn is_genesis(&self) -> bool

Whether this packet starts a chain.

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

This packet’s address.

Errors

Propagates an encoding failure from the canonical form.

Trait Implementations

impl Clone for Packet

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 Packet

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 Packet

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

Formats the value using the given formatter.

impl Eq for Packet

impl PartialEq for Packet

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Packet

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 Packet

impl TryFrom<MerkleNode<PacketBody>> for Packet

fn try_from(raw: RawPacket) -> Result<Self, Self::Error>

The only way in from foreign bytes.

One rule, because the chain has one shape: at most one parent. Nothing else about a decoded packet is a claim this layer can check — whether the units it names exist, or admit, needs a store, and inventing one here would be v0 growing a storage service to answer a structural question.

Errors

PacketAdmitError::NotAChain when the node carries two or more parents.

type Error = PacketAdmitError

The type returned in the event of a conversion error.