Struct SlotPath 

pub struct SlotPath(pub SmallVec<[Key; 8]>);

Path from the root cnode through nested cnodes to a slot.

The sequence of Keys walked through nested Cap::CNode slots; the final key is the target. An empty path is invalid (must address some slot). Backed by a [SmallVec] sized to MAX_SOURCE_DEPTH so a typical (shallow) path stays inline; the SSZ wire/hash form is identical to Vec<Key> (forwarded via #[ssz(transparent)]).

Example: SlotPath::root(Key::from(7)) addresses slot 7 of the root cnode; a two-step path addresses a slot of the Cap::CNode held in the first step’s slot.

Tuple Fields

0: SmallVec<[Key; 8]>

Implementations

impl SlotPath

pub fn root(key: Key) -> Self

Construct from a single root-cnode slot key.

pub fn new(steps: impl IntoIterator<Item = Key>) -> Result<Self, CapError>

Construct from a list of steps. Returns Err if empty.

pub fn steps(&self) -> &[Key]

The steps of this path (non-empty by construction).

pub fn len(&self) -> usize

Number of steps.

pub fn is_empty(&self) -> bool

True iff this path has no steps. A well-formed path is never empty; this exists for the clippy::len_without_is_empty lint and decode guards.

pub fn is_root_slot(&self) -> bool

True iff this path addresses a slot in the root cnode (one step).

pub fn target(&self) -> Option<&Key>

The target slot key (the deepest cnode this path addresses).

Returns None only for a malformed empty path (construction forbids it; the decode/image_cap paths reject empty paths eagerly).

pub fn prefix(&self) -> &[Key]

All steps before the target — the nested-cnode keys to walk.

Trait Implementations

impl Archive for SlotPath

where SmallVec<[Key; 8]>: Archive,

const COPY_OPTIMIZATION: CopyOptimization<Self>

An optimization flag that allows the bytes of this type to be copied directly to a writer instead of calling serialize.

type Archived = ArchivedSlotPath

The archived representation of this type.

type Resolver = SlotPathResolver

The resolver for this type. It must contain all the additional information from serializing needed to make the archived type from the normal type.

fn resolve(&self, resolver: Self::Resolver, out: Place<Self::Archived>)

Creates the archived version of this value at the given position and writes it to the given output.

impl Clone for SlotPath

fn clone(&self) -> SlotPath

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SlotPath

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

Formats the value using the given formatter.

impl Decode for SlotPath

fn is_ssz_fixed_len() -> bool

true iff this type is fixed-length.

fn ssz_fixed_len() -> usize

Number of bytes this type occupies in the fixed-length portion of a container encoding. Variable-length types return [BYTES_PER_LENGTH_OFFSET].

fn from_ssz_bytes(bytes: &[u8]) -> Result<Self, DecodeError>

Decode a full instance from bytes, rejecting trailing input.

impl<__D: Fallible + ?Sized> Deserialize<SlotPath, __D> for Archived<SlotPath>

where SmallVec<[Key; 8]>: Archive, <SmallVec<[Key; 8]> as Archive>::Archived: Deserialize<SmallVec<[Key; 8]>, __D>,

fn deserialize( &self, deserializer: &mut __D, ) -> Result<SlotPath, <__D as Fallible>::Error>

Deserializes using the given deserializer

impl Encode for SlotPath

fn is_ssz_fixed_len() -> bool

true iff this type is fixed-length (no variable-length fields).

fn ssz_fixed_len() -> usize

Number of bytes this type occupies in the fixed-length portion of a container encoding. For variable-length types this returns [BYTES_PER_LENGTH_OFFSET] (i.e. the size of the offset slot).

fn is_basic_type() -> bool

true for “basic” SSZ types (uintN, bool), which pack adjacent elements into shared 32-byte chunks for merkleization. Composite types (containers, lists, structs) return false (the default).

fn ssz_bytes_len(&self) -> usize

Total size of self when serialized.

fn ssz_append(&self, buf: &mut Vec<u8>)

Append the encoding of self to buf.

fn as_ssz_bytes(&self) -> Vec<u8>

Serialize into a fresh Vec<u8> allocated through the global allocator.

impl Hash for SlotPath

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 HashTreeRoot for SlotPath

fn hash_tree_root<__D: Digest<OutputSize = U32>>(&self) -> [u8; 32]

Compute the hash tree root using D as the underlying hash.

impl PartialEq for SlotPath

fn eq(&self, other: &SlotPath) -> 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<__S: Fallible + ?Sized> Serialize<__S> for SlotPath

where SmallVec<[Key; 8]>: Serialize<__S>,

fn serialize( &self, serializer: &mut __S, ) -> Result<<Self as Archive>::Resolver, <__S as Fallible>::Error>

Writes the dependencies for the object and returns a resolver that can create the archived type.

impl Eq for SlotPath

impl StructuralPartialEq for SlotPath