Releases: filecoin-project/lotus
v1.33.1
This is the Lotus v1.33.1 release, which introduces performance improvements and operational enhancements. This release focuses on improving F3 subsystem performance, and enhancing CLI tools for better storage provider operations. Notable improvements include up to 6-10x performance gains in F3 power table calculations, ensuring that PreCommit and ProveCommit operations are aggregating to get optimal gas usage after FIP-100, and a enhanced sector management tool with CSV output support. These improvements collectively enhance the stability and efficiency of Lotus operations for both node operators and storage providers.
☢️ Upgrade Warnings ☢️
- There are no upgrade warnings for this release candidate.
⭐ Feature/Improvement Highlights:
- fix(cli): fix
lotus state sector
command to display DealIDs correctly post-FIP-0076 by querying market actor's ProviderSectors HAMT while maintaining backward compatibility with DeprecatedDealIDs field (filecoin-project/lotus#13140) - feat(spcli): make settle-deal optionally take deal id ranges (filecoin-project/lotus#13146)
- feat(miner): Adjust PreCommit & ProveCommit logic for optimal nv25 gas usage: (filecoin-project/lotus#13049)
- remove deprecated pre-nv25 code, including batch balancer calculations
- default to PreCommit batching
- default to ProveCommit aggregation
- remove config options: AggregateCommits, AggregateAboveBaseFee, BatchPreCommitAboveBaseFee
- feat(paych): add EnablePaymentChannelManager config option and disable payment channel manager by default (filecoin-project/lotus#13139)
- feat(gateway): add CORS headers if --cors is provided (filecoin-project/lotus#13145)
- feat(f3): move go-f3 datastore to separate leveldb instance (filecoin-project/lotus#13174)
lotus state active-sectors
now outputs CSV format and supports an optional--show-partitions
to list active sector deadlines and partitions. (filecoin-project/lotus#13152)- feat: ExpectedRewardForPower builtin utility function and
lotus-shed miner expected-reward
CLI command (filecoin-project/lotus#13138) - feat(api): update go-f3 to 0.8.8, add F3GetPowerTableByInstance to the API (filecoin-project/lotus#13201)
- feat(f3): integrate cached MapReduce from go-hamt-ipld, which improves performance of F3 power table calculation by 6-10x (filecoin-project/lotus#13134)
🐛 Bug Fix Highlights
- fix(cli): correctly construct the TerminateSectors params (filecoin-project/lotus#13207)
- fix(spcli): send SettleDealPayments msg to f05 for
lotus-miner actor settle-deal
(filecoin-project/lotus#13142) - fix(cli): handle disabled payment channel manager gracefully in lotus info command (filecoin-project/lotus#13198)
- chore: disable F3 participation via gateway (filecoin-project/lotus#13123
- fix(cli): make lotus-miner sectors extend command resilient to higher gas (filecoin-project/lotus#11928)
- fix(cli): use F3GetPowerTableByInstance to resolve F3 power tables by default,
--by-tipset
flag can be used to restore old behavior (filecoin-project/lotus#13201) - fix(f3): properly wire up eth v2 APIs for f3 (filecoin-project/lotus#13149)
- chore: increase the F3 GMessage buffer size to 1024 (filecoin-project/lotus#13126)
- chore: bump the pubsub validation queue length to 256 (filecoin-project/lotus#13176)
- chore(deps): update of critical underlying dependencies with go-libp2p to v0.42.0 (#13190) and boxo to v0.32.0 (filecoin-project/lotus#13202) and boxo v0.33.0(filecoin-project/lotus#13226)
- feat(spcli): correctly handle the batch logic of
lotus-miner actor settle-deal
; replace the dealid data source (filecoin-project/lotus#13189)
📝 Changelog
For the full set of changes since the last stable release:
👨👩👧👦 Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
TippyFlits | 6 | +38440/-212 | 201 |
Masih H. Derkani | 32 | +10241/-3770 | 171 |
Jakub Sztandera | 33 | +2823/-1753 | 146 |
Rod Vagg | 17 | +2089/-238 | 67 |
Steven Allen | 7 | +885/-741 | 15 |
Steve Loeppky | 8 | +389/-395 | 29 |
hanabi1224 | 1 | +533/-8 | 5 |
Phi-rjan | 8 | +346/-169 | 37 |
Sarkazein | 3 | +364/-53 | 14 |
tediou5 | 4 | +48/-318 | 29 |
Barbara Peric | 5 | +315/-24 | 12 |
beck | 3 | +116/-89 | 8 |
dependabot[bot] | 21 | +92/-90 | 42 |
Łukasz Magiera | 1 | +173/-0 | 2 |
Copilot | 2 | +106/-66 | 5 |
Krishang Shah | 1 | +113/-0 | 5 |
Piotr Galar | 3 | +47/-3 | 6 |
Phi | 1 | +12/-12 | 11 |
terry.hung | 1 | +15/-6 | 1 |
Degen Dev | 2 | +8/-8 | 6 |
bytesingsong | 1 | +7/-7 | 6 |
Anna Smith | 1 | +7/-7 | 4 |
Aida Syoko | 1 | +6/-6 | 5 |
cuithon | 1 | +5/-5 | 5 |
shandongzhejiang | 1 | +4/-4 | 4 |
geekvest | 1 | +4/-4 | 3 |
Block Wizard | 1 | +4/-4 | 3 |
bytetigers | 1 | +3/-3 | 3 |
ZenGround0 | 1 | +2/-3 | 1 |
web3-bot | 2 | +2/-2 | 2 |
findmyhappy | 1 | +2/-2 | 1 |
emmmm | 1 | +2/-2 | 2 |
dumikau | 1 | +2/-2 | 2 |
David Klank | 1 | +2/-2 | 1 |
gopherorg | 1 | +1/-1 | 1 |
VolodymyrBg | 1 | +1/-1 | 1 |
Hubert | 1 | +1/-1 | 1 |
GarmashAlex | 1 | +1/-1 | 1 |
James Niken | 1 | +0/-1 | 1 |
miner/v1.33.1
This is the Lotus v1.33.1 release, which introduces performance improvements and operational enhancements. This release focuses on improving F3 subsystem performance, and enhancing CLI tools for better storage provider operations. Notable improvements include up to 6-10x performance gains in F3 power table calculations, ensuring that PreCommit and ProveCommit operations are aggregating to get optimal gas usage after FIP-100, and a enhanced sector management tool with CSV output support. These improvements collectively enhance the stability and efficiency of Lotus operations for both node operators and storage providers.
☢️ Upgrade Warnings ☢️
- There are no upgrade warnings for this release candidate.
⭐ Feature/Improvement Highlights:
- fix(cli): fix
lotus state sector
command to display DealIDs correctly post-FIP-0076 by querying market actor's ProviderSectors HAMT while maintaining backward compatibility with DeprecatedDealIDs field (filecoin-project/lotus#13140) - feat(spcli): make settle-deal optionally take deal id ranges (filecoin-project/lotus#13146)
- feat(miner): Adjust PreCommit & ProveCommit logic for optimal nv25 gas usage: (filecoin-project/lotus#13049)
- remove deprecated pre-nv25 code, including batch balancer calculations
- default to PreCommit batching
- default to ProveCommit aggregation
- remove config options: AggregateCommits, AggregateAboveBaseFee, BatchPreCommitAboveBaseFee
- feat(paych): add EnablePaymentChannelManager config option and disable payment channel manager by default (filecoin-project/lotus#13139)
- feat(gateway): add CORS headers if --cors is provided (filecoin-project/lotus#13145)
- feat(f3): move go-f3 datastore to separate leveldb instance (filecoin-project/lotus#13174)
lotus state active-sectors
now outputs CSV format and supports an optional--show-partitions
to list active sector deadlines and partitions. (filecoin-project/lotus#13152)- feat: ExpectedRewardForPower builtin utility function and
lotus-shed miner expected-reward
CLI command (filecoin-project/lotus#13138) - feat(api): update go-f3 to 0.8.8, add F3GetPowerTableByInstance to the API (filecoin-project/lotus#13201)
- feat(f3): integrate cached MapReduce from go-hamt-ipld, which improves performance of F3 power table calculation by 6-10x (filecoin-project/lotus#13134)
🐛 Bug Fix Highlights
- fix(cli): correctly construct the TerminateSectors params (filecoin-project/lotus#13207)
- fix(spcli): send SettleDealPayments msg to f05 for
lotus-miner actor settle-deal
(filecoin-project/lotus#13142) - fix(cli): handle disabled payment channel manager gracefully in lotus info command (filecoin-project/lotus#13198)
- chore: disable F3 participation via gateway (filecoin-project/lotus#13123
- fix(cli): make lotus-miner sectors extend command resilient to higher gas (filecoin-project/lotus#11928)
- fix(cli): use F3GetPowerTableByInstance to resolve F3 power tables by default,
--by-tipset
flag can be used to restore old behavior (filecoin-project/lotus#13201) - fix(f3): properly wire up eth v2 APIs for f3 (filecoin-project/lotus#13149)
- chore: increase the F3 GMessage buffer size to 1024 (filecoin-project/lotus#13126)
- chore: bump the pubsub validation queue length to 256 (filecoin-project/lotus#13176)
- chore(deps): update of critical underlying dependencies with go-libp2p to v0.42.0 (#13190) and boxo to v0.32.0 (filecoin-project/lotus#13202) and boxo v0.33.0(filecoin-project/lotus#13226)
- feat(spcli): correctly handle the batch logic of
lotus-miner actor settle-deal
; replace the dealid data source (filecoin-project/lotus#13189)
📝 Changelog
For the full set of changes since the last stable release:
👨👩👧👦 Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
TippyFlits | 6 | +38440/-212 | 201 |
Masih H. Derkani | 32 | +10241/-3770 | 171 |
Jakub Sztandera | 33 | +2823/-1753 | 146 |
Rod Vagg | 17 | +2089/-238 | 67 |
Steven Allen | 7 | +885/-741 | 15 |
Steve Loeppky | 8 | +389/-395 | 29 |
hanabi1224 | 1 | +533/-8 | 5 |
Phi-rjan | 8 | +346/-169 | 37 |
Sarkazein | 3 | +364/-53 | 14 |
tediou5 | 4 | +48/-318 | 29 |
Barbara Peric | 5 | +315/-24 | 12 |
beck | 3 | +116/-89 | 8 |
dependabot[bot] | 21 | +92/-90 | 42 |
Łukasz Magiera | 1 | +173/-0 | 2 |
Copilot | 2 | +106/-66 | 5 |
Krishang Shah | 1 | +113/-0 | 5 |
Piotr Galar | 3 | +47/-3 | 6 |
Phi | 1 | +12/-12 | 11 |
terry.hung | 1 | +15/-6 | 1 |
Degen Dev | 2 | +8/-8 | 6 |
bytesingsong | 1 | +7/-7 | 6 |
Anna Smith | 1 | +7/-7 | 4 |
Aida Syoko | 1 | +6/-6 | 5 |
cuithon | 1 | +5/-5 | 5 |
shandongzhejiang | 1 | +4/-4 | 4 |
geekvest | 1 | +4/-4 | 3 |
Block Wizard | 1 | +4/-4 | 3 |
bytetigers | 1 | +3/-3 | 3 |
ZenGround0 | 1 | +2/-3 | 1 |
web3-bot | 2 | +2/-2 | 2 |
findmyhappy | 1 | +2/-2 | 1 |
emmmm | 1 | +2/-2 | 2 |
dumikau | 1 | +2/-2 | 2 |
David Klank | 1 | +2/-2 | 1 |
gopherorg | 1 | +1/-1 | 1 |
VolodymyrBg | 1 | +1/-1 | 1 |
Hubert | 1 | +1/-1 | 1 |
GarmashAlex | 1 | +1/-1 | 1 |
James Niken | 1 | +0/-1 | 1 |
v1.33.1-rc1
This is the first release candidate of Lotus v1.33.1, which introduces performance improvements and operational enhancements. This release focuses on improving F3 subsystem performance, and enhancing CLI tools for better storage provider operations. Notable improvements include up to 6-10x performance gains in F3 power table calculations, as well as ensuring that PreCommit and ProveCommit operations are aggregating to get optimal gas usage after FIP-100, and a enhanced sector management tool with CSV output support. These improvements collectively enhance the stability and efficiency of Lotus operations for both node operators and storage providers.
☢️ Upgrade Warnings ☢️
- There are no upgrade warnings for this release candidate.
⭐ Feature/Improvement Highlights:
- fix(cli): fix
lotus state sector
command to display DealIDs correctly post-FIP-0076 by querying market actor's ProviderSectors HAMT while maintaining backward compatibility with DeprecatedDealIDs field (filecoin-project/lotus#13140) - feat(spcli): make settle-deal optionally take deal id ranges (filecoin-project/lotus#13146)
- feat(miner): Adjust PreCommit & ProveCommit logic for optimal nv25 gas usage: (filecoin-project/lotus#13049)
- remove deprecated pre-nv25 code, including batch balancer calculations
- default to PreCommit batching
- default to ProveCommit aggregation
- remove config options: AggregateCommits, AggregateAboveBaseFee, BatchPreCommitAboveBaseFee
- feat(paych): add EnablePaymentChannelManager config option and disable payment channel manager by default (filecoin-project/lotus#13139)
- feat(gateway): add CORS headers if --cors is provided (filecoin-project/lotus#13145)
- feat(f3): move go-f3 datastore to separate leveldb instance (filecoin-project/lotus#13174)
lotus state active-sectors
now outputs CSV format and supports an optional--show-partitions
to list active sector deadlines and partitions. (filecoin-project/lotus#13152)- feat: ExpectedRewardForPower builtin utility function and
lotus-shed miner expected-reward
CLI command (filecoin-project/lotus#13138) - feat(api): update go-f3 to 0.8.8, add F3GetPowerTableByInstance to the API (filecoin-project/lotus#13201)
- feat(f3): integrate cached MapReduce from go-hamt-ipld, which improves performance of F3 power table calculation by 6-10x (filecoin-project/lotus#13134)
🐛 Bug Fix Highlights
- fix(cli): correctly construct the TerminateSectors params (filecoin-project/lotus#13207)
- fix(spcli): send SettleDealPayments msg to f05 for
lotus-miner actor settle-deal
(filecoin-project/lotus#13142) - fix(cli): handle disabled payment channel manager gracefully in lotus info command (filecoin-project/lotus#13198)
- chore: disable F3 participation via gateway (filecoin-project/lotus#13123
- fix(cli): make lotus-miner sectors extend command resilient to higher gas (filecoin-project/lotus#11928)
- fix(cli): use F3GetPowerTableByInstance to resolve F3 power tables by default,
--by-tipset
flag can be used to restore old behavior (filecoin-project/lotus#13201) - fix(f3): properly wire up eth v2 APIs for f3 (filecoin-project/lotus#13149)
- chore: increase the F3 GMessage buffer size to 1024 (filecoin-project/lotus#13126)
- chore: bump the pubsub validation queue length to 256 (filecoin-project/lotus#13176)
- chore(deps): update of critical underlying dependencies with go-libp2p to v0.42.0 (#13190) and boxo to v0.32.0 (filecoin-project/lotus#13202) and boxo v0.33.0(filecoin-project/lotus#13226)
📝 Changelog
For the full set of changes since the last stable release:
👨👩👧👦 Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
TippyFlits | 6 | +38440/-212 | 201 |
Masih H. Derkani | 32 | +10241/-3770 | 171 |
Jakub Sztandera | 26 | +2557/-1617 | 127 |
Rod Vagg | 17 | +2089/-238 | 67 |
Steven Allen | 7 | +885/-741 | 15 |
Steve Loeppky | 8 | +389/-395 | 29 |
Sarkazein | 3 | +364/-53 | 14 |
tediou5 | 4 | +48/-318 | 29 |
Barbara Peric | 5 | +315/-24 | 12 |
beck | 3 | +116/-89 | 8 |
Phi-rjan | 3 | +115/-69 | 14 |
dependabot[bot] | 21 | +92/-90 | 42 |
Łukasz Magiera | 1 | +173/-0 | 2 |
Copilot | 2 | +106/-66 | 5 |
Krishang Shah | 1 | +113/-0 | 5 |
Phi | 2 | +42/-31 | 12 |
Piotr Galar | 4 | +54/-3 | 7 |
terry.hung | 1 | +15/-6 | 1 |
Degen Dev | 2 | +8/-8 | 6 |
bytesingsong | 1 | +7/-7 | 6 |
Anna Smith | 1 | +7/-7 | 4 |
Aida Syoko | 1 | +6/-6 | 5 |
cuithon | 1 | +5/-5 | 5 |
shandongzhejiang | 1 | +4/-4 | 4 |
geekvest | 1 | +4/-4 | 3 |
Block Wizard | 1 | +4/-4 | 3 |
bytetigers | 1 | +3/-3 | 3 |
ZenGround0 | 1 | +2/-3 | 1 |
web3-bot | 2 | +2/-2 | 2 |
findmyhappy | 1 | +2/-2 | 1 |
emmmm | 1 | +2/-2 | 2 |
dumikau | 1 | +2/-2 | 2 |
David Klank | 1 | +2/-2 | 1 |
gopherorg | 1 | +1/-1 | 1 |
VolodymyrBg | 1 | +1/-1 | 1 |
Hubert | 1 | +1/-1 | 1 |
GarmashAlex | 1 | +1/-1 | 1 |
James Niken | 1 | +0/-1 | 1 |
miner/v1.33.1-rc1
This is the first release candidate of Lotus v1.33.1, which introduces performance improvements and operational enhancements. This release focuses on improving F3 subsystem performance, and enhancing CLI tools for better storage provider operations. Notable improvements include up to 6-10x performance gains in F3 power table calculations, as well as ensuring that PreCommit and ProveCommit operations are aggregating to get optimal gas usage after FIP-100, and a enhanced sector management tool with CSV output support. These improvements collectively enhance the stability and efficiency of Lotus operations for both node operators and storage providers.
☢️ Upgrade Warnings ☢️
- There are no upgrade warnings for this release candidate.
⭐ Feature/Improvement Highlights:
- fix(cli): fix
lotus state sector
command to display DealIDs correctly post-FIP-0076 by querying market actor's ProviderSectors HAMT while maintaining backward compatibility with DeprecatedDealIDs field (filecoin-project/lotus#13140) - feat(spcli): make settle-deal optionally take deal id ranges (filecoin-project/lotus#13146)
- feat(miner): Adjust PreCommit & ProveCommit logic for optimal nv25 gas usage: (filecoin-project/lotus#13049)
- remove deprecated pre-nv25 code, including batch balancer calculations
- default to PreCommit batching
- default to ProveCommit aggregation
- remove config options: AggregateCommits, AggregateAboveBaseFee, BatchPreCommitAboveBaseFee
- feat(paych): add EnablePaymentChannelManager config option and disable payment channel manager by default (filecoin-project/lotus#13139)
- feat(gateway): add CORS headers if --cors is provided (filecoin-project/lotus#13145)
- feat(f3): move go-f3 datastore to separate leveldb instance (filecoin-project/lotus#13174)
lotus state active-sectors
now outputs CSV format and supports an optional--show-partitions
to list active sector deadlines and partitions. (filecoin-project/lotus#13152)- feat: ExpectedRewardForPower builtin utility function and
lotus-shed miner expected-reward
CLI command (filecoin-project/lotus#13138) - feat(api): update go-f3 to 0.8.8, add F3GetPowerTableByInstance to the API (filecoin-project/lotus#13201)
- feat(f3): integrate cached MapReduce from go-hamt-ipld, which improves performance of F3 power table calculation by 6-10x (filecoin-project/lotus#13134)
🐛 Bug Fix Highlights
- fix(cli): correctly construct the TerminateSectors params (filecoin-project/lotus#13207)
- fix(spcli): send SettleDealPayments msg to f05 for
lotus-miner actor settle-deal
(filecoin-project/lotus#13142) - fix(cli): handle disabled payment channel manager gracefully in lotus info command (filecoin-project/lotus#13198)
- chore: disable F3 participation via gateway (filecoin-project/lotus#13123
- fix(cli): make lotus-miner sectors extend command resilient to higher gas (filecoin-project/lotus#11928)
- fix(cli): use F3GetPowerTableByInstance to resolve F3 power tables by default,
--by-tipset
flag can be used to restore old behavior (filecoin-project/lotus#13201) - fix(f3): properly wire up eth v2 APIs for f3 (filecoin-project/lotus#13149)
- chore: increase the F3 GMessage buffer size to 1024 (filecoin-project/lotus#13126)
- chore: bump the pubsub validation queue length to 256 (filecoin-project/lotus#13176)
- chore(deps): update of critical underlying dependencies with go-libp2p to v0.42.0 (#13190) and boxo to v0.32.0 (filecoin-project/lotus#13202) and boxo v0.33.0(filecoin-project/lotus#13226)
📝 Changelog
For the full set of changes since the last stable release:
👨👩👧👦 Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
TippyFlits | 6 | +38440/-212 | 201 |
Masih H. Derkani | 32 | +10241/-3770 | 171 |
Jakub Sztandera | 26 | +2557/-1617 | 127 |
Rod Vagg | 17 | +2089/-238 | 67 |
Steven Allen | 7 | +885/-741 | 15 |
Steve Loeppky | 8 | +389/-395 | 29 |
Sarkazein | 3 | +364/-53 | 14 |
tediou5 | 4 | +48/-318 | 29 |
Barbara Peric | 5 | +315/-24 | 12 |
beck | 3 | +116/-89 | 8 |
Phi-rjan | 3 | +115/-69 | 14 |
dependabot[bot] | 21 | +92/-90 | 42 |
Łukasz Magiera | 1 | +173/-0 | 2 |
Copilot | 2 | +106/-66 | 5 |
Krishang Shah | 1 | +113/-0 | 5 |
Phi | 2 | +42/-31 | 12 |
Piotr Galar | 4 | +54/-3 | 7 |
terry.hung | 1 | +15/-6 | 1 |
Degen Dev | 2 | +8/-8 | 6 |
bytesingsong | 1 | +7/-7 | 6 |
Anna Smith | 1 | +7/-7 | 4 |
Aida Syoko | 1 | +6/-6 | 5 |
cuithon | 1 | +5/-5 | 5 |
shandongzhejiang | 1 | +4/-4 | 4 |
geekvest | 1 | +4/-4 | 3 |
Block Wizard | 1 | +4/-4 | 3 |
bytetigers | 1 | +3/-3 | 3 |
ZenGround0 | 1 | +2/-3 | 1 |
web3-bot | 2 | +2/-2 | 2 |
findmyhappy | 1 | +2/-2 | 1 |
emmmm | 1 | +2/-2 | 2 |
dumikau | 1 | +2/-2 | 2 |
David Klank | 1 | +2/-2 | 1 |
gopherorg | 1 | +1/-1 | 1 |
VolodymyrBg | 1 | +1/-1 | 1 |
Hubert | 1 | +1/-1 | 1 |
GarmashAlex | 1 | +1/-1 | 1 |
James Niken | 1 | +0/-1 | 1 |
v1.33.0
The Lotus v1.33.0 release introduces experimental v2 APIs with F3 awareness, featuring a new TipSet selection mechanism that significantly enhances how applications interact with the Filecoin blockchain. This release candidate also adds F3-aware Ethereum APIs via the /v2 endpoint. All of the /v2 APIs implement intelligent fallback mechanisms between F3 and Expected Consensus and are exposed through the Lotus Gateway.
Please review the detailed documentation for these experimental APIs, as they are subject to change and have important operational considerations for node operators and API providers.
☢️ Upgrade Warnings ☢️
- There are no upgrade warnings for this release candidate.
⭐ Feature/Improvement Highlights:
Experimental v2 APIs with F3 awareness
The Lotus V2 APIs introduce a powerful new TipSet selection mechanism that significantly enhances how applications interact with the Filecoin blockchain. The design reduces API footprint, seamlessly handles both traditional Expected Consensus (EC) and the new F3 protocol, and provides graceful fallbacks.
Note
V2 APIs are highly experimental and subject to change without notice.
See Filecoin v2 APIs docs for an in-depth overview. /v2 APIs are exosed through Lotus Gateway.
This work was primarily done in (filecoin-project/lotus#13003), (filecoin-project/lotus#13027), (filecoin-project/lotus#13034), (filecoin-project/lotus#13075), (filecoin-project/lotus#13066)
F3-aware Ethereum APIs via /v2
endpoint and improvements to existing /v1
APIs
Lotus now offers two versions of its Ethereum-compatible APIs (eth_*
, trace_*
, net_*
, web3_*
and associated Filecoin.*
APIs including Filecoin-specific functions such as Filecoin.EthAddressToFilecoinAddress
and Filecoin.FilecoinAddressToEthAddress
) with different finality handling:
/v2
APIs (New & Experimental): These APIs consult the F3 subsystem (if enabled) for finality information."finalized"
tag maps to the F3 finalized epoch."safe"
tag maps to the F3 finalized epoch or 200 epochs behind head, whichever is more recent.
/v1
APIs (Existing & Recommended): These maintain behavior closer to pre-F3 Lotus (EC finality) for compatibility."finalized"
tag continues to use a fixed 900-epoch delay from the head (EC finality)."safe"
tag uses a 30-epoch delay from the head.- One or both of these tags may be adjusted in a future upgrade to take advantage of F3 finality.
- Note: Previously,
"finalized"
and"safe"
tags referred to epochsN-1
. This-1
offset has been removed in both V1 and V2. - Additional improvements affecting both
/v1
and/v2
Ethereum APIs:eth_getBlockTransactionCountByNumber
now accepts standard Ethereum block specifiers (hex numbers or tags like"latest"
,"safe"
,"finalized"
).- Methods accepting
BlockNumberOrHash
now support all standard tags ("pending"
,"latest"
,"safe"
,"finalized"
). This includeseth_estimateGas
,eth_call
,eth_getCode
,eth_getStorageAt
,eth_getBalance
,eth_getTransactionCount
, andeth_getBlockReceipts
. - Removed internal
Eth*Limited
methods (e.g.,EthGetTransactionByHashLimited
) from the supported gateway API surface. - Improved error handling: block selection endpoints now consistently return
ErrNullRound
(and corresponding JSONRPC errors) for null tipsets.
This work was done in (filecoin-project/lotus#13026), (filecoin-project/lotus#13070).
Others
- feat: add gas to application metric reporting
vm/applyblocks_early_gas
,vm/applyblocks_messages_gas
,vm/applyblocks_cron_gas
(filecoin-project/lotus#13030) - feat(metrics): capture total gas metric from ApplyBlocks (filecoin-project/lotus#13037)
- feat: add F3 Grafana Dashboard Template (filecoin-project/lotus#12934)
- fix(f3): limit the concurrency of F3 power table calculation (filecoin-project/lotus#13085)
- feat(f3): remove dynnamic manifest functionality and use static manifest (filecoin-project/lotus#13074)
🐛 Bug Fix Highlights
- fix(eth): apply limit in EthGetBlockReceiptsLimited (filecoin-project/lotus#12883)
- fix(eth): always return nil for eth transactions not found (filecoin-project/lotus#12999)
- fix(deps): fix Ledger hardware wallet support (filecoin-project/lotus#13048)
📝 Changelog
For the full set of changes since the last stable release:
👨👩👧👦 Contributors
Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
Rod Vagg | 19 | +13805/-3639 | 129 |
Masih H. Derkani | 19 | +11910/-2369 | 119 |
Jakub Sztandera | 14 | +2528/-202 | 32 |
Phi-rjan | 12 | +1707/-79 | 42 |
Steve Loeppky | 3 | +1287/-32 | 8 |
Piotr Galar | 2 | +298/-3 | 4 |
Barbara Peric | 3 | +182/-73 | 5 |
ZenGround0 | 1 | +191/-0 | 4 |
CoolCu | 1 | +15/-49 | 6 |
Volker Mische | 1 | +18/-31 | 5 |
Phi | 3 | +32/-14 | 10 |
dependabot[bot] | 1 | +15/-15 | 2 |
Amit Gaikwad | 1 | +19/-2 | 2 |
tom | 1 | +0/-14 | 2 |
xixishidibei | 1 | +2/-11 | 1 |
Tomass | 1 | +4/-4 | 2 |
tsinghuacoder | 1 | +3/-2 | 1 |
dropbigfish | 1 | +1/-1 | 1 |
James Niken | 1 | +1/-1 | 1 |
Hubert | 1 | +1/-0 | 1 |
Steven Allen | 1 | +0/-0 | 2 |
v1.33.0-rc1
The Lotus v1.33.0-rc1 release introduces experimental v2 APIs with F3 awareness, featuring a new TipSet selection mechanism that significantly enhances how applications interact with the Filecoin blockchain. This release candidate also adds F3-aware Ethereum APIs via the /v2 endpoint. All of the /v2 APIs implement intelligent fallback mechanisms between F3 and Expected Consensus and are exposed through the Lotus Gateway.
Please review the detailed documentation for these experimental APIs, as they are subject to change and have important operational considerations for node operators and API providers.
☢️ Upgrade Warnings ☢️
- There are no upgrade warnings for this release candidate.
⭐ Feature/Improvement Highlights:
Experimental v2 APIs with F3 awareness
The Lotus V2 APIs introduce a powerful new TipSet selection mechanism that significantly enhances how applications interact with the Filecoin blockchain. The design reduces API footprint, seamlessly handles both traditional Expected Consensus (EC) and the new F3 protocol, and provides graceful fallbacks.
Note
V2 APIs are highly experimental and subject to change without notice.
See Filecoin v2 APIs docs for an in-depth overview. /v2 APIs are exosed through Lotus Gateway.
This work was primarily done in (filecoin-project/lotus#13003), (filecoin-project/lotus#13027), (filecoin-project/lotus#13034), (filecoin-project/lotus#13075), (filecoin-project/lotus#13066)
F3-aware Ethereum APIs via /v2
endpoint and improvements to existing /v1
APIs
Lotus now offers two versions of its Ethereum-compatible APIs (eth_*
, trace_*
, net_*
, web3_*
and associated Filecoin.*
APIs including Filecoin-specific functions such as Filecoin.EthAddressToFilecoinAddress
and Filecoin.FilecoinAddressToEthAddress
) with different finality handling:
/v2
APIs (New & Experimental): These APIs consult the F3 subsystem (if enabled) for finality information."finalized"
tag maps to the F3 finalized epoch."safe"
tag maps to the F3 finalized epoch or 200 epochs behind head, whichever is more recent.
/v1
APIs (Existing & Recommended): These maintain behavior closer to pre-F3 Lotus (EC finality) for compatibility."finalized"
tag continues to use a fixed 900-epoch delay from the head (EC finality)."safe"
tag uses a 30-epoch delay from the head.- One or both of these tags may be adjusted in a future upgrade to take advantage of F3 finality.
- Note: Previously,
"finalized"
and"safe"
tags referred to epochsN-1
. This-1
offset has been removed in both V1 and V2. - Additional improvements affecting both
/v1
and/v2
Ethereum APIs:eth_getBlockTransactionCountByNumber
now accepts standard Ethereum block specifiers (hex numbers or tags like"latest"
,"safe"
,"finalized"
).- Methods accepting
BlockNumberOrHash
now support all standard tags ("pending"
,"latest"
,"safe"
,"finalized"
). This includeseth_estimateGas
,eth_call
,eth_getCode
,eth_getStorageAt
,eth_getBalance
,eth_getTransactionCount
, andeth_getBlockReceipts
. - Removed internal
Eth*Limited
methods (e.g.,EthGetTransactionByHashLimited
) from the supported gateway API surface. - Improved error handling: block selection endpoints now consistently return
ErrNullRound
(and corresponding JSONRPC errors) for null tipsets.
This work was done in (filecoin-project/lotus#13026), (filecoin-project/lotus#13070).
Others
- feat: add gas to application metric reporting
vm/applyblocks_early_gas
,vm/applyblocks_messages_gas
,vm/applyblocks_cron_gas
(filecoin-project/lotus#13030) - feat(metrics): capture total gas metric from ApplyBlocks (filecoin-project/lotus#13037)
- feat: add F3 Grafana Dashboard Template (filecoin-project/lotus#12934)
- fix(f3): limit the concurrency of F3 power table calculation (filecoin-project/lotus#13085)
- feat(f3): remove dynnamic manifest functionality and use static manifest (filecoin-project/lotus#13074)
🐛 Bug Fix Highlights
- fix(eth): apply limit in EthGetBlockReceiptsLimited (filecoin-project/lotus#12883)
- fix(eth): always return nil for eth transactions not found (filecoin-project/lotus#12999)
- fix(deps): fix Ledger hardware wallet support (filecoin-project/lotus#13048)
📝 Changelog
For the full set of changes since the last stable release:
👨👩👧👦 Contributors
Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
Rod Vagg | 19 | +13805/-3639 | 129 |
Masih H. Derkani | 19 | +11910/-2369 | 119 |
Jakub Sztandera | 14 | +2528/-202 | 32 |
Phi-rjan | 12 | +1707/-79 | 42 |
Steve Loeppky | 3 | +1287/-32 | 8 |
Piotr Galar | 2 | +298/-3 | 4 |
Barbara Peric | 3 | +182/-73 | 5 |
ZenGround0 | 1 | +191/-0 | 4 |
CoolCu | 1 | +15/-49 | 6 |
Volker Mische | 1 | +18/-31 | 5 |
Phi | 3 | +32/-14 | 10 |
dependabot[bot] | 1 | +15/-15 | 2 |
Amit Gaikwad | 1 | +19/-2 | 2 |
tom | 1 | +0/-14 | 2 |
xixishidibei | 1 | +2/-11 | 1 |
Tomass | 1 | +4/-4 | 2 |
tsinghuacoder | 1 | +3/-2 | 1 |
dropbigfish | 1 | +1/-1 | 1 |
James Niken | 1 | +1/-1 | 1 |
Hubert | 1 | +1/-0 | 1 |
Steven Allen | 1 | +0/-0 | 2 |
v1.32.3
This Node v1.32.3 patch release contains a critical update for all node operators. This release ensures that the F3 initial power table CID is correctly set in your Lotus node now that F3 is activated on Mainnet. All node operators must upgrade to this release before their next node restart to ensure proper F3 functionality.
☢️ Upgrade Warnings ☢️
- All node operators must upgrade to this release before their next node restart to ensure proper F3 functionality. Storage providers only needs to upgrade their Lotus chain node to this release.
📝 Changelog
- feat: set F3 initial power table for mainnet (filecoin-project/lotus#13077)
For the set of changes since the last stable release:
- Node: v1.31.2...v1.32.3
Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
Jakub Sztandera | 1 | +7/-5 | 2 |
Phi | 1 | +2/-2 | 1 |
miner/v1.32.3
This Node v1.32.3 patch release contains a critical update for all node operators. This release ensures that the F3 initial power table CID is correctly set in your Lotus node now that F3 is activated on Mainnet. All node operators must upgrade to this release before their next node restart to ensure proper F3 functionality.
☢️ Upgrade Warnings ☢️
- All node operators must upgrade to this release before their next node restart to ensure proper F3 functionality. Storage providers only needs to upgrade their Lotus chain node to this release.
📝 Changelog
- feat: set F3 initial power table for mainnet (filecoin-project/lotus#13077)
For the set of changes since the last stable release:
- Node: v1.31.2...v1.32.3
Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
Jakub Sztandera | 1 | +7/-5 | 2 |
Phi | 1 | +2/-2 | 1 |
v1.32.2
This Lotus v1.32.2 release is a MANDATORY patch release. After the Calibration network upgraded to nv25, a bug was discovered in the ref-fvm KAMT library affecting ERC-20 token minting operations. You can read the the full techincal breakdown of the issue here.
This patch release includes the following updates:
- Schedules a mandatory Calibration upgrade, happening on
2025-04-07T23:00:00Z
, to fix the ERC-20 token minting bug on the Calibration network. - Postpones the mandatory Mainnet nv25 upgrade by 4 days, to
2025-04-14T23:00:00Z
☢️ Upgrade Warnings ☢️
- All Lotus node and Storage Provider (SP) operators must upgrade to this patch release before the specified dates for the Calibration and Mainnet networks.
- Please check the upgrade warning section for the v1.32.1 release for more upgrade warnings if you are upgrading from a version prior to v1.32.0.
🏛️ 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.1
🚚 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.
Bug Fixes and Chores
- feat!: actors bundle v16.0.1 & special handling for calibnet (filecoin-project/lotus#13006).
- chore: update new Mainnet nv25 date to 2025-04-14T23:00:00Z (filecoin-project/lotus#13007).
- chore: make TockFix epoch for 2k network configurable (filecoin-project/lotus#13008).
- chore(deps): update filecoin-ffi (filecoin-project/lotus#13011).
📝 Changelog
For the set of changes since the last stable release:
- Node: v1.31.1...v1.32.2
- Miner: v1.31.1...miner/v1.32.2
miner/v1.32.2
This Lotus v1.32.2 release is a MANDATORY patch release. After the Calibration network upgraded to nv25, a bug was discovered in the ref-fvm KAMT library affecting ERC-20 token minting operations. You can read the the full techincal breakdown of the issue here.
This patch release includes the following updates:
- Schedules a mandatory Calibration upgrade, happening on
2025-04-07T23:00:00Z
, to fix the ERC-20 token minting bug on the Calibration network. - Postpones the mandatory Mainnet nv25 upgrade by 4 days, to
2025-04-14T23:00:00Z
☢️ Upgrade Warnings ☢️
- All Lotus node and Storage Provider (SP) operators must upgrade to this patch release before the specified dates for the Calibration and Mainnet networks.
- Please check the upgrade warning section for the v1.32.1 release for more upgrade warnings if you are upgrading from a version prior to v1.32.0.
🏛️ 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.1
🚚 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.
Bug Fixes and Chores
- feat!: actors bundle v16.0.1 & special handling for calibnet (filecoin-project/lotus#13006).
- chore: update new Mainnet nv25 date to 2025-04-14T23:00:00Z (filecoin-project/lotus#13007).
- chore: make TockFix epoch for 2k network configurable (filecoin-project/lotus#13008).
- chore(deps): update filecoin-ffi (filecoin-project/lotus#13011).
📝 Changelog
For the set of changes since the last stable release:
- Node: v1.31.1...v1.32.2
- Miner: v1.31.1...miner/v1.32.2