Releases: filecoin-project/lotus
v1.34.4-rc1
This is a patch release candidate primarily to include the fr32 fix required for Storage Provider software. All SPs (including Curio SPs) should update to this latest Lotus release.
Bug Fixes
- fix(fr32): Update go-commp-utils to include fr32 fixes for Storage Provider compatibility (filecoin-project/lotus#13455)
📝 Changelog
For the set of changes since the last stable release:
👨👩👧👦 Contributors
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Łukasz Magiera | 1 | +837/-88 | 6 |
| Phi-rjan | 4 | +111/-36 | 25 |
| Phi | 2 | +26/-12 | 12 |
| zjumathcode | 1 | +0/-32 | 32 |
| Luca Moretti | 1 | +7/-7 | 7 |
| bigmoonbit | 1 | +0/-13 | 9 |
| xiaolinny | 1 | +6/-6 | 5 |
| Block Wizard | 1 | +4/-1 | 2 |
| mk0walsk | 1 | +2/-2 | 2 |
| beck | 1 | +2/-1 | 1 |
| Piotr Galar | 1 | +3/-0 | 1 |
| Evan Etton | 1 | +2/-1 | 2 |
miner/v1.34.4-rc1
This is a patch release candidate primarily to include the fr32 fix required for Storage Provider software. All SPs (including Curio SPs) should update to this latest Lotus release.
Bug Fixes
- fix(fr32): Update go-commp-utils to include fr32 fixes for Storage Provider compatibility (filecoin-project/lotus#13455)
📝 Changelog
For the set of changes since the last stable release:
👨👩👧👦 Contributors
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Łukasz Magiera | 1 | +837/-88 | 6 |
| Phi-rjan | 4 | +111/-36 | 25 |
| Phi | 2 | +26/-12 | 12 |
| zjumathcode | 1 | +0/-32 | 32 |
| Luca Moretti | 1 | +7/-7 | 7 |
| bigmoonbit | 1 | +0/-13 | 9 |
| xiaolinny | 1 | +6/-6 | 5 |
| Block Wizard | 1 | +4/-1 | 2 |
| mk0walsk | 1 | +2/-2 | 2 |
| beck | 1 | +2/-1 | 1 |
| Piotr Galar | 1 | +3/-0 | 1 |
| Evan Etton | 1 | +2/-1 | 2 |
v1.34.3
This is a patch release addressing Docker image glibc compatibility errors reported in with the Lotus v1.34.2 release. This update is only necessary for users running Lotus via Docker who encountered GLIBC_2.32/2.33/2.34 not found errors.
Bug Fixes
- fix(docker): upgrade base image from ubuntu:20.04 to ubuntu:22.04 (filecoin-project/lotus#13441)
- The build stage uses golang:1.24.7-bookworm (glibc 2.36), but the runtime base was ubuntu:20.04 (glibc 2.31), causing GLIBC_2.32/2.33/2.34 errors when running lotus binaries.
📝 Changelog
For the set of changes since the last stable release:
v1.34.2
The Lotus and Lotus-Miner v1.34.2 release includes numerous bug fixes, CLI enhancements, and dependency updates. These improvements, along with updated dependencies, enhance the stability and usability of Lotus for both node operators and storage providers.
☢️ Upgrade Warnings ☢️
- The minimum supported Golang version is now
1.24.7
Features and Bug Fixes
- feat(gateway): expose StateGetRandomnessDigestFromBeacon (filecoin-project/lotus#13339)
- fix(cli): add deposit-margin-factor to the new miner commands (filecoin-project/lotus#13365)
- feat(spcli): add a
deposit-margin-factoroption tolotus-miner actor newandlotus-shed miner createso the sent deposit still covers the on-chain requirement if it rises between lookup and execution (filecoin-project/lotus#13407) - feat(cli): lotus evm deploy prints message CID (filecoin-project/lotus#13241)
- fix(miner): ensure sender account exists (filecoin-project/lotus#13348)
- fix(eth): properly return vm error in all gas estimation methods (filecoin-project/lotus#13389)
- chore: all actor cmd support --actor (filecoin-project/lotus#13391)
📝 Changelog
For the set of changes since the last stable release:
👨👩👧👦 Contributors
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Phi-rjan | 11 | +39018/-254 | 240 |
| Rod Vagg | 12 | +793/-656 | 45 |
| dependabot[bot] | 33 | +483/-415 | 69 |
| Jintu Kumar Das | 1 | +372/-372 | 24 |
| Adin Schmahmann | 1 | +525/-53 | 6 |
| Mikers | 1 | +519/-0 | 18 |
| TippyFlits | 6 | +248/-160 | 22 |
| Piotr Galar | 3 | +57/-44 | 14 |
| aceppaluni | 1 | +48/-34 | 3 |
| Block Wizard | 5 | +37/-36 | 18 |
| tediou5 | 2 | +58/-6 | 4 |
| Phi | 2 | +37/-17 | 12 |
| Luca Moretti | 4 | +24/-24 | 18 |
| cui | 1 | +22/-25 | 5 |
| beck | 1 | +13/-22 | 4 |
| Aryan Tikarya | 1 | +21/-14 | 2 |
| parthshah1 | 1 | +11/-23 | 3 |
| 0x5459 | 1 | +28/-4 | 4 |
| fengyuchuanshen | 1 | +7/-7 | 7 |
| web3-bot | 4 | +6/-7 | 5 |
| Steve Loeppky | 1 | +7/-5 | 1 |
| Snezhkko | 1 | +6/-6 | 5 |
| Krishang Shah | 1 | +6/-5 | 1 |
| Lee | 1 | +5/-5 | 1 |
| stemlaud | 1 | +4/-4 | 4 |
| asttool | 1 | +4/-4 | 4 |
| Jakub Sztandera | 1 | +0/-8 | 1 |
| Hubert | 1 | +4/-3 | 3 |
| suranmiao | 1 | +2/-2 | 2 |
| reddaisyy | 1 | +2/-2 | 1 |
| joemicky | 1 | +2/-2 | 1 |
| efcking | 1 | +2/-2 | 1 |
| CertiK | 1 | +2/-1 | 1 |
| wyrapeseed | 1 | +1/-1 | 1 |
| letreturn | 1 | +1/-1 | 1 |
| juejinyuxitu | 1 | +1/-1 | 1 |
| cargoedit | 1 | +1/-1 | 1 |
| asamuj | 1 | +1/-1 | 1 |
| spuradage | 1 | +0/-1 | 1 |
miner/v1.34.2
The Lotus and Lotus-Miner v1.34.2 release includes numerous bug fixes, CLI enhancements, and dependency updates. These improvements, along with updated dependencies, enhance the stability and usability of Lotus for both node operators and storage providers.
☢️ Upgrade Warnings ☢️
- The minimum supported Golang version is now
1.24.7
Features and Bug Fixes
- feat(gateway): expose StateGetRandomnessDigestFromBeacon (filecoin-project/lotus#13339)
- fix(cli): add deposit-margin-factor to the new miner commands (filecoin-project/lotus#13365)
- feat(spcli): add a
deposit-margin-factoroption tolotus-miner actor newandlotus-shed miner createso the sent deposit still covers the on-chain requirement if it rises between lookup and execution (filecoin-project/lotus#13407) - feat(cli): lotus evm deploy prints message CID (filecoin-project/lotus#13241)
- fix(miner): ensure sender account exists (filecoin-project/lotus#13348)
- fix(eth): properly return vm error in all gas estimation methods (filecoin-project/lotus#13389)
- chore: all actor cmd support --actor (filecoin-project/lotus#13391)
📝 Changelog
For the set of changes since the last stable release:
👨👩👧👦 Contributors
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Phi-rjan | 11 | +39018/-254 | 240 |
| Rod Vagg | 12 | +793/-656 | 45 |
| dependabot[bot] | 33 | +483/-415 | 69 |
| Jintu Kumar Das | 1 | +372/-372 | 24 |
| Adin Schmahmann | 1 | +525/-53 | 6 |
| Mikers | 1 | +519/-0 | 18 |
| TippyFlits | 6 | +248/-160 | 22 |
| Piotr Galar | 3 | +57/-44 | 14 |
| aceppaluni | 1 | +48/-34 | 3 |
| Block Wizard | 5 | +37/-36 | 18 |
| tediou5 | 2 | +58/-6 | 4 |
| Phi | 2 | +37/-17 | 12 |
| Luca Moretti | 4 | +24/-24 | 18 |
| cui | 1 | +22/-25 | 5 |
| beck | 1 | +13/-22 | 4 |
| Aryan Tikarya | 1 | +21/-14 | 2 |
| parthshah1 | 1 | +11/-23 | 3 |
| 0x5459 | 1 | +28/-4 | 4 |
| fengyuchuanshen | 1 | +7/-7 | 7 |
| web3-bot | 4 | +6/-7 | 5 |
| Steve Loeppky | 1 | +7/-5 | 1 |
| Snezhkko | 1 | +6/-6 | 5 |
| Krishang Shah | 1 | +6/-5 | 1 |
| Lee | 1 | +5/-5 | 1 |
| stemlaud | 1 | +4/-4 | 4 |
| asttool | 1 | +4/-4 | 4 |
| Jakub Sztandera | 1 | +0/-8 | 1 |
| Hubert | 1 | +4/-3 | 3 |
| suranmiao | 1 | +2/-2 | 2 |
| reddaisyy | 1 | +2/-2 | 1 |
| joemicky | 1 | +2/-2 | 1 |
| efcking | 1 | +2/-2 | 1 |
| CertiK | 1 | +2/-1 | 1 |
| wyrapeseed | 1 | +1/-1 | 1 |
| letreturn | 1 | +1/-1 | 1 |
| juejinyuxitu | 1 | +1/-1 | 1 |
| cargoedit | 1 | +1/-1 | 1 |
| asamuj | 1 | +1/-1 | 1 |
| spuradage | 1 | +0/-1 | 1 |
v1.34.2-rc1
This is the first release candidate of the Lotus and Lotus-Miner v1.34.2, which includes bug fixes, CLI enhancements, and dependency updates. These improvements, along with updated dependencies, enhance the stability and usability of Lotus for both node operators and storage providers.
☢️ Upgrade Warnings ☢️
- The minimum supported Golang version is now
1.24.7
Features and Bug Fixes
- feat(gateway): expose StateGetRandomnessDigestFromBeacon (filecoin-project/lotus#13339)
- fix(cli): add deposit-margin-factor to the new miner commands (filecoin-project/lotus#13365)
- feat(spcli): add a
deposit-margin-factoroption tolotus-miner actor newandlotus-shed miner createso the sent deposit still covers the on-chain requirement if it rises between lookup and execution (filecoin-project/lotus#13407) - feat(cli): lotus evm deploy prints message CID (filecoin-project/lotus#13241)
- fix(miner): ensure sender account exists (filecoin-project/lotus#13348)
- fix(eth): properly return vm error in all gas estimation methods (filecoin-project/lotus#13389)
- chore: all actor cmd support --actor (filecoin-project/lotus#13391)
📝 Changelog
For the set of changes since the last stable release:
👨👩👧👦 Contributors
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Phi-rjan | 11 | +39018/-254 | 240 |
| Rod Vagg | 12 | +793/-656 | 45 |
| dependabot[bot] | 33 | +483/-415 | 69 |
| Jintu Kumar Das | 1 | +372/-372 | 24 |
| Adin Schmahmann | 1 | +525/-53 | 6 |
| Mikers | 1 | +519/-0 | 18 |
| TippyFlits | 6 | +248/-160 | 22 |
| Piotr Galar | 3 | +57/-44 | 14 |
| aceppaluni | 1 | +48/-34 | 3 |
| Block Wizard | 5 | +37/-36 | 18 |
| tediou5 | 2 | +58/-6 | 4 |
| Phi | 2 | +37/-17 | 12 |
| Luca Moretti | 4 | +24/-24 | 18 |
| cui | 1 | +22/-25 | 5 |
| beck | 1 | +13/-22 | 4 |
| Aryan Tikarya | 1 | +21/-14 | 2 |
| parthshah1 | 1 | +11/-23 | 3 |
| 0x5459 | 1 | +28/-4 | 4 |
| fengyuchuanshen | 1 | +7/-7 | 7 |
| web3-bot | 4 | +6/-7 | 5 |
| Steve Loeppky | 1 | +7/-5 | 1 |
| Snezhkko | 1 | +6/-6 | 5 |
| Krishang Shah | 1 | +6/-5 | 1 |
| Lee | 1 | +5/-5 | 1 |
| stemlaud | 1 | +4/-4 | 4 |
| asttool | 1 | +4/-4 | 4 |
| Jakub Sztandera | 1 | +0/-8 | 1 |
| Hubert | 1 | +4/-3 | 3 |
| suranmiao | 1 | +2/-2 | 2 |
| reddaisyy | 1 | +2/-2 | 1 |
| joemicky | 1 | +2/-2 | 1 |
| efcking | 1 | +2/-2 | 1 |
| CertiK | 1 | +2/-1 | 1 |
| wyrapeseed | 1 | +1/-1 | 1 |
| letreturn | 1 | +1/-1 | 1 |
| juejinyuxitu | 1 | +1/-1 | 1 |
| cargoedit | 1 | +1/-1 | 1 |
| asamuj | 1 | +1/-1 | 1 |
| spuradage | 1 | +0/-1 | 1 |
miner/v1.34.2-rc1
This is the first release candidate of the Lotus and Lotus-Miner v1.34.2, which includes bug fixes, CLI enhancements, and dependency updates. These improvements, along with updated dependencies, enhance the stability and usability of Lotus for both node operators and storage providers.
☢️ Upgrade Warnings ☢️
- The minimum supported Golang version is now
1.24.7
Features and Bug Fixes
- feat(gateway): expose StateGetRandomnessDigestFromBeacon (filecoin-project/lotus#13339)
- fix(cli): add deposit-margin-factor to the new miner commands (filecoin-project/lotus#13365)
- feat(spcli): add a
deposit-margin-factoroption tolotus-miner actor newandlotus-shed miner createso the sent deposit still covers the on-chain requirement if it rises between lookup and execution (filecoin-project/lotus#13407) - feat(cli): lotus evm deploy prints message CID (filecoin-project/lotus#13241)
- fix(miner): ensure sender account exists (filecoin-project/lotus#13348)
- fix(eth): properly return vm error in all gas estimation methods (filecoin-project/lotus#13389)
- chore: all actor cmd support --actor (filecoin-project/lotus#13391)
📝 Changelog
For the set of changes since the last stable release:
👨👩👧👦 Contributors
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Phi-rjan | 11 | +39018/-254 | 240 |
| Rod Vagg | 12 | +793/-656 | 45 |
| dependabot[bot] | 33 | +483/-415 | 69 |
| Jintu Kumar Das | 1 | +372/-372 | 24 |
| Adin Schmahmann | 1 | +525/-53 | 6 |
| Mikers | 1 | +519/-0 | 18 |
| TippyFlits | 6 | +248/-160 | 22 |
| Piotr Galar | 3 | +57/-44 | 14 |
| aceppaluni | 1 | +48/-34 | 3 |
| Block Wizard | 5 | +37/-36 | 18 |
| tediou5 | 2 | +58/-6 | 4 |
| Phi | 2 | +37/-17 | 12 |
| Luca Moretti | 4 | +24/-24 | 18 |
| cui | 1 | +22/-25 | 5 |
| beck | 1 | +13/-22 | 4 |
| Aryan Tikarya | 1 | +21/-14 | 2 |
| parthshah1 | 1 | +11/-23 | 3 |
| 0x5459 | 1 | +28/-4 | 4 |
| fengyuchuanshen | 1 | +7/-7 | 7 |
| web3-bot | 4 | +6/-7 | 5 |
| Steve Loeppky | 1 | +7/-5 | 1 |
| Snezhkko | 1 | +6/-6 | 5 |
| Krishang Shah | 1 | +6/-5 | 1 |
| Lee | 1 | +5/-5 | 1 |
| stemlaud | 1 | +4/-4 | 4 |
| asttool | 1 | +4/-4 | 4 |
| Jakub Sztandera | 1 | +0/-8 | 1 |
| Hubert | 1 | +4/-3 | 3 |
| suranmiao | 1 | +2/-2 | 2 |
| reddaisyy | 1 | +2/-2 | 1 |
| joemicky | 1 | +2/-2 | 1 |
| efcking | 1 | +2/-2 | 1 |
| CertiK | 1 | +2/-1 | 1 |
| wyrapeseed | 1 | +1/-1 | 1 |
| letreturn | 1 | +1/-1 | 1 |
| juejinyuxitu | 1 | +1/-1 | 1 |
| cargoedit | 1 | +1/-1 | 1 |
| asamuj | 1 | +1/-1 | 1 |
| spuradage | 1 | +0/-1 | 1 |
v1.34.1
Node and Miner v1.34.1 / 2025-09-15
This is a non-critical patch release that fixes an issue with the Lotus v1.34.0 release where the incorrect version of filecoin-ffi was included. Lotus v1.34.0 used filecoin-ffi v1.34.0-dev when it should have used v1.34.0. This isn’t critical since it’s the same filecoin-ffi version used during the nv27 Calibration network upgrade, but for consistency with other Node implementations like Forest, we are creating this release. This ensures the inclusion of ref-fvm v4.7.3 update that was missing in v1.34.0. All users of v1.34.0 are encouraged to upgrade to v1.34.1.
Node and Miner v1.34.0 / 2025-09-11
This is a MANDATORY Lotus v1.34.0 release, which will deliver the Filecoin network version 27, codenamed “Golden Week” 🏮. This release candidate sets the upgrade epoch for the Mainnet network to Epoch 5348280: 2025-09-24T23:00:00Z. (See the local time for other timezones.)
☢️ Upgrade Warnings ☢️
- All Lotus node and Storage Provider (SP) operators must upgrade to v1.34.x before the specified date for the Mainnet network.
- The
/v1Ethereum APIs have "F3 awareness" for all Ethereum calls where"finalized"or"safe"are supplied. Nodes will likely return different (and likely more recent) results in v1.34.x+ than previous versions when these tags are used. See more info below.
🏛️ Filecoin network version 27 FIPs and FRCs
- FIP-0105: BLS12-381 Precompiles for FEVM (EIP-2537)
- FIP-0109: Smart contract notifications for Direct Data Onboarding (DDO)
- FIP-0077: Add deposit requirement for new miner creation
- FIP-0103: Remove ExtendSectorExpiration method
- FIP-0106: Remove ProveReplicaUpdates method
- FIP-0101: Remove ProveCommitAggregate method
- FRC-0108: F3-compatible snapshots
📦 v17 Builtin Actor Bundle
This release candidate uses v17.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 NV27 upgrade is expected to be light with no heavy pre-migrations:
- Pre-Migration is expected to take less then 1 minute.
- The migration on the upgrade epoch is expected to take less than 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 less then 1 minute.
- RAM usages is expected to be under 20GiB RAM for both the pre-migration and migration.
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(eth): use F3 for "finalized" and "safe" resolution in v1 APIs. This switches the /v1 Ethereum APIs to have the same resolution rules as /v2, enabling F3 awareness for all Ethereum calls where
"finalized"or"safe"is supplied. See F3-aware Ethereum APIs via/v2endpoint and improvements to existing/v1APIs below for details of how the /v2 APIs work as introduced in the 1.33.0 release. Set the environment variableLOTUS_ETH_V1_DISABLE_F3_FINALITY_RESOLUTIONto1to revert this behaviour but note that the option to revert will likely be removed in a future release (tracking issue). (filecoin-project/lotus#13298) - feat(f3): expose simple ChainGetFinalizedTipSet API on v1 (and gateway) that just returns the latest F3 finalized tipset, or falls back to EC finality if F3 is not operational on the node or if the F3 finalized tipset is further back than EC finalized tipset. This API can be used for follow-up state calls that clamp to a specific tipset to have assurance of state finality. (filecoin-project/lotus#13299)
- feat: support for F3-aware snapshot v2 format per FRC-0108 (filecoin-project/lotus#13282)
- snapshot export now defaults to v2 format with embedded F3 finality certificates, dramatically reducing F3 catchup time from ~8 hours
- transparently imports both v1 and v2 snapshot formats
- to export v1 snapshots, use
lotus chain export --skip-old-msgs --recent-stateroots=2001 --snapshot-version=1 <filename>
- feat(net): add LOTUS_ENABLE_MESSAGE_FETCH_INSTRUMENTATION=1 to turn on metrics and debugging for local vs bitswap message fetching during block validation (filecoin-project/lotus#13221)
👌 Improvements
- chore(docs): mark v0 API as "deprecated" and v1 as "stable" (filecoin-project/lotus#13264)
- feat(api): add StateMinerCreationDeposit API method for FIP-0077 - calculates the deposit required for creating a new miner (filecoin-project/lotus#13308)
- feat(spcli): correctly handle the batch logic of
lotus-miner actor settle-deal(#13189) - feat(spcli): add
--all-dealstolotus-miner actor settle-deal(#13243)
🐛 Bug Fixes
- fix: properly handle all RPC API retry errors (#13279)
- fix(api):
eth_getCodeandeth_getStorageAtnow return state after the specified block rather than before it (filecoin-project/lotus#13274) - fix(api):
eth_getTransactionCountnow returns state after the specified block rather than before it (filecoin-project/lotus#13275) - fix: handle partial reads in UnpadReader for non-power-of-2 pieces (filecoin-project/lotus#13306)
📝 Changelog
For the set of changes since the last stable release:
Changes since RC2
- Updated to use final release versions of key dependencies, including builtin-actors. See filecoin-project/lotus#13337).
👨👩👧👦 Contributors
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Rod Vagg | 12 | +1856/-720 | 49 |
| TippyFlits | 6 | +1312/-897 | 60 |
| tediou5 | 1 | +610/-22 | 14 |
| Phi-rjan | 11 | +455/-169 | 29 |
| chris-4chain | 1 | +222/-23 | 7 |
| Steven Allen | 1 | +142/-68 | 3 |
| beck | 2 | +141/-52 | 8 |
| dependabot[bot] | 12 | +81/-86 | 24 |
| Steve Loeppky | 5 | +90/-42 | 22 |
| hanabi1224 | 2 | +91/-24 | 3 |
| raul0ligma | 1 | +88/-4 | 5 |
| William Morriss | 3 | +41/-13 | 7 |
| Copilot | 1 | +46/-0 | 1 |
| deepdring | 1 | +6/-6 | 6 |
| Block Wizard | 3 | +6/-6 | 5 |
| wmypku | 1 | +4/-4 | 2 |
| queryfast | 1 | +4/-4 | 4 |
| minxinyi | 1 | +4/-4 | 4 |
| web3-bot | 2 | +3/-3 | 3 |
| tzchenxixi | 1 | +3/-3 | 3 |
| haouvw | 1 | +3/-3 | 2 |
| TimberLake | 1 | +3/-3 | 2 |
| Jakub Sztandera | 2 | +3/-3 | 3 |
| Micke | 1 | +2/-2 | 2 |
| longhutianjie | 1 | +1/-1 | 1 |
| Piotr Galar | 1 | +1/-1 | 1 |
| Phi | 1 | +1/-1 | 1 |
miner/v1.34.1
Node and Miner v1.34.1 / 2025-09-15
This is a non-critical patch release that fixes an issue with the Lotus v1.34.0 release where the incorrect version of filecoin-ffi was included. Lotus v1.34.0 used filecoin-ffi v1.34.0-dev when it should have used v1.34.0. This isn’t critical since it’s the same filecoin-ffi version used during the nv27 Calibration network upgrade, but for consistency with other Node implementations like Forest, we are creating this release. This ensures the inclusion of ref-fvm v4.7.3 update that was missing in v1.34.0. All users of v1.34.0 are encouraged to upgrade to v1.34.1.
Node and Miner v1.34.0 / 2025-09-11
This is a MANDATORY Lotus v1.34.0 release, which will deliver the Filecoin network version 27, codenamed “Golden Week” 🏮. This release candidate sets the upgrade epoch for the Mainnet network to Epoch 5348280: 2025-09-24T23:00:00Z. (See the local time for other timezones.)
☢️ Upgrade Warnings ☢️
- All Lotus node and Storage Provider (SP) operators must upgrade to v1.34.x before the specified date for the Mainnet network.
- The
/v1Ethereum APIs have "F3 awareness" for all Ethereum calls where"finalized"or"safe"are supplied. Nodes will likely return different (and likely more recent) results in v1.34.x+ than previous versions when these tags are used. See more info below.
🏛️ Filecoin network version 27 FIPs and FRCs
- FIP-0105: BLS12-381 Precompiles for FEVM (EIP-2537)
- FIP-0109: Smart contract notifications for Direct Data Onboarding (DDO)
- FIP-0077: Add deposit requirement for new miner creation
- FIP-0103: Remove ExtendSectorExpiration method
- FIP-0106: Remove ProveReplicaUpdates method
- FIP-0101: Remove ProveCommitAggregate method
- FRC-0108: F3-compatible snapshots
📦 v17 Builtin Actor Bundle
This release candidate uses v17.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 NV27 upgrade is expected to be light with no heavy pre-migrations:
- Pre-Migration is expected to take less then 1 minute.
- The migration on the upgrade epoch is expected to take less than 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 less then 1 minute.
- RAM usages is expected to be under 20GiB RAM for both the pre-migration and migration.
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(eth): use F3 for "finalized" and "safe" resolution in v1 APIs. This switches the /v1 Ethereum APIs to have the same resolution rules as /v2, enabling F3 awareness for all Ethereum calls where
"finalized"or"safe"is supplied. See F3-aware Ethereum APIs via/v2endpoint and improvements to existing/v1APIs below for details of how the /v2 APIs work as introduced in the 1.33.0 release. Set the environment variableLOTUS_ETH_V1_DISABLE_F3_FINALITY_RESOLUTIONto1to revert this behaviour but note that the option to revert will likely be removed in a future release (tracking issue). (filecoin-project/lotus#13298) - feat(f3): expose simple ChainGetFinalizedTipSet API on v1 (and gateway) that just returns the latest F3 finalized tipset, or falls back to EC finality if F3 is not operational on the node or if the F3 finalized tipset is further back than EC finalized tipset. This API can be used for follow-up state calls that clamp to a specific tipset to have assurance of state finality. (filecoin-project/lotus#13299)
- feat: support for F3-aware snapshot v2 format per FRC-0108 (filecoin-project/lotus#13282)
- snapshot export now defaults to v2 format with embedded F3 finality certificates, dramatically reducing F3 catchup time from ~8 hours
- transparently imports both v1 and v2 snapshot formats
- to export v1 snapshots, use
lotus chain export --skip-old-msgs --recent-stateroots=2001 --snapshot-version=1 <filename>
- feat(net): add LOTUS_ENABLE_MESSAGE_FETCH_INSTRUMENTATION=1 to turn on metrics and debugging for local vs bitswap message fetching during block validation (filecoin-project/lotus#13221)
👌 Improvements
- chore(docs): mark v0 API as "deprecated" and v1 as "stable" (filecoin-project/lotus#13264)
- feat(api): add StateMinerCreationDeposit API method for FIP-0077 - calculates the deposit required for creating a new miner (filecoin-project/lotus#13308)
- feat(spcli): correctly handle the batch logic of
lotus-miner actor settle-deal(#13189) - feat(spcli): add
--all-dealstolotus-miner actor settle-deal(#13243)
🐛 Bug Fixes
- fix: properly handle all RPC API retry errors (#13279)
- fix(api):
eth_getCodeandeth_getStorageAtnow return state after the specified block rather than before it (filecoin-project/lotus#13274) - fix(api):
eth_getTransactionCountnow returns state after the specified block rather than before it (filecoin-project/lotus#13275) - fix: handle partial reads in UnpadReader for non-power-of-2 pieces (filecoin-project/lotus#13306)
📝 Changelog
For the set of changes since the last stable release:
Changes since RC2
- Updated to use final release versions of key dependencies, including builtin-actors. See filecoin-project/lotus#13337).
👨👩👧👦 Contributors
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Rod Vagg | 12 | +1856/-720 | 49 |
| TippyFlits | 6 | +1312/-897 | 60 |
| tediou5 | 1 | +610/-22 | 14 |
| Phi-rjan | 11 | +455/-169 | 29 |
| chris-4chain | 1 | +222/-23 | 7 |
| Steven Allen | 1 | +142/-68 | 3 |
| beck | 2 | +141/-52 | 8 |
| dependabot[bot] | 12 | +81/-86 | 24 |
| Steve Loeppky | 5 | +90/-42 | 22 |
| hanabi1224 | 2 | +91/-24 | 3 |
| raul0ligma | 1 | +88/-4 | 5 |
| William Morriss | 3 | +41/-13 | 7 |
| Copilot | 1 | +46/-0 | 1 |
| deepdring | 1 | +6/-6 | 6 |
| Block Wizard | 3 | +6/-6 | 5 |
| wmypku | 1 | +4/-4 | 2 |
| queryfast | 1 | +4/-4 | 4 |
| minxinyi | 1 | +4/-4 | 4 |
| web3-bot | 2 | +3/-3 | 3 |
| tzchenxixi | 1 | +3/-3 | 3 |
| haouvw | 1 | +3/-3 | 2 |
| TimberLake | 1 | +3/-3 | 2 |
| Jakub Sztandera | 2 | +3/-3 | 3 |
| Micke | 1 | +2/-2 | 2 |
| longhutianjie | 1 | +1/-1 | 1 |
| Piotr Galar | 1 | +1/-1 | 1 |
| Phi | 1 | +1/-1 | 1 |
v1.34.0
Node and Miner v1.34.0 / 2025-09-11
This is a MANDATORY Lotus v1.34.0 release, which will deliver the Filecoin network version 27, codenamed “Golden Week” 🏮. This release candidate sets the upgrade epoch for the Mainnet network to Epoch 5348280: 2025-09-24T23:00:00Z. (See the local time for other timezones.)
☢️ Upgrade Warnings ☢️
- All Lotus node and Storage Provider (SP) operators must upgrade to v1.34.x before the specified date for the Mainnet network.
- The
/v1Ethereum APIs have "F3 awareness" for all Ethereum calls where"finalized"or"safe"are supplied. Nodes will likely return different (and likely more recent) results in v1.34.x+ than previous versions when these tags are used. See more info below.
🏛️ Filecoin network version 27 FIPs and FRCs
- FIP-0105: BLS12-381 Precompiles for FEVM (EIP-2537)
- FIP-0109: Smart contract notifications for Direct Data Onboarding (DDO)
- FIP-0077: Add deposit requirement for new miner creation
- FIP-0103: Remove ExtendSectorExpiration method
- FIP-0106: Remove ProveReplicaUpdates method
- FIP-0101: Remove ProveCommitAggregate method
- FRC-0108: F3-compatible snapshots
📦 v17 Builtin Actor Bundle
This release candidate uses v17.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 NV27 upgrade is expected to be light with no heavy pre-migrations:
- Pre-Migration is expected to take less then 1 minute.
- The migration on the upgrade epoch is expected to take less than 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 less then 1 minute.
- RAM usages is expected to be under 20GiB RAM for both the pre-migration and migration.
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(eth): use F3 for "finalized" and "safe" resolution in v1 APIs. This switches the /v1 Ethereum APIs to have the same resolution rules as /v2, enabling F3 awareness for all Ethereum calls where
"finalized"or"safe"is supplied. See F3-aware Ethereum APIs via/v2endpoint and improvements to existing/v1APIs below for details of how the /v2 APIs work as introduced in the 1.33.0 release. Set the environment variableLOTUS_ETH_V1_DISABLE_F3_FINALITY_RESOLUTIONto1to revert this behaviour but note that the option to revert will likely be removed in a future release (tracking issue). (filecoin-project/lotus#13298) - feat(f3): expose simple ChainGetFinalizedTipSet API on v1 (and gateway) that just returns the latest F3 finalized tipset, or falls back to EC finality if F3 is not operational on the node or if the F3 finalized tipset is further back than EC finalized tipset. This API can be used for follow-up state calls that clamp to a specific tipset to have assurance of state finality. (filecoin-project/lotus#13299)
- feat: support for F3-aware snapshot v2 format per FRC-0108 (filecoin-project/lotus#13282)
- snapshot export now defaults to v2 format with embedded F3 finality certificates, dramatically reducing F3 catchup time from ~8 hours
- transparently imports both v1 and v2 snapshot formats
- to export v1 snapshots, use
lotus chain export --skip-old-msgs --recent-stateroots=2001 --snapshot-version=1 <filename>
- feat(net): add LOTUS_ENABLE_MESSAGE_FETCH_INSTRUMENTATION=1 to turn on metrics and debugging for local vs bitswap message fetching during block validation (filecoin-project/lotus#13221)
👌 Improvements
- chore(docs): mark v0 API as "deprecated" and v1 as "stable" (filecoin-project/lotus#13264)
- feat(api): add StateMinerCreationDeposit API method for FIP-0077 - calculates the deposit required for creating a new miner (filecoin-project/lotus#13308)
- feat(spcli): correctly handle the batch logic of
lotus-miner actor settle-deal(#13189) - feat(spcli): add
--all-dealstolotus-miner actor settle-deal(#13243)
🐛 Bug Fixes
- fix: properly handle all RPC API retry errors (#13279)
- fix(api):
eth_getCodeandeth_getStorageAtnow return state after the specified block rather than before it (filecoin-project/lotus#13274) - fix(api):
eth_getTransactionCountnow returns state after the specified block rather than before it (filecoin-project/lotus#13275) - fix: handle partial reads in UnpadReader for non-power-of-2 pieces (filecoin-project/lotus#13306)
📝 Changelog
For the set of changes since the last stable release:
Changes since RC2
- Updated to use final release versions of key dependencies, including builtin-actors. See filecoin-project/lotus#13337).
👨👩👧👦 Contributors
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Rod Vagg | 12 | +1856/-720 | 49 |
| TippyFlits | 6 | +1312/-897 | 60 |
| tediou5 | 1 | +610/-22 | 14 |
| Phi-rjan | 11 | +455/-169 | 29 |
| chris-4chain | 1 | +222/-23 | 7 |
| Steven Allen | 1 | +142/-68 | 3 |
| beck | 2 | +141/-52 | 8 |
| dependabot[bot] | 12 | +81/-86 | 24 |
| Steve Loeppky | 5 | +90/-42 | 22 |
| hanabi1224 | 2 | +91/-24 | 3 |
| raul0ligma | 1 | +88/-4 | 5 |
| William Morriss | 3 | +41/-13 | 7 |
| Copilot | 1 | +46/-0 | 1 |
| deepdring | 1 | +6/-6 | 6 |
| Block Wizard | 3 | +6/-6 | 5 |
| wmypku | 1 | +4/-4 | 2 |
| queryfast | 1 | +4/-4 | 4 |
| minxinyi | 1 | +4/-4 | 4 |
| web3-bot | 2 | +3/-3 | 3 |
| tzchenxixi | 1 | +3/-3 | 3 |
| haouvw | 1 | +3/-3 | 2 |
| TimberLake | 1 | +3/-3 | 2 |
| Jakub Sztandera | 2 | +3/-3 | 3 |
| Micke | 1 | +2/-2 | 2 |
| longhutianjie | 1 | +1/-1 | 1 |
| Piotr Galar | 1 | +1/-1 | 1 |
| Phi | 1 | +1/-1 | 1 |