@fuel-ts/account 0.101.2 → 0.101.3

package/dist/index.js

@@ -105,6 +105,8 @@ __export(src_exports, {
   calculateMinGasForTxUpload: () => calculateMinGasForTxUpload,
   calculateTXFeeForSummary: () => calculateTXFeeForSummary,
   coinQuantityfy: () => coinQuantityfy,
+  consolidateCoins: () => consolidateCoins,
+  consolidateCoinsIfRequired: () => consolidateCoinsIfRequired,
   deferPromise: () => deferPromise,
   deployScriptOrPredicate: () => deployScriptOrPredicate,
   deserializeChain: () => deserializeChain,
@@ -123,6 +125,7 @@ __export(src_exports, {
   extractTxError: () => extractTxError,
   fuelAssetsBaseUrl: () => fuelAssetsBaseUrl,
   gasUsedByInputs: () => gasUsedByInputs,
+  getAllCoins: () => getAllCoins,
   getAllDecodedLogs: () => getAllDecodedLogs,
   getAssetAmountInRequestInputs: () => getAssetAmountInRequestInputs,
   getAssetById: () => getAssetById,
@@ -929,13 +932,13 @@ var getAssetsByOwner = /* @__PURE__ */ __name(async (opts) => {
 
 // src/account.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_crypto2 = require("@fuel-ts/crypto");
-var import_errors22 = require("@fuel-ts/errors");
-var import_math22 = require("@fuel-ts/math");
-var import_transactions28 = require("@fuel-ts/transactions");
+var import_errors23 = require("@fuel-ts/errors");
+var import_math23 = require("@fuel-ts/math");
+var import_transactions29 = require("@fuel-ts/transactions");
 var import_utils37 = require("@fuel-ts/utils");
-var import_ramda9 = require("ramda");
+var import_ramda10 = require("ramda");
 
 // src/providers/coin-quantity.ts
 var import_math = require("@fuel-ts/math");
@@ -2376,8 +2379,11 @@ var import_graphql = require("graphql");
 
 // src/providers/utils/handle-gql-error-message.ts
 var import_errors2 = 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/,
@@ -2393,6 +2399,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_errors2.FuelError(
+      import_errors2.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_errors2.FuelError(
+      import_errors2.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] || "";
@@ -3538,6 +3584,7 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
   }
   return new import_errors8.FuelError(import_errors8.ErrorCode.SCRIPT_REVERTED, errorMessage, {
     ...metadata,
+    abiError,
     reason
   });
 }
@@ -4592,11 +4639,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;
   }
   /**
@@ -6222,25 +6273,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");
   }
@@ -6255,9 +6287,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
@@ -6797,7 +6862,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_errors20.FuelError(
+          import_errors20.ErrorCode.RESPONSE_BODY_EMPTY,
+          "The response from the server is missing the body",
+          { timestamp: (/* @__PURE__ */ new Date()).toISOString(), request: request2, response }
+        );
+      }
+      return response;
     }, retryOptions);
   }
   static applyBlockHeight(request2, url) {
@@ -6820,13 +6893,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);
@@ -7249,7 +7324,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.
@@ -8344,7 +8425,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.
@@ -8675,7 +8760,12 @@ var deserializeTransactionResponseJson = /* @__PURE__ */ __name((json) => {
   } = json;
   const provider = new Provider(providerUrl, { cache: providerCache });
   const { chainId } = providerCache.chain.consensusParameters;
-  const response = new TransactionResponse(id, provider, Number(chainId), abis);
+  const response = new TransactionResponse({
+    transactionRequestOrId: id,
+    provider,
+    chainId: Number(chainId),
+    abis
+  });
   if (requestJson) {
     response.request = transactionRequestify(JSON.parse(requestJson));
   }
@@ -8692,9 +8782,157 @@ var AbstractAccount = class {
   }
 };
 
+// src/utils/consolidate-coins.ts
+var import_address4 = require("@fuel-ts/address");
+var import_errors22 = require("@fuel-ts/errors");
+var import_math22 = require("@fuel-ts/math");
+var import_transactions28 = require("@fuel-ts/transactions");
+var import_ramda9 = require("ramda");
+var CONSOLIDATABLE_ERROR_CODES = [import_errors22.ErrorCode.MAX_COINS_REACHED];
+var consolidateCoinsIfRequired = /* @__PURE__ */ __name(async (opts) => {
+  const { error: errorUnknown, account, skipAutoConsolidation = false } = opts;
+  if (skipAutoConsolidation) {
+    return false;
+  }
+  const error = import_errors22.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_errors22.FuelError(import_errors22.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_address4.Address(outputCoin.to),
+    blockCreated: (0, import_math22.bn)(0),
+    txCreatedIdx: (0, import_math22.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_errors22.FuelError(
+      import_errors22.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 request2 = new ScriptTransactionRequest({
+      scriptData: "0x"
+    });
+    request2.addResources(batch);
+    return request2;
+  });
+  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_math22.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, request2) => acc.add(request2.maxFee), (0, import_math22.bn)(0)),
+    submitAll
+  };
+}, "consolidateCoins");
+
 // src/utils/formatTransferToContractScriptData.ts
 var import_abi_coder8 = require("@fuel-ts/abi-coder");
-var import_address4 = require("@fuel-ts/address");
+var import_address5 = require("@fuel-ts/address");
 var import_utils36 = require("@fuel-ts/utils");
 var asm = __toESM(require("@fuels/vm-asm"));
 var formatTransferToContractScriptData = /* @__PURE__ */ __name((transferParams) => {
@@ -8702,7 +8940,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_utils36.concat)([new import_address4.Address(contractId).toBytes(), encoded, (0, import_utils36.arrayify)(assetId)]);
+    const scriptData = (0, import_utils36.concat)([new import_address5.Address(contractId).toBytes(), encoded, (0, import_utils36.arrayify)(assetId)]);
     return (0, import_utils36.concat)([acc, scriptData]);
   }, new Uint8Array());
 }, "formatTransferToContractScriptData");
@@ -8773,7 +9011,7 @@ var Account = class extends AbstractAccount {
     super();
     this._provider = provider;
     this._connector = connector;
-    this.address = new import_address5.Address(address);
+    this.address = new import_address6.Address(address);
   }
   /**
    * The provider used to interact with the network.
@@ -8784,7 +9022,7 @@ var Account = class extends AbstractAccount {
    */
   get provider() {
     if (!this._provider) {
-      throw new import_errors22.FuelError(import_errors22.ErrorCode.MISSING_PROVIDER, "Provider not set");
+      throw new import_errors23.FuelError(import_errors23.ErrorCode.MISSING_PROVIDER, "Provider not set");
     }
     return this._provider;
   }
