Struct StateHasher 

pub struct StateHasher { /* private fields */ }

An explicit BLAKE3 writer for deterministic state.

The encoding is schema-driven: each write appends its fixed-width little-endian bytes without a type tag, and bytes and sequence prefix a u32 length. The schema is the shape of the primitive writes: which methods, in what order. Write sequences with the same schema hash differently whenever their values differ, provided each CanonicalWrite it uses is self-delimiting. Different schemas may encode alike — u16(0x1234) equals u8(0x34); u8(0x12) — so a caller that hashes several kinds of state in one stream, or changes what it writes, separates them itself with a leading tag or version (for example u32(KIND)).

Implementations

impl StateHasher

pub fn new() -> Self

Creates an empty state hasher.

pub fn u8(&mut self, value: u8)

Appends one byte.

pub fn u16(&mut self, value: u16)

Appends a two-byte little-endian integer.

pub fn u32(&mut self, value: u32)

Appends a four-byte little-endian integer.

pub fn u64(&mut self, value: u64)

Appends an eight-byte little-endian integer.

pub fn i32(&mut self, value: i32)

Appends a signed four-byte little-endian integer.

pub fn i64(&mut self, value: i64)

Appends a signed eight-byte little-endian integer.

pub fn bool(&mut self, value: bool)

Appends a boolean as exactly 0 or 1.

pub fn bytes(&mut self, bytes: &[u8])

Appends bytes preceded by their checked u32 length.

pub fn length(&mut self, length: usize)

Appends a collection length as u32.

Panics

Panics when length cannot be represented in the frozen format.

pub fn write<T: CanonicalWrite + ?Sized>(&mut self, value: &T)

Appends a canonical value.

pub fn sequence<T: CanonicalWrite>(&mut self, values: &[T])

Appends an ordered sequence with a u32 length prefix.

pub fn finish(self) -> Digest

Finalizes the digest.

Trait Implementations

impl Default for StateHasher

fn default() -> Self

Returns the “default value” for a type.