Struct ChaCha20Blake3 

pub struct ChaCha20Blake3 { /* private fields */ }

ChaCha20-BLAKE3 AEAD (encrypt-then-MAC).

The master key and nonce are fed through a BLAKE3-based KDF to derive a ChaCha20 encryption key, a ChaCha20 nonce, and an authentication key. The plaintext is encrypted with ChaCha20 and then MACed with BLAKE3(keyed, aad || len(aad) || ciphertext || len(ciphertext)).

Parameters

• Key: 256 bits (32 bytes)
• Nonce: 256 bits (32 bytes)
• Tag: 256 bits (32 bytes)

Panics

encrypt_in_place and decrypt_in_place panic if the nonce is not exactly 32 bytes.

Example

use crypto::{Aead, chacha::ChaCha20Blake3};

let key = [0xab; 32];
let nonce = [0xcd; 32];
let aad = b"associated data";
let plaintext = b"hello world";

let cipher = ChaCha20Blake3::new(&key);

let mut buf = plaintext.to_vec();
let tag = cipher.encrypt_in_place(&mut buf, &nonce, aad);

// buf now holds the ciphertext; tag is the 32-byte authentication tag.

cipher.decrypt_in_place(&mut buf, &nonce, aad, tag.as_ref())
    .expect("decryption failed");
assert_eq!(&buf, plaintext);

Implementations

impl ChaCha20Blake3

pub fn new(key: &[u8; 32]) -> Self

Trait Implementations

impl Aead for ChaCha20Blake3

const TAG_SIZE: usize = 32

const NONCE_SIZE: usize = 32

fn encrypt_in_place(&self, in_out: &mut [u8], nonce: &[u8], aad: &[u8]) -> Hash

fn decrypt_in_place( &self, in_out: &mut [u8], nonce: &[u8], aad: &[u8], tag: &[u8], ) -> Result<(), AeadError>

fn encrypt(&self, plaintext: &[u8], nonce: &[u8], aad: &[u8]) -> Vec<u8>

fn decrypt( &self, ciphertext: &[u8], nonce: &[u8], aad: &[u8], ) -> Result<Vec<u8>, AeadError>

impl Drop for ChaCha20Blake3

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Zeroize for ChaCha20Blake3

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.