@fuel-ts/account 0.101.2 → 0.101.3

package/dist/test-utils.global.js

@@ -17289,7 +17289,7 @@
     return {
       FUEL_CORE: "0.43.1",
       FORC: "0.68.7",
-      FUELS: "0.101.2"
+      FUELS: "0.101.3"
     };
   }
   __name(getBuiltinVersions, "getBuiltinVersions");
@@ -17402,6 +17402,7 @@ This unreleased fuel-core build may include features and updates not yet support
     ErrorCode2["CONNECTION_REFUSED"] = "connection-refused";
     ErrorCode2["INVALID_URL"] = "invalid-url";
     ErrorCode2["UNSUPPORTED_FEATURE"] = "unsupported-feature";
+    ErrorCode2["RESPONSE_BODY_EMPTY"] = "response-body-empty";
     ErrorCode2["INVALID_PUBLIC_KEY"] = "invalid-public-key";
     ErrorCode2["WALLET_MANAGER_ERROR"] = "wallet-manager-error";
     ErrorCode2["HD_WALLET_ERROR"] = "hd-wallet-error";
@@ -17420,6 +17421,8 @@ This unreleased fuel-core build may include features and updates not yet support
     ErrorCode2["INVALID_REQUEST"] = "invalid-request";
     ErrorCode2["INVALID_TRANSFER_AMOUNT"] = "invalid-transfer-amount";
     ErrorCode2["INSUFFICIENT_FUNDS_OR_MAX_COINS"] = "not-enough-funds-or-max-coins-reached";
+    ErrorCode2["INSUFFICIENT_FUNDS"] = "not-enough-funds";
+    ErrorCode2["MAX_COINS_REACHED"] = "max-coins-reached";
     ErrorCode2["INVALID_CREDENTIALS"] = "invalid-credentials";
     ErrorCode2["HASHER_LOCKED"] = "hasher-locked";
     ErrorCode2["GAS_PRICE_TOO_LOW"] = "gas-price-too-low";
@@ -17453,6 +17456,7 @@ This unreleased fuel-core build may include features and updates not yet support
     ErrorCode2["INVALID_PASSWORD"] = "invalid-password";
     ErrorCode2["ACCOUNT_REQUIRED"] = "account-required";
     ErrorCode2["UNLOCKED_WALLET_REQUIRED"] = "unlocked-wallet-required";
+    ErrorCode2["UNABLE_TO_CONSOLIDATE_COINS"] = "unable-to-consolidate-coins";
     ErrorCode2["NO_COINS_TO_CONSOLIDATE"] = "no-coins-to-consolidate";
     ErrorCode2["COINS_ASSET_ID_MISMATCH"] = "coins-asset-id-mismatch";
     ErrorCode2["ASSET_NOT_FOUND"] = "asset-not-found";
@@ -17494,7 +17498,7 @@ This unreleased fuel-core build may include features and updates not yet support
           `Unknown error code: ${error2.code}. Accepted codes: ${enumValues.join(", ")}.`
         );
       }
-      return new _FuelError(error2.code, error2.message);
+      return new _FuelError(error2.code, error2.message, error2.metadata, error2.rawError);
     }
     code;
     constructor(code, message, metadata = {}, rawError = null) {
@@ -23343,8 +23347,9 @@ If you are attempting to transform a hex value, please make sure it is being pas
         "--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;
@@ -23568,6 +23573,11 @@ If you are attempting to transform a hex value, please make sure it is being pas
   }
   __name(_curry3, "_curry3");
 
+  // ../../node_modules/.pnpm/ramda@0.30.1/node_modules/ramda/es/internal/_isArray.js
+  var isArray_default = Array.isArray || /* @__PURE__ */ __name(function _isArray(val) {
+    return val != null && val.length >= 0 && Object.prototype.toString.call(val) === "[object Array]";
+  }, "_isArray");
+
   // ../../node_modules/.pnpm/ramda@0.30.1/node_modules/ramda/es/internal/_has.js
   function _has(prop, obj) {
     return Object.prototype.hasOwnProperty.call(obj, prop);
@@ -23698,6 +23708,25 @@ If you are attempting to transform a hex value, please make sure it is being pas
   }, "clone"));
   var clone_default = clone;
 
