@fuel-ts/account 0.88.0 → 0.89.0

package/dist/index.mjs

@@ -2108,7 +2108,7 @@ var BaseTransactionRequest = class {
    * @param coin - Coin resource.
    */
   addCoinInput(coin) {
-    const { assetId, owner, amount, id, predicate } = coin;
+    const { assetId, owner, amount, id, predicate, predicateData } = coin;
     let witnessIndex;
     if (coin.predicate) {
       witnessIndex = 0;
@@ -2126,7 +2126,8 @@ var BaseTransactionRequest = class {
       assetId,
       txPointer: "0x00000000000000000000000000000000",
       witnessIndex,
-      predicate
+      predicate,
+      predicateData
     };
     this.pushInput(input);
     this.addChangeOutput(owner, assetId);
@@ -2138,7 +2139,7 @@ var BaseTransactionRequest = class {
    * @param message - Message resource.
    */
   addMessageInput(message) {
-    const { recipient, sender, amount, predicate, nonce, assetId } = message;
+    const { recipient, sender, amount, predicate, nonce, assetId, predicateData } = message;
     let witnessIndex;
     if (message.predicate) {
       witnessIndex = 0;
@@ -2155,7 +2156,8 @@ var BaseTransactionRequest = class {
       recipient: recipient.toB256(),
       amount,
       witnessIndex,
-      predicate
+      predicate,
+      predicateData
     };
     this.pushInput(input);
     this.addChangeOutput(recipient, assetId);
@@ -2357,23 +2359,13 @@ var BaseTransactionRequest = class {
     });
   }
   updatePredicateGasUsed(inputs) {
-    this.inputs.forEach((i) => {
-      let correspondingInput;
-      switch (i.type) {
-        case InputType3.Coin:
-          correspondingInput = inputs.find((x) => x.type === InputType3.Coin && x.owner === i.owner);
-          break;
-        case InputType3.Message:
-          correspondingInput = inputs.find(
-            (x) => x.type === InputType3.Message && x.sender === i.sender
-          );
-          break;
-        default:
-          return;
-      }
+    const inputsToExtractGasUsed = inputs.filter(isRequestInputResource);
+    this.inputs.filter(isRequestInputResource).forEach((i) => {
+      const owner = getRequestInputResourceOwner(i);
+      const correspondingInput = inputsToExtractGasUsed.find(
+        (x) => isRequestInputResourceFromOwner(x, Address.fromString(String(owner)))
+      );
       if (correspondingInput && "predicateGasUsed" in correspondingInput && bn8(correspondingInput.predicateGasUsed).gt(0)) {
-        i.predicate = correspondingInput.predicate;
-        i.predicateData = correspondingInput.predicateData;
         i.predicateGasUsed = correspondingInput.predicateGasUsed;
       }
     });
@@ -2706,6 +2698,13 @@ var ScriptTransactionRequest = class extends BaseTransactionRequest {
     }
     return this.outputs.length - 1;
   }
+  /**
+   * Calculates the maximum gas for the transaction.
+   *
+   * @param chainInfo - The chain information.
+   * @param minGas - The minimum gas.
+   * @returns the maximum gas.
+   */
   calculateMaxGas(chainInfo, minGas) {
     const { consensusParameters } = chainInfo;
     const {
@@ -3123,13 +3122,13 @@ function getReceiptsTransferOut(receipts) {
 }
 function getWithdrawFromFuelOperations({
   inputs,
-  receipts
+  receipts,
+  baseAssetId
 }) {
   const messageOutReceipts = getReceiptsMessageOut(receipts);
   const withdrawFromFuelOperations = messageOutReceipts.reduce(
     (prevWithdrawFromFuelOps, receipt) => {
-      const assetId = "0x0000000000000000000000000000000000000000000000000000000000000000";
-      const input = getInputFromAssetId(inputs, assetId);
+      const input = getInputFromAssetId(inputs, baseAssetId);
       if (input) {
         const inputAddress = getInputAccountAddress(input);
         const newWithdrawFromFuelOps = addOperation(prevWithdrawFromFuelOps, {
@@ -3146,7 +3145,7 @@ function getWithdrawFromFuelOperations({
           assetsSent: [
             {
               amount: receipt.amount,
-              assetId
+              assetId: baseAssetId
             }
           ]
         });
@@ -3342,7 +3341,8 @@ function getOperations({
   receipts,
   abiMap,
   rawPayload,
-  maxInputs
+  maxInputs,
+  baseAssetId
 }) {
   if (isTypeCreate(transactionType)) {
     return [
@@ -3361,7 +3361,7 @@ function getOperations({
         rawPayload,
         maxInputs
       }),
-      ...getWithdrawFromFuelOperations({ inputs, receipts })
+      ...getWithdrawFromFuelOperations({ inputs, receipts, baseAssetId })
     ];
   }
   return [...getPayProducerOperations(outputs)];
@@ -3497,7 +3497,8 @@ function assembleTransactionSummary(params) {
     maxInputs,
     gasCosts,
     maxGasPerTx,
-    gasPrice
+    gasPrice,
+    baseAssetId
   } = params;
   const gasUsed = getGasUsedFromReceipts(receipts);
   const rawPayload = hexlify11(transactionBytes);
@@ -3508,7 +3509,8 @@ function assembleTransactionSummary(params) {
     receipts,
     rawPayload,
     abiMap,
-    maxInputs
+    maxInputs,
+    baseAssetId
   });
   const typeName = getTransactionTypeName(transaction.type);
   const tip = bn15(transaction.policies?.find((policy) => policy.type === PolicyType3.Tip)?.data);
@@ -3668,6 +3670,7 @@ var TransactionResponse = class {
     const { gasPerByte, gasPriceFactor, gasCosts, maxGasPerTx } = this.provider.getGasConfig();
     const gasPrice = await this.provider.getLatestGasPrice();
     const maxInputs = this.provider.getChain().consensusParameters.txParameters.maxInputs;
+    const baseAssetId = this.provider.getBaseAssetId();
     const transactionSummary = assembleTransactionSummary({
       id: this.id,
       receipts,
@@ -3680,7 +3683,8 @@ var TransactionResponse = class {
       maxInputs,
       gasCosts,
       maxGasPerTx,
-      gasPrice
+      gasPrice,
+      baseAssetId
     });
     return transactionSummary;
   }
@@ -3868,7 +3872,6 @@ var _Provider = class {
    * Constructor to initialize a Provider.
    *
    * @param url - GraphQL endpoint of the Fuel node
-   * @param chainInfo - Chain info of the Fuel node
    * @param options - Additional options for the provider
    * @hidden
    */
@@ -3891,10 +3894,14 @@ var _Provider = class {
     this.operations = this.createOperations();
     this.cache = options.cacheUtxo ? new MemoryCache(options.cacheUtxo) : void 0;
   }
+  /** @hidden */
   static clearChainAndNodeCaches() {
     _Provider.nodeInfoCache = {};
     _Provider.chainInfoCache = {};
   }
+  /**
+   * @hidden
+   */
   static getFetchFn(options) {
     const { retryOptions, timeout } = options;
     return autoRetryFetch(async (...args) => {
@@ -3910,8 +3917,11 @@ var _Provider = class {
   }
   /**
    * Creates a new instance of the Provider class. This is the recommended way to initialize a Provider.
+   *
    * @param url - GraphQL endpoint of the Fuel node
    * @param options - Additional options for the provider
+   *
+   * @returns A promise that resolves to a Provider instance.
    */
   static async create(url, options = {}) {
     const provider = new _Provider(url, options);
@@ -3920,6 +3930,8 @@ var _Provider = class {
   }
   /**
    * Returns the cached chainInfo for the current URL.
+   *
+   * @returns the chain information configuration.
    */
   getChain() {
     const chain = _Provider.chainInfoCache[this.url];
@@ -3933,6 +3945,8 @@ var _Provider = class {
   }
   /**
    * Returns the cached nodeInfo for the current URL.
+   *
+   * @returns the node information configuration.
    */
   getNode() {
     const node = _Provider.nodeInfoCache[this.url];
@@ -3964,6 +3978,9 @@ var _Provider = class {
   }
   /**
    * Updates the URL for the provider and fetches the consensus parameters for the new URL, if needed.
+   *
+   * @param url - The URL to connect to.
+   * @param options - Additional options for the provider.
    */
   async connect(url, options) {
     this.url = url;
@@ -3972,9 +3989,9 @@ var _Provider = class {
     await this.fetchChainAndNodeInfo();
   }
   /**
-   * Fetches both the chain and node information, saves it to the cache, and return it.
+   * Return the chain and node information.
    *
-   * @returns NodeInfo and Chain
+   * @returns A promise that resolves to the Chain and NodeInfo.
    */
   async fetchChainAndNodeInfo() {
     const chain = await this.fetchChain();
@@ -3985,6 +4002,9 @@ var _Provider = class {
       nodeInfo
     };
   }
+  /**
+   * @hidden
+   */
   static ensureClientVersionIsSupported(nodeInfo) {
     const { isMajorSupported, isMinorSupported, supportedVersion } = checkFuelCoreVersionCompatibility(nodeInfo.nodeVersion);
     if (!isMajorSupported || !isMinorSupported) {
@@ -4000,6 +4020,7 @@ Supported fuel-core version: ${supportedVersion}.`
    * Create GraphQL client and set operations.
    *
    * @returns The operation SDK object
+   * @hidden
    */
   createOperations() {
     const fetchFn = _Provider.getFetchFn(this.options);
@@ -4044,18 +4065,18 @@ Supported fuel-core version: ${supportedVersion}.`
     return nodeVersion;
   }
   /**
-   * Returns the block number.
+   * Returns the latest block number.
    *
-   * @returns A promise that resolves to the block number
+   * @returns A promise that resolves to the latest block number.
    */
   async getBlockNumber() {
     const { chain } = await this.operations.getChain();
     return bn17(chain.latestBlock.height, 10);
   }
   /**
-   * Returns the chain information.
-   * @param url - The URL of the Fuel node
-   * @returns NodeInfo object
+   * Returns the node information for the current provider network.
+   *
+   * @returns a promise that resolves to the node information.
    */
   async fetchNode() {
     const { nodeInfo } = await this.operations.getNodeInfo();
@@ -4070,9 +4091,9 @@ Supported fuel-core version: ${supportedVersion}.`
     return processedNodeInfo;
   }
   /**
-   * Fetches the `chainInfo` for the given node URL.
-   * @param url - The URL of the Fuel node
-   * @returns ChainInfo object
+   * Returns the chain information for the current provider network.
+   *
+   * @returns a promise that resolves to the chain information.
    */
   async fetchChain() {
     const { chain } = await this.operations.getChain();
@@ -4081,8 +4102,9 @@ Supported fuel-core version: ${supportedVersion}.`
     return processedChain;
   }
   /**
-   * Returns the chain ID
-   * @returns A promise that resolves to the chain ID number
+   * Returns the chain ID for the current provider network.
+   *
+   * @returns A promise that resolves to the chain ID number.
    */
   getChainId() {
     const {
@@ -4091,9 +4113,9 @@ Supported fuel-core version: ${supportedVersion}.`
     return chainId.toNumber();
   }
   /**
-   * Returns the base asset ID for the current provider network
+   * Returns the base asset ID for the current provider network.
    *
-   * @returns the base asset ID
+   * @returns the base asset ID.
    */
   getBaseAssetId() {
     const {
@@ -4108,6 +4130,7 @@ Supported fuel-core version: ${supportedVersion}.`
    * the transaction will be mutated and those dependencies will be added.
    *
    * @param transactionRequestLike - The transaction request object.
+   * @param sendTransactionParams - The provider send transaction parameters (optional).
    * @returns A promise that resolves to the transaction response object.
    */
   // #region Provider-sendTransaction
@@ -4152,7 +4175,7 @@ Supported fuel-core version: ${supportedVersion}.`
    * the transaction will be mutated and those dependencies will be added.
    *
    * @param transactionRequestLike - The transaction request object.
-   * @param utxoValidation - Additional provider call parameters.
+   * @param sendTransactionParams - The provider call parameters (optional).
    * @returns A promise that resolves to the call result object.
    */
   async call(transactionRequestLike, { utxoValidation, estimateTxDependencies = true } = {}) {
@@ -4172,6 +4195,8 @@ Supported fuel-core version: ${supportedVersion}.`
   /**
    * Verifies whether enough gas is available to complete transaction.
    *
+   * @template T - The type of the transaction request object.
+   *
    * @param transactionRequest - The transaction request object.
    * @returns A promise that resolves to the estimated transaction request object.
    */
@@ -4206,9 +4231,8 @@ Supported fuel-core version: ${supportedVersion}.`
    * If there are missing variable outputs,
    * `addVariableOutputs` is called on the transaction.
    *
-   *
    * @param transactionRequest - The transaction request object.
-   * @returns A promise.
+   * @returns A promise that resolves to the estimate transaction dependencies.
    */
   async estimateTxDependencies(transactionRequest) {
     if (transactionRequest.type === TransactionType8.Create) {
@@ -4321,6 +4345,14 @@ Supported fuel-core version: ${supportedVersion}.`
     }
     return results;
   }
+  /**
+   * Dry runs multiple transactions.
+   *
+   * @param transactionRequests - Array of transaction request objects.
+   * @param sendTransactionParams - The provider call parameters (optional).
+   *
+   * @returns A promise that resolves to an array of results for each transaction call.
+   */
   async dryRunMultipleTransactions(transactionRequests, { utxoValidation, estimateTxDependencies = true } = {}) {
     if (estimateTxDependencies) {
       return this.estimateMultipleTxDependencies(transactionRequests);
@@ -4391,6 +4423,7 @@ Supported fuel-core version: ${supportedVersion}.`
    * the transaction will be mutated and those dependencies will be added
    *
    * @param transactionRequestLike - The transaction request object.
+   * @param estimateTxParams - The estimate transaction params (optional).
    * @returns A promise that resolves to the call result object.
    */
   async simulate(transactionRequestLike, { estimateTxDependencies = true } = {}) {
@@ -4415,14 +4448,9 @@ Supported fuel-core version: ${supportedVersion}.`
    * to set gasLimit and also reserve balance amounts
    * on the the transaction.
    *
-   * @privateRemarks
-   * The tolerance is add on top of the gasUsed calculated
-   * from the node, this create a safe margin costs like
-   * change states on transfer that don't occur on the dryRun
-   * transaction. The default value is 0.2 or 20%
-   *
    * @param transactionRequestLike - The transaction request object.
-   * @param tolerance - The tolerance to add on top of the gasUsed.
+   * @param transactionCostParams - The transaction cost parameters (optional).
+   *
    * @returns A promise that resolves to the transaction cost object.
    */
   async getTransactionCost(transactionRequestLike, { resourcesOwner, signatureCallback, quantitiesToContract = [] } = {}) {
@@ -4490,6 +4518,15 @@ Supported fuel-core version: ${supportedVersion}.`
       updateMaxFee
     };
   }
+  /**
+   * Get the required quantities and associated resources for a transaction.
+   *
+   * @param owner - address to add resources from.
+   * @param transactionRequestLike - transaction request to populate resources for.
+   * @param quantitiesToContract - quantities for the contract (optional).
+   *
+   * @returns a promise resolving to the required quantities for the transaction.
+   */
   async getResourcesForTransaction(owner, transactionRequestLike, quantitiesToContract = []) {
     const ownerAddress = Address2.fromAddressOrString(owner);
     const transactionRequest = transactionRequestify(clone3(transactionRequestLike));
@@ -4511,6 +4548,12 @@ Supported fuel-core version: ${supportedVersion}.`
   }
   /**
    * Returns coins for the given owner.
+   *
+   * @param owner - The address to get coins for.
+   * @param assetId - The asset ID of coins to get (optional).
+   * @param paginationArgs - Pagination arguments (optional).
+   *
+   * @returns A promise that resolves to the coins.
    */
   async getCoins(owner, assetId, paginationArgs) {
     const ownerAddress = Address2.fromAddressOrString(owner);
@@ -4533,8 +4576,8 @@ Supported fuel-core version: ${supportedVersion}.`
    * Returns resources for the given owner satisfying the spend query.
    *
    * @param owner - The address to get resources for.
-   * @param quantities - The quantities to get.
-   * @param excludedIds - IDs of excluded resources from the selection.
+   * @param quantities - The coin quantities to get.
+   * @param excludedIds - IDs of excluded resources from the selection (optional).
    * @returns A promise that resolves to the resources.
    */
   async getResourcesToSpend(owner, quantities, excludedIds) {
@@ -4589,7 +4632,7 @@ Supported fuel-core version: ${supportedVersion}.`
    * Returns block matching the given ID or height.
    *
    * @param idOrHeight - ID or height of the block.
-   * @returns A promise that resolves to the block.
+   * @returns A promise that resolves to the block or null.
    */
   async getBlock(idOrHeight) {
     let variables;
@@ -4719,7 +4762,7 @@ Supported fuel-core version: ${supportedVersion}.`
    * Returns balances for the given owner.
    *
    * @param owner - The address to get coins for.
-   * @param paginationArgs - Pagination arguments.
+   * @param paginationArgs - Pagination arguments (optional).
    * @returns A promise that resolves to the balances.
    */
   async getBalances(owner, paginationArgs) {
@@ -4738,7 +4781,7 @@ Supported fuel-core version: ${supportedVersion}.`
    * Returns message for the given address.
    *
    * @param address - The address to get message from.
-   * @param paginationArgs - Pagination arguments.
+   * @param paginationArgs - Pagination arguments (optional).
    * @returns A promise that resolves to the messages.
    */
   async getMessages(address, paginationArgs) {
@@ -4769,8 +4812,8 @@ Supported fuel-core version: ${supportedVersion}.`
    *
    * @param transactionId - The transaction to get message from.
    * @param messageId - The message id from MessageOut receipt.
-   * @param commitBlockId - The commit block id.
-   * @param commitBlockHeight - The commit block height.
+   * @param commitBlockId - The commit block id (optional).
+   * @param commitBlockHeight - The commit block height (optional).
    * @returns A promise that resolves to the message proof.
    */
   async getMessageProof(transactionId, nonce, commitBlockId, commitBlockHeight) {
@@ -4858,10 +4901,21 @@ Supported fuel-core version: ${supportedVersion}.`
       data
     };
   }
+  /**
+   * Get the latest gas price from the node.
+   *
+   * @returns A promise that resolves to the latest gas price.
+   */
   async getLatestGasPrice() {
     const { latestGasPrice } = await this.operations.getLatestGasPrice();
     return bn17(latestGasPrice.gasPrice);
   }
+  /**
+   * Returns the estimate gas price for the given block horizon.
+   *
+   * @param blockHorizon - The block horizon to estimate gas price for.
+   * @returns A promise that resolves to the estimated gas price.
+   */
   async estimateGasPrice(blockHorizon) {
     const { estimateGasPrice } = await this.operations.estimateGasPrice({
       blockHorizon: String(blockHorizon)
@@ -4881,8 +4935,8 @@ Supported fuel-core version: ${supportedVersion}.`
   /**
    * Lets you produce blocks with custom timestamps and the block number of the last block produced.
    *
-   * @param amount - The amount of blocks to produce
-   * @param startTime - The UNIX timestamp (milliseconds) to set for the first produced block
+   * @param amount - The amount of blocks to produce.
+   * @param startTime - The UNIX timestamp (milliseconds) to set for the first produced block (optional).
    * @returns A promise that resolves to the block number of the last produced block.
    */
   async produceBlocks(amount, startTime) {
@@ -4892,6 +4946,12 @@ Supported fuel-core version: ${supportedVersion}.`
     });
     return bn17(latestBlockHeight);
   }
+  /**
+   * Get the transaction response for the given transaction ID.
+   *
+   * @param transactionId - The transaction ID to get the response for.
+   * @returns A promise that resolves to the transaction response.
+   */
   // eslint-disable-next-line @typescript-eslint/require-await
   async getTransactionResponse(transactionId) {
     return new TransactionResponse(transactionId, this);
@@ -4900,7 +4960,7 @@ Supported fuel-core version: ${supportedVersion}.`
    * Returns Message for given nonce.
    *
    * @param nonce - The nonce of the message to retrieve.
-   * @returns A promise that resolves to the Message object.
+   * @returns A promise that resolves to the Message object or null.
    */
   async getMessageByNonce(nonce) {
     const { message } = await this.operations.getMessageByNonce({ nonce });
@@ -4909,6 +4969,12 @@ Supported fuel-core version: ${supportedVersion}.`
     }
     return message;
   }
+  /**
+   * Get the relayed transaction for the given transaction ID.
+   *
+   * @param relayedTransactionId - The relayed transaction ID to get the response for.
+   * @returns A promise that resolves to the relayed transaction.
+   */
   async getRelayedTransactionStatus(relayedTransactionId) {
     const { relayedTransactionStatus } = await this.operations.getRelayedTransactionStatus({
       relayedTransactionId
@@ -4918,6 +4984,9 @@ Supported fuel-core version: ${supportedVersion}.`
     }
     return relayedTransactionStatus;
   }
+  /**
+   * @hidden
+   */
   extractDryRunError(transactionRequest, receipts, dryRunStatus) {
     const status = dryRunStatus;
     let logs = [];
@@ -4947,7 +5016,9 @@ cacheInputs_fn = function(inputs) {
     }
   });
 };
+/** @hidden */
 __publicField(Provider, "chainInfoCache", {});
+/** @hidden */
 __publicField(Provider, "nodeInfoCache", {});
 
 // src/providers/transaction-summary/get-transaction-summary.ts
@@ -4983,6 +5054,7 @@ async function getTransactionSummary(params) {
     }
   } = provider.getChain();
   const gasPrice = await provider.getLatestGasPrice();
+  const baseAssetId = provider.getBaseAssetId();
   const transactionInfo = assembleTransactionSummary({
     id: gqlTransaction.id,
     receipts,
@@ -4995,7 +5067,8 @@ async function getTransactionSummary(params) {
     maxInputs,
     gasCosts,
     maxGasPerTx,
-    gasPrice
+    gasPrice,
+    baseAssetId
   });
   return {
     gqlTransaction,
@@ -5010,6 +5083,7 @@ async function getTransactionSummaryFromRequest(params) {
   const transaction = transactionRequest.toTransaction();
   const transactionBytes = transactionRequest.toTransactionBytes();
   const gasPrice = await provider.getLatestGasPrice();
+  const baseAssetId = provider.getBaseAssetId();
   const transactionSummary = assembleTransactionSummary({
     receipts,
     transaction,
@@ -5020,7 +5094,8 @@ async function getTransactionSummaryFromRequest(params) {
     maxInputs,
     gasCosts,
     maxGasPerTx,
-    gasPrice
+    gasPrice,
+    baseAssetId
   });
   return transactionSummary;
 }
@@ -5036,6 +5111,7 @@ async function getTransactionsSummaries(params) {
     }
   } = provider.getChain();
   const gasPrice = await provider.getLatestGasPrice();
+  const baseAssetId = provider.getBaseAssetId();
   const transactions = edges.map((edge) => {
     const { node: gqlTransaction } = edge;
     const { id, rawPayload, status } = gqlTransaction;
@@ -5057,7 +5133,8 @@ async function getTransactionsSummaries(params) {
       maxInputs,
       gasCosts,
       maxGasPerTx,
-      gasPrice
+      gasPrice,
+      baseAssetId
     });
     const output = {
       gqlTransaction,
@@ -5243,12 +5320,16 @@ var Account = class extends AbstractAccount {
    * The provider used to interact with the network.
    */
   _provider;
+  /**
+   * The connector for use with external wallets
+   */
   _connector;
   /**
    * Creates a new Account instance.
    *
    * @param address - The address of the account.
    * @param provider - A Provider instance  (optional).
+   * @param connector - A FuelConnector instance (optional).
    */
   constructor(address, provider, connector) {
     super();
@@ -5290,8 +5371,8 @@ var Account = class extends AbstractAccount {
   /**
    * Retrieves resources satisfying the spend query for the account.
    *
-   * @param quantities - IDs of coins to exclude.
-   * @param excludedIds - IDs of resources to be excluded from the query.
+   * @param quantities - Quantities of resources to be obtained.
+   * @param excludedIds - IDs of resources to be excluded from the query (optional).
    * @returns A promise that resolves to an array of Resources.
    */
   async getResourcesToSpend(quantities, excludedIds) {
@@ -5300,7 +5381,7 @@ var Account = class extends AbstractAccount {
   /**
    * Retrieves coins owned by the account.
    *
-   * @param assetId - The asset ID of the coins to retrieve.
+   * @param assetId - The asset ID of the coins to retrieve (optional).
    * @returns A promise that resolves to an array of Coins.
    */
   async getCoins(assetId) {
@@ -5353,7 +5434,7 @@ var Account = class extends AbstractAccount {
   /**
    * Retrieves the balance of the account for the given asset.
    *
-   * @param assetId - The asset ID to check the balance for.
+   * @param assetId - The asset ID to check the balance for (optional).
    * @returns A promise that resolves to the balance amount.
    */
   async getBalance(assetId) {
@@ -5393,7 +5474,7 @@ var Account = class extends AbstractAccount {
    * @typeParam T - The type of the TransactionRequest.
    * @param request - The transaction request to fund.
    * @param params - The estimated transaction parameters.
-   * @returns The funded transaction request.
+   * @returns A promise that resolves to the funded transaction request.
    */
   async fund(request, params) {
     const { addedSignatures, estimatedPredicates, requiredQuantities, updateMaxFee } = params;
@@ -5486,25 +5567,14 @@ var Account = class extends AbstractAccount {
    *
    * @param destination - The address of the destination.
    * @param amount - The amount of coins to transfer.
-   * @param assetId - The asset ID of the coins to transfer.
-   * @param txParams - The transaction parameters (gasLimit, tip, maturity, maxFee, witnessLimit).
+   * @param assetId - The asset ID of the coins to transfer (optional).
+   * @param txParams - The transaction parameters (optional).
    * @returns A promise that resolves to the prepared transaction request.
    */
   async createTransfer(destination, amount, assetId, txParams = {}) {
     let request = new ScriptTransactionRequest(txParams);
-    const assetIdToTransfer = assetId ?? this.provider.getBaseAssetId();
-    request.addCoinOutput(Address3.fromAddressOrString(destination), amount, assetIdToTransfer);
-    const txCost = await this.provider.getTransactionCost(request, {
-      estimateTxDependencies: true,
-      resourcesOwner: this
-    });
-    request = this.validateGasLimitAndMaxFee({
-      transactionRequest: request,
-      gasUsed: txCost.gasUsed,
-      maxFee: txCost.maxFee,
-      txParams
-    });
-    await this.fund(request, txCost);
+    request = this.addTransfer(request, { destination, amount, assetId });
+    request = await this.estimateAndFundTransaction(request, txParams);
     return request;
   }
   /**
@@ -5512,28 +5582,69 @@ var Account = class extends AbstractAccount {
    *
    * @param destination - The address of the destination.
    * @param amount - The amount of coins to transfer.
-   * @param assetId - The asset ID of the coins to transfer.
-   * @param txParams - The transaction parameters (gasLimit, maturity).
+   * @param assetId - The asset ID of the coins to transfer (optional).
+   * @param txParams - The transaction parameters (optional).
    * @returns A promise that resolves to the transaction response.
    */
   async transfer(destination, amount, assetId, txParams = {}) {
-    if (bn19(amount).lte(0)) {
-      throw new FuelError15(
-        ErrorCode15.INVALID_TRANSFER_AMOUNT,
-        "Transfer amount must be a positive number."
-      );
-    }
-    const assetIdToTransfer = assetId ?? this.provider.getBaseAssetId();
-    const request = await this.createTransfer(destination, amount, assetIdToTransfer, txParams);
+    const request = await this.createTransfer(destination, amount, assetId, txParams);
+    return this.sendTransaction(request, { estimateTxDependencies: false });
+  }
+  /**
+   * Transfers multiple amounts of a token to multiple recipients.
+   *
+   * @param transferParams - An array of `TransferParams` objects representing the transfers to be made.
+   * @param txParams - Optional transaction parameters.
+   * @returns A promise that resolves to a `TransactionResponse` object representing the transaction result.
+   */
+  async batchTransfer(transferParams, txParams = {}) {
+    let request = new ScriptTransactionRequest(txParams);
+    request = this.addBatchTransfer(request, transferParams);
+    request = await this.estimateAndFundTransaction(request, txParams);
     return this.sendTransaction(request, { estimateTxDependencies: false });
   }
+  /**
+   * Adds a transfer to the given transaction request.
+   *
+   * @param request - The script transaction request to add transfers to.
+   * @param transferParams - The object representing the transfer to be made.
+   * @returns The updated transaction request with the added transfer.
+   */
+  addTransfer(request, transferParams) {
+    const { destination, amount, assetId } = transferParams;
+    this.validateTransferAmount(amount);
+    request.addCoinOutput(
+      Address3.fromAddressOrString(destination),
+      amount,
+      assetId ?? this.provider.getBaseAssetId()
+    );
+    return request;
+  }
+  /**
+   * Adds multiple transfers to a script transaction request.
+   *
+   * @param request - The script transaction request to add transfers to.
+   * @param transferParams - An array of `TransferParams` objects representing the transfers to be made.
+   * @returns The updated script transaction request.
+   */
+  addBatchTransfer(request, transferParams) {
+    const baseAssetId = this.provider.getBaseAssetId();
+    transferParams.forEach(({ destination, amount, assetId }) => {
+      this.addTransfer(request, {
+        destination,
+        amount,
+        assetId: assetId ?? baseAssetId
+      });
+    });
+    return request;
+  }
   /**
    * Transfers coins to a contract address.
    *
    * @param contractId - The address of the contract.
    * @param amount - The amount of coins to transfer.
-   * @param assetId - The asset ID of the coins to transfer.
-   * @param txParams - The optional transaction parameters.
+   * @param assetId - The asset ID of the coins to transfer (optional).
+   * @param txParams - The transaction parameters (optional).
    * @returns A promise that resolves to the transaction response.
    */
   async transferToContract(contractId, amount, assetId, txParams = {}) {
@@ -5574,7 +5685,7 @@ var Account = class extends AbstractAccount {
    *
    * @param recipient - Address of the recipient on the base chain.
    * @param amount - Amount of base asset.
-   * @param txParams - The optional transaction parameters.
+   * @param txParams - The transaction parameters (optional).
    * @returns A promise that resolves to the transaction response.
    */
   async withdrawToBaseLayer(recipient, amount, txParams = {}) {
@@ -5604,6 +5715,14 @@ var Account = class extends AbstractAccount {
     await this.fund(request, txCost);
     return this.sendTransaction(request);
   }
+  /**
+   * Sign a message from the account via the connector.
+   *
+   * @param message - the message to sign.
+   * @returns a promise that resolves to the signature.
+   *
+   * @hidden
+   */
   async signMessage(message) {
     if (!this._connector) {
       throw new FuelError15(ErrorCode15.MISSING_CONNECTOR, "A connector is required to sign messages.");
@@ -5611,7 +5730,7 @@ var Account = class extends AbstractAccount {
     return this._connector.signMessage(this.address.toString(), message);
   }
   /**
-   * Signs a transaction with the wallet's private key.
+   * Signs a transaction from the account via the connector..
    *
    * @param transactionRequestLike - The transaction request to sign.
    * @returns A promise that resolves to the signature of the transaction.
@@ -5629,6 +5748,7 @@ var Account = class extends AbstractAccount {
    * Sends a transaction to the network.
    *
    * @param transactionRequestLike - The transaction request to be sent.
+   * @param sendTransactionParams - The provider send transaction parameters (optional).
    * @returns A promise that resolves to the transaction response.
    */
   async sendTransaction(transactionRequestLike, { estimateTxDependencies = true, awaitExecution } = {}) {
@@ -5650,6 +5770,7 @@ var Account = class extends AbstractAccount {
    * Simulates a transaction.
    *
    * @param transactionRequestLike - The transaction request to be simulated.
+   * @param estimateTxParams - The estimate transaction params (optional).
    * @returns A promise that resolves to the call result.
    */
   async simulateTransaction(transactionRequestLike, { estimateTxDependencies = true } = {}) {
@@ -5659,6 +5780,31 @@ var Account = class extends AbstractAccount {
     }
     return this.provider.simulate(transactionRequest, { estimateTxDependencies: false });
   }
+  /** @hidden * */
+  validateTransferAmount(amount) {
+    if (bn19(amount).lte(0)) {
+      throw new FuelError15(
+        ErrorCode15.INVALID_TRANSFER_AMOUNT,
+        "Transfer amount must be a positive number."
+      );
+    }
+  }
+  /** @hidden * */
+  async estimateAndFundTransaction(transactionRequest, txParams) {
+    let request = transactionRequest;
+    const txCost = await this.provider.getTransactionCost(request, {
+      resourcesOwner: this
+    });
+    request = this.validateGasLimitAndMaxFee({
+      transactionRequest: request,
+      gasUsed: txCost.gasUsed,
+      maxFee: txCost.maxFee,
+      txParams
+    });
+    request = await this.fund(request, txCost);
+    return request;
+  }
+  /** @hidden * */
   validateGasLimitAndMaxFee({
     gasUsed,
     maxFee,
@@ -5970,6 +6116,8 @@ var BaseWalletUnlocked = class extends Account {
    * Populates the witness signature for a transaction and sends it to the network using `provider.sendTransaction`.
    *
    * @param transactionRequestLike - The transaction request to send.
+   * @param estimateTxDependencies - Whether to estimate the transaction dependencies.
+   * @param awaitExecution - Whether to wait for the transaction to be executed.
    * @returns A promise that resolves to the TransactionResponse object.
    */
   async sendTransaction(transactionRequestLike, { estimateTxDependencies = false, awaitExecution } = {}) {
@@ -6001,6 +6149,12 @@ var BaseWalletUnlocked = class extends Account {
       }
     );
   }
+  /**
+   * Encrypts an unlocked wallet with a password.
+   *
+   * @param password - the password to encrypt the wallet with.
+   * @returns - the encrypted wallet.
+   */
   async encrypt(password) {
     return encryptKeystoreWallet(this.privateKey, this.address, password);
   }
@@ -9278,7 +9432,8 @@ var Predicate = class extends Account {
     );
     return resources.map((resource) => ({
       ...resource,
-      predicate: hexlify19(this.bytes)
+      predicate: hexlify19(this.bytes),
+      predicateData: hexlify19(this.getPredicateData())
     }));
   }
   /**