Struct SubtreePrefetchResponse 

pub struct SubtreePrefetchResponse {
    pub subtrees: Vec<SubtreeData>,
    pub not_found: Vec<[u8; 32]>,
}

Response containing prefetched subtrees.

Fields

subtrees: Vec<SubtreeData>

Fetched subtrees.

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

not_found: Vec<[u8; 32]>

Subtree roots that were not found.

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

Implementations

impl SubtreePrefetchResponse

pub fn new(subtrees: Vec<SubtreeData>, not_found: Vec<[u8; 32]>) -> Self

Create a new response.

pub fn complete(subtrees: Vec<SubtreeData>) -> Self

Create a response with no missing subtrees.

pub fn not_found(roots: Vec<[u8; 32]>) -> Self

Create an empty/not-found response.

pub fn is_complete(&self) -> bool

Check if all requested subtrees were found.

pub fn is_empty(&self) -> bool

Check if response is empty (no subtrees and none not found).

pub fn total_entity_count(&self) -> usize

Total number of entities across all subtrees.

Uses saturating arithmetic to prevent overflow from malicious input.

pub fn subtree_count(&self) -> usize

Number of subtrees returned.

pub fn is_valid(&self) -> bool

Check if response is within valid bounds.

Call this after deserializing from untrusted sources to prevent resource exhaustion attacks. Validates both response size, total entity count, and all contained subtrees.

Trait Implementations

impl BorshDeserialize for SubtreePrefetchResponse

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 SubtreePrefetchResponse

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

impl Clone for SubtreePrefetchResponse

fn clone(&self) -> SubtreePrefetchResponse

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SubtreePrefetchResponse

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

Formats the value using the given formatter.

impl PartialEq for SubtreePrefetchResponse

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