rustcrypto/hashesCollection of cryptographic hash functions written in pure Rust
[![Project Chat][chat-image]][chat-link] [![dependency status][deps-image]][deps-link] ![Apache2/MIT licensed][license-image]
Collection of [cryptographic hash functions][1] written in pure Rust.
All algorithms reside in separate crates and are implemented using traits from [digest] crate.
Usage examples are provided in digest and hash implementation crate docs.
Additionally all crates do not require the standard library (i.e. no_std capable) and can be
easily used for bare-metal or WebAssembly programming by disabling default crate features.
For a collection of [extendable output functions (XOFs)][XOF], refer to the [RustCrypto/XOFs] repository.
Note: For new applications, or where compatibility with other existing standards is not a primary concern, we strongly recommend to use either [BLAKE3][blake3], SHA-2 or SHA-3.
| Algorithm | Crate | Crates.io | Documentation | MSRV | Security |
|---|---|---|---|---|---|
| [Ascon-Hash256] | [ascon‑hash256] |  |  | 1.85 | 💚 |
| [bash-hash][STB 34.101.77-2020] | [bash‑hash] |  |  | 1.85 | 💚 |
| [BelT] hash | [belt‑hash] |  |  | 1.85 | 💚 |
| [BLAKE2] | [blake2] |  |  | 1.85 | 💚 |
| [FSB] | [fsb] |  |  | 1.85 | 💚 |
| [GOST R 34.11-94][GOST94] | [gost94] |  |  | 1.85 | 💛 |
| [Grøstl] (Groestl) | [groestl] |  |  | 1.85 | 💚 |
| [JH] | [jh] |  |  | 1.85 | 💚 |
| [Kupyna] | [kupyna] |  |  | 1.85 | 💚 |
| [MD2] | [md2] |  |  | 1.85 | 💔 |
| [MD4] | [md4] |  |  | 1.85 | 💔 |
| [MD5] | [md5] ❗ |  |  | 1.85 | 💔 |
| [RIPEMD] | [ripemd] |  |  | 1.85 | 💚 |
| [SHA-1] | [sha1] |  |  | 1.85 | 💔 |
| [SHA-1 Checked] | [sha1-checked] |  |  | 1.85 | 💛 |
| [SHA-2] | [sha2] |  |  | 1.85 | 💚 |
| [SHA-3] (Keccak) | [sha3] |  |  | 1.85 | 💚 |
| [SHABAL] | [shabal] |  |  | 1.85 | 💚 |
| [Skein] | [skein] |  |  | 1.85 | 💚 |
| [SM3] (OSCCA GM/T 0004-2012) | [sm3] |  |  | 1.85 | 💚 |
| [Streebog] (GOST R 34.11-2012) | [streebog] |  |  | 1.85 | 💛 |
| [Tiger] | [tiger] |  |  | 1.85 | 💛 |
| [Whirlpool] | [whirlpool] |  |  | 1.85 | 💚 |
NOTE: the [blake3] crate implements the digest traits used by the rest of the hashes in this repository, but is maintained by the BLAKE3 team.
The following describes the security level ratings associated with each hash function (i.e. algorithms, not the specific implementation):
| Heart | Description |
|---|---|
| 💚 | No known successful attacks |
| 💛 | Theoretical break: security lower than claimed |
| 💔 | Attack demonstrated in practice: avoid if at all possible |
See the Security page on Wikipedia for more information.
Whenever possible crates are published under the same name as the crate folder.
Owners of md5 declined to participate in this project.
This crate does not implement the [digest] traits, so it is not interoperable with the RustCrypto ecosystem.
This is why we publish our MD5 implementation as md-5 and mark it with the ❗ mark.
Note that the library itself is named as md5, i.e. inside use statements you should use md5, not md_5.
All crates in this repository are licensed under either of
at your option.
