Post-quantum primitives

@webbuf/mlkem

Rust/wasm ML-KEM (FIPS 203) post-quantum key encapsulation

Install

npm install @webbuf/mlkem

Usage

import {
  mlKem768KeyPair,
  mlKem768Encapsulate,
  mlKem768Decapsulate,
} from "@webbuf/mlkem";

const { encapsulationKey, decapsulationKey } = mlKem768KeyPair();
const { ciphertext, sharedSecret } = mlKem768Encapsulate(encapsulationKey);
const recovered = mlKem768Decapsulate(decapsulationKey, ciphertext);

API reference (20 exports)

Constants

ML_KEM_1024

const

ML_KEM_1024: { readonly encapsulationKeySize: 1568; readonly decapsulationKeySize: 3168; readonly ciphertextSize: 1568; readonly sharedSecretSize: 32; }

ML_KEM_512

const

ML_KEM_512: { readonly encapsulationKeySize: 800; readonly decapsulationKeySize: 1632; readonly ciphertextSize: 768; readonly sharedSecretSize: 32; }

ML_KEM_768

const

ML_KEM_768: { readonly encapsulationKeySize: 1184; readonly decapsulationKeySize: 2400; readonly ciphertextSize: 1088; readonly sharedSecretSize: 32; }

Functions

mlKem1024Decapsulate

function

mlKem1024Decapsulate(decapsulationKey: FixedBuf<3168>, ciphertext: FixedBuf<1568>): FixedBuf<32>

mlKem1024Encapsulate

function

mlKem1024Encapsulate(encapsulationKey: FixedBuf<1568>, m?: FixedBuf<32>): MlKemEncapResult<1568, 32>

mlKem1024EncapsulateDeterministic

function

mlKem1024EncapsulateDeterministic(encapsulationKey: FixedBuf<1568>, m: FixedBuf<32>): MlKemEncapResult<1568, 32>

mlKem1024KeyPair

function

mlKem1024KeyPair(): MlKemKeyPair<1568, 3168>
mlKem1024KeyPair(d: FixedBuf<32>, z: FixedBuf<32>): MlKemKeyPair<1568, 3168>

mlKem1024KeyPairDeterministic

function

mlKem1024KeyPairDeterministic(d: FixedBuf<32>, z: FixedBuf<32>): MlKemKeyPair<1568, 3168>

mlKem512Decapsulate

function

mlKem512Decapsulate(decapsulationKey: FixedBuf<1632>, ciphertext: FixedBuf<768>): FixedBuf<32>

mlKem512Encapsulate

function

mlKem512Encapsulate(encapsulationKey: FixedBuf<800>, m?: FixedBuf<32>): MlKemEncapResult<768, 32>

mlKem512EncapsulateDeterministic

function

mlKem512EncapsulateDeterministic(encapsulationKey: FixedBuf<800>, m: FixedBuf<32>): MlKemEncapResult<768, 32>

mlKem512KeyPair

function

mlKem512KeyPair(): MlKemKeyPair<800, 1632>
mlKem512KeyPair(d: FixedBuf<32>, z: FixedBuf<32>): MlKemKeyPair<800, 1632>

mlKem512KeyPairDeterministic

function

mlKem512KeyPairDeterministic(d: FixedBuf<32>, z: FixedBuf<32>): MlKemKeyPair<800, 1632>

mlKem768Decapsulate

function

mlKem768Decapsulate(decapsulationKey: FixedBuf<2400>, ciphertext: FixedBuf<1088>): FixedBuf<32>

mlKem768Encapsulate

function

mlKem768Encapsulate(encapsulationKey: FixedBuf<1184>, m?: FixedBuf<32>): MlKemEncapResult<1088, 32>

mlKem768EncapsulateDeterministic

function

mlKem768EncapsulateDeterministic(encapsulationKey: FixedBuf<1184>, m: FixedBuf<32>): MlKemEncapResult<1088, 32>

mlKem768KeyPair

function

mlKem768KeyPair(): MlKemKeyPair<1184, 2400>
mlKem768KeyPair(d: FixedBuf<32>, z: FixedBuf<32>): MlKemKeyPair<1184, 2400>

mlKem768KeyPairDeterministic

function

mlKem768KeyPairDeterministic(d: FixedBuf<32>, z: FixedBuf<32>): MlKemKeyPair<1184, 2400>

Interfaces

MlKemEncapResult

interface

ciphertext: FixedBuf<CtSize>
sharedSecret: FixedBuf<SsSize>

MlKemKeyPair

interface

encapsulationKey: FixedBuf<EkSize>
decapsulationKey: FixedBuf<DkSize>