@f0rest8/metamorphic-crypto 0.6.0 → 0.7.0

package/metamorphic_crypto.d.ts

@@ -77,6 +77,11 @@ export function generateHybridKeyPair1024(): any;
  */
 export function generateHybridKeyPair512(): any;
 
+/**
+ * Generate a keypair for `(suite, level)`. Returns JSON: `{ publicKey, secretKey }`.
+ */
+export function generateHybridKeyPairSuite(suite: string, level: string): any;
+
 /**
  * Generate a random 32-byte symmetric key (base64).
  */
@@ -105,6 +110,35 @@ export function generateSalt(): string;
  */
 export function generateSigningKeyPair(level: string): any;
 
+/**
+ * Generate a signing keypair for a full CNSA-2.0 `(suite, level)`.
+ *
+ * `suite` is `"hybrid"` (default), `"hybridMatched"` (Cat-3→Ed448,
+ * Cat-5→ECDSA-P-521), or `"pureCnsa2"` (ML-DSA-87 only, Cat-5). `level` is
+ * `"cat2"`/`"cat3"`/`"cat5"`. `sign` / `verify` / `deriveSigningPublicKey`
+ * auto-detect the suite from the key/signature version tag, so no suite
+ * argument is needed there. Returns JSON: `{ publicKey, secretKey }`.
+ */
+export function generateSigningKeyPairSuite(suite: string, level: string): any;
+
+/**
+ * Open a CNSA-2.0 (or legacy) hybrid ciphertext, supplying the context label
+ * used at seal time for the new suites. Returns base64-encoded plaintext.
+ */
+export function hybridOpenWithContext(ciphertext_b64: string, seed_b64: string, context_label: string): string;
+
+/**
+ * Seal plaintext (base64) to a `(suite, level)` combined public key, binding
+ * the default `"metamorphic/seal/v1"` context label. Returns base64 ciphertext.
+ */
+export function hybridSealSuite(plaintext_b64: string, combined_pk_b64: string, suite: string, level: string): string;
+
+/**
+ * Seal plaintext (base64) to a `(suite, level)` combined public key, binding a
+ * custom `context_label`. Returns base64 ciphertext.
+ */
+export function hybridSealSuiteWithContext(plaintext_b64: string, combined_pk_b64: string, suite: string, level: string, context_label: string): string;
+
 /**
  * Check if a base64 ciphertext is hybrid (v2/v3) format.
  */
