Enum MLKEM 

#[repr(u32)]
pub enum MLKEM {
    MLKEM512 = 512,
    MLKEM768 = 768,
    MLKEM1024 = 1_024,
}

Security levels for the ML-KEM post-quantum key encapsulation mechanism.

ML-KEM (Module Lattice-based Key Encapsulation Mechanism) is a post-quantum key encapsulation mechanism standardized by NIST. It provides resistance against attacks from both classical and quantum computers.

Each security level offers different trade-offs between security, performance, and key/ciphertext sizes:

• MLKEM512: NIST security level 1 (roughly equivalent to AES-128)
• MLKEM768: NIST security level 3 (roughly equivalent to AES-192)
• MLKEM1024: NIST security level 5 (roughly equivalent to AES-256)

The numeric values (512, 768, 1024) correspond to the parameter sets and are used in CBOR serialization.

Variants

MLKEM512 = 512

ML-KEM-512 (NIST security level 1, roughly equivalent to AES-128)

MLKEM768 = 768

ML-KEM-768 (NIST security level 3, roughly equivalent to AES-192)

MLKEM1024 = 1_024

ML-KEM-1024 (NIST security level 5, roughly equivalent to AES-256)

Implementations

impl MLKEM

pub const SHARED_SECRET_SIZE: usize = 32usize

The size of a shared secret in bytes (32 bytes for all security levels).

pub fn keypair(self) -> (MLKEMPrivateKey, MLKEMPublicKey)

Generates a new ML-KEM keypair with the specified security level.

Returns

A tuple containing the private key and public key.

Examples

use bc_components::MLKEM;

let (private_key, public_key) = MLKEM::MLKEM512.keypair();

pub fn private_key_size(&self) -> usize

Returns the size of a private key in bytes for this security level.

Returns

• MLKEM512: 1632 bytes
• MLKEM768: 2400 bytes
• MLKEM1024: 3168 bytes

pub fn public_key_size(&self) -> usize

Returns the size of a public key in bytes for this security level.

Returns

• MLKEM512: 800 bytes
• MLKEM768: 1184 bytes
• MLKEM1024: 1568 bytes

pub fn shared_secret_size(&self) -> usize

Returns the size of a shared secret in bytes for this security level.

This is 32 bytes for all security levels.

pub fn ciphertext_size(&self) -> usize

Returns the size of a ciphertext in bytes for this security level.

Returns

• MLKEM512: 768 bytes
• MLKEM768: 1088 bytes
• MLKEM1024: 1568 bytes

Trait Implementations

impl Clone for MLKEM

fn clone(&self) -> MLKEM

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MLKEM

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

Formats the value using the given formatter.

impl From<MLKEM> for CBOR

Converts an MLKEM value to CBOR.

fn from(mlkem: MLKEM) -> Self

Converts to the numeric security level value (512, 768, or 1024).

impl Hash for MLKEM

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 MLKEM

fn eq(&self, other: &MLKEM) -> 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 TryFrom<CBOR> for MLKEM

Attempts to convert CBOR to an MLKEM value.

fn try_from(cbor: CBOR) -> Result<Self>

Converts from a CBOR-encoded security level (512, 768, or 1024).

Errors

Returns an error if the CBOR value doesn’t represent a valid ML-KEM level.

type Error = Error

The type returned in the event of a conversion error.

impl Copy for MLKEM

impl Eq for MLKEM

impl StructuralPartialEq for MLKEM