rustpq 0.3.0

Pure Rust post-quantum cryptography suite - ML-KEM, ML-DSA, and more
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

//! ML-DSA (Module-Lattice-Based Digital Signature Algorithm) implementation.
//!
//! This module implements FIPS 204 (ML-DSA), formerly known as CRYSTALS-Dilithium.
//!
//! # Parameter Sets
//!
//! | Parameter Set | Security Level | Feature Flag |
//! |--------------|----------------|--------------|
//! | ML-DSA-44    | NIST Level 2   | `mldsa44`    |
//! | ML-DSA-65    | NIST Level 3   | `mldsa65`    |
//! | ML-DSA-87    | NIST Level 5   | `mldsa87`    |
//!
//! # Example
//!
//! ```
//! use rustpq::ml_dsa::mldsa44::{generate, sign, verify};
//! use rand::rngs::OsRng;
//!
//! let (pk, sk) = generate(&mut OsRng);
//! let message = b"Hello World";
//! let signature = sign(&sk, message, b"", &mut OsRng).unwrap();
//!
//! assert!(verify(&pk, message, b"", &signature).is_ok());
//! ```

#![allow(clippy::needless_range_loop)]
#![allow(dead_code)]

mod ntt;
mod packing;
mod params;
mod poly;
mod polyvec;
mod reduce;
mod rounding;
mod sampling;
mod symmetric;

pub mod error;
pub mod sign;

pub use error::Error;

#[cfg(feature = "mldsa44")]
pub mod mldsa44 {
    //! ML-DSA-44 (NIST Level 2 security).
    pub use super::sign::mldsa44::*;
}

#[cfg(feature = "mldsa65")]
pub mod mldsa65 {
    //! ML-DSA-65 (NIST Level 3 security).
    pub use super::sign::mldsa65::*;
}

#[cfg(feature = "mldsa87")]
pub mod mldsa87 {
    //! ML-DSA-87 (NIST Level 5 security).
    pub use super::sign::mldsa87::*;
}