@fuel-ts/account 0.88.1 → 0.89.1

package/dist/test-utils.js

@@ -1765,6 +1765,8 @@ var import_transactions6 = require("@fuel-ts/transactions");
 var isRequestInputCoin = (input) => input.type === import_transactions6.InputType.Coin;
 var isRequestInputMessage = (input) => input.type === import_transactions6.InputType.Message;
 var isRequestInputResource = (input) => isRequestInputCoin(input) || isRequestInputMessage(input);
+var getRequestInputResourceOwner = (input) => isRequestInputCoin(input) ? input.owner : input.recipient;
+var isRequestInputResourceFromOwner = (input, owner) => getRequestInputResourceOwner(input) === owner.toB256();
 var getAssetAmountInRequestInputs = (inputs, assetId, baseAsset) => inputs.filter(isRequestInputResource).reduce((acc, input) => {
   if (isRequestInputCoin(input) && input.assetId === assetId) {
     return acc.add(input.amount);
@@ -2027,7 +2029,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;
@@ -2045,7 +2047,8 @@ var BaseTransactionRequest = class {
       assetId,
       txPointer: "0x00000000000000000000000000000000",
       witnessIndex,
-      predicate
+      predicate,
+      predicateData
     };
     this.pushInput(input);
     this.addChangeOutput(owner, assetId);
@@ -2057,7 +2060,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;
@@ -2074,7 +2077,8 @@ var BaseTransactionRequest = class {
       recipient: recipient.toB256(),
       amount,
       witnessIndex,
-      predicate
+      predicate,
+      predicateData
     };
     this.pushInput(input);
     this.addChangeOutput(recipient, assetId);
@@ -2276,23 +2280,13 @@ var BaseTransactionRequest = class {
     });
   }
   updatePredicateGasUsed(inputs) {
-    this.inputs.forEach((i) => {
-      let correspondingInput;
-      switch (i.type) {
-        case import_transactions7.InputType.Coin:
-          correspondingInput = inputs.find((x) => x.type === import_transactions7.InputType.Coin && x.owner === i.owner);
-          break;
-        case import_transactions7.InputType.Message:
-          correspondingInput = inputs.find(
-            (x) => x.type === import_transactions7.InputType.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, import_address.Address.fromString(String(owner)))
+      );
       if (correspondingInput && "predicateGasUsed" in correspondingInput && (0, import_math8.bn)(correspondingInput.predicateGasUsed).gt(0)) {
-        i.predicate = correspondingInput.predicate;
-        i.predicateData = correspondingInput.predicateData;
         i.predicateGasUsed = correspondingInput.predicateGasUsed;
       }
     });
@@ -2625,6 +2619,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 {
@@ -2993,13 +2994,13 @@ function addOperation(operations, toAdd) {
 }
 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, {
@@ -3016,7 +3017,7 @@ function getWithdrawFromFuelOperations({
           assetsSent: [
             {
               amount: receipt.amount,
-              assetId
+              assetId: baseAssetId
             }
           ]
         });
@@ -3212,7 +3213,8 @@ function getOperations({
   receipts,
   abiMap,
   rawPayload,
-  maxInputs
+  maxInputs,
+  baseAssetId
 }) {
   if (isTypeCreate(transactionType)) {
     return [
@@ -3231,7 +3233,7 @@ function getOperations({
         rawPayload,
         maxInputs
       }),
-      ...getWithdrawFromFuelOperations({ inputs, receipts })
+      ...getWithdrawFromFuelOperations({ inputs, receipts, baseAssetId })
     ];
   }
   return [...getPayProducerOperations(outputs)];
@@ -3367,7 +3369,8 @@ function assembleTransactionSummary(params) {
     maxInputs,
     gasCosts,
     maxGasPerTx,
-    gasPrice
+    gasPrice,
+    baseAssetId
   } = params;
   const gasUsed = getGasUsedFromReceipts(receipts);
   const rawPayload = (0, import_utils18.hexlify)(transactionBytes);
@@ -3378,7 +3381,8 @@ function assembleTransactionSummary(params) {
     receipts,
     rawPayload,
     abiMap,
-    maxInputs
+    maxInputs,
+    baseAssetId
   });
   const typeName = getTransactionTypeName(transaction.type);
   const tip = (0, import_math15.bn)(transaction.policies?.find((policy) => policy.type === import_transactions17.PolicyType.Tip)?.data);
@@ -3538,6 +3542,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,
@@ -3550,7 +3555,8 @@ var TransactionResponse = class {
       maxInputs,
       gasCosts,
       maxGasPerTx,
-      gasPrice
+      gasPrice,
+      baseAssetId
     });
     return transactionSummary;
   }
@@ -3738,7 +3744,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
    */
@@ -3761,10 +3766,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) => {
@@ -3780,8 +3789,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);
@@ -3790,6 +3802,8 @@ var _Provider = class {
   }
   /**
    * Returns the cached chainInfo for the current URL.
+   *
+   * @returns the chain information configuration.
    */
   getChain() {
     const chain = _Provider.chainInfoCache[this.url];
@@ -3803,6 +3817,8 @@ var _Provider = class {
   }
   /**
    * Returns the cached nodeInfo for the current URL.
+   *
+   * @returns the node information configuration.
    */
   getNode() {
     const node = _Provider.nodeInfoCache[this.url];
@@ -3834,6 +3850,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;
@@ -3842,9 +3861,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();
@@ -3855,6 +3874,9 @@ var _Provider = class {
       nodeInfo
     };
   }
+  /**
+   * @hidden
+   */
   static ensureClientVersionIsSupported(nodeInfo) {
     const { isMajorSupported, isMinorSupported, supportedVersion } = (0, import_versions.checkFuelCoreVersionCompatibility)(nodeInfo.nodeVersion);
     if (!isMajorSupported || !isMinorSupported) {
@@ -3870,6 +3892,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);
@@ -3914,18 +3937,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 (0, import_math17.bn)(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();
@@ -3940,9 +3963,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();
@@ -3951,8 +3974,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 {
@@ -3961,9 +3985,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 {
@@ -3978,6 +4002,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
@@ -4022,7 +4047,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 } = {}) {
@@ -4042,6 +4067,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.
    */
@@ -4076,9 +4103,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 === import_transactions20.TransactionType.Create) {
@@ -4191,6 +4217,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);
@@ -4261,6 +4295,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 } = {}) {
@@ -4285,14 +4320,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 = [] } = {}) {
@@ -4360,6 +4390,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 = import_address3.Address.fromAddressOrString(owner);
     const transactionRequest = transactionRequestify((0, import_ramda3.clone)(transactionRequestLike));
@@ -4381,6 +4420,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 = import_address3.Address.fromAddressOrString(owner);
@@ -4403,8 +4448,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) {
@@ -4459,7 +4504,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;
@@ -4589,7 +4634,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) {
@@ -4608,7 +4653,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) {
@@ -4639,8 +4684,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) {
@@ -4728,10 +4773,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 (0, import_math17.bn)(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)
@@ -4751,8 +4807,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) {
@@ -4762,6 +4818,12 @@ Supported fuel-core version: ${supportedVersion}.`
     });
     return (0, import_math17.bn)(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);
@@ -4770,7 +4832,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 });
@@ -4779,6 +4841,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
@@ -4788,6 +4856,9 @@ Supported fuel-core version: ${supportedVersion}.`
     }
     return relayedTransactionStatus;
   }
