chore: upgrade fuel-core to 0.41.0

.changeset/real-schools-poke.md

@@ -0,0 +1,11 @@
+---
+"@fuel-ts/transactions": patch
+"@internal/fuel-core": patch
+"@fuel-ts/versions": patch
+"@fuel-ts/account": patch
+"@fuel-ts/program": patch
+"@fuel-ts/recipes": patch
+"@fuel-ts/errors": patch
+---
+
+chore: upgrade `fuel-core` to `0.41.0`

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

@@ -82,7 +82,7 @@ describe('ExampleContract', () => {
       () => contractInstance.functions.return_input(1337).simulate(),
       new FuelError(
         ErrorCode.NOT_ENOUGH_FUNDS,
-        `The account(s) sending the transaction don't have enough funds to cover the transaction.`
+        `Insufficient funds or too many small value coins. Consider combining UTXOs.`
       )
     );
   });

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

@@ -75,7 +75,7 @@ describe('ExampleContract', () => {
       () => contractInstance.functions.return_input(1337).simulate(),
       new FuelError(
         ErrorCode.NOT_ENOUGH_FUNDS,
-        `The account(s) sending the transaction don't have enough funds to cover the transaction.`
+        `Insufficient funds or too many small value coins. Consider combining UTXOs.`
       )
     );
   });

apps/demo-nextjs/package.json

@@ -10,7 +10,7 @@
     "pretest": "pnpm original:build"
   },
   "dependencies": {
-    "@fuels/vm-asm": "0.58.2",
+    "@fuels/vm-asm": "0.59.1",
     "@types/node": "22.5.5",
     "@types/react-dom": "18.3",
     "@types/react": "18.3.11",

apps/demo-react-cra/package.json

@@ -3,7 +3,7 @@
   "version": "0.1.29",
   "private": true,
   "dependencies": {
-    "@fuels/vm-asm": "0.58.2",
+    "@fuels/vm-asm": "0.59.1",
     "@testing-library/react": "16.0.1",
     "@types/node": "22.5.5",
     "@types/react": "18.3.11",

apps/demo-react-vite/package.json

@@ -11,7 +11,7 @@
     "pretest": "pnpm original:build"
   },
   "dependencies": {
-    "@fuels/vm-asm": "0.58.2",
+    "@fuels/vm-asm": "0.59.1",
     "fuels": "workspace:*",
     "react-dom": "18.3.1",
     "react": "18.3.1"

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

@@ -109,7 +109,7 @@ it('should throw when simulating via contract factory with wallet with no resour
     () => contractInstance.functions.return_input(1337).simulate(),
     new FuelError(
       ErrorCode.NOT_ENOUGH_FUNDS,
-      `The account(s) sending the transaction don't have enough funds to cover the transaction.`
+      `Insufficient funds or too many small value coins. Consider combining UTXOs.`
     )
   );
 });

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

@@ -25,7 +25,7 @@ const { error } = await safeExec(async () =>
 );
 
 // #region send-and-spend-funds-from-predicates-6
-const errorMessage = `The account(s) sending the transaction don't have enough funds to cover the transaction.`;
+const errorMessage = `Insufficient funds or too many small value coins. Consider combining UTXOs.`;
 // #endregion send-and-spend-funds-from-predicates-6
 
 const actualErrorMessage = (<Error>error).message;

apps/docs/src/guide/transactions/adding-parameters.md

@@ -4,7 +4,7 @@ Transaction parameters allow you to configure various aspects of your blockchain
 
 All available parameters are shown below:
 
-<<< @./snippets/transaction-parameters.ts#transaction-parameters-6{ts:line-numbers}
+<<< @./snippets/transaction-parameters.ts#transaction-parameters-7{ts:line-numbers}
 
 ## Gas Limit
 
@@ -38,6 +38,12 @@ The maximum byte length allowed for the transaction witnesses array. For instanc
 
 <<< @./snippets/transaction-parameters.ts#transaction-parameters-5{ts:line-numbers}
 
+## Expiration
+
+The block number after which the transaction can no longer be included in the blockchain. For example, if you set the expiration block for your transaction to 200, and the transaction remains in the queue waiting to be processed when block 200 is created, the transaction will be rejected.
+
+<<< @./snippets/transaction-parameters.ts#transaction-parameters-6{ts:line-numbers}
+
 ## Variable Outputs
 
 The number of variable outputs that should be added to the transaction request. You can read more about it on this [guide](../contracts/variable-outputs.md)
@@ -48,11 +54,11 @@ The number of variable outputs that should be added to the transaction request.
 
 To set the transaction parameters, you have access to the `txParams` method on a transaction request.
 
