@provablehq/sdk 0.8.6 → 0.8.8

package/dist/testnet/{program-manager-CjvnOyfn.js → program-manager-BuK9g9xJ.js}

@@ -1,4 +1,4 @@
-import { PrivateKey, RecordCiphertext, Program, Plaintext, Transaction, Metadata, VerifyingKey, ProvingKey, ProgramManager as ProgramManager$1, RecordPlaintext, verifyFunctionExecution } from '@provablehq/wasm/testnet.js';
+import { PrivateKey, RecordCiphertext, Program, Plaintext, Address, Transaction, Metadata, VerifyingKey, ProvingKey, ProgramManager as ProgramManager$1, RecordPlaintext, verifyFunctionExecution } from '@provablehq/wasm/testnet.js';
 
 function logAndThrow(message) {
     console.error(message);
@@ -37,12 +37,12 @@ async function post(url, options) {
  *
  * @param {string} host
  * @example
- * // Connection to a local node
- * const localNetworkClient = new AleoNetworkClient("http://localhost:3030");
+ * // Connection to a local node.
+ * const localNetworkClient = new AleoNetworkClient("http://0.0.0.0:3030", undefined, account);
  *
  * // Connection to a public beacon node
  * const account = Account.fromCiphertext(process.env.ciphertext, process.env.password);
- * const publicnetworkClient = new AleoNetworkClient("http://localhost:3030", undefined, account);
+ * const publicNetworkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined, account);
  */
 class AleoNetworkClient {
     host;
@@ -56,15 +56,18 @@ class AleoNetworkClient {
         else {
             this.headers = {
                 // This is replaced by the actual version by a Rollup plugin
-                "X-Aleo-SDK-Version": "0.8.6",
+                "X-Aleo-SDK-Version": "0.8.8",
             };
         }
     }
     /**
      * Set an account to use in networkClient calls
      *
-     * @param {Account} account
+     * @param {Account} account Set an account to use for record scanning functions.
      * @example
+     * import { Account, AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1");
      * const account = new Account();
      * networkClient.setAccount(account);
      */
@@ -85,6 +88,15 @@ class AleoNetworkClient {
      *
      * @param {string} host The address of a node hosting the Aleo API
      * @param host
+     *
+     * @example
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a networkClient that connects to a local node.
+     * const networkClient = new AleoNetworkClient("http://0.0.0.0:3030", undefined);
+     *
+     * // Set the host to a public node.
+     * networkClient.setHost("http://api.explorer.provable.com/v1");
      */
     setHost(host) {
         this.host = host + "/testnet";
@@ -92,7 +104,7 @@ class AleoNetworkClient {
     /**
      * Fetches data from the Aleo network and returns it as a JSON object.
      *
-     * @param url
+     * @param url The URL to fetch data from.
      */
     async fetchData(url = "/") {
         try {
@@ -132,8 +144,18 @@ class AleoNetworkClient {
      * @param {number} maxMicrocredits - The maximum number of microcredits to search for
      * @param {string[]} nonces - The nonces of already found records to exclude from the search
      * @param {string | PrivateKey} privateKey - An optional private key to use to find unspent records.
+     * @returns {Promise<Array<RecordPlaintext>>} An array of records belonging to the account configured in the network client.
      *
      * @example
+     * import { Account, AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Import an account from a ciphertext and password.
+     * const account = Account.fromCiphertext(process.env.ciphertext, process.env.password);
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * networkClient.setAccount(account);
+     *
      * // Find specific amounts
      * const startHeight = 500000;
      * const amounts = [600000, 1000000];
@@ -324,8 +346,17 @@ class AleoNetworkClient {
      * @param {number} maxMicrocredits - The maximum number of microcredits to search for
      * @param {string[]} nonces - The nonces of already found records to exclude from the search
      * @param {string | PrivateKey} privateKey - An optional private key to use to find unspent records.
+     * @returns {Promise<Array<RecordPlaintext>>} An array of unspent records belonging to the account configured in the network client.
      *
      * @example
+     * import { Account, AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * const account = Account.fromCiphertext(process.env.ciphertext, process.env.password);
+     *
+     * // Create a network client and set an account to search for records with.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * networkClient.setAccount(account);
+     *
      * // Find specific amounts
      * const startHeight = 500000;
      * const endHeight = 550000;
@@ -342,7 +373,9 @@ class AleoNetworkClient {
     /**
      * Returns the contents of the block at the specified block height.
      *
-     * @param {number} blockHeight
+     * @param {number} blockHeight - The height of the block to fetch
+     * @returns {Promise<BlockJSON>} A javascript object containing the block at the specified height
+     *
      * @example
      * const block = networkClient.getBlock(1234);
      */
@@ -358,8 +391,13 @@ class AleoNetworkClient {
     /**
      * Returns the contents of the block with the specified hash.
      *
-     * @param {string} blockHash
+     * @param {string} blockHash The hash of the block to fetch.
+     * @returns {Promise<BlockJSON>} A javascript object representation of the block matching the hash.
+     *
      * @example
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
      * const block = networkClient.getBlockByHash("ab19dklwl9vp63zu3hwg57wyhvmqf92fx5g8x0t6dr72py8r87pxupqfne5t9");
      */
     async getBlockByHash(blockHash) {
@@ -372,12 +410,24 @@ class AleoNetworkClient {
         }
     }
     /**
-     * Returns a range of blocks between the specified block heights.
+     * Returns a range of blocks between the specified block heights. A maximum of 50 blocks can be fetched at a time.
+     *
+     * @param {number} start Starting block to fetch.
+     * @param {number} end Ending block to fetch. This cannot be more than 50 blocks ahead of the start block.
+     * @returns {Promise<Array<BlockJSON>>} An array of block objects
      *
-     * @param {number} start
-     * @param {number} end
      * @example
-     * const blockRange = networkClient.getBlockRange(2050, 2100);
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Fetch 50 blocks.
+     * const (start, end) = (2050, 2100);
+     * const blockRange = networkClient.getBlockRange(start, end);
+     *
+     * let cursor = start;
+     * blockRange.forEach((block) => {
+     *   assert(block.height == cursor);
+     *   cursor += 1;
+     *  }
      */
     async getBlockRange(start, end) {
         try {
@@ -390,8 +440,21 @@ class AleoNetworkClient {
     /**
      * Returns the deployment transaction id associated with the specified program.
      *
-     * @param {Program | string} program
-     * @returns {TransactionJSON}
+     * @param {Program | string} program The name of the deployed program OR a wasm Program object.
+     * @returns {Promise<string>} The transaction ID of the deployment transaction.
+     *
+     * @example
+     * import { AleoNetworkClient } from "@provablehq/sdk/testnet.js";
+     *
+     * // Get the transaction ID of the deployment transaction for a program.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const transactionId = networkClient.getDeploymentTransactionIDForProgram("hello_hello.aleo");
+     *
+     * // Get the transaction data for the deployment transaction.
+     * const transaction = networkClient.getTransactionObject(transactionId);
+     *
+     * // Get the verifying keys for the functions in the deployed program.
+     * const verifyingKeys = transaction.verifyingKeys();
      */
     async getDeploymentTransactionIDForProgram(program) {
         if (program instanceof Program) {
@@ -406,10 +469,21 @@ class AleoNetworkClient {
         }
     }
     /**
-     * Returns the deployment transaction associated with a specified program.
+     * Returns the deployment transaction associated with a specified program as a JSON object.
      *
-     * @param {Program | string} program
-     * @returns {TransactionJSON}
+     * @param {Program | string} program The name of the deployed program OR a wasm Program object.
+     * @returns {Promise<Transaction>} JSON representation of the deployment transaction.
+     *
+     * @example
+     * import { AleoNetworkClient, DeploymentJSON } from "@provablehq/sdk/testnet.js";
+     *
+     * // Get the transaction ID of the deployment transaction for a program.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const transaction = networkClient.getDeploymentTransactionForProgram("hello_hello.aleo");
+     *
+     * // Get the verifying keys for each function in the deployment.
+     * const deployment = <DeploymentJSON>transaction.deployment;
+     * const verifyingKeys = deployment.verifying_keys;
      */
     async getDeploymentTransactionForProgram(program) {
         if (program instanceof Program) {
@@ -426,8 +500,21 @@ class AleoNetworkClient {
     /**
      * Returns the deployment transaction associated with a specified program as a wasm object.
      *
-     * @param {Program | string} program
-     * @returns {TransactionJSON}
+     * @param {Program | string} program The name of the deployed program OR a wasm Program object.
+     * @returns {Promise<Transaction>} Wasm object representation of the deployment transaction.
+     *
+     * @example
+     * import { AleoNetworkClient } from "@provablehq/sdk/testnet.js";
+     *
+     * // Get the transaction ID of the deployment transaction for a program.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const transactionId = networkClient.getDeploymentTransactionIDForProgram("hello_hello.aleo");
+     *
+     * // Get the transaction data for the deployment transaction.
+     * const transaction = networkClient.getDeploymentTransactionObjectForProgram(transactionId);
+     *
+     * // Get the verifying keys for the functions in the deployed program.
+     * const verifyingKeys = transaction.verifyingKeys();
      */
     async getDeploymentTransactionObjectForProgram(program) {
         try {
@@ -439,9 +526,16 @@ class AleoNetworkClient {
         }
     }
     /**
-     * Returns the contents of the latest block.
+     * Returns the contents of the latest block as JSON.
+     *
+     * @returns {Promise<BlockJSON>} A javascript object containing the latest block
      *
      * @example
+     * import { AleoNetworkClient } from "@provablehq/sdk/testnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
      * const latestHeight = networkClient.getLatestBlock();
      */
     async getLatestBlock() {
@@ -456,6 +550,16 @@ class AleoNetworkClient {
      * Returns the latest committee.
      *
      * @returns {Promise<object>} A javascript object containing the latest committee
+     *
+     * @example
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
+     * // Create a network client and get the latest committee.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const latestCommittee = await networkClient.getLatestCommittee();
      */
     async getLatestCommittee() {
         try {
@@ -466,14 +570,20 @@ class AleoNetworkClient {
         }
     }
     /**
-     * Returns the committe at the specified block height.
-     *
-     * @param {number} blockHeight
+     * Returns the committee at the specified block height.
      *
+     * @param {number} blockHeight - The height of the block to fetch the committee for
      * @returns {Promise<object>} A javascript object containing the committee
      *
      * @example
-     * const committee = await networkClient.getCommitteByBlockHeight(1234);
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
+     * // Create a network client and get the committee for a specific block.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const committee = await networkClient.getCommitteeByBlockHeight(1234);
      */
     async getCommitteeByBlockHeight(blockHeight) {
         try {
@@ -486,7 +596,14 @@ class AleoNetworkClient {
     /**
      * Returns the latest block height.
      *
+     * @returns {Promise<number>} The latest block height.
+     *
      * @example
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
      * const latestHeight = networkClient.getLatestHeight();
      */
     async getLatestHeight() {
@@ -500,8 +617,16 @@ class AleoNetworkClient {
     /**
      * Returns the latest block hash.
      *
+     * @returns {Promise<string>} The latest block hash.
+     *
      * @example
-     * const latestHash - newtworkClient.getLatestBlockHash();
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
+     * // Get the latest block hash.
+     * const latestHash = networkClient.getLatestBlockHash();
      */
     async getLatestBlockHash() {
         try {
@@ -515,9 +640,14 @@ class AleoNetworkClient {
      * Returns the source code of a program given a program ID.
      *
      * @param {string} programId The program ID of a program deployed to the Aleo Network
-     * @return {Promise<string>} Source code of the program
+     * @returns {Promise<string>} Source code of the program
      *
      * @example
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
      * const program = networkClient.getProgram("hello_hello.aleo");
      * const expectedSource = "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"
      * assert.equal(program, expectedSource);
@@ -534,9 +664,14 @@ class AleoNetworkClient {
      * Returns a program object from a program ID or program source code.
      *
      * @param {string} inputProgram The program ID or program source code of a program deployed to the Aleo Network
-     * @return {Promise<Program>} Source code of the program
+     * @returns {Promise<Program>} Source code of the program
      *
      * @example
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
      * const programID = "hello_hello.aleo";
      * const programSource = "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"
      *
@@ -545,7 +680,7 @@ class AleoNetworkClient {
      * const programObjectFromSource = await networkClient.getProgramObject(programSource);
      *
      * // Both program objects should be equal
-     * assert.equal(programObjectFromID.to_string(), programObjectFromSource.to_string());
+     * assert(programObjectFromID.to_string() === programObjectFromSource.to_string());
      */
     async getProgramObject(inputProgram) {
         try {
@@ -567,12 +702,17 @@ class AleoNetworkClient {
      * @returns {Promise<ProgramImports>} Object of the form { "program_id": "program_source", .. } containing program id & source code for all program imports
      *
      * @example
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
      * const double_test_source = "import multiply_test.aleo;\n\nprogram double_test.aleo;\n\nfunction double_it:\n    input r0 as u32.private;\n    call multiply_test.aleo/multiply 2u32 r0 into r1;\n    output r1 as u32.private;\n"
      * const double_test = Program.fromString(double_test_source);
      * const expectedImports = {
      *     "multiply_test.aleo": "program multiply_test.aleo;\n\nfunction multiply:\n    input r0 as u32.public;\n    input r1 as u32.private;\n    mul r0 r1 into r2;\n    output r2 as u32.private;\n"
      * }
      *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
      * // Imports can be fetched using the program ID, source code, or program object
      * let programImports = await networkClient.getProgramImports("double_test.aleo");
      * assert.deepStrictEqual(programImports, expectedImports);
@@ -619,8 +759,13 @@ class AleoNetworkClient {
      * @returns {string[]} - The list of program names that the program imports
      *
      * @example
-     * const programImportsNames = networkClient.getProgramImports("double_test.aleo");
-     * const expectedImportsNames = ["multiply_test.aleo"];
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
+     * const programImportsNames = networkClient.getProgramImports("wrapped_credits.aleo");
+     * const expectedImportsNames = ["credits.aleo"];
      * assert.deepStrictEqual(programImportsNames, expectedImportsNames);
      */
     async getProgramImportNames(inputProgram) {
@@ -636,7 +781,14 @@ class AleoNetworkClient {
      * Returns the names of the mappings of a program.
      *
      * @param {string} programId - The program ID to get the mappings of (e.g. "credits.aleo")
+     * @returns {Promise<Array<string>>} - The names of the mappings of the program.
+     *
      * @example
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
      * const mappings = networkClient.getProgramMappingNames("credits.aleo");
      * const expectedMappings = [
      *   "committee",
@@ -662,14 +814,19 @@ class AleoNetworkClient {
      *
      * @param {string} programId - The program ID to get the mapping value of (e.g. "credits.aleo")
      * @param {string} mappingName - The name of the mapping to get the value of (e.g. "account")
-     * @param {string | Plaintext} key - The key of the mapping to get the value of (e.g. "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px")
-     * @return {Promise<string>} String representation of the value of the mapping
+     * @param {string | Plaintext} key - The key to look up in the mapping (e.g. an address for the "account" mapping)
+     * @returns {Promise<string>} String representation of the value of the mapping
      *
      * @example
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
      * // Get public balance of an account
      * const mappingValue = networkClient.getMappingValue("credits.aleo", "account", "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px");
      * const expectedValue = "0u64";
-     * assert.equal(mappingValue, expectedValue);
+     * assert(mappingValue === expectedValue);
      */
     async getProgramMappingValue(programId, mappingName, key) {
         try {
@@ -681,11 +838,19 @@ class AleoNetworkClient {
         }
     }
     /**
-     * Returns the value of a mapping as a wasm Plaintext object. Returning an
-     * object in this format allows it to be converted to a Js type and for its
-     * internal members to be inspected if it's a struct or array.
+     * Returns the value of a mapping as a wasm Plaintext object. Returning an object in this format allows it to be converted to a Js type and for its internal members to be inspected if it's a struct or array.
+     *
+     * @param {string} programId - The program ID to get the mapping value of (e.g. "credits.aleo")
+     * @param {string} mappingName - The name of the mapping to get the value of (e.g. "bonded")
+     * @param {string | Plaintext} key - The key to look up in the mapping (e.g. an address for the "bonded" mapping)
+     * @returns {Promise<Plaintext>} String representation of the value of the mapping
      *
      * @example
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
      * // Get the bond state as an account.
      * const unbondedState = networkClient.getMappingPlaintext("credits.aleo", "bonded", "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px");
      *
@@ -702,15 +867,9 @@ class AleoNetworkClient {
      *
      * const expectedState = {
      *     validator: "aleo1u6940v5m0fzud859xx2c9tj2gjg6m5qrd28n636e6fdd2akvfcgqs34mfd",
-     *     microcredits: BigInt("9007199254740991")
+     *     microcredits: BigInt(9007199254740991)
      * };
      * assert.equal(unbondedState, expectedState);
-     *
-     * @param {string} programId - The program ID to get the mapping value of (e.g. "credits.aleo")
-     * @param {string} mappingName - The name of the mapping to get the value of (e.g. "account")
-     * @param {string | Plaintext} key - The key of the mapping to get the value of (e.g. "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px")
-     *
-     * @return {Promise<string>} String representation of the value of the mapping
      */
     async getProgramMappingPlaintext(programId, mappingName, key) {
         try {
@@ -725,15 +884,25 @@ class AleoNetworkClient {
     /**
      * Returns the public balance of an address from the account mapping in credits.aleo
      *
-     * @param {string} address
+     * @param {Address | string} address A string or wasm object representing an address.
+     * @returns {Promise<number>} The public balance of the address in microcredits.
      *
      * @example
-     * const account = new Account();
-     * const publicBalance = networkClient.getPublicBalance(account.address());
+     * import { AleoNetworkClient, Account } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
+     * // Get the balance of an account from either an address object or address string.
+     * const account = Account.fromCiphertext(process.env.ciphertext, process.env.password);
+     * const publicBalance = await networkClient.getPublicBalance(account.address());
+     * const publicBalanceFromString = await networkClient.getPublicBalance(account.address().to_string());
+     * assert(publicBalance === publicBalanceFromString);
      */
     async getPublicBalance(address) {
         try {
-            const balanceStr = await this.getProgramMappingValue('credits.aleo', 'account', address.to_string());
+            const addressString = address instanceof Address ? address.to_string() : address;
+            const balanceStr = await this.getProgramMappingValue('credits.aleo', 'account', addressString);
             return balanceStr ? parseInt(balanceStr) : 0;
         }
         catch (error) {
@@ -743,7 +912,15 @@ class AleoNetworkClient {
     /**
      * Returns the latest state/merkle root of the Aleo blockchain.
      *
+     * @returns {Promise<string>} A string representing the latest state root of the Aleo blockchain.
+     *
      * @example
+     * import { AleoNetworkClient, Account } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
+     * // Get the latest state root.
      * const stateRoot = networkClient.getStateRoot();
      */
     async getStateRoot() {
@@ -757,8 +934,15 @@ class AleoNetworkClient {
     /**
      * Returns a transaction by its unique identifier.
      *
-     * @param {string} transactionId
+     * @param {string} transactionId The transaction ID to fetch.
+     * @returns {Promise<TransactionJSON>} A json representation of the transaction.
+     *
      * @example
+     * import { AleoNetworkClient, Account } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
      * const transaction = networkClient.getTransaction("at1handz9xjrqeynjrr0xay4pcsgtnczdksz3e584vfsgaz0dh0lyxq43a4wj");
      */
     async getTransaction(transactionId) {
@@ -772,9 +956,17 @@ class AleoNetworkClient {
     /**
      * Returns a confirmed transaction by its unique identifier.
      *
-     * @param {string} transactionId
+     * @param {string} transactionId The transaction ID to fetch.
+     * @returns {Promise<ConfirmedTransactionJSON>} A json object containing the confirmed transaction.
+     *
      * @example
+     * import { AleoNetworkClient, Account } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
      * const transaction = networkClient.getConfirmedTransaction("at1handz9xjrqeynjrr0xay4pcsgtnczdksz3e584vfsgaz0dh0lyxq43a4wj");
+     * assert.equal(transaction.status, "confirmed");
      */
     async getConfirmedTransaction(transactionId) {
         try {
@@ -788,13 +980,16 @@ class AleoNetworkClient {
      * Returns a transaction as a wasm object. Getting a transaction of this type will allow the ability for the inputs,
      * outputs, and records to be searched for and displayed.
      *
+     * @param {string} transactionId - The unique identifier of the transaction to fetch
+     * @returns {Promise<Transaction>} A wasm object representation of the transaction.
+     *
      * @example
      * const transactionObject = networkClient.getTransaction("at1handz9xjrqeynjrr0xay4pcsgtnczdksz3e584vfsgaz0dh0lyxq43a4wj");
      * // Get the transaction inputs as a JS array.
-     * const transactionOutputs = transactionObject.inputs(true);
+     * const transactionInputs = transactionObject.inputs(true);
      *
      * // Get the transaction outputs as a JS object.
-     * const transactionInputs = transactionObject.outputs(true);
+     * const transactionOutputs = transactionObject.outputs(true);
      *
      * // Get any records generated in transitions in the transaction as a JS object.
      * const records = transactionObject.records();
@@ -805,10 +1000,6 @@ class AleoNetworkClient {
      *
      * // Get a JS representation of all inputs, outputs, and transaction metadata.
      * const transactionSummary = transactionObject.summary();
-     *
-     * @param {string} transactionId
-     * @example
-     * const transaction = networkClient.getTransactionObject("at1handz9xjrqeynjrr0xay4pcsgtnczdksz3e584vfsgaz0dh0lyxq43a4wj");
      */
     async getTransactionObject(transactionId) {
         try {
@@ -822,8 +1013,15 @@ class AleoNetworkClient {
     /**
      * Returns the transactions present at the specified block height.
      *
-     * @param {number} blockHeight
+     * @param {number} blockHeight The block height to fetch the confirmed transactions at.
+     * @returns {Promise<Array<ConfirmedTransactionJSON>>} An array of confirmed transactions (in JSON format) for the block height.
+     *
      * @example
+     * import { AleoNetworkClient, Account } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
      * const transactions = networkClient.getTransactions(654);
      */
     async getTransactions(blockHeight) {
@@ -837,9 +1035,16 @@ class AleoNetworkClient {
     /**
      * Returns the confirmed transactions present in the block with the specified block hash.
      *
-     * @param {string} blockHash
+     * @param {string} blockHash The block hash to fetch the confirmed transactions at.
+     * @returns {Promise<Array<ConfirmedTransactionJSON>>} An array of confirmed transactions (in JSON format) for the block hash.
+     *
      * @example
-     * const transactions = networkClient.getTransactionsByHash("ab19dklwl9vp63zu3hwg57wyhvmqf92fx5g8x0t6dr72py8r87pxupqfne5t9");
+     * import { AleoNetworkClient, Account } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
+     * const transactions = networkClient.getTransactionsByBlockHash("ab19dklwl9vp63zu3hwg57wyhvmqf92fx5g8x0t6dr72py8r87pxupqfne5t9");
      */
     async getTransactionsByBlockHash(blockHash) {
         try {
@@ -854,7 +1059,15 @@ class AleoNetworkClient {
     /**
      * Returns the transactions in the memory pool. This method requires access to a validator's REST API.
      *
+     * @returns {Promise<Array<TransactionJSON>>} An array of transactions (in JSON format) currently in the mempool.
+     *
      * @example
+     * import { AleoNetworkClient, Account } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     *
+     * // Get the current transactions in the mempool.
      * const transactions = networkClient.getTransactionsInMempool();
      */
     async getTransactionsInMempool() {
@@ -867,7 +1080,8 @@ class AleoNetworkClient {
     }
     /**
      * Returns the transition ID of the transition corresponding to the ID of the input or output.
-     * @param {string} inputOrOutputID - ID of the input or output.
+     * @param {string} inputOrOutputID - The unique identifier of the input or output to find the transition ID for
+     * @returns {Promise<string>} - The transition ID of the input or output ID.
      *
      * @example
      * const transitionId = networkClient.getTransitionId("2429232855236830926144356377868449890830704336664550203176918782554219952323field");
@@ -883,8 +1097,8 @@ class AleoNetworkClient {
     /**
      * Submit an execute or deployment transaction to the Aleo network.
      *
-     * @param {Transaction | string} transaction  - The transaction to submit to the network
-     * @returns {string} - The transaction id of the submitted transaction or the resulting error
+     * @param {Transaction | string} transaction - The transaction to submit, either as a Transaction object or string representation
+     * @returns {Promise<string>} - The transaction id of the submitted transaction or the resulting error
      */
     async submitTransaction(transaction) {
         const transaction_string = transaction instanceof Transaction ? transaction.toString() : transaction;
@@ -910,7 +1124,8 @@ class AleoNetworkClient {
     /**
      * Submit a solution to the Aleo network.
      *
-     * @param {string} solution The string representation of the solution desired to be submitted to the network.
+     * @param {string} solution - The string representation of the solution to submit
+     * @returns {Promise<string>} The solution id of the submitted solution or the resulting error.
      */
     async submitSolution(solution) {
         try {
@@ -933,9 +1148,31 @@ class AleoNetworkClient {
         }
     }
     /**
-     * Await a transaction to be confirmed on the Aleo network.
+     * Await a submitted transaction to be confirmed or rejected on the Aleo network.
+     *
+     * @param {string} transactionId - The transaction ID to wait for confirmation
+     * @param {number} checkInterval - The interval in milliseconds to check for confirmation (default: 2000)
+     * @param {number} timeout - The maximum time in milliseconds to wait for confirmation (default: 45000)
+     * @returns {Promise<Transaction>} The confirmed transaction object that returns if the transaction is confirmed.
+     *
+     * @example
+     * import { AleoNetworkClient, Account, ProgramManager } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a network client and program manager.
+     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const programManager = new ProgramManager(networkClient);
      *
-     * @param {string} solution The string representation of the solution desired to be submitted to the network.
+     * // Set the account for the program manager.
+     * programManager.setAccount(Account.fromCiphertext(process.env.ciphertext, process.env.password));
+     *
+     * // Build a transfer transaction.
+     * const tx = await programManager.buildTransferPublicTransaction(100, "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", 0);
+     *
+     * // Submit the transaction to the network.
+     * const transactionId = await networkClient.submitTransaction(tx);
+     *
+     * // Wait for the transaction to be confirmed.
+     * const transaction = await networkClient.waitForTransactionConfirmation(transactionId);
      */
     async waitForTransactionConfirmation(transactionId, checkInterval = 2000, // Poll every 2 seconds
     timeout = 45000 // Timeout after 45 seconds
@@ -1473,11 +1710,20 @@ class ProgramManager {
      * @param { RecordProvider | undefined } recordProvider A record provider that implements {@link RecordProvider} interface
      */
     constructor(host, keyProvider, recordProvider) {
-        this.host = host ? host : 'https://api.explorer.provable.com/v1';
+        this.host = host ? host : "https://api.explorer.provable.com/v1";
         this.networkClient = new AleoNetworkClient(this.host);
         this.keyProvider = keyProvider ? keyProvider : new AleoKeyProvider();
         this.recordProvider = recordProvider;
     }
+    /**
+     * Check if the fee is sufficient to pay for the transaction
+     */
+    async checkFee(address, feeAmount) {
+        const balance = BigInt(await this.networkClient.getPublicBalance(address));
+        if (feeAmount > balance) {
+            throw Error(`The desired execution requires a fee of ${feeAmount} microcredits, but the account paying the fee has ${balance} microcredits available.`);
+        }
+    }
     /**
      * Set the account to use for transaction submission to the Aleo network
      *
@@ -1515,34 +1761,51 @@ class ProgramManager {
      * Builds a deployment transaction for submission to the Aleo network.
      *
      * @param {string} program Program source code
-     * @param {number} fee Fee to pay for the transaction
+     * @param {number} priorityFee The optional priority fee to be paid for that transaction.
      * @param {boolean} privateFee Use a private record to pay the fee. If false this will use the account's public credit balance
-     * @param {RecordSearchParams | undefined} recordSearchParams Optional parameters for searching for a record to use
-     * pay the deployment fee
+     * @param {RecordSearchParams | undefined} recordSearchParams Optional parameters for searching for a record to use pay the deployment fee
      * @param {string | RecordPlaintext | undefined} feeRecord Optional Fee record to use for the transaction
      * @param {PrivateKey | undefined} privateKey Optional private key to use for the 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 { AleoKeyProvider, ProgramManager, NetworkRecordProvider } from "@provablehq/sdk/mainnet.js";
+     *
      * // Create a new NetworkClient, KeyProvider, and RecordProvider
-     * const networkClient = new AleoNetworkClient("https://api.explorer.provable.com/v1");
      * 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 fee = 1.2;
+     * const priorityFee = 0.0;
      *
      * // Create the deployment transaction.
      * const tx = await programManager.buildDeploymentTransaction(program, fee, false);
-     */
-    async buildDeploymentTransaction(program, fee, privateFee, recordSearchParams, feeRecord, privateKey) {
+     * 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 buildDeploymentTransaction(program, priorityFee, privateFee, recordSearchParams, feeRecord, 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 {
-            const programObject = Program.fromString(program);
             let programSource;
             try {
                 programSource = await this.networkClient.getProgram(programObject.id());
@@ -1551,8 +1814,8 @@ class ProgramManager {
                 // 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 (`Program ${programObject.id()} already exists on the network, please rename your program`);
+            if (typeof programSource === "string") {
+                throw Error(`Program ${programObject.id()} already exists on the network, please rename your program`);
             }
         }
         catch (e) {
@@ -1560,15 +1823,18 @@ class ProgramManager {
         }
         // 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") {
+        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");
+            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 ? await this.getCreditsRecord(fee, [], feeRecord, recordSearchParams) : undefined;
+            feeRecord = privateFee
+                ? (await this.getCreditsRecord(priorityFee, [], feeRecord, recordSearchParams))
+                : 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.`);
@@ -1576,7 +1842,9 @@ class ProgramManager {
         // Get the proving and verifying keys from the key provider
         let feeKeys;
         try {
-            feeKeys = privateFee ? await this.keyProvider.feePrivateKeys() : await this.keyProvider.feePublicKeys();
+            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.`);
@@ -1590,42 +1858,59 @@ class ProgramManager {
         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 and submit it to the network
-        return await ProgramManager$1.buildDeploymentTransaction(deploymentPrivateKey, program, fee, feeRecord, this.host, imports, feeProvingKey, feeVerifyingKey);
+        // Build a deployment transaction
+        return await ProgramManager$1.buildDeploymentTransaction(deploymentPrivateKey, program, priorityFee, feeRecord, this.host, imports, feeProvingKey, feeVerifyingKey);
     }
     /**
      * Deploy an Aleo program to the Aleo network
      *
      * @param {string} program Program source code
-     * @param {number} fee Fee to pay for the transaction
+     * @param {number} priorityFee The optional fee to be paid for the transaction
      * @param {boolean} privateFee Use a private record to pay the fee. If false this will use the account's public credit balance
-     * @param {RecordSearchParams | undefined} recordSearchParams Optional parameters for searching for a record to use
-     * pay the deployment fee
+     * @param {RecordSearchParams | undefined} recordSearchParams Optional parameters for searching for a record to used pay the deployment fee
      * @param {string | RecordPlaintext | undefined} feeRecord Optional Fee record to use for the transaction
      * @param {PrivateKey | undefined} privateKey Optional private key to use for the 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 { AleoKeyProvider, ProgramManager, NetworkRecordProvider } from "@provablehq/sdk/mainnet.js";
+     *
      * // Create a new NetworkClient, KeyProvider, and RecordProvider
-     * const networkClient = new AleoNetworkClient("https://api.explorer.provable.com/v1");
      * 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);
      *
      * // Define a fee in credits
-     * const fee = 1.2;
+     * const priorityFee = 0.0;
      *
      * // Deploy the program
      * const tx_id = await programManager.deploy(program, fee, false);
      *
      * // Verify the transaction was successful
-     * const transaction = await programManager.networkClient.getTransaction(tx_id);
+     * setTimeout(async () => {
+     *  const transaction = await programManager.networkClient.getTransaction(tx_id);
+     *  assert(transaction.id() === tx_id);
+     * }, 20000);
      */
-    async deploy(program, fee, privateFee, recordSearchParams, feeRecord, privateKey) {
-        const tx = await this.buildDeploymentTransaction(program, fee, privateFee, recordSearchParams, feeRecord, privateKey);
+    async deploy(program, priorityFee, privateFee, recordSearchParams, feeRecord, privateKey) {
+        const tx = (await this.buildDeploymentTransaction(program, priorityFee, privateFee, recordSearchParams, feeRecord, privateKey));
+        let feeAddress;
+        if (typeof privateKey !== "undefined") {
+            feeAddress = Address.from_private_key(privateKey);
+        }
+        else if (this.account !== undefined) {
+            feeAddress = this.account?.address();
+        }
+        else {
+            throw Error("No private key provided and no private key set in the ProgramManager. Please set an account or provide a private key.");
+        }
+        // Check if the account has sufficient credits to pay for the transaction
+        await this.checkFee(feeAddress.to_string(), tx.feeAmount());
         return await this.networkClient.submitTransaction(tx);
     }
     /**
@@ -1635,29 +1920,39 @@ class ProgramManager {
      * @returns {Promise<Transaction>} - A promise that resolves to the transaction or an error.
      *
      * @example
+     * /// Import the mainnet version of the sdk.
+     * import { AleoKeyProvider, ProgramManager, NetworkRecordProvider } from "@provablehq/sdk/mainnet.js";
+     *
      * // Create a new NetworkClient, KeyProvider, and RecordProvider using official Aleo record, key, and network providers
-     * const networkClient = new AleoNetworkClient("https://api.explorer.provable.com/v1");
      * const keyProvider = new AleoKeyProvider();
-     * keyProvider.useCache = true;
      * const recordProvider = new NetworkRecordProvider(account, networkClient);
+     * keyProvider.useCache = true;
      *
      * // Initialize a program manager with the key provider to automatically fetch keys for executions
      * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, recordProvider);
      *
      * // Build and execute the transaction
-     * const transaction = await programManager.buildExecutionTransaction({
+     * const tx = await programManager.buildExecutionTransaction({
      *   programName: "hello_hello.aleo",
      *   functionName: "hello_hello",
-     *   fee: 0.020,
+     *   priorityFee: 0.0,
      *   privateFee: false,
      *   inputs: ["5u32", "5u32"],
      *   keySearchParams: { "cacheKey": "hello_hello:hello" }
      * });
-     * const result = await programManager.networkClient.submitTransaction(transaction);
+     *
+     * // 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 buildExecutionTransaction(options) {
         // Destructure the options object to access the parameters
-        const { programName, functionName, fee, privateFee, inputs, recordSearchParams, keySearchParams, privateKey, offlineQuery } = options;
+        const { programName, functionName, priorityFee, privateFee, inputs, recordSearchParams, keySearchParams, privateKey, offlineQuery, } = options;
         let feeRecord = options.feeRecord;
         let provingKey = options.provingKey;
         let verifyingKey = options.verifyingKey;
@@ -1677,15 +1972,18 @@ class ProgramManager {
         }
         // 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") {
+        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");
+            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 ? await this.getCreditsRecord(fee, [], feeRecord, recordSearchParams) : undefined;
+            feeRecord = privateFee
+                ? (await this.getCreditsRecord(priorityFee, [], feeRecord, recordSearchParams))
+                : 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.`);
@@ -1693,7 +1991,9 @@ class ProgramManager {
         // Get the fee proving and verifying keys from the key provider
         let feeKeys;
         try {
-            feeKeys = privateFee ? await this.keyProvider.feePrivateKeys() : await this.keyProvider.feePublicKeys();
+            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.`);
@@ -1702,7 +2002,7 @@ class ProgramManager {
         // If the function proving and verifying keys are not provided, attempt to find them using the key provider
         if (!provingKey || !verifyingKey) {
             try {
-                [provingKey, verifyingKey] = await this.keyProvider.functionKeys(keySearchParams);
+                [provingKey, verifyingKey] = (await this.keyProvider.functionKeys(keySearchParams));
             }
             catch (e) {
                 console.log(`Function keys not found. Key finder response: '${e}'. The function keys will be synthesized`);
@@ -1712,44 +2012,63 @@ class ProgramManager {
         const numberOfImports = Program.fromString(program).getImports().length;
         if (numberOfImports > 0 && !imports) {
             try {
-                imports = await this.networkClient.getProgramImports(programName);
+                imports = (await this.networkClient.getProgramImports(programName));
             }
             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 an execution transaction and submit it to the network
-        return await ProgramManager$1.buildExecutionTransaction(executionPrivateKey, program, functionName, inputs, fee, feeRecord, this.host, imports, provingKey, verifyingKey, feeProvingKey, feeVerifyingKey, offlineQuery);
+        // Build an execution transaction
+        return await ProgramManager$1.buildExecutionTransaction(executionPrivateKey, program, functionName, inputs, priorityFee, feeRecord, this.host, imports, provingKey, verifyingKey, feeProvingKey, feeVerifyingKey, offlineQuery);
     }
     /**
      * Builds an execution transaction for submission to the Aleo network.
      *
      * @param {ExecuteOptions} options - The options for the execution transaction.
-     * @returns {Promise<Transaction>} - A promise that resolves to the transaction or an error.
+     * @returns {Promise<string>} - The transaction id
      *
      * @example
+     * /// Import the mainnet version of the sdk.
+     * import { AleoKeyProvider, ProgramManager, NetworkRecordProvider } from "@provablehq/sdk/mainnet.js";
+     *
      * // Create a new NetworkClient, KeyProvider, and RecordProvider using official Aleo record, key, and network providers
-     * const networkClient = new AleoNetworkClient("https://api.explorer.provable.com/v1");
      * const keyProvider = new AleoKeyProvider();
-     * keyProvider.useCache = true;
      * const recordProvider = new NetworkRecordProvider(account, networkClient);
+     * keyProvider.useCache = true;
      *
      * // Initialize a program manager with the key provider to automatically fetch keys for executions
      * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, recordProvider);
      *
      * // Build and execute the transaction
-     * const transaction = await programManager.execute({
+     * const tx_id = await programManager.execute({
      *   programName: "hello_hello.aleo",
      *   functionName: "hello_hello",
-     *   fee: 0.020,
+     *   priorityFee: 0.0,
      *   privateFee: false,
      *   inputs: ["5u32", "5u32"],
      *   keySearchParams: { "cacheKey": "hello_hello:hello" }
      * });
-     * const result = await programManager.networkClient.submitTransaction(transaction);
+     *
+     * // Verify the transaction was successful
+     * setTimeout(async () => {
+     *  const transaction = await programManager.networkClient.getTransaction(tx_id);
+     *  assert(transaction.id() === tx_id);
+     * }, 10000);
      */
     async execute(options) {
         const tx = await this.buildExecutionTransaction(options);
+        let feeAddress;
+        if (typeof options.privateKey !== "undefined") {
+            feeAddress = Address.from_private_key(options.privateKey);
+        }
+        else if (this.account !== undefined) {
+            feeAddress = this.account?.address();
+        }
+        else {
+            throw Error("No private key provided and no private key set in the ProgramManager. Please set an account or provide a private key.");
+        }
+        // Check if the account has sufficient credits to pay for the transaction
+        await this.checkFee(feeAddress.to_string(), tx.feeAmount());
         return await this.networkClient.submitTransaction(tx);
     }
     /**
@@ -1758,23 +2077,22 @@ class ProgramManager {
      * @param {string} program Program source code containing the function to be executed
      * @param {string} function_name Function name to execute
      * @param {string[]} inputs Inputs to the function
-     * @param {number} proveExecution Whether to prove the execution of the function and return an execution transcript
-     * that contains the proof.
+     * @param {number} proveExecution Whether to prove the execution of the function and return an execution transcript that contains the proof.
      * @param {string[] | undefined} imports Optional imports to the program
-     * @param {KeySearchParams | undefined} keySearchParams Optional parameters for finding the matching proving &
-     * verifying keys for the function
+     * @param {KeySearchParams | undefined} keySearchParams Optional parameters for finding the matching proving & verifying keys for the function
      * @param {ProvingKey | undefined} provingKey Optional proving key to use for the transaction
      * @param {VerifyingKey | undefined} verifyingKey Optional verifying key to use for the transaction
      * @param {PrivateKey | undefined} privateKey Optional private key to use for the transaction
      * @param {OfflineQuery | undefined} offlineQuery Optional offline query if creating transactions in an offline environment
-     * @returns {Promise<string>}
+     * @returns {Promise<ExecutionResponse>} The execution response containing the outputs of the function and the proof if the program is proved.
      *
      * @example
-     * import { Account, Program } from '@provablehq/sdk';
+     * /// Import the mainnet version of the sdk used to build executions.
+     * import { Account, ProgramManager } from "@provablehq/sdk/mainnet.js";
      *
      * /// Create the source for the "helloworld" program
      * const program = "program helloworld.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();
+     * const programManager = new ProgramManager(undefined, undefined, undefined);
      *
      * /// Create a temporary account for the execution of the program
      * const account = new Account();
@@ -1788,16 +2106,17 @@ class ProgramManager {
     async run(program, function_name, inputs, proveExecution, imports, keySearchParams, provingKey, verifyingKey, privateKey, offlineQuery) {
         // 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") {
+        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");
+            throw "No private key provided and no private key set in the ProgramManager";
         }
         // If the function proving and verifying keys are not provided, attempt to find them using the key provider
         if (!provingKey || !verifyingKey) {
             try {
-                [provingKey, verifyingKey] = await this.keyProvider.functionKeys(keySearchParams);
+                [provingKey, verifyingKey] = (await this.keyProvider.functionKeys(keySearchParams));
             }
             catch (e) {
                 console.log(`Function keys not found. Key finder response: '${e}'. The function keys will be synthesized`);
@@ -1814,29 +2133,57 @@ class ProgramManager {
      *
      * @param {RecordPlaintext | string} recordOne First credits record to join
      * @param {RecordPlaintext | string} recordTwo Second credits record to join
-     * @param {number} fee Fee in credits pay for the join transaction
+     * @param {number} priorityFee The optional priority fee to be paid for the transaction
      * @param {boolean} privateFee Use a private record to pay the fee. If false this will use the account's public credit balance
-     * @param {RecordSearchParams | undefined} recordSearchParams Optional parameters for finding the fee record to use
-     * to pay the fee for the join transaction
+     * @param {RecordSearchParams | undefined} recordSearchParams Optional parameters for finding the fee record to use to pay the fee for the join transaction
      * @param {RecordPlaintext | string | undefined} feeRecord Fee record to use for the join transaction
      * @param {PrivateKey | undefined} privateKey Private key to use for the join transaction
      * @param {OfflineQuery | undefined} offlineQuery Optional offline query if creating transactions in an offline environment
-     * @returns {Promise<string>}
+     * @returns {Promise<string>} The transaction id
+     *
+     * @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 executions
+     * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, recordProvider);
+     * const record_1 = "{  owner: aleo184vuwr5u7u0ha5f5k44067dd2uaqewxx6pe5ltha5pv99wvhfqxqv339h4.private,  microcredits: 45000000u64.private,  _nonce: 4106205762862305308495708971985748592380064201230396559307556388725936304984group.public}"
+     * const record_2 = "{  owner: aleo184vuwr5u7u0ha5f5k44067dd2uaqewxx6pe5ltha5pv99wvhfqxqv339h4.private,  microcredits: 45000000u64.private,  _nonce: 1540945439182663264862696551825005342995406165131907382295858612069623286213group.public}"
+     * const tx_id = await programManager.join(record_1, record_2, 0.05, false);
+     *
+     * // Verify the transaction was successful
+     * setTimeout(async () => {
+     *  const transaction = await programManager.networkClient.getTransaction(tx_id);
+     *  assert(transaction.id() === tx_id);
+     * }, 10000);
      */
-    async join(recordOne, recordTwo, fee, privateFee, recordSearchParams, feeRecord, privateKey, offlineQuery) {
-        // Get the private key from the account if it is not provided in the parameters
+    async join(recordOne, recordTwo, priorityFee, privateFee, recordSearchParams, feeRecord, privateKey, offlineQuery) {
+        // Get the private key from the account if it is not provided in the parameters and assign the fee address
         let executionPrivateKey = privateKey;
-        if (typeof privateKey === "undefined" && typeof this.account !== "undefined") {
+        let feeAddress;
+        if (typeof privateKey === "undefined" &&
+            typeof this.account !== "undefined") {
             executionPrivateKey = this.account.privateKey();
+            feeAddress = this.account?.address();
         }
-        if (typeof executionPrivateKey === "undefined") {
-            throw ("No private key provided and no private key set in the ProgramManager");
+        else if (typeof executionPrivateKey === "undefined") {
+            throw "No private key provided and no private key set in the ProgramManager";
+        }
+        else {
+            feeAddress = Address.from_private_key(executionPrivateKey);
         }
         // Get the proving and verifying keys from the key provider
         let feeKeys;
         let joinKeys;
         try {
-            feeKeys = privateFee ? await this.keyProvider.feePrivateKeys() : await this.keyProvider.feePublicKeys();
+            feeKeys = privateFee
+                ? await this.keyProvider.feePrivateKeys()
+                : await this.keyProvider.feePublicKeys();
             joinKeys = await this.keyProvider.joinKeys();
         }
         catch (e) {
@@ -1846,21 +2193,31 @@ class ProgramManager {
         const [joinProvingKey, joinVerifyingKey] = joinKeys;
         // Get the fee record from the account if it is not provided in the parameters
         try {
-            feeRecord = privateFee ? await this.getCreditsRecord(fee, [], feeRecord, recordSearchParams) : undefined;
+            feeRecord = privateFee
+                ? (await this.getCreditsRecord(priorityFee, [], feeRecord, recordSearchParams))
+                : 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.`);
         }
         // Validate the records provided are valid plaintext records
         try {
-            recordOne = recordOne instanceof RecordPlaintext ? recordOne : RecordPlaintext.fromString(recordOne);
-            recordTwo = recordTwo instanceof RecordPlaintext ? recordTwo : RecordPlaintext.fromString(recordTwo);
+            recordOne =
+                recordOne instanceof RecordPlaintext
+                    ? recordOne
+                    : RecordPlaintext.fromString(recordOne);
+            recordTwo =
+                recordTwo instanceof RecordPlaintext
+                    ? recordTwo
+                    : RecordPlaintext.fromString(recordTwo);
         }
         catch (e) {
-            logAndThrow('Records provided are not valid. Please ensure they are valid plaintext records.');
+            logAndThrow("Records provided are not valid. Please ensure they are valid plaintext records.");
         }
         // Build an execution transaction and submit it to the network
-        const tx = await ProgramManager$1.buildJoinTransaction(executionPrivateKey, recordOne, recordTwo, fee, feeRecord, this.host, joinProvingKey, joinVerifyingKey, feeProvingKey, feeVerifyingKey, offlineQuery);
+        const tx = await ProgramManager$1.buildJoinTransaction(executionPrivateKey, recordOne, recordTwo, priorityFee, feeRecord, this.host, joinProvingKey, joinVerifyingKey, feeProvingKey, feeVerifyingKey, offlineQuery);
+        // Check if the account has sufficient credits to pay for the transaction
+        await this.checkFee(feeAddress.to_string(), tx.feeAmount());
         return await this.networkClient.submitTransaction(tx);
     }
     /**
@@ -1870,29 +2227,37 @@ class ProgramManager {
      * @param {RecordPlaintext | string} amountRecord Amount record to use for the split transaction
      * @param {PrivateKey | undefined} privateKey Optional private key to use for the split transaction
      * @param {OfflineQuery | undefined} offlineQuery Optional offline query if creating transactions in an offline environment
-     * @returns {Promise<string>}
+     * @returns {Promise<string>} The transaction id
      *
      * @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 networkClient = new AleoNetworkClient("https://api.explorer.provable.com/v1");
      * 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 executions
-     * const programName = "hello_hello.aleo";
      * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, recordProvider);
      * const record = "{  owner: aleo184vuwr5u7u0ha5f5k44067dd2uaqewxx6pe5ltha5pv99wvhfqxqv339h4.private,  microcredits: 45000000u64.private,  _nonce: 4106205762862305308495708971985748592380064201230396559307556388725936304984group.public}"
      * const tx_id = await programManager.split(25000000, record);
-     * const transaction = await programManager.networkClient.getTransaction(tx_id);
+     *
+     * // Verify the transaction was successful
+     * setTimeout(async () => {
+     *  const transaction = await programManager.networkClient.getTransaction(tx_id);
+     *  assert(transaction.id() === tx_id);
+     * }, 10000);
      */
     async split(splitAmount, amountRecord, privateKey, offlineQuery) {
         // Get the private key from the account if it is not provided in the parameters
         let executionPrivateKey = privateKey;
-        if (typeof executionPrivateKey === "undefined" && typeof this.account !== "undefined") {
+        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");
+            throw "No private key provided and no private key set in the ProgramManager";
         }
         // Get the split keys from the key provider
         let splitKeys;
@@ -1905,7 +2270,10 @@ class ProgramManager {
         const [splitProvingKey, splitVerifyingKey] = splitKeys;
         // Validate the record to be split
         try {
-            amountRecord = amountRecord instanceof RecordPlaintext ? amountRecord : RecordPlaintext.fromString(amountRecord);
+            amountRecord =
+                amountRecord instanceof RecordPlaintext
+                    ? amountRecord
+                    : RecordPlaintext.fromString(amountRecord);
         }
         catch (e) {
             logAndThrow("Record provided is not valid. Please ensure it is a valid plaintext record.");
@@ -1940,7 +2308,10 @@ class ProgramManager {
         try {
             imports = await this.networkClient.getProgramImports(program);
             const keyPair = await ProgramManager$1.synthesizeKeyPair(executionPrivateKey, program, function_id, inputs, imports);
-            return [keyPair.provingKey(), keyPair.verifyingKey()];
+            return [
+                keyPair.provingKey(),
+                keyPair.verifyingKey(),
+            ];
         }
         catch (e) {
             logAndThrow(`Could not synthesize keys - error ${e.message}. Please ensure the program is valid and the inputs are correct.`);
@@ -1952,46 +2323,55 @@ class ProgramManager {
      * @param {number} amount The amount of credits to transfer
      * @param {string} recipient The recipient of the transfer
      * @param {string} transferType The type of transfer to perform - options: 'private', 'privateToPublic', 'public', 'publicToPrivate'
-     * @param {number} fee The fee to pay for the transfer
+     * @param {number} priorityFee The optional priority fee to be paid for the transaction
      * @param {boolean} privateFee Use a private record to pay the fee. If false this will use the account's public credit balance
-     * @param {RecordSearchParams | undefined} recordSearchParams Optional parameters for finding the amount and fee
-     * records for the transfer transaction
+     * @param {RecordSearchParams | undefined} recordSearchParams Optional parameters for finding the amount and fee records for the transfer transaction
      * @param {RecordPlaintext | string} amountRecord Optional amount record to use for the transfer
      * @param {RecordPlaintext | string} feeRecord Optional fee record to use for the transfer
      * @param {PrivateKey | undefined} privateKey Optional private key to use for the transfer transaction
      * @param {OfflineQuery | undefined} offlineQuery Optional offline query if creating transactions in an offline environment
-     * @returns {Promise<string>} The transaction id of the transfer transaction
+     * @returns {Promise<Transaction>} The transaction object
      *
      * @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 networkClient = new AleoNetworkClient("https://api.explorer.provable.com/v1");
      * 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 executions
-     * const programName = "hello_hello.aleo";
      * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, recordProvider);
-     * await programManager.initialize();
-     * const tx_id = await programManager.transfer(1, "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", "private", 0.2)
-     * const transaction = await programManager.networkClient.getTransaction(tx_id);
+     * const tx = await programManager.buildTransferTransaction(1, "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", "public", 0.2, false);
+     * 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 buildTransferTransaction(amount, recipient, transferType, fee, privateFee, recordSearchParams, amountRecord, feeRecord, privateKey, offlineQuery) {
+    async buildTransferTransaction(amount, recipient, transferType, priorityFee, privateFee, recordSearchParams, amountRecord, feeRecord, privateKey, offlineQuery) {
         // Validate the transfer type
         transferType = validateTransferType(transferType);
         // Get the private key from the account if it is not provided in the parameters
         let executionPrivateKey = privateKey;
-        if (typeof executionPrivateKey === "undefined" && typeof this.account !== "undefined") {
+        if (typeof executionPrivateKey === "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");
+            throw "No private key provided and no private key set in the ProgramManager";
         }
         // Get the proving and verifying keys from the key provider
         let feeKeys;
         let transferKeys;
         try {
-            feeKeys = privateFee ? await this.keyProvider.feePrivateKeys() : await this.keyProvider.feePublicKeys();
-            transferKeys = await this.keyProvider.transferKeys(transferType);
+            feeKeys = privateFee
+                ? await this.keyProvider.feePrivateKeys()
+                : await this.keyProvider.feePublicKeys();
+            transferKeys = (await this.keyProvider.transferKeys(transferType));
         }
         catch (e) {
             logAndThrow(`Error finding fee keys. Key finder response: '${e.message}'. Please ensure your key provider is configured correctly.`);
@@ -2004,57 +2384,87 @@ 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 = await this.getCreditsRecord(fee, [], amountRecord, recordSearchParams);
+                amountRecord = (await this.getCreditsRecord(priorityFee, [], amountRecord, recordSearchParams));
                 nonces.push(amountRecord.nonce());
             }
             else {
                 amountRecord = undefined;
             }
-            feeRecord = privateFee ? await this.getCreditsRecord(fee, nonces, feeRecord, recordSearchParams) : undefined;
+            feeRecord = privateFee
+                ? (await this.getCreditsRecord(priorityFee, nonces, feeRecord, recordSearchParams))
+                : 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 an execution transaction and submit it to the network
-        return await ProgramManager$1.buildTransferTransaction(executionPrivateKey, amount, recipient, transferType, amountRecord, fee, feeRecord, this.host, transferProvingKey, transferVerifyingKey, feeProvingKey, feeVerifyingKey, offlineQuery);
+        // Build an execution transaction
+        return await ProgramManager$1.buildTransferTransaction(executionPrivateKey, amount, recipient, transferType, amountRecord, priorityFee, feeRecord, this.host, transferProvingKey, transferVerifyingKey, feeProvingKey, feeVerifyingKey, offlineQuery);
     }
     /**
      * Build a transfer_public transaction to transfer credits to another account for later submission to the Aleo network
      *
      * @param {number} amount The amount of credits to transfer
      * @param {string} recipient The recipient of the transfer
-     * @param {string} transferType The type of transfer to perform - options: 'private', 'privateToPublic', 'public', 'publicToPrivate'
-     * @param {number} fee The fee to pay for the transfer
-     * @param {boolean} privateFee Use a private record to pay the fee. If false this will use the account's public credit balance
-     * @param {RecordSearchParams | undefined} recordSearchParams Optional parameters for finding the amount and fee
-     * records for the transfer transaction
-     * @param {RecordPlaintext | string} amountRecord Optional amount record to use for the transfer
-     * @param {RecordPlaintext | string} feeRecord Optional fee record to use for the transfer
+     * @param {number} priorityFee The optional priority fee to be paid for the transfer
      * @param {PrivateKey | undefined} privateKey Optional private key to use for the transfer transaction
      * @param {OfflineQuery | undefined} offlineQuery Optional offline query if creating transactions in an offline environment
-     * @returns {Promise<string>} The transaction id of the transfer transaction
+     * @returns {Promise<Transaction>} The transaction object
+     *
+     * @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 executions
+     * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, recordProvider);
+     * const tx = await programManager.buildTransferPublicTransaction(1, "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", 0.2);
+     * 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 buildTransferPublicTransaction(amount, recipient, fee, privateKey, offlineQuery) {
-        return this.buildTransferTransaction(amount, recipient, "public", fee, false, undefined, undefined, undefined, privateKey, offlineQuery);
+    async buildTransferPublicTransaction(amount, recipient, priorityFee, privateKey, offlineQuery) {
+        return this.buildTransferTransaction(amount, recipient, "public", priorityFee, false, undefined, undefined, undefined, privateKey, offlineQuery);
     }
     /**
      * Build a transfer_public_as_signer transaction to transfer credits to another account for later submission to the Aleo network
      *
      * @param {number} amount The amount of credits to transfer
      * @param {string} recipient The recipient of the transfer
-     * @param {string} transferType The type of transfer to perform - options: 'private', 'privateToPublic', 'public', 'publicToPrivate'
-     * @param {number} fee The fee to pay for the transfer
-     * @param {boolean} privateFee Use a private record to pay the fee. If false this will use the account's public credit balance
-     * @param {RecordSearchParams | undefined} recordSearchParams Optional parameters for finding the amount and fee
-     * records for the transfer transaction
-     * @param {RecordPlaintext | string} amountRecord Optional amount record to use for the transfer
-     * @param {RecordPlaintext | string} feeRecord Optional fee record to use for the transfer
+     * @param {number} priorityFee The optional priority fee to be paid for the transfer
      * @param {PrivateKey | undefined} privateKey Optional private key to use for the transfer transaction
      * @param {OfflineQuery | undefined} offlineQuery Optional offline query if creating transactions in an offline environment
-     * @returns {Promise<string>} The transaction id of the transfer transaction
+     * @returns {Promise<Transaction>} The transaction object
+     *
+     * @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 executions
+     * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, recordProvider);
+     * const tx = await programManager.buildTransferPublicAsSignerTransaction(1, "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", 0.2);
+     * 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 buildTransferPublicAsSignerTransaction(amount, recipient, fee, privateKey, offlineQuery) {
-        return this.buildTransferTransaction(amount, recipient, "public", fee, false, undefined, undefined, undefined, privateKey, offlineQuery);
+    async buildTransferPublicAsSignerTransaction(amount, recipient, priorityFee, privateKey, offlineQuery) {
+        return this.buildTransferTransaction(amount, recipient, "public", priorityFee, false, undefined, undefined, undefined, privateKey, offlineQuery);
     }
     /**
      * Transfer credits to another account
@@ -2062,36 +2472,63 @@ class ProgramManager {
      * @param {number} amount The amount of credits to transfer
      * @param {string} recipient The recipient of the transfer
      * @param {string} transferType The type of transfer to perform - options: 'private', 'privateToPublic', 'public', 'publicToPrivate'
-     * @param {number} fee The fee to pay for the transfer
+     * @param {number} priorityFee The optional priority fee to be paid for the transfer
      * @param {boolean} privateFee Use a private record to pay the fee. If false this will use the account's public credit balance
-     * @param {RecordSearchParams | undefined} recordSearchParams Optional parameters for finding the amount and fee
-     * records for the transfer transaction
+     * @param {RecordSearchParams | undefined} recordSearchParams Optional parameters for finding the amount and fee records for the transfer transaction
      * @param {RecordPlaintext | string} amountRecord Optional amount record to use for the transfer
      * @param {RecordPlaintext | string} feeRecord Optional fee record to use for the transfer
      * @param {PrivateKey | undefined} privateKey Optional private key to use for the transfer transaction
      * @param {OfflineQuery | undefined} offlineQuery Optional offline query if creating transactions in an offline environment
-     * @returns {Promise<string>} The transaction id of the transfer transaction
+     * @returns {Promise<string>} The transaction id
      *
      * @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 networkClient = new AleoNetworkClient("https://api.explorer.provable.com/v1");
      * 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 executions
      * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, recordProvider);
-     * await programManager.initialize();
-     * const tx_id = await programManager.transfer(1, "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", "private", 0.2)
-     * const transaction = await programManager.networkClient.getTransaction(tx_id);
+     * const tx_id = await programManager.transfer(1, "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", "public", 0.2, false);
+     *
+     * // Verify the transaction was successful
+     * setTimeout(async () => {
+     *  const transaction = await programManager.networkClient.getTransaction(tx_id);
+     *  assert(transaction.id() === tx_id);
+     * }, 10000);
      */
-    async transfer(amount, recipient, transferType, fee, privateFee, recordSearchParams, amountRecord, feeRecord, privateKey, offlineQuery) {
-        const tx = await this.buildTransferTransaction(amount, recipient, transferType, fee, privateFee, recordSearchParams, amountRecord, feeRecord, privateKey, offlineQuery);
+    async transfer(amount, recipient, transferType, priorityFee, privateFee, recordSearchParams, amountRecord, feeRecord, privateKey, offlineQuery) {
+        const tx = (await this.buildTransferTransaction(amount, recipient, transferType, priorityFee, privateFee, recordSearchParams, amountRecord, feeRecord, privateKey, offlineQuery));
+        let feeAddress;
+        if (typeof privateKey !== "undefined") {
+            feeAddress = Address.from_private_key(privateKey);
+        }
+        else if (this.account !== undefined) {
+            feeAddress = this.account?.address();
+        }
+        else {
+            throw Error("No private key provided and no private key set in the ProgramManager. Please set an account or provide a private key.");
+        }
+        // Check if the account has sufficient credits to pay for the transaction
+        await this.checkFee(feeAddress.to_string(), tx.feeAmount());
         return await this.networkClient.submitTransaction(tx);
     }
     /**
      * Build transaction to bond credits to a validator for later submission to the Aleo Network
      *
+     * @param {string} validator_address Address of the validator to bond to, if this address is the same as the staker (i.e. the executor of this function), it will attempt to bond the credits as a validator. Bonding as a validator currently requires a minimum of 10,000,000 credits to bond (subject to change). If the address is specified is an existing validator and is different from the address of the executor of this function, it will bond the credits to that validator's staking committee as a delegator. A minimum of 10 credits is required to bond as a delegator.
+     * @param {string} withdrawal_address Address to withdraw the staked credits to when unbond_public is called.
+     * @param {number} amount The amount of credits to bond
+     * @param {Partial<ExecuteOptions>} options - Override default execution options.
+     * @returns {Promise<Transaction>} The transaction object
+     *
      * @example
+     * // Import the mainnet version of the sdk.
+     * import { AleoKeyProvider, ProgramManager } from "@provablehq/sdk/mainnet.js";
+     *
      * // Create a keyProvider to handle key management
      * const keyProvider = new AleoKeyProvider();
      * keyProvider.useCache = true;
@@ -2102,72 +2539,97 @@ class ProgramManager {
      *
      * // Create the bonding transaction object for later submission
      * const tx = await programManager.buildBondPublicTransaction("aleo1jx8s4dvjepculny4wfrzwyhs3tlyv65r58ns3g6q2gm2esh7ps8sqy9s5j", "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", "aleo1feya8sjy9k2zflvl2dx39pdsq5tju28elnp2ektnn588uu9ghv8s84msv9", 2000000);
-     * console.log(tx);
      *
      * // The transaction can be later submitted to the network using the network client.
-     * const result = await programManager.networkClient.submitTransaction(tx);
-     *
-     * @returns string
-     * @param {string} validator_address Address of the validator to bond to, if this address is the same as the staker (i.e. the
-     * executor of this function), it will attempt to bond the credits as a validator. Bonding as a validator currently
-     * requires a minimum of 10,000,000 credits to bond (subject to change). If the address is specified is an existing
-     * validator and is different from the address of the executor of this function, it will bond the credits to that
-     * validator's staking committee as a delegator. A minimum of 10 credits is required to bond as a delegator.
-     * @param {string} withdrawal_address Address to withdraw the staked credits to when unbond_public is called.
-     * @param {number} amount The amount of credits to bond
-     * @param {Partial<ExecuteOptions>} options - Override default execution options.
+     * 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 buildBondPublicTransaction(validator_address, withdrawal_address, amount, options = {}) {
         const scaledAmount = Math.trunc(amount * 1000000);
-        const { programName = "credits.aleo", functionName = "bond_public", fee = options.fee || 0.86, privateFee = false, inputs = [validator_address, withdrawal_address, `${scaledAmount.toString()}u64`], keySearchParams = new AleoKeyProviderParams({
+        const { programName = "credits.aleo", functionName = "bond_public", priorityFee = options.priorityFee || 0, privateFee = false, inputs = [
+            validator_address,
+            withdrawal_address,
+            `${scaledAmount.toString()}u64`,
+        ], keySearchParams = new AleoKeyProviderParams({
             proverUri: CREDITS_PROGRAM_KEYS.bond_public.prover,
             verifierUri: CREDITS_PROGRAM_KEYS.bond_public.verifier,
-            cacheKey: "credits.aleo/bond_public"
+            cacheKey: "credits.aleo/bond_public",
         }), program = this.creditsProgram(), ...additionalOptions } = options;
         const executeOptions = {
             programName,
             functionName,
-            fee,
+            priorityFee,
             privateFee,
             inputs,
             keySearchParams,
-            ...additionalOptions
+            ...additionalOptions,
         };
         return await this.buildExecutionTransaction(executeOptions);
     }
     /**
      * Bond credits to validator.
      *
+     * @param {string} validator_address Address of the validator to bond to, if this address is the same as the signer (i.e. the executor of this function), it will attempt to bond the credits as a validator. Bonding as a validator currently requires a minimum of 1,000,000 credits to bond (subject to change). If the address is specified is an existing validator and is different from the address of the executor of this function, it will bond the credits to that validator's staking committee as a delegator. A minimum of 10 credits is required to bond as a delegator.
+     * @param {string} withdrawal_address Address to withdraw the staked credits to when unbond_public is called.
+     * @param {number} amount The amount of credits to bond
+     * @param {Options} options Options for the execution
+     * @returns {Promise<string>} The transaction id
+     *
      * @example
+     * // Import the mainnet version of the sdk.
+     * import { AleoKeyProvider, ProgramManager } from "@provablehq/sdk/mainnet.js";
+     *
      * // Create a keyProvider to handle key management
      * const keyProvider = new AleoKeyProvider();
      * keyProvider.useCache = true;
      *
      * // Create a new ProgramManager with the key that will be used to bond credits
      * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, undefined);
-     * programManager.setAccount(new Account("YourPrivateKey"));
      *
      * // Create the bonding transaction
-     * const tx_id = await programManager.bondPublic("aleo1jx8s4dvjepculny4wfrzwyhs3tlyv65r58ns3g6q2gm2esh7ps8sqy9s5j", "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", "aleo1feya8sjy9k2zflvl2dx39pdsq5tju28elnp2ektnn588uu9ghv8s84msv9", 2000000);
-     *
-     * @returns string
-     * @param {string} validator_address Address of the validator to bond to, if this address is the same as the signer (i.e. the
-     * executor of this function), it will attempt to bond the credits as a validator. Bonding as a validator currently
-     * requires a minimum of 1,000,000 credits to bond (subject to change). If the address is specified is an existing
-     * validator and is different from the address of the executor of this function, it will bond the credits to that
-     * validator's staking committee as a delegator. A minimum of 10 credits is required to bond as a delegator.
-     * @param {string} withdrawal_address Address to withdraw the staked credits to when unbond_public is called.
-     * @param {number} amount The amount of credits to bond
-     * @param {Options} options Options for the execution
+     * tx_id = await programManager.bondPublic("aleo1jx8s4dvjepculny4wfrzwyhs3tlyv65r58ns3g6q2gm2esh7ps8sqy9s5j", "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", "aleo1feya8sjy9k2zflvl2dx39pdsq5tju28elnp2ektnn588uu9ghv8s84msv9", 2000000);
+     *
+     * // Verify the transaction was successful
+     * setTimeout(async () => {
+     *  const transaction = await programManager.networkClient.getTransaction(tx_id);
+     *  assert(transaction.id() === tx_id);
+     * }, 10000);
      */
     async bondPublic(validator_address, withdrawal_address, amount, options = {}) {
-        const tx = await this.buildBondPublicTransaction(validator_address, withdrawal_address, amount, options);
+        const tx = (await this.buildBondPublicTransaction(validator_address, withdrawal_address, amount, options));
+        let feeAddress;
+        if (typeof options.privateKey !== "undefined") {
+            feeAddress = Address.from_private_key(options.privateKey);
+        }
+        else if (this.account !== undefined) {
+            feeAddress = this.account?.address();
+        }
+        else {
+            throw Error("No private key provided and no private key set in the ProgramManager. Please set an account or provide a private key.");
+        }
+        // Check if the account has sufficient credits to pay for the transaction
+        await this.checkFee(feeAddress.to_string(), tx.feeAmount());
         return await this.networkClient.submitTransaction(tx);
     }
     /**
      * Build a bond_validator transaction for later submission to the Aleo Network.
      *
+     * @param {string} validator_address Address of the validator to bond to, if this address is the same as the staker (i.e. the executor of this function), it will attempt to bond the credits as a validator. If the address is specified is an existing validator and is different from the address of the executor of this function, it will bond the credits to that validator's staking committee as a delegator.
+     * @param {string} withdrawal_address Address to withdraw the staked credits to when unbond_public is called.
+     * @param {number} amount The amount of credits to bond. A minimum of 10000 credits is required to bond as a delegator.
+     * @param {number} commission The commission rate for the validator (must be between 0 and 100 - an error will be thrown if it is not)
+     * @param {Partial<ExecuteOptions>} options - Override default execution options.
+     * @returns {Promise<Transaction>} The transaction object
+     *
      * @example
+     * // Import the mainnet version of the sdk.
+     * import { AleoKeyProvider, ProgramManager } from "@provablehq/sdk/mainnet.js";
+     *
      * // Create a keyProvider to handle key management
      * const keyProvider = new AleoKeyProvider();
      * keyProvider.useCache = true;
@@ -2178,45 +2640,54 @@ class ProgramManager {
      *
      * // Create the bond validator transaction object for later use.
      * const tx = await programManager.buildBondValidatorTransaction("aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", "aleo1feya8sjy9k2zflvl2dx39pdsq5tju28elnp2ektnn588uu9ghv8s84msv9", 2000000);
-     * console.log(tx);
      *
      * // The transaction can later be submitted to the network using the network client.
-     * const tx_id = await programManager.networkClient.submitTransaction(tx);
-     *
-     * @returns string
-     * @param {string} validator_address Address of the validator to bond to, if this address is the same as the staker (i.e. the
-     * executor of this function), it will attempt to bond the credits as a validator. Bonding as a validator currently
-     * requires a minimum of 10,000,000 credits to bond (subject to change). If the address is specified is an existing
-     * validator and is different from the address of the executor of this function, it will bond the credits to that
-     * validator's staking committee as a delegator. A minimum of 10 credits is required to bond as a delegator.
-     * @param {string} withdrawal_address Address to withdraw the staked credits to when unbond_public is called.
-     * @param {number} amount The amount of credits to bond
-     * @param {number} commission The commission rate for the validator (must be between 0 and 100 - an error will be thrown if it is not)
-     * @param {Partial<ExecuteOptions>} options - Override default execution options.
+     * const tx_id = 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 buildBondValidatorTransaction(validator_address, withdrawal_address, amount, commission, options = {}) {
         const scaledAmount = Math.trunc(amount * 1000000);
         const adjustedCommission = Math.trunc(commission);
-        const { programName = "credits.aleo", functionName = "bond_validator", fee = options.fee || 0.86, privateFee = false, inputs = [validator_address, withdrawal_address, `${scaledAmount.toString()}u64`, `${adjustedCommission.toString()}u8`], keySearchParams = new AleoKeyProviderParams({
+        const { programName = "credits.aleo", functionName = "bond_validator", priorityFee = options.priorityFee || 0, privateFee = false, inputs = [
+            validator_address,
+            withdrawal_address,
+            `${scaledAmount.toString()}u64`,
+            `${adjustedCommission.toString()}u8`,
+        ], keySearchParams = new AleoKeyProviderParams({
             proverUri: CREDITS_PROGRAM_KEYS.bond_validator.prover,
             verifierUri: CREDITS_PROGRAM_KEYS.bond_validator.verifier,
-            cacheKey: "credits.aleo/bond_validator"
+            cacheKey: "credits.aleo/bond_validator",
         }), program = this.creditsProgram(), ...additionalOptions } = options;
         const executeOptions = {
             programName,
             functionName,
-            fee,
+            priorityFee,
             privateFee,
             inputs,
             keySearchParams,
-            ...additionalOptions
+            ...additionalOptions,
         };
         return await this.buildExecutionTransaction(executeOptions);
     }
     /**
      * Build transaction to bond a validator.
      *
+     * @param {string} validator_address Address of the validator to bond to, if this address is the same as the staker (i.e. the executor of this function), it will attempt to bond the credits as a validator. Bonding as a validator currently requires a minimum of 10,000,000 credits to bond (subject to change). If the address is specified is an existing validator and is different from the address of the executor of this function, it will bond the credits to that validator's staking committee as a delegator. A minimum of 10 credits is required to bond as a delegator.
+     * @param {string} withdrawal_address Address to withdraw the staked credits to when unbond_public is called.
+     * @param {number} amount The amount of credits to bond
+     * @param {number} commission The commission rate for the validator (must be between 0 and 100 - an error will be thrown if it is not)
+     * @param {Partial<ExecuteOptions>} options - Override default execution options.
+     * @returns {Promise<string>} The transaction id
+     *
      * @example
+     * // Import the mainnet version of the sdk.
+     * import { AleoKeyProvider, ProgramManager } from "@provablehq/sdk/mainnet.js";
+     *
      * // Create a keyProvider to handle key management
      * const keyProvider = new AleoKeyProvider();
      * keyProvider.useCache = true;
@@ -2228,23 +2699,30 @@ class ProgramManager {
      * // Create the bonding transaction
      * const tx_id = await programManager.bondValidator("aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", "aleo1feya8sjy9k2zflvl2dx39pdsq5tju28elnp2ektnn588uu9ghv8s84msv9", 2000000);
      *
-     * @returns string
-     * @param {string} validator_address Address of the validator to bond to, if this address is the same as the staker (i.e. the
-     * executor of this function), it will attempt to bond the credits as a validator. Bonding as a validator currently
-     * requires a minimum of 10,000,000 credits to bond (subject to change). If the address is specified is an existing
-     * validator and is different from the address of the executor of this function, it will bond the credits to that
-     * validator's staking committee as a delegator. A minimum of 10 credits is required to bond as a delegator.
-     * @param {string} withdrawal_address Address to withdraw the staked credits to when unbond_public is called.
-     * @param {number} amount The amount of credits to bond
-     * @param {number} commission The commission rate for the validator (must be between 0 and 100 - an error will be thrown if it is not)
-     * @param {Partial<ExecuteOptions>} options - Override default execution options.
+     * // Verify the transaction was successful
+     * setTimeout(async () => {
+     *  const transaction = await programManager.networkClient.getTransaction(tx_id);
+     *  assert(transaction.id() === tx_id);
+     * }, 10000);
      */
     async bondValidator(validator_address, withdrawal_address, amount, commission, options = {}) {
-        const tx = await this.buildBondValidatorTransaction(validator_address, withdrawal_address, amount, commission, options);
+        const tx = (await this.buildBondValidatorTransaction(validator_address, withdrawal_address, amount, commission, options));
+        let feeAddress;
+        if (typeof options.privateKey !== "undefined") {
+            feeAddress = Address.from_private_key(options.privateKey);
+        }
+        else if (this.account !== undefined) {
+            feeAddress = this.account?.address();
+        }
+        else {
+            throw Error("No private key provided and no private key set in the ProgramManager. Please set an account or provide a private key.");
+        }
+        // Check if the account has sufficient credits to pay for the transaction
+        await this.checkFee(feeAddress.to_string(), tx.feeAmount());
         return await this.networkClient.submitTransaction(tx);
     }
     /**
-     * Build a transaction to unbond public credits from a validator in the Aleo network.
+     * Build an unbond_public execution transaction to unbond credits from a validator in the Aleo network.
      *
      * @param {string} staker_address - The address of the staker who is unbonding the credits.
      * @param {number} amount - The amount of credits to unbond (scaled by 1,000,000).
@@ -2252,6 +2730,9 @@ class ProgramManager {
      * @returns {Promise<Transaction>} - A promise that resolves to the transaction or an error message.
      *
      * @example
+     * // Import the mainnet version of the sdk.
+     * import { AleoKeyProvider, ProgramManager } from "@provablehq/sdk/mainnet.js";
+     *
      * // Create a keyProvider to handle key management.
      * const keyProvider = new AleoKeyProvider();
      * keyProvider.useCache = true;
@@ -2259,33 +2740,51 @@ class ProgramManager {
      * // Create a new ProgramManager with the key that will be used to unbond credits.
      * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, undefined);
      * const tx = await programManager.buildUnbondPublicTransaction("aleo1jx8s4dvjepculny4wfrzwyhs3tlyv65r58ns3g6q2gm2esh7ps8sqy9s5j", 2000000);
-     * console.log(tx);
      *
      * // The transaction can be submitted later to the network using the network client.
-     * programManager.networkClient.submitTransaction(tx);
+     * 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 buildUnbondPublicTransaction(staker_address, amount, options = {}) {
         const scaledAmount = Math.trunc(amount * 1000000);
-        const { programName = "credits.aleo", functionName = "unbond_public", fee = options.fee || 1.3, privateFee = false, inputs = [staker_address, `${scaledAmount.toString()}u64`], keySearchParams = new AleoKeyProviderParams({
+        const { programName = "credits.aleo", functionName = "unbond_public", priorityFee = options.priorityFee || 0, privateFee = false, inputs = [staker_address, `${scaledAmount.toString()}u64`], keySearchParams = new AleoKeyProviderParams({
             proverUri: CREDITS_PROGRAM_KEYS.unbond_public.prover,
             verifierUri: CREDITS_PROGRAM_KEYS.unbond_public.verifier,
-            cacheKey: "credits.aleo/unbond_public"
+            cacheKey: "credits.aleo/unbond_public",
         }), program = this.creditsProgram(), ...additionalOptions } = options;
         const executeOptions = {
             programName,
             functionName,
-            fee,
+            priorityFee,
             privateFee,
             inputs,
             keySearchParams,
-            ...additionalOptions
+            ...additionalOptions,
         };
         return this.buildExecutionTransaction(executeOptions);
     }
     /**
-     * Unbond a specified amount of staked credits.
+     * Unbond a specified amount of staked credits. If the address of the executor of this function is an existing
+     * validator, it will subtract this amount of credits from the validator's staked credits. If there are less than
+     * 1,000,000 credits staked pool after the unbond, the validator will be removed from the validator set. If the
+     * address of the executor of this function is not a validator and has credits bonded as a delegator, it will
+     * subtract this amount of credits from the delegator's staked credits. If there are less than 10 credits bonded
+     * after the unbond operation, the delegator will be removed from the validator's staking pool.
+     *
+     * @param {string} staker_address Address of the staker who is unbonding the credits
+     * @param {number} amount Amount of credits to unbond.
+     * @param {ExecuteOptions} options Options for the execution
+     * @returns {Promise<string>} The transaction id
      *
      * @example
+     * // Import the mainnet version of the sdk.
+     * import { AleoKeyProvider, ProgramManager } from "@provablehq/sdk/mainnet.js";
+     *
      * // Create a keyProvider to handle key management
      * const keyProvider = new AleoKeyProvider();
      * keyProvider.useCache = true;
@@ -2294,21 +2793,29 @@ class ProgramManager {
      * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, undefined);
      * programManager.setAccount(new Account("YourPrivateKey"));
      *
-     * // Create the bonding transaction and send it to the network
+     * // Create the unbond_public transaction and send it to the network
      * const tx_id = await programManager.unbondPublic("aleo1jx8s4dvjepculny4wfrzwyhs3tlyv65r58ns3g6q2gm2esh7ps8sqy9s5j", 10);
      *
-     * @returns string
-     * @param {string} staker_address Address of the staker who is unbonding the credits
-     * @param {number} amount Amount of credits to unbond. If the address of the executor of this function is an
-     * existing validator, it will subtract this amount of credits from the validator's staked credits. If there are
-     * less than 1,000,000 credits staked pool after the unbond, the validator will be removed from the validator set.
-     * If the address of the executor of this function is not a validator and has credits bonded as a delegator, it will
-     * subtract this amount of credits from the delegator's staked credits. If there are less than 10 credits bonded
-     * after the unbond operation, the delegator will be removed from the validator's staking pool.
-     * @param {ExecuteOptions} options Options for the execution
+     * // Verify the transaction was successful
+     * setTimeout(async () => {
+     *  const transaction = await programManager.networkClient.getTransaction(tx_id);
+     *  assert(transaction.id() === tx_id);
+     * }, 10000);
      */
     async unbondPublic(staker_address, amount, options = {}) {
-        const tx = await this.buildUnbondPublicTransaction(staker_address, amount, options);
+        const tx = (await this.buildUnbondPublicTransaction(staker_address, amount, options));
+        let feeAddress;
+        if (typeof options.privateKey !== "undefined") {
+            feeAddress = Address.from_private_key(options.privateKey);
+        }
+        else if (this.account !== undefined) {
+            feeAddress = this.account?.address();
+        }
+        else {
+            throw Error("No private key provided and no private key set in the ProgramManager. Please set an account or provide a private key.");
+        }
+        // Check if the account has sufficient credits to pay for the transaction
+        await this.checkFee(feeAddress.to_string(), tx.feeAmount());
         return await this.networkClient.submitTransaction(tx);
     }
     /**
@@ -2319,6 +2826,9 @@ class ProgramManager {
      * @returns {Promise<Transaction>} - A promise that resolves to the transaction or an error message.
      *
      * @example
+     * // Import the mainnet version of the sdk.
+     * import { AleoKeyProvider, ProgramManager } from "@provablehq/sdk/mainnet.js";
+     *
      * // Create a keyProvider to handle key management
      * const keyProvider = new AleoKeyProvider();
      * keyProvider.useCache = true;
@@ -2326,35 +2836,48 @@ class ProgramManager {
      * // Create a new ProgramManager with the key that will be used to claim unbonded credits.
      * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, undefined);
      *
-     * // Create the claim unbonded transaction object for later use.
+     * // Create the claim_unbond_public transaction object for later use.
      * const tx = await programManager.buildClaimUnbondPublicTransaction("aleo1jx8s4dvjepculny4wfrzwyhs3tlyv65r58ns3g6q2gm2esh7ps8sqy9s5j");
-     * console.log(tx);
      *
      * // The transaction can be submitted later to the network using the network client.
-     * programManager.networkClient.submitTransaction(tx);
+     * 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 buildClaimUnbondPublicTransaction(staker_address, options = {}) {
-        const { programName = "credits.aleo", functionName = "claim_unbond_public", fee = options.fee || 2, privateFee = false, inputs = [staker_address], keySearchParams = new AleoKeyProviderParams({
+        const { programName = "credits.aleo", functionName = "claim_unbond_public", priorityFee = options.priorityFee || 0, privateFee = false, inputs = [staker_address], keySearchParams = new AleoKeyProviderParams({
             proverUri: CREDITS_PROGRAM_KEYS.claim_unbond_public.prover,
             verifierUri: CREDITS_PROGRAM_KEYS.claim_unbond_public.verifier,
-            cacheKey: "credits.aleo/claim_unbond_public"
+            cacheKey: "credits.aleo/claim_unbond_public",
         }), program = this.creditsProgram(), ...additionalOptions } = options;
         const executeOptions = {
             programName,
             functionName,
-            fee,
+            priorityFee,
             privateFee,
             inputs,
             keySearchParams,
-            ...additionalOptions
+            ...additionalOptions,
         };
+        // Check if the account has sufficient credits to pay for the transaction
         return await this.buildExecutionTransaction(executeOptions);
     }
     /**
      * Claim unbonded credits. If credits have been unbonded by the account executing this function, this method will
      * claim them and add them to the public balance of the account.
      *
+     * @param {string} staker_address Address of the staker who is claiming the credits
+     * @param {ExecuteOptions} options
+     * @returns {Promise<string>} The transaction id
+     *
      * @example
+     * // Import the mainnet version of the sdk.
+     * import { AleoKeyProvider, ProgramManager } from "@provablehq/sdk/mainnet.js";
+     *
      * // Create a keyProvider to handle key management
      * const keyProvider = new AleoKeyProvider();
      * keyProvider.useCache = true;
@@ -2363,15 +2886,29 @@ class ProgramManager {
      * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, undefined);
      * programManager.setAccount(new Account("YourPrivateKey"));
      *
-     * // Create the bonding transaction
+     * // Create the claim_unbond_public transaction
      * const tx_id = await programManager.claimUnbondPublic("aleo1jx8s4dvjepculny4wfrzwyhs3tlyv65r58ns3g6q2gm2esh7ps8sqy9s5j");
      *
-     * @param {string} staker_address Address of the staker who is claiming the credits
-     * @param {ExecuteOptions} options
-     * @returns string
+     * // Verify the transaction was successful
+     * setTimeout(async () => {
+     *  const transaction = await programManager.networkClient.getTransaction(tx_id);
+     *  assert(transaction.id() === tx_id);
+     * }, 10000);
      */
     async claimUnbondPublic(staker_address, options = {}) {
-        const tx = await this.buildClaimUnbondPublicTransaction(staker_address, options);
+        const tx = (await this.buildClaimUnbondPublicTransaction(staker_address, options));
+        let feeAddress;
+        if (typeof options.privateKey !== "undefined") {
+            feeAddress = Address.from_private_key(options.privateKey);
+        }
+        else if (this.account !== undefined) {
+            feeAddress = this.account?.address();
+        }
+        else {
+            throw Error("No private key provided and no private key set in the ProgramManager. Please set an account or provide a private key.");
+        }
+        // Check if the account has sufficient credits to pay for the transaction
+        await this.checkFee(feeAddress.to_string(), tx.feeAmount());
         return await this.networkClient.submitTransaction(tx);
     }
     /**
@@ -2385,41 +2922,49 @@ class ProgramManager {
      * 1. Allow a validator to leave the committee, by closing themselves to stakers and then unbonding all of their stakers.
      * 2. Allow a validator to maintain their % of stake, by closing themselves to allowing more stakers to bond to them.
      *
+     * @param {boolean} validator_state
+     * @param {Partial<ExecuteOptions>} options - Override default execution options
+     * @returns {Promise<Transaction>} The transaction object
+     *
      * @example
+     * // Import the mainnet version of the sdk.
+     * import { AleoKeyProvider, ProgramManager } from "@provablehq/sdk/mainnet.js";
+     *
      * // Create a keyProvider to handle key management
      * const keyProvider = new AleoKeyProvider();
      * keyProvider.useCache = true;
      *
      * // Create a new ProgramManager with the key that will be used to bond credits
      * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, undefined);
-     * programManager.setAccount(new Account("ValidatorPrivateKey"));
      *
-     * // Create the bonding transaction
+     * // Create the set_validator_state transaction
      * const tx = await programManager.buildSetValidatorStateTransaction(true);
      *
      * // The transaction can be submitted later to the network using the network client.
-     * programManager.networkClient.submitTransaction(tx);
+     * programManager.networkClient.submitTransaction(tx.toString());
      *
-     * @returns string
-     * @param {boolean} validator_state
-     * @param {Partial<ExecuteOptions>} options - Override default execution options
+     * // Verify the transaction was successful
+     * setTimeout(async () => {
+     *  const transaction = await programManager.networkClient.getTransaction(tx.id());
+     *  assert(transaction.id() === tx.id());
+     * }, 10000);
      */
     async buildSetValidatorStateTransaction(validator_state, options = {}) {
-        const { programName = "credits.aleo", functionName = "set_validator_state", fee = 1, privateFee = false, inputs = [validator_state.toString()], keySearchParams = new AleoKeyProviderParams({
+        const { programName = "credits.aleo", functionName = "set_validator_state", priorityFee = 0, privateFee = false, inputs = [validator_state.toString()], keySearchParams = new AleoKeyProviderParams({
             proverUri: CREDITS_PROGRAM_KEYS.set_validator_state.prover,
             verifierUri: CREDITS_PROGRAM_KEYS.set_validator_state.verifier,
-            cacheKey: "credits.aleo/set_validator_state"
+            cacheKey: "credits.aleo/set_validator_state",
         }), ...additionalOptions } = options;
         const executeOptions = {
             programName,
             functionName,
-            fee,
+            priorityFee,
             privateFee,
             inputs,
             keySearchParams,
-            ...additionalOptions
+            ...additionalOptions,
         };
-        return await this.execute(executeOptions);
+        return await this.buildExecutionTransaction(executeOptions);
     }
     /**
      * Submit a set_validator_state transaction to the Aleo Network.
@@ -2432,24 +2977,44 @@ class ProgramManager {
      * 1. Allow a validator to leave the committee, by closing themselves to stakers and then unbonding all of their stakers.
      * 2. Allow a validator to maintain their % of stake, by closing themselves to allowing more stakers to bond to them.
      *
+     * @param {boolean} validator_state
+     * @param {Partial<ExecuteOptions>} options - Override default execution options
+     * @returns {Promise<string>} The transaction id
+     *
      * @example
+     * // Import the mainnet version of the sdk.
+     * import { AleoKeyProvider, ProgramManager } from "@provablehq/sdk/mainnet.js";
+     *
      * // Create a keyProvider to handle key management
      * const keyProvider = new AleoKeyProvider();
      * keyProvider.useCache = true;
      *
      * // Create a new ProgramManager with the key that will be used to bond credits
      * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, undefined);
-     * programManager.setAccount(new Account("ValidatorPrivateKey"));
      *
-     * // Create the bonding transaction
+     * // Create the set_validator_state transaction
      * const tx_id = await programManager.setValidatorState(true);
      *
-     * @returns string
-     * @param {boolean} validator_state
-     * @param {Partial<ExecuteOptions>} options - Override default execution options
+     * // Verify the transaction was successful
+     * setTimeout(async () => {
+     *  const transaction = await programManager.networkClient.getTransaction(tx_id);
+     *  assert(transaction.id() === tx_id);
+     * }, 10000);
      */
     async setValidatorState(validator_state, options = {}) {
-        const tx = await this.buildSetValidatorStateTransaction(validator_state, options);
+        const tx = (await this.buildSetValidatorStateTransaction(validator_state, options));
+        let feeAddress;
+        if (typeof options.privateKey !== "undefined") {
+            feeAddress = Address.from_private_key(options.privateKey);
+        }
+        else if (this.account !== undefined) {
+            feeAddress = this.account?.address();
+        }
+        else {
+            throw Error("No private key provided and no private key set in the ProgramManager. Please set an account or provide a private key.");
+        }
+        // Check if the account has sufficient credits to pay for the transaction
+        await this.checkFee(feeAddress.to_string(), tx.feeAmount());
         return this.networkClient.submitTransaction(tx);
     }
     /**
@@ -2460,7 +3025,7 @@ class ProgramManager {
      */
     verifyExecution(executionResponse) {
         try {
-            const execution = executionResponse.getExecution();
+            const execution = (executionResponse.getExecution());
             const function_id = executionResponse.getFunctionId();
             const program = executionResponse.getProgram();
             const verifyingKey = executionResponse.getVerifyingKey();
@@ -2505,7 +3070,9 @@ class ProgramManager {
     // Internal utility function for getting a credits.aleo record
     async getCreditsRecord(amount, nonces, record, params) {
         try {
-            return record instanceof RecordPlaintext ? record : RecordPlaintext.fromString(record);
+            return record instanceof RecordPlaintext
+                ? record
+                : RecordPlaintext.fromString(record);
         }
         catch (e) {
             try {
@@ -2524,9 +3091,10 @@ function requiresAmountRecord(transferType) {
 }
 // Validate the transfer type
 function validateTransferType(transferType) {
-    return VALID_TRANSFER_TYPES.has(transferType) ? transferType :
-        logAndThrow(`Invalid transfer type '${transferType}'. Valid transfer types are 'private', 'privateToPublic', 'public', and 'publicToPrivate'.`);
+    return VALID_TRANSFER_TYPES.has(transferType)
+        ? transferType
+        : logAndThrow(`Invalid transfer type '${transferType}'. Valid transfer types are 'private', 'privateToPublic', 'public', and 'publicToPrivate'.`);
 }
 
 export { AleoKeyProvider as A, CREDITS_PROGRAM_KEYS as C, KEY_STORE as K, ProgramManager as P, VALID_TRANSFER_TYPES as V, AleoKeyProviderParams as a, AleoNetworkClient as b, PRIVATE_TRANSFER as c, PRIVATE_TO_PUBLIC_TRANSFER as d, PRIVATE_TRANSFER_TYPES as e, PUBLIC_TRANSFER as f, PUBLIC_TRANSFER_AS_SIGNER as g, PUBLIC_TO_PRIVATE_TRANSFER as h, logAndThrow as l };
-//# sourceMappingURL=program-manager-CjvnOyfn.js.map
+//# sourceMappingURL=program-manager-BuK9g9xJ.js.map