+  /**
+   * @hidden
+   */
   extractDryRunError(transactionRequest, receipts, dryRunStatus) {
     const status = dryRunStatus;
     let logs = [];
@@ -4817,7 +4888,9 @@ cacheInputs_fn = function(inputs) {
     }
   });
 };
+/** @hidden */
 __publicField(Provider, "chainInfoCache", {});
+/** @hidden */
 __publicField(Provider, "nodeInfoCache", {});
 
 // src/providers/transaction-summary/get-transaction-summary.ts
@@ -4944,12 +5017,16 @@ var Account = class extends import_interfaces.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();
@@ -4991,8 +5068,8 @@ var Account = class extends import_interfaces.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) {
@@ -5001,7 +5078,7 @@ var Account = class extends import_interfaces.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) {
@@ -5054,7 +5131,7 @@ var Account = class extends import_interfaces.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) {
@@ -5094,7 +5171,7 @@ var Account = class extends import_interfaces.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;
@@ -5187,25 +5264,14 @@ var Account = class extends import_interfaces.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(import_address4.Address.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;
   }
   /**
@@ -5213,28 +5279,69 @@ var Account = class extends import_interfaces.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 ((0, import_math20.bn)(amount).lte(0)) {
-      throw new import_errors16.FuelError(
-        import_errors16.ErrorCode.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(
+      import_address4.Address.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 = {}) {
@@ -5275,7 +5382,7 @@ var Account = class extends import_interfaces.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 = {}) {
@@ -5305,6 +5412,14 @@ var Account = class extends import_interfaces.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 import_errors16.FuelError(import_errors16.ErrorCode.MISSING_CONNECTOR, "A connector is required to sign messages.");
@@ -5312,7 +5427,7 @@ var Account = class extends import_interfaces.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.
@@ -5330,6 +5445,7 @@ var Account = class extends import_interfaces.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 } = {}) {
@@ -5351,6 +5467,7 @@ var Account = class extends import_interfaces.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 } = {}) {
@@ -5360,6 +5477,31 @@ var Account = class extends import_interfaces.AbstractAccount {
     }
     return this.provider.simulate(transactionRequest, { estimateTxDependencies: false });
   }
+  /** @hidden * */
+  validateTransferAmount(amount) {
+    if ((0, import_math20.bn)(amount).lte(0)) {
+      throw new import_errors16.FuelError(
+        import_errors16.ErrorCode.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,
@@ -5659,6 +5801,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 } = {}) {
@@ -5690,6 +5834,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);
   }
@@ -8433,7 +8583,6 @@ var generateTestWallet = async (provider, quantities) => {
 var import_abi_coder7 = require("@fuel-ts/abi-coder");
 var import_crypto7 = require("@fuel-ts/crypto");
 var import_utils36 = require("@fuel-ts/utils");
-var import_cli_utils = require("@fuel-ts/utils/cli-utils");
 var import_child_process = require("child_process");
 var import_crypto8 = require("crypto");
 var import_fs = require("fs");
@@ -8476,7 +8625,7 @@ var launchNode = async ({
   ip,
   port,
   args = [],
-  useSystemFuelCore = false,
+  fuelCorePath = process.env.FUEL_CORE_PATH ?? void 0,
   loggingEnabled = true,
   debugEnabled = false,
   basePath
@@ -8495,9 +8644,9 @@ var launchNode = async ({
     const useInMemoryDb = dbTypeFlagValue === "in-memory" || dbTypeFlagValue === void 0;
     const poaInstantFlagValue = getFlagValueFromArgs(args, "--poa-instant");
     const poaInstant = poaInstantFlagValue === "true" || poaInstantFlagValue === void 0;
+    const nativeExecutorVersion = getFlagValueFromArgs(args, "--native-executor-version") || "0";
     const graphQLStartSubstring = "Binding GraphQL provider to";
-    const binPath = (0, import_cli_utils.findBinPath)("fuels-core", __dirname);
-    const command = useSystemFuelCore ? "fuel-core" : binPath;
+    const command = fuelCorePath ?? "fuel-core";
     const ipToUse = ip || "0.0.0.0";
     const portToUse = port || (await (0, import_portfinder.getPortPromise)({
       port: 4e3,
@@ -8536,7 +8685,7 @@ var launchNode = async ({
         const signer = new Signer(pk);
         process.env.GENESIS_SECRET = (0, import_utils36.hexlify)(pk);
         stateConfigJson.coins.push({
-          tx_id: (0, import_utils36.hexlify)((0, import_crypto7.randomBytes)(import_abi_coder7.UTXO_ID_LEN)),
+          tx_id: (0, import_utils36.hexlify)((0, import_crypto7.randomBytes)(import_abi_coder7.BYTES_32)),
           owner: signer.address.toHexString(),
           // eslint-disable-next-line @typescript-eslint/no-explicit-any
           amount: "18446744073709551615",
@@ -8568,6 +8717,7 @@ var launchNode = async ({
         useInMemoryDb ? ["--db-type", "in-memory"] : ["--db-path", tempDirPath],
         ["--min-gas-price", "1"],
         poaInstant ? ["--poa-instant", "true"] : [],
+        ["--native-executor-version", nativeExecutorVersion],
         ["--consensus-key", consensusKey],
         ["--snapshot", snapshotDirToUse],
         "--vm-backtrace",