@@ -134,6 +168,12 @@ export function sealForUser(plaintext_b64: string, public_key_b64: string, pq_pu
  */
 export function sealForUserWithLevel(plaintext_b64: string, public_key_b64: string, pq_public_key_b64: string | null | undefined, level: string): string;
 
+/**
+ * Seal plaintext (base64) to a user's key(s) under a full `(suite, level)`.
+ * Falls back to legacy X25519 if `pq_public_key_b64` is absent/empty.
+ */
+export function sealForUserWithSuite(plaintext_b64: string, public_key_b64: string, pq_public_key_b64: string | null | undefined, suite: string, level: string): string;
+
 /**
  * SHA-256 (SHA-2) digest of base64-encoded `data`. Returns the 32-byte digest as base64.
  */
@@ -202,6 +242,11 @@ export interface InitOutput {
     readonly generateHybridKeyPair: () => number;
     readonly generateHybridKeyPair1024: () => number;
     readonly isHybridCiphertext: (a: number, b: number) => number;
+    readonly generateHybridKeyPairSuite: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly hybridSealSuite: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
+    readonly hybridSealSuiteWithContext: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => void;
+    readonly hybridOpenWithContext: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+    readonly sealForUserWithSuite: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => void;
     readonly generateKey: (a: number) => void;
     readonly generateKeyPair: () => number;
     readonly generateSalt: (a: number) => void;
@@ -216,6 +261,7 @@ export interface InitOutput {
     readonly sha256: (a: number, b: number, c: number) => void;
     readonly sha512: (a: number, b: number, c: number) => void;
     readonly generateSigningKeyPair: (a: number, b: number, c: number) => void;
+    readonly generateSigningKeyPairSuite: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly deriveSigningPublicKey: (a: number, b: number, c: number) => void;
     readonly sign: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
     readonly verify: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;

package/metamorphic_crypto.js

@@ -448,6 +448,32 @@ export function generateHybridKeyPair512() {
     return takeObject(ret);
 }
 
+/**
+ * Generate a keypair for `(suite, level)`. Returns JSON: `{ publicKey, secretKey }`.
+ * @param {string} suite
+ * @param {string} level
+ * @returns {any}
+ */
+export function generateHybridKeyPairSuite(suite, level) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(suite, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(level, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.generateHybridKeyPairSuite(retptr, ptr0, len0, ptr1, len1);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        if (r2) {
+            throw takeObject(r1);
+        }
+        return takeObject(r0);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+}
+
 /**
  * Generate a random 32-byte symmetric key (base64).
  * @returns {string}
@@ -545,6 +571,164 @@ export function generateSigningKeyPair(level) {
     }
 }
 
+/**
+ * Generate a signing keypair for a full CNSA-2.0 `(suite, level)`.
+ *
+ * `suite` is `"hybrid"` (default), `"hybridMatched"` (Cat-3→Ed448,
+ * Cat-5→ECDSA-P-521), or `"pureCnsa2"` (ML-DSA-87 only, Cat-5). `level` is
+ * `"cat2"`/`"cat3"`/`"cat5"`. `sign` / `verify` / `deriveSigningPublicKey`
+ * auto-detect the suite from the key/signature version tag, so no suite
+ * argument is needed there. Returns JSON: `{ publicKey, secretKey }`.
+ * @param {string} suite
+ * @param {string} level
+ * @returns {any}
+ */
+export function generateSigningKeyPairSuite(suite, level) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(suite, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(level, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.generateSigningKeyPairSuite(retptr, ptr0, len0, ptr1, len1);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        if (r2) {
+            throw takeObject(r1);
+        }
+        return takeObject(r0);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+}
+
+/**
+ * Open a CNSA-2.0 (or legacy) hybrid ciphertext, supplying the context label
+ * used at seal time for the new suites. Returns base64-encoded plaintext.
+ * @param {string} ciphertext_b64
+ * @param {string} seed_b64
+ * @param {string} context_label
+ * @returns {string}
+ */
+export function hybridOpenWithContext(ciphertext_b64, seed_b64, context_label) {
+    let deferred5_0;
+    let deferred5_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(ciphertext_b64, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(seed_b64, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passStringToWasm0(context_label, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len2 = WASM_VECTOR_LEN;
+        wasm.hybridOpenWithContext(retptr, ptr0, len0, ptr1, len1, ptr2, len2);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+        var ptr4 = r0;
+        var len4 = r1;
+        if (r3) {
+            ptr4 = 0; len4 = 0;
+            throw takeObject(r2);
+        }
+        deferred5_0 = ptr4;
+        deferred5_1 = len4;
+        return getStringFromWasm0(ptr4, len4);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export4(deferred5_0, deferred5_1, 1);
+    }
+}
+
+/**
+ * Seal plaintext (base64) to a `(suite, level)` combined public key, binding
+ * the default `"metamorphic/seal/v1"` context label. Returns base64 ciphertext.
+ * @param {string} plaintext_b64
+ * @param {string} combined_pk_b64
+ * @param {string} suite
+ * @param {string} level
+ * @returns {string}
+ */
+export function hybridSealSuite(plaintext_b64, combined_pk_b64, suite, level) {
+    let deferred6_0;
+    let deferred6_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(plaintext_b64, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(combined_pk_b64, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passStringToWasm0(suite, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len2 = WASM_VECTOR_LEN;
+        const ptr3 = passStringToWasm0(level, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len3 = WASM_VECTOR_LEN;
+        wasm.hybridSealSuite(retptr, ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+        var ptr5 = r0;
+        var len5 = r1;
+        if (r3) {
+            ptr5 = 0; len5 = 0;
+            throw takeObject(r2);
+        }
+        deferred6_0 = ptr5;
+        deferred6_1 = len5;
+        return getStringFromWasm0(ptr5, len5);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export4(deferred6_0, deferred6_1, 1);
+    }
+}
+
+/**
+ * Seal plaintext (base64) to a `(suite, level)` combined public key, binding a
+ * custom `context_label`. Returns base64 ciphertext.
+ * @param {string} plaintext_b64
+ * @param {string} combined_pk_b64
+ * @param {string} suite
+ * @param {string} level
+ * @param {string} context_label
+ * @returns {string}
+ */
+export function hybridSealSuiteWithContext(plaintext_b64, combined_pk_b64, suite, level, context_label) {
+    let deferred7_0;
+    let deferred7_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(plaintext_b64, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(combined_pk_b64, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passStringToWasm0(suite, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len2 = WASM_VECTOR_LEN;
+        const ptr3 = passStringToWasm0(level, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len3 = WASM_VECTOR_LEN;
+        const ptr4 = passStringToWasm0(context_label, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len4 = WASM_VECTOR_LEN;
+        wasm.hybridSealSuiteWithContext(retptr, ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+        var ptr6 = r0;
+        var len6 = r1;
+        if (r3) {
+            ptr6 = 0; len6 = 0;
+            throw takeObject(r2);
+        }
+        deferred7_0 = ptr6;
+        deferred7_1 = len6;
+        return getStringFromWasm0(ptr6, len6);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export4(deferred7_0, deferred7_1, 1);
+    }
+}
+
 /**
  * Check if a base64 ciphertext is hybrid (v2/v3) format.
  * @param {string} ciphertext_b64
@@ -704,6 +888,51 @@ export function sealForUserWithLevel(plaintext_b64, public_key_b64, pq_public_ke
     }
 }
 
+/**
+ * Seal plaintext (base64) to a user's key(s) under a full `(suite, level)`.
+ * Falls back to legacy X25519 if `pq_public_key_b64` is absent/empty.
+ * @param {string} plaintext_b64
+ * @param {string} public_key_b64
+ * @param {string | null | undefined} pq_public_key_b64
+ * @param {string} suite
+ * @param {string} level
+ * @returns {string}
+ */
+export function sealForUserWithSuite(plaintext_b64, public_key_b64, pq_public_key_b64, suite, level) {
+    let deferred7_0;
+    let deferred7_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(plaintext_b64, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(public_key_b64, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        var ptr2 = isLikeNone(pq_public_key_b64) ? 0 : passStringToWasm0(pq_public_key_b64, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        var len2 = WASM_VECTOR_LEN;
+        const ptr3 = passStringToWasm0(suite, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len3 = WASM_VECTOR_LEN;
+        const ptr4 = passStringToWasm0(level, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len4 = WASM_VECTOR_LEN;
+        wasm.sealForUserWithSuite(retptr, ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+        var ptr6 = r0;
+        var len6 = r1;
+        if (r3) {
+            ptr6 = 0; len6 = 0;
+            throw takeObject(r2);
+        }
+        deferred7_0 = ptr6;
+        deferred7_1 = len6;
+        return getStringFromWasm0(ptr6, len6);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export4(deferred7_0, deferred7_1, 1);
+    }
+}
+
 /**
  * SHA-256 (SHA-2) digest of base64-encoded `data`. Returns the 32-byte digest as base64.
  * @param {string} data_b64

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@f0rest8/metamorphic-crypto",
   "type": "module",
-  "description": "Zero-knowledge end-to-end encryption with post-quantum hybrid KEM (ML-KEM-512/768/1024 + X25519)",
-  "version": "0.6.0",
+  "description": "Zero-knowledge end-to-end encryption with post-quantum hybrid KEM (ML-KEM + X25519) and an opt-in CNSA 2.0 suite axis (matched-strength hybrid + pure ML-KEM-1024 / ML-DSA-87 / AES-256-GCM)",
+  "version": "0.7.0",
   "license": "MIT OR Apache-2.0",
   "repository": {
     "type": "git",