Struct RandomXorb 

pub struct RandomXorb { /* private fields */ }

A XORB that generates its chunk data on-the-fly from random seeds.

This allows testing with massive files without actually storing the data in memory. Each chunk is defined by a seed and size, and the data is generated deterministically using SmallRng when needed.

Implementations

impl RandomXorb

pub fn new(chunk_specs: &[(u64, u32)]) -> Self

Creates a new RandomXorb from a list of (seed, size) pairs.

The chunk data is generated deterministically from each seed, and chunk hashes are computed and cached.

pub fn from_seed(seed: u64, num_chunks: u32, chunk_size: u32) -> Self

Creates a new RandomXorb from a seed, number of chunks, and chunk size.

Each chunk gets a unique sub-seed derived from the main seed.

pub fn num_chunks(&self) -> u32

Returns the number of chunks in this XORB.

pub fn xorb_hash(&self) -> MerkleHash

Returns the hash of the XORB.

pub fn chunk_hash(&self, idx: u32) -> Option<MerkleHash>

Returns the hash of a specific chunk.

pub fn chunk_size(&self, idx: u32) -> Option<u32>

Returns the uncompressed size of a specific chunk.

pub fn total_uncompressed_size(&self) -> u64

Returns the total uncompressed size of all chunks.

pub fn chunk_range_size(&self, start: u32, end: u32) -> u64

Returns the total uncompressed size for a range of chunks [start, end).

pub fn chunk_hash_sizes(&self, start: u32, end: u32) -> Vec<(MerkleHash, u64)>

Returns (hash, size) pairs for a range of chunks [start, end). This is useful for computing file hashes.

pub fn chunk_hashes_range(&self, start: u32, end: u32) -> Vec<MerkleHash>

Returns the chunk hashes for a range of chunks [start, end).

pub fn get_chunk_data(&self, idx: u32) -> Option<Bytes>

Generates and returns the raw data for a specific chunk.

pub fn get_chunk_range_data(&self, start: u32, end: u32) -> Option<Bytes>

Generates and returns the raw data for a range of chunks [start, end).

pub fn get_xorb_object(&self) -> XorbObject

Returns the XorbObject header/footer for this XORB.

Uses no compression (CompressionScheme::None) for all chunks.

pub fn serialized_length(&self) -> u64

Returns the total serialized length of the XORB (chunks + footer).

pub fn get_serialized_range(&self, start: u64, end: u64) -> Bytes

Returns the serialized bytes for a range within the XORB.

This generates the bytes on-the-fly, including chunk headers and data. The range is in terms of the serialized byte positions.

pub fn get_full_serialized(&self) -> Bytes

Returns the full serialized XORB.

Note: This materializes the entire XORB, which may be large. Prefer get_serialized_range for partial access.

Trait Implementations

impl Clone for RandomXorb

fn clone(&self) -> RandomXorb

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RandomXorb

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

Formats the value using the given formatter.