Trait SymmetricCipher 

pub trait SymmetricCipher: Sized {
    type Key: Zeroize + AsRef<[u8]> + AsMut<[u8]> + Clone;
    type Nonce: AsRef<[u8]> + AsMut<[u8]> + Clone;
    type Ciphertext: AsRef<[u8]> + AsMut<[u8]> + Clone;
    type EncryptOperation<'a>: EncryptOperation<'a, Self>
       where Self: 'a;
    type DecryptOperation<'a>: DecryptOperation<'a, Self>
       where Self: 'a;

    // Required methods
    fn name() -> &'static str;
    fn encrypt(&self) -> Self::EncryptOperation<'_>;
    fn decrypt(&self) -> Self::DecryptOperation<'_>;
    fn generate_key<R: RngCore + CryptoRng>(rng: &mut R) -> Result<Self::Key>;
    fn generate_nonce<R: RngCore + CryptoRng>(
        rng: &mut R,
    ) -> Result<Self::Nonce>;
    fn derive_key_from_bytes(bytes: &[u8]) -> Result<Self::Key>;
}

Trait for symmetric encryption algorithms with enhanced type safety

Required Associated Types

type Key: Zeroize + AsRef<[u8]> + AsMut<[u8]> + Clone

Key type with appropriate algorithm binding

type Nonce: AsRef<[u8]> + AsMut<[u8]> + Clone

Nonce type with appropriate size constraint

type Ciphertext: AsRef<[u8]> + AsMut<[u8]> + Clone

Ciphertext output type

type EncryptOperation<'a>: EncryptOperation<'a, Self> where Self: 'a

Operation type for encryption operations

type DecryptOperation<'a>: DecryptOperation<'a, Self> where Self: 'a

Operation type for decryption operations

Required Methods

fn name() -> &'static str

Returns the symmetric cipher algorithm name

fn encrypt(&self) -> Self::EncryptOperation<'_>

Begin encryption operation

fn decrypt(&self) -> Self::DecryptOperation<'_>

Begin decryption operation

fn generate_key<R: RngCore + CryptoRng>(rng: &mut R) -> Result<Self::Key>

Generate a new random key

fn generate_nonce<R: RngCore + CryptoRng>(rng: &mut R) -> Result<Self::Nonce>

Generate a new random nonce

fn derive_key_from_bytes(bytes: &[u8]) -> Result<Self::Key>

Derive a key from arbitrary bytes

Dyn Compatibility

This trait is not dyn compatible.

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

Implementors