@fuel-ts/account 0.101.2 → 0.101.3

package/dist/test-utils.mjs

@@ -217,8 +217,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") || defaultConsensusKey;
@@ -1809,8 +1810,11 @@ import { print } from "graphql";
 
 // src/providers/utils/handle-gql-error-message.ts
 import { ErrorCode as ErrorCode2, FuelError as FuelError3 } from "@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/,
@@ -1826,6 +1830,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 FuelError3(
+      ErrorCode2.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 FuelError3(
+      ErrorCode2.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] || "";
@@ -2929,6 +2973,7 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
   }
   return new FuelError9(ErrorCode8.SCRIPT_REVERTED, errorMessage, {
     ...metadata,
+    abiError,
     reason
   });
 }
@@ -3951,11 +3996,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;
   }
   /**
@@ -5522,25 +5571,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");
   }
@@ -5555,9 +5585,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
@@ -6074,7 +6137,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 FuelError20(
+          ErrorCode17.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) {
@@ -6097,13 +6168,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);
@@ -6526,7 +6599,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.
@@ -7621,7 +7700,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.
@@ -7792,8 +7875,8 @@ var TestAssetId = class _TestAssetId {
 
 // src/test-utils/wallet-config.ts
 import { randomBytes as randomBytes8 } from "@fuel-ts/crypto";
-import { FuelError as FuelError27 } from "@fuel-ts/errors";
-import { bn as bn23 } from "@fuel-ts/math";
+import { FuelError as FuelError28 } from "@fuel-ts/errors";
+import { bn as bn24 } from "@fuel-ts/math";
 import { defaultSnapshotConfigs as defaultSnapshotConfigs2, hexlify as hexlify26 } from "@fuel-ts/utils";
 
 // src/wallet/base-wallet-unlocked.ts
@@ -7802,11 +7885,11 @@ import { hexlify as hexlify23 } from "@fuel-ts/utils";
 
 // src/account.ts
 import { UTXO_ID_LEN as UTXO_ID_LEN3 } from "@fuel-ts/abi-coder";
-import { Address as Address5 } from "@fuel-ts/address";
+import { Address as Address6 } from "@fuel-ts/address";
 import { randomBytes as randomBytes5 } from "@fuel-ts/crypto";
-import { ErrorCode as ErrorCode19, FuelError as FuelError22 } from "@fuel-ts/errors";
-import { bn as bn21 } from "@fuel-ts/math";
-import { InputType as InputType8, OutputType as OutputType9 } from "@fuel-ts/transactions";
+import { ErrorCode as ErrorCode20, FuelError as FuelError23 } from "@fuel-ts/errors";
+import { bn as bn22 } from "@fuel-ts/math";
+import { InputType as InputType8, OutputType as OutputType10 } from "@fuel-ts/transactions";
 import { arrayify as arrayify18, hexlify as hexlify21, isDefined as isDefined4 } from "@fuel-ts/utils";
 import { clone as clone9 } from "ramda";
 
@@ -7817,9 +7900,157 @@ var AbstractAccount = class {
   }
 };
 
+// src/utils/consolidate-coins.ts
+import { Address as Address4 } from "@fuel-ts/address";
+import { ErrorCode as ErrorCode19, FuelError as FuelError22 } from "@fuel-ts/errors";
+import { bn as bn21 } from "@fuel-ts/math";
+import { OutputType as OutputType9 } from "@fuel-ts/transactions";
+import { splitEvery } from "ramda";
+var CONSOLIDATABLE_ERROR_CODES = [ErrorCode19.MAX_COINS_REACHED];
+var consolidateCoinsIfRequired = /* @__PURE__ */ __name(async (opts) => {
+  const { error: errorUnknown, account, skipAutoConsolidation = false } = opts;
+  if (skipAutoConsolidation) {
+    return false;
+  }
+  const error = FuelError22.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 === OutputType9.Change && output.assetId === baseAssetId
+  );
+  if (outputChangeIndex === -1) {
+    throw new FuelError22(ErrorCode19.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 Address4(outputCoin.to),
+    blockCreated: bn21(0),
+    txCreatedIdx: bn21(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 FuelError22(
+      ErrorCode19.INSUFFICIENT_FUNDS,
+      `Insufficient funds to consolidate.
+	Asset ID: ${baseAssetId}
+	Owner: ${account.address.toB256()}`
+    );
+  }
+  const batches = [
+    ...splitEvery(batchSize, funding),
+    // We leave one coin for the funding coin
+    ...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 = bn21(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), bn21(0)),
+    submitAll
+  };
+}, "consolidateCoins");
+
 // src/utils/formatTransferToContractScriptData.ts
 import { ASSET_ID_LEN, BigNumberCoder as BigNumberCoder3, CONTRACT_ID_LEN, WORD_SIZE } from "@fuel-ts/abi-coder";
