CHANGELOG.md

Change Log

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[Unreleased (see .changes folder)]

[Version 0.47.1]

Fixed

• 3119: Add missing description and license in cargo manifest

[Version 0.47.0]

Breaking

• 3014: Extend CoinConfig to also support being configured with private keys.
• 3050: - Used a new fuel-vm 0.64.0 release which brings breaking changes: https://github.com/FuelLabs/fuel-vm/releases/tag/v0.64.0
  • The default gas cost has been changed according to new optimizations and a new benchmark machine for a local node.
  • Receipts now are behind an Arc pointer to avoid unnecessary cloning. It affects transaction states and preconfirmations.
  • The deploy_contract_with_id now works with [u8] instead of the Contract type.
• 3083: Disable gossip subscription for transactions by default. It can be enabled using --subscribe-to-transactions flag.
• 3094: Fixed the bug where we charged for additional 40 entries on the GraphQL query
• 3099: Use hash-based balance_root and state_root fields in tx inputs and outputs
• 3110: Bump Rust version to 1.90.0 and fuel-vm to 0.65.0
• 3117: The algorithm to calculate the genesis state root and the balance root was changed to not use SMTs. This change doesn't affect mainnet, testnet, and devnet, because these networks didn't use any balances or storage slots in the state config. But the change is breaking for anyone who used them.

Added

• 3023: Add a method to wait for gas_price to finish syncing upon receiving a new block, and modify the test accordingly.

• 3049: Support awaiting of DA block height on pre defined block production.

• 3050: A new benchmarking group for niop operations in the alu.rs file. The changes add comprehensive benchmarks for various operations (ADD, SUB, MUL, EXP, SLL, XNOR) across different operand widths (U8, U16, U32)

  Additions to benchmarking:

  • A new niop benchmarking group was added to evaluate the performance of narrow integer operations (niop) with different operand widths (U8, U16, U32).
  • Introduced the niop_bench macro to simplify the creation of benchmarks for operations like ADD, SUB, MUL, EXP, SLL, and XNOR.
  • Benchmarks iterate over generated operand pairs for each width, ensuring a variety of test cases for each operation.

• 3059: Enable debug logging in predicates and scripts using ECAL. Upgrades fuel-vm to 0.63.0.

• 3085: Add scaffolding for the new block aggregator service

• 3092: Add adapter for the block aggregator DB

• 3096: Add subscription manager for core service

• 3097: Add block source adapter using fuel storage and block importer

Changed

• 3050: Actualized benchmarks with the performance of the network. With this change we should be able to run benchmarks on nightly bases.

  Added several optimizations to the code base:

  • Executor now reuses the memory instance between blocks production and validation avoiding allocations.
  • Receipts are not cloned anymore from the VM. Instead, they are extracted from the VM and stored ina s shared pointer.
  • The gas usage for script is discovered in a faster way.
  • Create transaction doesn't require a cloning of the contract bytecode anymore to calculate its ContractId.
  • Serialization and deserialization of the bytes became much faster for canonical, postcard, bincode codecs.

• 3104: Automatically adjust relayer log page size to prevent sync failures from oversized Ethereum RPC responses.

Removed

• 3117: Removed SMT usage from STF and benchmarks.

[Version 0.46.0]

Breaking

• 3070: Fix the AssetDetails endpoint to match GraphQL standards

Added

• 3061: Add tests showing that mints are correctly added and validated
• 3074: Added alpha version of new subscriptions for pre confirmations and new blocks. These subscriptions are not final and may change in the future. Subscriptions are disabled by default and can be enabled by setting --expensive-subscriptions via CLI.

Fixed

• 3071: Use outputs instead of events to compress blocks

[Version 0.45.1]

Breaking

• 3022: Support rolling back Relayer DB.
• 3056: Bump Rust version to 1.86.0
• 3058: upgrade wasmtime and thiserror dependencies

Added

• 2959: Add Registrations table to the compression database. This is merkleized.
• 3027: Support state rewind for compression DB.
• 3054: Added a new configuration option --p2p-cache-size to control the size of the p2p req/res protocol cache size.

Changed

• 3030: Disable dependency on blob transactions in transaction pool.
• 3033: Use ubuntu:24.04 to build x86_64 binary
• 3060: Use v44 STF if forward-compatibility test
• 3062: Increase default transmission size to 260MB, to support 2.5MB blocks by default during synchronization

Fixed

• 3048: The MaxCoinsReached error is now thrown when the target reached the max input limit.

[Version 0.44.0]

Breaking

• 2887: Bump Rust version to 1.85.0. Starting with this release, newly generated WASM state transition functions are no longer compatible with old versions of the fuel-core. So, the change breaks forward compatibility for the network and each node should start to use a new fuel-core release.
• 2943: Registry root calculation for compression tables no longer accounts for the evictor cache.
• 2947: Upgrade to 2024 Rust edition.
• 2958: Changed return type of balance endpoint from u64 to u128
• 3002: Update fuel-vm to 0.61.1. In doing this, we've changed Receipts to use the SubId scalar type for sub asset IDs.

Added

• 2954: Made registry mod public in fuel-core-compression
• 2956: Add excluded_contract filter to extract of transaction from TxPool.
• 2994: Simple makefile with basic commands.
• 3004: Additional error logs for Ethereum provider failures.

Changed

• 3021: Updated fuel-vm to 0.62.0, see https://github.com/fuelLabs/fuel-vm/releases/v0.62.0

Fixed

• 2969: Ensure that vm heap memory is zeroed out on rellocation after reset. Adds support for GM::GetGasPrice Bumps fuel-vm to 0.60.2.
• 2984: Fix client coins endpoint so that passing None for asset_id no longer defaults to AssetId::default() but correctly returns all asset types.
• 2987: Make txpool pre-conf broadcast conditional on there being some txs in the list
• 2989: Prevent syncing compression database from genesis if override cli arg --da-compression-starting-height is provided.
• 2992: Make sure assemble tx doesn't count message data inputs as spendable inputs for covering fee
• 2993: Pin the graphiql playground to v3, and cache the result to be reused across multiple calls to render the playground.

Removed

• 2955: Remove unnecessary lifetime constraints on fuel-core-client.

[Version 0.43.2]

Fixed

• 2978: Add method to override starting syncing height for compression service if starting from scratch.

[Version 0.43.1]

Fixed

• 2964: Ensure that vm heap memory is zeroed out on rellocation after reset. Adds support for GM::GetGasPrice Bumps fuel-vm to 0.60.2.

[Version 0.43.0]

Breaking

• 2882: Changed the type of the resolved_outputs for pre-confirmations. Now it also includes Utxoid. resolved_outputs field contains only Change and Variable outputs, so the UtxoId for them could be hard to derive, if transaction has known inputs. This information should help to create dependent transactions more easily.
• 2900: Get rid of Deref impl on ImportResult by introducing wrapper type.
• 2909: Compressed block headers now include a merkle root of the temporal registry after compression was performed.
• 2931: In fuel-core-compression, the compress function now takes a reference to Config instead of the value.

Added

• 2848: Link all components of preconfirmations and add E2E tests.
• 2882: Listen to tx status update from TxStatusManager in TxPool. Added logic to clean up transactions from the pool if received squeezed out pre confirmations. Added logic to promote transactions on sentry nodes when receive pre-confirmation.
• 2885: Notify P2P from TxStatusManager in case of bad preconfirmation message.
• 2901: New query dryRunRecordStorageReads which works like dryRun but also returns storage reads, allowing use of execution tracer or local debugger
• 2912: Add the allow_partial parameter to the coinsToSpend query. The default value of this parameters is false to preserve the old behavior. If set to true, the query returns available coins instead of failing when the requested amount is unavailable.
• 2914: Tests ensuring the proof generation and validation of tables with sparse and merklized blueprints work.

Changed

• 2859: Swap out off-chain worker compression for dedicated compression service in fuel-core-bin.
• 2914: Break out test logic to trait methods for root_storage_tests and basic_merkleized_storage_tests test macros.
• 2925: Make preconfirmation optional on API endpoints.

Fixed

• 2918: Only cancel background work if primary RocksDB instance is dropped
• 2935: The change rejects transactions immediately, if they use spent coins. TxPool has a SpentInputs LRU cache, storing all spent coins.

Removed

• 2859: Removed DA compression from off-chain worker in favor of dedicated compression service in fuel-core-bin.

[Version 0.42.0]

Breaking

• 2648: Add feature-flagged field to block header fault_proving_header that contains a commitment to all transaction ids.
• 2678: Removed public accessors for BlockHeader fields and replaced with methods instead, moved tx_id_commitment to the application header of BlockHeaderV2.
• 2746: Breaking changes to the CLI arguments:
  • To disable random-walk just don't specify it. Before it required to use --random-walk 0.
  • Next CLI arguments were renamed:
    • relayer-min-duration-s -> relayer-min-duration
    • relayer-eth-sync-call-freq-s -> relayer-eth-sync-call-freq
    • relayer-eth-sync-log-freq-s -> relayer-eth-sync-log-freq
  • Default value for the heartbeat-idle-duration was changed from 1s to 100ms. So information about new block will be propagated faster by default.
  • All CLI arguments below use time(like 100ms, 1s, 1d, etc.) use as a flag argument instead of number of seconds:
    • random-walk
    • connection-idle-timeout
    • info-interval
    • identify-interval
    • request-timeout
    • connection-keep-alive
    • heartbeat-send-duration
    • heartbeat-idle-duration
    • heartbeat-check-interval
    • heartbeat-max-avg-interval
    • heartbeat-max-time-since-last
    • relayer-min-duration
    • relayer-eth-sync-call-freq
    • relayer-eth-sync-log-freq
• 2840: CLI argument vm-backtrace is deprecated and does nothing. It will be removed in a future version of fuel-core. The extra_tx_checks field was renamed into forbid_fake_coins that affects JSON based serialization/deserialization. Renamed extra_tx_checks_default field into forbid_fake_coins_default.

Added

• 2150: Upgraded libp2p to 0.54.1 and introduced ConnectionLimiter to limit pending incoming/outgoing connections.

• 2491: Storage read replays of historical blocks for execution tracing. Only available behind --historical-execution flag.

