Struct SecretKey768 

pub struct SecretKey768 { /* private fields */ }

ML-KEM-768 decapsulation key (secret key) as defined in FIPS 203.

A key is created with SecretKey768::generate (fresh random key) or SecretKey768::generate_derand (deterministic, for test vectors).

Example

use crypto::mlkem::SecretKey768;

let (secret_key, public_key) = SecretKey768::generate_derand(&[0u8; 64]);
let (shared_secret, ciphertext) = public_key.encapsulate_derand(&[0u8; 32]);
let decapsulated = secret_key.decapsulate(&ciphertext).unwrap();
assert_eq!(shared_secret, decapsulated);

Implementations

impl SecretKey768

pub fn from_bytes(bytes: &[u8; 2400]) -> Self

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

pub fn generate() -> Result<(Self, PublicKey768), MlKemError>

Generates a fresh random keypair.

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

pub fn generate_derand(coins: &[u8; 64]) -> (Self, PublicKey768)

pub fn decapsulate( &self, ciphertext: &[u8; 1088], ) -> Result<[u8; 32], MlKemError>

Decapsulates ciphertext, recovering the shared secret encapsulated in it.

Implements the FIPS 203 implicit-rejection transform: a ciphertext that does not re-encrypt to itself does not produce an error, but instead yields a pseudorandom shared secret derived from the key and ciphertext.

Returns MlKemError::InvalidKey if this key fails the FIPS 203 decapsulation-key check, i.e. the hash of its embedded encapsulation key does not match the hash stored in the key.

pub fn public_key(&self) -> PublicKey768

Trait Implementations

impl Clone for SecretKey768

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Drop for SecretKey768

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Eq for SecretKey768

impl From<&[u8; 2400]> for SecretKey768

fn from(bytes: &[u8; 2400]) -> Self

Converts to this type from the input type.

impl PartialEq for SecretKey768

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SecretKey768

impl TryFrom<&[u8]> for SecretKey768

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.

impl Zeroize for SecretKey768

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.