@provablehq/wasm 0.11.3 → 0.11.5

package/dist/mainnet/aleo_wasm.d.ts

@@ -1,7 +1,6 @@
 /* tslint:disable */
 /* eslint-disable */
 export function runRayonThread(receiver: number): void;
-export function initThreadPool(url: URL, num_threads: number): Promise<void>;
 /**
  * Set the WASM log level from JS. Called automatically by the SDK's
  * `setLogLevel(level)` to keep TS and WASM logging in sync.
@@ -9,6 +8,7 @@ export function initThreadPool(url: URL, num_threads: number): Promise<void>;
  * Values above 4 are clamped to debug.
  */
 export function setWasmLogLevel(level: number): void;
+export function initThreadPool(url: URL, num_threads: number): Promise<void>;
 /**
  * Verify a SNARK proof against a verifying key and public inputs.
  *
@@ -21,6 +21,18 @@ 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
@@ -36,17 +48,18 @@ export function snarkVerify(verifying_key: VerifyingKey, inputs: Array<any>, pro
  */
 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.
+ * Returns the maximum number of imports allowed in a program by the
+ * snarkVM network implementation this SDK was built against.
  *
- * 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).
+ * @returns {number} The maximum number of program imports.
  *
- * @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
+ * @example
+ * import { getMaxProgramImports } from '@provablehq/sdk';
+ *
+ * const maxImports = getMaxProgramImports();
  */
-export function snarkVerifyBatch(verifying_keys: Array<any>, inputs: Array<any>, proof: Proof): boolean;
+export function getMaxProgramImports(): number;
+export function stringToField(string: string): Field;
 /**
  * Set test consensus version heights for testing.
  *
@@ -56,10 +69,9 @@ export function snarkVerifyBatch(verifying_keys: Array<any>, inputs: Array<any>,
  * 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");
  */
 export function getOrInitConsensusVersionTestHeights(heights?: string | null): Array<any>;
