@fuel-ts/account 0.101.2 → 0.101.3

package/dist/test-utils.js

@@ -255,8 +255,9 @@ var launchNode = /* @__PURE__ */ __name(async ({
       "--consensus-key",
       "--db-type",
       "--poa-instant",
+      "--native-executor-version",
       "--min-gas-price",
-      "--native-executor-version"
+      "--starting-gas-price"
     ]);
     const snapshotDir = getFlagValueFromArgs(args, "--snapshot");
     const consensusKey = getFlagValueFromArgs(args, "--consensus-key") || import_utils2.defaultConsensusKey;
@@ -406,7 +407,7 @@ var launchNode = /* @__PURE__ */ __name(async ({
 
 // src/test-utils/setup-test-provider-and-wallets.ts
 var import_utils47 = require("@fuel-ts/utils");
-var import_ramda10 = require("ramda");
+var import_ramda11 = require("ramda");
 
 // src/providers/coin-quantity.ts
 var import_math2 = require("@fuel-ts/math");
@@ -1847,8 +1848,11 @@ var import_graphql = require("graphql");
 
 // src/providers/utils/handle-gql-error-message.ts
 var import_errors3 = require("@fuel-ts/errors");
+var ASSET_ID_REGEX = /[0-9a-fA-F]{32,64}/g;
 var gqlErrorMessage = {
   RPC_CONSISTENCY: /The required fuel block height is higher than the current block height. Required: \d+, Current: \d+/,
+  INSUFFICIENT_FUNDS: /the target cannot be met due to insufficient coins available for [0-9a-fA-F]{32,64}. Collected: \d+/,
+  MAX_COINS_REACHED: /the target for [0-9a-fA-F]{32,64} cannot be met due to exceeding the \d+ coin limit. Collected: \d+./,
   NOT_ENOUGH_COINS_MAX_COINS: /the target cannot be met due to no coins available or exceeding the \d+ coin limit./,
   ASSET_NOT_FOUND: /resource was not found in table/,
   MULTIPLE_CHANGE_POLICIES: /The asset ([a-fA-F0-9]{64}) has multiple change policies/,
@@ -1864,6 +1868,46 @@ var mapGqlErrorMessage = /* @__PURE__ */ __name((error) => {
       error
     );
   }
+  if (gqlErrorMessage.MAX_COINS_REACHED.test(error.message)) {
+    const matches = error.message.match(ASSET_ID_REGEX);
+    const assetId = matches ? `0x${matches[0]}` : null;
+    const owner = matches ? `0x${matches[1]}` : null;
+    let suffix = "";
+    if (assetId) {
+      suffix += `
+	Asset ID: '${assetId}'.`;
+    }
+    if (owner) {
+      suffix += `
+	Owner: '${owner}'.`;
+    }
+    return new import_errors3.FuelError(
+      import_errors3.ErrorCode.MAX_COINS_REACHED,
+      `You have too many small value coins - consider combining UTXOs.${suffix}`,
+      { assetId, owner },
+      error
+    );
+  }
+  if (gqlErrorMessage.INSUFFICIENT_FUNDS.test(error.message)) {
+    const matches = error.message.match(ASSET_ID_REGEX);
+    const assetId = matches ? `0x${matches[0]}` : null;
+    const owner = matches ? `0x${matches[1]}` : null;
+    let suffix = "";
+    if (assetId) {
+      suffix += `
+	Asset ID: '${assetId}'.`;
+    }
+    if (owner) {
+      suffix += `
+	Owner: '${owner}'.`;
+    }
+    return new import_errors3.FuelError(
+      import_errors3.ErrorCode.INSUFFICIENT_FUNDS,
+      `Insufficient funds.${suffix}`,
+      { assetId, owner },
+      error
+    );
+  }
   if (gqlErrorMessage.MULTIPLE_CHANGE_POLICIES.test(error.message)) {
     const match = error.message.match(/asset ([a-fA-F0-9]{64})/);
     const assetId = match?.[1] || "";
@@ -2946,6 +2990,7 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
   }
   return new import_errors9.FuelError(import_errors9.ErrorCode.SCRIPT_REVERTED, errorMessage, {
     ...metadata,
+    abiError,
     reason
   });
 }
@@ -3968,11 +4013,15 @@ var ScriptTransactionRequest = class extends BaseTransactionRequest {
    * @deprecated Use `provider.assembleTx` instead.
    * Check the migration guide https://docs.fuel.network/guide/assembling-transactions/migration-guide.html for more information.
    */
-  async estimateAndFund(account, { signatureCallback, quantities = [] } = {}) {
+  async estimateAndFund(account, {
+    signatureCallback,
+    quantities = [],
+    skipAutoConsolidation
+  } = {}) {
     const txCost = await account.getTransactionCost(this, { signatureCallback, quantities });
     this.maxFee = txCost.maxFee;
     this.gasLimit = txCost.gasUsed;
-    await account.fund(this, txCost);
+    await account.fund(this, txCost, { skipAutoConsolidation });
     return this;
   }
   /**
@@ -5536,25 +5585,6 @@ __name(getAllDecodedLogs, "getAllDecodedLogs");
 
 // src/providers/transaction-response/transaction-response.ts
 var TransactionResponse = class _TransactionResponse {
-  /**
-   * Constructor for `TransactionResponse`.
-   *
-   * @param tx - The transaction ID or TransactionRequest.
-   * @param provider - The provider.
-   */
-  constructor(tx, provider, chainId, abis, submitTxSubscription) {
-    this.submitTxSubscription = submitTxSubscription;
-    if (typeof tx === "string") {
-      this.id = tx;
-    } else {
-      this.id = tx.getTransactionId(chainId);
-      this.request = tx;
-    }
-    this.provider = provider;
-    this.abis = abis;
-    this.waitForResult = this.waitForResult.bind(this);
-    this.waitForPreConfirmation = this.waitForPreConfirmation.bind(this);
-  }
   static {
     __name(this, "TransactionResponse");
   }
@@ -5569,9 +5599,42 @@ var TransactionResponse = class _TransactionResponse {
   request;
   status;
   abis;
+  submitTxSubscription;
   preConfirmationStatus;
   waitingForStreamData = false;
   statusResolvers = /* @__PURE__ */ new Map();
+  /**
+   * Constructor for `TransactionResponse`.
+   */
+  constructor(constructorParams, provider, chainId, abis, submitTxSubscription) {
+    let tx;
+    let _provider;
+    let _chainId;
+    let _abis;
+    if (typeof constructorParams === "object" && "provider" in constructorParams && arguments.length === 1) {
+      tx = constructorParams.transactionRequestOrId;
+      _provider = constructorParams.provider;
+      _chainId = constructorParams.chainId;
+      _abis = constructorParams.abis;
+      this.submitTxSubscription = constructorParams.submitAndAwaitSubscription;
+    } else {
+      tx = constructorParams;
+      _provider = provider;
+      _chainId = chainId;
+      _abis = abis;
+      this.submitTxSubscription = submitTxSubscription;
+    }
+    if (typeof tx === "string") {
+      this.id = tx;
+    } else {
+      this.id = tx.getTransactionId(_chainId);
+      this.request = tx;
+    }
+    this.provider = _provider;
+    this.abis = _abis;
+    this.waitForResult = this.waitForResult.bind(this);
+    this.waitForPreConfirmation = this.waitForPreConfirmation.bind(this);
+  }
   /**
    * Async constructor for `TransactionResponse`. This method can be used to create
    * an instance of `TransactionResponse` and wait for the transaction to be fetched
@@ -6088,7 +6151,15 @@ var Provider = class _Provider {
       if (_Provider.ENABLE_RPC_CONSISTENCY && _Provider.hasWriteOperationHappened(url)) {
         _Provider.applyBlockHeight(fullRequest, url);
       }
-      return _Provider.fetchAndProcessBlockHeight(url, fullRequest, options);
+      const response = await _Provider.fetchAndProcessBlockHeight(url, fullRequest, options);
+      if (response.body === null) {
+        throw new import_errors21.FuelError(
+          import_errors21.ErrorCode.RESPONSE_BODY_EMPTY,
+          "The response from the server is missing the body",
+          { timestamp: (/* @__PURE__ */ new Date()).toISOString(), request, response }
+        );
+      }
+      return response;
     }, retryOptions);
   }
   static applyBlockHeight(request, url) {
@@ -6111,13 +6182,15 @@ var Provider = class _Provider {
       baseDelay: 500
     };
     for (let retriesLeft = retryOptions.maxRetries; retriesLeft > 0; --retriesLeft) {
-      const { extensions } = await parseGraphqlResponse({
-        response,
-        isSubscription: url.endsWith("-sub")
-      });
-      _Provider.setCurrentBlockHeight(url, extensions?.current_fuel_block_height);
-      if (!extensions?.fuel_block_height_precondition_failed) {
-        break;
+      if (response.body) {
+        const { extensions } = await parseGraphqlResponse({
+          response,
+          isSubscription: url.endsWith("-sub")
+        });
+        _Provider.setCurrentBlockHeight(url, extensions?.current_fuel_block_height);
+        if (!extensions?.fuel_block_height_precondition_failed) {
+          break;
+        }
       }
       const retryAttempt = retryOptions.maxRetries - retriesLeft + 1;
       const sleepTime = getWaitDelay(retryOptions, retryAttempt);
@@ -6540,7 +6613,13 @@ var Provider = class _Provider {
       transactionRequest.getTransactionId(await this.getChainId())
     );
     const chainId = await this.getChainId();
-    return new TransactionResponse(transactionRequest, this, chainId, abis, subscription);
+    return new TransactionResponse({
+      transactionRequestOrId: transactionRequest,
+      provider: this,
+      chainId,
+      abis,
+      submitAndAwaitSubscription: subscription
+    });
   }
   /**
    * Executes a transaction without actually submitting it to the chain.
@@ -7635,7 +7714,11 @@ var Provider = class _Provider {
    */
   async getTransactionResponse(transactionId) {
     const chainId = await this.getChainId();
-    return new TransactionResponse(transactionId, this, chainId);
+    return new TransactionResponse({
+      transactionRequestOrId: transactionId,
+      provider: this,
+      chainId
+    });
   }
   /**
    * Returns Message for given nonce.
@@ -7806,8 +7889,8 @@ var TestAssetId = class _TestAssetId {
 
 // src/test-utils/wallet-config.ts
 var import_crypto9 = require("@fuel-ts/crypto");
-var import_errors28 = require("@fuel-ts/errors");
-var import_math25 = require("@fuel-ts/math");
+var import_errors29 = require("@fuel-ts/errors");
+var import_math26 = require("@fuel-ts/math");
 var import_utils46 = require("@fuel-ts/utils");
 
 // src/wallet/base-wallet-unlocked.ts
@@ -7816,13 +7899,13 @@ var import_utils41 = require("@fuel-ts/utils");
 
 // src/account.ts
 var import_abi_coder10 = require("@fuel-ts/abi-coder");
-var import_address6 = require("@fuel-ts/address");
+var import_address7 = require("@fuel-ts/address");
 var import_crypto5 = require("@fuel-ts/crypto");
-var import_errors23 = require("@fuel-ts/errors");
-var import_math23 = require("@fuel-ts/math");
-var import_transactions28 = require("@fuel-ts/transactions");
+var import_errors24 = require("@fuel-ts/errors");
+var import_math24 = require("@fuel-ts/math");
+var import_transactions29 = require("@fuel-ts/transactions");
 var import_utils39 = require("@fuel-ts/utils");
-var import_ramda9 = require("ramda");
+var import_ramda10 = require("ramda");
 
 // src/types.ts
 var AbstractAccount = class {
@@ -7831,9 +7914,157 @@ var AbstractAccount = class {
   }
 };
 
+// src/utils/consolidate-coins.ts
+var import_address5 = require("@fuel-ts/address");
+var import_errors23 = require("@fuel-ts/errors");
+var import_math23 = require("@fuel-ts/math");
+var import_transactions28 = require("@fuel-ts/transactions");
+var import_ramda9 = require("ramda");
+var CONSOLIDATABLE_ERROR_CODES = [import_errors23.ErrorCode.MAX_COINS_REACHED];
+var consolidateCoinsIfRequired = /* @__PURE__ */ __name(async (opts) => {
+  const { error: errorUnknown, account, skipAutoConsolidation = false } = opts;
+  if (skipAutoConsolidation) {
+    return false;
+  }
+  const error = import_errors23.FuelError.parse(errorUnknown);
+  if (CONSOLIDATABLE_ERROR_CODES.includes(error.code)) {
+    const { assetId, owner } = error.metadata;
+    return account.startConsolidation({
+      owner,
+      assetId
+    });
+  }
+  return false;
+}, "consolidateCoinsIfRequired");
+var getAllCoins = /* @__PURE__ */ __name(async (account, assetId) => {
+  const all = [];
+  let hasNextPage = true;
+  let after;
+  while (hasNextPage) {
+    const { coins, pageInfo } = await account.getCoins(assetId, { after });
+    all.push(...coins);
+    after = coins.pop()?.id;
+    hasNextPage = pageInfo.hasNextPage;
+  }
+  return { coins: all };
+}, "getAllCoins");
+var sortCoins = /* @__PURE__ */ __name(({ coins }) => coins.sort((a, b) => b.amount.cmp(a.amount)), "sortCoins");
+var createOuputCoin = /* @__PURE__ */ __name((opts) => {
+  const { transactionId, outputs, baseAssetId } = opts;
+  const outputChangeIndex = outputs.findIndex(
+    (output) => output.type === import_transactions28.OutputType.Change && output.assetId === baseAssetId
+  );
+  if (outputChangeIndex === -1) {
+    throw new import_errors23.FuelError(import_errors23.ErrorCode.UNKNOWN, "No change output found");
+  }
+  const outputCoin = outputs[outputChangeIndex];
+  const outputIndexPadded = Number(outputChangeIndex).toString().padStart(4, "0");
+  return {
+    id: `${transactionId}${outputIndexPadded}`,
+    assetId: outputCoin.assetId,
+    amount: outputCoin.amount,
+    owner: new import_address5.Address(outputCoin.to),
+    blockCreated: (0, import_math23.bn)(0),
+    txCreatedIdx: (0, import_math23.bn)(0)
+  };
+}, "createOuputCoin");
+var consolidateCoins = /* @__PURE__ */ __name(async ({
+  account,
+  assetId
+}) => {
+  const chainInfo = await account.provider.getChain();
+  const chainId = chainInfo.consensusParameters.chainId.toNumber();
+  const gasPrice = await account.provider.estimateGasPrice(10);
+  const maxInputs = chainInfo.consensusParameters.txParameters.maxInputs.toNumber();
+  const baseAssetId = await account.provider.getBaseAssetId();
+  const isBaseAsset = assetId === baseAssetId;
+  const batchSize = maxInputs;
+  const numberOfFundingCoins = maxInputs;
+  let funding = [];
+  let dust = [];
+  if (isBaseAsset) {
+    const coins = await getAllCoins(account, baseAssetId).then(sortCoins);
+    funding = coins.slice(0, numberOfFundingCoins);
+    dust = coins.slice(numberOfFundingCoins);
+  } else {
+    funding = await getAllCoins(account, baseAssetId).then(sortCoins).then((coins) => coins.slice(0, numberOfFundingCoins));
+    dust = await getAllCoins(account, assetId).then(({ coins }) => coins);
+  }
+  if (funding.length === 0) {
+    throw new import_errors23.FuelError(
+      import_errors23.ErrorCode.INSUFFICIENT_FUNDS,
+      `Insufficient funds to consolidate.
+	Asset ID: ${baseAssetId}
+	Owner: ${account.address.toB256()}`
+    );
+  }
+  const batches = [
+    ...(0, import_ramda9.splitEvery)(batchSize, funding),
+    // We leave one coin for the funding coin
+    ...(0, import_ramda9.splitEvery)(batchSize - 1, dust)
+  ];
+  const txs = batches.map((batch) => {
+    const request = new ScriptTransactionRequest({
+      scriptData: "0x"
+    });
+    request.addResources(batch);
+    return request;
+  });
+  const submitAll = /* @__PURE__ */ __name(async (opts = {}) => {
+    const txResponses = [];
+    let previousTx;
+    for (let i = 0; i < txs.length; i++) {
+      let currentTx = txs[i];
+      const step = i + 1;
+      if (previousTx) {
+        const coin = createOuputCoin({
+          transactionId: previousTx.transactionId,
+          outputs: previousTx.outputs,
+          baseAssetId
+        });
+        currentTx.addResource(coin);
+      }
+      if ("populateTransactionPredicateData" in account && typeof account.populateTransactionPredicateData === "function") {
+        currentTx = account.populateTransactionPredicateData(currentTx);
+        currentTx = await account.provider.estimatePredicates(currentTx);
+      }
+      const fee = calculateGasFee({
+        gasPrice,
+        gas: currentTx.calculateMinGas(chainInfo),
+        priceFactor: chainInfo.consensusParameters.feeParameters.gasPriceFactor,
+        tip: currentTx.tip
+      });
+      currentTx.maxFee = fee;
+      currentTx.gasLimit = (0, import_math23.bn)(1e3);
+      opts.onTransactionStart?.({
+        tx: currentTx,
+        step,
+        assetId,
+        transactionId: currentTx.getTransactionId(chainId)
+      });
+      const response = await account.sendTransaction(currentTx);
+      const result = await response.waitForResult();
+      txResponses.push(result);
+      previousTx = {
+        transactionId: response.id,
+        outputs: result.transaction.outputs
+      };
+    }
+    return {
+      txResponses,
+      errors: []
+    };
+  }, "submitAll");
+  return {
+    txs,
+    totalFeeCost: txs.reduce((acc, request) => acc.add(request.maxFee), (0, import_math23.bn)(0)),
+    submitAll
+  };
+}, "consolidateCoins");
+
 // src/utils/formatTransferToContractScriptData.ts
 var import_abi_coder9 = require("@fuel-ts/abi-coder");
-var import_address5 = require("@fuel-ts/address");
+var import_address6 = require("@fuel-ts/address");
 var import_utils38 = require("@fuel-ts/utils");
 var asm = __toESM(require("@fuels/vm-asm"));
 var formatTransferToContractScriptData = /* @__PURE__ */ __name((transferParams) => {
@@ -7841,7 +8072,7 @@ var formatTransferToContractScriptData = /* @__PURE__ */ __name((transferParams)
   return transferParams.reduce((acc, transferParam) => {
     const { assetId, amount, contractId } = transferParam;
     const encoded = numberCoder.encode(amount);
-    const scriptData = (0, import_utils38.concat)([new import_address5.Address(contractId).toBytes(), encoded, (0, import_utils38.arrayify)(assetId)]);
+    const scriptData = (0, import_utils38.concat)([new import_address6.Address(contractId).toBytes(), encoded, (0, import_utils38.arrayify)(assetId)]);
     return (0, import_utils38.concat)([acc, scriptData]);
   }, new Uint8Array());
 }, "formatTransferToContractScriptData");
@@ -7912,7 +8143,7 @@ var Account = class extends AbstractAccount {
     super();
     this._provider = provider;
     this._connector = connector;
-    this.address = new import_address6.Address(address);
+    this.address = new import_address7.Address(address);
   }
   /**
    * The provider used to interact with the network.
@@ -7923,7 +8154,7 @@ var Account = class extends AbstractAccount {
    */
   get provider() {
     if (!this._provider) {
-      throw new import_errors23.FuelError(import_errors23.ErrorCode.MISSING_PROVIDER, "Provider not set");
+      throw new import_errors24.FuelError(import_errors24.ErrorCode.MISSING_PROVIDER, "Provider not set");
     }
     return this._provider;
   }
@@ -7950,10 +8181,24 @@ var Account = class extends AbstractAccount {
    *
    * @param quantities - Quantities of resources to be obtained.
    * @param resourcesIdsToIgnore - IDs of resources to be excluded from the query (optional).
+   * @param skipAutoConsolidation - Whether to skip the automatic consolidatation of coins process (optional).
    * @returns A promise that resolves to an array of Resources.
    */
-  async getResourcesToSpend(quantities, resourcesIdsToIgnore) {
-    return this.provider.getResourcesToSpend(this.address, quantities, resourcesIdsToIgnore);
+  async getResourcesToSpend(quantities, resourcesIdsToIgnore, { skipAutoConsolidation } = {}) {
+    const getResourcesToSpend = /* @__PURE__ */ __name(() => this.provider.getResourcesToSpend(this.address, quantities, resourcesIdsToIgnore), "getResourcesToSpend");
+    try {
+      return await getResourcesToSpend();
+    } catch (error) {
+      const shouldRetry = await consolidateCoinsIfRequired({
+        error,
+        account: this,
+        skipAutoConsolidation
+      });
+      if (!shouldRetry) {
+        throw error;
+      }
+      return await getResourcesToSpend();
+    }
   }
   /**
    * Retrieves coins owned by the account.
@@ -8002,7 +8247,7 @@ var Account = class extends AbstractAccount {
    * @deprecated Use provider.assembleTx instead
    * Check the migration guide https://docs.fuel.network/docs/fuels-ts/transactions/assemble-tx-migration-guide/ for more information.
    */
-  async fund(request, params) {
+  async fund(request, params, { skipAutoConsolidation } = {}) {
     const {
       addedSignatures,
       estimatedPredicates,
@@ -8014,9 +8259,9 @@ var Account = class extends AbstractAccount {
     const chainId = await this.provider.getChainId();
     const fee = request.maxFee;
     const baseAssetId = await this.provider.getBaseAssetId();
-    const requiredInBaseAsset = requiredQuantities.find((quantity) => quantity.assetId === baseAssetId)?.amount || (0, import_math23.bn)(0);
+    const requiredInBaseAsset = requiredQuantities.find((quantity) => quantity.assetId === baseAssetId)?.amount || (0, import_math24.bn)(0);
     const requiredQuantitiesWithFee = addAmountToCoinQuantities({
-      amount: (0, import_math23.bn)(fee),
+      amount: (0, import_math24.bn)(fee),
       assetId: baseAssetId,
       coinQuantities: requiredQuantities
     });
@@ -8024,7 +8269,7 @@ var Account = class extends AbstractAccount {
     requiredQuantitiesWithFee.forEach(({ amount, assetId }) => {
       quantitiesDict[assetId] = {
         required: amount,
-        owned: (0, import_math23.bn)(0)
+        owned: (0, import_math24.bn)(0)
       };
     });
     request.inputs.filter(isRequestInputResource).forEach((input) => {
@@ -8048,11 +8293,12 @@ var Account = class extends AbstractAccount {
     while (needsToBeFunded && fundingAttempts < MAX_FUNDING_ATTEMPTS) {
       const resources = await this.getResourcesToSpend(
         missingQuantities,
-        cacheRequestInputsResourcesFromOwner(request.inputs, this.address)
+        cacheRequestInputsResourcesFromOwner(request.inputs, this.address),
+        { skipAutoConsolidation }
       );
       request.addResources(resources);
       request.updatePredicateGasUsed(estimatedPredicates);
-      const requestToReestimate2 = (0, import_ramda9.clone)(request);
+      const requestToReestimate2 = (0, import_ramda10.clone)(request);
       if (addedSignatures) {
         Array.from({ length: addedSignatures }).forEach(
           () => requestToReestimate2.addEmptyWitness()
@@ -8085,15 +8331,15 @@ var Account = class extends AbstractAccount {
       fundingAttempts += 1;
     }
     if (needsToBeFunded) {
-      throw new import_errors23.FuelError(
-        import_errors23.ErrorCode.INSUFFICIENT_FUNDS_OR_MAX_COINS,
+      throw new import_errors24.FuelError(
+        import_errors24.ErrorCode.INSUFFICIENT_FUNDS,
         `The account ${this.address} does not have enough base asset funds to cover the transaction execution.`
       );
     }
     request.updateState(chainId, "funded", transactionSummary);
     await this.provider.validateTransaction(request);
     request.updatePredicateGasUsed(estimatedPredicates);
-    const requestToReestimate = (0, import_ramda9.clone)(request);
+    const requestToReestimate = (0, import_ramda10.clone)(request);
     if (addedSignatures) {
       Array.from({ length: addedSignatures }).forEach(() => requestToReestimate.addEmptyWitness());
     }
@@ -8114,16 +8360,20 @@ var Account = class extends AbstractAccount {
    * @param amount - The amount of coins to transfer.
    * @param assetId - The asset ID of the coins to transfer (optional).
    * @param txParams - The transaction parameters (optional).
+   * @param skipAutoConsolidation - Whether to skip the automatic consolidatation of coins process (optional).
    * @returns A promise that resolves to the prepared transaction request.
    */
-  async createTransfer(destination, amount, assetId, txParams = {}) {
+  async createTransfer(destination, amount, assetId, txParams = {}, { skipAutoConsolidation } = {}) {
     let request = new ScriptTransactionRequest(txParams);
     request = this.addTransfer(request, {
       destination,
       amount,
       assetId: assetId || await this.provider.getBaseAssetId()
     });
-    const { gasPrice, transactionRequest } = await this.assembleTx(request);
+    const { gasPrice, transactionRequest } = await this.assembleTx({
+      transactionRequest: request,
+      skipAutoConsolidation
+    });
     request = await setAndValidateGasAndFeeForAssembledTx({
       gasPrice,
       provider: this.provider,
@@ -8140,10 +8390,13 @@ var Account = class extends AbstractAccount {
    * @param amount - The amount of coins to transfer.
    * @param assetId - The asset ID of the coins to transfer (optional).
    * @param txParams - The transaction parameters (optional).
+   * @param skipAutoConsolidation - Whether to skip the automatic consolidatation of coins process (optional).
    * @returns A promise that resolves to the transaction response.
    */
-  async transfer(destination, amount, assetId, txParams = {}) {
-    const request = await this.createTransfer(destination, amount, assetId, txParams);
+  async transfer(destination, amount, assetId, txParams = {}, { skipAutoConsolidation } = {}) {
+    const request = await this.createTransfer(destination, amount, assetId, txParams, {
+      skipAutoConsolidation
+    });
     return this.sendTransaction(request, { estimateTxDependencies: false });
   }
   /**
@@ -8151,12 +8404,16 @@ var Account = class extends AbstractAccount {
    *
    * @param transferParams - An array of `TransferParams` objects representing the transfers to be made.
    * @param txParams - Optional transaction parameters.
+   * @param skipAutoConsolidation - Whether to skip the automatic consolidatation of coins process (optional).
    * @returns A promise that resolves to a `TransactionResponse` object representing the transaction result.
    */
-  async batchTransfer(transferParams, txParams = {}) {
+  async batchTransfer(transferParams, txParams = {}, { skipAutoConsolidation } = {}) {
     let request = new ScriptTransactionRequest(txParams);
     request = this.addBatchTransfer(request, transferParams);
-    const { gasPrice, transactionRequest } = await this.assembleTx(request);
+    const { gasPrice, transactionRequest } = await this.assembleTx({
+      transactionRequest: request,
+      skipAutoConsolidation
+    });
     request = await setAndValidateGasAndFeeForAssembledTx({
       gasPrice,
       provider: this.provider,
@@ -8176,7 +8433,7 @@ var Account = class extends AbstractAccount {
   addTransfer(request, transferParams) {
     const { destination, amount, assetId } = transferParams;
     this.validateTransferAmount(amount);
-    request.addCoinOutput(new import_address6.Address(destination), amount, assetId);
+    request.addCoinOutput(new import_address7.Address(destination), amount, assetId);
     return request;
   }
   /**
@@ -8203,24 +8460,27 @@ var Account = class extends AbstractAccount {
    * @param amount - The amount of coins to transfer.
    * @param assetId - The asset ID of the coins to transfer (optional).
    * @param txParams - The transaction parameters (optional).
+   * @param skipAutoConsolidation - Whether to skip the automatic consolidatation of coins process (optional).
    * @returns A promise that resolves to the transaction response.
    */
-  async transferToContract(contractId, amount, assetId, txParams = {}) {
-    return this.batchTransferToContracts([{ amount, assetId, contractId }], txParams);
+  async transferToContract(contractId, amount, assetId, txParams = {}, { skipAutoConsolidation } = {}) {
+    return this.batchTransferToContracts([{ amount, assetId, contractId }], txParams, {
+      skipAutoConsolidation
+    });
   }
-  async batchTransferToContracts(contractTransferParams, txParams = {}) {
+  async batchTransferToContracts(contractTransferParams, txParams = {}, { skipAutoConsolidation } = {}) {
     let request = new ScriptTransactionRequest({
       ...txParams
     });
     const quantities = [];
     const defaultAssetId = await this.provider.getBaseAssetId();
     const transferParams = contractTransferParams.map((transferParam) => {
-      const amount = (0, import_math23.bn)(transferParam.amount);
-      const contractAddress = new import_address6.Address(transferParam.contractId);
+      const amount = (0, import_math24.bn)(transferParam.amount);
+      const contractAddress = new import_address7.Address(transferParam.contractId);
       const assetId = transferParam.assetId ? (0, import_utils39.hexlify)(transferParam.assetId) : defaultAssetId;
       if (amount.lte(0)) {
-        throw new import_errors23.FuelError(
-          import_errors23.ErrorCode.INVALID_TRANSFER_AMOUNT,
+        throw new import_errors24.FuelError(
+          import_errors24.ErrorCode.INVALID_TRANSFER_AMOUNT,
           "Transfer amount must be a positive number."
         );
       }
@@ -8235,7 +8495,11 @@ var Account = class extends AbstractAccount {
     const { script, scriptData } = await assembleTransferToContractScript(transferParams);
     request.script = script;
     request.scriptData = scriptData;
-    const { gasPrice, transactionRequest } = await this.assembleTx(request, quantities);
+    const { gasPrice, transactionRequest } = await this.assembleTx({
+      transactionRequest: request,
+      quantities,
+      skipAutoConsolidation
+    });
     request = await setAndValidateGasAndFeeForAssembledTx({
       gasPrice,
       provider: this.provider,
@@ -8251,15 +8515,16 @@ var Account = class extends AbstractAccount {
    * @param recipient - Address of the recipient on the base chain.
    * @param amount - Amount of base asset.
    * @param txParams - The transaction parameters (optional).
+   * @param skipAutoConsolidation - Whether to skip the automatic consolidatation of coins process (optional).
    * @returns A promise that resolves to the transaction response.
    */
-  async withdrawToBaseLayer(recipient, amount, txParams = {}) {
-    const recipientAddress = new import_address6.Address(recipient);
+  async withdrawToBaseLayer(recipient, amount, txParams = {}, { skipAutoConsolidation } = {}) {
+    const recipientAddress = new import_address7.Address(recipient);
     const recipientDataArray = (0, import_utils39.arrayify)(
       "0x".concat(recipientAddress.toHexString().substring(2).padStart(64, "0"))
     );
     const amountDataArray = (0, import_utils39.arrayify)(
-      "0x".concat((0, import_math23.bn)(amount).toHex().substring(2).padStart(16, "0"))
+      "0x".concat((0, import_math24.bn)(amount).toHex().substring(2).padStart(16, "0"))
     );
     const script = new Uint8Array([
       ...(0, import_utils39.arrayify)(withdrawScript.bytes),
@@ -8269,8 +8534,12 @@ var Account = class extends AbstractAccount {
     const params = { script, ...txParams };
     const baseAssetId = await this.provider.getBaseAssetId();
     let request = new ScriptTransactionRequest(params);
-    const quantities = [{ amount: (0, import_math23.bn)(amount), assetId: baseAssetId }];
-    const { gasPrice, transactionRequest } = await this.assembleTx(request, quantities);
+    const quantities = [{ amount: (0, import_math24.bn)(amount), assetId: baseAssetId }];
+    const { gasPrice, transactionRequest } = await this.assembleTx({
+      transactionRequest: request,
+      quantities,
+      skipAutoConsolidation
+    });
     request = await setAndValidateGasAndFeeForAssembledTx({
       gasPrice,
       provider: this.provider,
@@ -8280,6 +8549,25 @@ var Account = class extends AbstractAccount {
     });
     return this.sendTransaction(request);
   }
+  /**
+   * Start the consolidation process
+   *
+   * @param owner - The B256 address of the owner.
+   * @param assetId - The asset ID that requires consolidation.
+   */
+  async startConsolidation(opts) {
+    if (this._connector) {
+      await this._connector.startConsolidation(opts);
+      return false;
+    }
+    const { owner, assetId } = opts;
+    if (owner !== this.address.toB256()) {
+      return false;
+    }
+    const { submitAll } = await consolidateCoins({ account: this, assetId });
+    await submitAll();
+    return true;
+  }
   /**
    * Consolidates base asset UTXOs into fewer, larger ones.
    *
@@ -8299,6 +8587,7 @@ var Account = class extends AbstractAccount {
     const isBaseAsset = baseAssetId === assetId;
     let submitAll;
     const consolidationParams = {
+      assetId,
       coins,
       mode: params.mode,
       outputNum: params.outputNum
@@ -8306,10 +8595,7 @@ var Account = class extends AbstractAccount {
     if (isBaseAsset) {
       ({ submitAll } = await this.assembleBaseAssetConsolidationTxs(consolidationParams));
     } else {
-      throw new import_errors23.FuelError(
-        import_errors23.ErrorCode.UNSUPPORTED_FEATURE,
-        "Consolidation for non-base assets is not supported yet."
-      );
+      ({ submitAll } = await this.assembleNonBaseAssetConsolidationTxs(consolidationParams));
     }
     return submitAll();
   }
@@ -8330,7 +8616,7 @@ var Account = class extends AbstractAccount {
     this.validateConsolidationTxsCoins(coins, baseAssetId);
     const chainInfo = await this.provider.getChain();
     const maxInputsNumber = chainInfo.consensusParameters.txParameters.maxInputs.toNumber();
-    let totalFeeCost = (0, import_math23.bn)(0);
+    let totalFeeCost = (0, import_math24.bn)(0);
     const txs = [];
     const coinsBatches = splitCoinsIntoBatches(coins, maxInputsNumber);
     const gasPrice = await this.provider.estimateGasPrice(10);
@@ -8354,10 +8640,10 @@ var Account = class extends AbstractAccount {
       });
       request.maxFee = fee;
       if (consolidateMoreThanOneCoin) {
-        const total = request.inputs.filter(isRequestInputCoin).reduce((acc, input) => acc.add(input.amount), (0, import_math23.bn)(0));
+        const total = request.inputs.filter(isRequestInputCoin).reduce((acc, input) => acc.add(input.amount), (0, import_math24.bn)(0));
         const amountPerNewUtxo = total.div(outputNum + 1);
         request.outputs.forEach((output) => {
-          if (output.type === import_transactions28.OutputType.Coin) {
+          if (output.type === import_transactions29.OutputType.Coin) {
             output.amount = amountPerNewUtxo;
           }
         });
@@ -8368,6 +8654,70 @@ var Account = class extends AbstractAccount {
     const submitAll = this.prepareSubmitAll({ txs, mode });
     return { txs, totalFeeCost, submitAll };
   }
+  async assembleNonBaseAssetConsolidationTxs(params) {
+    const { assetId, coins, mode = "parallel", outputNum = 1 } = params;
+    this.validateConsolidationTxsCoins(coins, assetId);
+    const chainInfo = await this.provider.getChain();
+    const maxInputsNumber = chainInfo.consensusParameters.txParameters.maxInputs.toNumber();
+    const baseAssetId = chainInfo.consensusParameters.baseAssetId;
+    const { coins: baseAssetCoins } = await this.provider.getCoins(this.address, baseAssetId);
+    let totalFeeCost = (0, import_math24.bn)(0);
+    const txs = [];
+    const gasPrice = await this.provider.estimateGasPrice(10);
+    const consolidateMoreThanOneCoin = outputNum > 1;
+    const assetCoinBatches = splitCoinsIntoBatches(coins, maxInputsNumber);
+    assetCoinBatches.filter((batch) => batch.length > 1).forEach((coinBatch) => {
+      const request = new ScriptTransactionRequest({
+        script: "0x"
+      });
+      request.addResources(coinBatch);
+      if (consolidateMoreThanOneCoin) {
+        Array.from({ length: outputNum - 1 }).forEach(() => {
+          request.addCoinOutput(this.address, 0, assetId);
+        });
+      }
+      const minGas = request.calculateMinGas(chainInfo);
+      const fee = calculateGasFee({
+        gasPrice,
+        gas: minGas,
+        priceFactor: chainInfo.consensusParameters.feeParameters.gasPriceFactor,
+        tip: request.tip
+      });
+      request.maxFee = fee;
+      if (consolidateMoreThanOneCoin) {
+        const total = request.inputs.filter(isRequestInputCoin).reduce((acc, input) => acc.add(input.amount), (0, import_math24.bn)(0));
+        const amountPerNewUtxo = total.div(outputNum + 1);
+        request.outputs.forEach((output) => {
+          if (output.type === import_transactions29.OutputType.Coin) {
+            output.amount = amountPerNewUtxo;
+          }
+        });
+      }
+      totalFeeCost = totalFeeCost.add(fee);
+      const baseAssetResources = [];
+      let fundingFeeTotal = (0, import_math24.bn)(0);
+      while (fundingFeeTotal.lt(fee)) {
+        const baseAssetCoin = baseAssetCoins.pop();
+        if (!baseAssetCoin) {
+          break;
+        }
+        baseAssetResources.push(baseAssetCoin);
+        fundingFeeTotal = fundingFeeTotal.add(baseAssetCoin.amount);
+      }
+      const { inputs } = request;
+      request.inputs = inputs.slice(0, maxInputsNumber - baseAssetResources.length);
+      const removedCoins = coinBatch.slice(maxInputsNumber - baseAssetResources.length);
+      request.addResources(baseAssetResources);
+      const lastCoinBatch = assetCoinBatches[assetCoinBatches.length - 1];
+      lastCoinBatch.push(...removedCoins);
+      if (lastCoinBatch.length > maxInputsNumber) {
+        assetCoinBatches.push(lastCoinBatch.slice(maxInputsNumber));
+      }
+      txs.push(request);
+    });
+    const submitAll = this.prepareSubmitAll({ txs, mode });
+    return { txs, totalFeeCost, submitAll };
+  }
   /**
    * Prepares a function to submit all transactions either sequentially or in parallel.
    *
@@ -8422,13 +8772,13 @@ var Account = class extends AbstractAccount {
    * Check the migration guide https://docs.fuel.network/docs/fuels-ts/transactions/assemble-tx-migration-guide/ for more information.
    */
   async getTransactionCost(transactionRequestLike, { signatureCallback, quantities = [], gasPrice } = {}) {
-    const txRequestClone = (0, import_ramda9.clone)(transactionRequestify(transactionRequestLike));
+    const txRequestClone = (0, import_ramda10.clone)(transactionRequestify(transactionRequestLike));
     const baseAssetId = await this.provider.getBaseAssetId();
     const coinOutputsQuantities = txRequestClone.getCoinOutputsQuantities();
     const requiredQuantities = mergeQuantities(coinOutputsQuantities, quantities);
-    const transactionFeeForDryRun = [{ assetId: baseAssetId, amount: (0, import_math23.bn)("100000000000000000") }];
+    const transactionFeeForDryRun = [{ assetId: baseAssetId, amount: (0, import_math24.bn)("100000000000000000") }];
     const findAssetInput = /* @__PURE__ */ __name((assetId) => txRequestClone.inputs.find((input) => {
-      if (input.type === import_transactions28.InputType.Coin) {
+      if (input.type === import_transactions29.InputType.Coin) {
         return input.assetId === assetId;
       }
       if (isRequestInputMessageWithoutData(input)) {
@@ -8474,7 +8824,7 @@ var Account = class extends AbstractAccount {
    */
   async signMessage(message) {
     if (!this._connector) {
-      throw new import_errors23.FuelError(import_errors23.ErrorCode.MISSING_CONNECTOR, "A connector is required to sign messages.");
+      throw new import_errors24.FuelError(import_errors24.ErrorCode.MISSING_CONNECTOR, "A connector is required to sign messages.");
     }
     return this._connector.signMessage(this.address.toString(), message);
   }
@@ -8486,8 +8836,8 @@ var Account = class extends AbstractAccount {
    */
   async signTransaction(transactionRequestLike, connectorOptions = {}) {
     if (!this._connector) {
-      throw new import_errors23.FuelError(
-        import_errors23.ErrorCode.MISSING_CONNECTOR,
+      throw new import_errors24.FuelError(
+        import_errors24.ErrorCode.MISSING_CONNECTOR,
         "A connector is required to sign transactions."
       );
     }
@@ -8554,8 +8904,8 @@ var Account = class extends AbstractAccount {
     return coins.map((coin) => ({
       id: (0, import_utils39.hexlify)((0, import_crypto5.randomBytes)(import_abi_coder10.UTXO_ID_LEN)),
       owner: this.address,
-      blockCreated: (0, import_math23.bn)(1),
-      txCreatedIdx: (0, import_math23.bn)(1),
+      blockCreated: (0, import_math24.bn)(1),
+      txCreatedIdx: (0, import_math24.bn)(1),
       ...coin
     }));
   }
@@ -8582,73 +8932,50 @@ var Account = class extends AbstractAccount {
     } : void 0;
   }
   /** @hidden * */
-  async assembleTx(transactionRequest, quantities = []) {
-    const outputQuantities = transactionRequest.outputs.filter((o) => o.type === import_transactions28.OutputType.Coin).map(({ amount, assetId }) => ({ assetId: String(assetId), amount: (0, import_math23.bn)(amount) }));
-    transactionRequest.gasLimit = (0, import_math23.bn)(0);
-    transactionRequest.maxFee = (0, import_math23.bn)(0);
-    const { assembledRequest, gasPrice } = await this.provider.assembleTx({
-      request: transactionRequest,
-      accountCoinQuantities: mergeQuantities(outputQuantities, quantities),
-      feePayerAccount: this
-    });
-    return { transactionRequest: assembledRequest, gasPrice };
+  async assembleTx(opts) {
+    const { transactionRequest, quantities = [], skipAutoConsolidation } = opts;
+    const outputQuantities = transactionRequest.outputs.filter((o) => o.type === import_transactions29.OutputType.Coin).map(({ amount, assetId }) => ({ assetId: String(assetId), amount: (0, import_math24.bn)(amount) }));
+    transactionRequest.gasLimit = (0, import_math24.bn)(0);
+    transactionRequest.maxFee = (0, import_math24.bn)(0);
+    const assembleTx = /* @__PURE__ */ __name(async () => {
+      const { assembledRequest, gasPrice } = await this.provider.assembleTx({
+        request: transactionRequest,
+        accountCoinQuantities: mergeQuantities(outputQuantities, quantities),
+        feePayerAccount: this
+      });
+      return { transactionRequest: assembledRequest, gasPrice };
+    }, "assembleTx");
+    try {
+      return await assembleTx();
+    } catch (error) {
+      const shouldRetry = await consolidateCoinsIfRequired({
+        error,
+        account: this,
+        skipAutoConsolidation
+      });
+      if (!shouldRetry) {
+        throw error;
+      }
+      return await assembleTx();
+    }
   }
   /** @hidden * */
   validateTransferAmount(amount) {
-    if ((0, import_math23.bn)(amount).lte(0)) {
-      throw new import_errors23.FuelError(
-        import_errors23.ErrorCode.INVALID_TRANSFER_AMOUNT,
+    if ((0, import_math24.bn)(amount).lte(0)) {
+      throw new import_errors24.FuelError(
+        import_errors24.ErrorCode.INVALID_TRANSFER_AMOUNT,
         "Transfer amount must be a positive number."
       );
     }
   }
   /** @hidden * */
-  async estimateAndFundTransaction(transactionRequest, txParams, costParams) {
-    let request = transactionRequest;
-    const txCost = await this.getTransactionCost(request, costParams);
-    request = this.validateGasLimitAndMaxFee({
-      transactionRequest: request,
-      gasUsed: txCost.gasUsed,
-      maxFee: txCost.maxFee,
-      txParams
-    });
-    request = await this.fund(request, txCost);
-    return request;
-  }
-  /** @hidden * */
-  validateGasLimitAndMaxFee({
-    gasUsed,
-    maxFee,
-    transactionRequest,
-    txParams: { gasLimit: setGasLimit, maxFee: setMaxFee }
-  }) {
-    const request = transactionRequestify(transactionRequest);
-    if (!(0, import_utils39.isDefined)(setGasLimit)) {
-      request.gasLimit = gasUsed;
-    } else if (gasUsed.gt(setGasLimit)) {
-      throw new import_errors23.FuelError(
-        import_errors23.ErrorCode.GAS_LIMIT_TOO_LOW,
-        `Gas limit '${setGasLimit}' is lower than the required: '${gasUsed}'.`
-      );
-    }
-    if (!(0, import_utils39.isDefined)(setMaxFee)) {
-      request.maxFee = maxFee;
-    } else if (maxFee.gt(setMaxFee)) {
-      throw new import_errors23.FuelError(
-        import_errors23.ErrorCode.MAX_FEE_TOO_LOW,
-        `Max fee '${setMaxFee}' is lower than the required: '${maxFee}'.`
-      );
-    }
-    return request;
-  }
-  /** @hidden * */
   validateConsolidationTxsCoins(coins, assetId) {
     if (coins.length <= 1) {
-      throw new import_errors23.FuelError(import_errors23.ErrorCode.NO_COINS_TO_CONSOLIDATE, "No coins to consolidate.");
+      throw new import_errors24.FuelError(import_errors24.ErrorCode.NO_COINS_TO_CONSOLIDATE, "No coins to consolidate.");
     }
     if (!coins.every((c) => c.assetId === assetId)) {
-      throw new import_errors23.FuelError(
-        import_errors23.ErrorCode.COINS_ASSET_ID_MISMATCH,
+      throw new import_errors24.FuelError(
+        import_errors24.ErrorCode.COINS_ASSET_ID_MISMATCH,
         "All coins to consolidate must be from the same asset id."
       );
     }
@@ -8673,9 +9000,9 @@ var Account = class extends AbstractAccount {
 };
 
 // src/wallet/keystore-wallet.ts
-var import_address7 = require("@fuel-ts/address");
+var import_address8 = require("@fuel-ts/address");
 var import_crypto6 = require("@fuel-ts/crypto");
-var import_errors24 = require("@fuel-ts/errors");
+var import_errors25 = require("@fuel-ts/errors");
 var import_utils40 = require("@fuel-ts/utils");
 var DEFAULT_KDF_PARAMS_LOG_N = 13;
 var DEFAULT_KDF_PARAMS_R = 8;
@@ -8690,7 +9017,7 @@ var removeHexPrefix = /* @__PURE__ */ __name((hexString) => {
 }, "removeHexPrefix");
 async function encryptKeystoreWallet(privateKey, address, password) {
   const privateKeyBuffer = (0, import_crypto6.bufferFromString)(removeHexPrefix(privateKey), "hex");
-  const ownerAddress = new import_address7.Address(address);
+  const ownerAddress = new import_address8.Address(address);
   const salt = (0, import_crypto6.randomBytes)(DEFAULT_KEY_SIZE);
   const key = (0, import_crypto6.scrypt)({
     password: (0, import_crypto6.bufferFromString)(password),
@@ -8753,8 +9080,8 @@ async function decryptKeystoreWallet(jsonWallet, password) {
   const macHashUint8Array = (0, import_crypto6.keccak256)(data);
   const macHash = (0, import_crypto6.stringFromBuffer)(macHashUint8Array, "hex");
   if (mac !== macHash) {
-    throw new import_errors24.FuelError(
-      import_errors24.ErrorCode.INVALID_PASSWORD,
+    throw new import_errors25.FuelError(
+      import_errors25.ErrorCode.INVALID_PASSWORD,
       "Failed to decrypt the keystore wallet, the provided password is incorrect."
     );
   }
@@ -8893,14 +9220,14 @@ var BaseWalletUnlocked = class extends Account {
 
 // src/hdwallet/hdwallet.ts
 var import_crypto8 = require("@fuel-ts/crypto");
-var import_errors27 = require("@fuel-ts/errors");
+var import_errors28 = require("@fuel-ts/errors");
 var import_hasher7 = require("@fuel-ts/hasher");
-var import_math24 = require("@fuel-ts/math");
+var import_math25 = require("@fuel-ts/math");
 var import_utils45 = require("@fuel-ts/utils");
 
 // src/mnemonic/mnemonic.ts
 var import_crypto7 = require("@fuel-ts/crypto");
-var import_errors26 = require("@fuel-ts/errors");
+var import_errors27 = require("@fuel-ts/errors");
 var import_hasher6 = require("@fuel-ts/hasher");
 var import_utils43 = require("@fuel-ts/utils");
 
@@ -10957,7 +11284,7 @@ var english = [
 ];
 
 // src/mnemonic/utils.ts
-var import_errors25 = require("@fuel-ts/errors");
+var import_errors26 = require("@fuel-ts/errors");
 var import_hasher5 = require("@fuel-ts/hasher");
 var import_utils42 = require("@fuel-ts/utils");
 function getLowerMask(bits) {
@@ -11011,8 +11338,8 @@ function mnemonicWordsToEntropy(words, wordlist) {
   for (let i = 0; i < words.length; i += 1) {
     const index = wordlist.indexOf(words[i].normalize("NFKD"));
     if (index === -1) {
-      throw new import_errors25.FuelError(
-        import_errors25.ErrorCode.INVALID_MNEMONIC,
+      throw new import_errors26.FuelError(
+        import_errors26.ErrorCode.INVALID_MNEMONIC,
         `Invalid mnemonic: the word '${words[i]}' is not found in the provided wordlist.`
       );
     }
@@ -11028,8 +11355,8 @@ function mnemonicWordsToEntropy(words, wordlist) {
   const checksumMask = getUpperMask(checksumBits);
   const checksum = (0, import_utils42.arrayify)((0, import_hasher5.sha256)(entropy.slice(0, entropyBits / 8)))[0] & checksumMask;
   if (checksum !== (entropy[entropy.length - 1] & checksumMask)) {
-    throw new import_errors25.FuelError(
-      import_errors25.ErrorCode.INVALID_CHECKSUM,
+    throw new import_errors26.FuelError(
+      import_errors26.ErrorCode.INVALID_CHECKSUM,
       "Checksum validation failed for the provided mnemonic."
     );
   }
@@ -11044,8 +11371,8 @@ var TestnetPRV = "0x04358394";
 var MNEMONIC_SIZES = [12, 15, 18, 21, 24];
 function assertWordList(wordlist) {
   if (wordlist.length !== 2048) {
-    throw new import_errors26.FuelError(
-      import_errors26.ErrorCode.INVALID_WORD_LIST,
+    throw new import_errors27.FuelError(
+      import_errors27.ErrorCode.INVALID_WORD_LIST,
       `Expected word list length of 2048, but got ${wordlist.length}.`
     );
   }
@@ -11053,8 +11380,8 @@ function assertWordList(wordlist) {
 __name(assertWordList, "assertWordList");
 function assertEntropy(entropy) {
   if (entropy.length % 4 !== 0 || entropy.length < 16 || entropy.length > 32) {
-    throw new import_errors26.FuelError(
-      import_errors26.ErrorCode.INVALID_ENTROPY,
+    throw new import_errors27.FuelError(
+      import_errors27.ErrorCode.INVALID_ENTROPY,
       `Entropy should be between 16 and 32 bytes and a multiple of 4, but got ${entropy.length} bytes.`
     );
   }
@@ -11065,7 +11392,7 @@ function assertMnemonic(words) {
     const errorMsg = `Invalid mnemonic size. Expected one of [${MNEMONIC_SIZES.join(
       ", "
     )}] words, but got ${words.length}.`;
-    throw new import_errors26.FuelError(import_errors26.ErrorCode.INVALID_MNEMONIC, errorMsg);
+    throw new import_errors27.FuelError(import_errors27.ErrorCode.INVALID_MNEMONIC, errorMsg);
   }
 }
 __name(assertMnemonic, "assertMnemonic");
@@ -11187,8 +11514,8 @@ var Mnemonic = class _Mnemonic {
   static masterKeysFromSeed(seed) {
     const seedArray = (0, import_utils43.arrayify)(seed);
     if (seedArray.length < 16 || seedArray.length > 64) {
-      throw new import_errors26.FuelError(
-        import_errors26.ErrorCode.INVALID_SEED,
+      throw new import_errors27.FuelError(
+        import_errors27.ErrorCode.INVALID_SEED,
         `Seed length should be between 16 and 64 bytes, but received ${seedArray.length} bytes.`
       );
     }
@@ -11269,7 +11596,7 @@ __name(isValidExtendedKey, "isValidExtendedKey");
 function parsePath(path2, depth = 0) {
   const components = path2.split("/");
   if (components.length === 0 || components[0] === "m" && depth !== 0) {
-    throw new import_errors27.FuelError(import_errors27.ErrorCode.HD_WALLET_ERROR, `invalid path - ${path2}`);
+    throw new import_errors28.FuelError(import_errors28.ErrorCode.HD_WALLET_ERROR, `invalid path - ${path2}`);
   }
   if (components[0] === "m") {
     components.shift();
@@ -11302,8 +11629,8 @@ var HDWallet = class _HDWallet {
       this.privateKey = (0, import_utils45.hexlify)(config.privateKey);
     } else {
       if (!config.publicKey) {
-        throw new import_errors27.FuelError(
-          import_errors27.ErrorCode.HD_WALLET_ERROR,
+        throw new import_errors28.FuelError(
+          import_errors28.ErrorCode.HD_WALLET_ERROR,
           "Both public and private Key cannot be missing. At least one should be provided."
         );
       }
@@ -11332,8 +11659,8 @@ var HDWallet = class _HDWallet {
     const data = new Uint8Array(37);
     if (index & HARDENED_INDEX) {
       if (!privateKey) {
-        throw new import_errors27.FuelError(
-          import_errors27.ErrorCode.HD_WALLET_ERROR,
+        throw new import_errors28.FuelError(
+          import_errors28.ErrorCode.HD_WALLET_ERROR,
           "Cannot derive a hardened index without a private Key."
         );
       }
@@ -11341,13 +11668,13 @@ var HDWallet = class _HDWallet {
     } else {
       data.set((0, import_utils45.arrayify)(this.publicKey));
     }
-    data.set((0, import_math24.toBytes)(index, 4), 33);
+    data.set((0, import_math25.toBytes)(index, 4), 33);
     const bytes = (0, import_utils45.arrayify)((0, import_crypto8.computeHmac)("sha512", chainCode, data));
     const IL = bytes.slice(0, 32);
     const IR = bytes.slice(32);
     if (privateKey) {
       const N = "0xfffffffffffffffffffffffffffffffebaaedce6af48a03bbfd25e8cd0364141";
-      const ki = (0, import_math24.bn)(IL).add(privateKey).mod(N).toBytes(32);
+      const ki = (0, import_math25.bn)(IL).add(privateKey).mod(N).toBytes(32);
       return new _HDWallet({
         privateKey: ki,
         chainCode: IR,
@@ -11385,15 +11712,15 @@ var HDWallet = class _HDWallet {
    */
   toExtendedKey(isPublic = false, testnet = false) {
     if (this.depth >= 256) {
-      throw new import_errors27.FuelError(
-        import_errors27.ErrorCode.HD_WALLET_ERROR,
+      throw new import_errors28.FuelError(
+        import_errors28.ErrorCode.HD_WALLET_ERROR,
         `Exceeded max depth of 255. Current depth: ${this.depth}.`
       );
     }
     const prefix = getExtendedKeyPrefix(this.privateKey == null || isPublic, testnet);
     const depth = (0, import_utils45.hexlify)(Uint8Array.from([this.depth]));
     const parentFingerprint = this.parentFingerprint;
-    const index = (0, import_math24.toHex)(this.index, 4);
+    const index = (0, import_math25.toHex)(this.index, 4);
     const chainCode = this.chainCode;
     const key = this.privateKey != null && !isPublic ? (0, import_utils45.concat)(["0x00", this.privateKey]) : this.publicKey;
     const extendedKey = (0, import_utils45.arrayify)((0, import_utils45.concat)([prefix, depth, parentFingerprint, index, chainCode, key]));
@@ -11413,14 +11740,14 @@ var HDWallet = class _HDWallet {
     });
   }
   static fromExtendedKey(extendedKey) {
-    const decoded = (0, import_utils45.hexlify)((0, import_math24.toBytes)((0, import_utils45.decodeBase58)(extendedKey)));
+    const decoded = (0, import_utils45.hexlify)((0, import_math25.toBytes)((0, import_utils45.decodeBase58)(extendedKey)));
     const bytes = (0, import_utils45.arrayify)(decoded);
     const validChecksum = base58check(bytes.slice(0, 78)) === extendedKey;
     if (bytes.length !== 82 || !isValidExtendedKey(bytes)) {
-      throw new import_errors27.FuelError(import_errors27.ErrorCode.HD_WALLET_ERROR, "Provided key is not a valid extended key.");
+      throw new import_errors28.FuelError(import_errors28.ErrorCode.HD_WALLET_ERROR, "Provided key is not a valid extended key.");
     }
     if (!validChecksum) {
-      throw new import_errors27.FuelError(import_errors27.ErrorCode.HD_WALLET_ERROR, "Provided key has an invalid checksum.");
+      throw new import_errors28.FuelError(import_errors28.ErrorCode.HD_WALLET_ERROR, "Provided key has an invalid checksum.");
     }
     const depth = bytes[4];
     const parentFingerprint = (0, import_utils45.hexlify)(bytes.slice(5, 9));
@@ -11428,14 +11755,14 @@ var HDWallet = class _HDWallet {
     const chainCode = (0, import_utils45.hexlify)(bytes.slice(13, 45));
     const key = bytes.slice(45, 78);
     if (depth === 0 && parentFingerprint !== "0x00000000" || depth === 0 && index !== 0) {
-      throw new import_errors27.FuelError(
-        import_errors27.ErrorCode.HD_WALLET_ERROR,
+      throw new import_errors28.FuelError(
+        import_errors28.ErrorCode.HD_WALLET_ERROR,
         "Inconsistency detected: Depth is zero but fingerprint/index is non-zero."
       );
     }
     if (isPublicExtendedKey(bytes)) {
       if (key[0] !== 3) {
-        throw new import_errors27.FuelError(import_errors27.ErrorCode.HD_WALLET_ERROR, "Invalid public extended key.");
+        throw new import_errors28.FuelError(import_errors28.ErrorCode.HD_WALLET_ERROR, "Invalid public extended key.");
       }
       return new _HDWallet({
         publicKey: key,
@@ -11446,7 +11773,7 @@ var HDWallet = class _HDWallet {
       });
     }
     if (key[0] !== 0) {
-      throw new import_errors27.FuelError(import_errors27.ErrorCode.HD_WALLET_ERROR, "Invalid private extended key.");
+      throw new import_errors28.FuelError(import_errors28.ErrorCode.HD_WALLET_ERROR, "Invalid private extended key.");
     }
     return new _HDWallet({
       privateKey: key.slice(1),
@@ -11682,7 +12009,7 @@ var WalletsConfig = class _WalletsConfig {
       assetIds.forEach((assetId) => {
         for (let index = 0; index < coinsPerAsset; index++) {
           coins.push({
-            amount: (0, import_math25.bn)(amountPerCoin).toString(),
+            amount: (0, import_math26.bn)(amountPerCoin).toString(),
             asset_id: assetId,
             owner: walletAddress,
             tx_pointer_block_height: 0,
@@ -11702,26 +12029,26 @@ var WalletsConfig = class _WalletsConfig {
     amountPerCoin
   }) {
     if (Array.isArray(wallets) && wallets.length === 0 || typeof wallets === "number" && wallets <= 0) {
-      throw new import_errors28.FuelError(
-        import_errors28.FuelError.CODES.INVALID_INPUT_PARAMETERS,
+      throw new import_errors29.FuelError(
+        import_errors29.FuelError.CODES.INVALID_INPUT_PARAMETERS,
         "Number of wallets must be greater than zero."
       );
     }
     if (Array.isArray(assets) && assets.length === 0 || typeof assets === "number" && assets <= 0) {
-      throw new import_errors28.FuelError(
-        import_errors28.FuelError.CODES.INVALID_INPUT_PARAMETERS,
+      throw new import_errors29.FuelError(
+        import_errors29.FuelError.CODES.INVALID_INPUT_PARAMETERS,
         "Number of assets per wallet must be greater than zero."
       );
     }
     if (coinsPerAsset <= 0) {
-      throw new import_errors28.FuelError(
-        import_errors28.FuelError.CODES.INVALID_INPUT_PARAMETERS,
+      throw new import_errors29.FuelError(
+        import_errors29.FuelError.CODES.INVALID_INPUT_PARAMETERS,
         "Number of coins per asset must be greater than zero."
       );
     }
-    if ((0, import_math25.bn)(amountPerCoin).lt(0)) {
-      throw new import_errors28.FuelError(
-        import_errors28.FuelError.CODES.INVALID_INPUT_PARAMETERS,
+    if ((0, import_math26.bn)(amountPerCoin).lt(0)) {
+      throw new import_errors29.FuelError(
+        import_errors29.FuelError.CODES.INVALID_INPUT_PARAMETERS,
         "Amount per coin must be greater than or equal to zero."
       );
     }
@@ -11753,7 +12080,7 @@ async function setupTestProviderAndWallets({
   const launchNodeOptions = {
     loggingEnabled: false,
     ...nodeOptions,
-    snapshotConfig: (0, import_ramda10.mergeDeepRight)(
+    snapshotConfig: (0, import_ramda11.mergeDeepRight)(
       import_utils47.defaultSnapshotConfigs,
       walletsConfig.apply(nodeOptions?.snapshotConfig)
     ),
@@ -11797,9 +12124,9 @@ async function setupTestProviderAndWallets({
 __name(setupTestProviderAndWallets, "setupTestProviderAndWallets");
 
 // src/test-utils/test-message.ts
-var import_address8 = require("@fuel-ts/address");
+var import_address9 = require("@fuel-ts/address");
 var import_crypto10 = require("@fuel-ts/crypto");
-var import_math26 = require("@fuel-ts/math");
+var import_math27 = require("@fuel-ts/math");
 var import_utils48 = require("@fuel-ts/utils");
 var TestMessage = class {
   static {
@@ -11818,8 +12145,8 @@ var TestMessage = class {
    * It can also be used standalone and passed into the initial state of a chain via the `.toChainMessage` method.
    */
   constructor({
-    sender = import_address8.Address.fromRandom(),
-    recipient = import_address8.Address.fromRandom(),
+    sender = import_address9.Address.fromRandom(),
+    recipient = import_address9.Address.fromRandom(),
     nonce = (0, import_utils48.hexlify)((0, import_crypto10.randomBytes)(32)),
     amount = 1e6,
     data = "",
@@ -11839,7 +12166,7 @@ var TestMessage = class {
       sender: this.sender.toB256(),
       recipient: recipient?.toB256() ?? this.recipient.toB256(),
       nonce: this.nonce,
-      amount: (0, import_math26.bn)(this.amount).toNumber(),
+      amount: (0, import_math27.bn)(this.amount).toNumber(),
       data,
       da_height: this.da_height
     };