Class MlKem768

Represents the MlKem768 class, which extends the MlKemBase class.

This class extends the MlKemBase class and provides specific implementation for MlKem768.

Remarks

MlKem768 is a specific implementation of the ML-KEM key encapsulation mechanism.

Example

// Using jsr:
import { MlKem768 } from "@dajiaji/mlkem";
// Using npm:
// import { MlKem768 } from "mlkem"; // or "crystals-kyber-js"

const recipient = new MlKem768();
const [pkR, skR] = await recipient.generateKeyPair();

const sender = new MlKem768();
const [ct, ssS] = await sender.encap(pkR);

const ssR = await recipient.decap(ct, skR);
// ssS === ssR

Hierarchy

MlKemBase
- MlKem768

Index

Constructors

constructor

new MlKem768(): MlKem768
Returns MlKem768
Overrides MlKemBase.constructor
- Defined in src/mlKem768.ts:43

Properties

`Protected`_compressedUSize

_compressedUSize: number = 0

`Protected`_compressedVSize

_compressedVSize: number = 0

_du

_du: number = 10

_dv

_dv: number = 4

_eta1

_eta1: number = 2

_eta2

_eta2: number = 2

_k

_k: number = 3

`Protected`_pkSize

_pkSize: number = 0

`Protected`_skSize

_skSize: number = 0

Methods

`Protected`_compressU

_compressU(r: Uint8Array, u: number[][]): Uint8Array
Compresses the given array of coefficients into a Uint8Array.
Parameters
- r: Uint8Array
  The output Uint8Array.
- u: number[][]
  The array of coefficients.
Returns Uint8Array
The compressed Uint8Array.
Inherited from MlKemBase._compressU
- Defined in src/mlKemBase.ts:559

`Protected`_compressV

_compressV(r: Uint8Array, v: number[]): Uint8Array
Compresses the given array of numbers into a Uint8Array.
Parameters
- r: Uint8Array
  The Uint8Array to store the compressed values.
- v: number[]
  The array of numbers to compress.
Returns Uint8Array
The compressed Uint8Array.
Inherited from MlKemBase._compressV
- Defined in src/mlKemBase.ts:592

`Protected`_decompressU

_decompressU(a: Uint8Array): number[][]
Decompresses a Uint8Array into a two-dimensional array of numbers.
Parameters
- a: Uint8Array
  The Uint8Array to decompress.
Returns number[][]
The decompressed two-dimensional array.
Inherited from MlKemBase._decompressU
- Defined in src/mlKemBase.ts:617

`Protected`_decompressV

_decompressV(a: Uint8Array): number[]
Decompresses a Uint8Array into an array of numbers.
Parameters
- a: Uint8Array
  The Uint8Array to decompress.
Returns number[]
An array of numbers.
Inherited from MlKemBase._decompressV
- Defined in src/mlKemBase.ts:651

`Protected`_sampleNoise1

_sampleNoise1(sigma: Uint8Array, offset: number, size: number): number[][]
Generates a 2D array of noise samples.
Parameters
- sigma: Uint8Array
  The noise parameter.
- offset: number
  The offset value.
- size: number
  The size of the array.
Returns number[][]
The generated 2D array of noise samples.
Inherited from MlKemBase._sampleNoise1
- Defined in src/mlKemBase.ts:500

`Protected`_sampleNoise2

_sampleNoise2(sigma: Uint8Array, offset: number, size: number): number[][]
Generates a 2-dimensional array of noise samples.
Parameters
- sigma: Uint8Array
  The noise parameter.
- offset: number
  The offset value.
- size: number
  The size of the array.
Returns number[][]
The generated 2-dimensional array of noise samples.
Inherited from MlKemBase._sampleNoise2
- Defined in src/mlKemBase.ts:521

decap

decap(ct: Uint8Array, sk: Uint8Array): Promise<Uint8Array<ArrayBufferLike>>
Generates a ciphertext for the public key and a shared secret.

If an error occurred, throws MlKemError.
Parameters
- ct: Uint8Array
  A ciphertext generated by encap.
- sk: Uint8Array
  A private key.
