Struct PqNtt 

pub struct PqNtt { /* private fields */ }

A ready-to-use NTT engine configured for a specific post-quantum scheme.

Wraps Ntt32Context with scheme metadata for safety and convenience.

Example

use vaea_ntt::pq::{PqScheme, PqNtt};

let ntt = PqNtt::new(PqScheme::MlDsa65);
assert_eq!(ntt.scheme(), PqScheme::MlDsa65);
assert_eq!(ntt.n(), 256);
assert_eq!(ntt.q(), 8380417);

let mut data = vec![0u32; 256];
data[0] = 1;
ntt.forward(&mut data);
ntt.inverse(&mut data);
assert_eq!(data[0], 1);

Implementations

impl PqNtt

pub fn new(scheme: PqScheme) -> Self

Creates a new PQ-NTT engine for the given scheme.

This precomputes all twiddle factors and modular arithmetic constants. The context can be reused for multiple NTT calls.

pub fn scheme(&self) -> PqScheme

Returns the scheme this engine was configured for.

pub fn n(&self) -> usize

Returns the polynomial degree N.

pub fn q(&self) -> u32

Returns the prime modulus q.

pub fn security_level(&self) -> u8

Returns the NIST security level.

pub fn context(&self) -> &Ntt32Context

Returns a reference to the underlying Ntt32Context.

pub fn forward(&self, data: &mut [u32])

Applies forward NTT in-place.

Transforms from coefficient domain to evaluation (NTT) domain. In NTT domain, polynomial multiplication is pointwise O(N).

Panics

If data.len() != self.n().

pub fn inverse(&self, data: &mut [u32])

Applies inverse NTT in-place.

Transforms from evaluation (NTT) domain back to coefficient domain. Includes the N⁻¹ normalization factor.

Panics

If data.len() != self.n().

pub fn multiply(&self, a: &[u32], b: &[u32]) -> Vec<u32>

Computes negacyclic polynomial multiplication: result = a × b mod (X^N + 1, q).

Both inputs must be in coefficient domain (not NTT). Result is in coefficient domain.

Panics

If a.len() != self.n() or b.len() != self.n().

pub fn multiply_into(&self, a: &mut [u32], b: &mut [u32], result: &mut [u32])

Computes negacyclic polynomial multiplication: result = a × b mod (X^N + 1, q).

Both a and b are consumed (transformed in-place as scratch space). Result is written to result.

Panics

If any slice length != self.n().

Trait Implementations

impl Debug for PqNtt

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

Formats the value using the given formatter.