Expand description
Byte-oriented Ascon algorithms from NIST SP 800-232 (August 2025).
All operations use caller-owned buffers and work without allocation. Disable
default features for no_std. See Aead128, Hash256, Xof128, and
Cxof128. Nonces must never repeat under the same encryption key.
use ascon::{Aead128, hash256};
let cipher = Aead128::new(&[7; 16]);
let nonce = [1; 16]; // Use a unique nonce for every encryption with this key.
let mut message = *b"hello";
let tag = cipher.encrypt_in_place(&nonce, b"metadata", &mut message);
cipher.decrypt_in_place(&nonce, b"metadata", &mut message, &tag)?;
assert_eq!(&message, b"hello");
assert_eq!(hash256(&message).len(), 32);Structs§
- Aead128
- Ascon-AEAD128 with a 128-bit key and full 128-bit tags.
- Cxof128
- Streaming Ascon-CXOF128, domain separated by a customization string.
- Hash256
- Streaming Ascon-Hash256 with a 32-byte digest.
- Xof128
- Streaming Ascon-XOF128 with caller-selected output length.
- XofReader
- Squeezing state for XOF128 or CXOF128. Each read continues the output stream.
Enums§
- Error
- Errors from the public cryptographic API.
Constants§
- KEY_
SIZE - Key length in bytes.
- NONCE_
SIZE - Nonce length in bytes.
- TAG_
SIZE - Full authentication tag length in bytes.