crystals-kyber-js
Version:
An ML-KEM/CRYSTALS-KYBER implementation written in TypeScript for various JavaScript runtimes
105 lines (104 loc) • 3.32 kB
JavaScript
(function (factory) {
if (typeof module === "object" && typeof module.exports === "object") {
var v = factory(require, exports);
if (v !== undefined) module.exports = v;
}
else if (typeof define === "function" && define.amd) {
define(["require", "exports", "./errors.js", "./mlKem1024Base.js"], factory);
}
})(function (require, exports) {
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.MlKem1024Impl = void 0;
exports.createMlKem1024 = createMlKem1024;
const errors_js_1 = require("./errors.js");
const mlKem1024Base_js_1 = require("./mlKem1024Base.js");
/**
* Synchronous implementation of MlKem1024.
*
* Use {@link createMlKem1024} to create an initialized instance.
*
* @example
*
* ```ts
* // Using jsr:
* import { createMlKem1024 } from "@dajiaji/mlkem";
* // Using npm:
* // import { createMlKem1024 } from "mlkem"; // or "crystals-kyber-js"
*
* const recipient = await createMlKem1024();
* const [pkR, skR] = recipient.generateKeyPair();
*
* const sender = await createMlKem1024();
* const [ct, ssS] = sender.encap(pkR);
*
* const ssR = recipient.decap(ct, skR);
* // ssS === ssR
* ```
*/
class MlKem1024Impl extends mlKem1024Base_js_1.MlKem1024Base {
constructor() {
super();
}
/** Generates a keypair [publicKey, privateKey]. */
generateKeyPair() {
try {
return this._generateKeyPairCore();
}
catch (e) {
throw new errors_js_1.MlKemError(e);
}
}
/** Derives a keypair [publicKey, privateKey] deterministically from a 64-octet seed. */
deriveKeyPair(seed) {
try {
return this._deriveKeyPairCore(seed);
}
catch (e) {
throw new errors_js_1.MlKemError(e);
}
}
/** Encapsulates: returns [ciphertext, sharedSecret]. */
encap(pk, seed) {
try {
return this._encapCore(pk, seed);
}
catch (e) {
throw new errors_js_1.MlKemError(e);
}
}
/** Decapsulates: returns sharedSecret. */
decap(ct, sk) {
try {
return this._decapCore(ct, sk);
}
catch (e) {
throw new errors_js_1.MlKemError(e);
}
}
/** @internal */
static async _create() {
const impl = new MlKem1024Impl();
await impl._setup();
return impl;
}
}
exports.MlKem1024Impl = MlKem1024Impl;
/**
* Creates a pre-initialized MlKem1024 instance with synchronous operations.
*
* @returns A promise that resolves to an {@link MlKemInterface} instance.
*
* @example
*
* ```ts
* const ctx = await createMlKem1024();
* const [pk, sk] = ctx.generateKeyPair(); // sync
* const [ct, ssS] = ctx.encap(pk); // sync
* const ssR = ctx.decap(ct, sk); // sync
* ```
*/
function createMlKem1024() {
return MlKem1024Impl._create();
}
});