Trait AeadDecryptSemantic 

pub trait AeadDecryptSemantic: Aead {
    // Required method
    fn decrypt_semantic(
        &self,
        key: &AeadKey,
        nonce: &Nonce,
        ciphertext: &[u8],
        associated_data: Option<&[u8]>,
    ) -> Result<DecryptSemanticOutcome, Error>;
}

AEAD implementations that expose a semantic decrypt API (Layer B).

Implementors must also implement Aead. Operational errors (invalid sizes, keys, nonces, configuration) are returned as Err. Only post-decrypt authentication failure is reported as DecryptSemanticOutcome::AuthenticationFailed inside Ok.

This trait is separate from Aead so dyn AeadOperations and other object-safe surfaces can remain Result-only (crate::api::AeadOperations) without forcing every backend to expose semantic decrypt.

Required Methods

fn decrypt_semantic( &self, key: &AeadKey, nonce: &Nonce, ciphertext: &[u8], associated_data: Option<&[u8]>, ) -> Result<DecryptSemanticOutcome, Error>

Decrypt and classify the outcome without overloading Result for auth failure.

Dyn Compatibility

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementations on Foreign Types

impl AeadDecryptSemantic for DuplexSpongeAead

fn decrypt_semantic( &self, key: &AeadKey, nonce: &Nonce, ciphertext: &[u8], associated_data: Option<&[u8]>, ) -> Result<DecryptSemanticOutcome, Error>

impl AeadDecryptSemantic for RomulusMAead

fn decrypt_semantic( &self, key: &AeadKey, nonce: &Nonce, ciphertext: &[u8], associated_data: Option<&[u8]>, ) -> Result<DecryptSemanticOutcome, Error>

impl AeadDecryptSemantic for RomulusNAead

fn decrypt_semantic( &self, key: &AeadKey, nonce: &Nonce, ciphertext: &[u8], associated_data: Option<&[u8]>, ) -> Result<DecryptSemanticOutcome, Error>

impl AeadDecryptSemantic for SaturninAead

fn decrypt_semantic( &self, key: &AeadKey, nonce: &Nonce, ciphertext: &[u8], associated_data: Option<&[u8]>, ) -> Result<DecryptSemanticOutcome, Error>

impl AeadDecryptSemantic for Shake256Aead

fn decrypt_semantic( &self, key: &AeadKey, nonce: &Nonce, ciphertext: &[u8], associated_data: Option<&[u8]>, ) -> Result<DecryptSemanticOutcome, Error>

impl AeadDecryptSemantic for TweakAead

fn decrypt_semantic( &self, key: &AeadKey, nonce: &Nonce, ciphertext: &[u8], associated_data: Option<&[u8]>, ) -> Result<DecryptSemanticOutcome, Error>

impl AeadDecryptSemantic for DuplexSpongeAead

Available on crate feature alloc only.

fn decrypt_semantic( &self, key: &AeadKey, nonce: &Nonce, ciphertext: &[u8], associated_data: Option<&[u8]>, ) -> Result<DecryptSemanticOutcome, Error>

impl AeadDecryptSemantic for RomulusMAead

fn decrypt_semantic( &self, key: &AeadKey, nonce: &Nonce, ciphertext: &[u8], associated_data: Option<&[u8]>, ) -> Result<DecryptSemanticOutcome, Error>

impl AeadDecryptSemantic for RomulusNAead

fn decrypt_semantic( &self, key: &AeadKey, nonce: &Nonce, ciphertext: &[u8], associated_data: Option<&[u8]>, ) -> Result<DecryptSemanticOutcome, Error>

impl AeadDecryptSemantic for SaturninAead

fn decrypt_semantic( &self, key: &AeadKey, nonce: &Nonce, ciphertext: &[u8], associated_data: Option<&[u8]>, ) -> Result<DecryptSemanticOutcome, Error>

Layer B semantic decrypt; see docs/adr/003-aead-decrypt-layers.md.

impl AeadDecryptSemantic for TweakAead

Available on crate feature alloc only.

fn decrypt_semantic( &self, key: &AeadKey, nonce: &Nonce, ciphertext: &[u8], associated_data: Option<&[u8]>, ) -> Result<DecryptSemanticOutcome, Error>

Implementors