Struct ChaCha20Poly1305 

pub struct ChaCha20Poly1305 { /* private fields */ }

ChaCha20-Poly1305 AEAD as specified in RFC 8439.

Parameters

• Key: 256 bits (32 bytes)
• Nonce: 96 bits (12 bytes)
• Tag: 128 bits (16 bytes)

Panics

encrypt_in_place panics if in_out exceeds [CHACHA20_IETF_MAX_LEN] bytes (~256 GiB), the maximum allowed by RFC 8439’s 32-bit block counter. decrypt_in_place returns [AeadError::InvalidCiphertext] in that case instead.

Implementations

impl ChaCha20Poly1305

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

Creates a new AEAD instance from a 32-byte key.

Trait Implementations

impl Aead for ChaCha20Poly1305

const KEY_SIZE: usize = 32

const TAG_SIZE: usize = 16

const NONCE_SIZE: usize = 12

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 Aead for ChaCha20Poly1305

ChaCha20-Poly1305 (AEAD id 0x0003).

const HPKE_AEAD_ID: u16 = 0x0003

The HPKE AEAD identifier (draft-ietf-hpke-hpke-05 Section 7.3, IANA “HPKE AEAD Identifiers”), used to build the ciphersuite suite_id.

const MAX_PLAINTEXT_SIZE: u64 = CHACHA20_POLY1305_MAX_PLAINTEXT_SIZE

Maximum length, in bytes, of a plaintext passed to Aead::seal, i.e. P_MAX ([RFC 5116]).

const MAX_CIPHERTEXT_SIZE: u64 = CHACHA20_POLY1305_MAX_CIPHERTEXT_SIZE

Maximum length, in bytes, of a ciphertext passed to Aead::open, i.e. C_MAX ([RFC 5116]).

fn new(key: &[u8]) -> Result<Self, HpkeError>

Instantiates the cipher from KEY_SIZE raw key bytes, as produced by the HPKE key schedule.

fn seal( &self, in_out: &mut [u8], nonce: &[u8], associated_data: &[u8], ) -> Result<Hash, HpkeError>

Encrypts in_out in place and returns the detached authentication tag, forwarding to [crypto::Aead::encrypt_in_place].

fn open( &self, in_out: &mut [u8], nonce: &[u8], associated_data: &[u8], tag: &[u8], ) -> Result<(), HpkeError>

Decrypts in_out in place using the detached authentication tag, forwarding to [crypto::Aead::decrypt_in_place].

impl Drop for ChaCha20Poly1305

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 ChaCha20Poly1305

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.