• 2619: Add possibility to submit list of changes to rocksdb.

• 2666: Added two new CLI arguments to control the GraphQL queries consistency: --graphql-block-height-tolerance (default: 10) and --graphql-block-height-min-timeout (default: 30s). If a request requires a specific block height and the node is slightly behind, it will wait instead of failing.

• 2682: Added GraphQL APIs to get contract storage and balances for current and past blocks.

• 2719: Merklized DA compression temporal registry tables.

• 2722: Service definition for state root service.

• 2724: Explicit error type for merkleized storage.

• 2726: Add a new gossip-sub message for transaction preconfirmations

• 2731: Include TemporalRegistry trait implementations for v2 tables.

• 2733: Add a pending pool transaction that allow transaction to wait a bit of time if an input is missing instead of direct delete.

• 2742: Added API crate for merkle root service.

• 2756: Add new service for managing pre-confirmations

• 2769: Added a new assembleTx GraphQL endpoint. The endpoint can be used to assemble the transaction based on the provided requirements.

  • The returned transaction contains:

    • Input coins to cover required_balances
    • Input coins to cover the fee of the transaction based on the gas price from block_horizon
    • Change or Destroy outputs for all assets from the inputs
    • Variable outputs in the case they are required during the execution
    • Contract inputs and outputs in the case they are required during the execution
    • Reserved witness slots for signed coins filled with 64 zeroes
    • Set script gas limit(unless script is empty)
    • Estimated predicates, if estimate_predicates == true

  • Returns an error if:

    • The number of required balances exceeds the maximum number of inputs allowed.
    • The fee address index is out of bounds.
    • The same asset has multiple change policies(either the receiver of the change is different, or one of the policies states about the destruction of the token while the other does not). The Change output from the transaction also count as a ChangePolicy.
    • The number of excluded coin IDs exceeds the maximum number of inputs allowed.
    • Required assets have multiple entries.
    • If accounts don't have sufficient amounts to cover the transaction requirements in assets.
    • If a constructed transaction breaks the rules defined by consensus parameters.

• 2780: Add implementations for the pre-confirmation signing task

• 2784: Integrate the pre conf signature task into the main consensus task

• 2788: Scaffold dedicated compression service.

• 2799: Add a transaction waiter to the executor to wait for potential new transactions inside the block production window. Add a channel to send preconfirmation created by executor to the other modules Added a new CLI arguments:

  • --production-timeout to control the block production timeout in the case if block producer stuck.
  • --poa-open-period set the block production mode to Open. The Open mode starts the production of the next block immediately after the previous block. The block is open until the period passed. The period is a duration represented by 100ms, 1s, 1m, etc. The manual block production is disabled if this production mode is used.

• 2802: Add a new cache with outputs extracted from the pool for the duration of the block.

• 2824: Introduce new Try-like methods for the TaskNextAction

• 2840: Added a new CLI arguments:

  • assemble-tx-dry-run-limit - The max number how many times script can be executed during assemble_tx GraphQL request. Default value is 3 times.
  • assemble-tx-estimate-predicates-limit - The max number how many times predicates can be estimated during assemble_tx GraphQL request. Default values is 10 times.

• 2841: Following endpoints allow estimation of predicates on submission of the transaction via new estimatePredicates argument:

  • submit
  • submit_and_await
  • submit_and_await_status

  The change is backward compatible with all SDKs. The change is not forward-compatible with Rust SDK in the case of the estimate_predicates flag set.

• 2844: Implement DA compression in fuel-core-compression-service.

• 2845: New status to manage the pre confirmation status send in TxUpdateSender.

• 2855: Add an expiration interval check for pending pool and refactor extracted_outputs to not rely on block creation/process sequence.

• 2856: Add generic logic for managing the signatures and delegate keys for pre-confirmations signatures

• 2862: Derive enum_iterator::Sequence and strum_macros::{EnumCount, IntoStaticStr} for MerkleizedColumn.

Changed

• 2388: Rework the P2P service codecs to avoid unnecessary coupling between components. The refactoring makes it explicit that the Gossipsub and RequestResponse codecs only share encoding/decoding functionalities from the Postcard codec. It also makes handling Gossipsub and RequestResponse messages completely independent of each other.
• 2460: The type of the max_response_sizefor the postcard codec used in RequestResponse protocols has been changed from usize to u64.
• 2473: Graphql requests and responses make use of a new extensions object to specify request/response metadata. A request extensions object can contain an integer-valued required_fuel_block_height field. When specified, the request will return an error unless the node's current fuel block height is at least the value specified in the required_fuel_block_height field. All graphql responses now contain an integer-valued current_fuel_block_height field in the extensions object, which contains the block height of the last block processed by the node.
• 2618: Parallelize block/transaction changes creation in Importer
• 2653: Added cleaner error for wasm-executor upon failed deserialization.
• 2656: Migrate test helper function create_contract to fuel_core_types::test_helpers::create_contract, and refactor test in proof_system/global_merkle_root crate to use this function.
• 2659: Replace derivative crate with educe crate.
• 2705: Update the default value for --max-block-size and --max-transmit-size to 50 MB
• 2715: Each GraphQL response contains current_consensus_parameters_version and current_stf_version in the extensions section.
• 2723: Change the way we are building the changelog to avoids conflicts.
• 2725: New txpool worker to remove lock contention
• 2752: Extended the TransactionStatus to support pre-confirmations.
• 2761: Renamed ConsensusParametersProvider to ChainStateInfoProvider because it is now providing more than just info about consensus parameters.
• 2767: Updated fuel-vm to v0.60.0, see release notes.
• 2781: Deprecate dryRun mutation. Use dryRun query instead.
• 2791: Added TxStatusManager service which serves as a single source of truth regarding the current statuses of transactions
• 2793: Moved common merkle storage trait implementations to fuel-core-storage and made it easier to setup a set of columns that need merkleization.
• 2799: Change the block production to not be trigger after an interval but directly after the creation of last block and let the executor run for the block time window.
• 2800: Implement P2P adapter for preconfirmation broadcasting
• 2802: Change new txs notifier to be notified only on executable transactions
• 2811: When the state rewind window of 7d was triggered, the is_migration_in_progress was repeatedly called, resulting in multiple iterations over the empty ModificationsHistoryV1 table. Iteration was slow because compaction didn't have a chance to clean up V1 table. We removed iteration from the migration process.
• 2824: Improve conditions where Errors in the PreConfirmationSignatureTask stop the service
• 2840: Removed log_backtrace logic from the executor. It is not needed anymore with the existence of the local debugger for the transactions.
• 2865: Consider the following transaction statuses as final: Success, Failure, SqueezedOut, PreConfirmationSqueezedOut. All other statuses will be considered transient.

Fixed

• 2646: Improved performance of fetching block height by caching it when the view is created.
• 2682: Fixed the issue with RPC consistency feature for the subscriptions(without the fix first we perform the logic of the query, and only after verify the required height).
• 2730: Fixed RocksDB closing issue that potentially could panic.
• 2743: Allow discovery of the peers when slots for functional connections are consumed. Reserved nodes are not affected by the limitation on connections anymore.
• 2746: Fixed flaky part in the e2e tests and version compatibility tests. Speed up compatibility tests execution time. Decreased the default time between block height propagation throw the network.
• 2758: Made tx_id_commitment feature flagged in fuel-core-client.
• 2832: - Trigger block production only when all other sub services are started.
  • Fix relayer syncing issue causing block production to slow down occasionally.
• 2840: Fixed fuel-core-client receipt deserialization in the case if the ContractId is zero.

Removed

• 2863: Removed everything related to the state root service, as it has been moved to another repo.

[Version 0.41.10]

Fixed

• 2963: Ensure that vm heap memory is zeroed out on rellocation after reset. Bumps fuel-vm to 0.59.3.

[Version 0.41.9]

Fixed

• 2829: Ensure that the local state of fuel-core-relayer is set correctly after downloading logs from DA.
• 2830: Ensure that the block producer only starts after all the services have been initialized.

[Version 0.41.8]

Fixed

• 2809: When the state rewind window of 7d was triggered, the is_migration_in_progress was repeatedly called, resulting in multiple iterations over the empty ModificationsHistoryV1 table. Iteration was slow because compaction didn't have a chance to clean up V1 table. We removed iteration from the migration process.

[Version 0.41.7]

Fixed

• 2710: Update Fuel-VM to fix compressed transaction backward compatibility.

[Version 0.41.6]

Added

• 2668: Expose gas price service test helpers
• 2621: Global merkle root storage updates process upgrade transactions.
• 2650: Populate ProcessedTransactions table in global merkle root storage.
• 2667: Populate Blobs table in global merkle root storage.
• 2652: Global Merkle Root storage crate: Add Raw contract bytecode to global merkle root storage when processing Create transactions.
• 2669: Populate UploadedBytecodes table in global merkle root storage.

Fixed

