Trait NodeCodec 

pub trait NodeCodec: Sized {
    type Error: Error;
    type HashOut: AsRef<[u8]> + AsMut<[u8]> + Default + MaybeDebug + PartialEq + Eq + Hash + Send + Sync + Clone + Copy;

    // Required methods
    fn hashed_null_node() -> Self::HashOut;
    fn decode_plan(data: &[u8]) -> Result<NodePlan, Self::Error>;
    fn is_empty_node(data: &[u8]) -> bool;
    fn empty_node() -> &'static [u8] ;
    fn leaf_node(partial: Partial<'_>, value: &[u8]) -> Vec<u8> ;
    fn extension_node(
        partial: impl Iterator<Item = u8>,
        number_nibble: usize,
        child_ref: ChildReference<Self::HashOut>,
    ) -> Vec<u8> ;
    fn branch_node(
        children: impl Iterator<Item = impl Borrow<Option<ChildReference<Self::HashOut>>>>,
        value: Option<&[u8]>,
    ) -> Vec<u8> ;
    fn branch_node_nibbled(
        partial: impl Iterator<Item = u8>,
        number_nibble: usize,
        children: impl Iterator<Item = impl Borrow<Option<ChildReference<Self::HashOut>>>>,
        value: Option<&[u8]>,
    ) -> Vec<u8> ;

    // Provided method
    fn decode(data: &[u8]) -> Result<Node<'_>, Self::Error> { ... }
}

Trait for trie node encoding/decoding.

Required Associated Types

type Error: Error

Codec error type.

type HashOut: AsRef<[u8]> + AsMut<[u8]> + Default + MaybeDebug + PartialEq + Eq + Hash + Send + Sync + Clone + Copy

Output type of encoded node hasher.

Required Methods

fn hashed_null_node() -> Self::HashOut

Get the hashed null node.

fn decode_plan(data: &[u8]) -> Result<NodePlan, Self::Error>

Decode bytes to a NodePlan. Returns Self::E on failure.

fn is_empty_node(data: &[u8]) -> bool

Check if the provided bytes correspond to the codecs “empty” node.

fn empty_node() -> &'static [u8]

Returns an encoded empty node.

fn leaf_node(partial: Partial<'_>, value: &[u8]) -> Vec<u8>

Returns an encoded leaf node

fn extension_node( partial: impl Iterator<Item = u8>, number_nibble: usize, child_ref: ChildReference<Self::HashOut>, ) -> Vec<u8>

Returns an encoded extension node Note that number_nibble is the number of element of the iterator it can possibly be obtain by Iterator size_hint, but for simplicity it is used directly as a parameter.

fn branch_node( children: impl Iterator<Item = impl Borrow<Option<ChildReference<Self::HashOut>>>>, value: Option<&[u8]>, ) -> Vec<u8>

Returns an encoded branch node. Takes an iterator yielding ChildReference<Self::HashOut> and an optional value.

fn branch_node_nibbled( partial: impl Iterator<Item = u8>, number_nibble: usize, children: impl Iterator<Item = impl Borrow<Option<ChildReference<Self::HashOut>>>>, value: Option<&[u8]>, ) -> Vec<u8>

Returns an encoded branch node with a possible partial path. number_nibble is the partial path length as in extension_node.

Provided Methods

fn decode(data: &[u8]) -> Result<Node<'_>, Self::Error>

Decode bytes to a Node. Returns Self::E on failure.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors