node-tkms 0.12.8 → 0.13.0-rc.1

package/kms_lib.d.ts

@@ -5,9 +5,33 @@
  * happens on the KMS side. It's just here for completeness and tests.
  */
 export function ml_kem_pke_encrypt(msg: Uint8Array, their_pk: PublicEncKeyMlKem512): Uint8Array;
+/**
+ * Instantiate a new client.
+ *
+ * * `server_addrs` - a list of KMS server ID with EIP-55 addresses,
+ * the elements in the list can be created using [new_server_id_addr].
+ *
+ * * `client_address_hex` - the client (wallet) address in hex,
+ * must be prefixed with "0x".
+ *
+ * * `fhe_parameter` - the parameter choice, which can be either `"test"` or `"default"`.
+ * The "default" parameter choice is selected if no matching string is found.
+ */
+export function new_client(server_addrs: ServerIdAddr[], client_address_hex: string, fhe_parameter: string): Client;
+export function ml_kem_pke_keygen(): PrivateEncKeyMlKem512;
+export function ml_kem_pke_get_pk(sk: PrivateEncKeyMlKem512): PublicEncKeyMlKem512;
+export function u8vec_to_private_sig_key(v: Uint8Array): PrivateSigKey;
+export function public_sig_key_to_u8vec(pk: PublicSigKey): Uint8Array;
+/**
+ * This function is *not* used by relayer-sdk because the decryption
+ * is handled by [process_user_decryption_resp].
+ * It's just here for completeness and tests.
+ */
+export function ml_kem_pke_decrypt(ct: Uint8Array, my_sk: PrivateEncKeyMlKem512): Uint8Array;
 export function u8vec_to_public_sig_key(v: Uint8Array): PublicSigKey;
+export function u8vec_to_ml_kem_pke_pk(v: Uint8Array): PublicEncKeyMlKem512;
 export function ml_kem_pke_pk_len(): number;
-export function u8vec_to_private_sig_key(v: Uint8Array): PrivateSigKey;
+export function get_server_addrs(client: Client): ServerIdAddr[];
 /**
  * Process the user_decryption response from JavaScript objects.
  * The returned result is a byte array representing a plaintext of any length,
@@ -70,7 +94,15 @@ export function u8vec_to_private_sig_key(v: Uint8Array): PrivateSigKey;
  * It is insecure if `verify = false`!
  */
 export function process_user_decryption_resp_from_js(client: Client, request: any, eip712_domain: any, agg_resp: any, enc_pk: PublicEncKeyMlKem512, enc_sk: PrivateEncKeyMlKem512, verify: boolean): TypedPlaintext[];
+/**
+ * Create a new [ServerIdAddr] structure that holds an ID and an address
+ * which must be a valid EIP-55 address, notably prefixed with "0x".
+ */
+export function new_server_id_addr(id: number, addr: string): ServerIdAddr;
+export function ml_kem_pke_sk_len(): number;
 export function private_sig_key_to_u8vec(sk: PrivateSigKey): Uint8Array;
+export function u8vec_to_ml_kem_pke_sk(v: Uint8Array): PrivateEncKeyMlKem512;
+export function get_client_address(client: Client): string;
 /**
  * Process the user_decryption response from Rust objects.
  * Consider using [process_user_decryption_resp_from_js]
@@ -95,41 +127,9 @@ export function private_sig_key_to_u8vec(sk: PrivateSigKey): Uint8Array;
  * It is insecure if `verify = false`!
  */
 export function process_user_decryption_resp(client: Client, request: ParsedUserDecryptionRequest | null | undefined, eip712_domain: Eip712DomainMsg | null | undefined, agg_resp: UserDecryptionResponse[], enc_pk: PublicEncKeyMlKem512, enc_sk: PrivateEncKeyMlKem512, verify: boolean): TypedPlaintext[];
-/**
- * Create a new [ServerIdAddr] structure that holds an ID and an address
- * which must be a valid EIP-55 address, notably prefixed with "0x".
- */
-export function new_server_id_addr(id: number, addr: string): ServerIdAddr;
-export function ml_kem_pke_pk_to_u8vec(pk: PublicEncKeyMlKem512): Uint8Array;
 export function get_client_secret_key(client: Client): PrivateSigKey | undefined;
