Struct AeadContext 

pub struct AeadContext { /* private fields */ }

AEAD context for authenticated encryption operations

Implementations

impl AeadContext

pub fn new() -> Self

Create an AEAD context with no provider configured.

Operations return Error::ProviderNotConfigured until you call set_provider or build via with_aead_operations. The lib-q crate provides libq::aead::context() wired to lib-q-aead.

pub fn with_provider(provider: Box<dyn CryptoProvider>) -> Self

Create a new AEAD context with a provider

pub fn with_aead_operations(aead: Box<dyn AeadOperations + Send + Sync>) -> Self

Create a new AEAD context backed by the given AEAD implementation only.

The lib-q facade typically injects lib_q_aead::LibQAeadProvider this way so lib-q-core does not depend on lib-q-aead.

pub fn with_default_provider() -> Self

Create a new AEAD context with the default provider

pub fn set_provider(&mut self, provider: Box<dyn CryptoProvider>)

Set the cryptographic provider

pub fn provider(&self) -> Option<&dyn CryptoProvider>

Get the current provider

pub fn encrypt( &mut self, algorithm: Algorithm, key: &AeadKey, nonce: &Nonce, plaintext: &[u8], associated_data: Option<&[u8]>, ) -> Result<Vec<u8>>

Encrypt data using the specified algorithm

pub fn decrypt( &self, algorithm: Algorithm, key: &AeadKey, nonce: &Nonce, ciphertext: &[u8], associated_data: Option<&[u8]>, ) -> Result<Vec<u8>>

Decrypt data using the specified algorithm.

Dispatches through AeadOperations::decrypt (Layer A Result only). Semantic decrypt (crate::AeadDecryptSemantic) is not part of this context; see ADR docs/adr/003-aead-decrypt-layers.md.

pub fn is_initialized(&self) -> bool

Check if the context is initialized

Trait Implementations

impl Default for AeadContext

Available on crate feature alloc only.

fn default() -> Self

Returns the “default value” for a type.