Pure Rust implementation of the Whirlpool cryptographic hash algorithm.
This is the algorithm recommended by NESSIE (New European Schemes for Signatures, Integrity and Encryption; an European research project).
The constants used by Whirlpool were changed twice (2001 and 2003) - this crate only implements the most recent standard. The two older Whirlpool implementations (sometimes called Whirlpool-0 (pre 2001) and Whirlpool-T (pre 2003)) were not used much anyway (both have never been recommended by NESSIE).
For details see this page.
use whirlpool::{Whirlpool, Digest};
use hex_literal::hex;
let mut hasher = Whirlpool::new();
hasher.update(b"Hello Whirlpool");
let hash = hasher.finalize();
assert_eq!(hash, hex!(
"8eaccdc136903c458ea0b1376be2a5fc9dc5b8ce8892a3b4f43366e2610c206c"
"a373816495e63db0fff2ff25f75aa7162f332c9f518c3036456502a8414d300a"
));
// Hex-encode hash using https://docs.rs/base16ct
let hex_hash = base16ct::lower::encode_string(&hash);
assert_eq!(
hex_hash,
"8eaccdc136903c458ea0b1376be2a5fc9dc5b8ce8892a3b4f43366e2610c206c\
a373816495e63db0fff2ff25f75aa7162f332c9f518c3036456502a8414d300a",
);Also, see the examples section in the RustCrypto/hashes readme.
Rust 1.81 or higher.
Minimum supported Rust version can be changed in the future, but it will be done with a minor version bump.
- All on-by-default features of this library are covered by SemVer
- MSRV is considered exempt from SemVer as noted above
The crate is licensed under either of:
at your option.
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.