Enum DilithiumMode 

pub enum DilithiumMode {
    Dilithium2,
    Dilithium3,
    Dilithium5,
}

ML-DSA / Dilithium security levels (FIPS 204).

The FIPS 204 standard names are ML-DSA-44, ML-DSA-65, and ML-DSA-87. The Dilithium2/3/5 names are provided for compatibility with the original CRYSTALS-Dilithium submission.

Variants

Dilithium2

ML-DSA-44 (NIST Level 2): K=4, L=4

Dilithium3

ML-DSA-65 (NIST Level 3): K=6, L=5

Dilithium5

ML-DSA-87 (NIST Level 5): K=8, L=7

Implementations

impl DilithiumMode

pub const fn mode_tag(self) -> u8

Byte tag for binary serialization (matches NIST level: 2, 3, 5).

pub const fn from_tag(tag: u8) -> Option<Self>

Recover mode from a serialization tag.

pub const fn k(self) -> usize

Number of rows in the matrix A.

pub const fn l(self) -> usize

Number of columns in the matrix A.

pub const fn eta(self) -> i32

Secret key coefficient bound.

pub const fn tau(self) -> usize

Number of ±1 coefficients in the challenge polynomial.

pub const fn beta(self) -> i32

Rejection bound: TAU * ETA.

pub const fn gamma1(self) -> i32

Masking vector coefficient range: coefficients in [-(GAMMA1-1), GAMMA1].

pub const fn gamma2(self) -> i32

Low-order rounding range: GAMMA2 = (Q-1)/88 or (Q-1)/32.

pub const fn omega(self) -> usize

Maximum number of ones in the hint vector.

pub const fn ctildebytes(self) -> usize

Challenge hash output length in bytes.

pub const fn polyz_packedbytes(self) -> usize

Packed size for z polynomial.

pub const fn polyw1_packedbytes(self) -> usize

Packed size for w1 polynomial.

pub const fn polyeta_packedbytes(self) -> usize

Packed size for eta polynomial.

pub const fn public_key_bytes(self) -> usize

Public key size in bytes.

pub const fn secret_key_bytes(self) -> usize

Secret key size in bytes.

pub const fn signature_bytes(self) -> usize

Signature size in bytes.

pub fn hash_oid(self) -> &'static [u8]

Get the HashML-DSA OID for this mode.

pub fn fips_name(self) -> &'static str

FIPS 204 algorithm name.

Trait Implementations

impl Clone for DilithiumMode

fn clone(&self) -> DilithiumMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DilithiumMode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DilithiumMode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for DilithiumMode

fn eq(&self, other: &DilithiumMode) -> 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 Serialize for DilithiumMode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for DilithiumMode

impl Eq for DilithiumMode

impl StructuralPartialEq for DilithiumMode