Skip to content

Latest commit

 

History

History
 
 

whirlpool

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

RustCrypto: Whirlpool

crate Docs Apache2/MIT licensed Rust Version Project Chat Build Status

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.

Examples

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.

Minimum Supported Rust Version

Rust 1.71 or higher.

Minimum supported Rust version can be changed in the future, but it will be done with a minor version bump.

SemVer Policy

  • All on-by-default features of this library are covered by SemVer
  • MSRV is considered exempt from SemVer as noted above

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.