@provablehq/wasm 0.11.3 → 0.11.5

package/dist/testnet/aleo_wasm.d.ts

@@ -21,18 +21,6 @@ export function setWasmLogLevel(level: number): void;
  * @returns {boolean} True if the proof is valid, false otherwise
  */
 export function snarkVerify(verifying_key: VerifyingKey, inputs: Array<any>, proof: Proof): boolean;
-/**
- * Verify a batch SNARK proof against multiple verifying keys and their corresponding public inputs.
- *
- * This function verifies a batch proof produced by Aleo programs that may not be deployed on chain.
- * Each verifying key is paired with one or more sets of public inputs (instances).
- *
- * @param {Array<string>} verifying_keys Array of verifying key strings, one per circuit
- * @param {Array<Array<Array<string>>>} inputs 3D array of field element strings [circuit_idx][instance_idx][field_idx]
- * @param {Proof} proof The batch proof to verify
- * @returns {boolean} True if the batch proof is valid, false otherwise
- */
-export function snarkVerifyBatch(verifying_keys: Array<any>, inputs: Array<any>, proof: Proof): boolean;
 /**
  * Verify an execution. Executions with multiple transitions must have the program source code and
  * verifying keys of imported functions supplied from outside to correctly verify. Also, this does
@@ -47,6 +35,19 @@ export function snarkVerifyBatch(verifying_keys: Array<any>, inputs: Array<any>,
  * @returns {boolean} True if the execution is valid, false otherwise
  */
 export function verifyFunctionExecution(execution: Execution, verifying_key: VerifyingKey, program: Program, function_id: string, imports: object | null | undefined, imported_verifying_keys: object | null | undefined, block_height: number, program_imports?: ProgramImports | null): boolean;
+/**
+ * Verify a batch SNARK proof against multiple verifying keys and their corresponding public inputs.
+ *
+ * This function verifies a batch proof produced by Aleo programs that may not be deployed on chain.
+ * Each verifying key is paired with one or more sets of public inputs (instances).
+ *
+ * @param {Array<string>} verifying_keys Array of verifying key strings, one per circuit
+ * @param {Array<Array<Array<string>>>} inputs 3D array of field element strings [circuit_idx][instance_idx][field_idx]
+ * @param {Proof} proof The batch proof to verify
+ * @returns {boolean} True if the batch proof is valid, false otherwise
+ */
+export function snarkVerifyBatch(verifying_keys: Array<any>, inputs: Array<any>, proof: Proof): boolean;
+export function stringToField(string: string): Field;
 /**
  * Set test consensus version heights for testing.
  *
@@ -56,10 +57,21 @@ export function verifyFunctionExecution(execution: Execution, verifying_key: Ver
  * import { getOrInitConsensusVersionTestHeights } from '@provablehq/sdk';
  *
  * Set the consensus version heights.
- * getOrInitConsensusVersionTestHeights("0,1,2,3,4,5,6,7,8,9,10,11,12,13,14");
+ * getOrInitConsensusVersionTestHeights("0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17");
  */
 export function getOrInitConsensusVersionTestHeights(heights?: string | null): Array<any>;
-export function stringToField(string: string): Field;
+/**
+ * Returns the maximum number of imports allowed in a program by the
+ * snarkVM network implementation this SDK was built against.
+ *
+ * @returns {number} The maximum number of program imports.
+ *
+ * @example
+ * import { getMaxProgramImports } from '@provablehq/sdk';
+ *
+ * const maxImports = getMaxProgramImports();
+ */
+export function getMaxProgramImports(): number;
 /**
  * Public address of an Aleo account
  */
