Struct EncapsulationKey 

pub struct EncapsulationKey { /* private fields */ }

An ML-KEM-1024 encapsulation (public) key.

Implementations

impl EncapsulationKey

pub fn from_bytes(ek_bytes: &[u8]) -> Result<Self>

Constructs an encapsulation key from its MLKEM1024_ENCAPSULATION_KEY_SIZE-byte encoded form. Rejects non-canonical encodings (any coefficient >= q).

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

Produces a fresh (shared_key, ciphertext) pair using system randomness for the encapsulated message.

pub fn encapsulate_deterministic( &self, m: &[u8; 32], ) -> (Zeroizing<[u8; 32]>, [u8; 1568])

Derandomized counterpart to EncapsulationKey::encapsulate that takes the 32-byte message m explicitly.

Test-only. Reusing m across encapsulations breaks IND-CCA security; this exists solely to reproduce ACVP / Wycheproof / cross-verification vectors. Production code must call EncapsulationKey::encapsulate.

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

Returns the encoded form of the encapsulation key.

Trait Implementations

impl Clone for EncapsulationKey

fn clone(&self) -> EncapsulationKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.