https://github.com/banyc/tokio_chacha20
Encrypt/Decrypt async stream data (`AsyncRead/Write`) using ChaCha20
https://github.com/banyc/tokio_chacha20
chacha20 poly1305 tokio
Last synced: 7 months ago
JSON representation
Encrypt/Decrypt async stream data (`AsyncRead/Write`) using ChaCha20
- Host: GitHub
- URL: https://github.com/banyc/tokio_chacha20
- Owner: Banyc
- Created: 2023-12-30T14:24:36.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-12-25T06:15:16.000Z (over 1 year ago)
- Last Synced: 2025-01-20T05:49:04.969Z (over 1 year ago)
- Topics: chacha20, poly1305, tokio
- Language: Rust
- Homepage:
- Size: 51.8 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# `tokio_chacha20`
ChaCha20 and Poly1305 primitives (primitives are not AEAD).
## How to use
Async:
```rust
#[tokio::test]
async fn test_simplex_async() {
let config = create_random_config();
let (client, server) = tokio::io::duplex(1024);
let (mut server, mut client) = same_key_nonce_ciphertext(config.key(), server, client);
let data = b"Hello, world!";
let mut buf = [0u8; 1024];
for _ in 0..1024 {
client.write_all(data).await.unwrap();
server.read_exact(&mut buf[..data.len()]).await.unwrap();
assert_eq!(&buf[..data.len()], data);
}
}
```
Polling:
```rust
#[test]
fn test_simplex_polling() {
let config = create_random_config();
let msg = b"Hello world!";
let mut nonce_ciphertext = vec![];
let mut w = nonce_ciphertext_writer(config.key(), &mut nonce_ciphertext);
unwrap_ready(Pin::new(&mut w).poll_write(&mut noop_context(), msg)).unwrap();
let mut r = nonce_ciphertext_reader(config.key(), &nonce_ciphertext[..]);
let mut read_buf = vec![0; 1024];
let mut read_buf = ReadBuf::new(&mut read_buf);
unwrap_ready(Pin::new(&mut r).poll_read(&mut noop_context(), &mut read_buf)).unwrap();
assert_eq!(msg, read_buf.filled());
}
fn noop_context() -> Context<'static> {
Context::from_waker(Waker::noop())
}
fn unwrap_ready(poll: Poll) -> T {
match poll {
Poll::Ready(x) => x,
Poll::Pending => panic!(),
}
}
```
Cipher:
```rust
fn same_key_nonce_ciphertext(
key: &[u8; KEY_BYTES],
r: R,
w: W,
) -> (NonceCiphertextReader, NonceCiphertextTagWriter) {
let r = nonce_ciphertext_reader(key, r);
let w = nonce_ciphertext_writer(key, w);
(r, w)
}
fn nonce_ciphertext_reader(key: &[u8; KEY_BYTES], r: R) -> NonceCiphertextReader {
let reader_config = NonceCiphertextReaderConfig { hash: false };
let nonce_buf = NonceBuf::Nonce(Box::new([0; NONCE_BYTES]));
NonceCiphertextReader::new(&reader_config, Box::new(*key), nonce_buf, r)
}
fn nonce_ciphertext_writer(key: &[u8; KEY_BYTES], w: W) -> NonceCiphertextTagWriter {
let writer_config = NonceCiphertextWriterConfig {
write_nonce: true,
hash: false,
key,
};
let nonce = NonceBuf::Nonce(Box::new(rand::random()));
NonceCiphertextTagWriter::new(&writer_config, nonce, w)
}
```