Struct LevelWiseRequest 

pub struct LevelWiseRequest {
    pub level: usize,
    pub parent_ids: Option<Vec<[u8; 32]>>,
}

Request for level-wise breadth-first synchronization.

Processes the tree level-by-level, comparing hashes at each level. Efficient for wide, shallow trees with scattered changes.

Use when:

• max_depth <= 2
• Wide trees with many children at each level
• Changes scattered across siblings

Fields

level: usize

Level to request (0 = root’s children, 1 = grandchildren, etc.).

parent_ids: Option<Vec<[u8; 32]>>

Parent IDs to fetch children for (None = fetch all at this level). Used to narrow down which subtrees to explore.

Limited to MAX_PARENTS_PER_REQUEST entries. Use is_valid() to check bounds after deserialization from untrusted sources.

Implementations

impl LevelWiseRequest

pub fn at_level(level: usize) -> Self

Request all nodes at a given level.

pub fn for_parents(level: usize, parent_ids: Vec<[u8; 32]>) -> Self

Request children of specific parents at a given level.

pub fn is_full_level(&self) -> bool

Check if this requests all nodes at the level.

pub fn parent_count(&self) -> Option<usize>

Get number of parents being queried (None if full level).

pub fn is_valid(&self) -> bool

Check if request is within valid bounds.

Call this after deserializing from untrusted sources to prevent resource exhaustion attacks.

Trait Implementations

impl BorshDeserialize for LevelWiseRequest

fn deserialize_reader<__R: Read>(reader: &mut __R) -> Result<Self, Error>

fn deserialize(buf: &mut &[u8]) -> Result<Self, Error>

Deserializes this instance from a given slice of bytes. Updates the buffer to point at the remaining bytes.

fn try_from_slice(v: &[u8]) -> Result<Self, Error>

Deserialize this instance from a slice of bytes.

fn try_from_reader<R>(reader: &mut R) -> Result<Self, Error>

where R: Read,

impl BorshSerialize for LevelWiseRequest

fn serialize<__W: Write>(&self, writer: &mut __W) -> Result<(), Error>

impl Clone for LevelWiseRequest

fn clone(&self) -> LevelWiseRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LevelWiseRequest

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

Formats the value using the given formatter.

impl PartialEq for LevelWiseRequest

fn eq(&self, other: &LevelWiseRequest) -> 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 StructuralPartialEq for LevelWiseRequest