22 releases

0.11.0-pre.4 Jul 27, 2024
0.11.0-pre.2 Jan 19, 2024
0.10.4 Sep 2, 2022
0.10.1 Feb 17, 2022
0.3.0 Nov 17, 2016

#2589 in Cryptography

Download history 19113/week @ 2024-07-19 26048/week @ 2024-07-26 24916/week @ 2024-08-02 22595/week @ 2024-08-09 26543/week @ 2024-08-16 25316/week @ 2024-08-23 34220/week @ 2024-08-30 33419/week @ 2024-09-06 28409/week @ 2024-09-13 30603/week @ 2024-09-20 28345/week @ 2024-09-27 19707/week @ 2024-10-04 26281/week @ 2024-10-11 34147/week @ 2024-10-18 33040/week @ 2024-10-25 27804/week @ 2024-11-01

125,323 downloads per month
Used in 29 crates (21 directly)

MIT/Apache

63KB
2.5K SLoC

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.

Dependencies

~300–470KB
~11K SLoC