feat: auto consolidation

.changeset/full-carpets-lose.md

@@ -0,0 +1,11 @@
+---
+"@internal/fuel-core": patch
+"@fuel-ts/account": patch
+"@fuel-ts/contract": patch
+"fuels": patch
+"@fuel-ts/program": patch
+"@fuel-ts/utils": patch
+"@fuel-ts/versions": patch
+---
+
+chore: upgrade `fuel-core` to `0.44.0`

.fuel-core/configs/chainConfig.json

@@ -87,6 +87,7 @@
           "mul": 2,
           "muli": 2,
           "mldv": 3,
+          "niop": 2,
           "noop": 1,
           "not": 2,
           "or": 1,

apps/create-fuels-counter-guide/fuel-toolchain.toml

@@ -3,4 +3,4 @@ channel = "testnet"
 
 [components]
 forc = "0.68.7"
-fuel-core = "0.43.1"
+fuel-core = "0.44.0"

apps/demo-bun-fuels/src/bun.test.ts

@@ -72,6 +72,7 @@ describe('ExampleContract', () => {
     } = launched;
 
     const unfundedWallet = Wallet.generate({ provider });
+    const baseAssetId = await provider.getBaseAssetId();
 
     const deploy = await SampleFactory.deploy(fundedWallet);
     const { contract } = await deploy.waitForResult();
@@ -81,8 +82,8 @@ describe('ExampleContract', () => {
     await expectToThrowFuelError(
       () => contractInstance.functions.return_input(1337).simulate(),
       new FuelError(
-        ErrorCode.INSUFFICIENT_FUNDS_OR_MAX_COINS,
-        `Insufficient funds or too many small value coins. Consider combining UTXOs.`
+        ErrorCode.INSUFFICIENT_FUNDS,
+        `Insufficient funds.\n\tAsset ID: '${baseAssetId}'.\n\tOwner: '${unfundedWallet.address.toB256()}'.`
       )
     );
   });

apps/demo-fuels/src/index.test.ts

@@ -65,6 +65,7 @@ describe('ExampleContract', () => {
     } = launched;
 
     const unfundedWallet = Wallet.generate({ provider });
+    const baseAssetId = await provider.getBaseAssetId();
 
     const deploy = await SampleFactory.deploy(fundedWallet);
     const { contract } = await deploy.waitForResult();
@@ -74,8 +75,8 @@ describe('ExampleContract', () => {
     await expectToThrowFuelError(
       () => contractInstance.functions.return_input(1337).simulate(),
       new FuelError(
-        ErrorCode.INSUFFICIENT_FUNDS_OR_MAX_COINS,
-        `Insufficient funds or too many small value coins. Consider combining UTXOs.`
+        ErrorCode.INSUFFICIENT_FUNDS,
+        `Insufficient funds.\n\tAsset ID: '${baseAssetId}'.\n\tOwner: '${unfundedWallet.address.toB256()}'.`
       )
     );
   });

apps/demo-nextjs/package.json

@@ -10,7 +10,7 @@
     "pretest": "pnpm original:build"
   },
   "dependencies": {
-    "@fuels/vm-asm": "0.60.2",
+    "@fuels/vm-asm": "0.62.0",
     "@types/node": "22.13.5",
     "@types/react-dom": "19.0.4",
     "@types/react": "19.0.10",

apps/demo-react-vite/package.json

@@ -11,7 +11,7 @@
     "pretest": "pnpm original:build"
   },
   "dependencies": {
-    "@fuels/vm-asm": "0.60.2",
+    "@fuels/vm-asm": "0.62.0",
     "fuels": "workspace:*",
     "react-dom": "19.0.0",
     "react": "19.0.0"

apps/demo-typegen/src/demo.test.ts

@@ -99,6 +99,7 @@ it('should throw when simulating via contract factory with wallet with no resour
   } = launched;
 
   const unfundedWallet = Wallet.generate({ provider });
+  const baseAssetId = await provider.getBaseAssetId();
 
   const factory = new DemoContractFactory(fundedWallet);
   const { waitForResult } = await factory.deploy();
@@ -108,8 +109,8 @@ it('should throw when simulating via contract factory with wallet with no resour
   await expectToThrowFuelError(
     () => contractInstance.functions.return_input(1337).simulate(),
     new FuelError(
-      ErrorCode.INSUFFICIENT_FUNDS_OR_MAX_COINS,
-      `Insufficient funds or too many small value coins. Consider combining UTXOs.`
+        ErrorCode.INSUFFICIENT_FUNDS,
+        `Insufficient funds.\n\tAsset ID: '${baseAssetId}'.\n\tOwner: '${unfundedWallet.address.toB256()}'.`
     )
   );
 });

apps/docs/src/guide/predicates/snippets/cookbook/failure-not-enough-funds.ts

@@ -16,16 +16,13 @@ const predicate = new SimplePredicate({
 
 // Any amount coins will fail as the predicate is unfunded
 const amountOfCoinsToFail = 1000;
-const { error } = await safeExec(async () =>
-  predicate.transfer(
-    receiver.address,
-    amountOfCoinsToFail,
-    await provider.getBaseAssetId()
-  )
+const baseAssetId = await provider.getBaseAssetId();
+const { error } = await safeExec(() =>
+  predicate.transfer(receiver.address, amountOfCoinsToFail, baseAssetId)
 );
 
 // #region send-and-spend-funds-from-predicates-6
-const errorMessage = `Insufficient funds or too many small value coins. Consider combining UTXOs.`;
+const errorMessage = `Insufficient funds.\n\tAsset ID: '${baseAssetId}'.\n\tOwner: '${predicate.address.toB256()}'.`;
 // #endregion send-and-spend-funds-from-predicates-6
 
 const actualErrorMessage = (<Error>error).message;

internal/fuel-core/VERSION

@@ -1 +1 @@
-0.43.1
+git:ps/fix/max-coins-error

packages/account/package.json

@@ -58,7 +58,7 @@
     "@fuel-ts/transactions": "workspace:*",
     "@fuel-ts/utils": "workspace:*",
     "@fuel-ts/versions": "workspace:*",
-    "@fuels/vm-asm": "0.60.2",
+    "@fuels/vm-asm": "0.62.0",
     "@noble/curves": "1.8.1",
     "events": "3.3.0",
     "graphql": "16.10.0",

packages/account/src/account.test.ts

@@ -602,8 +602,8 @@ describe('Account', () => {
     await expectToThrowFuelError(
       () => user.getResourcesToSpend([[1, ASSET_A]], { utxos: [assetAUTXO.id] }),
       new FuelError(
-        ErrorCode.INSUFFICIENT_FUNDS_OR_MAX_COINS,
-        `Insufficient funds or too many small value coins. Consider combining UTXOs.`
+        ErrorCode.INSUFFICIENT_FUNDS,
+        `Insufficient funds.\n\tAsset ID: '${ASSET_A}'.\n\tOwner: '${user.address.toB256()}'.`
       )
     );
   });
@@ -975,13 +975,43 @@ describe('Account', () => {
       wallets: [wallet],
       provider,
     } = launched;
+    const baseAssetId = await provider.getBaseAssetId();
 
     const request = new ScriptTransactionRequest();
-    request.addCoinOutput(wallet.address, 30_000, await provider.getBaseAssetId());
+    request.addCoinOutput(wallet.address, 30_000, baseAssetId);
 
     await expectToThrowFuelError(() => request.estimateAndFund(wallet), {
-      code: ErrorCode.INSUFFICIENT_FUNDS_OR_MAX_COINS,
-      message: 'Insufficient funds or too many small value coins. Consider combining UTXOs.',
+      code: ErrorCode.MAX_COINS_REACHED,
+      message: `You have too many small value coins - consider combining UTXOs.\n\tAsset ID: '${baseAssetId}'.\n\tOwner: '${wallet.address.toB256()}'.`,
+    });
+  });
+
+  it('throws when funding with more than 255 coins for an input', async () => {
+    using launched = await setupTestProviderAndWallets({
+      walletsConfig: {
+        amountPerCoin: 100,
+        coinsPerAsset: 400,
+      },
+    });
+    const {
+      wallets: [wallet],
+      provider,
+    } = launched;
+    const baseAssetId = await provider.getBaseAssetId();
+
+    const request = new ScriptTransactionRequest();
+    request.addCoinOutput(wallet.address, 30_000, baseAssetId);
+
+    const assembleTx = () =>
+      provider.assembleTx({
+        request,
+        feePayerAccount: wallet,
+        accountCoinQuantities: [{ amount: 30_000, assetId: baseAssetId }],
+      });
+
+    await expectToThrowFuelError(assembleTx, {
+      code: ErrorCode.MAX_COINS_REACHED,
+      message: `You have too many small value coins - consider combining UTXOs.\n\tAsset ID: '${baseAssetId}'.\n\tOwner: '${wallet.address.toB256()}'.`,
     });
   });