Struct UnboundKey 

pub struct UnboundKey {
    ctx: AeadCtx,
    algorithm: &'static Algorithm,
}

An AEAD key without a designated role or nonce sequence.

Fields

ctx: AeadCtx

algorithm: &'static Algorithm

Implementations

impl UnboundKey

pub fn new( algorithm: &'static Algorithm, key_bytes: &[u8], ) -> Result<Self, Unspecified>

Constructs an UnboundKey.

Errors

error::Unspecified if key_bytes.len() != algorithm.key_len().

pub(crate) fn open_within<'in_out>( &self, nonce: Nonce, aad: &[u8], in_out: &'in_out mut [u8], ciphertext_and_tag: RangeFrom<usize>, ) -> Result<&'in_out mut [u8], Unspecified>

pub(crate) fn open_separate_gather( &self, nonce: &Nonce, aad: &[u8], in_ciphertext: &[u8], in_tag: &[u8], out_plaintext: &mut [u8], ) -> Result<(), Unspecified>

pub(crate) fn open_in_place_separate_tag( &self, nonce: &Nonce, aad: &[u8], in_tag: &[u8], in_out: &mut [u8], ) -> Result<(), Unspecified>

fn open_separate_gather_impl( &self, nonce: &Nonce, aad: &[u8], in_ciphertext: *const u8, in_ciphertext_len: usize, in_tag: &[u8], out_plaintext: *mut u8, out_plaintext_len: usize, ) -> Result<(), Unspecified>

Common FFI path for EVP_AEAD_CTX_open_gather-based opening.

in_ciphertext / out_plaintext may alias (exactly, i.e. same base pointer and length). EVP_AEAD_CTX_open_gather explicitly permits out == in, which is how open_in_place_separate_tag works.

Callers must ensure:

• in_ciphertext is valid for reads of in_ciphertext_len bytes.
• out_plaintext is valid for writes of out_plaintext_len bytes.
• If the two pointers alias, they must alias exactly (same base, same length).

pub(crate) fn seal_in_place_append_tag<'a, InOut>( &self, nonce: Option<Nonce>, aad: &[u8], in_out: &'a mut InOut, ) -> Result<Nonce, Unspecified>

where InOut: AsMut<[u8]> + for<'in_out> Extend<&'in_out u8>,

pub(crate) fn seal_in_place_separate_tag( &self, nonce: Option<Nonce>, aad: &[u8], in_out: &mut [u8], ) -> Result<(Nonce, Tag), Unspecified>

pub(crate) fn seal_in_place_separate_scatter( &self, nonce: Nonce, aad: &[u8], in_out: &mut [u8], extra_in: &[u8], extra_out_and_tag: &mut [u8], ) -> Result<(), Unspecified>

pub fn algorithm(&self) -> &'static Algorithm

The key’s AEAD algorithm.

pub(crate) fn check_per_nonce_max_bytes( &self, in_out_len: usize, ) -> Result<(), Unspecified>

fn open_combined( &self, nonce: Nonce, aad: &[u8], in_out: &mut [u8], ) -> Result<(), Unspecified>

fn open_combined_randnonce( &self, nonce: Nonce, aad: &[u8], in_out: &mut [u8], ) -> Result<(), Unspecified>

fn seal_combined<InOut>( &self, nonce: Nonce, aad: &[u8], in_out: &mut InOut, ) -> Result<Nonce, Unspecified>

where InOut: AsMut<[u8]> + for<'in_out> Extend<&'in_out u8>,

fn seal_combined_randnonce<InOut>( &self, aad: &[u8], in_out: &mut InOut, ) -> Result<Nonce, Unspecified>

where InOut: AsMut<[u8]> + for<'in_out> Extend<&'in_out u8>,

fn seal_separate( &self, nonce: Nonce, aad: &[u8], in_out: &mut [u8], ) -> Result<(Nonce, Tag), Unspecified>

fn seal_separate_randnonce( &self, aad: &[u8], in_out: &mut [u8], ) -> Result<(Nonce, Tag), Unspecified>

Trait Implementations

impl Debug for UnboundKey

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl From<AeadCtx> for UnboundKey

fn from(value: AeadCtx) -> Self

Converts to this type from the input type.

impl From<Okm<'_, &'static Algorithm>> for UnboundKey

fn from(okm: Okm<'_, &'static Algorithm>) -> Self

Converts to this type from the input type.