Forest Files

Non-mandatory release for all node operators. It includes some fixes and improvements, notably around RPC and snapshot export. Note that there are some breaking changes in this release, so please read the changelog carefully before upgrading.

Pinochet from the release name is a Pirate from Forgotten Realms. :pirate_flag:

Breaking

• #7252: forest-cli snapshot export now generates checksum file at {filepath}.sha256sum. The default file extension is changed from .forest.car.sha256sum to .forest.car.zst.sha256sum.

• #7321: The chain indexer, which populates the Ethereum transaction-hash mappings used by eth_getTransactionByHash, eth_getTransactionReceipt, and related methods, is now enabled by default. Opt out with FOREST_CHAIN_INDEXER_ENABLED=0.

Changed

• #7320: Increase the default Eth transaction receipt cache size to 10000 and make it configurable via the FOREST_ETH_TRANSACTION_RECEIPT_CACHE_SIZE environment variable.

• #7350: Allow snapshot GC to be cancelled in-progress, same as regular snapshot export.

Fixed

• #6748: The Ethereum trace methods (trace_transaction, trace_block, trace_replayBlockTransactions) now report Reverted for a reverted contract creation instead of a mis-classified actor error.

• #7270: eth_getTransactionByBlockNumberAndIndex and eth_getTransactionByBlockHashAndIndex now resolve the transaction's to address against the tipset's post-execution state (matching eth_getBlockByNumber/eth_getTransactionByHash), instead of the pre-execution state which returned a 0xff…ffffffffffffffff masked-ID sentinel for recipients created within the tipset.

• #7329: Filecoin.NodeStatus now matches Lotus: SyncStatus.Behind is reported in epochs (not seconds), and the method takes an inclChainStatus boolean parameter that gates the chain-status computation. Also fixed casing in output JSON to match Lotus PascalCase convention.

• #7348: In case of snapshot export getting stuck, Forest will now error after a timeout of 5 minutes of no progress.

Full Changelog: https://github.com/ChainSafe/forest/compare/v0.33.8...v0.34.0