#hash #digest #hashing #crypto

no-std sha2

Pure Rust implementation of the SHA-2 hash function family including SHA-224, SHA-256, SHA-384, and SHA-512

26 releases

0.11.0-pre.3 Feb 1, 2024
0.10.8 Sep 26, 2023
0.10.7 Jun 15, 2023
0.10.6 Sep 16, 2022
0.1.2 May 6, 2016

#211 in Cryptography

Download history 1589531/week @ 2023-11-26 1593510/week @ 2023-12-03 1587783/week @ 2023-12-10 1409298/week @ 2023-12-17 789357/week @ 2023-12-24 1261483/week @ 2023-12-31 1620265/week @ 2024-01-07 1665972/week @ 2024-01-14 1732967/week @ 2024-01-21 1808254/week @ 2024-01-28 1773219/week @ 2024-02-04 1742559/week @ 2024-02-11 1716105/week @ 2024-02-18 1825817/week @ 2024-02-25 1826026/week @ 2024-03-03 703921/week @ 2024-03-10

6,184,963 downloads per month
Used in 16,094 crates (2,949 directly)

MIT/Apache

85KB
2K SLoC

RustCrypto: SHA-2

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

Pure Rust implementation of the SHA-2 cryptographic hash algorithms.

There are 6 standard algorithms specified in the SHA-2 standard: Sha224, Sha256, Sha512_224, Sha512_256, Sha384, and Sha512.

Algorithmically, there are only 2 core algorithms: SHA-256 and SHA-512. All other algorithms are just applications of these with different initial hash values, and truncated to different digest bit lengths. The first two algorithms in the list are based on SHA-256, while the last four are based on SHA-512.

Examples

One-shot API

use sha2::{Sha256, Digest};
use hex_literal::hex;

let hash = Sha256::digest(b"hello world");
assert_eq!(hash, hex!("b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9"));

Incremental API

use sha2::{Sha256, Sha512, Digest};
use hex_literal::hex;

let mut hasher = Sha256::new();
hasher.update(b"hello world");
let hash256 = hasher.finalize();

assert_eq!(hash256, hex!("b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9"));

let mut hasher = Sha512::new();
hasher.update(b"hello world");
let hash512 = hasher.finalize();

assert_eq!(hash512, hex!(
    "309ecc489c12d6eb4cc40f50c902f2b4d0ed77ee511a7c7a9bcd3ca86d4cd86f"
    "989dd35bc5ff499670da34255b45b0cfd830e81f605dcf7dc5542e93ae9cd76f"
));

Also, see the examples section in the RustCrypto/hashes readme.

Minimum Supported Rust Version

Rust 1.72 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

~305–510KB
~12K SLoC