Struct Blake3 

pub struct Blake3 { /* private fields */ }

BLAKE3 hash function.

Implements the Hasher trait. See the module documentation for examples and backend details.

When the zeroize feature is enabled, the internal state (key words, chunk buffer and chaining-value stack) is overwritten with zeros when the hasher is dropped, so key material does not linger in memory.

Implementations

impl Blake3

pub fn new_keyed(key: &[u8; 32]) -> Self

Create a keyed hasher (MAC) from a 32-byte key.

pub fn new_derive_key(context: &str) -> Self

Create a key-derivation hasher from a context string.

The context string should be hardcoded, globally unique and application-specific; see derive_key.

pub fn derive_key(context: &str, key_material: &[u8]) -> [u8; 32]

Derive a 32-byte subkey from key_material and a context string.

The context string should be hardcoded, globally unique and application-specific, e.g. "example.com 2019-12-25 16:18:03 session tokens v1". This function is not a password hash.

pub fn keyed_hash(key: &[u8; 32], input: &[u8]) -> Hash

One-shot keyed hash (MAC).

pub fn finalize_xof(self) -> Blake3XofReader

Finalize the hasher and return an extendable-output reader.

Trait Implementations

impl Clone for Blake3

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Drop for Blake3

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Hasher for Blake3

const BLOCK_SIZE: usize = 64

The internal block size of the hash function

const OUTPUT_SIZE: usize = 32

The output size of the hash function.

fn new() -> Self

fn update(&mut self, data: &[u8])

fn sum(self) -> Hash

fn hash(data: &[u8]) -> Hash

impl Zeroize for Blake3

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.