Struct PublicKey1024 

pub struct PublicKey1024 { /* private fields */ }

ML-KEM-1024 encapsulation key (public key) as defined in FIPS 203.

See SecretKey1024 for a full usage example.

Implementations

impl PublicKey1024

pub fn from_bytes(bytes: &[u8; 1568]) -> Result<Self, MlKemError>

Parses an encapsulation key from its FIPS 203 encoding.

Returns MlKemError::InvalidKey when the encoded t̂ is not canonical, i.e. when any of its coefficients is not in [0, q-1] (FIPS 203 Section 7.2 modulus check).

pub fn to_bytes(&self) -> [u8; 1568]

Returns the FIPS 203 encoding of this encapsulation key.

pub fn encapsulate(&self) -> Result<([u8; 32], [u8; 1568]), MlKemError>

Encapsulates a fresh random shared secret against this public key.

Returns MlKemError::Random when the operating system’s random number generator is unavailable or fails.

pub fn encapsulate_derand(&self, coins: &[u8; 32]) -> ([u8; 32], [u8; 1568])

Encapsulates a shared secret against this public key using the provided 32-byte coins as the encapsulation randomness.

This is the deterministic counterpart of PublicKey1024::encapsulate, useful for reproducing FIPS 203 / ACVP test vectors. It must not be used with repeated coins.

Trait Implementations

impl Clone for PublicKey1024

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PublicKey1024

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

Formats the value using the given formatter.

impl Eq for PublicKey1024

impl PartialEq for PublicKey1024

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PublicKey1024

impl TryFrom<&[u8]> for PublicKey1024

type Error = MlKemError

The type returned in the event of a conversion error.

fn try_from(bytes: &[u8]) -> Result<Self, Self::Error>

Performs the conversion.