@@ -2894,6 +2906,20 @@ export class Program {
    * console.log(credits_functions === expected_functions); // Output should be "true"
    */
   getFunctions(): Array<any>;
+  /**
+   * Get the program's name (without the `.aleo` suffix) encoded as a field element.
+   *
+   * This is the same value as casting the program name identifier to a field on-chain
+   * (e.g. `my_program.aleo` -> `Identifier("my_program") as field`), which is used as
+   * the program id in dynamic dispatch calls such as `IARC20@(token_id)`.
+   *
+   * @example
+   * const program = aleo_wasm.Program.getCreditsProgram();
+   * const field = program.nameToField(); // Field encoding of "credits"
+   *
+   * @returns {Field} The program name as a field element
+   */
+  nameToField(): Field;
   /**
    * Get the external call graph reachable from a specific entry function.
    *
@@ -3042,6 +3068,39 @@ export class Program {
    * @returns {Address} The address of the program
    */
   address(): Address;
+  /**
+   * Determine if the program implements the ARC-20 fungible token interface (IARC20).
+   *
+   * This checks that the program defines a `Token` record with an `amount: u128` entry
+   * (additional entries are permitted, per the interface's open record definition) and
+   * that every function and view function required by ARC-20 is present with the exact
+   * input and output signature defined by the standard.
+   *
+   * @see https://github.com/ProvableHQ/ARCs/blob/master/arc-0020/README.md
+   *
+   * @returns {boolean} True if the program implements the ARC-20 token interface
+   */
+  isArc20(): boolean;
+  /**
+   * Determine if the program implements the ARC-22 compliant token interface (IARC22).
+   *
+   * This checks that the program defines `Token` and `ComplianceRecord` records with the
+   * entries required by the standard (additional entries are permitted, per the
+   * interface's open record definitions), and that every function and view function
+   * required by ARC-22 is present with the exact input and output signature defined by
+   * the standard. The `MerkleProof` struct used by the private transfer functions may be
+   * declared locally (in which case its shape must match the standard exactly) or
+   * imported from another program such as a freeze list registry.
+   *
+   * Note: this checks the token interface (IARC22) only. The freeze list registry
+   * interface (IARC22Freezelist) is typically implemented by a separate program and is
+   * not required for a token program to be considered ARC-22 compliant.
+   *
+   * @see https://github.com/ProvableHQ/ARCs/blob/master/arc-0022/README.md
+   *
+   * @returns {boolean} True if the program implements the ARC-22 token interface
+   */
+  isArc22(): boolean;
   /**
    * Determine equality with another program
    *

package/dist/testnet/index.cjs

@@ -353,38 +353,6 @@ function snarkVerify(verifying_key, inputs, proof) {
     }
 }
 
-/**
- * Verify a batch SNARK proof against multiple verifying keys and their corresponding public inputs.
- *
- * This function verifies a batch proof produced by Aleo programs that may not be deployed on chain.
- * Each verifying key is paired with one or more sets of public inputs (instances).
- *
- * @param {Array<string>} verifying_keys Array of verifying key strings, one per circuit
- * @param {Array<Array<Array<string>>>} inputs 3D array of field element strings [circuit_idx][instance_idx][field_idx]
- * @param {Proof} proof The batch proof to verify
- * @returns {boolean} True if the batch proof is valid, false otherwise
- * @param {Array<any>} verifying_keys
- * @param {Array<any>} inputs
- * @param {Proof} proof
- * @returns {boolean}
- */
-function snarkVerifyBatch(verifying_keys, inputs, proof) {
-    try {
-        const retptr = wasm$1.__wbindgen_add_to_stack_pointer(-16);
-        _assertClass(proof, Proof);
-        wasm$1.snarkVerifyBatch(retptr, addHeapObject(verifying_keys), addHeapObject(inputs), proof.__wbg_ptr);
-        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 r0 !== 0;
-    } finally {
-        wasm$1.__wbindgen_add_to_stack_pointer(16);
-    }
-}
-
 /**
  * Verify an execution. Executions with multiple transitions must have the program source code and
  * verifying keys of imported functions supplied from outside to correctly verify. Also, this does
@@ -434,23 +402,35 @@ function verifyFunctionExecution(execution, verifying_key, program, function_id,
 }
 
 /**
- * Set test consensus version heights for testing.
- *
- * @param {string | undefined} heights The block heights at which each consensus version applies. This input should be a simple csv list of block heights and there should be one number for each consensus version. If left undefined, the default test heights will be applied.
+ * Verify a batch SNARK proof against multiple verifying keys and their corresponding public inputs.
  *
- * @example
- * import { getOrInitConsensusVersionTestHeights } from '@provablehq/sdk';
+ * This function verifies a batch proof produced by Aleo programs that may not be deployed on chain.
+ * Each verifying key is paired with one or more sets of public inputs (instances).
  *
- * Set the consensus version heights.
- * getOrInitConsensusVersionTestHeights("0,1,2,3,4,5,6,7,8,9,10,11,12,13,14");
- * @param {string | null} [heights]
- * @returns {Array<any>}
+ * @param {Array<string>} verifying_keys Array of verifying key strings, one per circuit
+ * @param {Array<Array<Array<string>>>} inputs 3D array of field element strings [circuit_idx][instance_idx][field_idx]
+ * @param {Proof} proof The batch proof to verify
+ * @returns {boolean} True if the batch proof is valid, false otherwise
+ * @param {Array<any>} verifying_keys
+ * @param {Array<any>} inputs
+ * @param {Proof} proof
+ * @returns {boolean}
  */
-function getOrInitConsensusVersionTestHeights(heights) {
-    var ptr0 = isLikeNone(heights) ? 0 : passStringToWasm0(heights, wasm$1.__wbindgen_export, wasm$1.__wbindgen_export2);
-    var len0 = WASM_VECTOR_LEN;
-    const ret = wasm$1.getOrInitConsensusVersionTestHeights(ptr0, len0);
-    return takeObject(ret);
+function snarkVerifyBatch(verifying_keys, inputs, proof) {
+    try {
+        const retptr = wasm$1.__wbindgen_add_to_stack_pointer(-16);
+        _assertClass(proof, Proof);
+        wasm$1.snarkVerifyBatch(retptr, addHeapObject(verifying_keys), addHeapObject(inputs), proof.__wbg_ptr);
+        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 r0 !== 0;
+    } finally {
+        wasm$1.__wbindgen_add_to_stack_pointer(16);
+    }
 }
 
 /**
@@ -475,6 +455,43 @@ function stringToField(string) {
     }
 }
 
+/**
+ * Set test consensus version heights for testing.
+ *
+ * @param {string | undefined} heights The block heights at which each consensus version applies. This input should be a simple csv list of block heights and there should be one number for each consensus version. If left undefined, the default test heights will be applied.
+ *
+ * @example
+ * import { getOrInitConsensusVersionTestHeights } from '@provablehq/sdk';
+ *
+ * Set the consensus version heights.
+ * getOrInitConsensusVersionTestHeights("0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17");
+ * @param {string | null} [heights]
+ * @returns {Array<any>}
+ */
+function getOrInitConsensusVersionTestHeights(heights) {
+    var ptr0 = isLikeNone(heights) ? 0 : passStringToWasm0(heights, wasm$1.__wbindgen_export, wasm$1.__wbindgen_export2);
+    var len0 = WASM_VECTOR_LEN;
+    const ret = wasm$1.getOrInitConsensusVersionTestHeights(ptr0, len0);
+    return takeObject(ret);
+}
+
+/**
+ * Returns the maximum number of imports allowed in a program by the
+ * snarkVM network implementation this SDK was built against.
+ *
+ * @returns {number} The maximum number of program imports.
+ *
+ * @example
+ * import { getMaxProgramImports } from '@provablehq/sdk';
+ *
+ * const maxImports = getMaxProgramImports();
+ * @returns {number}
+ */
+function getMaxProgramImports() {
+    const ret = wasm$1.getMaxProgramImports();
+    return ret >>> 0;
+}
+
 function passArrayJsValueToWasm0(array, malloc) {
     const ptr = malloc(array.length * 4, 4) >>> 0;
     const mem = getDataViewMemory0();
@@ -494,16 +511,16 @@ function getArrayJsValueFromWasm0(ptr, len) {
     }
     return result;
 }
-function __wasm_bindgen_func_elem_7384(arg0, arg1) {
-    wasm$1.__wasm_bindgen_func_elem_7384(arg0, arg1);
+function __wasm_bindgen_func_elem_8910(arg0, arg1, arg2) {
+    wasm$1.__wasm_bindgen_func_elem_8910(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_8758(arg0, arg1, arg2) {
-    wasm$1.__wasm_bindgen_func_elem_8758(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_7472(arg0, arg1) {
+    wasm$1.__wasm_bindgen_func_elem_7472(arg0, arg1);
 }
 
-function __wasm_bindgen_func_elem_7657(arg0, arg1, arg2, arg3) {
-    wasm$1.__wasm_bindgen_func_elem_7657(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_7744(arg0, arg1, arg2, arg3) {
+    wasm$1.__wasm_bindgen_func_elem_7744(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
 }
 
 const __wbindgen_enum_RequestCredentials = ["omit", "same-origin", "include"];
@@ -10020,6 +10037,35 @@ class Program {
         const ret = wasm$1.program_getFunctions(this.__wbg_ptr);
         return takeObject(ret);
     }
+    /**
+     * Get the program's name (without the `.aleo` suffix) encoded as a field element.
+     *
+     * This is the same value as casting the program name identifier to a field on-chain
+     * (e.g. `my_program.aleo` -> `Identifier("my_program") as field`), which is used as
+     * the program id in dynamic dispatch calls such as `IARC20@(token_id)`.
+     *
+     * @example
+     * const program = aleo_wasm.Program.getCreditsProgram();
+     * const field = program.nameToField(); // Field encoding of "credits"
+     *
+     * @returns {Field} The program name as a field element
+     * @returns {Field}
+     */
+    nameToField() {
+        try {
+            const retptr = wasm$1.__wbindgen_add_to_stack_pointer(-16);
+            wasm$1.program_nameToField(retptr, this.__wbg_ptr);
+            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 Field.__wrap(r0);
+        } finally {
+            wasm$1.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Get the external call graph reachable from a specific entry function.
      *
@@ -10275,6 +10321,47 @@ class Program {
             wasm$1.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Determine if the program implements the ARC-20 fungible token interface (IARC20).
+     *
+     * This checks that the program defines a `Token` record with an `amount: u128` entry
+     * (additional entries are permitted, per the interface's open record definition) and
+     * that every function and view function required by ARC-20 is present with the exact
+     * input and output signature defined by the standard.
+     *
+     * @see https://github.com/ProvableHQ/ARCs/blob/master/arc-0020/README.md
+     *
+     * @returns {boolean} True if the program implements the ARC-20 token interface
+     * @returns {boolean}
+     */
+    isArc20() {
+        const ret = wasm$1.program_isArc20(this.__wbg_ptr);
+        return ret !== 0;
+    }
+    /**
+     * Determine if the program implements the ARC-22 compliant token interface (IARC22).
+     *
+     * This checks that the program defines `Token` and `ComplianceRecord` records with the
+     * entries required by the standard (additional entries are permitted, per the
+     * interface's open record definitions), and that every function and view function
+     * required by ARC-22 is present with the exact input and output signature defined by
+     * the standard. The `MerkleProof` struct used by the private transfer functions may be
+     * declared locally (in which case its shape must match the standard exactly) or
+     * imported from another program such as a freeze list registry.
+     *
+     * Note: this checks the token interface (IARC22) only. The freeze list registry
+     * interface (IARC22Freezelist) is typically implemented by a separate program and is
+     * not required for a token program to be considered ARC-22 compliant.
+     *
+     * @see https://github.com/ProvableHQ/ARCs/blob/master/arc-0022/README.md
+     *
+     * @returns {boolean} True if the program implements the ARC-22 token interface
+     * @returns {boolean}
+     */
+    isArc22() {
+        const ret = wasm$1.program_isArc22(this.__wbg_ptr);
+        return ret !== 0;
+    }
     /**
      * Determine equality with another program
      *
@@ -19238,7 +19325,7 @@ function __wbg_get_imports(memory) {
         const ret = getObject(arg0).length;
         return ret;
     };
-    imports.wbg.__wbg_log_0eaae399732a802e = function(arg0, arg1) {
+    imports.wbg.__wbg_log_a530da429f854235 = function(arg0, arg1) {
         console.log(getStringFromWasm0(arg0, arg1));
     };
     imports.wbg.__wbg_new_1acc0b6eea89d040 = function() {
@@ -19256,7 +19343,7 @@ function __wbg_get_imports(memory) {
                 const a = state0.a;
                 state0.a = 0;
                 try {
-                    return __wasm_bindgen_func_elem_7657(a, state0.b, arg0, arg1);
+                    return __wasm_bindgen_func_elem_7744(a, state0.b, arg0, arg1);
                 } finally {
                     state0.a = a;
                 }
@@ -19428,7 +19515,7 @@ function __wbg_get_imports(memory) {
         const ret = Signature.__wrap(arg0);
         return addHeapObject(ret);
     };
-    imports.wbg.__wbg_spawnWorker_3f95ae6c0630b765 = function(arg0, arg1, arg2, arg3) {
+    imports.wbg.__wbg_spawnWorker_ad641c7b32ebd520 = function(arg0, arg1, arg2, arg3) {
         const ret = spawnWorker(getObject(arg0), getObject(arg1), getObject(arg2), arg3 >>> 0);
         return addHeapObject(ret);
     };
@@ -19510,21 +19597,11 @@ function __wbg_get_imports(memory) {
         const ret = Atomics.waitAsync(getObject(arg0), arg1 >>> 0, arg2);
         return addHeapObject(ret);
     };
-    imports.wbg.__wbindgen_cast_073ddd2b87fab8ab = function(arg0, arg1) {
-        // Cast intrinsic for `Closure(Closure { dtor_idx: 360, function: Function { arguments: [], shim_idx: 467, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-        const ret = makeMutClosure(arg0, arg1, wasm$1.__wasm_bindgen_func_elem_7383, __wasm_bindgen_func_elem_7384);
-        return addHeapObject(ret);
-    };
     imports.wbg.__wbindgen_cast_2241b6af4c4b2941 = function(arg0, arg1) {
         // Cast intrinsic for `Ref(String) -> Externref`.
         const ret = getStringFromWasm0(arg0, arg1);
         return addHeapObject(ret);
     };
-    imports.wbg.__wbindgen_cast_263b62405be3c669 = function(arg0, arg1) {
-        // Cast intrinsic for `Closure(Closure { dtor_idx: 360, function: Function { arguments: [NamedExternref("MessageEvent")], shim_idx: 361, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-        const ret = makeMutClosure(arg0, arg1, wasm$1.__wasm_bindgen_func_elem_7383, __wasm_bindgen_func_elem_8758);
-        return addHeapObject(ret);
-    };
     imports.wbg.__wbindgen_cast_2ddd8a25ff58642a = function(arg0, arg1) {
         // Cast intrinsic for `I128 -> Externref`.
         const ret = (BigInt.asUintN(64, arg0) | (arg1 << BigInt(64)));
@@ -19535,9 +19612,9 @@ function __wbg_get_imports(memory) {
         const ret = BigInt.asUintN(64, arg0);
         return addHeapObject(ret);
     };
-    imports.wbg.__wbindgen_cast_5cd376b701f56c0e = function(arg0, arg1) {
-        // Cast intrinsic for `Closure(Closure { dtor_idx: 360, function: Function { arguments: [Externref], shim_idx: 361, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-        const ret = makeMutClosure(arg0, arg1, wasm$1.__wasm_bindgen_func_elem_7383, __wasm_bindgen_func_elem_8758);
+    imports.wbg.__wbindgen_cast_69588da295a6a0d2 = function(arg0, arg1) {
+        // Cast intrinsic for `Closure(Closure { dtor_idx: 390, function: Function { arguments: [], shim_idx: 495, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+        const ret = makeMutClosure(arg0, arg1, wasm$1.__wasm_bindgen_func_elem_7471, __wasm_bindgen_func_elem_7472);
         return addHeapObject(ret);
     };
     imports.wbg.__wbindgen_cast_9ae0607507abb057 = function(arg0) {
@@ -19545,11 +19622,21 @@ function __wbg_get_imports(memory) {
         const ret = arg0;
         return addHeapObject(ret);
     };
+    imports.wbg.__wbindgen_cast_b5deba2f813aede2 = function(arg0, arg1) {
+        // Cast intrinsic for `Closure(Closure { dtor_idx: 390, function: Function { arguments: [NamedExternref("MessageEvent")], shim_idx: 391, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+        const ret = makeMutClosure(arg0, arg1, wasm$1.__wasm_bindgen_func_elem_7471, __wasm_bindgen_func_elem_8910);
+        return addHeapObject(ret);
+    };
     imports.wbg.__wbindgen_cast_d6cd19b81560fd6e = function(arg0) {
         // Cast intrinsic for `F64 -> Externref`.
         const ret = arg0;
         return addHeapObject(ret);
     };
+    imports.wbg.__wbindgen_cast_e15614d8168764d1 = function(arg0, arg1) {
+        // Cast intrinsic for `Closure(Closure { dtor_idx: 390, function: Function { arguments: [Externref], shim_idx: 391, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+        const ret = makeMutClosure(arg0, arg1, wasm$1.__wasm_bindgen_func_elem_7471, __wasm_bindgen_func_elem_8910);
+        return addHeapObject(ret);
+    };
     imports.wbg.__wbindgen_cast_e7b45dd881f38ce3 = function(arg0, arg1) {
         // Cast intrinsic for `U128 -> Externref`.
         const ret = (BigInt.asUintN(64, arg0) | (BigInt.asUintN(64, arg1) << BigInt(64)));
@@ -19697,6 +19784,7 @@ var exports$1$1 = /*#__PURE__*/Object.freeze({
     VerifyingKey: VerifyingKey,
     ViewKey: ViewKey,
     default: __wbg_init,
+    getMaxProgramImports: getMaxProgramImports,
     getOrInitConsensusVersionTestHeights: getOrInitConsensusVersionTestHeights,
     initSync: initSync$1,
     initThreadPool: initThreadPool,