28 releases

Uses new Rust 2024

0.11.0-pre.5 Mar 5, 2025
0.11.0-pre.4 Jul 26, 2024
0.11.0-pre.3 Feb 1, 2024
0.10.6 Sep 21, 2023
0.0.3 Nov 21, 2014

#104 in Cryptography

Download history 1237564/week @ 2024-11-27 1535080/week @ 2024-12-04 1622477/week @ 2024-12-11 1140789/week @ 2024-12-18 687483/week @ 2024-12-25 1106367/week @ 2025-01-01 1611557/week @ 2025-01-08 1545498/week @ 2025-01-15 1622773/week @ 2025-01-22 1707109/week @ 2025-01-29 1879755/week @ 2025-02-05 1819722/week @ 2025-02-12 2104205/week @ 2025-02-19 1947890/week @ 2025-02-26 2419023/week @ 2025-03-05 1895521/week @ 2025-03-12

8,701,691 downloads per month
Used in 7,153 crates (720 directly)

MIT/Apache

38KB
792 lines

RustCrypto: SHA-1

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

Pure Rust implementation of the SHA-1 cryptographic hash algorithm.

🚨 Warning: Cryptographically Broken! 🚨

The SHA-1 hash function should be considered cryptographically broken and unsuitable for further use in any security critical capacity, as it is practically vulnerable to chosen-prefix collisions.

We provide this crate for legacy interoperability purposes only.

If possible use the sha1-checked crate, while slower it provides the ability to detect potential collisions, as well as generate alternative safe hashes.

Examples

One-shot API

use hex_literal::hex;
use sha1::{Sha1, Digest};

let result = Sha1::digest(b"hello world");
assert_eq!(result, hex!("2aae6c35c94fcfb415dbe95f408b9ce91ee846ed"));

Incremental API

use hex_literal::hex;
use sha1::{Sha1, Digest};

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

assert_eq!(hash, hex!("2aae6c35c94fcfb415dbe95f408b9ce91ee846ed"));

// Hex-encode hash using https://docs.rs/base16ct
let hex_hash = base16ct::lower::encode_string(&hash);
assert_eq!(hex_hash, "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed");

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

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

~685KB
~18K SLoC