@provablehq/sdk 0.9.11 → 0.9.13

package/dist/testnet/browser.js

@@ -497,7 +497,7 @@ class AleoNetworkClient {
         else {
             this.headers = {
                 // This is replaced by the actual version by a Rollup plugin
-                "X-Aleo-SDK-Version": "0.9.11",
+                "X-Aleo-SDK-Version": "0.9.13",
                 "X-Aleo-environment": environment(),
             };
         }
@@ -2306,7 +2306,7 @@ class AleoKeyProvider {
                 const verifying_key = key.verifyingKey();
                 const proving_key = await this.fetchProvingKey(key.prover, key.locator);
                 if (this.cacheOption) {
-                    this.cache.set(CREDITS_PROGRAM_KEYS.bond_public.locator, [proving_key.toBytes(), verifying_key.toBytes()]);
+                    this.cache.set(CREDITS_PROGRAM_KEYS.getKey(key.name).locator, [proving_key.toBytes(), verifying_key.toBytes()]);
                 }
                 return [proving_key, verifying_key];
             }
@@ -3703,6 +3703,22 @@ class SealanceMerkleTree {
         }
         return tree.map(element => BigInt(element.slice(0, element.length - "field".length)));
     }
+    /** Converts an array of decimal string representations of U256 numbers to an array of BigInts.
+    *
+    * @param tree - Array of decimal string representations of U256 numbers.
+    * @returns Array of BigInts.
+    */
+    convertTreeToBigInt(tree) {
+        return tree.map((element) => {
+            try {
+                // decimal string → native bigint
+                return BigInt(element);
+            }
+            catch {
+                throw new Error(`Invalid decimal U256 string: ${element}`);
+            }
+        });
+    }
     /**
     * Converts Aleo addresses to field elements, sorts them, pads with zero fields, and returns an array. This prepares addresses for Merkle tree construction.
     *
@@ -3811,6 +3827,28 @@ class SealanceMerkleTree {
         }
         return { siblings: siblingPath, leaf_index: leafIndex };
     }
+    /**
+    * Generates a formatted exclusion proof suitable for Aleo transactions.
+    *
+    * @param proof - An array of two {sibling path, leafindex} objects.
+    * @returns String representation of the exclusion proof.
+    *
+    * @example
+    * ```typescript
+    * const tree = buildTree(leaves);
+    * const proof = getSiblingPath(tree, 0, 15);
+    * const proof2 = getSiblingPath(tree, 1, 15);
+    * const formattedProof = formatMerkleProof([proof, proof2]);
+    * // formattedProof = "[{ siblings: [0field, 1field, ...], leaf_index: 0u32 }, { siblings: [0field, 2field, ...], leaf_index: 1u32 }]"
+    * ```
+    */
+    formatMerkleProof(proof) {
+        const formatted = proof.map(item => {
+            const siblings = item.siblings.map(s => `${s}field`).join(", ");
+            return `{siblings: [${siblings}], leaf_index: ${item.leaf_index}u32}`;
+        }).join(", ");
+        return `[${formatted}]`;
+    }
 }
 
 /**
@@ -3895,6 +3933,44 @@ class ProgramManager {
     setHeader(headerName, value) {
         this.networkClient.headers[headerName] = value;
     }
+    /**
+     * Set the inclusion prover into the wasm memory. This should be done prior to any execution of a function with a
+     * private record.
+     *
+     * @param {ProvingKey} [provingKey]
+     *
+     * @example
+     * import { ProgramManager, AleoKeyProvider } from "@provablehq/sdk/mainnet.js";
+     *
+     * const keyProvider = new AleoKeyProvider();
+     * keyProvider.useCache(true);
+     *
+     * // Create a ProgramManager
+     * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider);
+     *
+     * // Set the inclusion keys.
+     * programManager.setInclusionProver();
+     */
+    async setInclusionProver(provingKey) {
+        if (this.inclusionKeysLoaded) {
+            return;
+        }
+        try {
+            if (provingKey) {
+                ProgramManager$1.loadInclusionProver(provingKey);
+                this.inclusionKeysLoaded = true;
+            }
+            else {
+                const inclusionKeys = await this.keyProvider.inclusionKeys();
+                ProgramManager$1.loadInclusionProver(inclusionKeys[0]);
+                this.inclusionKeysLoaded = true;
+            }
+            return;
+        }
+        catch {
+            console.log("Setting the inclusion prover requires either a key provider to be configured for the ProgramManager OR to pass the inclusion prover directly");
+        }
+    }
     /**
      * Remove a header from the `AleoNetworkClient`s header map
      *
@@ -3987,9 +4063,23 @@ class ProgramManager {
         }
         // Get the fee record from the account if it is not provided in the parameters
         try {
-            feeRecord = privateFee
-                ? RecordPlaintext.fromString((await this.getCreditsRecord(priorityFee, [], feeRecord, recordSearchParams)).record_plaintext ?? '')
-                : undefined;
+            if (privateFee) {
+                let fee = priorityFee;
+                // If a private fee is specified, but no fee record is provided, estimate the fee and find a matching record.
+                if (!feeRecord) {
+                    console.log("Private fee specified, but no private fee record provided, estimating fee and finding a matching fee record.");
+                    const programString = programObject.toString();
+                    const imports = await this.networkClient.getProgramImports(programString);
+                    const baseFee = Number(ProgramManager$1.estimateDeploymentFee(programString, imports));
+                    fee = baseFee + priorityFee;
+                }
+                // Get a credits.aleo record for the fee.
+                feeRecord = await this.getCreditsRecord(fee, [], feeRecord, recordSearchParams);
+            }
+            else {
+                // If it's specified NOT to use a privateFee, use a public fee.
+                feeRecord = undefined;
+            }
         }
         catch (e) {
             logAndThrow(`Error finding fee record. Record finder response: '${e.message}'. Please ensure you're connected to a valid Aleo network and a record with enough balance exists.`);
@@ -4016,6 +4106,118 @@ class ProgramManager {
         // Build a deployment transaction
         return await ProgramManager$1.buildDeploymentTransaction(deploymentPrivateKey, program, priorityFee, feeRecord, this.host, imports, feeProvingKey, feeVerifyingKey);
     }
+    /**
+     * Builds a deployment transaction for submission to the Aleo network that upgrades an existing program.
+     *
+     * @param {DeployOptions} options The deployment options.
+     *
+     * @example
+     * /// Import the mainnet version of the sdk.
+     * import { AleoKeyProvider, ProgramManager, NetworkRecordProvider } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a new NetworkClient, KeyProvider, and RecordProvider
+     * const keyProvider = new AleoKeyProvider();
+     * const recordProvider = new NetworkRecordProvider(account, networkClient);
+     * keyProvider.useCache(true);
+     *
+     * // Initialize a program manager with the key provider to automatically fetch keys for deployments
+     * const program = "program hello_hello.aleo;\n\nfunction hello:\n    input r0 as u32.public;\n    input r1 as u32.private;\n    add r0 r1 into r2;\n    output r2 as u32.private;\n";
+     * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, recordProvider);
+     * programManager.setAccount(Account);
+     *
+     * // Define a fee in credits
+     * const priorityFee = 0.0;
+     *
+     * // Create the deployment transaction.
+     * const tx = await programManager.buildUpgradeTransaction({program: program, priorityFee: fee, privateFee: false});
+     * await programManager.networkClient.submitTransaction(tx);
+     *
+     * // Verify the transaction was successful
+     * setTimeout(async () => {
+     *  const transaction = await programManager.networkClient.getTransaction(tx.id());
+     *  assert(transaction.id() === tx.id());
+     * }, 20000);
+     */
+    async buildUpgradeTransaction(options) {
+        const { program, priorityFee, privateFee, recordSearchParams } = options;
+        let feeRecord = options.feeRecord;
+        let privateKey = options.privateKey;
+        // Ensure the program is valid.
+        let programObject;
+        try {
+            programObject = Program.fromString(program);
+        }
+        catch (e) {
+            logAndThrow(`Error parsing program: '${e.message}'. Please ensure the program is valid.`);
+        }
+        // Ensure the program is valid and does not exist on the network
+        try {
+            let programSource;
+            try {
+                programSource = await this.networkClient.getProgram(programObject.id());
+            }
+            catch (e) {
+                // Program does not exist on the network, deployment can proceed
+                console.log(`Program ${programObject.id()} does not exist on the network...`);
+            }
+        }
+        catch (e) {
+            logAndThrow(`Error validating program: ${e.message}`);
+        }
+        // Get the private key from the account if it is not provided in the parameters
+        let deploymentPrivateKey = privateKey;
+        if (typeof privateKey === "undefined" &&
+            typeof this.account !== "undefined") {
+            deploymentPrivateKey = this.account.privateKey();
+        }
+        if (typeof deploymentPrivateKey === "undefined") {
+            throw "No private key provided and no private key set in the ProgramManager";
+        }
+        // Get the fee record from the account if it is not provided in the parameters
+        try {
+            if (privateFee) {
+                let fee = priorityFee;
+                // If a private fee is specified, but no fee record is provided, estimate the fee and find a matching record.
+                if (!feeRecord) {
+                    console.log("Private fee specified, but no private fee record provided, estimating fee and finding a matching fee record.");
+                    const programString = programObject.toString();
+                    const imports = await this.networkClient.getProgramImports(programString);
+                    const baseFee = Number(ProgramManager$1.estimateDeploymentFee(programString, imports));
+                    fee = baseFee + priorityFee;
+                }
+                // Get a credits.aleo record for the fee.
+                feeRecord = await this.getCreditsRecord(fee, [], feeRecord, recordSearchParams);
+            }
+            else {
+                // If it's specified NOT to use a privateFee, use a public fee.
+                feeRecord = undefined;
+            }
+        }
+        catch (e) {
+            logAndThrow(`Error finding fee record. Record finder response: '${e.message}'. Please ensure you're connected to a valid Aleo network and a record with enough balance exists.`);
+        }
+        // Get the proving and verifying keys from the key provider
+        let feeKeys;
+        try {
+            feeKeys = privateFee
+                ? await this.keyProvider.feePrivateKeys()
+                : await this.keyProvider.feePublicKeys();
+        }
+        catch (e) {
+            logAndThrow(`Error finding fee keys. Key finder response: '${e.message}'. Please ensure your key provider is configured correctly.`);
+        }
+        const [feeProvingKey, feeVerifyingKey] = feeKeys;
+        // Resolve the program imports if they exist
+        let imports;
+        try {
+            imports = await this.networkClient.getProgramImports(program);
+        }
+        catch (e) {
+            logAndThrow(`Error finding program imports. Network response: '${e.message}'. Please ensure you're connected to a valid Aleo network and the program is deployed to the network.`);
+        }
+        // Build a deployment transaction
+        return await ProgramManager$1.buildUpgradeTransaction(deploymentPrivateKey, program, priorityFee, feeRecord, this.host, imports, feeProvingKey, feeVerifyingKey);
+    }
     /**
      * Deploy an Aleo program to the Aleo network
      *
@@ -4115,21 +4317,35 @@ class ProgramManager {
         let programName = options.programName;
         let imports = options.imports;
         let edition = options.edition;
+        let programObject;
         // Ensure the function exists on the network
         if (program === undefined) {
             try {
-                program = (await this.networkClient.getProgram(programName));
+                programObject = await this.networkClient.getProgramObject(programName);
+                program = programObject.toString();
             }
             catch (e) {
                 logAndThrow(`Error finding ${programName}. Network response: '${e.message}'. Please ensure you're connected to a valid Aleo network the program is deployed to the network.`);
             }
         }
+        else if (typeof program == "string") {
+            try {
+                programObject = Program.fromString(program);
+            }
+            catch (e) {
+                logAndThrow(`Program sources passed for ${programName} were invalid: ${e}`);
+            }
+        }
         else if (program instanceof Program) {
+            programObject = program;
             program = program.toString();
         }
+        if (!(programObject instanceof Program)) {
+            logAndThrow(`Failed to validate program ${programName}`);
+        }
         // Get the program name if it is not provided in the parameters.
         if (programName === undefined) {
-            programName = Program.fromString(program).id();
+            programName = programObject.id();
         }
         if (edition == undefined) {
             try {
@@ -4149,15 +4365,6 @@ class ProgramManager {
         if (typeof executionPrivateKey === "undefined") {
             throw "No private key provided and no private key set in the ProgramManager";
         }
-        // Get the fee record from the account if it is not provided in the parameters
-        try {
-            feeRecord = privateFee
-                ? RecordPlaintext.fromString((await this.getCreditsRecord(priorityFee, [], feeRecord, recordSearchParams)).record_plaintext ?? '')
-                : undefined;
-        }
-        catch (e) {
-            logAndThrow(`Error finding fee record. Record finder response: '${e.message}'. Please ensure you're connected to a valid Aleo network and a record with enough balance exists.`);
-        }
         // Get the fee proving and verifying keys from the key provider
         let feeKeys;
         try {
@@ -4179,7 +4386,7 @@ class ProgramManager {
             }
         }
         // Resolve the program imports if they exist
-        const numberOfImports = Program.fromString(program).getImports().length;
+        const numberOfImports = programObject.getImports().length;
         if (numberOfImports > 0 && !imports) {
             try {
                 imports = (await this.networkClient.getProgramImports(programName));
@@ -4188,6 +4395,26 @@ class ProgramManager {
                 logAndThrow(`Error finding program imports. Network response: '${e.message}'. Please ensure you're connected to a valid Aleo network and the program is deployed to the network.`);
             }
         }
+        // Get the fee record from the account if it is not provided in the parameters
+        try {
+            if (privateFee) {
+                let fee = priorityFee;
+                // If a fee record wasn't provided, estimate the fee that needs to be paid.
+                if (!feeRecord) {
+                    const baseFee = Number(await this.estimateExecutionFee({ programName, functionName, program, imports }));
+                    fee = baseFee + priorityFee;
+                }
+                // Get a credits.aleo record for the fee.
+                feeRecord = await this.getCreditsRecord(fee, [], feeRecord, recordSearchParams);
+            }
+            else {
+                // If it's specified NOT to use a privateFee, use a public fee.
+                feeRecord = undefined;
+            }
+        }
+        catch (e) {
+            logAndThrow(`Error finding fee record. Record finder response: '${e.message}'. Please ensure you're connected to a valid Aleo network and a record with enough balance exists.`);
+        }
         if (offlineQuery && !this.inclusionKeysLoaded) {
             try {
                 const inclusionKeys = await this.keyProvider.inclusionKeys();
@@ -4584,15 +4811,6 @@ class ProgramManager {
         if (typeof executionPrivateKey === "undefined") {
             throw "No private key provided and no private key set in the ProgramManager";
         }
-        // Get the fee record from the account if it is not provided in the parameters.
-        try {
-            feeRecord = privateFee
-                ? RecordPlaintext.fromString((await this.getCreditsRecord(priorityFee, [], feeRecord, recordSearchParams)).record_plaintext ?? '')
-                : undefined;
-        }
-        catch (e) {
-            logAndThrow(`Error finding fee record. Record finder response: '${e.message}'. Please ensure you're connected to a valid Aleo network and a record with enough balance exists.`);
-        }
         // Resolve the program imports if they exist.
         const numberOfImports = Program.fromString(program).getImports().length;
         if (numberOfImports > 0 && !imports) {
@@ -4603,6 +4821,26 @@ class ProgramManager {
                 logAndThrow(`Error finding program imports. Network response: '${e.message}'. Please ensure you're connected to a valid Aleo network and the program is deployed to the network.`);
             }
         }
+        // Get the fee record from the account if it is not provided in the parameters
+        try {
+            if (privateFee) {
+                let fee = priorityFee;
+                // If a fee record wasn't provided, estimate the fee that needs to be paid.
+                if (!feeRecord) {
+                    const baseFee = Number(await this.estimateExecutionFee({ programName, functionName, program: program.toString(), imports }));
+                    fee = baseFee + priorityFee;
+                }
+                // Get a credits.aleo record for the fee.
+                feeRecord = await this.getCreditsRecord(fee, [], feeRecord, recordSearchParams);
+            }
+            else {
+                // If it's specified NOT to use a privateFee, use a public fee.
+                feeRecord = undefined;
+            }
+        }
+        catch (e) {
+            logAndThrow(`Error finding fee record. Record finder response: '${e.message}'. Please ensure you're connected to a valid Aleo network and a record with enough balance exists.`);
+        }
         // Build and return the `ProvingRequest`.
         return await ProgramManager$1.buildProvingRequest(executionPrivateKey, program, functionName, inputs, baseFee, priorityFee, feeRecord, imports, broadcast, unchecked, edition);
     }
@@ -4825,9 +5063,20 @@ class ProgramManager {
         const [joinProvingKey, joinVerifyingKey] = joinKeys;
         // Get the fee record from the account if it is not provided in the parameters
         try {
-            feeRecord = privateFee
-                ? RecordPlaintext.fromString((await this.getCreditsRecord(priorityFee, [], feeRecord, recordSearchParams)).record_plaintext ?? '')
-                : undefined;
+            if (privateFee) {
+                let fee = priorityFee;
+                // If a fee record wasn't provided, estimate the fee that needs to be paid.
+                if (!feeRecord) {
+                    const baseFee = Number(await this.estimateExecutionFee({ programName: "credits.aleo", functionName: "join" }));
+                    fee = baseFee + priorityFee;
+                }
+                // Get a credits.aleo record for the fee.
+                feeRecord = await this.getCreditsRecord(fee, [], feeRecord, recordSearchParams);
+            }
+            else {
+                // If it's specified NOT to use a privateFee, use a public fee.
+                feeRecord = undefined;
+            }
         }
         catch (e) {
             logAndThrow(`Error finding fee record. Record finder response: '${e.message}'. Please ensure you're connected to a valid Aleo network and a record with enough balance exists.`);
@@ -5040,15 +5289,20 @@ class ProgramManager {
             const nonces = [];
             if (requiresAmountRecord(transferType)) {
                 // If the transfer type is private and requires an amount record, get it from the record provider
-                amountRecord = RecordPlaintext.fromString((await this.getCreditsRecord(priorityFee, [], amountRecord, recordSearchParams)).record_plaintext ?? '');
+                amountRecord = await this.getCreditsRecord(priorityFee, [], amountRecord, recordSearchParams);
                 nonces.push(amountRecord.nonce());
             }
             else {
                 amountRecord = undefined;
             }
-            feeRecord = privateFee
-                ? RecordPlaintext.fromString((await this.getCreditsRecord(priorityFee, nonces, feeRecord, recordSearchParams)).record_plaintext ?? '')
-                : undefined;
+            if (privateFee) {
+                // Get a credits.aleo record for the fee.
+                feeRecord = await this.getCreditsRecord(priorityFee, [], feeRecord, recordSearchParams);
+            }
+            else {
+                // If it's specified NOT to use a privateFee, use a public fee.
+                feeRecord = undefined;
+            }
         }
         catch (e) {
             logAndThrow(`Error finding fee record. Record finder response: '${e.message}'. Please ensure you're connected to a valid Aleo network and a record with enough balance exists.`);
@@ -5875,28 +6129,372 @@ class ProgramManager {
     }
     // Internal utility function for getting a credits.aleo record
     async getCreditsRecord(amount, nonces, record, params) {
+        if (record) {
+            try {
+                return record instanceof RecordPlaintext
+                    ? record : RecordPlaintext.fromString(record);
+            }
+            catch {
+                logAndThrow(`Record '${record}' could not be parsed, please ensure a valid credits.aleo record 
+                is passed prior to trying again`);
+            }
+        }
+        else {
+            try {
+                const recordProvider = this.recordProvider;
+                const record = await recordProvider.findCreditsRecord(amount, { ...params, unspent: true, nonces });
+                if (record.record_plaintext) {
+                    return RecordPlaintext.fromString(record.record_plaintext);
+                }
+                else {
+                    logAndThrow("Failed to deserialize record returned from record provider");
+                }
+            }
+            catch (e) {
+                logAndThrow(`Error finding fee record. Record finder response: '${e}'. Please ensure you're connected to a valid Aleo network and a record with enough balance exists.`);
+            }
+        }
+    }
+    /**
+     * Builds an execution transaction for submission to the a local devnode.
+     * This method skips proof generation and is not meant for use with the mainnet or testnet Aleo networks.
+     * Note: getOrInitConsensusVersionTestHeights must be called prior to using this method for this method to work properly.
+     *
+     * @param {ExecuteOptions} options - The options for the execution transaction.
+     * @returns {Promise<Transaction>} - A promise that resolves to the transaction or an error.
+     *
+     * @example
+     * /// Import the mainnet version of the sdk.
+     * import { AleoKeyProvider, getOrInitConsensusVersionTestHeights, ProgramManager, NetworkRecordProvider } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Initialize the development consensus heights in order to work with devnode.
+     * getOrInitConsensusVersionTestHeights("0,1,2,3,4,5,6,7,8,9,10,11");
+     *
+     * // Create a new NetworkClient and RecordProvider.
+     * const recordProvider = new NetworkRecordProvider(account, networkClient);
+     * keyProvider.useCache(true);
+     *
+     * // Initialize a program manager.
+     * const programManager = new ProgramManager("http://localhost:3030", recordProvider);
+     *
+     * // Build and execute the transaction.
+     * const tx = await programManager.buildDevnodeExecutionTransaction({
+     *   programName: "hello_hello.aleo",
+     *   functionName: "hello_hello",
+     *   priorityFee: 0.0,
+     *   privateFee: false,
+     *   inputs: ["5u32", "5u32"],
+     * });
+     *
+     * // Submit the transaction to the network
+     * await programManager.networkClient.submitTransaction(tx.toString());
+     *
+     * // Verify the transaction was successful
+     * setTimeout(async () => {
+     *  const transaction = await programManager.networkClient.getTransaction(tx.id());
+     *  assert(transaction.id() === tx.id());
+     * }, 10000);
+     */
+    async buildDevnodeExecutionTransaction(options) {
+        // Destructure the options object to access the parameters
+        const { functionName, priorityFee, privateFee, inputs, recordSearchParams, privateKey, } = options;
+        let feeRecord = options.feeRecord;
+        let program = options.program;
+        let programName = options.programName;
+        let imports = options.imports;
+        let edition = options.edition;
+        let programObject;
+        // Ensure the function exists on the network
+        if (program === undefined) {
+            try {
+                programObject = await this.networkClient.getProgramObject(programName);
+                program = programObject.toString();
+            }
+            catch (e) {
+                logAndThrow(`Error finding ${programName}. Network response: '${e.message}'. Please ensure you're connected to a valid Aleo network the program is deployed to the network.`);
+            }
+        }
+        else if (typeof program == "string") {
+            try {
+                programObject = Program.fromString(program);
+            }
+            catch (e) {
+                logAndThrow(`Program sources passed for ${programName} were invalid: ${e}`);
+            }
+        }
+        else if (program instanceof Program) {
+            programObject = program;
+            program = program.toString();
+        }
+        if (!(programObject instanceof Program)) {
+            logAndThrow(`Failed to validate program ${programName}`);
+        }
+        // Get the program name if it is not provided in the parameters.
+        if (programName === undefined) {
+            programName = programObject.id();
+        }
+        if (edition == undefined) {
+            try {
+                edition = await this.networkClient.getLatestProgramEdition(programName);
+            }
+            catch (e) {
+                console.warn(`Error finding edition for ${programName}. Network response: '${e.message}'. Assuming edition 0.`);
+                edition = 0;
+            }
+        }
+        // Get the private key from the account if it is not provided in the parameters.
+        let executionPrivateKey = privateKey;
+        if (typeof privateKey === "undefined" &&
+            typeof this.account !== "undefined") {
+            executionPrivateKey = this.account.privateKey();
+        }
+        if (typeof executionPrivateKey === "undefined") {
+            throw "No private key provided and no private key set in the ProgramManager";
+        }
+        // Get the fee record from the account if it is not provided in the parameters.
         try {
-            // return record instanceof RecordPlaintext
-            //     ? record
-            //     : RecordPlaintext.fromString(<string>record);
-            if (record && record instanceof RecordPlaintext) {
-                record = record.toString();
-            }
-            return ({
-                recordPlaintext: record,
-                programName: 'credits.aleo',
-                recordName: 'credits',
-            });
+            if (privateFee) {
+                let fee = priorityFee;
+                // If a private fee is specified, but no fee record is provided, estimate the fee and find a matching record.
+                if (!feeRecord) {
+                    console.log("Private fee specified, but no private fee record provided, estimating fee and finding a matching fee record.");
+                    const programString = programObject.toString();
+                    const imports = await this.networkClient.getProgramImports(programString);
+                    const baseFee = Number(ProgramManager$1.estimateDeploymentFee(programString, imports));
+                    fee = baseFee + priorityFee;
+                }
+                // Get a credits.aleo record for the fee.
+                feeRecord = await this.getCreditsRecord(fee, [], feeRecord, recordSearchParams);
+            }
+            else {
+                // If it's specified NOT to use a privateFee, use a public fee.
+                feeRecord = undefined;
+            }
         }
         catch (e) {
+            logAndThrow(`Error finding fee record. Record finder response: '${e.message}'. Please ensure you're connected to a valid Aleo network and a record with enough balance exists.`);
+        }
+        // Resolve the program imports if they exist.
+        const numberOfImports = programObject.getImports().length;
+        if (numberOfImports > 0 && !imports) {
             try {
-                const recordProvider = this.recordProvider;
-                return await recordProvider.findCreditsRecord(amount, { ...params, unspent: true, nonces });
+                imports = (await this.networkClient.getProgramImports(programName));
             }
             catch (e) {
-                logAndThrow(`Error finding fee record. Record finder response: '${e.message}'. Please ensure you're connected to a valid Aleo network and a record with enough balance exists.`);
+                logAndThrow(`Error finding program imports. Network response: '${e.message}'. Please ensure you're connected to a valid Aleo network and the program is deployed to the network.`);
             }
         }
+        // Build a transaction without a proof
+        return await ProgramManager$1.buildDevnodeExecutionTransaction(executionPrivateKey, program, functionName, inputs, priorityFee, feeRecord, this.host, imports, edition);
+    }
+    /**
+     * Builds a deployment transaction with placeholder certificates and verifying keys for each function in the program.
+     * Intended for use with a local devnode.
+     * `getOrInitConsensusVersionTestHeights` must be called with development heights prior to invoking this method for it to work properly.
+     *
+     * @param {DeployOptions} options - The options for the deployment transaction.
+     * @returns {string} The transaction id of the deployed program or a failure message from the network
+     *
+     * @example
+     * /// Import the mainnet version of the sdk.
+     * import { ProgramManager, NetworkRecordProvider, getOrInitConsensusVersionTestHeights } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Initialize the development consensus heights in order to work with a local devnode.
+     * getOrInitConsensusVersionTestHeights("0,1,2,3,4,5,6,7,8,9,10,11");
+     *
+     * // Create a new NetworkClient, and RecordProvider
+     * const recordProvider = new NetworkRecordProvider(account, networkClient);
+     * keyProvider.useCache(true);
+     *
+     * // Initialize a program manager with the key provider to automatically fetch keys for deployments
+     * const program = "program hello_hello.aleo;\n\nfunction hello:\n    input r0 as u32.public;\n    input r1 as u32.private;\n    add r0 r1 into r2;\n    output r2 as u32.private;\n";
+     * const programManager = new ProgramManager("http://localhost:3030", recordProvider);
+     * programManager.setAccount(Account);
+     *
+     * // Define a fee in credits
+     * const priorityFee = 0.0;
+     *
+     * // Create the deployment transaction.
+     * const tx = await programManager.buildDevnodeDeploymentTransaction({program: program, fee: priorityFee, privateFee: false});
+     * await programManager.networkClient.submitTransaction(tx);
+     *
+     * // Verify the transaction was successful
+     * setTimeout(async () => {
+     *  const transaction = await programManager.networkClient.getTransaction(tx.id());
+     *  assert(transaction.id() === tx.id());
+     * }, 20000);
+     */
+    async buildDevnodeDeploymentTransaction(options) {
+        const { program, priorityFee, privateFee, recordSearchParams } = options;
+        let feeRecord = options.feeRecord;
+        let privateKey = options.privateKey;
+        // Ensure the program is valid.
+        let programObject;
+        try {
+            programObject = Program.fromString(program);
+        }
+        catch (e) {
+            logAndThrow(`Error parsing program: '${e.message}'. Please ensure the program is valid.`);
+        }
+        // Ensure the program is valid and does not exist on the network
+        try {
+            let programSource;
+            try {
+                programSource = await this.networkClient.getProgram(programObject.id());
+            }
+            catch (e) {
+                // Program does not exist on the network, deployment can proceed
+                console.log(`Program ${programObject.id()} does not exist on the network, deploying...`);
+            }
+            if (typeof programSource === "string") {
+                throw Error(`Program ${programObject.id()} already exists on the network, please rename your program`);
+            }
+        }
+        catch (e) {
+            logAndThrow(`Error validating program: ${e.message}`);
+        }
+        // Get the private key from the account if it is not provided in the parameters
+        let deploymentPrivateKey = privateKey;
+        if (typeof privateKey === "undefined" &&
+            typeof this.account !== "undefined") {
+            deploymentPrivateKey = this.account.privateKey();
+        }
+        if (typeof deploymentPrivateKey === "undefined") {
+            throw "No private key provided and no private key set in the ProgramManager";
+        }
+        // Get the fee record from the account if it is not provided in the parameters
+        try {
+            if (privateFee) {
+                let fee = priorityFee;
+                // If a private fee is specified, but no fee record is provided, estimate the fee and find a matching record.
+                if (!feeRecord) {
+                    console.log("Private fee specified, but no private fee record provided, estimating fee and finding a matching fee record.");
+                    const programString = programObject.toString();
+                    const imports = await this.networkClient.getProgramImports(programString);
+                    const baseFee = Number(ProgramManager$1.estimateDeploymentFee(programString, imports));
+                    fee = baseFee + priorityFee;
+                }
+                // Get a credits.aleo record for the fee.
+                feeRecord = await this.getCreditsRecord(fee, [], feeRecord, recordSearchParams);
+            }
+            else {
+                // If it's specified NOT to use a privateFee, use a public fee.
+                feeRecord = undefined;
+            }
+        }
+        catch (e) {
+            logAndThrow(`Error finding fee record. Record finder response: '${e.message}'. Please ensure you're connected to a valid Aleo network and a record with enough balance exists.`);
+        }
+        // Resolve the program imports if they exist
+        let imports;
+        try {
+            imports = await this.networkClient.getProgramImports(program);
+        }
+        catch (e) {
+            logAndThrow(`Error finding program imports. Network response: '${e.message}'. Please ensure you're connected to a valid Aleo network and the program is deployed to the network.`);
+        }
+        return await ProgramManager$1.buildDevnodeDeploymentTransaction(deploymentPrivateKey, program, priorityFee, feeRecord, this.host, imports);
+    }
+    /**
+     * Builds an upgrade transaction on a local devnodewith placeholder certificates and verifying keys for each function in the program.
+     * This method is only intended for use with a local devnode.
+     *
+     * @param {DeployOptions} options - The options for the deployment transaction.
+     * @returns {string} The transaction id of the deployed program or a failure message from the network
+     *
+     * @example
+     * /// Import the mainnet version of the sdk.
+     * import { ProgramManager, NetworkRecordProvider } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a new NetworkClient, and RecordProvider
+     * const recordProvider = new NetworkRecordProvider(account, networkClient);
+     * keyProvider.useCache(true);
+     *
+     * // Initialize a program manager with the key provider to automatically fetch keys for deployments
+     * const program = "program hello_hello.aleo;\n\nfunction hello:\n    input r0 as u32.public;\n    input r1 as u32.private;\n    add r0 r1 into r2;\n    output r2 as u32.private;\n";
+     * const programManager = new ProgramManager("http://localhost:3030", recordProvider);
+     * programManager.setAccount(Account);
+     *
+     * // Define a fee in credits
+     * const priorityFee = 0.0;
+     *
+     * // Create the deployment transaction.
+     * const tx = await programManager.buildDevnodeUpgradeTransaction({program: program, fee: priorityFee, privateFee: false});
+     * await programManager.networkClient.submitTransaction(tx);
+     *
+     * // Verify the transaction was successful
+     * setTimeout(async () => {
+     *  const transaction = await programManager.networkClient.getTransaction(tx.id());
+     *  assert(transaction.id() === tx.id());
+     * }, 20000);
+     */
+    async buildDevnodeUpgradeTransaction(options) {
+        const { program, priorityFee, privateFee, recordSearchParams } = options;
+        let feeRecord = options.feeRecord;
+        let privateKey = options.privateKey;
+        // Ensure the program is valid.
+        let programObject;
+        try {
+            programObject = Program.fromString(program);
+        }
+        catch (e) {
+            logAndThrow(`Error parsing program: '${e.message}'. Please ensure the program is valid.`);
+        }
+        // Ensure the program is valid and does not exist on the network.
+        try {
+            let programSource;
+            try {
+                programSource = await this.networkClient.getProgram(programObject.id());
+            }
+            catch (e) {
+                // Program does not exist on the network.
+                logAndThrow(`Program ${programObject.id()} does not exist on the network...`);
+            }
+        }
+        catch (e) {
+            logAndThrow(`Error validating program: ${e.message}`);
+        }
+        // Get the private key from the account if it is not provided in the parameters
+        let deploymentPrivateKey = privateKey;
+        if (typeof privateKey === "undefined" &&
+            typeof this.account !== "undefined") {
+            deploymentPrivateKey = this.account.privateKey();
+        }
+        if (typeof deploymentPrivateKey === "undefined") {
+            throw "No private key provided and no private key set in the ProgramManager";
+        }
+        // Get the fee record from the account if it is not provided in the parameters
+        try {
+            if (privateFee) {
+                let fee = priorityFee;
+                // If a private fee is specified, but no fee record is provided, estimate the fee and find a matching record.
+                if (!feeRecord) {
+                    console.log("Private fee specified, but no private fee record provided, estimating fee and finding a matching fee record.");
+                    const programString = programObject.toString();
+                    const imports = await this.networkClient.getProgramImports(programString);
+                    const baseFee = Number(ProgramManager$1.estimateDeploymentFee(programString, imports));
+                    fee = baseFee + priorityFee;
+                }
+                // Get a credits.aleo record for the fee.
+                feeRecord = await this.getCreditsRecord(fee, [], feeRecord, recordSearchParams);
+            }
+            else {
+                // If it's specified NOT to use a privateFee, use a public fee.
+                feeRecord = undefined;
+            }
+        }
+        catch (e) {
+            logAndThrow(`Error finding fee record. Record finder response: '${e.message}'. Please ensure you're connected to a valid Aleo network and a record with enough balance exists.`);
+        }
+        // Resolve the program imports if they exist
+        let imports;
+        try {
+            imports = await this.networkClient.getProgramImports(program);
+        }
+        catch (e) {
+            logAndThrow(`Error finding program imports. Network response: '${e.message}'. Please ensure you're connected to a valid Aleo network and the program is deployed to the network.`);
+        }
+        return ProgramManager$1.buildDevnodeUpgradeTransaction(deploymentPrivateKey, program, priorityFee, feeRecord, this.host, imports);
     }
 }
 // Ensure the transfer type requires an amount record