+  // ../../node_modules/.pnpm/ramda@0.30.1/node_modules/ramda/es/internal/_checkForMethod.js
+  function _checkForMethod(methodname, fn) {
+    return function() {
+      var length = arguments.length;
+      if (length === 0) {
+        return fn();
+      }
+      var obj = arguments[length - 1];
+      return isArray_default(obj) || typeof obj[methodname] !== "function" ? fn.apply(this, arguments) : obj[methodname].apply(obj, Array.prototype.slice.call(arguments, 0, length - 1));
+    };
+  }
+  __name(_checkForMethod, "_checkForMethod");
+
+  // ../../node_modules/.pnpm/ramda@0.30.1/node_modules/ramda/es/slice.js
+  var slice = /* @__PURE__ */ _curry3(/* @__PURE__ */ _checkForMethod("slice", /* @__PURE__ */ __name(function slice2(fromIndex, toIndex, list) {
+    return Array.prototype.slice.call(list, fromIndex, toIndex);
+  }, "slice")));
+  var slice_default = slice;
+
   // ../../node_modules/.pnpm/ramda@0.30.1/node_modules/ramda/es/mergeWithKey.js
   var mergeWithKey = /* @__PURE__ */ _curry3(/* @__PURE__ */ __name(function mergeWithKey2(fn, l, r) {
     var result = {};
@@ -23738,6 +23767,20 @@ If you are attempting to transform a hex value, please make sure it is being pas
   }, "mergeDeepRight"));
   var mergeDeepRight_default = mergeDeepRight;
 
+  // ../../node_modules/.pnpm/ramda@0.30.1/node_modules/ramda/es/splitEvery.js
+  var splitEvery = /* @__PURE__ */ _curry2(/* @__PURE__ */ __name(function splitEvery2(n, list) {
+    if (n <= 0) {
+      throw new Error("First argument to splitEvery must be a positive integer");
+    }
+    var result = [];
+    var idx = 0;
+    while (idx < list.length) {
+      result.push(slice_default(idx, idx += n, list));
+    }
+    return result;
+  }, "splitEvery"));
+  var splitEvery_default = splitEvery;
+
   // src/providers/coin-quantity.ts
   var coinQuantityfy = /* @__PURE__ */ __name((coinQuantityLike) => {
     let assetId;
@@ -30394,8 +30437,11 @@ ${DryRunSuccessAssembleTxFragmentDoc}`;
   }, "setAndValidateGasAndFeeForAssembledTx");
 
   // src/providers/utils/handle-gql-error-message.ts
+  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/,
@@ -30411,6 +30457,46 @@ ${DryRunSuccessAssembleTxFragmentDoc}`;
         error2
       );
     }
+    if (gqlErrorMessage.MAX_COINS_REACHED.test(error2.message)) {
+      const matches = error2.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 FuelError(
+        ErrorCode.MAX_COINS_REACHED,
+        `You have too many small value coins - consider combining UTXOs.${suffix}`,
+        { assetId, owner },
+        error2
+      );
+    }
+    if (gqlErrorMessage.INSUFFICIENT_FUNDS.test(error2.message)) {
+      const matches = error2.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 FuelError(
+        ErrorCode.INSUFFICIENT_FUNDS,
+        `Insufficient funds.${suffix}`,
+        { assetId, owner },
+        error2
+      );
+    }
     if (gqlErrorMessage.MULTIPLE_CHANGE_POLICIES.test(error2.message)) {
       const match = error2.message.match(/asset ([a-fA-F0-9]{64})/);
       const assetId = match?.[1] || "";
@@ -31539,6 +31625,7 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
     }
     return new FuelError(ErrorCode.SCRIPT_REVERTED, errorMessage, {
       ...metadata,
+      abiError,
       reason
     });
   }
@@ -32529,11 +32616,15 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
      * @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;
     }
     /**
@@ -34053,25 +34144,6 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
 
   // 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");
     }
@@ -34086,9 +34158,42 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
     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
@@ -34598,7 +34703,15 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
         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 FuelError(
+            ErrorCode.RESPONSE_BODY_EMPTY,
+            "The response from the server is missing the body",
+            { timestamp: (/* @__PURE__ */ new Date()).toISOString(), request, response }
+          );
+        }
+        return response;
       }, retryOptions);
     }
     static applyBlockHeight(request, url) {
@@ -34621,13 +34734,15 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
         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);
@@ -35050,7 +35165,13 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
         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.
@@ -36145,7 +36266,11 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
      */
     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.
@@ -36308,6 +36433,149 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
     }
   };
 
