Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rustcrypto/stream-ciphers
Collection of stream cipher algorithms
https://github.com/rustcrypto/stream-ciphers
aes-ctr cfb cfb8 cryptography ctr rust stream-ciphers
Last synced: 2 days ago
JSON representation
Collection of stream cipher algorithms
- Host: GitHub
- URL: https://github.com/rustcrypto/stream-ciphers
- Owner: RustCrypto
- Created: 2017-02-24T14:50:21.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-12-02T11:38:27.000Z (about 1 month ago)
- Last Synced: 2024-12-31T20:07:17.244Z (2 days ago)
- Topics: aes-ctr, cfb, cfb8, cryptography, ctr, rust, stream-ciphers
- Language: Rust
- Size: 751 KB
- Stars: 270
- Watchers: 10
- Forks: 51
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# RustCrypto: stream ciphers
[![Project Chat][chat-image]][chat-link]
[![dependency status][deps-image]][deps-link]
![Apache2/MIT licensed][license-image]
[![HAZMAT][hazmat-image]][hazmat-link]
Collection of [stream ciphers] written in pure Rust.
## ⚠️ Security Warning: [Hazmat!][hazmat-link]
Crates in this repository do not ensure ciphertexts are authentic (i.e. by
using a MAC to verify ciphertext integrity), which can lead to serious
vulnerabilities if used incorrectly!
Aside from the `chacha20` crate, no crates in this repository have yet
received any formal cryptographic and security reviews/audits.
**USE AT YOUR OWN RISK!**
## Crates
| Name | Crate name | Crates.io | Docs | MSRV | Security |
|----------|------------|-----------|------|------|----------|
| [ChaCha] | [`chacha20`] | [](https://crates.io/crates/chacha20) | [](https://docs.rs/chacha20) | ![MSRV 1.81][msrv-1.81] | 💚 |
| [HC-256] | [`hc-256`] | [](https://crates.io/crates/hc-256) | [](https://docs.rs/hc-256) | ![MSRV 1.81][msrv-1.81] | [💛](https://link.springer.com/chapter/10.1007/978-3-642-04846-3_4) |
| [Rabbit] | [`rabbit`] | [](https://crates.io/crates/rabbit) | [](https://docs.rs/rabbit) | ![MSRV 1.81][msrv-1.81] | [💛](https://eprint.iacr.org/2013/780.pdf) |
| [RC4] | [`rc4`] | [](https://crates.io/crates/rc4) | [](https://docs.rs/rc4) | ![MSRV 1.81][msrv-1.81] | [💔](https://www.usenix.org/system/files/conference/usenixsecurity13/sec13-paper_alfardan.pdf) |
| [Salsa20] | [`salsa20`] | [](https://crates.io/crates/salsa20) | [](https://docs.rs/salsa20) | ![MSRV 1.81][msrv-1.81] | 💚 |
### Security Level Legend
The following describes the security level ratings associated with each hash function (i.e. algorithms, not the specific implementation):
| Heart | Description |
|----------------|-------------|
| :green_heart: | No known successful attacks |
| :yellow_heart: | Theoretical break: security lower than claimed |
| :broken_heart: | Attack demonstrated in practice: avoid if at all possible |
## Minimum Supported Rust Version (MSRV) Policy
MSRV bump is considered a breaking change and will be performed only with a minor version bump.
## Example
Crates functionality is expressed in terms of traits defined in the [`cipher`] crate.
Let's use ChaCha20 to demonstrate usage of synchronous stream cipher:
```rust
use chacha20::ChaCha20;
// Import relevant traits
use chacha20::cipher::{KeyIvInit, StreamCipher, StreamCipherSeek};
use hex_literal::hex;
let key = [0x42; 32];
let nonce = [0x24; 12];
let plaintext = hex!("00010203 04050607 08090a0b 0c0d0e0f");
let ciphertext = hex!("e405626e 4f1236b3 670ee428 332ea20e");
// Key and IV must be references to the `GenericArray` type.
// Here we use the `Into` trait to convert arrays into it.
let mut cipher = ChaCha20::new(&key.into(), &nonce.into());
let mut buffer = plaintext.clone();
// apply keystream (encrypt)
cipher.apply_keystream(&mut buffer);
assert_eq!(buffer, ciphertext);
let ciphertext = buffer.clone();
// ChaCha ciphers support seeking
cipher.seek(0u32);
// decrypt ciphertext by applying keystream again
cipher.apply_keystream(&mut buffer);
assert_eq!(buffer, plaintext);
// stream ciphers can be used with streaming messages
cipher.seek(0u32);
for chunk in buffer.chunks_mut(3) {
cipher.apply_keystream(chunk);
}
assert_eq!(buffer, ciphertext);
```
## License
All crates licensed under either of
* [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0)
* [MIT license](http://opensource.org/licenses/MIT)
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.
[//]: # (badges)
[chat-image]: https://img.shields.io/badge/zulip-join_chat-blue.svg
[chat-link]: https://rustcrypto.zulipchat.com/#narrow/stream/260049-stream-ciphers
[deps-image]: https://deps.rs/repo/github/RustCrypto/stream-ciphers/status.svg
[deps-link]: https://deps.rs/repo/github/RustCrypto/stream-ciphers
[license-image]: https://img.shields.io/badge/license-Apache2.0/MIT-blue.svg
[hazmat-image]: https://img.shields.io/badge/crypto-hazmat%E2%9A%A0-red.svg
[hazmat-link]: https://github.com/RustCrypto/meta/blob/master/HAZMAT.md
[msrv-1.81]: https://img.shields.io/badge/rustc-1.81.0+-blue.svg
[//]: # (footnotes)
[stream ciphers]: https://en.wikipedia.org/wiki/Stream_cipher
[`cipher`]: https://docs.rs/cipher
[//]: # (crates)
[`chacha20`]: ./chacha20
[`hc-256`]: ./hc-256
[`rabbit`]: ./rabbit
[`rc4`]: ./rc4
[`salsa20`]: ./salsa20
[//]: # (links)
[ChaCha]: https://en.wikipedia.org/wiki/Salsa20#ChaCha_variant
[HC-256]: https://en.wikipedia.org/wiki/HC-256
[Rabbit]: https://en.wikipedia.org/wiki/Rabbit_(cipher)
[RC4]: https://en.wikipedia.org/wiki/RC4
[Salsa20]: https://en.wikipedia.org/wiki/Salsa20