lib-q-tweak-aead 0.0.5

Parallel tweakable-block (CTR) AEAD over Keccak-f[1600] for lib-Q
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

# lib-q-tweak-aead

Tweakable-block CTR AEAD: each **32-byte** block uses an independent Keccak-f[1600] evaluation (key, nonce, counter), so four permutations can be run in parallel on x86_64 with the `simd-avx2` feature.

## Usage

```rust
use lib_q_core::{Aead, AeadKey, Nonce};
use lib_q_tweak_aead::TweakAead;

let aead = TweakAead::new();
let key = AeadKey::new(vec![0u8; 32]);
let nonce = Nonce::new(vec![0u8; 16]);
let ct = aead.encrypt(&key, &nonce, b"message", Some(b"ad")).unwrap();
let pt = aead.decrypt(&key, &nonce, &ct, Some(b"ad")).unwrap();
```

## Features

- `std`, `alloc` — defaults for `Aead` API
- `simd-avx2` — four-way parallel Keccak-f[1600] for bulk data on AVX2 CPUs

## Security

Uses the SHA-3 permutation only (no AES/ChaCha). The **mode** is custom; review before production use.

Part of the [lib-Q workspace](../README.md); pairs with `lib-q-core` AEAD traits.