-<<< @./snippets/transaction-parameters.ts#transaction-parameters-7{ts:line-numbers}
+<<< @./snippets/transaction-parameters.ts#transaction-parameters-8{ts:line-numbers}
 
 The same method is also accessible within a function invocation scope, so it can also be used when calling contract functions.
 
-<<< @./snippets/transaction-parameters.ts#transaction-parameters-8{ts:line-numbers}
+<<< @./snippets/transaction-parameters.ts#transaction-parameters-9{ts:line-numbers}
 
 > **Note:** When performing an action that results in a transaction (e.g. contract deployment, contract call with `.call()`, asset transfer), the SDK will automatically estimate the fee based on the gas limit and the transaction's byte size. This estimation is used when building the transaction. As a side effect, your wallet must own at least one coin of the base asset, regardless of the amount.
 

apps/docs/src/guide/transactions/adding-policies.md

@@ -18,6 +18,10 @@ The number of blocks that must pass before the transaction can be included in a
 
 The maximum amount you're willing to pay for the transaction using the base asset.
 
+### Expiration
+
+Block number after which the transaction can no longer be included in the blockchain.
+
 ## Setting Transaction Policies
 
 The following snippet shows which transaction parameters correspond to which policies:

apps/docs/src/guide/transactions/snippets/transaction-parameters.ts

@@ -13,7 +13,7 @@ const deploy = await CounterFactory.deploy(wallet);
 
 const { contract } = await deploy.waitForResult();
 
-// #region transaction-parameters-6
+// #region transaction-parameters-7
 const txParams: TxParams = {
   // #region transaction-parameters-1
   gasLimit: bn(70935),
@@ -30,17 +30,20 @@ const txParams: TxParams = {
   // #region transaction-parameters-5
   witnessLimit: bn(5000),
   // #endregion transaction-parameters-5
+  // #region transaction-parameters-6
+  expiration: 200,
+  // #endregion transaction-parameters-6
 };
-// #endregion transaction-parameters-6
+// #endregion transaction-parameters-7
 
-// #region transaction-parameters-7
+// #region transaction-parameters-8
 const transactionRequest = new ScriptTransactionRequest({
   script: ScriptSum.bytecode,
   gasLimit: 100,
 });
-// #endregion transaction-parameters-7
+// #endregion transaction-parameters-8
 
-// #region transaction-parameters-8
+// #region transaction-parameters-9
 const { waitForResult } = await contract.functions
   .increment_count(15) //
   .txParams(txParams)
@@ -55,5 +58,5 @@ console.log('Transaction request', transactionRequest);
 console.log('Transaction status', isStatusSuccess);
 console.log('Transaction value', value);
 
-// #endregion transaction-parameters-8
+// #endregion transaction-parameters-9
 // #endregion full

apps/docs/src/guide/transactions/snippets/transaction-policies/policies-from-response.ts

@@ -18,6 +18,7 @@ const transactionRequest = new ScriptTransactionRequest({
   tip: bn(10),
   witnessLimit: 900,
   maxFee: bn(2000),
+  expiration: 200,
 });
 
 // Set the script main function arguments

apps/docs/src/guide/transactions/snippets/transaction-policies/setting-policies.ts

@@ -6,6 +6,7 @@ const transactionRequest = new ScriptTransactionRequest({
   witnessLimit: bn(1), // Sets the witness limit policy
   maturity: 1, // Sets the maturity policy
   maxFee: bn(1), // Sets the max fee policy
+  expiration: 200, // Sets the block after which the transaction cannot be included.
 });
 // #endregion transaction-policies-1
 

internal/fuel-core/VERSION

@@ -1 +1 @@
-0.40.2
+0.41.0

packages/account/codegen.json

@@ -27,7 +27,9 @@
           "U16": "string",
           "U32": "string",
           "U64": "string",
-          "UtxoId": "string"
+          "U128": "string",
+          "UtxoId": "string",
+          "SubId": "string"
         },
         "useTypeImports": true,
         "dedupeOperationSuffix": true,

packages/account/package.json

@@ -58,7 +58,7 @@
     "@fuel-ts/transactions": "workspace:*",
     "@fuel-ts/utils": "workspace:*",
     "@fuel-ts/versions": "workspace:*",
-    "@fuels/vm-asm": "0.58.2",
+    "@fuels/vm-asm": "0.59.1",
     "@noble/curves": "1.6.0",
     "events": "3.3.0",
     "graphql": "16.9.0",

packages/account/src/account.test.ts

@@ -590,7 +590,7 @@ describe('Account', () => {
       () => user.getResourcesToSpend([[1, ASSET_A, 500_000]], { utxos: [assetAUTXO.id] }),
       new FuelError(
         ErrorCode.NOT_ENOUGH_FUNDS,
-        `The account(s) sending the transaction don't have enough funds to cover the transaction.`
+        `Insufficient funds or too many small value coins. Consider combining UTXOs.`
       )
     );
   });