+  // src/utils/consolidate-coins.ts
+  var CONSOLIDATABLE_ERROR_CODES = [ErrorCode.MAX_COINS_REACHED];
+  var consolidateCoinsIfRequired = /* @__PURE__ */ __name(async (opts) => {
+    const { error: errorUnknown, account, skipAutoConsolidation = false } = opts;
+    if (skipAutoConsolidation) {
+      return false;
+    }
+    const error2 = FuelError.parse(errorUnknown);
+    if (CONSOLIDATABLE_ERROR_CODES.includes(error2.code)) {
+      const { assetId, owner } = error2.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 === OutputType.Change && output.assetId === baseAssetId
+    );
+    if (outputChangeIndex === -1) {
+      throw new FuelError(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 Address(outputCoin.to),
+      blockCreated: bn(0),
+      txCreatedIdx: 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 FuelError(
+        ErrorCode.INSUFFICIENT_FUNDS,
+        `Insufficient funds to consolidate.
+	Asset ID: ${baseAssetId}
+	Owner: ${account.address.toB256()}`
+      );
+    }
+    const batches = [
+      ...splitEvery_default(batchSize, funding),
+      // We leave one coin for the funding coin
+      ...splitEvery_default(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 = bn(1e3);
+        opts.onTransactionStart?.({
+          tx: currentTx,
+          step,
+          assetId,
+          transactionId: currentTx.getTransactionId(chainId)
+        });
+        const response = await account.sendTransaction(currentTx);
+        const result = await response.waitForResult();
+        txResponses.push(result);
+        previousTx = {
+          transactionId: response.id,
+          outputs: result.transaction.outputs
+        };
+      }
+      return {
+        txResponses,
+        errors: []
+      };
+    }, "submitAll");
+    return {
+      txs,
+      totalFeeCost: txs.reduce((acc, request) => acc.add(request.maxFee), bn(0)),
+      submitAll
+    };
+  }, "consolidateCoins");
+
   // src/utils/formatTransferToContractScriptData.ts
   var asm = __toESM(require_node());
   var formatTransferToContractScriptData = /* @__PURE__ */ __name((transferParams) => {
@@ -36424,10 +36692,24 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
      *
      * @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 (error2) {
+        const shouldRetry = await consolidateCoinsIfRequired({
+          error: error2,
+          account: this,
+          skipAutoConsolidation
+        });
+        if (!shouldRetry) {
+          throw error2;
+        }
+        return await getResourcesToSpend();
+      }
     }
     /**
      * Retrieves coins owned by the account.
@@ -36476,7 +36758,7 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
      * @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,
@@ -36522,7 +36804,8 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
       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);
@@ -36560,7 +36843,7 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
       }
       if (needsToBeFunded) {
         throw new FuelError(
-          ErrorCode.INSUFFICIENT_FUNDS_OR_MAX_COINS,
+          ErrorCode.INSUFFICIENT_FUNDS,
           `The account ${this.address} does not have enough base asset funds to cover the transaction execution.`
         );
       }
@@ -36588,16 +36871,20 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
      * @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,
@@ -36614,10 +36901,13 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
      * @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 });
     }
     /**
@@ -36625,12 +36915,16 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
      *
      * @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,
@@ -36677,12 +36971,15 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
      * @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
       });
@@ -36709,7 +37006,11 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
       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,
@@ -36725,9 +37026,10 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
      * @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 = {}) {
+    async withdrawToBaseLayer(recipient, amount, txParams = {}, { skipAutoConsolidation } = {}) {
       const recipientAddress = new Address(recipient);
       const recipientDataArray = arrayify(
         "0x".concat(recipientAddress.toHexString().substring(2).padStart(64, "0"))
@@ -36744,7 +37046,11 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
       const baseAssetId = await this.provider.getBaseAssetId();
       let request = new ScriptTransactionRequest(params);
       const quantities = [{ amount: bn(amount), assetId: baseAssetId }];
-      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,
@@ -36754,6 +37060,25 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
       });
       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.
      *
@@ -36773,6 +37098,7 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
       const isBaseAsset = baseAssetId === assetId;
       let submitAll;
       const consolidationParams = {
+        assetId,
         coins,
         mode: params.mode,
         outputNum: params.outputNum
@@ -36780,10 +37106,7 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
       if (isBaseAsset) {
         ({ submitAll } = await this.assembleBaseAssetConsolidationTxs(consolidationParams));
       } else {
-        throw new FuelError(
-          ErrorCode.UNSUPPORTED_FEATURE,
-          "Consolidation for non-base assets is not supported yet."
-        );
+        ({ submitAll } = await this.assembleNonBaseAssetConsolidationTxs(consolidationParams));
       }
       return submitAll();
     }
@@ -36842,6 +37165,70 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
       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 = bn(0);
+      const txs = [];
+      const gasPrice = await this.provider.estimateGasPrice(10);
+      const consolidateMoreThanOneCoin = outputNum > 1;
+      const assetCoinBatches = splitCoinsIntoBatches(coins, maxInputsNumber);
+      assetCoinBatches.filter((batch) => batch.length > 1).forEach((coinBatch) => {
+        const request = new ScriptTransactionRequest({
+          script: "0x"
+        });
+        request.addResources(coinBatch);
+        if (consolidateMoreThanOneCoin) {
+          Array.from({ length: outputNum - 1 }).forEach(() => {
+            request.addCoinOutput(this.address, 0, assetId);
+          });
+        }
+        const minGas = request.calculateMinGas(chainInfo);
+        const fee = calculateGasFee({
+          gasPrice,
+          gas: minGas,
+          priceFactor: chainInfo.consensusParameters.feeParameters.gasPriceFactor,
+          tip: request.tip
+        });
+        request.maxFee = fee;
+        if (consolidateMoreThanOneCoin) {
+          const total = request.inputs.filter(isRequestInputCoin).reduce((acc, input) => acc.add(input.amount), bn(0));
+          const amountPerNewUtxo = total.div(outputNum + 1);
+          request.outputs.forEach((output) => {
+            if (output.type === OutputType.Coin) {
+              output.amount = amountPerNewUtxo;
+            }
+          });
+        }
+        totalFeeCost = totalFeeCost.add(fee);
+        const baseAssetResources = [];
+        let fundingFeeTotal = bn(0);
+        while (fundingFeeTotal.lt(fee)) {
+          const baseAssetCoin = baseAssetCoins.pop();
+          if (!baseAssetCoin) {
+            break;
+          }
+          baseAssetResources.push(baseAssetCoin);
+          fundingFeeTotal = fundingFeeTotal.add(baseAssetCoin.amount);
+        }
+        const { inputs } = request;
+        request.inputs = inputs.slice(0, maxInputsNumber - baseAssetResources.length);
+        const removedCoins = coinBatch.slice(maxInputsNumber - baseAssetResources.length);
+        request.addResources(baseAssetResources);
+        const lastCoinBatch = assetCoinBatches[assetCoinBatches.length - 1];
+        lastCoinBatch.push(...removedCoins);
+        if (lastCoinBatch.length > maxInputsNumber) {
+          assetCoinBatches.push(lastCoinBatch.slice(maxInputsNumber));
+        }
+        txs.push(request);
+      });
+      const submitAll = this.prepareSubmitAll({ txs, mode });
+      return { txs, totalFeeCost, submitAll };
+    }
     /**
      * Prepares a function to submit all transactions either sequentially or in parallel.
      *
@@ -37056,16 +37443,32 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
       } : void 0;
     }
     /** @hidden * */
-    async assembleTx(transactionRequest, quantities = []) {
+    async assembleTx(opts) {
+      const { transactionRequest, quantities = [], skipAutoConsolidation } = opts;
       const outputQuantities = transactionRequest.outputs.filter((o) => o.type === OutputType.Coin).map(({ amount, assetId }) => ({ assetId: String(assetId), amount: bn(amount) }));
       transactionRequest.gasLimit = bn(0);
       transactionRequest.maxFee = bn(0);
-      const { assembledRequest, gasPrice } = await this.provider.assembleTx({
-        request: transactionRequest,
-        accountCoinQuantities: mergeQuantities(outputQuantities, quantities),
-        feePayerAccount: this
-      });
-      return { transactionRequest: assembledRequest, gasPrice };
+      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 (error2) {
+        const shouldRetry = await consolidateCoinsIfRequired({
+          error: error2,
+          account: this,
+          skipAutoConsolidation
+        });
+        if (!shouldRetry) {
+          throw error2;
+        }
+        return await assembleTx();
+      }
     }
     /** @hidden * */
     validateTransferAmount(amount) {
@@ -37077,45 +37480,6 @@ This error originated at ${JSON.stringify(pos, null, 2)}` : "";
       }
     }
     /** @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 (!isDefined(setGasLimit)) {
-        request.gasLimit = gasUsed;
-      } else if (gasUsed.gt(setGasLimit)) {
-        throw new FuelError(
-          ErrorCode.GAS_LIMIT_TOO_LOW,
-          `Gas limit '${setGasLimit}' is lower than the required: '${gasUsed}'.`
-        );
-      }
-      if (!isDefined(setMaxFee)) {
-        request.maxFee = maxFee;
-      } else if (maxFee.gt(setMaxFee)) {
-        throw new FuelError(
-          ErrorCode.MAX_FEE_TOO_LOW,
-          `Max fee '${setMaxFee}' is lower than the required: '${maxFee}'.`
-        );
-      }
-      return request;
-    }
-    /** @hidden * */
     validateConsolidationTxsCoins(coins, assetId) {
       if (coins.length <= 1) {
         throw new FuelError(ErrorCode.NO_COINS_TO_CONSOLIDATE, "No coins to consolidate.");