-import { Address as Address4 } from "@fuel-ts/address";
+import { Address as Address5 } from "@fuel-ts/address";
 import { arrayify as arrayify17, concat as concat5 } from "@fuel-ts/utils";
 import * as asm from "@fuels/vm-asm";
 var formatTransferToContractScriptData = /* @__PURE__ */ __name((transferParams) => {
@@ -7827,7 +8058,7 @@ var formatTransferToContractScriptData = /* @__PURE__ */ __name((transferParams)
   return transferParams.reduce((acc, transferParam) => {
     const { assetId, amount, contractId } = transferParam;
     const encoded = numberCoder.encode(amount);
-    const scriptData = concat5([new Address4(contractId).toBytes(), encoded, arrayify17(assetId)]);
+    const scriptData = concat5([new Address5(contractId).toBytes(), encoded, arrayify17(assetId)]);
     return concat5([acc, scriptData]);
   }, new Uint8Array());
 }, "formatTransferToContractScriptData");
@@ -7898,7 +8129,7 @@ var Account = class extends AbstractAccount {
     super();
     this._provider = provider;
     this._connector = connector;
-    this.address = new Address5(address);
+    this.address = new Address6(address);
   }
   /**
    * The provider used to interact with the network.
@@ -7909,7 +8140,7 @@ var Account = class extends AbstractAccount {
    */
   get provider() {
     if (!this._provider) {
-      throw new FuelError22(ErrorCode19.MISSING_PROVIDER, "Provider not set");
+      throw new FuelError23(ErrorCode20.MISSING_PROVIDER, "Provider not set");
     }
     return this._provider;
   }
@@ -7936,10 +8167,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.
@@ -7988,7 +8233,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,
@@ -8000,9 +8245,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 || bn21(0);
+    const requiredInBaseAsset = requiredQuantities.find((quantity) => quantity.assetId === baseAssetId)?.amount || bn22(0);
     const requiredQuantitiesWithFee = addAmountToCoinQuantities({
-      amount: bn21(fee),
+      amount: bn22(fee),
       assetId: baseAssetId,
       coinQuantities: requiredQuantities
     });
@@ -8010,7 +8255,7 @@ var Account = class extends AbstractAccount {
     requiredQuantitiesWithFee.forEach(({ amount, assetId }) => {
       quantitiesDict[assetId] = {
         required: amount,
-        owned: bn21(0)
+        owned: bn22(0)
       };
     });
     request.inputs.filter(isRequestInputResource).forEach((input) => {
@@ -8034,7 +8279,8 @@ 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);
@@ -8071,8 +8317,8 @@ var Account = class extends AbstractAccount {
       fundingAttempts += 1;
     }
     if (needsToBeFunded) {
-      throw new FuelError22(
-        ErrorCode19.INSUFFICIENT_FUNDS_OR_MAX_COINS,
+      throw new FuelError23(
+        ErrorCode20.INSUFFICIENT_FUNDS,
         `The account ${this.address} does not have enough base asset funds to cover the transaction execution.`
       );
     }
@@ -8100,16 +8346,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,
@@ -8126,10 +8376,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 });
   }
   /**
@@ -8137,12 +8390,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,
@@ -8162,7 +8419,7 @@ var Account = class extends AbstractAccount {
   addTransfer(request, transferParams) {
     const { destination, amount, assetId } = transferParams;
     this.validateTransferAmount(amount);
-    request.addCoinOutput(new Address5(destination), amount, assetId);
+    request.addCoinOutput(new Address6(destination), amount, assetId);
     return request;
   }
   /**
@@ -8189,24 +8446,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 = bn21(transferParam.amount);
-      const contractAddress = new Address5(transferParam.contractId);
+      const amount = bn22(transferParam.amount);
+      const contractAddress = new Address6(transferParam.contractId);
       const assetId = transferParam.assetId ? hexlify21(transferParam.assetId) : defaultAssetId;
       if (amount.lte(0)) {
-        throw new FuelError22(
-          ErrorCode19.INVALID_TRANSFER_AMOUNT,
+        throw new FuelError23(
+          ErrorCode20.INVALID_TRANSFER_AMOUNT,
           "Transfer amount must be a positive number."
         );
       }
@@ -8221,7 +8481,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,
@@ -8237,15 +8501,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 Address5(recipient);
+  async withdrawToBaseLayer(recipient, amount, txParams = {}, { skipAutoConsolidation } = {}) {
+    const recipientAddress = new Address6(recipient);
     const recipientDataArray = arrayify18(
       "0x".concat(recipientAddress.toHexString().substring(2).padStart(64, "0"))
     );
     const amountDataArray = arrayify18(
-      "0x".concat(bn21(amount).toHex().substring(2).padStart(16, "0"))
+      "0x".concat(bn22(amount).toHex().substring(2).padStart(16, "0"))
     );
     const script = new Uint8Array([
       ...arrayify18(withdrawScript.bytes),
@@ -8255,8 +8520,12 @@ var Account = class extends AbstractAccount {
     const params = { script, ...txParams };
     const baseAssetId = await this.provider.getBaseAssetId();
     let request = new ScriptTransactionRequest(params);
-    const quantities = [{ amount: bn21(amount), assetId: baseAssetId }];
-    const { gasPrice, transactionRequest } = await this.assembleTx(request, quantities);
+    const quantities = [{ amount: bn22(amount), assetId: baseAssetId }];
+    const { gasPrice, transactionRequest } = await this.assembleTx({
+      transactionRequest: request,
+      quantities,
+      skipAutoConsolidation
+    });
     request = await setAndValidateGasAndFeeForAssembledTx({
       gasPrice,
       provider: this.provider,
@@ -8266,6 +8535,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.
    *
@@ -8285,6 +8573,7 @@ var Account = class extends AbstractAccount {
     const isBaseAsset = baseAssetId === assetId;
     let submitAll;
     const consolidationParams = {
+      assetId,
       coins,
       mode: params.mode,
       outputNum: params.outputNum
@@ -8292,10 +8581,7 @@ var Account = class extends AbstractAccount {
     if (isBaseAsset) {
       ({ submitAll } = await this.assembleBaseAssetConsolidationTxs(consolidationParams));
     } else {
-      throw new FuelError22(
-        ErrorCode19.UNSUPPORTED_FEATURE,
-        "Consolidation for non-base assets is not supported yet."
-      );
+      ({ submitAll } = await this.assembleNonBaseAssetConsolidationTxs(consolidationParams));
     }
     return submitAll();
   }
@@ -8316,7 +8602,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 = bn21(0);
+    let totalFeeCost = bn22(0);
     const txs = [];
     const coinsBatches = splitCoinsIntoBatches(coins, maxInputsNumber);
     const gasPrice = await this.provider.estimateGasPrice(10);
@@ -8340,10 +8626,10 @@ var Account = class extends AbstractAccount {
       });
       request.maxFee = fee;
       if (consolidateMoreThanOneCoin) {
-        const total = request.inputs.filter(isRequestInputCoin).reduce((acc, input) => acc.add(input.amount), bn21(0));
+        const total = request.inputs.filter(isRequestInputCoin).reduce((acc, input) => acc.add(input.amount), bn22(0));
         const amountPerNewUtxo = total.div(outputNum + 1);
         request.outputs.forEach((output) => {
-          if (output.type === OutputType9.Coin) {
+          if (output.type === OutputType10.Coin) {
             output.amount = amountPerNewUtxo;
           }
         });
@@ -8354,6 +8640,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 = bn22(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), bn22(0));
+        const amountPerNewUtxo = total.div(outputNum + 1);
+        request.outputs.forEach((output) => {
+          if (output.type === OutputType10.Coin) {
+            output.amount = amountPerNewUtxo;
+          }
+        });
+      }
+      totalFeeCost = totalFeeCost.add(fee);
+      const baseAssetResources = [];
+      let fundingFeeTotal = bn22(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.
    *
@@ -8412,7 +8762,7 @@ var Account = class extends AbstractAccount {
     const baseAssetId = await this.provider.getBaseAssetId();
     const coinOutputsQuantities = txRequestClone.getCoinOutputsQuantities();
     const requiredQuantities = mergeQuantities(coinOutputsQuantities, quantities);
-    const transactionFeeForDryRun = [{ assetId: baseAssetId, amount: bn21("100000000000000000") }];
+    const transactionFeeForDryRun = [{ assetId: baseAssetId, amount: bn22("100000000000000000") }];
     const findAssetInput = /* @__PURE__ */ __name((assetId) => txRequestClone.inputs.find((input) => {
       if (input.type === InputType8.Coin) {
         return input.assetId === assetId;
@@ -8460,7 +8810,7 @@ var Account = class extends AbstractAccount {
    */
   async signMessage(message) {
     if (!this._connector) {
-      throw new FuelError22(ErrorCode19.MISSING_CONNECTOR, "A connector is required to sign messages.");
+      throw new FuelError23(ErrorCode20.MISSING_CONNECTOR, "A connector is required to sign messages.");
     }
     return this._connector.signMessage(this.address.toString(), message);
   }
@@ -8472,8 +8822,8 @@ var Account = class extends AbstractAccount {
    */
   async signTransaction(transactionRequestLike, connectorOptions = {}) {
     if (!this._connector) {
-      throw new FuelError22(
-        ErrorCode19.MISSING_CONNECTOR,
+      throw new FuelError23(
+        ErrorCode20.MISSING_CONNECTOR,
         "A connector is required to sign transactions."
       );
     }
@@ -8540,8 +8890,8 @@ var Account = class extends AbstractAccount {
     return coins.map((coin) => ({
       id: hexlify21(randomBytes5(UTXO_ID_LEN3)),
       owner: this.address,
-      blockCreated: bn21(1),
-      txCreatedIdx: bn21(1),
+      blockCreated: bn22(1),
+      txCreatedIdx: bn22(1),
       ...coin
     }));
   }
@@ -8568,73 +8918,50 @@ var Account = class extends AbstractAccount {
     } : void 0;
   }
   /** @hidden * */
-  async assembleTx(transactionRequest, quantities = []) {
-    const outputQuantities = transactionRequest.outputs.filter((o) => o.type === OutputType9.Coin).map(({ amount, assetId }) => ({ assetId: String(assetId), amount: bn21(amount) }));
-    transactionRequest.gasLimit = bn21(0);
-    transactionRequest.maxFee = bn21(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 === OutputType10.Coin).map(({ amount, assetId }) => ({ assetId: String(assetId), amount: bn22(amount) }));
+    transactionRequest.gasLimit = bn22(0);
+    transactionRequest.maxFee = bn22(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 (bn21(amount).lte(0)) {
-      throw new FuelError22(
-        ErrorCode19.INVALID_TRANSFER_AMOUNT,
+    if (bn22(amount).lte(0)) {
+      throw new FuelError23(
+        ErrorCode20.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 (!isDefined4(setGasLimit)) {
-      request.gasLimit = gasUsed;
-    } else if (gasUsed.gt(setGasLimit)) {
-      throw new FuelError22(
-        ErrorCode19.GAS_LIMIT_TOO_LOW,
-        `Gas limit '${setGasLimit}' is lower than the required: '${gasUsed}'.`
-      );
-    }
-    if (!isDefined4(setMaxFee)) {
-      request.maxFee = maxFee;
-    } else if (maxFee.gt(setMaxFee)) {
-      throw new FuelError22(
-        ErrorCode19.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 FuelError22(ErrorCode19.NO_COINS_TO_CONSOLIDATE, "No coins to consolidate.");
+      throw new FuelError23(ErrorCode20.NO_COINS_TO_CONSOLIDATE, "No coins to consolidate.");
     }
     if (!coins.every((c) => c.assetId === assetId)) {
-      throw new FuelError22(
-        ErrorCode19.COINS_ASSET_ID_MISMATCH,
+      throw new FuelError23(
+        ErrorCode20.COINS_ASSET_ID_MISMATCH,
         "All coins to consolidate must be from the same asset id."
       );
     }
@@ -8659,7 +8986,7 @@ var Account = class extends AbstractAccount {
 };
 
 // src/wallet/keystore-wallet.ts
-import { Address as Address6 } from "@fuel-ts/address";
+import { Address as Address7 } from "@fuel-ts/address";
 import {
   bufferFromString,
   keccak256,
@@ -8670,7 +8997,7 @@ import {
   encryptJsonWalletData,
   randomUUID as randomUUID2
 } from "@fuel-ts/crypto";
-import { ErrorCode as ErrorCode20, FuelError as FuelError23 } from "@fuel-ts/errors";
+import { ErrorCode as ErrorCode21, FuelError as FuelError24 } from "@fuel-ts/errors";
 import { hexlify as hexlify22 } from "@fuel-ts/utils";
 var DEFAULT_KDF_PARAMS_LOG_N = 13;
 var DEFAULT_KDF_PARAMS_R = 8;
@@ -8685,7 +9012,7 @@ var removeHexPrefix = /* @__PURE__ */ __name((hexString) => {
 }, "removeHexPrefix");
 async function encryptKeystoreWallet(privateKey, address, password) {
   const privateKeyBuffer = bufferFromString(removeHexPrefix(privateKey), "hex");
-  const ownerAddress = new Address6(address);
+  const ownerAddress = new Address7(address);
   const salt = randomBytes6(DEFAULT_KEY_SIZE);
   const key = scrypt({
     password: bufferFromString(password),
@@ -8748,8 +9075,8 @@ async function decryptKeystoreWallet(jsonWallet, password) {
   const macHashUint8Array = keccak256(data);
   const macHash = stringFromBuffer(macHashUint8Array, "hex");
   if (mac !== macHash) {
-    throw new FuelError23(
-      ErrorCode20.INVALID_PASSWORD,
+    throw new FuelError24(
+      ErrorCode21.INVALID_PASSWORD,
       "Failed to decrypt the keystore wallet, the provided password is incorrect."
     );
   }
@@ -8888,14 +9215,14 @@ var BaseWalletUnlocked = class extends Account {
 
 // src/hdwallet/hdwallet.ts
 import { computeHmac as computeHmac2, ripemd160 } from "@fuel-ts/crypto";
-import { ErrorCode as ErrorCode23, FuelError as FuelError26 } from "@fuel-ts/errors";
+import { ErrorCode as ErrorCode24, FuelError as FuelError27 } from "@fuel-ts/errors";
 import { sha256 as sha2564 } from "@fuel-ts/hasher";
-import { bn as bn22, toBytes as toBytes3, toHex } from "@fuel-ts/math";
+import { bn as bn23, toBytes as toBytes3, toHex } from "@fuel-ts/math";
 import { arrayify as arrayify21, hexlify as hexlify25, concat as concat7, dataSlice as dataSlice2, encodeBase58 as encodeBase582, decodeBase58 } from "@fuel-ts/utils";
 
 // src/mnemonic/mnemonic.ts
 import { randomBytes as randomBytes7, pbkdf2, computeHmac } from "@fuel-ts/crypto";
-import { ErrorCode as ErrorCode22, FuelError as FuelError25 } from "@fuel-ts/errors";
+import { ErrorCode as ErrorCode23, FuelError as FuelError26 } from "@fuel-ts/errors";
 import { sha256 as sha2563 } from "@fuel-ts/hasher";
 import { arrayify as arrayify20, hexlify as hexlify24, concat as concat6, dataSlice, encodeBase58, toUtf8Bytes } from "@fuel-ts/utils";
 
@@ -10952,7 +11279,7 @@ var english = [
 ];
 
 // src/mnemonic/utils.ts
-import { ErrorCode as ErrorCode21, FuelError as FuelError24 } from "@fuel-ts/errors";
+import { ErrorCode as ErrorCode22, FuelError as FuelError25 } from "@fuel-ts/errors";
 import { sha256 as sha2562 } from "@fuel-ts/hasher";
 import { arrayify as arrayify19 } from "@fuel-ts/utils";
 function getLowerMask(bits) {
@@ -11006,8 +11333,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 FuelError24(
-        ErrorCode21.INVALID_MNEMONIC,
+      throw new FuelError25(
+        ErrorCode22.INVALID_MNEMONIC,
         `Invalid mnemonic: the word '${words[i]}' is not found in the provided wordlist.`
       );
     }
@@ -11023,8 +11350,8 @@ function mnemonicWordsToEntropy(words, wordlist) {
   const checksumMask = getUpperMask(checksumBits);
   const checksum = arrayify19(sha2562(entropy.slice(0, entropyBits / 8)))[0] & checksumMask;
   if (checksum !== (entropy[entropy.length - 1] & checksumMask)) {
-    throw new FuelError24(
-      ErrorCode21.INVALID_CHECKSUM,
+    throw new FuelError25(
+      ErrorCode22.INVALID_CHECKSUM,
       "Checksum validation failed for the provided mnemonic."
     );
   }
@@ -11039,8 +11366,8 @@ var TestnetPRV = "0x04358394";
 var MNEMONIC_SIZES = [12, 15, 18, 21, 24];
 function assertWordList(wordlist) {
   if (wordlist.length !== 2048) {
-    throw new FuelError25(
-      ErrorCode22.INVALID_WORD_LIST,
+    throw new FuelError26(
+      ErrorCode23.INVALID_WORD_LIST,
       `Expected word list length of 2048, but got ${wordlist.length}.`
     );
   }
@@ -11048,8 +11375,8 @@ function assertWordList(wordlist) {
 __name(assertWordList, "assertWordList");
 function assertEntropy(entropy) {
   if (entropy.length % 4 !== 0 || entropy.length < 16 || entropy.length > 32) {
-    throw new FuelError25(
-      ErrorCode22.INVALID_ENTROPY,
+    throw new FuelError26(
+      ErrorCode23.INVALID_ENTROPY,
       `Entropy should be between 16 and 32 bytes and a multiple of 4, but got ${entropy.length} bytes.`
     );
   }
@@ -11060,7 +11387,7 @@ function assertMnemonic(words) {
     const errorMsg = `Invalid mnemonic size. Expected one of [${MNEMONIC_SIZES.join(
       ", "
     )}] words, but got ${words.length}.`;
-    throw new FuelError25(ErrorCode22.INVALID_MNEMONIC, errorMsg);
+    throw new FuelError26(ErrorCode23.INVALID_MNEMONIC, errorMsg);
   }
 }
 __name(assertMnemonic, "assertMnemonic");
@@ -11182,8 +11509,8 @@ var Mnemonic = class _Mnemonic {
   static masterKeysFromSeed(seed) {
     const seedArray = arrayify20(seed);
     if (seedArray.length < 16 || seedArray.length > 64) {
-      throw new FuelError25(
-        ErrorCode22.INVALID_SEED,
+      throw new FuelError26(
+        ErrorCode23.INVALID_SEED,
         `Seed length should be between 16 and 64 bytes, but received ${seedArray.length} bytes.`
       );
     }
@@ -11264,7 +11591,7 @@ __name(isValidExtendedKey, "isValidExtendedKey");
 function parsePath(path2, depth = 0) {
   const components = path2.split("/");
   if (components.length === 0 || components[0] === "m" && depth !== 0) {
-    throw new FuelError26(ErrorCode23.HD_WALLET_ERROR, `invalid path - ${path2}`);
+    throw new FuelError27(ErrorCode24.HD_WALLET_ERROR, `invalid path - ${path2}`);
   }
   if (components[0] === "m") {
     components.shift();
@@ -11297,8 +11624,8 @@ var HDWallet = class _HDWallet {
       this.privateKey = hexlify25(config.privateKey);
     } else {
       if (!config.publicKey) {
-        throw new FuelError26(
-          ErrorCode23.HD_WALLET_ERROR,
+        throw new FuelError27(
+          ErrorCode24.HD_WALLET_ERROR,
           "Both public and private Key cannot be missing. At least one should be provided."
         );
       }
@@ -11327,8 +11654,8 @@ var HDWallet = class _HDWallet {
     const data = new Uint8Array(37);
     if (index & HARDENED_INDEX) {
       if (!privateKey) {
-        throw new FuelError26(
-          ErrorCode23.HD_WALLET_ERROR,
+        throw new FuelError27(
+          ErrorCode24.HD_WALLET_ERROR,
           "Cannot derive a hardened index without a private Key."
         );
       }
@@ -11342,7 +11669,7 @@ var HDWallet = class _HDWallet {
     const IR = bytes.slice(32);
     if (privateKey) {
       const N = "0xfffffffffffffffffffffffffffffffebaaedce6af48a03bbfd25e8cd0364141";
-      const ki = bn22(IL).add(privateKey).mod(N).toBytes(32);
+      const ki = bn23(IL).add(privateKey).mod(N).toBytes(32);
       return new _HDWallet({
         privateKey: ki,
         chainCode: IR,
@@ -11380,8 +11707,8 @@ var HDWallet = class _HDWallet {
    */
   toExtendedKey(isPublic = false, testnet = false) {
     if (this.depth >= 256) {
-      throw new FuelError26(
-        ErrorCode23.HD_WALLET_ERROR,
+      throw new FuelError27(
+        ErrorCode24.HD_WALLET_ERROR,
         `Exceeded max depth of 255. Current depth: ${this.depth}.`
       );
     }
@@ -11412,10 +11739,10 @@ var HDWallet = class _HDWallet {
     const bytes = arrayify21(decoded);
     const validChecksum = base58check(bytes.slice(0, 78)) === extendedKey;
     if (bytes.length !== 82 || !isValidExtendedKey(bytes)) {
-      throw new FuelError26(ErrorCode23.HD_WALLET_ERROR, "Provided key is not a valid extended key.");
+      throw new FuelError27(ErrorCode24.HD_WALLET_ERROR, "Provided key is not a valid extended key.");
     }
     if (!validChecksum) {
-      throw new FuelError26(ErrorCode23.HD_WALLET_ERROR, "Provided key has an invalid checksum.");
+      throw new FuelError27(ErrorCode24.HD_WALLET_ERROR, "Provided key has an invalid checksum.");
     }
     const depth = bytes[4];
     const parentFingerprint = hexlify25(bytes.slice(5, 9));
@@ -11423,14 +11750,14 @@ var HDWallet = class _HDWallet {
     const chainCode = hexlify25(bytes.slice(13, 45));
     const key = bytes.slice(45, 78);
     if (depth === 0 && parentFingerprint !== "0x00000000" || depth === 0 && index !== 0) {
-      throw new FuelError26(
-        ErrorCode23.HD_WALLET_ERROR,
+      throw new FuelError27(
+        ErrorCode24.HD_WALLET_ERROR,
         "Inconsistency detected: Depth is zero but fingerprint/index is non-zero."
       );
     }
     if (isPublicExtendedKey(bytes)) {
       if (key[0] !== 3) {
-        throw new FuelError26(ErrorCode23.HD_WALLET_ERROR, "Invalid public extended key.");
+        throw new FuelError27(ErrorCode24.HD_WALLET_ERROR, "Invalid public extended key.");
       }
       return new _HDWallet({
         publicKey: key,
@@ -11441,7 +11768,7 @@ var HDWallet = class _HDWallet {
       });
     }
     if (key[0] !== 0) {
-      throw new FuelError26(ErrorCode23.HD_WALLET_ERROR, "Invalid private extended key.");
+      throw new FuelError27(ErrorCode24.HD_WALLET_ERROR, "Invalid private extended key.");
     }
     return new _HDWallet({
       privateKey: key.slice(1),
@@ -11677,7 +12004,7 @@ var WalletsConfig = class _WalletsConfig {
       assetIds.forEach((assetId) => {
         for (let index = 0; index < coinsPerAsset; index++) {
           coins.push({
-            amount: bn23(amountPerCoin).toString(),
+            amount: bn24(amountPerCoin).toString(),
             asset_id: assetId,
             owner: walletAddress,
             tx_pointer_block_height: 0,
@@ -11697,26 +12024,26 @@ var WalletsConfig = class _WalletsConfig {
     amountPerCoin
   }) {
     if (Array.isArray(wallets) && wallets.length === 0 || typeof wallets === "number" && wallets <= 0) {
-      throw new FuelError27(
-        FuelError27.CODES.INVALID_INPUT_PARAMETERS,
+      throw new FuelError28(
+        FuelError28.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 FuelError27(
-        FuelError27.CODES.INVALID_INPUT_PARAMETERS,
+      throw new FuelError28(
+        FuelError28.CODES.INVALID_INPUT_PARAMETERS,
         "Number of assets per wallet must be greater than zero."
       );
     }
     if (coinsPerAsset <= 0) {
-      throw new FuelError27(
-        FuelError27.CODES.INVALID_INPUT_PARAMETERS,
+      throw new FuelError28(
+        FuelError28.CODES.INVALID_INPUT_PARAMETERS,
         "Number of coins per asset must be greater than zero."
       );
     }
-    if (bn23(amountPerCoin).lt(0)) {
-      throw new FuelError27(
-        FuelError27.CODES.INVALID_INPUT_PARAMETERS,
+    if (bn24(amountPerCoin).lt(0)) {
+      throw new FuelError28(
+        FuelError28.CODES.INVALID_INPUT_PARAMETERS,
         "Amount per coin must be greater than or equal to zero."
       );
     }
@@ -11792,9 +12119,9 @@ async function setupTestProviderAndWallets({
 __name(setupTestProviderAndWallets, "setupTestProviderAndWallets");
 
 // src/test-utils/test-message.ts
-import { Address as Address7 } from "@fuel-ts/address";
+import { Address as Address8 } from "@fuel-ts/address";
 import { randomBytes as randomBytes9 } from "@fuel-ts/crypto";
-import { bn as bn24 } from "@fuel-ts/math";
+import { bn as bn25 } from "@fuel-ts/math";
 import { hexlify as hexlify27 } from "@fuel-ts/utils";
 var TestMessage = class {
   static {
@@ -11813,8 +12140,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 = Address7.fromRandom(),
-    recipient = Address7.fromRandom(),
+    sender = Address8.fromRandom(),
+    recipient = Address8.fromRandom(),
     nonce = hexlify27(randomBytes9(32)),
     amount = 1e6,
     data = "",
@@ -11834,7 +12161,7 @@ var TestMessage = class {
       sender: this.sender.toB256(),
       recipient: recipient?.toB256() ?? this.recipient.toB256(),
       nonce: this.nonce,
-      amount: bn24(this.amount).toNumber(),
+      amount: bn25(this.amount).toNumber(),
       data,
       da_height: this.da_height
     };