-export function stringToField(string: string): Field;
 /**
  * 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/mainnet/index.cjs

@@ -292,16 +292,6 @@ function runRayonThread(receiver) {
     wasm$1.runRayonThread(receiver);
 }
 
-/**
- * @param {URL} url
- * @param {number} num_threads
- * @returns {Promise<void>}
- */
-function initThreadPool(url, num_threads) {
-    const ret = wasm$1.initThreadPool(addHeapObject(url), num_threads);
-    return takeObject(ret);
-}
-
 /**
  * Set the WASM log level from JS. Called automatically by the SDK's
  * `setLogLevel(level)` to keep TS and WASM logging in sync.
@@ -313,6 +303,16 @@ function setWasmLogLevel(level) {
     wasm$1.setWasmLogLevel(level);
 }
 
+/**
+ * @param {URL} url
+ * @param {number} num_threads
+ * @returns {Promise<void>}
+ */
+function initThreadPool(url, num_threads) {
+    const ret = wasm$1.initThreadPool(addHeapObject(url), num_threads);
+    return takeObject(ret);
+}
+
 let stack_pointer = 128;
 
 function addBorrowedObject(obj) {
@@ -353,6 +353,38 @@ 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
@@ -402,32 +434,39 @@ function verifyFunctionExecution(execution, verifying_key, program, function_id,
 }
 
 /**
- * Verify a batch SNARK proof against multiple verifying keys and their corresponding public inputs.
+ * Returns the maximum number of imports allowed in a program by the
+ * snarkVM network implementation this SDK was built against.
  *
- * 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).
+ * @returns {number} The maximum number of program imports.
  *
- * @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}
+ * @example
+ * import { getMaxProgramImports } from '@provablehq/sdk';
+ *
+ * const maxImports = getMaxProgramImports();
+ * @returns {number}
  */
-function snarkVerifyBatch(verifying_keys, inputs, proof) {
+function getMaxProgramImports() {
+    const ret = wasm$1.getMaxProgramImports();
+    return ret >>> 0;
+}
+
+/**
+ * @param {string} string
+ * @returns {Field}
+ */
+function stringToField(string) {
     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);
+        const ptr0 = passStringToWasm0(string, wasm$1.__wbindgen_export, wasm$1.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        wasm$1.stringToField(retptr, ptr0, len0);
         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;
+        return Field.__wrap(r0);
     } finally {
         wasm$1.__wbindgen_add_to_stack_pointer(16);
     }
@@ -442,7 +481,7 @@ function snarkVerifyBatch(verifying_keys, inputs, proof) {
  * 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");
  * @param {string | null} [heights]
  * @returns {Array<any>}
  */
@@ -453,28 +492,6 @@ function getOrInitConsensusVersionTestHeights(heights) {
     return takeObject(ret);
 }
 
-/**
- * @param {string} string
- * @returns {Field}
- */
-function stringToField(string) {
-    try {
-        const retptr = wasm$1.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passStringToWasm0(string, wasm$1.__wbindgen_export, wasm$1.__wbindgen_export2);
-        const len0 = WASM_VECTOR_LEN;
-        wasm$1.stringToField(retptr, ptr0, len0);
-        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);
-    }
-}
-
 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_7387(arg0, arg1) {
-    wasm$1.__wasm_bindgen_func_elem_7387(arg0, arg1);
+function __wasm_bindgen_func_elem_7393(arg0, arg1) {
+    wasm$1.__wasm_bindgen_func_elem_7393(arg0, arg1);
 }
 
-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_8766(arg0, arg1, arg2) {
+    wasm$1.__wasm_bindgen_func_elem_8766(arg0, arg1, addHeapObject(arg2));
 }
 
-function __wasm_bindgen_func_elem_7660(arg0, arg1, arg2, arg3) {
-    wasm$1.__wasm_bindgen_func_elem_7660(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_7666(arg0, arg1, arg2, arg3) {
+    wasm$1.__wasm_bindgen_func_elem_7666(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_7660(a, state0.b, arg0, arg1);
+                    return __wasm_bindgen_func_elem_7666(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);
     };
@@ -19527,12 +19614,12 @@ function __wbg_get_imports(memory) {
     };
     imports.wbg.__wbindgen_cast_4a64cbb5b17898c9 = function(arg0, arg1) {
         // Cast intrinsic for `Closure(Closure { dtor_idx: 358, function: Function { arguments: [Externref], shim_idx: 359, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-        const ret = makeMutClosure(arg0, arg1, wasm$1.__wasm_bindgen_func_elem_7386, __wasm_bindgen_func_elem_8758);
+        const ret = makeMutClosure(arg0, arg1, wasm$1.__wasm_bindgen_func_elem_7392, __wasm_bindgen_func_elem_8766);
         return addHeapObject(ret);
     };
     imports.wbg.__wbindgen_cast_65bbaf572cb463ed = function(arg0, arg1) {
         // Cast intrinsic for `Closure(Closure { dtor_idx: 358, function: Function { arguments: [NamedExternref("MessageEvent")], shim_idx: 359, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-        const ret = makeMutClosure(arg0, arg1, wasm$1.__wasm_bindgen_func_elem_7386, __wasm_bindgen_func_elem_8758);
+        const ret = makeMutClosure(arg0, arg1, wasm$1.__wasm_bindgen_func_elem_7392, __wasm_bindgen_func_elem_8766);
         return addHeapObject(ret);
     };
     imports.wbg.__wbindgen_cast_9ae0607507abb057 = function(arg0) {
@@ -19542,7 +19629,7 @@ function __wbg_get_imports(memory) {
     };
     imports.wbg.__wbindgen_cast_aca65e91b5ef2a91 = function(arg0, arg1) {
         // Cast intrinsic for `Closure(Closure { dtor_idx: 358, 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_7386, __wasm_bindgen_func_elem_7387);
+        const ret = makeMutClosure(arg0, arg1, wasm$1.__wasm_bindgen_func_elem_7392, __wasm_bindgen_func_elem_7393);
         return addHeapObject(ret);
     };
     imports.wbg.__wbindgen_cast_d6cd19b81560fd6e = function(arg0) {
@@ -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,