Releases: filecoin-project/lotus
v1.34.0-rc2
This is the second release candidate of the upcoming 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 calibration network to Epoch 3007294: 2025-09-10T23:00:00Z. (See the local time for other timezones.)
This RC is required for participation in the nv27 calibration upgrade.
You can follow filecoin-project/lotus#13269 for keeping up with the other expected release dates, epochs, and updates.
Note
This release candidate does NOT set the mainnet network upgrade epoch. It will be added in the final release (expected 2025-09-11).
☢️ Upgrade Warnings ☢️
- All Lotus node and Storage Provider (SP) operators must upgrade to v1.34.x before the specified dates for the Calibration and Mainnet networks.
- The
/v1
Ethereum 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-rc1.
🚚 Migration
There is no pre-migration or migration with this network upgrade.
⭐ 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/v2
endpoint and improvements to existing/v1
APIs 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_RESOLUTION
to1
to 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-deals
tolotus-miner actor settle-deal
(#13243)
🐛 Bug Fixes
- fix: properly handle all RPC API retry errors (#13279)
- fix(api):
eth_getCode
andeth_getStorageAt
now return state after the specified block rather than before it (filecoin-project/lotus#13274) - fix(api):
eth_getTransactionCount
now 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 RC1
- Using actors bundle v17.0.0-rc1 instead of v17.0.0-dev1.
- Backported: fix: handle partial reads in UnpadReader for non-power-of-2 pieces (filecoin-project/lotus#13306)
👨👩👧👦 Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
Rod Vagg | 11 | +1780/-717 | 47 |
TippyFlits | 2 | +1058/-734 | 32 |
tediou5 | 1 | +610/-22 | 14 |
chris-4chain | 1 | +222/-23 | 7 |
Steven Allen | 1 | +142/-68 | 3 |
beck | 2 | +141/-52 | 8 |
Phi-rjan | 7 | +114/-75 | 20 |
dependabot[bot] | 12 | +81/-86 | 24 |
Steve Loeppky | 7 | +132/-29 | 7 |
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 |
miner/v1.34.0-rc2
This is the second release candidate of the upcoming 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 calibration network to Epoch 3007294: 2025-09-10T23:00:00Z. (See the local time for other timezones.)
This RC is required for participation in the nv27 calibration upgrade.
You can follow filecoin-project/lotus#13269 for keeping up with the other expected release dates, epochs, and updates.
Note
This release candidate does NOT set the mainnet network upgrade epoch. It will be added in the final release (expected 2025-09-11).
☢️ Upgrade Warnings ☢️
- All Lotus node and Storage Provider (SP) operators must upgrade to v1.34.x before the specified dates for the Calibration and Mainnet networks.
- The
/v1
Ethereum 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-rc1.
🚚 Migration
There is no pre-migration or migration with this network upgrade.
⭐ 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/v2
endpoint and improvements to existing/v1
APIs 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_RESOLUTION
to1
to 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-deals
tolotus-miner actor settle-deal
(#13243)
🐛 Bug Fixes
- fix: properly handle all RPC API retry errors (#13279)
- fix(api):
eth_getCode
andeth_getStorageAt
now return state after the specified block rather than before it (filecoin-project/lotus#13274) - fix(api):
eth_getTransactionCount
now 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 RC1
- Using actors bundle v17.0.0-rc1 instead of v17.0.0-dev1.
- Backported: fix: handle partial reads in UnpadReader for non-power-of-2 pieces (filecoin-project/lotus#13306)
👨👩👧👦 Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
Rod Vagg | 11 | +1780/-717 | 47 |
TippyFlits | 2 | +1058/-734 | 32 |
tediou5 | 1 | +610/-22 | 14 |
chris-4chain | 1 | +222/-23 | 7 |
Steven Allen | 1 | +142/-68 | 3 |
beck | 2 | +141/-52 | 8 |
Phi-rjan | 7 | +114/-75 | 20 |
dependabot[bot] | 12 | +81/-86 | 24 |
Steve Loeppky | 7 | +132/-29 | 7 |
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 |
v1.34.0-rc1
Node and Miner v1.34.0-rc1 / 2025-09-04
This is the first release candidate of the upcoming 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 calibration network to Epoch 3007294: 2025-09-10T23:00:00Z. (See the local time for other timezones.)
You can follow filecoin-project/lotus#13269 for keeping up with the other expected release dates, epochs, and updates.
Note
This release candidate does NOT set the mainnet network upgrade epoch. It will be added in the final release (expected 2025-09-11).
☢️ Upgrade Warnings ☢️
- All Lotus node and Storage Provider (SP) operators must upgrade to v1.34.x before the specified dates for the Calibration and Mainnet networks.
- The
/v1
Ethereum 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-dev1.
🚚 Migration
There is no pre-migration or migration with this network upgrade.
⭐ 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/v2
endpoint and improvements to existing/v1
APIs 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_RESOLUTION
to1
to 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-deals
tolotus-miner actor settle-deal
(#13243)
🐛 Bug Fixes
- fix: properly handle all RPC API retry errors (#13279)
- fix(api):
eth_getCode
andeth_getStorageAt
now return state after the specified block rather than before it (filecoin-project/lotus#13274) - fix(api):
eth_getTransactionCount
now returns state after the specified block rather than before it (filecoin-project/lotus#13275)
📝 Changelog
For the set of changes since the last stable release:
👨👩👧👦 Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
Rod Vagg | 11 | +1780/-717 | 47 |
TippyFlits | 2 | +1058/-734 | 32 |
tediou5 | 1 | +610/-22 | 14 |
chris-4chain | 1 | +222/-23 | 7 |
Steven Allen | 1 | +142/-68 | 3 |
beck | 2 | +141/-52 | 8 |
Phi-rjan | 7 | +114/-75 | 20 |
dependabot[bot] | 12 | +81/-86 | 24 |
Steve Loeppky | 7 | +132/-29 | 7 |
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 |
miner/v1.34.0-rc1
Node and Miner v1.34.0-rc1 / 2025-09-04
This is the first release candidate of the upcoming 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 calibration network to Epoch 3007294: 2025-09-10T23:00:00Z. (See the local time for other timezones.)
You can follow filecoin-project/lotus#13269 for keeping up with the other expected release dates, epochs, and updates.
Note
This release candidate does NOT set the mainnet network upgrade epoch. It will be added in the final release (expected 2025-09-11).
☢️ Upgrade Warnings ☢️
- All Lotus node and Storage Provider (SP) operators must upgrade to v1.34.x before the specified dates for the Calibration and Mainnet networks.
- The
/v1
Ethereum 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-dev1.
🚚 Migration
There is no pre-migration or migration with this network upgrade.
⭐ 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/v2
endpoint and improvements to existing/v1
APIs 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_RESOLUTION
to1
to 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-deals
tolotus-miner actor settle-deal
(#13243)
🐛 Bug Fixes
- fix: properly handle all RPC API retry errors (#13279)
- fix(api):
eth_getCode
andeth_getStorageAt
now return state after the specified block rather than before it (filecoin-project/lotus#13274) - fix(api):
eth_getTransactionCount
now returns state after the specified block rather than before it (filecoin-project/lotus#13275)
📝 Changelog
For the set of changes since the last stable release:
👨👩👧👦 Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
Rod Vagg | 11 | +1780/-717 | 47 |
TippyFlits | 2 | +1058/-734 | 32 |
tediou5 | 1 | +610/-22 | 14 |
chris-4chain | 1 | +222/-23 | 7 |
Steven Allen | 1 | +142/-68 | 3 |
beck | 2 | +141/-52 | 8 |
Phi-rjan | 7 | +114/-75 | 20 |
dependabot[bot] | 12 | +81/-86 | 24 |
Steve Loeppky | 7 | +132/-29 | 7 |
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 |
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 |