Expand description
An implementation of the BLAKE2 hash functions.
§Usage
Blake2b512
and Blake2s256
can be used in the following way:
use blake2::{Blake2b512, Blake2s256, Digest};
use hex_literal::hex;
// create a Blake2b512 object
let mut hasher = Blake2b512::new();
// write input message
hasher.update(b"hello world");
// read hash digest and consume hasher
let res = hasher.finalize();
assert_eq!(res[..], hex!("
021ced8799296ceca557832ab941a50b4a11f83478cf141f51f933f653ab9fbc
c05a037cddbed06e309bf334942c4e58cdf1a46e237911ccd7fcf9787cbc7fd0
")[..]);
// same example for Blake2s256:
let mut hasher = Blake2s256::new();
hasher.update(b"hello world");
let res = hasher.finalize();
assert_eq!(res[..], hex!("
9aec6806794561107e594b1f6a8a6b0c92a0cba9acf5e5e93cca06f781813b0b
")[..]);
Also see RustCrypto/hashes readme.
§Variable output size
This implementation supports run and compile time variable sizes.
Run time variable output example:
use blake2::Blake2bVar;
use blake2::digest::{Update, VariableOutput};
use hex_literal::hex;
let mut hasher = Blake2bVar::new(10).unwrap();
hasher.update(b"my_input");
let mut buf = [0u8; 10];
hasher.finalize_variable(&mut buf).unwrap();
assert_eq!(buf, hex!("2cc55c84e416924e6400"));
Compile time variable output example:
use blake2::{Blake2b, Digest, digest::consts::U10};
use hex_literal::hex;
type Blake2b80 = Blake2b<U10>;
let mut hasher = Blake2b80::new();
hasher.update(b"my_input");
let res = hasher.finalize();
assert_eq!(res[..], hex!("2cc55c84e416924e6400")[..]);
§Acknowledgment
Based on the blake2-rfc crate.
Re-exports§
pub use digest;
Structs§
- Blake2b MAC function
- Blake2b instance with a variable output.
- Blake2s MAC function
- Blake2s instance with a variable output.
Traits§
- Convenience wrapper trait covering functionality of cryptographic hash functions with fixed output size.
Type Aliases§
- BLAKE2b generic over output size.
- BLAKE2b-512 hasher state.
- Core hasher state of BLAKE2b generic over output size.
- BLAKE2b-512 MAC state.
- BLAKE2b which allows to choose output size at runtime.
- BLAKE2s generic over output size.
- BLAKE2s-256 hasher state.
- Core hasher state of BLAKE2s generic over output size.
- BLAKE2s-256 MAC state.
- BLAKE2s which allows to choose output size at runtime.