chacha20
| Crates.io | chacha20 |
| lib.rs | chacha20 |
| version | 0.10.0-pre.2 |
| source | src |
| created_at | 2016-10-06 21:11:22.073136 |
| updated_at | 2024-10-07 18:51:49.921487 |
| description | The ChaCha20 stream cipher (RFC 8439) implemented in pure Rust using traits from the RustCrypto `cipher` crate, with optional architecture-specific hardware acceleration (AVX2, SSE2). Additionally provides the ChaCha8, ChaCha12, XChaCha20, XChaCha12 and XChaCha8 stream ciphers, and also optional rand_core-compatible RNGs based on those ciphers. |
| homepage | |
| repository | https://github.com/RustCrypto/stream-ciphers |
| max_upload_size | |
| id | 6755 |
| size | 127,990 |
stream-ciphers (github:rustcrypto:stream-ciphers)
documentation
README
RustCrypto: ChaCha20
Pure Rust implementation of the ChaCha20 Stream Cipher.
About
ChaCha20 is a stream cipher which is designed to support high-performance software implementations.
It improves upon the previous Salsa20 stream cipher with increased per-round diffusion at no cost to performance.
This crate also contains an implementation of XChaCha20: a variant
of ChaCha20 with an extended 192-bit (24-byte) nonce, gated under the
chacha20 Cargo feature (on-by-default).
Implementations
This crate contains the following implementations of ChaCha20, all of which
work on stable Rust with the following RUSTFLAGS:
x86/x86_64avx2: (~1.4cpb)-Ctarget-cpu=haswell -Ctarget-feature=+avx2sse2: (~2.5cpb)-Ctarget-feature=+sse2(on by default on x86 CPUs)
aarch64neon(~2-3x faster thansoft) requires Rust 1.61+ and theneonfeature enabled
- Portable
soft: (~5 cpb on x86/x86_64)
NOTE: cpb = cycles per byte (smaller is better)
Security
⚠️ Warning: Hazmat!
This crate does not ensure ciphertexts are authentic (i.e. by using a MAC to verify ciphertext integrity), which can lead to serious vulnerabilities if used incorrectly!
To avoid this, use an AEAD mode based on ChaCha20, i.e. ChaCha20Poly1305. See the RustCrypto/AEADs repository for more information.
USE AT YOUR OWN RISK!
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 (along with the underlying ChaCha20 stream cipher itself) are designed to execute in constant time.
Minimum Supported Rust Version
Rust 1.65 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
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.