Expand description
§RustCrypto: BLAKE2
Pure Rust implementation of the BLAKE2 hash function family.
§Examples
§Fixed output size
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 hash = hasher.finalize();
assert_eq!(hash, hex!(
"021ced8799296ceca557832ab941a50b4a11f83478cf141f51f933f653ab9fbc"
"c05a037cddbed06e309bf334942c4e58cdf1a46e237911ccd7fcf9787cbc7fd0"
));
// same example for Blake2s256:
let mut hasher = Blake2s256::new();
hasher.update(b"hello world");
let hash = hasher.finalize();
assert_eq!(hash, hex!("9aec6806794561107e594b1f6a8a6b0c92a0cba9acf5e5e93cca06f781813b0b"));
// Hex-encode hash using https://docs.rs/base16ct
let hex_hash = base16ct::lower::encode_string(&hash);
assert_eq!(hex_hash, "9aec6806794561107e594b1f6a8a6b0c92a0cba9acf5e5e93cca06f781813b0b");Also, see the examples section in the RustCrypto/hashes readme.
§Variable output size
This implementation supports output sizes variable at compile time:
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"));§License
The crate is licensed under either of:
at your option.
§Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Re-exports§
pub use digest;
Structs§
- Blake2b
- BLAKE2b generic over output size.
- Blake2b
Mac - Blake2b MAC function
- Blake2b
VarCore - Blake2b instance with a variable output.
- Blake2s
- BLAKE2s generic over output size.
- Blake2s
Mac - Blake2s MAC function
- Blake2s
VarCore - Blake2s instance with a variable output.
Traits§
- Digest
- Convenience wrapper trait covering functionality of cryptographic hash functions with fixed output size.
Type Aliases§
- Blake2b128
- BLAKE2b-128 hasher state.
- Blake2b256
- BLAKE2b-256 hasher state.
- Blake2b512
- BLAKE2b-512 hasher state.
- Blake2b
Mac512 - BLAKE2b-512 MAC state.
- Blake2s128
- BLAKE2s-128 hasher state.
- Blake2s256
- BLAKE2s-256 hasher state.
- Blake2s
Mac256 - BLAKE2s-256 MAC state.