27 releases

0.11.0-pre.4 Jul 26, 2024
0.11.0-pre.3 Feb 1, 2024
0.11.0-pre.2 Jan 17, 2024
0.10.6 Sep 21, 2023
0.0.3 Nov 21, 2014

#6 in Cryptography

Download history 1173537/week @ 2024-07-18 1176225/week @ 2024-07-25 1223598/week @ 2024-08-01 1267673/week @ 2024-08-08 1211123/week @ 2024-08-15 1269830/week @ 2024-08-22 1189633/week @ 2024-08-29 1298336/week @ 2024-09-05 1222501/week @ 2024-09-12 1342020/week @ 2024-09-19 1441928/week @ 2024-09-26 1855678/week @ 2024-10-03 1800721/week @ 2024-10-10 1921747/week @ 2024-10-17 1463348/week @ 2024-10-24 1352583/week @ 2024-10-31

6,847,993 downloads per month
Used in 6,409 crates (632 directly)

MIT/Apache

32KB
669 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.

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

~320–540KB
~12K SLoC