Returns Promise<Uint8Array<ArrayBufferLike>>
A shared secret.
Throws
MlKemError
Example: The {@link MlKem768} decapsulation.
```
// Using jsr:
import { MlKem768 } from "@dajiaji/mlkem";
// Using npm:
// import { MlKem768 } from "mlkem"; // or "crystals-kyber-js"

const kyber = new MlKem768();
const [pk, sk] = await kyber.generateKeyPair();
const [ct, ssS] = await kyber.encap(pk);
const ssR = await kyber.decap(ct, sk);
// ssS === ssR
```
Inherited from MlKemBase.decap
- Defined in src/mlKemBase.ts:214

deriveKeyPair

deriveKeyPair(
seed: Uint8Array,
): Promise<[Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>]>
Derives a keypair [publicKey, privateKey] deterministically from a 64-octet seed.

If an error occurred, throws MlKemError.
Parameters
- seed: Uint8Array
  A 64-octet seed for the deterministic key generation.
Returns Promise<[Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>]>
A kaypair [publicKey, privateKey].
Throws
MlKemError
Example: Derives a {@link MlKem768} keypair deterministically.
```
// Using jsr:
import { MlKem768 } from "@dajiaji/mlkem";
// Using npm:
// import { MlKem768 } from "mlkem"; // or "crystals-kyber-js"

const kyber = new MlKem768();
const seed = new Uint8Array(64);
globalThis.crypto.getRandomValues(seed);
const [pk, sk] = await kyber.deriveKeyPair(seed);
```
Inherited from MlKemBase.deriveKeyPair
- Defined in src/mlKemBase.ts:131

encap

encap(
pk: Uint8Array,
seed?: Uint8Array,
): Promise<[Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>]>
Generates a shared secret from the encapsulated ciphertext and the private key.

If an error occurred, throws MlKemError.
Parameters
- pk: Uint8Array
  A public key.
- Optionalseed: Uint8Array
  An optional 32-octet seed for the deterministic shared secret generation.
Returns Promise<[Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>]>
A ciphertext (encapsulated public key) and a shared secret.
Throws
MlKemError
Example: The {@link MlKem768} encapsulation.
```
// Using jsr:
import { MlKem768 } from "@dajiaji/mlkem";
// Using npm:
// import { MlKem768 } from "mlkem"; // or "crystals-kyber-js"

const kyber = new MlKem768();
const [pk, sk] = await kyber.generateKeyPair();
const [ct, ss] = await kyber.encap(pk);
```
Inherited from MlKemBase.encap
- Defined in src/mlKemBase.ts:169

generateKeyPair

generateKeyPair(): Promise<
[Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>],
>
Generates a keypair [publicKey, privateKey].

If an error occurred, throws MlKemError.

Returns Promise<[Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>]>
A kaypair [publicKey, privateKey].
Throws
MlKemError
Example: Generates a {@link MlKem768} keypair.
```
// Using jsr:
import { MlKem768 } from "@dajiaji/mlkem";
// Using npm:
// import { MlKem768 } from "mlkem"; // or "crystals-kyber-js"

const kyber = new MlKem768();
const [pk, sk] = await kyber.generateKeyPair();
```
Inherited from MlKemBase.generateKeyPair
- Defined in src/mlKemBase.ts:96

Class MlKem768

Remarks

Example

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Returns MlKem768

Properties

Protected_compressedUSize

Protected_compressedVSize

_du

_dv

_eta1

_eta2

_k

Protected_pkSize

Protected_skSize

Methods

Protected_compressU

Parameters

Returns Uint8Array

Protected_compressV

Parameters

Returns Uint8Array

Protected_decompressU

Parameters

Returns number[][]

Protected_decompressV

Parameters

Returns number[]

Protected_sampleNoise1

Parameters

Returns number[][]

Protected_sampleNoise2

Parameters

Returns number[][]

decap

Parameters

Returns Promise<Uint8Array<ArrayBufferLike>>

Throws

Example: The {@link MlKem768} decapsulation.

deriveKeyPair

Parameters

Returns Promise<[Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>]>

Throws

Example: Derives a {@link MlKem768} keypair deterministically.

encap

Parameters

Returns Promise<[Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>]>

Throws

Example: The {@link MlKem768} encapsulation.

generateKeyPair

Returns Promise<[Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>]>

Throws

Example: Generates a {@link MlKem768} keypair.

Settings

On This Page

`Protected`_compressedUSize

`Protected`_compressedVSize

`Protected`_pkSize

`Protected`_skSize

`Protected`_compressU

`Protected`_compressV

`Protected`_decompressU

`Protected`_decompressV

`Protected`_sampleNoise1

`Protected`_sampleNoise2