RustCrypto: MD5

Pure Rust implementation of the MD5 cryptographic hash algorithm.

⚠️ Security Warning

This crate is provided for the purposes of legacy interoperability with protocols and systems which mandate the use of MD5.

However, MD5 is cryptographically broken and unsuitable for further use.

Collision attacks against MD5 are both practical and trivial, and theoretical attacks against MD5's preimage resistance have been found.

RFC 6151 advises no new IETF protocols can be designed MD5-based constructions, including HMAC-MD5.

Examples

use md5::{Md5, Digest};
use hex_literal::hex;

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

assert_eq!(hash, hex!("5eb63bbbe01eeed093cb22bb8f5acdc3"));

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

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:

• Apache License, Version 2.0
• MIT license

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.