Crate qserde

qserde is a non-std rust library for serializing/deserializing ml-kem(aka kyber) public key, encapsulating/decapsulating 256 bit keys and so on.

WARNING

Current version of ml-kem crate used in this crate does not support rand crate of 0.9.x versions, so if everything doesn’t work maybe you should downgrade the rand crate version to at least 0.8.5

usage

Use generate_keypair{512/768/1024} to generate keypair, encapsulation key’s functions to_bytes, from_bytes, encapsulate to do encapsulation, serialize and deserialize it. And decapsulate func of DecapsulationKey to decapsulate ciphertexts Here’s usage example below:

use qserde::*;

let mut rng = rand::thread_rng();

//generating ml_kem keypair of 1024-bit mode
let (dk, ek) = generate_keypair1024(&mut rng);

//encapsulation key deserialized into bytes
let serialized_encapsulaion_key = ek.to_bytes();

//converting bytes into 1024-bit mode encapsulation key
let ek = EncapsulationKey1024::from_bytes(&ek).unwrap();

//encapsulating random 32 bytes
let (ciphertext, shared_secret) = ek.encapsulate(&mut rng).unwrap();

//decapsulating shared secret from ciphertext
let another_shared_secret = dk.decapsulate(&ciphertext).unwrap();

assert_eq!(shared_secret, another_shared_secret);

Structs

DecapsulationKey512

512-bit ml-kem decapsulation key

DecapsulationKey768

768-bit ml-kem decapsulation key

DecapsulationKey1024

1024-bit ml-kem decapsulation key

EncapsulationKey512

512-bit ml-kem encapsulation key

EncapsulationKey768

768-bit ml-kem encapsulation key

EncapsulationKey1024

1024-bit ml-kem encapsulation key

Functions

generate_keypair512

Creates ml-kem 512 bit size keypair

generate_keypair768

Creates ml-kem 768 bit size keypair

generate_keypair1024

Creates ml-kem 1024 bit size keypair