@provablehq/sdk 0.9.7 → 0.9.8

package/dist/mainnet/browser.js

@@ -478,18 +478,20 @@ class AleoNetworkClient {
     headers;
     account;
     ctx;
+    verboseErrors;
     network;
     constructor(host, options) {
         this.host = host + "/mainnet";
         this.network = "mainnet";
         this.ctx = {};
+        this.verboseErrors = true;
         if (options && options.headers) {
             this.headers = options.headers;
         }
         else {
             this.headers = {
                 // This is replaced by the actual version by a Rollup plugin
-                "X-Aleo-SDK-Version": "0.9.7",
+                "X-Aleo-SDK-Version": "0.9.8",
                 "X-Aleo-environment": environment(),
             };
         }
@@ -521,7 +523,6 @@ class AleoNetworkClient {
      * Set a new host for the networkClient
      *
      * @param {string} host The address of a node hosting the Aleo API
-     * @param host
      *
      * @example
      * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
@@ -535,6 +536,22 @@ class AleoNetworkClient {
     setHost(host) {
         this.host = host + "/mainnet";
     }
+    /**
+     * Set verbose errors to true or false for the `AleoNetworkClient`. When set to true, if `submitTransaction` fails, the failure responses will report descriptive information as to why the transaction failed.
+     *
+     * @param {boolean} verboseErrors Set verbose error mode to true or false for the AleoNetworkClient.
+     * @example
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a networkClient
+     * const networkClient = new AleoNetworkClient();
+     *
+     * // Set debug mode to true
+     * networkClient.setVerboseTransactionErrors(true);
+     **/
+    setVerboseErrors(verboseErrors) {
+        this.verboseErrors = verboseErrors;
+    }
     /**
      * Set a header in the `AleoNetworkClient`s header map
      *
@@ -1773,7 +1790,8 @@ class AleoNetworkClient {
             ? transaction.toString()
             : transaction;
         try {
-            const response = await retryWithBackoff(() => this._sendPost(this.host + "/transaction/broadcast", {
+            const endpoint = this.verboseErrors ? "transaction/broadcast?check_transaction=true" : "transaction/broadcast";
+            const response = await retryWithBackoff(() => this._sendPost(`${this.host}/${endpoint}`, {
                 body: transactionString,
                 headers: Object.assign({}, { ...this.headers, "X-ALEO-METHOD": "submitTransaction" }, {
                     "Content-Type": "application/json",
@@ -1820,32 +1838,35 @@ class AleoNetworkClient {
     /**
      * Submit a `ProvingRequest` to a remote proving service for delegated proving. If the broadcast flag of the `ProvingRequest` is set to `true` the remote service will attempt to broadcast the result `Transaction` on behalf of the requestor.
      *
-     * @param {ProvingRequest | string} provingRequest - The `ProvingRequest` (generated by the ProgramManager) to submit.
-     * @param {string} url - (Optional) The url of the proving service.
+     * @param {DelegatedProvingParams} options - The optional parameters required to submit a proving request.
      * @returns {Promise<ProvingResponse>} The ProvingResponse containing the transaction result and the result of the broadcast if the `broadcast` flag was set to `true`.
      */
-    async submitProvingRequest(provingRequest, url) {
-        const prover_uri = url ? url : this.host;
-        const provingRequestString = provingRequest instanceof ProvingRequest
-            ? provingRequest.toString()
-            : provingRequest;
+    async submitProvingRequest(options) {
+        const proverUri = options.url ?? this.host;
+        const provingRequestString = options.provingRequest instanceof ProvingRequest
+            ? options.provingRequest.toString()
+            : options.provingRequest;
+        // Build headers with proper auth fallback
+        const headers = {
+            ...this.headers,
+            "X-ALEO-METHOD": "submitProvingRequest",
+            "Content-Type": "application/json"
+        };
+        // Add auth header based on what's available
+        if (options.apiKey) {
+            headers["X-Provable-API-Key"] = options.apiKey;
+        }
         try {
-            const response = await retryWithBackoff(() => post(prover_uri + "/prove", {
+            const response = await retryWithBackoff(() => post(`${proverUri}/prove`, {
                 body: provingRequestString,
-                headers: Object.assign({}, { ...this.headers, "X-ALEO-METHOD": "submitProvingRequest" }, {
-                    "Content-Type": "application/json",
-                }),
+                headers
             }));
-            try {
-                const text = await response.text();
-                return parseJSON(text);
-            }
-            catch (error) {
-                throw new Error(`Error posting proving request. Aleo network response: ${error.message}`);
-            }
+            const responseText = await response.text();
+            return parseJSON(responseText);
         }
         catch (error) {
-            throw new Error(`Error posting proving request: No response received: ${error.message}`);
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            throw new Error(`Failed to submit proving request: ${errorMessage}`);
         }
     }
     /**
@@ -3490,11 +3511,12 @@ class ProgramManager {
      */
     async buildExecutionTransaction(options) {
         // Destructure the options object to access the parameters
-        const { programName, functionName, priorityFee, privateFee, inputs, recordSearchParams, keySearchParams, privateKey, offlineQuery, } = options;
+        const { functionName, priorityFee, privateFee, inputs, recordSearchParams, keySearchParams, privateKey, offlineQuery, } = options;
         let feeRecord = options.feeRecord;
         let provingKey = options.provingKey;
         let verifyingKey = options.verifyingKey;
         let program = options.program;
+        let programName = options.programName;
         let imports = options.imports;
         let edition = options.edition;
         // Ensure the function exists on the network
@@ -3509,6 +3531,10 @@ class ProgramManager {
         else if (program instanceof Program) {
             program = program.toString();
         }
+        // Get the program name if it is not provided in the parameters.
+        if (programName === undefined) {
+            programName = Program.fromString(program).id();
+        }
         if (edition == undefined) {
             try {
                 edition = await this.networkClient.getLatestProgramEdition(programName);
@@ -3599,9 +3625,10 @@ class ProgramManager {
      */
     async buildAuthorization(options) {
         // Destructure the options object to access the parameters.
-        const { programName, functionName, inputs, } = options;
+        const { functionName, inputs, } = options;
         const privateKey = options.privateKey;
         let program = options.programSource;
+        let programName = options.programName;
         let imports = options.programImports;
         let edition = options.edition;
         // Ensure the function exists on the network.
@@ -3616,6 +3643,10 @@ class ProgramManager {
         else if (program instanceof Program) {
             program = program.toString();
         }
+        // Get the program name if it is not provided in the parameters.
+        if (programName === undefined) {
+            programName = Program.fromString(program).id();
+        }
         // Get the private key from the account if it is not provided in the parameters.
         let executionPrivateKey = privateKey;
         if (typeof privateKey === "undefined" &&
@@ -3677,9 +3708,10 @@ class ProgramManager {
      */
     async buildAuthorizationUnchecked(options) {
         // Destructure the options object to access the parameters.
-        const { programName, functionName, inputs, } = options;
+        const { functionName, inputs, } = options;
         const privateKey = options.privateKey;
         let program = options.programSource;
+        let programName = options.programName;
         let imports = options.programImports;
         let edition = options.edition;
         // Ensure the function exists on the network.
@@ -3694,6 +3726,10 @@ class ProgramManager {
         else if (program instanceof Program) {
             program = program.toString();
         }
+        // Get the program name if it is not provided in the parameters.
+        if (programName === undefined) {
+            programName = Program.fromString(program).id();
+        }
         // Get the private key from the account if it is not provided in the parameters.
         let executionPrivateKey = privateKey;
         if (typeof privateKey === "undefined" &&
@@ -3759,9 +3795,10 @@ class ProgramManager {
      */
     async provingRequest(options) {
         // Destructure the options object to access the parameters.
-        const { programName, functionName, baseFee, priorityFee, privateFee, inputs, recordSearchParams, broadcast = false, unchecked = false, } = options;
+        const { functionName, baseFee, priorityFee, privateFee, inputs, recordSearchParams, broadcast = false, unchecked = false, } = options;
         const privateKey = options.privateKey;
         let program = options.programSource;
+        let programName = options.programName;
         let feeRecord = options.feeRecord;
         let imports = options.programImports;
         let edition = options.edition;
@@ -3777,6 +3814,10 @@ class ProgramManager {
         else if (program instanceof Program) {
             program = program.toString();
         }
+        // Get the program name if it is not provided in the parameters.
+        if (programName === undefined) {
+            programName = Program.fromString(program).id();
+        }
         if (edition == undefined) {
             try {
                 edition = await this.networkClient.getLatestProgramEdition(programName);