@@ -8811,10 +9049,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.
@@ -8863,7 +9115,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(request2, params) {
+  async fund(request2, params, { skipAutoConsolidation } = {}) {
     const {
       addedSignatures,
       estimatedPredicates,
@@ -8875,9 +9127,9 @@ var Account = class extends AbstractAccount {
     const chainId = await this.provider.getChainId();
     const fee = request2.maxFee;
     const baseAssetId = await this.provider.getBaseAssetId();
-    const requiredInBaseAsset = requiredQuantities.find((quantity) => quantity.assetId === baseAssetId)?.amount || (0, import_math22.bn)(0);
+    const requiredInBaseAsset = requiredQuantities.find((quantity) => quantity.assetId === baseAssetId)?.amount || (0, import_math23.bn)(0);
     const requiredQuantitiesWithFee = addAmountToCoinQuantities({
-      amount: (0, import_math22.bn)(fee),
+      amount: (0, import_math23.bn)(fee),
       assetId: baseAssetId,
       coinQuantities: requiredQuantities
     });
@@ -8885,7 +9137,7 @@ var Account = class extends AbstractAccount {
     requiredQuantitiesWithFee.forEach(({ amount, assetId }) => {
       quantitiesDict[assetId] = {
         required: amount,
-        owned: (0, import_math22.bn)(0)
+        owned: (0, import_math23.bn)(0)
       };
     });
     request2.inputs.filter(isRequestInputResource).forEach((input) => {
@@ -8909,11 +9161,12 @@ var Account = class extends AbstractAccount {
     while (needsToBeFunded && fundingAttempts < MAX_FUNDING_ATTEMPTS) {
       const resources = await this.getResourcesToSpend(
         missingQuantities,
-        cacheRequestInputsResourcesFromOwner(request2.inputs, this.address)
+        cacheRequestInputsResourcesFromOwner(request2.inputs, this.address),
+        { skipAutoConsolidation }
       );
       request2.addResources(resources);
       request2.updatePredicateGasUsed(estimatedPredicates);
-      const requestToReestimate2 = (0, import_ramda9.clone)(request2);
+      const requestToReestimate2 = (0, import_ramda10.clone)(request2);
       if (addedSignatures) {
         Array.from({ length: addedSignatures }).forEach(
           () => requestToReestimate2.addEmptyWitness()
@@ -8946,15 +9199,15 @@ var Account = class extends AbstractAccount {
       fundingAttempts += 1;
     }
     if (needsToBeFunded) {
-      throw new import_errors22.FuelError(
-        import_errors22.ErrorCode.INSUFFICIENT_FUNDS_OR_MAX_COINS,
+      throw new import_errors23.FuelError(
+        import_errors23.ErrorCode.INSUFFICIENT_FUNDS,
         `The account ${this.address} does not have enough base asset funds to cover the transaction execution.`
       );
     }
     request2.updateState(chainId, "funded", transactionSummary);
     await this.provider.validateTransaction(request2);
     request2.updatePredicateGasUsed(estimatedPredicates);
-    const requestToReestimate = (0, import_ramda9.clone)(request2);
+    const requestToReestimate = (0, import_ramda10.clone)(request2);
     if (addedSignatures) {
       Array.from({ length: addedSignatures }).forEach(() => requestToReestimate.addEmptyWitness());
     }
@@ -8975,16 +9228,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 request2 = new ScriptTransactionRequest(txParams);
     request2 = this.addTransfer(request2, {
       destination,
       amount,
       assetId: assetId || await this.provider.getBaseAssetId()
     });
-    const { gasPrice, transactionRequest } = await this.assembleTx(request2);
+    const { gasPrice, transactionRequest } = await this.assembleTx({
+      transactionRequest: request2,
+      skipAutoConsolidation
+    });
     request2 = await setAndValidateGasAndFeeForAssembledTx({
       gasPrice,
       provider: this.provider,
@@ -9001,10 +9258,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 request2 = await this.createTransfer(destination, amount, assetId, txParams);
+  async transfer(destination, amount, assetId, txParams = {}, { skipAutoConsolidation } = {}) {
+    const request2 = await this.createTransfer(destination, amount, assetId, txParams, {
+      skipAutoConsolidation
+    });
     return this.sendTransaction(request2, { estimateTxDependencies: false });
   }
   /**
@@ -9012,12 +9272,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 request2 = new ScriptTransactionRequest(txParams);
     request2 = this.addBatchTransfer(request2, transferParams);
-    const { gasPrice, transactionRequest } = await this.assembleTx(request2);
+    const { gasPrice, transactionRequest } = await this.assembleTx({
+      transactionRequest: request2,
+      skipAutoConsolidation
+    });
     request2 = await setAndValidateGasAndFeeForAssembledTx({
       gasPrice,
       provider: this.provider,
@@ -9037,7 +9301,7 @@ var Account = class extends AbstractAccount {
   addTransfer(request2, transferParams) {
     const { destination, amount, assetId } = transferParams;
     this.validateTransferAmount(amount);
-    request2.addCoinOutput(new import_address5.Address(destination), amount, assetId);
+    request2.addCoinOutput(new import_address6.Address(destination), amount, assetId);
     return request2;
   }
   /**
@@ -9064,24 +9328,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 request2 = new ScriptTransactionRequest({
       ...txParams
     });
     const quantities = [];
     const defaultAssetId = await this.provider.getBaseAssetId();
     const transferParams = contractTransferParams.map((transferParam) => {
-      const amount = (0, import_math22.bn)(transferParam.amount);
-      const contractAddress = new import_address5.Address(transferParam.contractId);
+      const amount = (0, import_math23.bn)(transferParam.amount);
+      const contractAddress = new import_address6.Address(transferParam.contractId);
       const assetId = transferParam.assetId ? (0, import_utils37.hexlify)(transferParam.assetId) : defaultAssetId;
       if (amount.lte(0)) {
-        throw new import_errors22.FuelError(
-          import_errors22.ErrorCode.INVALID_TRANSFER_AMOUNT,
+        throw new import_errors23.FuelError(
+          import_errors23.ErrorCode.INVALID_TRANSFER_AMOUNT,
           "Transfer amount must be a positive number."
         );
       }
@@ -9096,7 +9363,11 @@ var Account = class extends AbstractAccount {
     const { script, scriptData } = await assembleTransferToContractScript(transferParams);
     request2.script = script;
     request2.scriptData = scriptData;
-    const { gasPrice, transactionRequest } = await this.assembleTx(request2, quantities);
+    const { gasPrice, transactionRequest } = await this.assembleTx({
+      transactionRequest: request2,
+      quantities,
+      skipAutoConsolidation
+    });
     request2 = await setAndValidateGasAndFeeForAssembledTx({
       gasPrice,
       provider: this.provider,
@@ -9112,15 +9383,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_address5.Address(recipient);
+  async withdrawToBaseLayer(recipient, amount, txParams = {}, { skipAutoConsolidation } = {}) {
+    const recipientAddress = new import_address6.Address(recipient);
     const recipientDataArray = (0, import_utils37.arrayify)(
       "0x".concat(recipientAddress.toHexString().substring(2).padStart(64, "0"))
     );
     const amountDataArray = (0, import_utils37.arrayify)(
-      "0x".concat((0, import_math22.bn)(amount).toHex().substring(2).padStart(16, "0"))
+      "0x".concat((0, import_math23.bn)(amount).toHex().substring(2).padStart(16, "0"))
     );
     const script = new Uint8Array([
       ...(0, import_utils37.arrayify)(withdrawScript.bytes),
@@ -9130,8 +9402,12 @@ var Account = class extends AbstractAccount {
     const params = { script, ...txParams };
     const baseAssetId = await this.provider.getBaseAssetId();
     let request2 = new ScriptTransactionRequest(params);
-    const quantities = [{ amount: (0, import_math22.bn)(amount), assetId: baseAssetId }];
-    const { gasPrice, transactionRequest } = await this.assembleTx(request2, quantities);
+    const quantities = [{ amount: (0, import_math23.bn)(amount), assetId: baseAssetId }];
+    const { gasPrice, transactionRequest } = await this.assembleTx({
+      transactionRequest: request2,
+      quantities,
+      skipAutoConsolidation
+    });
     request2 = await setAndValidateGasAndFeeForAssembledTx({
       gasPrice,
       provider: this.provider,
@@ -9141,6 +9417,25 @@ var Account = class extends AbstractAccount {
     });
     return this.sendTransaction(request2);
   }
+  /**
+   * 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.
    *
@@ -9160,6 +9455,7 @@ var Account = class extends AbstractAccount {
     const isBaseAsset = baseAssetId === assetId;
     let submitAll;
     const consolidationParams = {
+      assetId,
       coins,
       mode: params.mode,
       outputNum: params.outputNum
@@ -9167,10 +9463,7 @@ var Account = class extends AbstractAccount {
     if (isBaseAsset) {
       ({ submitAll } = await this.assembleBaseAssetConsolidationTxs(consolidationParams));
     } else {
-      throw new import_errors22.FuelError(
-        import_errors22.ErrorCode.UNSUPPORTED_FEATURE,
-        "Consolidation for non-base assets is not supported yet."
-      );
+      ({ submitAll } = await this.assembleNonBaseAssetConsolidationTxs(consolidationParams));
     }
     return submitAll();
   }
@@ -9191,7 +9484,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_math22.bn)(0);
+    let totalFeeCost = (0, import_math23.bn)(0);
     const txs = [];
     const coinsBatches = splitCoinsIntoBatches(coins, maxInputsNumber);
     const gasPrice = await this.provider.estimateGasPrice(10);
@@ -9215,10 +9508,10 @@ var Account = class extends AbstractAccount {
       });
       request2.maxFee = fee;
       if (consolidateMoreThanOneCoin) {
-        const total = request2.inputs.filter(isRequestInputCoin).reduce((acc, input) => acc.add(input.amount), (0, import_math22.bn)(0));
+        const total = request2.inputs.filter(isRequestInputCoin).reduce((acc, input) => acc.add(input.amount), (0, import_math23.bn)(0));
         const amountPerNewUtxo = total.div(outputNum + 1);
         request2.outputs.forEach((output) => {
-          if (output.type === import_transactions28.OutputType.Coin) {
+          if (output.type === import_transactions29.OutputType.Coin) {
             output.amount = amountPerNewUtxo;
           }
         });
@@ -9229,6 +9522,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_math23.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 request2 = new ScriptTransactionRequest({
+        script: "0x"
+      });
+      request2.addResources(coinBatch);
+      if (consolidateMoreThanOneCoin) {
+        Array.from({ length: outputNum - 1 }).forEach(() => {
+          request2.addCoinOutput(this.address, 0, assetId);
+        });
+      }
+      const minGas = request2.calculateMinGas(chainInfo);
+      const fee = calculateGasFee({
+        gasPrice,
+        gas: minGas,
+        priceFactor: chainInfo.consensusParameters.feeParameters.gasPriceFactor,
+        tip: request2.tip
+      });
+      request2.maxFee = fee;
+      if (consolidateMoreThanOneCoin) {
+        const total = request2.inputs.filter(isRequestInputCoin).reduce((acc, input) => acc.add(input.amount), (0, import_math23.bn)(0));
+        const amountPerNewUtxo = total.div(outputNum + 1);
+        request2.outputs.forEach((output) => {
+          if (output.type === import_transactions29.OutputType.Coin) {
+            output.amount = amountPerNewUtxo;
+          }
+        });
+      }
+      totalFeeCost = totalFeeCost.add(fee);
+      const baseAssetResources = [];
+      let fundingFeeTotal = (0, import_math23.bn)(0);
+      while (fundingFeeTotal.lt(fee)) {
+        const baseAssetCoin = baseAssetCoins.pop();
+        if (!baseAssetCoin) {
+          break;
+        }
+        baseAssetResources.push(baseAssetCoin);
+        fundingFeeTotal = fundingFeeTotal.add(baseAssetCoin.amount);
+      }
+      const { inputs } = request2;
+      request2.inputs = inputs.slice(0, maxInputsNumber - baseAssetResources.length);
+      const removedCoins = coinBatch.slice(maxInputsNumber - baseAssetResources.length);
+      request2.addResources(baseAssetResources);
+      const lastCoinBatch = assetCoinBatches[assetCoinBatches.length - 1];
+      lastCoinBatch.push(...removedCoins);
+      if (lastCoinBatch.length > maxInputsNumber) {
+        assetCoinBatches.push(lastCoinBatch.slice(maxInputsNumber));
+      }
+      txs.push(request2);
+    });
+    const submitAll = this.prepareSubmitAll({ txs, mode });
+    return { txs, totalFeeCost, submitAll };
+  }
   /**
    * Prepares a function to submit all transactions either sequentially or in parallel.
    *
@@ -9283,13 +9640,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_math22.bn)("100000000000000000") }];
+    const transactionFeeForDryRun = [{ assetId: baseAssetId, amount: (0, import_math23.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)) {
@@ -9335,7 +9692,7 @@ var Account = class extends AbstractAccount {
    */
   async signMessage(message) {
     if (!this._connector) {
-      throw new import_errors22.FuelError(import_errors22.ErrorCode.MISSING_CONNECTOR, "A connector is required to sign messages.");
+      throw new import_errors23.FuelError(import_errors23.ErrorCode.MISSING_CONNECTOR, "A connector is required to sign messages.");
     }
     return this._connector.signMessage(this.address.toString(), message);
   }
@@ -9347,8 +9704,8 @@ var Account = class extends AbstractAccount {
    */
   async signTransaction(transactionRequestLike, connectorOptions = {}) {
     if (!this._connector) {
-      throw new import_errors22.FuelError(
-        import_errors22.ErrorCode.MISSING_CONNECTOR,
+      throw new import_errors23.FuelError(
+        import_errors23.ErrorCode.MISSING_CONNECTOR,
         "A connector is required to sign transactions."
       );
     }
@@ -9415,8 +9772,8 @@ var Account = class extends AbstractAccount {
     return coins.map((coin) => ({
       id: (0, import_utils37.hexlify)((0, import_crypto2.randomBytes)(import_abi_coder9.UTXO_ID_LEN)),
       owner: this.address,
-      blockCreated: (0, import_math22.bn)(1),
-      txCreatedIdx: (0, import_math22.bn)(1),
+      blockCreated: (0, import_math23.bn)(1),
+      txCreatedIdx: (0, import_math23.bn)(1),
       ...coin
     }));
   }
@@ -9443,73 +9800,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_math22.bn)(amount) }));
-    transactionRequest.gasLimit = (0, import_math22.bn)(0);
-    transactionRequest.maxFee = (0, import_math22.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_math23.bn)(amount) }));
+    transactionRequest.gasLimit = (0, import_math23.bn)(0);
+    transactionRequest.maxFee = (0, import_math23.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_math22.bn)(amount).lte(0)) {
-      throw new import_errors22.FuelError(
-        import_errors22.ErrorCode.INVALID_TRANSFER_AMOUNT,
+    if ((0, import_math23.bn)(amount).lte(0)) {
+      throw new import_errors23.FuelError(
+        import_errors23.ErrorCode.INVALID_TRANSFER_AMOUNT,
         "Transfer amount must be a positive number."
       );
     }
   }
   /** @hidden * */
-  async estimateAndFundTransaction(transactionRequest, txParams, costParams) {
-    let request2 = transactionRequest;
-    const txCost = await this.getTransactionCost(request2, costParams);
-    request2 = this.validateGasLimitAndMaxFee({
-      transactionRequest: request2,
-      gasUsed: txCost.gasUsed,
-      maxFee: txCost.maxFee,
-      txParams
-    });
-    request2 = await this.fund(request2, txCost);
-    return request2;
-  }
-  /** @hidden * */
-  validateGasLimitAndMaxFee({
-    gasUsed,
-    maxFee,
-    transactionRequest,
-    txParams: { gasLimit: setGasLimit, maxFee: setMaxFee }
-  }) {
-    const request2 = transactionRequestify(transactionRequest);
-    if (!(0, import_utils37.isDefined)(setGasLimit)) {
-      request2.gasLimit = gasUsed;
-    } else if (gasUsed.gt(setGasLimit)) {
-      throw new import_errors22.FuelError(
-        import_errors22.ErrorCode.GAS_LIMIT_TOO_LOW,
-        `Gas limit '${setGasLimit}' is lower than the required: '${gasUsed}'.`
-      );
-    }
-    if (!(0, import_utils37.isDefined)(setMaxFee)) {
-      request2.maxFee = maxFee;
-    } else if (maxFee.gt(setMaxFee)) {
-      throw new import_errors22.FuelError(
-        import_errors22.ErrorCode.MAX_FEE_TOO_LOW,
-        `Max fee '${setMaxFee}' is lower than the required: '${maxFee}'.`
-      );
-    }
-    return request2;
-  }
-  /** @hidden * */
   validateConsolidationTxsCoins(coins, assetId) {
     if (coins.length <= 1) {
-      throw new import_errors22.FuelError(import_errors22.ErrorCode.NO_COINS_TO_CONSOLIDATE, "No coins to consolidate.");
+      throw new import_errors23.FuelError(import_errors23.ErrorCode.NO_COINS_TO_CONSOLIDATE, "No coins to consolidate.");
     }
     if (!coins.every((c) => c.assetId === assetId)) {
-      throw new import_errors22.FuelError(
-        import_errors22.ErrorCode.COINS_ASSET_ID_MISMATCH,
+      throw new import_errors23.FuelError(
+        import_errors23.ErrorCode.COINS_ASSET_ID_MISMATCH,
         "All coins to consolidate must be from the same asset id."
       );
     }
@@ -9538,10 +9872,10 @@ var import_hasher4 = require("@fuel-ts/hasher");
 var import_utils40 = require("@fuel-ts/utils");
 
 // src/signer/signer.ts
-var import_address6 = require("@fuel-ts/address");
+var import_address7 = require("@fuel-ts/address");
 var import_crypto3 = require("@fuel-ts/crypto");
 var import_hasher3 = require("@fuel-ts/hasher");
-var import_math23 = require("@fuel-ts/math");
+var import_math24 = require("@fuel-ts/math");
 var import_utils38 = require("@fuel-ts/utils");
 var import_secp256k1 = require("@noble/curves/secp256k1");
 var Signer = class _Signer {
@@ -9564,11 +9898,11 @@ var Signer = class _Signer {
         privateKey = `0x${privateKey}`;
       }
     }
-    const privateKeyBytes = (0, import_math23.toBytes)(privateKey, 32);
+    const privateKeyBytes = (0, import_math24.toBytes)(privateKey, 32);
     this.privateKey = (0, import_utils38.hexlify)(privateKeyBytes);
     this.publicKey = (0, import_utils38.hexlify)(import_secp256k1.secp256k1.getPublicKey(privateKeyBytes, false).slice(1));
     this.compressedPublicKey = (0, import_utils38.hexlify)(import_secp256k1.secp256k1.getPublicKey(privateKeyBytes, true));
-    this.address = new import_address6.Address(this.publicKey);
+    this.address = new import_address7.Address(this.publicKey);
   }
   /**
    * Sign data using the Signer instance
@@ -9582,8 +9916,8 @@ var Signer = class _Signer {
    */
   sign(data) {
     const signature = import_secp256k1.secp256k1.sign((0, import_utils38.arrayify)(data), (0, import_utils38.arrayify)(this.privateKey));
-    const r = (0, import_math23.toBytes)(`0x${signature.r.toString(16)}`, 32);
-    const s = (0, import_math23.toBytes)(`0x${signature.s.toString(16)}`, 32);
+    const r = (0, import_math24.toBytes)(`0x${signature.r.toString(16)}`, 32);
+    const s = (0, import_math24.toBytes)(`0x${signature.s.toString(16)}`, 32);
     s[0] |= (signature.recovery || 0) << 7;
     return (0, import_utils38.hexlify)((0, import_utils38.concat)([r, s]));
   }
@@ -9626,7 +9960,7 @@ var Signer = class _Signer {
    * @returns Address from signature
    */
   static recoverAddress(data, signature) {
-    return new import_address6.Address(_Signer.recoverPublicKey(data, signature));
+    return new import_address7.Address(_Signer.recoverPublicKey(data, signature));
   }
   /**
    * Generate a random privateKey
@@ -9650,9 +9984,9 @@ var Signer = class _Signer {
 };
 
 // src/wallet/keystore-wallet.ts
-var import_address7 = require("@fuel-ts/address");
+var import_address8 = require("@fuel-ts/address");
 var import_crypto4 = require("@fuel-ts/crypto");
-var import_errors23 = require("@fuel-ts/errors");
+var import_errors24 = require("@fuel-ts/errors");
 var import_utils39 = require("@fuel-ts/utils");
 var DEFAULT_KDF_PARAMS_LOG_N = 13;
 var DEFAULT_KDF_PARAMS_R = 8;
@@ -9667,7 +10001,7 @@ var removeHexPrefix = /* @__PURE__ */ __name((hexString) => {
 }, "removeHexPrefix");
 async function encryptKeystoreWallet(privateKey, address, password) {
   const privateKeyBuffer = (0, import_crypto4.bufferFromString)(removeHexPrefix(privateKey), "hex");
-  const ownerAddress = new import_address7.Address(address);
+  const ownerAddress = new import_address8.Address(address);
   const salt = (0, import_crypto4.randomBytes)(DEFAULT_KEY_SIZE);
   const key = (0, import_crypto4.scrypt)({
     password: (0, import_crypto4.bufferFromString)(password),
@@ -9730,8 +10064,8 @@ async function decryptKeystoreWallet(jsonWallet, password) {
   const macHashUint8Array = (0, import_crypto4.keccak256)(data);
   const macHash = (0, import_crypto4.stringFromBuffer)(macHashUint8Array, "hex");
   if (mac !== macHash) {
-    throw new import_errors23.FuelError(
-      import_errors23.ErrorCode.INVALID_PASSWORD,
+    throw new import_errors24.FuelError(
+      import_errors24.ErrorCode.INVALID_PASSWORD,
       "Failed to decrypt the keystore wallet, the provided password is incorrect."
     );
   }
@@ -9870,14 +10204,14 @@ var BaseWalletUnlocked = class extends Account {
 
 // src/hdwallet/hdwallet.ts
 var import_crypto6 = require("@fuel-ts/crypto");
-var import_errors26 = require("@fuel-ts/errors");
+var import_errors27 = 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_utils44 = require("@fuel-ts/utils");
 
 // src/mnemonic/mnemonic.ts
 var import_crypto5 = require("@fuel-ts/crypto");
-var import_errors25 = require("@fuel-ts/errors");
+var import_errors26 = require("@fuel-ts/errors");
 var import_hasher6 = require("@fuel-ts/hasher");
 var import_utils42 = require("@fuel-ts/utils");
 
@@ -11940,7 +12274,7 @@ var Language = /* @__PURE__ */ ((Language2) => {
 })(Language || {});
 
 // src/mnemonic/utils.ts
-var import_errors24 = require("@fuel-ts/errors");
+var import_errors25 = require("@fuel-ts/errors");
 var import_hasher5 = require("@fuel-ts/hasher");
 var import_utils41 = require("@fuel-ts/utils");
 function getLowerMask(bits) {
@@ -11994,8 +12328,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_errors24.FuelError(
-        import_errors24.ErrorCode.INVALID_MNEMONIC,
+      throw new import_errors25.FuelError(
+        import_errors25.ErrorCode.INVALID_MNEMONIC,
         `Invalid mnemonic: the word '${words[i]}' is not found in the provided wordlist.`
       );
     }
@@ -12011,8 +12345,8 @@ function mnemonicWordsToEntropy(words, wordlist) {
   const checksumMask = getUpperMask(checksumBits);
   const checksum = (0, import_utils41.arrayify)((0, import_hasher5.sha256)(entropy.slice(0, entropyBits / 8)))[0] & checksumMask;
   if (checksum !== (entropy[entropy.length - 1] & checksumMask)) {
-    throw new import_errors24.FuelError(
-      import_errors24.ErrorCode.INVALID_CHECKSUM,
+    throw new import_errors25.FuelError(
+      import_errors25.ErrorCode.INVALID_CHECKSUM,
       "Checksum validation failed for the provided mnemonic."
     );
   }
@@ -12027,8 +12361,8 @@ var TestnetPRV = "0x04358394";
 var MNEMONIC_SIZES = [12, 15, 18, 21, 24];
 function assertWordList(wordlist) {
   if (wordlist.length !== 2048) {
-    throw new import_errors25.FuelError(
-      import_errors25.ErrorCode.INVALID_WORD_LIST,
+    throw new import_errors26.FuelError(
+      import_errors26.ErrorCode.INVALID_WORD_LIST,
       `Expected word list length of 2048, but got ${wordlist.length}.`
     );
   }
@@ -12036,8 +12370,8 @@ function assertWordList(wordlist) {
 __name(assertWordList, "assertWordList");
 function assertEntropy(entropy) {
   if (entropy.length % 4 !== 0 || entropy.length < 16 || entropy.length > 32) {
-    throw new import_errors25.FuelError(
-      import_errors25.ErrorCode.INVALID_ENTROPY,
+    throw new import_errors26.FuelError(
+      import_errors26.ErrorCode.INVALID_ENTROPY,
       `Entropy should be between 16 and 32 bytes and a multiple of 4, but got ${entropy.length} bytes.`
     );
   }
@@ -12048,7 +12382,7 @@ function assertMnemonic(words) {
     const errorMsg = `Invalid mnemonic size. Expected one of [${MNEMONIC_SIZES.join(
       ", "
     )}] words, but got ${words.length}.`;
-    throw new import_errors25.FuelError(import_errors25.ErrorCode.INVALID_MNEMONIC, errorMsg);
+    throw new import_errors26.FuelError(import_errors26.ErrorCode.INVALID_MNEMONIC, errorMsg);
   }
 }
 __name(assertMnemonic, "assertMnemonic");
@@ -12170,8 +12504,8 @@ var Mnemonic = class _Mnemonic {
   static masterKeysFromSeed(seed) {
     const seedArray = (0, import_utils42.arrayify)(seed);
     if (seedArray.length < 16 || seedArray.length > 64) {
-      throw new import_errors25.FuelError(
-        import_errors25.ErrorCode.INVALID_SEED,
+      throw new import_errors26.FuelError(
+        import_errors26.ErrorCode.INVALID_SEED,
         `Seed length should be between 16 and 64 bytes, but received ${seedArray.length} bytes.`
       );
     }
@@ -12252,7 +12586,7 @@ __name(isValidExtendedKey, "isValidExtendedKey");
 function parsePath(path, depth = 0) {
   const components = path.split("/");
   if (components.length === 0 || components[0] === "m" && depth !== 0) {
-    throw new import_errors26.FuelError(import_errors26.ErrorCode.HD_WALLET_ERROR, `invalid path - ${path}`);
+    throw new import_errors27.FuelError(import_errors27.ErrorCode.HD_WALLET_ERROR, `invalid path - ${path}`);
   }
   if (components[0] === "m") {
     components.shift();
@@ -12285,8 +12619,8 @@ var HDWallet = class _HDWallet {
       this.privateKey = (0, import_utils44.hexlify)(config.privateKey);
     } else {
       if (!config.publicKey) {
-        throw new import_errors26.FuelError(
-          import_errors26.ErrorCode.HD_WALLET_ERROR,
+        throw new import_errors27.FuelError(
+          import_errors27.ErrorCode.HD_WALLET_ERROR,
           "Both public and private Key cannot be missing. At least one should be provided."
         );
       }
@@ -12315,8 +12649,8 @@ var HDWallet = class _HDWallet {
     const data = new Uint8Array(37);
     if (index & HARDENED_INDEX) {
       if (!privateKey) {
-        throw new import_errors26.FuelError(
-          import_errors26.ErrorCode.HD_WALLET_ERROR,
+        throw new import_errors27.FuelError(
+          import_errors27.ErrorCode.HD_WALLET_ERROR,
           "Cannot derive a hardened index without a private Key."
         );
       }
@@ -12324,13 +12658,13 @@ var HDWallet = class _HDWallet {
     } else {
       data.set((0, import_utils44.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_utils44.arrayify)((0, import_crypto6.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,
@@ -12368,15 +12702,15 @@ var HDWallet = class _HDWallet {
    */
   toExtendedKey(isPublic = false, testnet = false) {
     if (this.depth >= 256) {
-      throw new import_errors26.FuelError(
-        import_errors26.ErrorCode.HD_WALLET_ERROR,
+      throw new import_errors27.FuelError(
+        import_errors27.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_utils44.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_utils44.concat)(["0x00", this.privateKey]) : this.publicKey;
     const extendedKey = (0, import_utils44.arrayify)((0, import_utils44.concat)([prefix, depth, parentFingerprint, index, chainCode, key]));
@@ -12396,14 +12730,14 @@ var HDWallet = class _HDWallet {
     });
   }
   static fromExtendedKey(extendedKey) {
-    const decoded = (0, import_utils44.hexlify)((0, import_math24.toBytes)((0, import_utils44.decodeBase58)(extendedKey)));
+    const decoded = (0, import_utils44.hexlify)((0, import_math25.toBytes)((0, import_utils44.decodeBase58)(extendedKey)));
     const bytes = (0, import_utils44.arrayify)(decoded);
     const validChecksum = base58check(bytes.slice(0, 78)) === extendedKey;
     if (bytes.length !== 82 || !isValidExtendedKey(bytes)) {
-      throw new import_errors26.FuelError(import_errors26.ErrorCode.HD_WALLET_ERROR, "Provided key is not a valid extended key.");
+      throw new import_errors27.FuelError(import_errors27.ErrorCode.HD_WALLET_ERROR, "Provided key is not a valid extended key.");
     }
     if (!validChecksum) {
-      throw new import_errors26.FuelError(import_errors26.ErrorCode.HD_WALLET_ERROR, "Provided key has an invalid checksum.");
+      throw new import_errors27.FuelError(import_errors27.ErrorCode.HD_WALLET_ERROR, "Provided key has an invalid checksum.");
     }
     const depth = bytes[4];
     const parentFingerprint = (0, import_utils44.hexlify)(bytes.slice(5, 9));
@@ -12411,14 +12745,14 @@ var HDWallet = class _HDWallet {
     const chainCode = (0, import_utils44.hexlify)(bytes.slice(13, 45));
     const key = bytes.slice(45, 78);
     if (depth === 0 && parentFingerprint !== "0x00000000" || depth === 0 && index !== 0) {
-      throw new import_errors26.FuelError(
-        import_errors26.ErrorCode.HD_WALLET_ERROR,
+      throw new import_errors27.FuelError(
+        import_errors27.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_errors26.FuelError(import_errors26.ErrorCode.HD_WALLET_ERROR, "Invalid public extended key.");
+        throw new import_errors27.FuelError(import_errors27.ErrorCode.HD_WALLET_ERROR, "Invalid public extended key.");
       }
       return new _HDWallet({
         publicKey: key,
@@ -12429,7 +12763,7 @@ var HDWallet = class _HDWallet {
       });
     }
     if (key[0] !== 0) {
-      throw new import_errors26.FuelError(import_errors26.ErrorCode.HD_WALLET_ERROR, "Invalid private extended key.");
+      throw new import_errors27.FuelError(import_errors27.ErrorCode.HD_WALLET_ERROR, "Invalid private extended key.");
     }
     return new _HDWallet({
       privateKey: key.slice(1),
@@ -12604,9 +12938,9 @@ var Wallet = class {
 };
 
 // src/wallet-manager/wallet-manager.ts
-var import_address10 = require("@fuel-ts/address");
+var import_address11 = require("@fuel-ts/address");
 var import_crypto7 = require("@fuel-ts/crypto");
-var import_errors29 = require("@fuel-ts/errors");
+var import_errors30 = require("@fuel-ts/errors");
 var import_events = require("events");
 
 // src/wallet-manager/storages/memory-storage.ts
@@ -12631,8 +12965,8 @@ var MemoryStorage = class {
 };
 
 // src/wallet-manager/vaults/mnemonic-vault.ts
-var import_address8 = require("@fuel-ts/address");
-var import_errors27 = require("@fuel-ts/errors");
+var import_address9 = require("@fuel-ts/address");
+var import_errors28 = require("@fuel-ts/errors");
 var MnemonicVault = class {
   static {
     __name(this, "MnemonicVault");
@@ -12683,7 +13017,7 @@ var MnemonicVault = class {
   }
   exportAccount(address) {
     let numberOfAccounts = 0;
-    const ownerAddress = new import_address8.Address(address);
+    const ownerAddress = new import_address9.Address(address);
     do {
       const wallet = Wallet.fromMnemonic(this.#secret, this.getDerivePath(numberOfAccounts));
       if (wallet.address.equals(ownerAddress)) {
@@ -12691,8 +13025,8 @@ var MnemonicVault = class {
       }
       numberOfAccounts += 1;
     } while (numberOfAccounts < this.numberOfAccounts);
-    throw new import_errors27.FuelError(
-      import_errors27.ErrorCode.WALLET_MANAGER_ERROR,
+    throw new import_errors28.FuelError(
+      import_errors28.ErrorCode.WALLET_MANAGER_ERROR,
       `Account with address '${address}' not found in derived wallets.`
     );
   }
@@ -12703,8 +13037,8 @@ var MnemonicVault = class {
 };
 
 // src/wallet-manager/vaults/privatekey-vault.ts
-var import_address9 = require("@fuel-ts/address");
-var import_errors28 = require("@fuel-ts/errors");
+var import_address10 = require("@fuel-ts/address");
+var import_errors29 = require("@fuel-ts/errors");
 var PrivateKeyVault = class {
   static {
     __name(this, "PrivateKeyVault");
@@ -12743,13 +13077,13 @@ var PrivateKeyVault = class {
     return this.getPublicAccount(wallet.privateKey);
   }
   exportAccount(address) {
-    const ownerAddress = new import_address9.Address(address);
+    const ownerAddress = new import_address10.Address(address);
     const privateKey = this.#privateKeys.find(
       (pk) => Wallet.fromPrivateKey(pk).address.equals(ownerAddress)
     );
     if (!privateKey) {
-      throw new import_errors28.FuelError(
-        import_errors28.ErrorCode.WALLET_MANAGER_ERROR,
+      throw new import_errors29.FuelError(
+        import_errors29.ErrorCode.WALLET_MANAGER_ERROR,
         `No private key found for address '${address}'.`
       );
     }
@@ -12771,7 +13105,7 @@ var ERROR_MESSAGES = {
 };
 function assert(condition, message) {
   if (!condition) {
-    throw new import_errors29.FuelError(import_errors29.ErrorCode.WALLET_MANAGER_ERROR, message);
+    throw new import_errors30.FuelError(import_errors30.ErrorCode.WALLET_MANAGER_ERROR, message);
   }
 }
 __name(assert, "assert");
@@ -12840,7 +13174,7 @@ var WalletManager = class _WalletManager extends import_events.EventEmitter {
    * Create a Wallet instance for the specific account
    */
   getWallet(address) {
-    const ownerAddress = new import_address10.Address(address);
+    const ownerAddress = new import_address11.Address(address);
     const vaultState = this.#vaults.find(
       (vs) => vs.vault.getAccounts().find((a) => a.address.equals(ownerAddress))
     );
@@ -12851,7 +13185,7 @@ var WalletManager = class _WalletManager extends import_events.EventEmitter {
    * Export specific account privateKey
    */
   exportPrivateKey(address) {
-    const ownerAddress = new import_address10.Address(address);
+    const ownerAddress = new import_address11.Address(address);
     assert(!this.#isLocked, ERROR_MESSAGES.wallet_not_unlocked);
     const vaultState = this.#vaults.find(
       (vs) => vs.vault.getAccounts().find((a) => a.address.equals(ownerAddress))
@@ -12992,29 +13326,29 @@ var WalletManager = class _WalletManager extends import_events.EventEmitter {
 };
 
 // src/wallet-manager/types.ts
-var import_errors30 = require("@fuel-ts/errors");
+var import_errors31 = require("@fuel-ts/errors");
 var Vault = class {
   static {
     __name(this, "Vault");
   }
   static type;
   constructor(_options) {
-    throw new import_errors30.FuelError(import_errors30.ErrorCode.NOT_IMPLEMENTED, "Not implemented.");
+    throw new import_errors31.FuelError(import_errors31.ErrorCode.NOT_IMPLEMENTED, "Not implemented.");
   }
   serialize() {
-    throw new import_errors30.FuelError(import_errors30.ErrorCode.NOT_IMPLEMENTED, "Not implemented.");
+    throw new import_errors31.FuelError(import_errors31.ErrorCode.NOT_IMPLEMENTED, "Not implemented.");
   }
   getAccounts() {
-    throw new import_errors30.FuelError(import_errors30.ErrorCode.NOT_IMPLEMENTED, "Not implemented.");
+    throw new import_errors31.FuelError(import_errors31.ErrorCode.NOT_IMPLEMENTED, "Not implemented.");
   }
   addAccount() {
-    throw new import_errors30.FuelError(import_errors30.ErrorCode.NOT_IMPLEMENTED, "Not implemented.");
+    throw new import_errors31.FuelError(import_errors31.ErrorCode.NOT_IMPLEMENTED, "Not implemented.");
   }
   exportAccount(_address) {
-    throw new import_errors30.FuelError(import_errors30.ErrorCode.NOT_IMPLEMENTED, "Not implemented.");
+    throw new import_errors31.FuelError(import_errors31.ErrorCode.NOT_IMPLEMENTED, "Not implemented.");
   }
   getWallet(_address) {
-    throw new import_errors30.FuelError(import_errors30.ErrorCode.NOT_IMPLEMENTED, "Not implemented.");
+    throw new import_errors31.FuelError(import_errors31.ErrorCode.NOT_IMPLEMENTED, "Not implemented.");
   }
 };
 var StorageAbstract = class {
@@ -13025,12 +13359,12 @@ var StorageAbstract = class {
 
 // src/predicate/predicate.ts
 var import_abi_coder11 = require("@fuel-ts/abi-coder");
-var import_address11 = require("@fuel-ts/address");
-var import_errors32 = require("@fuel-ts/errors");
+var import_address12 = require("@fuel-ts/address");
+var import_errors33 = require("@fuel-ts/errors");
 var import_utils48 = require("@fuel-ts/utils");
 
 // src/utils/deployScriptOrPredicate.ts
-var import_errors31 = require("@fuel-ts/errors");
+var import_errors32 = require("@fuel-ts/errors");
 var import_utils46 = require("@fuel-ts/utils");
 
 // src/utils/predicate-script-loader-instructions.ts
@@ -13237,7 +13571,7 @@ async function deployScriptOrPredicate({
         throw new Error();
       }
     } catch (err) {
-      throw new import_errors31.FuelError(import_errors31.ErrorCode.TRANSACTION_FAILED, "Failed to deploy predicate chunk");
+      throw new import_errors32.FuelError(import_errors32.ErrorCode.TRANSACTION_FAILED, "Failed to deploy predicate chunk");
     }
     return loaderInstance;
   }, "waitForResult");
@@ -13292,7 +13626,7 @@ var Predicate = class _Predicate extends Account {
       abi,
       configurableConstants
     );
-    const address = new import_address11.Address(getPredicateRoot(predicateBytes));
+    const address = new import_address12.Address(getPredicateRoot(predicateBytes));
     super(address, provider);
     this.initialBytecode = (0, import_utils48.arrayify)(bytecode);
     this.bytes = predicateBytes;
@@ -13389,8 +13723,8 @@ var Predicate = class _Predicate extends Account {
     let predicateBytes = (0, import_utils48.arrayify)(bytes);
     const abiInterface = new import_abi_coder11.Interface(jsonAbi);
     if (abiInterface.functions.main === void 0) {
-      throw new import_errors32.FuelError(
-        import_errors32.ErrorCode.ABI_MAIN_METHOD_MISSING,
+      throw new import_errors33.FuelError(
+        import_errors33.ErrorCode.ABI_MAIN_METHOD_MISSING,
         'Cannot use ABI without "main" function.'
       );
     }
@@ -13450,15 +13784,15 @@ var Predicate = class _Predicate extends Account {
     const mutatedBytes = bytes;
     try {
       if (Object.keys(abiInterface.configurables).length === 0) {
-        throw new import_errors32.FuelError(
-          import_errors32.ErrorCode.INVALID_CONFIGURABLE_CONSTANTS,
+        throw new import_errors33.FuelError(
+          import_errors33.ErrorCode.INVALID_CONFIGURABLE_CONSTANTS,
           "Predicate has no configurable constants to be set"
         );
       }
       Object.entries(configurableConstants).forEach(([key, value]) => {
         if (!abiInterface?.configurables[key]) {
-          throw new import_errors32.FuelError(
-            import_errors32.ErrorCode.CONFIGURABLE_NOT_FOUND,
+          throw new import_errors33.FuelError(
+            import_errors33.ErrorCode.CONFIGURABLE_NOT_FOUND,
             `No configurable constant named '${key}' found in the Predicate`
           );
         }
@@ -13467,8 +13801,8 @@ var Predicate = class _Predicate extends Account {
         mutatedBytes.set(encoded, offset);
       });
     } catch (err) {
-      throw new import_errors32.FuelError(
-        import_errors32.ErrorCode.INVALID_CONFIGURABLE_CONSTANTS,
+      throw new import_errors33.FuelError(
+        import_errors33.ErrorCode.INVALID_CONFIGURABLE_CONSTANTS,
         `Error setting configurable constants: ${err.message}.`
       );
     }
@@ -13521,10 +13855,10 @@ var Predicate = class _Predicate extends Account {
 };
 
 // src/connectors/fuel.ts
-var import_errors35 = require("@fuel-ts/errors");
+var import_errors36 = require("@fuel-ts/errors");
 
 // src/connectors/fuel-connector.ts
-var import_errors33 = require("@fuel-ts/errors");
+var import_errors34 = require("@fuel-ts/errors");
 var import_events2 = require("events");
 
 // src/connectors/types/connector-types.ts
@@ -13549,6 +13883,7 @@ var FuelConnectorMethods = /* @__PURE__ */ ((FuelConnectorMethods2) => {
   FuelConnectorMethods2["addABI"] = "addABI";
   FuelConnectorMethods2["getABI"] = "getABI";
   FuelConnectorMethods2["hasABI"] = "hasABI";
+  FuelConnectorMethods2["startConsolidation"] = "startConsolidation";
   return FuelConnectorMethods2;
 })(FuelConnectorMethods || {});
 var FuelConnectorEventTypes = /* @__PURE__ */ ((FuelConnectorEventTypes2) => {
@@ -13561,6 +13896,7 @@ var FuelConnectorEventTypes = /* @__PURE__ */ ((FuelConnectorEventTypes2) => {
   FuelConnectorEventTypes2["currentNetwork"] = "currentNetwork";
   FuelConnectorEventTypes2["assets"] = "assets";
   FuelConnectorEventTypes2["abis"] = "abis";
+  FuelConnectorEventTypes2["consolidateCoins"] = "consolidateCoins";
   return FuelConnectorEventTypes2;
 })(FuelConnectorEventTypes || {});
 var FuelConnectorEventType = "FuelConnector";
@@ -13606,7 +13942,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns Always true.
    */
   async ping() {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should return the current version of the connector
@@ -13615,7 +13951,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns boolean - connection status.
    */
   async version() {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should return true if the connector is connected
@@ -13624,7 +13960,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns The connection status.
    */
   async isConnected() {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should return all the accounts authorized for the
@@ -13633,7 +13969,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns The accounts addresses strings
    */
   async accounts() {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should start the connection process and return
@@ -13645,7 +13981,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns boolean - connection status.
    */
   async connect() {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should disconnect the current connection and
@@ -13655,7 +13991,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns The connection status.
    */
   async disconnect() {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should start the sign message process and return
@@ -13667,7 +14003,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns Message signature
    */
   async signMessage(_address, _message) {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should start the sign transaction process and return
@@ -13679,7 +14015,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns Transaction signature
    */
   async signTransaction(_address, _transaction, _params) {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should start the send transaction process and return
@@ -13695,7 +14031,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns The transaction id or transaction response
    */
   async sendTransaction(_address, _transaction, _params) {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should return the current account selected inside the connector, if the account
@@ -13706,7 +14042,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns The current account selected otherwise null.
    */
   async currentAccount() {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should add the assets metadata to the connector and return true if the asset
@@ -13720,7 +14056,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns True if the asset was added successfully
    */
   async addAssets(_assets) {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should add the asset metadata to the connector and return true if the asset
@@ -13734,7 +14070,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns True if the asset was added successfully
    */
   async addAsset(_asset) {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should return all the assets added to the connector. If a connection is already established.
@@ -13742,7 +14078,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns Array of assets metadata from the connector vinculated to the all accounts from a specific Wallet.
    */
   async assets() {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should start the add network process and return true if the network was added successfully.
@@ -13753,7 +14089,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns Return true if the network was added successfully
    */
   async addNetwork(_networkUrl) {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should start the select network process and return true if the network has change successfully.
@@ -13764,7 +14100,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns Return true if the network was added successfully
    */
   async selectNetwork(_network) {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should return all the networks available from the connector. If the connection is already established.
@@ -13772,7 +14108,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns Return all the networks added to the connector.
    */
   async networks() {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should return the current network selected inside the connector. Even if the connection is not established.
@@ -13780,7 +14116,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns Return the current network selected inside the connector.
    */
   async currentNetwork() {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should add the ABI to the connector and return true if the ABI was added successfully.
@@ -13790,7 +14126,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns Return true if the ABI was added successfully.
    */
   async addABI(_contractId, _abi) {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should return the ABI from the connector vinculated to the all accounts from a specific Wallet.
@@ -13799,7 +14135,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns The ABI if it exists, otherwise return null.
    */
   async getABI(_id) {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Should return true if the abi exists in the connector vinculated to the all accounts from a specific Wallet.
@@ -13808,7 +14144,16 @@ var FuelConnector = class extends import_events2.EventEmitter {
    * @returns Returns true if the abi exists or false if not.
    */
   async hasABI(_id) {
-    throw new import_errors33.FuelError(import_errors33.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
+  }
+  /**
+   * Start the consolidation of coins process
+   *
+   * @param owner - The B256 address of the owner.
+   * @param assetId - The asset ID that requires consolidation.
+   */
+  async startConsolidation(_opts) {
+    throw new import_errors34.FuelError(import_errors34.FuelError.CODES.NOT_IMPLEMENTED, "Method not implemented.");
   }
   /**
    * Event listener for the connector.
@@ -13854,7 +14199,7 @@ function dispatchFuelConnectorEvent(connector) {
 __name(dispatchFuelConnectorEvent, "dispatchFuelConnectorEvent");
 
 // src/connectors/utils/promises.ts
-var import_errors34 = require("@fuel-ts/errors");
+var import_errors35 = require("@fuel-ts/errors");
 function deferPromise() {
   const defer = {};
   defer.promise = new Promise((resolve, reject) => {
@@ -13867,7 +14212,7 @@ __name(deferPromise, "deferPromise");
 async function withTimeout(promise, timeout = 1050) {
   const timeoutPromise = new Promise((resolve, reject) => {
     setTimeout(() => {
-      reject(new import_errors34.FuelError(import_errors34.FuelError.CODES.TIMEOUT_EXCEEDED, "Promise timed out"));
+      reject(new import_errors35.FuelError(import_errors35.FuelError.CODES.TIMEOUT_EXCEEDED, "Promise timed out"));
     }, timeout);
   });
   return Promise.race([timeoutPromise, promise]);
@@ -13908,7 +14253,7 @@ var Fuel = class _Fuel extends FuelConnector {
       this._targetUnsubscribe = this.setupConnectorListener();
       await connectResponse;
     } catch (error) {
-      throw new import_errors35.FuelError(import_errors35.ErrorCode.INVALID_PROVIDER, "Error initializing Fuel Connector");
+      throw new import_errors36.FuelError(import_errors36.ErrorCode.INVALID_PROVIDER, "Error initializing Fuel Connector");
     }
   }
   async init() {
@@ -13974,8 +14319,8 @@ var Fuel = class _Fuel extends FuelConnector {
     const hasConnector = await this.hasConnector();
     await this.pingConnector();
     if (!this._currentConnector || !hasConnector) {
-      throw new import_errors35.FuelError(
-        import_errors35.ErrorCode.MISSING_CONNECTOR,
+      throw new import_errors36.FuelError(
+        import_errors36.ErrorCode.MISSING_CONNECTOR,
         `No connector selected for calling ${method}. Use hasConnector before executing other methods.`
       );
     }
@@ -14039,7 +14384,7 @@ var Fuel = class _Fuel extends FuelConnector {
         cacheTime: PING_CACHE_TIME
       })();
     } catch {
-      throw new import_errors35.FuelError(import_errors35.ErrorCode.INVALID_PROVIDER, "Current connector is not available.");
+      throw new import_errors36.FuelError(import_errors36.ErrorCode.INVALID_PROVIDER, "Current connector is not available.");
     }
   }
   /**
@@ -14188,7 +14533,7 @@ var Fuel = class _Fuel extends FuelConnector {
       const currentNetwork = await this.currentNetwork();
       provider = new Provider(currentNetwork.url);
     } else {
-      throw new import_errors35.FuelError(import_errors35.ErrorCode.INVALID_PROVIDER, "Provider is not valid.");
+      throw new import_errors36.FuelError(import_errors36.ErrorCode.INVALID_PROVIDER, "Provider is not valid.");
     }
     return provider;
   }
@@ -14299,6 +14644,8 @@ var Fuel = class _Fuel extends FuelConnector {
   calculateMinGasForTxUpload,
   calculateTXFeeForSummary,
   coinQuantityfy,
+  consolidateCoins,
+  consolidateCoinsIfRequired,
   deferPromise,
   deployScriptOrPredicate,
   deserializeChain,
@@ -14317,6 +14664,7 @@ var Fuel = class _Fuel extends FuelConnector {
   extractTxError,
   fuelAssetsBaseUrl,
   gasUsedByInputs,
+  getAllCoins,
   getAllDecodedLogs,
   getAssetAmountInRequestInputs,
   getAssetById,