Rust chacha20_poly1305 stream wrapper library
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Go to file
Avril d76b77fbf1
Fixed build fail with async feature.
3 years ago
include version bump. pushing C API v0 at lib version 1.2.0 3 years ago
src Fixed build fail with async feature. 3 years ago
.gitignore initial commit 3 years ago
Cargo.toml Fixed build fail with async feature. 3 years ago
README.md update README 3 years ago
build.rs removed cc dep 3 years ago
test.c test program uses open_memstream for backing 3 years ago
test.sh version bump. pushing C API v0 at lib version 1.2.0 3 years ago

README.md

chacha20_poly1305 stream wrapper

Contains a writable stream that wraps another, applying the chacha20_poly1305 cipher to the input before writing for either encryption or decryption.

Usage example

Encrypt and decrypt message with an in-memory buffer.

// Generate random key and IV for the operations.
let (key, iv) = chacha20stream::keygen();

let input = "Hello world!";

// Encryption into a new `Vec<u8>`. (Any implementor of `io::Write` or `&mut io::Write` can be used.)
let mut sink = Sink::encrypt(Vec::new(), key, iv).expect("Failed to create encryptor");
sink.write_all(input.as_bytes()).unwrap();
sink.flush().unwrap(); // `flush` also clears the in-memory buffer if there is left over data in it.

let output_encrypted = sink.into_inner();

// Decryption into a new `Vec<u8>`. (Any implementor of `std::io::Write` or `&mut std::io::Write` can be used.)
let mut sink = Sink::decrypt(Vec::new(), key, iv).expect("Failed to create decryptor");
sink.write_all(&output_encrypted[..]).unwrap();
sink.flush().unwrap();

let output_decrypted = sink.into_inner();

assert_eq!(&output_decrypted[..], input.as_bytes());

Features

  • smallvec - Use smallvec crate to store the in-memory buffer on the stack if it's smalle enough (default)
  • async - Enable AsyncSink with Tokio 0.2 AsyncWrite. The API is the same as for the regular Sink.
  • explicit_clear - Explicitly clear in-memory buffer after operations.
  • ffi - Build with the C FFI interface (see include/cc20.h.) The output libraries are generated in target/{debug,release}/libchacha20stream.{a,so}.

License

MIT