Struct AsconAead128 

pub struct AsconAead128 { /* private fields */ }

Ascon-AEAD128 authenticated encryption with associated data (NIST SP 800-232).

Parameters

• Key: 128 bits (16 bytes)
• Nonce: 128 bits (16 bytes)
• Tag: 128 bits (16 bytes)
• Rate: 128 bits, capacity: 192 bits
• Initialization/finalization rounds: 12
• Data processing rounds: 8

Example

use crypto::{Aead, ascon::AsconAead128};

let key = [0x42u8; 16];
let nonce = [0xABu8; 16];
let aad = b"example metadata";
let plaintext = b"hello, world!";

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

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

let mut pt = ct.clone();
cipher.decrypt_in_place(&mut pt, &nonce, aad, tag.as_ref()).unwrap();
assert_eq!(&pt, plaintext);

Usage limits (NIST SP 800-232 §4.3)

• Max data per key: 2^54 bytes
• Nonces must be distinct per key (up to 2^8 repetitions tolerated)
• Max decryption failures: 2^(tag_len - 32) before key rotation

Implementations

impl AsconAead128

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

Creates a new Ascon-AEAD128 instance from a 16-byte key.

Trait Implementations

impl Aead for AsconAead128

const TAG_SIZE: usize = 16

const NONCE_SIZE: usize = 16

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 AsconAead128

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 AsconAead128

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.