Crate blake2s_simd

An implementation of the BLAKE2s and BLAKE2sp hash functions. See also blake2b_simd.

This crate includes:

• 100% stable Rust.
• SIMD implementations based on Samuel Neves’ blake2-avx2. These are very fast. For benchmarks, see the Performance section of the README.
• Portable, safe implementations for other platforms.
• Dynamic CPU feature detection. Binaries include multiple implementations by default and choose the fastest one the processor supports at runtime.
• All the features from the the BLAKE2 spec, like adjustable length, keying, and associated data for tree hashing.
• no_std support. The std Cargo feature is on by default, for CPU feature detection and for implementing std::io::Write.
• Support for computing multiple BLAKE2s hashes in parallel, matching the efficiency of BLAKE2sp. See the many module.

Example

use blake2s_simd::{blake2s, Params};

let expected = "08d6cad88075de8f192db097573d0e829411cd91eb6ec65e8fc16c017edfdb74";
let hash = blake2s(b"foo");
assert_eq!(expected, &hash.to_hex());

let hash = Params::new()
    .hash_length(16)
    .key(b"Squeamish Ossifrage")
    .personal(b"Shaftoe")
    .to_state()
    .update(b"foo")
    .update(b"bar")
    .update(b"baz")
    .finalize();
assert_eq!("28325512782cbf5019424fa65da9a6c7", &hash.to_hex());

Modules

blake2sp	BLAKE2sp, a variant of BLAKE2s that uses SIMD more efficiently.
many	Interfaces for hashing multiple inputs at once, using SIMD more efficiently.

Structs

Hash	A finalized BLAKE2 hash, with constant-time equality.
Params	A parameter builder that exposes all the non-default BLAKE2 features.
State	An incremental hasher for BLAKE2s.

Constants

BLOCKBYTES	The number input bytes passed to each call to the compression function. Small benchmarks need to use an even multiple of BLOCKBYTES, or else their apparent throughput will be low.
KEYBYTES	The max key length.
OUTBYTES	The max hash length.
PERSONALBYTES	The max personalization length.
SALTBYTES	The max salt length.

Functions

blake2s

Compute the BLAKE2s hash of a slice of bytes all at once, using default parameters.