• 2673: Change read behavior on the InMemoryTransaction to use offset and allow not equal buf size (fix CCP and LDC broken from FuelLabs/fuel-vm#847)

[Version 0.41.5]

Changed

• 2387: Update description tx-max-depth flag.
• 2630: Removed some noisy tracing::info! logs
• 2643: Before this fix when tip is zero, transactions that use 30M have the same priority as transactions with 1M gas. Now they are correctly ordered.
• 2645: Refactored cumulative_percent_change for 90% perf gains and reduced duplication.

Breaking

• 2661: Dry run now supports running in past blocks. dry_run_opt method now takes block number as the last argument. To retain old behavior, simply pass in None for the last argument.

Added

• 2617: Add integration skeleton of parallel-executor.
• 2553: Scaffold global merkle root storage crate.
• 2598: Add initial test suite for global merkle root storage updates.
• 2635: Add metrics to gas price service
• 2664: Add print with all information when a transaction is refused because of a collision.

Fixed

• 2632: Improved performance of certain async trait impls in the gas price service.
• 2662: Fix balances query endpoint cost without indexation and behavior coins to spend with one parameter at zero.

[Version 0.41.4]

Fixed

• 2628: Downgrade STF.

[Version 0.41.3]

Fixed

• 2626: Avoid needs of RocksDB features in tests modules.

[Version 0.41.2]

Fixed

• 2623: Pinned netlink-proto's version.

[Version 0.41.1]

Added

• 2551: Enhanced the DA compressed block header to include block id.
• 2595: Added indexation field to the nodeInfo GraphQL endpoint to allow checking if a specific indexation is enabled.

Changed

• 2603: Sets the latest recorded height on initialization, not just when DA costs are received

Fixed

• 2612: Use latest gas price to estimate next block gas price during dry runs
• 2612: Use latest gas price to estimate next block gas price in tx pool instead of using algorithm directly
• 2609: Check response before trying to deserialize, return error instead
• 2599: Use the proper url apis to construct full url path in BlockCommitterHttpApi client
• 2593: Fixed utxo id decompression

[Version 0.41.0]

Added

• 2547: Replace the old Graphql gas price provider adapter with the ArcGasPriceEstimate.
• 2445: Added GQL endpoint for querying asset details.
• 2442: Add uninitialized task for V1 gas price service
• 2154: Added Unknown variant to ConsensusParameters graphql queries
• 2154: Added Unknown variant to Block graphql queries
• 2154: Added TransactionType type in fuel-client
• 2321: New metrics for the TxPool:
  • The size of transactions in the txpool (txpool_tx_size)
  • The time spent by a transaction in the txpool in seconds (txpool_tx_time_in_txpool_seconds)
  • The number of transactions in the txpool (txpool_number_of_transactions)
  • The number of transactions pending verification before entering the txpool (txpool_number_of_transactions_pending_verification)
  • The number of executable transactions in the txpool (txpool_number_of_executable_transactions)
  • The time it took to select transactions for inclusion in a block in microseconds (txpool_select_transactions_time_microseconds)
  • The time it took to insert a transaction in the txpool in microseconds (transaction_insertion_time_in_thread_pool_microseconds)
• 2385: Added new histogram buckets for some of the TxPool metrics, optimize the way they are collected.
• 2347: Add activity concept in order to protect against infinitely increasing DA gas price scenarios
• 2362: Added a new request_response protocol version /fuel/req_res/0.0.2. In comparison with /fuel/req/0.0.1, which returns an empty response when a request cannot be fulfilled, this version returns more meaningful error codes. Nodes still support the version 0.0.1 of the protocol to guarantee backward compatibility with fuel-core nodes. Empty responses received from nodes using the old protocol /fuel/req/0.0.1 are automatically converted into an error ProtocolV1EmptyResponse with error code 0, which is also the only error code implemented. More specific error codes will be added in the future.
• 2386: Add a flag to define the maximum number of file descriptors that RocksDB can use. By default it's half of the OS limit.
• 2376: Add a way to fetch transactions in P2P without specifying a peer.
• 2361: Add caches to the sync service to not reask for data it already fetched from the network.
• 2327: Add more services tests and more checks of the pool. Also add an high level documentation for users of the pool and contributors.
• 2416: Define the GasPriceServiceV1 task.
• 2447: Use new expiration policy in the transaction pool. Add a mechanism to prune the transactions when they expired.
• 1922: Added support for posting blocks to the shared sequencer.
• 2033: Remove Option<BlockHeight> in favor of BlockHeightQuery where applicable.
• 2490: Added pagination support for the balances GraphQL query, available only when 'balances indexation' is enabled.
• 2439: Add gas costs for the two new zk opcodes ecop and eadd and the benches that allow to calibrate them.
• 2472: Added the amountU128 field to the Balance GraphQL schema, providing the total balance as a U128. The existing amount field clamps any balance exceeding U64 to u64::MAX.
• 2526: Add possibility to not have any cache set for RocksDB. Add an option to either load the RocksDB columns families on creation of the database or when the column is used.
• 2532: Getters for inner rocksdb database handles.
• 2524: Adds a new lock type which is optimized for certain workloads to the txpool and p2p services.
• 2535: Expose backup and restore APIs on the CombinedDatabase struct to create portable backups and restore from them.
• 2550: Add statistics and more limits infos about txpool on the node_info endpoint

Fixed

• 2560: Fix flaky test by increasing timeout
• 2558: Rename cost and reward to remove excess wording
• 2469: Improved the logic for syncing the gas price database with on_chain database
• 2365: Fixed the error during dry run in the case of race condition.
• 2366: The importer_gas_price_for_block metric is properly collected.
• 2369: The transaction_insertion_time_in_thread_pool_milliseconds metric is properly collected.
• 2413: block production immediately errors if unable to lock the mutex.
• 2389: Fix construction of reverse iterator in RocksDB.
• 2479: Fix an error on the last iteration of the read and write sequential opcodes on contract storage.
• 2478: Fix proof created by message_receipts_proof function by ignoring the receipts from failed transactions to match message_outbox_root.
• 2485: Hardcode the timestamp of the genesis block and version of tai64 to avoid breaking changes for us.
• 2511: Fix backward compatibility of V0Metadata in gas price db.

Changed

• 2469: Updated adapter for querying costs from DA Block committer API
• 2469: Use the gas price from the latest block to estimate future gas prices
• 2501: Use gas price from block for estimating future gas prices
• 2468: Abstract unrecorded blocks concept for V1 algorithm, create new storage impl. Introduce TransactionableStorage trait to allow atomic changes to the storage.
• 2295: CombinedDb::from_config now respects state_rewind_policy with tmp RocksDB.
• 2378: Use cached hash of the topic instead of calculating it on each publishing gossip message.
• 2438: Refactored service to use new implementation of StorageRead::read that takes an offset in input.
• 2429: Introduce custom enum for representing result of running service tasks
• 2377: Add more errors that can be returned as responses when using protocol /fuel/req_res/0.0.2. The errors supported are ProtocolV1EmptyResponse (status code 0) for converting empty responses sent via protocol /fuel/req_res/0.0.1, RequestedRangeTooLarge(status code 1) if the client requests a range of objects such as sealed block headers or transactions too large, Timeout (status code 2) if the remote peer takes too long to fulfill a request, or SyncProcessorOutOfCapacity if the remote peer is fulfilling too many requests concurrently.
• 2233: Introduce a new column modification_history_v2 for storing the modification history in the historical rocksDB. Keys in this column are stored in big endian order. Changed the behaviour of the historical rocksDB to write changes for new block heights to the new column, and to perform lookup of values from the modification_history_v2 table first, and then from the modification_history table, performing a migration upon access if necessary.
• 2383: The balance and balances GraphQL query handlers now use index to provide the response in a more performant way. As the index is not created retroactively, the client must be initialized with an empty database and synced from the genesis block to utilize it. Otherwise, the legacy way of retrieving data will be used.
• 2463: The coinsToSpend GraphQL query handler now uses index to provide the response in a more performant way. As the index is not created retroactively, the client must be initialized with an empty database and synced from the genesis block to utilize it. Otherwise, the legacy way of retrieving data will be used.
• 2556: Ensure that the last_recorded_height is set for the DA gas price source.

Breaking

• 2469: Move from GasPriceServicev0 to GasPriceServiceV1. Include new config values.
• 2438: The fuel-core-client can only work with new version of the fuel-core. The 0.40 and all older versions are not supported.
• 2438: Updated fuel-vm to 0.59.1 release. Check release notes for more details.
• 2389: Updated the messageProof GraphQL schema to return a non-nullable MessageProof.
• 2154: Transaction graphql endpoints use TransactionType instead of fuel_tx::Transaction.
• 2446: Use graphiql instead of graphql-playground due to known vulnerability and stale development.
• 2379: Change kv_store::Value to be Arc<[u8]> instead of Arc<Vec<u8>>.
• 2490: Updated GraphQL complexity calculation for balances query to account for pagination (first/last) and nested field complexity (child_complexity). Queries with large pagination values or deeply nested fields may have higher complexity costs.
• 2463: 'CoinsQueryError::MaxCoinsReachedvariant has been removed. TheInsufficientCoinsvariant has been renamed toInsufficientCoinsForTheMaxand it now contains the additionalmax` field
• 2463: The number of excluded ids in the coinsToSpend GraphQL query is now limited to the maximum number of inputs allowed in transaction.
• 2463: The coinsToSpend GraphQL query may now return different coins, depending whether the indexation is enabled or not. However, regardless of the differences, the returned coins will accurately reflect the current state of the database within the context of the query.
• 2526: By default the cache of RocksDB is now disabled instead of being 1024 * 1024 * 1024.

[Version 0.40.2]

Fixed

• 2476: Hardcode the timestamp of the genesis block.

[Version 0.40.1]

Added

• 2450: Added support for posting blocks to the shared sequencer.

[Version 0.40.0]

Added

• 2347: Add GraphQL complexity histogram to metrics.
• 2350: Added a new CLI flag graphql-number-of-threads to limit the number of threads used by the GraphQL service. The default value is 2, 0 enables the old behavior.
• 2335: Added CLI arguments for configuring GraphQL query costs.

Fixed

• 2345: In PoA increase priority of block creation timer trigger compare to txpool event management

Changed

• 2334: Prepare the GraphQL service for the switching to async methods.
• 2310: New metrics: "The gas prices used in a block" (importer_gas_price_for_block), "The total gas used in a block" (importer_gas_per_block), "The total fee (gwei) paid by transactions in a block" (importer_fee_per_block_gwei), "The total number of transactions in a block" (importer_transactions_per_block), P2P metrics for swarm and protocol.
• 2340: Avoid long heavy tasks in the GraphQL service by splitting work into batches.
• 2341: Updated all pagination queries to work with the async stream instead of the sync iterator.
• 2350: Limited the number of threads used by the GraphQL service.

Breaking

• 2310: The metrics command-line parameter has been replaced with disable-metrics. Metrics are now enabled by default, with the option to disable them entirely or on a per-module basis.
• 2341: The maximum number of processed coins from the coins_to_spend query is limited to max_inputs.

Fixed

• 2352: Cache p2p responses to serve without roundtrip to db.

[Version 0.39.0]

Added

• 2324: Added metrics for sync, async processor and for all GraphQL queries.
• 2320: Added new CLI flag graphql-max-resolver-recursive-depth to limit recursion within resolver. The default value it "1".

Fixed

• 2320: Prevent /health and /v1/health from being throttled by the concurrency limiter.
• 2322: Set the salt of genesis contracts to zero on execution.
• 2324: Ignore peer if we already are syncing transactions from it.

Breaking

• 2320: Reject queries that are recursive during the resolution of the query.

Changed

Breaking

• 2311: Changed the text of the error returned by the executor if gas overflows.

[Version 0.38.0]

Added

• 2309: Limit number of concurrent queries to the graphql service.

• 2216: Add more function to the state and task of TxPoolV2 to handle the future interactions with others modules (PoA, BlockProducer, BlockImporter and P2P).

• 2263: Transaction pool is now included in all modules of the code it has requires modifications on different modules :

  • The PoA is now notify only when there is new transaction and not using the tx_update_sender anymore.
  • The Pool transaction source for the executor is now locking the pool until the block production is finished.
  • Reading operations on the pool is now asynchronous and it’s the less prioritized operation on the Pool, API has been updated accordingly.
  • GasPrice is no more using async to allow the transactions verifications to not use async anymore

  We also added a lot of new configuration cli parameters to fine-tune TxPool configuration. This PR also changes the way we are making the heavy work processor and a sync and asynchronous version is available in services folder (usable by anyone) P2P now use separate heavy work processor for DB and TxPool interactions.

Removed

• 2306: Removed hack for genesis asset contract from the code.

[Version 0.37.1]

Fixed

• 2304: Add initialization for the genesis base asset contract.

Added

• 2288: Specify V1Metadata for GasPriceServiceV1.

[Version 0.37.0]

Added

• 1609: Add DA compression support. Compressed blocks are stored in the offchain database when blocks are produced, and can be fetched using the GraphQL API.
• 2290: Added a new CLI argument --graphql-max-directives. The default value is 10.
• 2195: Added enforcement of the limit on the size of the L2 transactions per block according to the block_transaction_size_limit parameter.
• 2131: Add flow in TxPool in order to ask to newly connected peers to share their transaction pool
• 2182: Limit number of transactions that can be fetched via TxSource::next
• 2189: Select next DA height to never include more than u16::MAX -1 transactions from L1.
• 2265: Integrate Block Committer API for DA Block Costs.
• 2162: Pool structure with dependencies, etc.. for the next transaction pool module. Also adds insertion/verification process in PoolV2 and tests refactoring
• 2280: Allow comma separated relayer addresses in cli
• 2299: Support blobs in the predicates.
• 2300: Added new function to fuel-core-client for checking whether a blob exists.

Changed

Breaking

• 2299: Anyone who wants to participate in the transaction broadcasting via p2p must upgrade to support new predicates on the TxPool level.
• 2299: Upgraded fuel-vm to 0.58.0. More information in the release.
• 2276: Changed how complexity for blocks is calculated. The default complexity now is 80_000. All queries that somehow touch the block header now are more expensive.
• 2290: Added a new GraphQL limit on number of directives. The default value is 10.
• 2206: Use timestamp of last block when dry running transactions.
• 2153: Updated default gas costs for the local testnet configuration to match fuel-core 0.35.0.

[Version 0.36.0]

Added

• 2135: Added metrics logging for number of blocks served over the p2p req/res protocol.
• 2151: Added limitations on gas used during dry_run in API.
• 2188: Added the new variant V2 for the ConsensusParameters which contains the new block_transaction_size_limit parameter.
• 2163: Added runnable task for fetching block committer data.
• 2204: Added dnsaddr resolution for TLD without suffixes.

Changed

Breaking

• 2199: Applying several breaking changes to the WASM interface from backlog:
  • Get the module to execute WASM byte code from the storage first, an fallback to the built-in version in the case of the FUEL_ALWAYS_USE_WASM.
  • Added host_v1 with a new peek_next_txs_size method, that accepts tx_number_limit and size_limit.
  • Added new variant of the return type to pass the validation result. It removes block serialization and deserialization and should improve performance.
  • Added a V1 execution result type that uses JSONError instead of postcard serialized error. It adds flexibility of how variants of the error can be managed. More information about it in FuelLabs/fuel-vm#797. The change also moves TooManyOutputs error to the top. It shows that JSONError works as expected.
• 2145: feat: Introduce time port in PoA service.
• 2155: Added trait declaration for block committer data
• 2142: Added benchmarks for varied forms of db lookups to assist in optimizations.
• 2158: Log the public address of the signing key, if it is specified
• 2188: Upgraded the fuel-vm to 0.57.0. More information in the release.

[Version 0.35.0]

Added

• 2122: Changed the relayer URI address to be a vector and use a quorum provider. The relayer argument now supports multiple URLs to fetch information from different sources.
• 2119: GraphQL query fields for retrieving information about upgrades.

Changed

• 2113: Modify the way the gas price service and shared algo is initialized to have some default value based on best guess instead of None, and initialize service before graphql.
• 2112: Alter the way the sealed blocks are fetched with a given height.
• 2120: Added submitAndAwaitStatus subscription endpoint which returns the SubmittedStatus after the transaction is submitted as well as the TransactionStatus subscription.
• 2115: Add test for SignMode is_available method.
• 2124: Generalize the way p2p req/res protocol handles requests.

Breaking

• 2040: Added full no_std support state transition related crates. The crates now require the "alloc" feature to be enabled. Following crates are affected:
  • fuel-core-types
  • fuel-core-storage
  • fuel-core-executor
• 2116: Replace H160 in config and cli options of relayer by Bytes20 of fuel-types

Fixed

• 2134: Perform RecoveryID normalization for AWS KMS -generated signatures.

[Version 0.34.0]

Added

• 2051: Add support for AWS KMS signing for the PoA consensus module. The new key can be specified with --consensus-aws-kms AWS_KEY_ARN.
• 2092: Allow iterating by keys in rocksdb, and other storages.
• 2096: GraphQL query field to fetch blob byte code by its blob ID.

Changed

• 2106: Remove deadline clock in POA and replace with tokio time functions.

• 2035: Small code optimizations.

  • The optimized code specifies the capacity when initializing the HashSet, avoiding potential multiple reallocations of memory during element insertion.
  • The optimized code uses the return value of HashSet::insert to check if the insertion was successful. If the insertion fails (i.e., the element already exists), it returns an error. This reduces one lookup operation.
  • The optimized code simplifies the initialization logic of exclude by using the Option::map_or_else method.

Breaking

• 2051: Misdocumented CONSENSUS_KEY environ variable has been removed, use CONSENSUS_KEY_SECRET instead. Also raises MSRV to 1.79.0.

Fixed

• 2106: Handle the case when nodes with overriding start on the fresh network.
• 2105: Fixed the rollback functionality to work with empty gas price database.

[Version 0.33.0]

Added

• 2094: Added support for predefined blocks provided via the filesystem.
• 2094: Added --predefined-blocks-path CLI argument to pass the path to the predefined blocks.
• 2081: Enable producer to include predefined blocks.
• 2079: Open unknown columns in the RocksDB for forward compatibility.

Changed

• 2076: Replace usages of iter_all with iter_all_keys where necessary.

Breaking

• 2080: Reject Upgrade txs with invalid wasm on txpool level.
• 2082: Move TxPoolError from fuel-core-types to fuel-core-txpool.
• 2086: Added support for PoA key rotation.
• 2086: Support overriding of the non consensus parameters in the chain config.

Fixed

• 2094: Fixed bug in rollback logic because of wrong ordering of modifications.

[Version 0.32.1]

Added

• 2061: Allow querying filled transaction body from the status.

Changed

• 2067: Return error from TxPool level if the BlobId is known.
• 2064: Allow gas price metadata values to be overridden with config

Fixes

• 2060: Use min-gas-price as a starting point if start-gas-price is zero.
• 2059: Remove unwrap that is breaking backwards compatibility
• 2063: Don't use historical view during dry run.

[Version 0.32.0]

Added

• 1983: Add adapters for gas price service for accessing database values

Breaking

• 2048: Disable SMT for ContractsAssets and ContractsState for the production mode of the fuel-core. The SMT still is used in benchmarks and tests.
• #1988: Updated fuel-vm to 0.56.0 (release notes). Adds Blob transaction support.
• 2025: Add new V0 algorithm for gas price to services. This change includes new flags for the CLI: - "starting-gas-price" - the starting gas price for the gas price algorithm - "gas-price-change-percent" - the percent change for each gas price update - "gas-price-threshold-percent" - the threshold percent for determining if the gas price will be increase or decreased And the following CLI flags are serving a new purpose - "min-gas-price" - the minimum gas price that the gas price algorithm will return
• 2045: Include withdrawal message only if transaction is executed successfully.
• 2041: Add code for startup of the gas price algorithm updater so the gas price db on startup is always in sync with the on chain db

[Version 0.31.0]

Added

• #2014: Added a separate thread for the block importer.
• #2013: Added a separate thread to process P2P database lookups.
• #2004: Added new CLI argument continue-services-on-error to control internal flow of services.
• #2004: Added handling of incorrect shutdown of the off-chain GraphQL worker by using state rewind feature.
• #2007: Improved metrics:
  • Added database metrics per column.
  • Added statistic about commit time of each database.
  • Refactored how metrics are registered: Now, we use only one register shared between all metrics. This global register is used to encode all metrics.
• #1996: Added support for rollback command when state rewind feature is enabled. The command allows the rollback of the state of the blockchain several blocks behind until the end of the historical window. The default historical window it 7 days.
• #1996: Added support for the state rewind feature. The feature allows the execution of the blocks in the past and the same execution results to be received. Together with forkless upgrades, execution of any block from the past is possible if historical data exist for the target block height.
• #1994: Added the actual implementation for the AtomicView::latest_view.
• #1972: Implement AlgorithmUpdater for GasPriceService
• #1948: Add new AlgorithmV1 and AlgorithmUpdaterV1 for the gas price. Include tools for analysis
• #1676: Added new CLI arguments:
  • graphql-max-depth
  • graphql-max-complexity
  • graphql-max-recursive-depth

Changed

• #2015: Small fixes for the database:
  • Fixed the name for historical columns - Metrics was working incorrectly for historical columns.
  • Added recommended setting for the RocksDB - The source of recommendation is official documentation https://github.com/facebook/rocksdb/wiki/Setup-Options-and-Basic-Tuning#other-general-options.
  • Removed repairing since it could corrupt the database if fails - Several users reported about the corrupted state of the database after having a "Too many descriptors" error where in logs, repairing of the database also failed with this error creating a lost folder.
• #2010: Updated the block importer to allow more blocks to be in the queue. It improves synchronization speed and mitigate the impact of other services on synchronization speed.
• #2006: Process block importer events first under P2P pressure.
• #2002: Adapted the block producer to react to checked transactions that were using another version of consensus parameters during validation in the TxPool. After an upgrade of the consensus parameters of the network, TxPool could store invalid Checked transactions. This change fixes that by tracking the version that was used to validate the transactions.
• #1999: Minimize the number of panics in the codebase.
• #1990: Use latest view for mutate GraphQL queries after modification of the node.
• #1992: Parse multiple relayer contracts, RELAYER-V2-LISTENING-CONTRACTS env variable using a , delimiter.
• #1980: Add Transaction to relayer 's event filter

Breaking

• #2012: Bumped the fuel-vm to 0.55.0 release. More about the change here.
• #2001: Prevent GraphQL query body to be huge and cause OOM. The default body size is 1MB. The limit can be changed by the graphql-request-body-bytes-limit CLI argument.
• #1991: Prepare the database to use different types than Database for atomic view.
• #1989: Extract HistoricalView trait from the AtomicView.
• #1676: New fuel-core-client is incompatible with the old fuel-core because of two requested new fields.
• #1676: Changed default value for api-request-timeout to be 30s.
• #1676: Now, GraphQL API has complexity and depth limitations on the queries. The default complexity limit is 20000. It is ~50 blocks per request with transaction IDs and ~2-5 full blocks.

Fixed

• #2000: Use correct query name in metrics for aliased queries.

[Version 0.30.0]

Added

• #1975: Added DependentCost benchmarks for the cfe and cfei opcodes.
• #1975: Added DependentCost for the cfe opcode to the GasCosts endpoint.
• #1974: Optimized the work of InMemoryTransaction for lookups and empty insertion.

Changed

• #1973: Updated VM initialization benchmark to include many inputs and outputs.

Breaking

• #1975: Updated gas prices according to new release.
• #1975: Changed GasCosts endpoint to return DependentCost for the cfei opcode via cfeiDependentCost.
• #1975: Use fuel-vm 0.54.0. More information in the release.

[Version 0.29.0]

Added

• #1889: Add new FuelGasPriceProvider that receives the gas price algorithm from a GasPriceService

Changed

• #1942: Sequential relayer's commits.
• #1952: Change tip sorting to ratio between tip and max gas sorting in txpool
• #1960: Update fuel-vm to v0.53.0.
• #1964: Add creation_instant as second sort key in tx pool

Fixed

• #1962: Fixes the error message for incorrect keypair's path.
• #1950: Fix cursor BlockHeight encoding in SortedTXCursor

[Version 0.28.0]

Changed

• #1934: Updated benchmark for the aloc opcode to be DependentCost. Updated vm_initialization benchmark to exclude growing of memory(It is handled by VM reuse).
• #1916: Speed up synchronisation of the blocks for the fuel-core-sync service.
• #1888: optimization: Reuse VM memory across executions.

Breaking

• #1934: Changed GasCosts endpoint to return DependentCost for the aloc opcode via alocDependentCost.
• #1934: Updated default gas costs for the local testnet configuration. All opcodes became cheaper.
• #1924: dry_run_opt has new gas_price: Option<u64> argument
• #1888: Upgraded fuel-vm to 0.51.0. See release for more information.

Added

• #1939: Added API functions to open a RocksDB in different modes.
• #1929: Added support of customization of the state transition version in the ChainConfig.

Removed

• #1913: Removed dead code from the project.

Fixed

• #1921: Fixed unstable gossipsub_broadcast_tx_with_accept test.
• #1915: Fixed reconnection issue in the dev cluster with AWS cluster.
• #1914: Fixed halting of the node during synchronization in PoA service.

[Version 0.27.0]

Added

• #1895: Added backward and forward compatibility integration tests for forkless upgrades.
• #1898: Enforce increasing of the Executor::VERSION on each release.

Changed

• #1906: Makes cli::snapshot::Command members public such that clients can create and execute snapshot commands programmatically. This enables snapshot execution in external programs, such as the regenesis test suite.
• #1891: Regenesis now preserves FuelBlockMerkleData and FuelBlockMerkleMetadata in the off-chain table. These tables are checked when querying message proofs.
• #1886: Use ref to Block in validation code
• #1876: Updated benchmark to include the worst scenario for CROO opcode. Also include consensus parameters in bench output.
• #1879: Return the old behaviour for the discovery_works test.
• #1848: Added version field to the Block and BlockHeader GraphQL entities. Added corresponding version field to the Block and BlockHeader client types in fuel-core-client.
• #1873: Separate dry runs from block production in executor code, remove ExecutionKind and ExecutionType, remove thread_block_transaction concept, remove PartialBlockComponent type, refactor away inner functions.
• #1900: Update the root README as fuel-core run no longer has --chain as an option. It has been replaced by --snapshot.

Breaking

• #1894: Use testnet configuration for local testnet.
• #1894: Removed support for helm chart.
• #1910: fuel-vm upgraded to 0.50.0. More information in the changelog.

[Version 0.26.0]

Fixed

Breaking

• #1868: Include the event_inbox_root in the header hash. Changed types of the transactions_count to u16 and message_receipt_count to u32 instead of u64. Updated the application hash root calculation to not pad numbers.
• #1866: Fixed a runtime panic that occurred when restarting a node. The panic happens when the relayer database is already populated, and the relayer attempts an empty commit during start up. This invalid commit is removed in this PR.
• #1871: Fixed block endpoint to return fetch the blocks from both databases after regenesis.
• #1856: Replaced instances of Union with Enum for GraphQL definitions of ConsensusParametersVersion and related types. This is needed because Union does not support multiple Versions inside discriminants or empty variants.
• #1870: Fixed benchmarks for the 0.25.3.
• #1870: Improves the performance of getting the size of the contract from the InMemoryTransaction.
• #1851: Provided migration capabilities (enabled addition of new column families) to RocksDB instance.

Added

• #1853: Added a test case to verify the database's behavior when new columns are added to the RocksDB database.
• #1860: Regenesis now preserves FuelBlockIdsToHeights off-chain table.

Changed

• #1847: Simplify the validation interface to use Block. Remove Validation variant of ExecutionKind.
• #1832: Snapshot generation can be cancelled. Progress is also reported.
• #1837: Refactor the executor and separate validation from the other use cases

[Version 0.25.2]

Fixed

• #1844: Fixed the publishing of the fuel-core 0.25.1 release.
• #1842: Ignore RUSTSEC-2024-0336: rustls::ConnectionCommon::complete_io could fall into an infinite loop based on network

[Version 0.25.1]

Fixed

• #1840: Fixed the publishing of the fuel-core 0.25.0 release.

[Version 0.25.0]

Fixed

• #1821: Can handle missing tables in snapshot.
• #1814: Bugfix: the iter_all_by_prefix was not working for all tables. The change adds a Rust level filtering.

Added

• #1831: Included the total gas and fee used by transaction into TransactionStatus.
• #1821: Propagate shutdown signal to (re)genesis. Also add progress bar for (re)genesis.
• #1813: Added back support for /health endpoint.
• #1799: Snapshot creation is now concurrent.
• #1811: Regenesis now preserves old blocks and transactions for GraphQL API.

Changed

• #1833: Regenesis of SpentMessages and ProcessedTransactions.
• #1830: Use versioning enum for WASM executor input and output.
• #1816: Updated the upgradable executor to fetch the state transition bytecode from the database when the version doesn't match a native one. This change enables the WASM executor in the "production" build and requires a wasm32-unknown-unknown target.
• #1812: Follow-up PR to simplify the logic around parallel snapshot creation.
• #1809: Fetch ConsensusParameters from the database
• #1808: Fetch consensus parameters from the provider.

Breaking

• #1826: The changes make the state transition bytecode part of the ChainConfig. It guarantees the state transition's availability for the network's first blocks. The change has many minor improvements in different areas related to the state transition bytecode:

  • The state transition bytecode lies in its own file(state_transition_bytecode.wasm) along with the chain config file. The ChainConfig loads it automatically when ChainConfig::load is called and pushes it back when ChainConfig::write is called.

  • The fuel-core release bundle also contains the fuel-core-wasm-executor.wasm file of the corresponding executor version.

  • The regenesis process now considers the last block produced by the previous network. When we create a (re)genesis block of a new network, it has the height = last_block_of_old_network + 1. It continues the old network and doesn't overlap blocks(before, we had old_block.height == new_genesis_block.height).

  • Along with the new block height, the regenesis process also increases the state transition bytecode and consensus parameters versions. It guarantees that a new network doesn't use values from the previous network and allows us not to migrate StateTransitionBytecodeVersions and ConsensusParametersVersions tables.

  • Added a new CLI argument, native-executor-version, that allows overriding of the default version of the native executor. It can be useful for side rollups that have their own history of executor upgrades.

  • Replaced:

             let file = std::fs::File::open(path)?;
             let mut snapshot: Self = serde_json::from_reader(&file)?;

    with a:

             let mut json = String::new();
             std::fs::File::open(&path)
                 .with_context(|| format!("Could not open snapshot file: {path:?}"))?
                 .read_to_string(&mut json)?;
             let mut snapshot: Self = serde_json::from_str(json.as_str())?;

    because it is 100 times faster for big JSON files.

  • Updated all tests to use Config::local_node_* instead of working with the SnapshotReader directly. It is the preparation of the tests for the futures bumps of the Executor::VERSION. When we increase the version, all tests continue to use GenesisBlock.state_transition_bytecode = 0 while the version is different, which forces the usage of the WASM executor, while for tests, we still prefer to test native execution. The Config::local_node_* handles it and forces the executor to use the native version.

  • Reworked the build.rs file of the upgradable executor. The script now caches WASM bytecode to avoid recompilation. Also, fixed the issue with outdated WASM bytecode. The script reacts on any modifications of the fuel-core-wasm-executor and forces recompilation (it is why we need the cache), so WASM bytecode always is actual now.

• #1822: Removed support of Create transaction from debugger since it doesn't have any script to execute.
• #1822: Use fuel-vm 0.49.0 with new transactions types - Upgrade and Upload. Also added max_bytecode_subsections field to the ConsensusParameters to limit the number of bytecode subsections in the state transition bytecode.
• #1816: Updated the upgradable executor to fetch the state transition bytecode from the database when the version doesn't match a native one. This change enables the WASM executor in the "production" build and requires a wasm32-unknown-unknown target.

[Version 0.24.2]

Changed

Breaking

• #1798: Add nonce to relayed transactions and also hash full messages in the inbox root.

Fixed

• #1802: Fixed a runtime panic that occurred when restarting a node. The panic was caused by an invalid database commit while loading an existing off-chain database. The invalid commit is removed in this PR.
• #1803: Produce block when da height haven't changed.
• #1795: Fixed the building of the fuel-core-wasm-executor to work outside of the fuel-core context. The change uses the path to the manifest file of the fuel-core-upgradable-executor to build the fuel-core-wasm-executor instead of relying on the workspace.

[Version 0.24.1]

Added

• #1787: Handle processing of relayed (forced) transactions
• #1786: Regenesis now includes off-chain tables.
• #1716: Added support of WASM state transition along with upgradable execution that works with native(std) and WASM(non-std) executors. The fuel-core now requires a wasm32-unknown-unknown target to build.
• #1770: Add the new L1 event type for forced transactions.
• #1767: Added consensus parameters version and state transition version to the ApplicationHeader to describe what was used to produce this block.
• #1760: Added tests to verify that the network operates with a custom chain id and base asset id.
• #1752: Add ProducerGasPrice trait that the Producer depends on to get the gas price for the block.
• #1747: The DA block height is now included in the genesis state.
• #1740: Remove optional fields from genesis configs
• #1737: Remove temporary tables for calculating roots during genesis.
• #1731: Expose schema.sdl from fuel-core-client.

Changed

Breaking

• 1785: Producer will only include DA height if it has enough gas to include the associate forced transactions.

• #1771: Contract 'states' and 'balances' brought back into ContractConfig. Parquet now writes a file per table.

• 1779: Modify Relayer service to order Events from L1 by block index

• #1783: The PR upgrade fuel-vm to 0.48.0 release. Because of some breaking changes, we also adapted our codebase to follow them:

  • Implementation of Default for configs was moved under the test-helpers feature. The fuel-core binary uses testnet configuration instead of Default::default(for cases when ChainConfig was not provided by the user).
  • All parameter types are enums now and require corresponding modifications across the codebase(we need to use getters and setters). The GraphQL API remains the same for simplicity, but each parameter now has one more field - version, that can be used to decide how to deserialize.
  • The UtxoId type now is 34 bytes instead of 33. It affects hex representation and requires adding 00.
  • The block_gas_limit was moved to ConsensusParameters from ChainConfig. It means the block producer doesn't specify the block gas limit anymore, and we don't need to propagate this information.
  • The bytecodeLength field is removed from the Create transaction.
  • Removed ConsensusParameters from executor config because ConsensusParameters::default is not available anymore. Instead, executors fetch ConsensusParameters from the database.

• #1769: Include new field on header for the merkle root of imported events. Rename other message root field.

• #1768: Moved ContractsInfo table to the off-chain database. Removed salt field from the ContractConfig.

• #1761: Adjustments to the upcoming testnet configs:

  • Decreased the max size of the contract/predicate/script to be 100KB.
  • Decreased the max size of the transaction to be 110KB.
  • Decreased the max number of storage slots to be 1760(110KB / 64).
  • Removed fake coins from the genesis state.
  • Renamed folders to be "testnet" and "dev-testnet".
  • The name of the networks are "Upgradable Testnet" and "Upgradable Dev Testnet".

• #1694: The change moves the database transaction logic from the fuel-core to the fuel-core-storage level. The corresponding issue described the reason behind it.

  Technical details of implementation

  • The change splits the KeyValueStore into KeyValueInspect and KeyValueMutate, as well the Blueprint into BlueprintInspect and BlueprintMutate. It allows requiring less restricted constraints for any read-related operations.

  • One of the main ideas of the change is to allow for the actual storage only to implement KeyValueInspect and Modifiable without the KeyValueMutate. It simplifies work with the databases and provides a safe way of interacting with them (Modification into the database can only go through the Modifiable::commit_changes). This feature is used to track the height of each database during commits and even limit how commits are done, providing additional safety. This part of the change was done as a separate commit.

  • The StorageTransaction is a StructuredStorage that uses InMemoryTransaction inside to accumulate modifications. Only InMemoryTransaction has a real implementation of the KeyValueMutate(Other types only implement it in tests).

  • The implementation of the Modifiable for the Database contains a business logic that provides additional safety but limits the usage of the database. The Database now tracks its height and is responsible for its updates. In the commit_changes function, it analyzes the changes that were done and tries to find a new height(For example, in the case of the OnChain database, we are looking for a new Block in the FuelBlocks table).

  • As was planned in the issue, now the executor has full control over how commits to the storage are done.

  • All mutation methods now require &mut self - exclusive ownership over the object to be able to write into it. It almost negates the chance of concurrent modification of the storage, but it is still possible since the Database implements the Clone trait. To be sure that we don't corrupt the state of the database, the commit_changes function implements additional safety checks to be sure that we commit updates per each height only once time.

  • Side changes:

    • The drop function was moved from Database to RocksDB as a preparation for the state rewind since the read view should also keep the drop function until it is destroyed.
    • The StatisticTable table lives in the off-chain worker.
    • Removed duplication of the Database from the dap::ConcreteStorage since it is already available from the VM.
    • The executor return only produced Changes instead of the storage transaction, which simplifies the interaction between modules and port definition.
    • The logic related to the iteration over the storage is moved to the fuel-core-storage crate and is now reusable. It provides an iterator method that duplicates the logic from MemoryStore on iterating over the BTreeMap and methods like iter_all, iter_all_by_prefix, etc. It was done in a separate revivable commit.
    • The MemoryTransactionView is fully replaced by the StorageTransactionInner.
    • Removed flush method from the Database since it is not needed after #1664.

• #1693: The change separates the initial chain state from the chain config and stores them in separate files when generating a snapshot. The state snapshot can be generated in a new format where parquet is used for compression and indexing while postcard is used for encoding. This enables importing in a stream like fashion which reduces memory requirements. Json encoding is still supported to enable easy manual setup. However, parquet is preferred for large state files.

  Snapshot command

  The CLI was expanded to allow customizing the used encoding. Snapshots are now generated along with a metadata file describing the encoding used. The metadata file contains encoding details as well as the location of additional files inside the snapshot directory containing the actual data. The chain config is always generated in the JSON format.

  The snapshot command now has the '--output-directory' for specifying where to save the snapshot.

  Run command

  The run command now includes the 'db_prune' flag which when provided will prune the existing db and start genesis from the provided snapshot metadata file or the local testnet configuration.

  The snapshot metadata file contains paths to the chain config file and files containing chain state items (coins, messages, contracts, contract states, and balances), which are loaded via streaming.

  Each item group in the genesis process is handled by a separate worker, allowing for parallel loading. Workers stream file contents in batches.

  A database transaction is committed every time an item group is successfully loaded. Resumability is achieved by recording the last loaded group index within the same db tx. If loading is aborted, the remaining workers are shutdown. Upon restart, workers resume from the last processed group.

  Contract States and Balances

  Using uniform-sized batches may result in batches containing items from multiple contracts. Optimal performance can presumably be achieved by selecting a batch size that typically encompasses an entire contract's state or balance, allowing for immediate initialization of relevant Merkle trees.

Removed

• #1757: Removed protobuf from everywhere since libp2p uses quick-protobuf.

[Version 0.23.0]

Added

• #1713: Added automatic impl of traits StorageWrite and StorageRead for StructuredStorage. Tables that use a Blueprint can be read and written using these interfaces provided by structured storage types.
• #1671: Added a new Merklized blueprint that maintains the binary Merkle tree over the storage data. It supports only the insertion of the objects without removing them.
• #1657: Moved ContractsInfo table from fuel-vm to on-chain tables, and created version-able ContractsInfoType to act as the table's data type.

Changed

• #1872: Added Eq and PartialEq derives to TransactionStatus and TransactionResponse to enable comparison in the e2e tests.
• #1723: Notify about imported blocks from the off-chain worker.
• #1717: The fix for the #1657 to include the contract into ContractsInfo table.
• #1657: Upgrade to fuel-vm 0.46.0.
• #1671: The logic related to the FuelBlockIdsToHeights is moved to the off-chain worker.
• #1663: Reduce the punishment criteria for mempool gossipping.
• #1658: Removed Receipts table. Instead, receipts are part of the TransactionStatuses table.
• #1640: Upgrade to fuel-vm 0.45.0.
• #1635: Move updating of the owned messages and coins to off-chain worker.
• #1650: Add api endpoint for getting estimates for future gas prices
• #1649: Add api endpoint for getting latest gas price
• #1600: Upgrade to fuel-vm 0.45.0
• #1633: Notify services about importing of the genesis block.
• #1625: Making relayer independent from the executor and preparation for the force transaction inclusion.
• #1613: Add api endpoint to retrieve a message by its nonce.
• #1612: Use AtomicView in all services for consistent results.
• #1597: Unify namespacing for libp2p modules
• #1591: Simplify libp2p dependencies and not depend on all sub modules directly.
• #1590: Use AtomicView in the TxPool to read the state of the database during insertion of the transactions.
• #1587: Use BlockHeight as a primary key for the FuelsBlock table.
• #1585: Let NetworkBehaviour macro generate FuelBehaviorEvent in p2p
• #1579: The change extracts the off-chain-related logic from the executor and moves it to the GraphQL off-chain worker. It creates two new concepts - Off-chain and On-chain databases where the GraphQL worker has exclusive ownership of the database and may modify it without intersecting with the On-chain database.
• #1577: Moved insertion of sealed blocks into the BlockImporter instead of the executor.
• #1574: Penalizes peers for sending invalid responses or for not replying at all.
• #1601: Fix formatting in docs and check that cargo doc passes in the CI.
• #1636: Add more docs to GraphQL DAP API.

Breaking

• #1725: All API endpoints now are prefixed with /v1 version. New usage looks like: /v1/playground, /v1/graphql, /v1/graphql-sub, /v1/metrics, /v1/health.

• #1722: Bugfix: Zero predicate_gas_used field during validation of the produced block.

• #1714: The change bumps the fuel-vm to 0.47.1. It breaks several breaking changes into the protocol:

  • All malleable fields are zero during the execution and unavailable through the GTF getters. Accessing them via the memory directly is still possible, but they are zero.
  • The Transaction doesn't define the gas price anymore. The gas price is defined by the block producer and recorded in the Mint transaction at the end of the block. A price of future blocks can be fetched through a new API nedopoint and the price of the last block can be fetch or via the block or another API endpoint.
  • The GasPrice policy is replaced with the Tip policy. The user may specify in the native tokens how much he wants to pay the block producer to include his transaction in the block. It is the prioritization mechanism to incentivize the block producer to include users transactions earlier.
  • The MaxFee policy is mandatory to set. Without it, the transaction pool will reject the transaction. Since the block producer defines the gas price, the only way to control how much user agreed to pay can be done only through this policy.
  • The maturity field is removed from the Input::Coin. The same affect can be achieve with the Maturity policy on the transaction and predicate. This changes breaks how input coin is created and removes the passing of this argument.
  • The metadata of the Checked<Tx> doesn't contain max_fee and min_fee anymore. Only max_gas and min_gas. The max_fee is controlled by the user via the MaxFee policy.
  • Added automatic impl of traits StorageWrite and StorageRead for StructuredStorage. Tables that use a Blueprint can be read and written using these interfaces provided by structured storage types.

• #1712: Make ContractUtxoInfo type a version-able enum for use in the ContractsLatestUtxotable.

• #1657: Changed CROO gas price type from Word to DependentGasPrice. The dependent gas price values are dummy values while awaiting updated benchmarks.

• #1671: The GraphQL API uses block height instead of the block id where it is possible. The transaction status contains block_height instead of the block_id.

• #1675: Simplify GQL schema by disabling contract resolvers in most cases, and just return a ContractId scalar instead.

• #1658: Receipts are part of the transaction status. Removed reason from the TransactionExecutionResult::Failed. It can be calculated based on the program state and receipts. Also, it is not possible to fetch receipts from the Transaction directly anymore. Instead, you need to fetch status and its receipts.

• #1646: Remove redundant receipts from queries.

• #1639: Make Merkle metadata, i.e. SparseMerkleMetadata and DenseMerkleMetadata type version-able enums

• #1632: Make Message type a version-able enum

• #1631: Modify api endpoint to dry run multiple transactions.

• #1629: Use a separate database for each data domain. Each database has its own folder where data is stored.

• #1628: Make CompressedCoin type a version-able enum

• #1616: Make BlockHeader type a version-able enum

• #1614: Use the default consensus key regardless of trigger mode. The change is breaking because it removes the --dev-keys argument. If the debug flag is set, the default consensus key will be used, regardless of the trigger mode.

• #1596: Make Consensus type a version-able enum

• #1593: Make Block type a version-able enum

• #1576: The change moves the implementation of the storage traits for required tables from fuel-core to fuel-core-storage crate. The change also adds a more flexible configuration of the encoding/decoding per the table and allows the implementation of specific behaviors for the table in a much easier way. It unifies the encoding between database, SMTs, and iteration, preventing mismatching bytes representation on the Rust type system level. Plus, it increases the re-usage of the code by applying the same blueprint to other tables.

  It is a breaking PR because it changes database encoding/decoding for some tables.

  StructuredStorage

  The change adds a new type StructuredStorage. It is a wrapper around the key-value storage that implements the storage traits(StorageInspect, StorageMutate, StorageRead, etc) for the tables with blueprint. This blueprint works in tandem with the TableWithBlueprint trait. The table may implement TableWithBlueprint specifying the blueprint, as an example:

  impl TableWithBlueprint for ContractsRawCode {
      type Blueprint = Plain<Raw, Raw>;
  
      fn column() -> Column {
          Column::ContractsRawCode
      }
  }

  It is a definition of the blueprint for the ContractsRawCode table. It has a plain blueprint meaning it simply encodes/decodes bytes and stores/loads them into/from the storage. As a key codec and value codec, it uses a Raw encoding/decoding that simplifies writing bytes and loads them back into the memory without applying any serialization or deserialization algorithm.

  If the table implements TableWithBlueprint and the selected codec satisfies all blueprint requirements, the corresponding storage traits for that table are implemented on the StructuredStorage type.

  Codecs

  Each blueprint allows customizing the key and value codecs. It allows the use of different codecs for different tables, taking into account the complexity and weight of the data and providing a way of more optimal implementation.

  That property may be very useful to perform migration in a more easier way. Plus, it also can be a no_std migration potentially allowing its fraud proving.

  An example of migration:

  /// Define the table for V1 value encoding/decoding.
  impl TableWithBlueprint for ContractsRawCodeV1 {
      type Blueprint = Plain<Raw, Raw>;
  
      fn column() -> Column {
          Column::ContractsRawCode
      }
  }
  
  /// Define the table for V2 value encoding/decoding.
  /// It uses `Postcard` codec for the value instead of `Raw` codec.
  ///
  /// # Dev-note: The columns is the same.
  impl TableWithBlueprint for ContractsRawCodeV2 {
      type Blueprint = Plain<Raw, Postcard>;
  
      fn column() -> Column {
          Column::ContractsRawCode
      }
  }
  
  fn migration(storage: &mut Database) {
      let mut iter = storage.iter_all::<ContractsRawCodeV1>(None);
      while let Ok((key, value)) = iter.next() {
          // Insert into the same table but with another codec.
          storage.storage::<ContractsRawCodeV2>().insert(key, value);
      }
  }

  Structures

  The blueprint of the table defines its behavior. As an example, a Plain blueprint simply encodes/decodes bytes and stores/loads them into/from the storage. The SMT blueprint builds a sparse merkle tree on top of the key-value pairs.

  Implementing a blueprint one time, we can apply it to any table satisfying the requirements of this blueprint. It increases the re-usage of the code and minimizes duplication.

  It can be useful if we decide to create global roots for all required tables that are used in fraud proving.

  impl TableWithBlueprint for SpentMessages {
      type Blueprint = Plain<Raw, Postcard>;
  
      fn column() -> Column {
          Column::SpentMessages
      }
  }
                   |
                   |
                  \|/
  
  impl TableWithBlueprint for SpentMessages {
      type Blueprint =
          Sparse<Raw, Postcard, SpentMessagesMerkleMetadata, SpentMessagesMerkleNodes>;
  
      fn column() -> Column {
          Column::SpentMessages
      }
  }

  Side changes

  iter_all

  The iter_all functionality now accepts the table instead of K and V generics. It is done to use the correct codec during deserialization. Also, the table definition provides the column.

  Duplicated unit tests

  The fuel-core-storage crate provides macros that generate unit tests. Almost all tables had the same test like get, insert, remove, exist. All duplicated tests were moved to macros. The unique one still stays at the same place where it was before.

  StorageBatchMutate

  Added a new StorageBatchMutate trait that we can move to fuel-storage crate later. It allows batch operations on the storage. It may be more performant in some cases.

• #1573: Remove nested p2p request/response encoding. Only breaks p2p networking compatibility with older fuel-core versions, but is otherwise fully internal.

[Version 0.22.4]

Added

• #1743: Added blacklisting of the transactions on the TxPool level.

        --tx-blacklist-addresses <TX_BLACKLIST_ADDRESSES>
            The list of banned addresses ignored by the `TxPool`
  
            [env: TX_BLACKLIST_ADDRESSES=]
  
        --tx-blacklist-coins <TX_BLACKLIST_COINS>
            The list of banned coins ignored by the `TxPool`
  
            [env: TX_BLACKLIST_COINS=]
  
        --tx-blacklist-messages <TX_BLACKLIST_MESSAGES>
            The list of banned messages ignored by the `TxPool`
  
            [env: TX_BLACKLIST_MESSAGES=]
  
        --tx-blacklist-contracts <TX_BLACKLIST_CONTRACTS>
            The list of banned contracts ignored by the `TxPool`
  
            [env: TX_BLACKLIST_CONTRACTS=]

[Version 0.22.3]

Added

• #1732: Added Clone bounds to most datatypes of fuel-core-client.

[Version 0.22.2]

Added

• #1729: Exposed the schema.sdl file from fuel-core-client. The user can create his own queries by using this file.

[Version 0.22.1]

Fixed

• #1664: Fixed long database initialization after restart of the node by setting limit to the WAL file.

[Version 0.22.0]

Added

• #1515: Added support of --version command for fuel-core-keygen binary.
• #1504: A Success or Failure variant of TransactionStatus returned by a query now contains the associated receipts generated by transaction execution.

Breaking

• #1531: Make fuel-core-executor no_std compatible. It affects the fuel-core crate because it uses the fuel-core-executor crate. The change is breaking because of moved types.
• #1524: Adds information about connected peers to the GQL API.

Changed

• #1517: Changed default gossip heartbeat interval to 500ms.
• #1520: Extract executor into fuel-core-executor crate.

Fixed

Breaking

• #1536: The change fixes the contracts tables to not touch SMT nodes of foreign contracts. Before, it was possible to invalidate the SMT from another contract. It is a breaking change and requires re-calculating the whole state from the beginning with new SMT roots.
• #1542: Migrates information about peers to NodeInfo instead of ChainInfo. It also elides information about peers in the default node_info query.

[Version 0.21.0]

This release focuses on preparing fuel-core for the mainnet environment:

• Most of the changes improved the security and stability of the node.
• The gas model was reworked to cover all aspects of execution.
• The benchmarking system was significantly enhanced, covering worst scenarios.
• A new set of benchmarks was added to track the accuracy of gas prices.
• Optimized heavy operations and removed/replaced exploitable functionality.

Besides that, there are more concrete changes:

• Unified naming conventions for all CLI arguments. Added dependencies between related fields to avoid misconfiguration in case of missing arguments. Added --debug flag that enables additional functionality like a debugger.
• Improved telemetry to cover the internal work of services and added support for the Pyroscope, allowing it to generate real-time flamegraphs to track performance.
• Improved stability of the P2P layer and adjusted the updating of reputation. The speed of block synchronization was significantly increased.
• The node is more stable and resilient. Improved DoS resistance and resource management. Fixed critical bugs during state transition.
• Reworked the Mint transaction to accumulate the fee from block production inside the contract defined by the block producer.

FuelVM received a lot of safety and stability improvements:

• The audit helped identify some bugs and errors that have been successfully fixed.
• Updated the gas price model to charge for resources used during the transaction lifecycle.
• Added no_std and 32 bit system support. This opens doors for fraud proving in the future.
• Removed the ChainId from the PredicateId calculation, allowing the use of predicates cross-chain.
• Improvements in the performance of some storage-related opcodes.
• Support the ECAL instruction that allows adding custom functionality to the VM. It can be used to create unique rollups or advanced indexers in the future.
• Support of transaction policies provides additional safety for the user. It also allows the implementation of a multi-dimensional price model in the future, making the transaction execution cheaper and allowing more transactions that don't affect storage.
• Refactored errors, returning more detailed errors to the user, simplifying debugging.

Added

• #1503: Add gtf opcode sanity check.
• #1502: Added price benchmark for vm_initialization.
• #1501: Add a CLI command for generating a fee collection contract.
• #1492: Support backward iteration in the RocksDB. It allows backward queries that were not allowed before.
• #1490: Add push and pop benchmarks.
• #1485: Prepare rc release of fuel core v0.21
• #1476: Add the majority of the "other" benchmarks for contract opcodes.
• #1473: Expose fuel-core version as a constant
• #1469: Added support of bloom filter for RocksDB tables and increased the block cache.
• #1465: Improvements for keygen cli and crates
• #1642: Added benchmark to measure the performance of contract state and contract ID calculation; use for gas costing.
• #1457: Fixing incorrect measurement for fast(µs) opcodes.
• #1456: Added flushing of the RocksDB during a graceful shutdown.
• #1456: Added more logs to track the service lifecycle.
• #1453: Add the majority of the "sanity" benchmarks for contract opcodes.
• #1452: Added benchmark to measure the performance of contract root calculation when utilizing the maximum contract size; used for gas costing of contract root during predicate owner validation.
• #1449: Fix coin pagination in e2e test client.
• #1447: Add timeout for continuous e2e tests
• #1444: Add "sanity" benchmarks for memory opcodes.
• #1437: Add some transaction throughput tests for basic transfers.
• #1436: Add a github action to continuously test beta-4.
• #1433: Add "sanity" benchmarks for flow opcodes.
• #1432: Add a new --api-request-timeout argument to control TTL for GraphQL requests.
• #1430: Add "sanity" benchmarks for crypto opcodes.
• #1426 Split keygen into a create and a binary.
• #1419: Add additional "sanity" benchmarks for arithmetic op code instructions.
• #1411: Added WASM and no_std compatibility.
• #1405: Use correct names for service metrics.
• #1400: Add releasy beta to fuel-core so that new commits to fuel-core master triggers fuels-rs.
• #1371: Add new client function for querying the MessageStatus for a specific message (by Nonce).
• #1356: Add peer reputation reporting to heartbeat code.
• #1355: Added new metrics related to block importing, such as tps, sync delays etc.
• #1339: Adds baseAssetId to FeeParameters in the GraphQL API.
• #1331: Add peer reputation reporting to block import code.
• #1324: Added pyroscope profiling to fuel-core, intended to be used by a secondary docker image that has debug symbols enabled.
• #1309: Add documentation for running debug builds with CLion and Visual Studio Code.
• #1308: Add support for loading .env files when compiling with the env feature. This allows users to conveniently supply CLI arguments in a secure and IDE-agnostic way.
• #1304: Implemented submit_and_await_commit_with_receipts method for FuelClient.
• #1286: Include readable names for test cases where missing.
• #1274: Added tests to benchmark block synchronization.
• #1263: Add gas benchmarks for ED19 and ECR1 instructions.

Changed

• #1512: Internally simplify merkle_contract_state_range.
• #1507: Updated chain configuration to be ready for beta 5 network. It includes opcode prices from the latest benchmark and contract for the block producer.
• #1477: Upgraded the Rust version used in CI and containers to 1.73.0. Also includes associated Clippy changes.
• #1469: Replaced usage of MemoryTransactionView by Checkpoint database in the benchmarks.
• #1468: Bumped version of the fuel-vm to v0.40.0. It brings some breaking changes into consensus parameters API because of changes in the underlying types.
• #1466: Handling overflows during arithmetic operations.
• #1460: Change tracking branch from main to master for releasy tests.
• #1454: Update gas benchmarks for opcodes that append receipts.
• #1440: Don't report reserved nodes that send invalid transactions.
• #1439: Reduced memory BMT consumption during creation of the header.
• #1434: Continue gossiping transactions to reserved peers regardless of gossiping reputation score.
• #1408: Update gas benchmarks for storage opcodes to use a pre-populated database to get more accurate worst-case costs.
• #1399: The Relayer now queries Ethereum for its latest finalized block instead of using a configurable "finalization period" to presume finality.
• #1397: Improved keygen. Created a crate to be included from forc plugins and upgraded internal library to drop requirement of protoc to build
• #1395: Add DependentCost benchmarks for k256, s256 and mcpi instructions.
• #1393: Increase heartbeat timeout from 2 to 60 seconds, as suggested in this issue.
• #1392: Fixed an overflow in message_proof.
• #1390: Up the ethers version to 2 to fix an issue with tungstenite.
• #1383: Disallow usage of log crate internally in favor of tracing crate.
• #1380: Add preliminary, hard-coded config values for heartbeat peer reputation, removing todo.
• #1377: Remove DiscoveryEvent and use KademliaEvent directly in DiscoveryBehavior.
• #1366: Improve caching during docker builds in CI by replacing gha
• #1358: Upgraded the Rust version used in CI to 1.72.0. Also includes associated Clippy changes.
• #1349: Updated peer-to-peer transactions API to support multiple blocks in a single request, and updated block synchronization to request multiple blocks based on the configured range of headers.
• #1342: Add error handling for P2P requests to return None to requester and log error.
• #1318: Modified block synchronization to use asynchronous task execution when retrieving block headers.
• #1314: Removed types::ConsensusParameters in favour of fuel_tx:ConsensusParameters.
• #1302: Removed the usage of flake and building of the bridge contract ABI. It simplifies the maintenance and updating of the events, requiring only putting the event definition into the codebase of the relayer.
• #1293: Parallelized the estimate_predicates endpoint to utilize all available threads.
• #1270: Modify the way block headers are retrieved from peers to be done in batches.

Breaking

• #1506: Added validation of the coin's fields during block production and validation. Before, it was possible to submit a transaction that didn't match the coin's values in the database, allowing printing/using unavailable assets.
• #1491: Removed unused request and response variants from the Gossipsub implementation, as well as related definitions and tests. Specifically, this removes gossiping of ConsensusVote and NewBlock events.
• #1472: Upgraded fuel-vm to v0.42.0. It introduces transaction policies that changes layout of the transaction. FOr more information check the v0.42.0 release.
• #1470: Divide DependentCost into "light" and "heavy" operations.
• #1464: Avoid possible truncation of higher bits. It may invalidate the code that truncated higher bits causing different behavior on 32-bit vs. 64-bit systems. The change affects some endpoints that now require lesser integers.
• #1432: All subscriptions and requests have a TTL now. So each subscription lifecycle is limited in time. If the subscription is closed because of TTL, it means that you subscribed after your transaction had been dropped by the network.
• #1407: The recipient is a ContractId instead of Address. The block producer should deploy its contract to receive the transaction fee. The collected fee is zero until the recipient contract is set.
• #1407: The Mint transaction is reworked with new fields to support the account-base model. It affects serialization and deserialization of the transaction and also affects GraphQL schema.
• #1407: The Mint transaction is the last transaction in the block instead of the first.
• #1374: Renamed base_chain_height to da_height and return current relayer height instead of latest Fuel block height.
• #1367: Update to the latest version of fuel-vm.
• #1363: Change message_proof api to take nonce instead of message_id
• #1355: Removed the metrics feature flag from the fuel-core crate, and metrics are now included by default.
• #1339: Added a new required field called base_asset_id to the FeeParameters definition in ConsensusParameters, as well as default values for base_asset_id in the beta and dev chain specifications.
• #1322: The debug flag is added to the CLI. The flag should be used for local development only. Enabling debug mode: - Allows GraphQL Endpoints to arbitrarily advance blocks. - Enables debugger GraphQL Endpoints. - Allows setting utxo_validation to false.
• #1318: Removed the --sync-max-header-batch-requests CLI argument, and renamed --sync-max-get-txns to --sync-block-stream-buffer-size to better represent the current behavior in the import.
• #1290: Standardize CLI args to use - instead of _.
• #1279: Added a new CLI flag to enable the Relayer service --enable-relayer, and disabled the Relayer service by default. When supplying the --enable-relayer flag, the --relayer argument becomes mandatory, and omitting it is an error. Similarly, providing a --relayer argument without the --enable-relayer flag is an error. Lastly, providing the --keypair or --network arguments will also produce an error if the --enable-p2p flag is not set.
• #1262: The ConsensusParameters aggregates all configuration data related to the consensus. It contains many fields that are segregated by the usage. The API of some functions was affected to use lesser types instead the whole ConsensusParameters. It is a huge breaking change requiring repetitively monotonically updating all places that use the ConsensusParameters. But during updating, consider that maybe you can use lesser types. Usage of them may simplify signatures of methods and make them more user-friendly and transparent.

Removed

Breaking

• #1484: Removed --network CLI argument. Now the name of the network is fetched form chain configuration.
• #1399: Removed relayer-da-finalization parameter from the relayer CLI.
• #1338: Updated GraphQL client to use DependentCost for k256, mcpi, s256, scwq, swwq opcodes.
• #1322: The manual_blocks_enabled flag is removed from the CLI. The analog is a debug flag.