-export function public_sig_key_to_u8vec(pk: PublicSigKey): Uint8Array;
-export function ml_kem_pke_keygen(): PrivateEncKeyMlKem512;
-export function get_client_address(client: Client): string;
+export function ml_kem_pke_pk_to_u8vec(pk: PublicEncKeyMlKem512): Uint8Array;
 export function ml_kem_pke_sk_to_u8vec(sk: PrivateEncKeyMlKem512): Uint8Array;
-export function get_server_addrs(client: Client): ServerIdAddr[];
-export function u8vec_to_ml_kem_pke_pk(v: Uint8Array): PublicEncKeyMlKem512;
-export function u8vec_to_ml_kem_pke_sk(v: Uint8Array): PrivateEncKeyMlKem512;
-export function ml_kem_pke_sk_len(): number;
-/**
- * This function is *not* used by relayer-sdk because the decryption
- * is handled by [process_user_decryption_resp].
- * It's just here for completeness and tests.
- */
-export function ml_kem_pke_decrypt(ct: Uint8Array, my_sk: PrivateEncKeyMlKem512): Uint8Array;
-/**
- * Instantiate a new client.
- *
- * * `server_addrs` - a list of KMS server ID with EIP-55 addresses,
- * the elements in the list can be created using [new_server_id_addr].
- *
- * * `client_address_hex` - the client (wallet) address in hex,
- * must be prefixed with "0x".
- *
- * * `fhe_parameter` - the parameter choice, which can be either `"test"` or `"default"`.
- * The "default" parameter choice is selected if no matching string is found.
- */
-export function new_client(server_addrs: ServerIdAddr[], client_address_hex: string, fhe_parameter: string): Client;
-export function ml_kem_pke_get_pk(sk: PrivateEncKeyMlKem512): PublicEncKeyMlKem512;
 export class CiphertextHandle {
   private constructor();
   free(): void;

package/kms_lib.js

@@ -205,31 +205,67 @@ module.exports.ml_kem_pke_encrypt = function(msg, their_pk) {
     return v2;
 };
 
+function passArrayJsValueToWasm0(array, malloc) {
+    const ptr = malloc(array.length * 4, 4) >>> 0;
+    for (let i = 0; i < array.length; i++) {
+        const add = addToExternrefTable0(array[i]);
+        getDataViewMemory0().setUint32(ptr + 4 * i, add, true);
+    }
+    WASM_VECTOR_LEN = array.length;
+    return ptr;
+}
+
 function takeFromExternrefTable0(idx) {
     const value = wasm.__wbindgen_export_4.get(idx);
     wasm.__externref_table_dealloc(idx);
     return value;
 }
 /**
- * @param {Uint8Array} v
- * @returns {PublicSigKey}
+ * Instantiate a new client.
+ *
+ * * `server_addrs` - a list of KMS server ID with EIP-55 addresses,
+ * the elements in the list can be created using [new_server_id_addr].
+ *
+ * * `client_address_hex` - the client (wallet) address in hex,
+ * must be prefixed with "0x".
+ *
+ * * `fhe_parameter` - the parameter choice, which can be either `"test"` or `"default"`.
+ * The "default" parameter choice is selected if no matching string is found.
+ * @param {ServerIdAddr[]} server_addrs
+ * @param {string} client_address_hex
+ * @param {string} fhe_parameter
+ * @returns {Client}
  */
-module.exports.u8vec_to_public_sig_key = function(v) {
-    const ptr0 = passArray8ToWasm0(v, wasm.__wbindgen_malloc);
+module.exports.new_client = function(server_addrs, client_address_hex, fhe_parameter) {
+    const ptr0 = passArrayJsValueToWasm0(server_addrs, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.u8vec_to_public_sig_key(ptr0, len0);
+    const ptr1 = passStringToWasm0(client_address_hex, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ptr2 = passStringToWasm0(fhe_parameter, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len2 = WASM_VECTOR_LEN;
+    const ret = wasm.new_client(ptr0, len0, ptr1, len1, ptr2, len2);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }
-    return PublicSigKey.__wrap(ret[0]);
+    return Client.__wrap(ret[0]);
 };
 
 /**
- * @returns {number}
+ * @returns {PrivateEncKeyMlKem512}
  */
-module.exports.ml_kem_pke_pk_len = function() {
-    const ret = wasm.ml_kem_pke_pk_len();
-    return ret >>> 0;
+module.exports.ml_kem_pke_keygen = function() {
+    const ret = wasm.ml_kem_pke_keygen();
+    return PrivateEncKeyMlKem512.__wrap(ret);
+};
+
+/**
+ * @param {PrivateEncKeyMlKem512} sk
+ * @returns {PublicEncKeyMlKem512}
+ */
+module.exports.ml_kem_pke_get_pk = function(sk) {
+    _assertClass(sk, PrivateEncKeyMlKem512);
+    const ret = wasm.ml_kem_pke_get_pk(sk.__wbg_ptr);
+    return PublicEncKeyMlKem512.__wrap(ret);
 };
 
 /**
@@ -246,6 +282,72 @@ module.exports.u8vec_to_private_sig_key = function(v) {
     return PrivateSigKey.__wrap(ret[0]);
 };
 
+/**
+ * @param {PublicSigKey} pk
+ * @returns {Uint8Array}
+ */
+module.exports.public_sig_key_to_u8vec = function(pk) {
+    _assertClass(pk, PublicSigKey);
+    const ret = wasm.public_sig_key_to_u8vec(pk.__wbg_ptr);
+    var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+    return v1;
+};
+
+/**
+ * This function is *not* used by relayer-sdk because the decryption
+ * is handled by [process_user_decryption_resp].
+ * It's just here for completeness and tests.
+ * @param {Uint8Array} ct
+ * @param {PrivateEncKeyMlKem512} my_sk
+ * @returns {Uint8Array}
+ */
+module.exports.ml_kem_pke_decrypt = function(ct, my_sk) {
+    const ptr0 = passArray8ToWasm0(ct, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    _assertClass(my_sk, PrivateEncKeyMlKem512);
+    const ret = wasm.ml_kem_pke_decrypt(ptr0, len0, my_sk.__wbg_ptr);
+    var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+    return v2;
+};
+
+/**
+ * @param {Uint8Array} v
+ * @returns {PublicSigKey}
+ */
+module.exports.u8vec_to_public_sig_key = function(v) {
+    const ptr0 = passArray8ToWasm0(v, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.u8vec_to_public_sig_key(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return PublicSigKey.__wrap(ret[0]);
+};
+
+/**
+ * @param {Uint8Array} v
+ * @returns {PublicEncKeyMlKem512}
+ */
+module.exports.u8vec_to_ml_kem_pke_pk = function(v) {
+    const ptr0 = passArray8ToWasm0(v, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.u8vec_to_ml_kem_pke_pk(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return PublicEncKeyMlKem512.__wrap(ret[0]);
+};
+
+/**
+ * @returns {number}
+ */
+module.exports.ml_kem_pke_pk_len = function() {
+    const ret = wasm.ml_kem_pke_pk_len();
+    return ret >>> 0;
+};
+
 function getArrayJsValueFromWasm0(ptr, len) {
     ptr = ptr >>> 0;
     const mem = getDataViewMemory0();
@@ -256,6 +358,18 @@ function getArrayJsValueFromWasm0(ptr, len) {
     wasm.__externref_drop_slice(ptr, len);
     return result;
 }
+/**
+ * @param {Client} client
+ * @returns {ServerIdAddr[]}
+ */
+module.exports.get_server_addrs = function(client) {
+    _assertClass(client, Client);
+    const ret = wasm.get_server_addrs(client.__wbg_ptr);
+    var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+    return v1;
+};
+
 /**
  * Process the user_decryption response from JavaScript objects.
  * The returned result is a byte array representing a plaintext of any length,
@@ -338,6 +452,31 @@ module.exports.process_user_decryption_resp_from_js = function(client, request,
     return v1;
 };
 
+/**
+ * Create a new [ServerIdAddr] structure that holds an ID and an address
+ * which must be a valid EIP-55 address, notably prefixed with "0x".
+ * @param {number} id
+ * @param {string} addr
+ * @returns {ServerIdAddr}
+ */
+module.exports.new_server_id_addr = function(id, addr) {
+    const ptr0 = passStringToWasm0(addr, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.new_server_id_addr(id, ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return ServerIdAddr.__wrap(ret[0]);
+};
+
+/**
+ * @returns {number}
+ */
+module.exports.ml_kem_pke_sk_len = function() {
+    const ret = wasm.ml_kem_pke_sk_len();
+    return ret >>> 0;
+};
+
 /**
  * @param {PrivateSigKey} sk
  * @returns {Uint8Array}
@@ -353,15 +492,38 @@ module.exports.private_sig_key_to_u8vec = function(sk) {
     return v1;
 };
 
-function passArrayJsValueToWasm0(array, malloc) {
-    const ptr = malloc(array.length * 4, 4) >>> 0;
-    for (let i = 0; i < array.length; i++) {
-        const add = addToExternrefTable0(array[i]);
-        getDataViewMemory0().setUint32(ptr + 4 * i, add, true);
+/**
+ * @param {Uint8Array} v
+ * @returns {PrivateEncKeyMlKem512}
+ */
+module.exports.u8vec_to_ml_kem_pke_sk = function(v) {
+    const ptr0 = passArray8ToWasm0(v, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.u8vec_to_ml_kem_pke_sk(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
     }
-    WASM_VECTOR_LEN = array.length;
-    return ptr;
-}
+    return PrivateEncKeyMlKem512.__wrap(ret[0]);
+};
+
+/**
+ * @param {Client} client
+ * @returns {string}
+ */
+module.exports.get_client_address = function(client) {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        _assertClass(client, Client);
+        const ret = wasm.get_client_address(client.__wbg_ptr);
+        deferred1_0 = ret[0];
+        deferred1_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+    }
+};
+
 /**
  * Process the user_decryption response from Rust objects.
  * Consider using [process_user_decryption_resp_from_js]
@@ -419,20 +581,13 @@ module.exports.process_user_decryption_resp = function(client, request, eip712_d
 };
 
 /**
- * Create a new [ServerIdAddr] structure that holds an ID and an address
- * which must be a valid EIP-55 address, notably prefixed with "0x".
- * @param {number} id
- * @param {string} addr
- * @returns {ServerIdAddr}
+ * @param {Client} client
+ * @returns {PrivateSigKey | undefined}
  */
-module.exports.new_server_id_addr = function(id, addr) {
-    const ptr0 = passStringToWasm0(addr, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
-    const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.new_server_id_addr(id, ptr0, len0);
-    if (ret[2]) {
-        throw takeFromExternrefTable0(ret[1]);
-    }
-    return ServerIdAddr.__wrap(ret[0]);
+module.exports.get_client_secret_key = function(client) {
+    _assertClass(client, Client);
+    const ret = wasm.get_client_secret_key(client.__wbg_ptr);
+    return ret === 0 ? undefined : PrivateSigKey.__wrap(ret);
 };
 
 /**
@@ -450,54 +605,6 @@ module.exports.ml_kem_pke_pk_to_u8vec = function(pk) {
     return v1;
 };
 
-/**
- * @param {Client} client
- * @returns {PrivateSigKey | undefined}
- */
-module.exports.get_client_secret_key = function(client) {
-    _assertClass(client, Client);
-    const ret = wasm.get_client_secret_key(client.__wbg_ptr);
-    return ret === 0 ? undefined : PrivateSigKey.__wrap(ret);
-};
-
-/**
- * @param {PublicSigKey} pk
- * @returns {Uint8Array}
- */
-module.exports.public_sig_key_to_u8vec = function(pk) {
-    _assertClass(pk, PublicSigKey);
-    const ret = wasm.public_sig_key_to_u8vec(pk.__wbg_ptr);
-    var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
-    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-    return v1;
-};
-
-/**
- * @returns {PrivateEncKeyMlKem512}
- */
-module.exports.ml_kem_pke_keygen = function() {
-    const ret = wasm.ml_kem_pke_keygen();
-    return PrivateEncKeyMlKem512.__wrap(ret);
-};
-
-/**
- * @param {Client} client
- * @returns {string}
- */
-module.exports.get_client_address = function(client) {
-    let deferred1_0;
-    let deferred1_1;
-    try {
-        _assertClass(client, Client);
-        const ret = wasm.get_client_address(client.__wbg_ptr);
-        deferred1_0 = ret[0];
-        deferred1_1 = ret[1];
-        return getStringFromWasm0(ret[0], ret[1]);
-    } finally {
-        wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
-    }
-};
-
 /**
  * @param {PrivateEncKeyMlKem512} sk
  * @returns {Uint8Array}
@@ -513,112 +620,6 @@ module.exports.ml_kem_pke_sk_to_u8vec = function(sk) {
     return v1;
 };
 
-/**
- * @param {Client} client
- * @returns {ServerIdAddr[]}
- */
-module.exports.get_server_addrs = function(client) {
-    _assertClass(client, Client);
-    const ret = wasm.get_server_addrs(client.__wbg_ptr);
-    var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]).slice();
-    wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
-    return v1;
-};
-
-/**
- * @param {Uint8Array} v
- * @returns {PublicEncKeyMlKem512}
- */
-module.exports.u8vec_to_ml_kem_pke_pk = function(v) {
-    const ptr0 = passArray8ToWasm0(v, wasm.__wbindgen_malloc);
-    const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.u8vec_to_ml_kem_pke_pk(ptr0, len0);
-    if (ret[2]) {
-        throw takeFromExternrefTable0(ret[1]);
-    }
-    return PublicEncKeyMlKem512.__wrap(ret[0]);
-};
-
-/**
- * @param {Uint8Array} v
- * @returns {PrivateEncKeyMlKem512}
- */
-module.exports.u8vec_to_ml_kem_pke_sk = function(v) {
-    const ptr0 = passArray8ToWasm0(v, wasm.__wbindgen_malloc);
-    const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.u8vec_to_ml_kem_pke_sk(ptr0, len0);
-    if (ret[2]) {
-        throw takeFromExternrefTable0(ret[1]);
-    }
-    return PrivateEncKeyMlKem512.__wrap(ret[0]);
-};
-
-/**
- * @returns {number}
- */
-module.exports.ml_kem_pke_sk_len = function() {
-    const ret = wasm.ml_kem_pke_sk_len();
-    return ret >>> 0;
-};
-
-/**
- * This function is *not* used by relayer-sdk because the decryption
- * is handled by [process_user_decryption_resp].
- * It's just here for completeness and tests.
- * @param {Uint8Array} ct
- * @param {PrivateEncKeyMlKem512} my_sk
- * @returns {Uint8Array}
- */
-module.exports.ml_kem_pke_decrypt = function(ct, my_sk) {
-    const ptr0 = passArray8ToWasm0(ct, wasm.__wbindgen_malloc);
-    const len0 = WASM_VECTOR_LEN;
-    _assertClass(my_sk, PrivateEncKeyMlKem512);
-    const ret = wasm.ml_kem_pke_decrypt(ptr0, len0, my_sk.__wbg_ptr);
-    var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
-    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-    return v2;
-};
-
-/**
- * Instantiate a new client.
- *
- * * `server_addrs` - a list of KMS server ID with EIP-55 addresses,
- * the elements in the list can be created using [new_server_id_addr].
- *
- * * `client_address_hex` - the client (wallet) address in hex,
- * must be prefixed with "0x".
- *
- * * `fhe_parameter` - the parameter choice, which can be either `"test"` or `"default"`.
- * The "default" parameter choice is selected if no matching string is found.
- * @param {ServerIdAddr[]} server_addrs
- * @param {string} client_address_hex
- * @param {string} fhe_parameter
- * @returns {Client}
- */
-module.exports.new_client = function(server_addrs, client_address_hex, fhe_parameter) {
-    const ptr0 = passArrayJsValueToWasm0(server_addrs, wasm.__wbindgen_malloc);
-    const len0 = WASM_VECTOR_LEN;
-    const ptr1 = passStringToWasm0(client_address_hex, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
-    const len1 = WASM_VECTOR_LEN;
-    const ptr2 = passStringToWasm0(fhe_parameter, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
-    const len2 = WASM_VECTOR_LEN;
-    const ret = wasm.new_client(ptr0, len0, ptr1, len1, ptr2, len2);
-    if (ret[2]) {
-        throw takeFromExternrefTable0(ret[1]);
-    }
-    return Client.__wrap(ret[0]);
-};
-
-/**
- * @param {PrivateEncKeyMlKem512} sk
- * @returns {PublicEncKeyMlKem512}
- */
-module.exports.ml_kem_pke_get_pk = function(sk) {
-    _assertClass(sk, PrivateEncKeyMlKem512);
-    const ret = wasm.ml_kem_pke_get_pk(sk.__wbg_ptr);
-    return PublicEncKeyMlKem512.__wrap(ret);
-};
-
 const CiphertextHandleFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_ciphertexthandle_free(ptr >>> 0, 1));

package/package.json

@@ -4,7 +4,7 @@
     "Zama"
   ],
   "description": "Key Management System for the Zama Protocol.",
-  "version": "0.12.8",
+  "version": "v0.13.0-rc.1",
   "license": "BSD-3-Clause-Clear",
   "repository": {
     "type": "git",