Struct Kem 

pub struct Kem { /* private fields */ }

KEM (Key Encapsulation Mechanism) subsystem.

Provides access to post-quantum key encapsulation operations using ML-KEM (formerly Kyber).

Example

use quantacore::{initialize, open_first_device, KemAlgorithm};

initialize().unwrap();
let device = open_first_device().unwrap();
let kem = device.kem();

// Generate key pair
let keypair = kem.generate_keypair(KemAlgorithm::MlKem768).unwrap();

// Encapsulate (sender side)
let (ciphertext, sender_secret) = kem.encapsulate(
    keypair.public_key(),
    KemAlgorithm::MlKem768
).unwrap();

// Decapsulate (receiver side)
let receiver_secret = kem.decapsulate(
    keypair.secret_key(),
    &ciphertext,
    KemAlgorithm::MlKem768
).unwrap();

assert_eq!(sender_secret, receiver_secret);

Implementations

impl Kem

pub fn generate_keypair(&self, algorithm: KemAlgorithm) -> Result<KeyPair>

Generate a KEM key pair.

Arguments

• algorithm - The KEM algorithm to use

Returns

A KeyPair containing the public and secret keys.

pub fn generate_keypair_512(&self) -> Result<KeyPair>

Generate ML-KEM-512 key pair.

pub fn generate_keypair_768(&self) -> Result<KeyPair>

Generate ML-KEM-768 key pair.

pub fn generate_keypair_1024(&self) -> Result<KeyPair>

Generate ML-KEM-1024 key pair.

pub fn encapsulate( &self, public_key: &[u8], algorithm: KemAlgorithm, ) -> Result<(Vec<u8>, Vec<u8>)>

Encapsulate to generate a shared secret and ciphertext.

This is the sender’s operation. The ciphertext should be sent to the recipient who can decapsulate using their secret key.

Arguments

• public_key - The recipient’s public key
• algorithm - The KEM algorithm to use

Returns

A tuple of (ciphertext, shared_secret).

pub fn encapsulate_result( &self, public_key: &[u8], algorithm: KemAlgorithm, ) -> Result<EncapsulationResult>

Encapsulate returning an EncapsulationResult.

pub fn encapsulate_512(&self, public_key: &[u8]) -> Result<(Vec<u8>, Vec<u8>)>

Encapsulate using ML-KEM-512.

pub fn encapsulate_768(&self, public_key: &[u8]) -> Result<(Vec<u8>, Vec<u8>)>

Encapsulate using ML-KEM-768.

pub fn encapsulate_1024(&self, public_key: &[u8]) -> Result<(Vec<u8>, Vec<u8>)>

Encapsulate using ML-KEM-1024.

pub fn decapsulate( &self, secret_key: &[u8], ciphertext: &[u8], algorithm: KemAlgorithm, ) -> Result<Vec<u8>>

Decapsulate to recover the shared secret.

This is the recipient’s operation. Use the secret key and received ciphertext to recover the shared secret.

Arguments

• secret_key - The recipient’s secret key
• ciphertext - The ciphertext received from the sender
• algorithm - The KEM algorithm to use

Returns

The shared secret (same as the sender’s).

pub fn decapsulate_512( &self, secret_key: &[u8], ciphertext: &[u8], ) -> Result<Vec<u8>>

Decapsulate using ML-KEM-512.

pub fn decapsulate_768( &self, secret_key: &[u8], ciphertext: &[u8], ) -> Result<Vec<u8>>

Decapsulate using ML-KEM-768.

pub fn decapsulate_1024( &self, secret_key: &[u8], ciphertext: &[u8], ) -> Result<Vec<u8>>

Decapsulate using ML-KEM-1024.

Trait Implementations

impl Clone for Kem

fn clone(&self) -> Kem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Kem

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

Formats the value using the given formatter.