ReadSizedMerkleVerifier

Struct ReadSizedMerkleVerifier 

Source
pub struct ReadSizedMerkleVerifier { /* private fields */ }
Expand description

Verifies reads against a merkle tree.

MerkleVerifier verifies data at a granularity of BLOCK_SIZE. Consequently, it stores one hash (of size HASH_SIZE) for each data block. This hash storage consumes memory equal to 1/256th of the original data size.

ReadSizedMerkleVerifier optimizes memory usage when reads are always aligned and are guaranteed to be a multiple of the BLOCK_SIZE. Instead of storing a hash for every BLOCK_SIZE blocks like MerkleVerifier, it stores only one hash for each read sized chunk. For example, 128KiB aligned reads would require storing 1/16th the number of hashes.

Implementations§

Source§

impl ReadSizedMerkleVerifier

Source

pub fn new(verifier: MerkleVerifier, read_size: usize) -> Result<Self, Status>

Constructs a ReadSizedMerkleVerifier from an existing MerkleVerifier and a read_size.

Returns an error if read_size is not a multiple of BLOCK_SIZE.

Source

pub fn verify(&self, offset: usize, data: &[u8]) -> Result<(), Status>

Verifies a data slice against the Merkle tree, assuming it corresponds to original data starting at offset.

§Requirements:
  • The offset must be aligned to the configured read size granularity.
  • The length of data must be a multiple of the read size, except if data represents the final chunk of the original data source (in which case it can be shorter).

Trait Implementations§

Source§

impl Clone for ReadSizedMerkleVerifier

Source§

fn clone(&self) -> ReadSizedMerkleVerifier

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for ReadSizedMerkleVerifier

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.