filecoin-project/lotus v1.32.1

on GitHub

The Lotus v1.32.1 release is a MANDATORY patch release, which will deliver the Filecoin network version 25, codenamed “Teep” 🦵. This release sets the upgrade epoch for the Mainnet to Epoch 4867320 - 2025-04-10T23:00:00Z, and correctly sets the F3 activationcontract address to 0xA19080A1Bcb82Bb61bcb9691EC94653Eb5315716. You can find more details about how the F3 activation on Mainnet will be executed in the F3 Activation Procedure.

☢️ Upgrade Warnings ☢️

• The Lotus v1.32.0 release had an issue where the F3 activation contract address was not set correctly. This release corrects that issue.
• If you are running the v1.30.0 version of Lotus, please go through the Upgrade Warnings section for the v1.31.0 releases and v1.31.1 before upgrading to this release.
• The minimum supported Golang version is now 1.23.6 (filecoin-project/lotus#12910).
• The SupportedProofTypes field has been removed from the Filecoin.StateGetNetworkParams method because it was frequently overlooked during proof type updates and did not accurately reflect the FVM's supported proofs (filecoin-project/lotus#12881).
• Introduced Agent field to the Filecoin.Version response. Note that this change may be breaking, depending on the clients deserialization capabilities. (filecoin-project/lotus#12904).
• The --only-cc option has been removed from the lotus-miner sectors extend command.

🏛️ Filecoin network version 25 FIPs

• FIP-0097: Add Support for EIP-1153 (Transient Storage) in the FEVM
• FIP-0098: Simplify termination fee calculation to a fixed percentage of initial pledge
• FIP-0100: Removing Batch Balancer, Replacing It With a Per-sector Fee and Removing Gas-limited Constraints
• F3 Mainnet Activation

📦 v16 Builtin Actor Bundle

This release candidate uses the v16.0.0

🚚 Migration

All node operators, including storage providers, should be aware that ONE pre-migration is being scheduled 120 epochs before the network upgrade. The migration for the NV25 upgrade is expected to be medium with a bit longer pre-migration compared to the two previous network upgrade.

Pre-Migration is expected to take between 4 to 8 minutes on a SplitStore node. The migration on the upgrade epoch is expected to take 30 seconds on a node with a NVMe-drive and a newer CPU. For nodes running on slower disks/CPU, it is still expected to take around 1 minute. We recommend node operators (who haven't enabled splitstore discard mode) that do not care about historical chain states, to prune the chain blockstore by syncing from a snapshot 1-2 days before the upgrade.

For certain node operators, such as full archival nodes or systems that need to keep large amounts of state (RPC providers), we recommend skipping the pre-migration and run the non-cached migration (i.e., just running the migration at the network upgrade epoch), and schedule for some additional downtime. Operators of such nodes can read the How to disable premigration in network upgrade tutorial.

New Features highlight

• feat!: FIP-0100 and FIP-0098 implementation.
  • Adds a scheduled nv26 "Tock" upgrade exactly 90 days after nv25 to signal the end of the sector extensions grace period for FIP-0100. This grace period is 7 days for calibnet.
  • Deadlines on the public API now have a DailyFee field
  • DealIDs has now been removed from the public API's SectorOnChainInfo (was deprecated in FIP-0079)
  • Removed --only-cc from spcli sectors extend command
  • Change circulating supply calculation for calibnet, butterflynet and 2k for nv25 upgrade; see (filecoin-project/lotus#12938) for more information.
• feat: integrate & test FIP-0098 additions (filecoin-project/lotus#12968)
• feat(cli): the lotus state sectors command now supports the --show-partitions flag and printing CSV output. (filecoin-project/lotus#12834).
• feat: handle non-existing actors gracefully in F3 power proportion CLI. (filecoin-project/lotus#12840)
• feat: check ETH events indexed in range (filecoin-project/lotus#12728)
• feat: exposed StateGetNetworkParams in the Lotus Gateway API (filecoin-project/lotus#12881)
• feat: add --csv option to the lotus send command (filecoin-project/lotus#12892)
• feat: add GenesisTimestamp to StateGetNetworkParams response (filecoin-project/lotus#12925)
• feat: add ChainGetMessagesInTipset to Lotus Gateway API (filecoin-project/lotus#12947)
• feat(f3): Implement contract based parameter setting as for FRC-0099 (filecoin-project/lotus#12861)
• feat(miner): remove batch balancer-related functionality (filecoin-project/lotus#12919)
• feat(market): expose access to ProviderSectors on the market actor abstraction (filecoin-project/lotus#12978)
• feat: expose market ProviderSectors access on state-types abstraction (filecoin-project/lotus#12978)
• feat(shed): lotus-shed miner-fees - to inspect FIP-0100 fees for a miner (filecoin-project/lotus#12980)
• Set the F3 contract address on mainnet (filecoin-project/lotus#12994)

Improvements

• refactor(eth): attach ToFilecoinMessage converter to EthCall (filecoin-project/lotus#12844)
• feat: automatically detect if genesis CAR is compressed when using the --genesis flag in the lotus daemon command (filecoin-project/lotus#12885)
• fix: In addition to existing network, also publish 2k docker images (filecoin-project/lotus#12911)
• docs(api): document 10% overestimation in collateral/pledge APIs (filecoin-project/lotus#12922)
• fix(drand): add null HistoricalBeaconClient for old beacons (filecoin-project/lotus#12830)
• chore: reduce participation log verbosity when F3 isn't read (filecoin-project/lotus#12937)
• fix: allow users to optionally configure node startup even if index reconciliation fails (filecoin-project/lotus#12930)
• feat: add a LOTUS_DISABLE_F3_ACTIVATION enviroment variable allowing disabling F3 activation for a specific contract address or epoch (filecoin-project/lotus#12920).
• chore: switch to pure-go zstd decoder for snapshot imports. (filecoin-project/lotus#12857)
• chore: upgrade go-state-types with big.Int{} change that means an empty big.Int is now treated as zero for all operations (filecoin-project/lotus#12936)
• chore(eth): make EthGetBlockByNumber & EthGetBlockByHash share the same cache and be impacted by EthBlkCacheSize config settings (filecoin-project/lotus#12979)
• chore(deps): bump go-state-types to v0.16.0-rc8 (filecoin-project/lotus#12973)
• chore: set Mainnet nv25 upgrade epoch and update deps (filecoin-project/lotus#12986)
• chore(eth): make EthGetBlockByNumber & EthGetBlockByHash share cache code (filecoin-project/lotus#12979)

Bug Fixes

• fix(eth): minor improvements to event range checking (filecoin-project/lotus#12867)
• fix(wallet): allow delegated wallet import (filecoin-project/lotus#12876)
• fix: use the correct environment variable (FIL_PROOFS_PARAMETER_CACHE) for proof params path (filecoin-project/lotus#12891)

📝 Changelog

For the set of changes since the last stable release:

• Node: v1.31.1...v1.32.1
• Miner: v1.31.1...miner/v1.32.1

👨‍👩‍👧‍👦 Contributors