Enum Algorithm 

#[non_exhaustive]
pub enum Algorithm {
    ChaCha20Poly1305,
    Aes256Gcm,
}

Available on crate features aead-chacha20 or aead-aes-gcm only.

Supported AEAD algorithms.

The enum is #[non_exhaustive]. New algorithms are added in minor releases; downstream match sites must include a wildcard arm.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ChaCha20Poly1305

ChaCha20-Poly1305 (RFC 8439). The default. Fast in software, post-quantum-safe at 256-bit symmetric strength, no timing-side-channel risk on platforms without constant-time hardware AES.

Aes256Gcm

AES-256-GCM (NIST SP 800-38D). Hardware-accelerated on every modern x86 CPU (AES-NI + CLMUL) and on ARMv8 with the crypto extensions. Pick this when you need interop with TLS / JWE / spec’d protocols or when running on AES-accelerated hardware.

Implementations

impl Algorithm

pub const fn name(self) -> &'static str

Human-readable name of the algorithm.

pub const fn key_len(self) -> usize

Required key length in bytes for this algorithm.

pub const fn nonce_len(self) -> usize

Nonce length in bytes that this algorithm uses.

pub const fn tag_len(self) -> usize

Authentication-tag length in bytes that this algorithm produces.

Trait Implementations

impl Clone for Algorithm

fn clone(&self) -> Algorithm

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Algorithm

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

Formats the value using the given formatter.

impl Default for Algorithm

fn default() -> Algorithm

Returns the “default value” for a type.

impl Hash for Algorithm

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Algorithm

fn eq(&self, other: &Algorithm) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Algorithm

impl Eq for Algorithm

impl StructuralPartialEq for Algorithm