#aead #chacha20 #poly1305 #xchacha20 #xchacha20poly1305

no-std chacha20poly1305

Pure Rust implementation of the ChaCha20Poly1305 Authenticated Encryption with Additional Data Cipher (RFC 8439) with optional architecture-specific hardware acceleration. Also contains implementations of the XChaCha20Poly1305 extended nonce variant of ChaCha20Poly1305, and the reduced-round ChaCha8Poly1305 and ChaCha12Poly1305 lightweight variants.

27 releases

0.10.1 Aug 10, 2022
0.10.0-pre.2 Jul 20, 2022
0.10.0-pre Mar 19, 2022
0.9.0 Aug 29, 2021
0.0.0 Oct 6, 2016

#1064 in Cryptography

Download history 153718/week @ 2023-10-31 159679/week @ 2023-11-07 212377/week @ 2023-11-14 167302/week @ 2023-11-21 174726/week @ 2023-11-28 165577/week @ 2023-12-05 154639/week @ 2023-12-12 129075/week @ 2023-12-19 60528/week @ 2023-12-26 137140/week @ 2024-01-02 145153/week @ 2024-01-09 164617/week @ 2024-01-16 170275/week @ 2024-01-23 184996/week @ 2024-01-30 168536/week @ 2024-02-06 151836/week @ 2024-02-13

708,220 downloads per month
Used in 781 crates (194 directly)

Apache-2.0 OR MIT

69KB
202 lines

RustCrypto: ChaCha20Poly1305

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

Pure Rust implementation of ChaCha20Poly1305 (RFC 8439): an Authenticated Encryption with Associated Data (AEAD) cipher amenable to fast, constant-time implementations in software, based on the ChaCha20 stream cipher and Poly1305 universal hash function.

This crate also contains an implementation of XChaCha20Poly1305: a variant of ChaCha20Poly1305 with an extended 192-bit (24-byte) nonce.

Documentation

About

ChaCha20Poly1305 is notable for being simple and fast when implemented in pure software. The underlying ChaCha20 stream cipher uses a simple combination of add, rotate, and XOR instructions (a.k.a. "ARX"), and the Poly1305 hash function is likewise extremely simple.

While it hasn't received approval from certain standards bodies (i.e. NIST) the algorithm is widely used and deployed. Notably it's mandatory to implement in the Transport Layer Security (TLS) protocol. The underlying ChaCha20 cipher is also widely used as a cryptographically secure random number generator, including internal use by the Rust standard library.

Security Notes

This crate has received one security audit by NCC Group, with no significant findings. We would like to thank MobileCoin for funding the audit.

All implementations contained in the crate are designed to execute in constant time, either by relying on hardware intrinsics (i.e. AVX2 on x86/x86_64), or using a portable implementation which is only constant time on processors which implement constant-time multiplication.

It is not suitable for use on processors with a variable-time multiplication operation (e.g. short circuit on multiply-by-zero / multiply-by-one, such as certain 32-bit PowerPC CPUs and some non-ARM microcontrollers).

License

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

~0.6–1MB
~17K SLoC