Struct TreeBuildOutput 

pub struct TreeBuildOutput {
    pub root_hash: [u8; 32],
    pub root_bytes: Vec<u8>,
    pub root_depth: u8,
    pub total_bytes: u64,
    pub chunk_count: u64,
    pub trailing_nodes: Vec<ClosedNode>,
}

Output of TreeBuilder::finalize. The root node lives in root_hash + root_bytes + root_depth; every other node closed during finalize is in trailing_nodes and must be persisted before the BlobRef::Tree is published.

Nodes closed during streaming (via TreeBuilder::push_chunk) are returned by that call directly; trailing_nodes carries only the cascade-on-finalize closures.

Fields

root_hash: [u8; 32]

BLAKE3 of the root TreeNode.

root_bytes: Vec<u8>

Postcard-encoded root TreeNode bytes. Empty Vec signals “already in chunk store; skip persist” — used by the finalize-time streamed-child peel when the root was promoted from a streamed ClosedNode that the streaming-store caller has already persisted. Callers MUST check root_bytes.is_empty() before invoking store_chunk(&root_hash, &root_bytes) and skip the store when empty (the bytes are already content-addressed at root_hash from streaming).

root_depth: u8

Total tree depth — 1 for a single-leaf tree (root IS the leaf), increasing by one per additional internal level. Capped at MAX_TREE_DEPTH.

total_bytes: u64

Sum of every leaf chunk’s size across the whole tree.

chunk_count: u64

Number of chunks accumulated across all leaves.

trailing_nodes: Vec<ClosedNode>

Non-root nodes closed during finalize, in deepest-first order. The caller persists each before publishing the final BlobRef::Tree.

Trait Implementations

impl Clone for TreeBuildOutput

fn clone(&self) -> TreeBuildOutput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TreeBuildOutput

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

Formats the value using the given formatter.

impl PartialEq for TreeBuildOutput

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

impl StructuralPartialEq for TreeBuildOutput