@@ -969,9 +969,8 @@ describe('Account', () => {
     request.addCoinOutput(wallet.address, 30_000, await provider.getBaseAssetId());
 
     await expectToThrowFuelError(() => request.estimateAndFund(wallet), {
-      code: ErrorCode.MAX_COINS_REACHED,
-      message:
-        'The account retrieving coins has exceeded the maximum number of coins per asset. Please consider combining your coins into a single UTXO.',
+      code: ErrorCode.NOT_ENOUGH_FUNDS,
+      message: 'Insufficient funds or too many small value coins. Consider combining UTXOs.',
     });
   });
 

packages/account/src/account.ts

@@ -51,7 +51,7 @@ import { assembleTransferToContractScript } from './utils/formatTransferToContra
 
 export type TxParamsType = Pick<
   ScriptTransactionRequestLike,
-  'gasLimit' | 'tip' | 'maturity' | 'maxFee' | 'witnessLimit'
+  'gasLimit' | 'tip' | 'maturity' | 'maxFee' | 'witnessLimit' | 'expiration'
 >;
 
 export type TransferParams = {

packages/account/src/providers/fuel-core-schema.graphql

@@ -18,9 +18,16 @@ scalar Address
 
 scalar AssetId
 
+type AssetInfoDetails {
+  contractId: ContractId!
+  subId: SubId!
+  totalSupply: U128!
+}
+
 type Balance {
   owner: Address!
   amount: U64!
+  amountU128: U128!
   assetId: AssetId!
 }
 
@@ -314,6 +321,10 @@ enum ContractParametersVersion {
   V1
 }
 
+type DaCompressedBlock {
+  bytes: HexString!
+}
+
 union DependentCost = LightOperation | HeavyOperation
 
 type DryRunFailureStatus {
@@ -468,6 +479,7 @@ type GasCosts {
   wqmm: U64!
   xor: U64!
   xori: U64!
+  ecop: U64
   alocDependentCost: DependentCost!
   bldd: DependentCost
   bsiz: DependentCost
@@ -492,6 +504,7 @@ type GasCosts {
   smo: DependentCost!
   srwq: DependentCost!
   swwq: DependentCost!
+  epar: DependentCost
   contractRoot: DependentCost!
   stateRoot: DependentCost!
   vmInitialization: DependentCost!
@@ -809,8 +822,11 @@ type NodeInfo {
   utxoValidation: Boolean!
   vmBacktrace: Boolean!
   maxTx: U64!
+  maxGas: U64!
+  maxSize: U64!
   maxDepth: U64!
   nodeVersion: String!
+  txPoolStats: TxPoolStats!
   peers: [PeerInfo!]!
 }
 
@@ -921,6 +937,13 @@ type ProgramState {
 }
 
 type Query {
+  assetDetails(
+    """
+    ID of the Asset
+    """
+    id: AssetId!
+  ): AssetInfoDetails!
+
   """
   Read register value by index.
   """
@@ -1039,7 +1062,8 @@ type Query {
     """
     The list of requested assets` coins with asset ids, `target` amount the user
     wants to reach, and the `max` number of coins in the selection. Several
-    entries with the same asset id are not allowed.
+    entries with the same asset id are not allowed. The result can't contain
+    more coins than `max_inputs`.
     """
     queryPerAsset: [SpendQueryElementInput!]!
 
@@ -1048,6 +1072,12 @@ type Query {
     """
     excludedIds: ExcludeInput
   ): [[CoinType!]!]!
+  daCompressedBlock(
+    """
+    Height of the block
+    """
+    height: U32!
+  ): DaCompressedBlock
   contract(
     """
     ID of the Contract
@@ -1091,7 +1121,7 @@ type Query {
     nonce: Nonce!
     commitBlockId: BlockId
     commitBlockHeight: U32
-  ): MessageProof
+  ): MessageProof!
   messageStatus(nonce: Nonce!): MessageStatus!
   relayedTransactionStatus(
     """
@@ -1232,6 +1262,8 @@ type StateTransitionPurpose {
   root: Bytes32!
 }
 
+scalar SubId
+
 type SubmittedStatus {
   time: Tai64Timestamp!
 }
@@ -1383,6 +1415,25 @@ enum TxParametersVersion {
 
 scalar TxPointer
 
+type TxPoolStats {
+  """
+  The number of transactions in the pool
+  """
+  txCount: U64!
+
+  """
+  The total size of the transactions in the pool
+  """
+  totalSize: U64!
+
+  """
+  The total gas of the transactions in the pool
+  """
+  totalGas: U64!
+}
+
+scalar U128
+
 scalar U16
 
 scalar U32