Releases: filecoin-project/lotus
v1.30.0-rc2
This is the second release candidate of the upcoming MANDATORY Lotus v1.30.0 release, which will deliver the Filecoin network version 24, codenamed Tuk Tuk 🛺. This release candidate sets the calibration network upgrade to epoch 207879
, which corresponds to 2024-10-23T13:30:00Z
. F3 is set to be automatically activated one day later at epoch 2081674
, which corresponds to 2024-10-24T13:30:00Z
.
Note
- This release candidate does NOT set the mainnet network upgrade epoch. It will be added in the final release (expected October 30th).
- You can follow this release issue for keeping up with the release dates, epochs, and updates: #12480
☢️ Upgrade Warnings ☢️
- If you are running the v1.28.x version of Lotus, please go through the Upgrade Warnings section for the v1.28.* releases and v1.29.*, before upgrading to this RC.
- This release requires a minimum Go version of v1.22.7 or higher.
- The
releases
branch has been deprecated with the 202408 split of 'Lotus Node' and 'Lotus Miner'. See https://github.com/filecoin-project/lotus/blob/master/LOTUS_RELEASE_FLOW.md#why-is-the-releases-branch-deprecated-and-what-are-alternatives for more info and alternatives for getting the latest release for both the 'Lotus Node' and 'Lotus Miner' based on the Branch and Tag Strategy.- To get the latest Lotus Node tag: git tag -l 'v*' | sort -V -r | head -n 1
- To get the latest Lotus Miner tag: git tag -l 'miner/v*' | sort -V -r | head -n 1
🏛️ Filecoin network version 24 FIPs
- FIP-0081: Introduce lower bound for sector initial pledge
- FIP-0086: Fast Finality in Filecoin (F3)
- FIP-0094: Add Support for EIP-5656 (MCOPY Opcode) in the FEVM
- FIP-0095: Add FEVM precompile to fetch beacon digest from chain history
📦 v15 Builtin Actor Bundle
This release candidate uses the v15.0.0-rc1
🚚 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 NV24 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.
📝 Changelog
For the set of changes since the last stable release:
- Node: v1.29.2...v1.30.0-rc2
- Miner: v1.28.3...miner/v1.30.0-rc2
👨👩👧👦 Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
Krishang | 2 | +34106/-0 | 109 |
Rod Vagg | 86 | +10643/-8291 | 456 |
Masih H. Derkani | 59 | +7700/-4725 | 298 |
Steven Allen | 55 | +6113/-3169 | 272 |
kamuik16 | 7 | +4618/-1333 | 285 |
Jakub Sztandera | 10 | +3995/-1226 | 94 |
Peter Rabbitson | 26 | +2313/-2718 | 275 |
Viraj Bhartiya | 5 | +2624/-580 | 50 |
Phi | 7 | +1337/-1519 | 257 |
Mikers | 1 | +1274/-455 | 23 |
Phi-rjan | 29 | +736/-600 | 92 |
Andrew Jackson (Ajax) | 3 | +732/-504 | 75 |
LexLuthr | 3 | +167/-996 | 8 |
Aarsh Shah | 12 | +909/-177 | 47 |
web3-bot | 40 | +445/-550 | 68 |
Piotr Galar | 6 | +622/-372 | 15 |
aarshkshah1992 | 18 | +544/-299 | 40 |
Steve Loeppky | 14 | +401/-196 | 22 |
Frrist | 1 | +403/-22 | 5 |
Łukasz Magiera | 4 | +266/-27 | 13 |
winniehere | 1 | +146/-144 | 3 |
Jon | 1 | +209/-41 | 4 |
Aryan Tikarya | 2 | +183/-8 | 7 |
adlrocha | 2 | +123/-38 | 21 |
dependabot[bot] | 11 | +87/-61 | 22 |
Jiaying Wang | 8 | +61/-70 | 12 |
Ian Davis | 2 | +60/-38 | 5 |
Aayush Rajasekaran | 2 | +81/-3 | 3 |
hanabi1224 | 4 | +46/-4 | 5 |
Laurent Senta | 1 | +44/-1 | 2 |
jennijuju | 6 | +21/-20 | 17 |
parthshah1 | 1 | +23/-13 | 1 |
Brendan O'Brien | 1 | +25/-10 | 2 |
Jennifer Wang | 4 | +24/-8 | 6 |
Matthew Rothenberg | 3 | +10/-18 | 6 |
riskrose | 1 | +8/-8 | 7 |
linghuying | 1 | +5/-5 | 5 |
fsgerse | 2 | +3/-7 | 3 |
PolyMa | 1 | +5/-5 | 5 |
zhangguanzhang | 1 | +3/-3 | 2 |
luozexuan | 1 | +3/-3 | 3 |
Po-Chun Chang | 1 | +6/-0 | 2 |
Kevin Martin | 1 | +4/-1 | 2 |
simlecode | 1 | +2/-2 | 2 |
ZenGround0 | 1 | +2/-2 | 2 |
GFZRZK | 1 | +2/-1 | 1 |
DemoYeti | 1 | +2/-1 | 1 |
qwdsds | 1 | +1/-1 | 1 |
Samuel Arogbonlo | 1 | +2/-0 | 2 |
Elias Rad | 1 | +1/-1 | 1 |
miner/v1.30.0-rc2
This is the second release candidate of the upcoming MANDATORY Lotus v1.30.0 release, which will deliver the Filecoin network version 24, codenamed Tuk Tuk 🛺. This release candidate sets the calibration network upgrade to epoch 207879
, which corresponds to 2024-10-23T13:30:00Z
. F3 is set to be automatically activated one day later at epoch 2081674
, which corresponds to 2024-10-24T13:30:00Z
.
Note
- This release candidate does NOT set the mainnet network upgrade epoch. It will be added in the final release (expected October 30th).
- You can follow this release issue for keeping up with the release dates, epochs, and updates: #12480
☢️ Upgrade Warnings ☢️
- If you are running the v1.28.x version of Lotus, please go through the Upgrade Warnings section for the v1.28.* releases and v1.29.*, before upgrading to this RC.
- This release requires a minimum Go version of v1.22.7 or higher.
- The
releases
branch has been deprecated with the 202408 split of 'Lotus Node' and 'Lotus Miner'. See https://github.com/filecoin-project/lotus/blob/master/LOTUS_RELEASE_FLOW.md#why-is-the-releases-branch-deprecated-and-what-are-alternatives for more info and alternatives for getting the latest release for both the 'Lotus Node' and 'Lotus Miner' based on the Branch and Tag Strategy.- To get the latest Lotus Node tag: git tag -l 'v*' | sort -V -r | head -n 1
- To get the latest Lotus Miner tag: git tag -l 'miner/v*' | sort -V -r | head -n 1
🏛️ Filecoin network version 24 FIPs
- FIP-0081: Introduce lower bound for sector initial pledge
- FIP-0086: Fast Finality in Filecoin (F3)
- FIP-0094: Add Support for EIP-5656 (MCOPY Opcode) in the FEVM
- FIP-0095: Add FEVM precompile to fetch beacon digest from chain history
📦 v15 Builtin Actor Bundle
This release candidate uses the v15.0.0-rc1
🚚 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 NV24 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.
📝 Changelog
For the set of changes since the last stable release:
- Node: v1.29.2...v1.30.0-rc2
- Miner: v1.28.3...miner/v1.30.0-rc2
👨👩👧👦 Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
Krishang | 2 | +34106/-0 | 109 |
Rod Vagg | 86 | +10643/-8291 | 456 |
Masih H. Derkani | 59 | +7700/-4725 | 298 |
Steven Allen | 55 | +6113/-3169 | 272 |
kamuik16 | 7 | +4618/-1333 | 285 |
Jakub Sztandera | 10 | +3995/-1226 | 94 |
Peter Rabbitson | 26 | +2313/-2718 | 275 |
Viraj Bhartiya | 5 | +2624/-580 | 50 |
Phi | 7 | +1337/-1519 | 257 |
Mikers | 1 | +1274/-455 | 23 |
Phi-rjan | 29 | +736/-600 | 92 |
Andrew Jackson (Ajax) | 3 | +732/-504 | 75 |
LexLuthr | 3 | +167/-996 | 8 |
Aarsh Shah | 12 | +909/-177 | 47 |
web3-bot | 40 | +445/-550 | 68 |
Piotr Galar | 6 | +622/-372 | 15 |
aarshkshah1992 | 18 | +544/-299 | 40 |
Steve Loeppky | 14 | +401/-196 | 22 |
Frrist | 1 | +403/-22 | 5 |
Łukasz Magiera | 4 | +266/-27 | 13 |
winniehere | 1 | +146/-144 | 3 |
Jon | 1 | +209/-41 | 4 |
Aryan Tikarya | 2 | +183/-8 | 7 |
adlrocha | 2 | +123/-38 | 21 |
dependabot[bot] | 11 | +87/-61 | 22 |
Jiaying Wang | 8 | +61/-70 | 12 |
Ian Davis | 2 | +60/-38 | 5 |
Aayush Rajasekaran | 2 | +81/-3 | 3 |
hanabi1224 | 4 | +46/-4 | 5 |
Laurent Senta | 1 | +44/-1 | 2 |
jennijuju | 6 | +21/-20 | 17 |
parthshah1 | 1 | +23/-13 | 1 |
Brendan O'Brien | 1 | +25/-10 | 2 |
Jennifer Wang | 4 | +24/-8 | 6 |
Matthew Rothenberg | 3 | +10/-18 | 6 |
riskrose | 1 | +8/-8 | 7 |
linghuying | 1 | +5/-5 | 5 |
fsgerse | 2 | +3/-7 | 3 |
PolyMa | 1 | +5/-5 | 5 |
zhangguanzhang | 1 | +3/-3 | 2 |
luozexuan | 1 | +3/-3 | 3 |
Po-Chun Chang | 1 | +6/-0 | 2 |
Kevin Martin | 1 | +4/-1 | 2 |
simlecode | 1 | +2/-2 | 2 |
ZenGround0 | 1 | +2/-2 | 2 |
GFZRZK | 1 | +2/-1 | 1 |
DemoYeti | 1 | +2/-1 | 1 |
qwdsds | 1 | +1/-1 | 1 |
Samuel Arogbonlo | 1 | +2/-0 | 2 |
Elias Rad | 1 | +1/-1 | 1 |
v1.30.0-rc1
This is the first release candidate of the upcoming MANDATORY Lotus v1.30.0 release, which will deliver the Filecoin network version 24, codenamed Tuk Tuk 🛺.
Note
- This release candidate does NOT set a calibration network upgrade epoch. It will be added in the second release candidate (expected October 14th).
- This release candidate does NOT set the mainnet network upgrade epoch. It will be added in the final release (expected October 30th).
- You can follow this release issue for keeping up with the release dates, epochs, and updates: #12480
☢️ Upgrade Warnings ☢️
- If you are running the v1.28.x version of Lotus, please go through the Upgrade Warnings section for the v1.28.* releases and v1.29.*, before upgrading to this RC.
- This release requires a minimum Go version of v1.22.7 or higher.
- The
releases
branch has been deprecated with the 202408 split of 'Lotus Node' and 'Lotus Miner'. See https://github.com/filecoin-project/lotus/blob/master/LOTUS_RELEASE_FLOW.md#why-is-the-releases-branch-deprecated-and-what-are-alternatives for more info and alternatives for getting the latest release for both the 'Lotus Node' and 'Lotus Miner' based on the Branch and Tag Strategy.- To get the latest Lotus Node tag: git tag -l 'v*' | sort -V -r | head -n 1
- To get the latest Lotus Miner tag: git tag -l 'miner/v*' | sort -V -r | head -n 1
🏛️ Filecoin network version 24 FIPs
- FIP-0081: Introduce lower bound for sector initial pledge
- FIP-0086: Fast Finality in Filecoin (F3)
- FIP-0094: Add Support for EIP-5656 (MCOPY Opcode) in the FEVM
- FIP-0095: Add FEVM precompile to fetch beacon digest from chain history
📦 v15 Builtin Actor Bundle
This release candidate uses the v15.0.0-rc1
🚚 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 NV24 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.
📝 Changelog
For the set of changes since the last stable release:
- Node: v1.29.2...v1.30.0-rc1
- Miner: v1.28.3...miner/v1.30.0-rc1
👨👩👧👦 Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
Krishang | 2 | +34106/-0 | 109 |
Rod Vagg | 86 | +10643/-8291 | 456 |
Masih H. Derkani | 59 | +7700/-4725 | 298 |
Steven Allen | 55 | +6113/-3169 | 272 |
kamuik16 | 7 | +4618/-1333 | 285 |
Jakub Sztandera | 10 | +3995/-1226 | 94 |
Peter Rabbitson | 26 | +2313/-2718 | 275 |
Viraj Bhartiya | 5 | +2624/-580 | 50 |
Phi | 7 | +1337/-1519 | 257 |
Mikers | 1 | +1274/-455 | 23 |
Phi-rjan | 29 | +736/-600 | 92 |
Andrew Jackson (Ajax) | 3 | +732/-504 | 75 |
LexLuthr | 3 | +167/-996 | 8 |
Aarsh Shah | 12 | +909/-177 | 47 |
web3-bot | 40 | +445/-550 | 68 |
Piotr Galar | 6 | +622/-372 | 15 |
aarshkshah1992 | 18 | +544/-299 | 40 |
Steve Loeppky | 14 | +401/-196 | 22 |
Frrist | 1 | +403/-22 | 5 |
Łukasz Magiera | 4 | +266/-27 | 13 |
winniehere | 1 | +146/-144 | 3 |
Jon | 1 | +209/-41 | 4 |
Aryan Tikarya | 2 | +183/-8 | 7 |
adlrocha | 2 | +123/-38 | 21 |
dependabot[bot] | 11 | +87/-61 | 22 |
Jiaying Wang | 8 | +61/-70 | 12 |
Ian Davis | 2 | +60/-38 | 5 |
Aayush Rajasekaran | 2 | +81/-3 | 3 |
hanabi1224 | 4 | +46/-4 | 5 |
Laurent Senta | 1 | +44/-1 | 2 |
jennijuju | 6 | +21/-20 | 17 |
parthshah1 | 1 | +23/-13 | 1 |
Brendan O'Brien | 1 | +25/-10 | 2 |
Jennifer Wang | 4 | +24/-8 | 6 |
Matthew Rothenberg | 3 | +10/-18 | 6 |
riskrose | 1 | +8/-8 | 7 |
linghuying | 1 | +5/-5 | 5 |
fsgerse | 2 | +3/-7 | 3 |
PolyMa | 1 | +5/-5 | 5 |
zhangguanzhang | 1 | +3/-3 | 2 |
luozexuan | 1 | +3/-3 | 3 |
Po-Chun Chang | 1 | +6/-0 | 2 |
Kevin Martin | 1 | +4/-1 | 2 |
simlecode | 1 | +2/-2 | 2 |
ZenGround0 | 1 | +2/-2 | 2 |
GFZRZK | 1 | +2/-1 | 1 |
DemoYeti | 1 | +2/-1 | 1 |
qwdsds | 1 | +1/-1 | 1 |
Samuel Arogbonlo | 1 | +2/-0 | 2 |
Elias Rad | 1 | +1/-1 | 1 |
miner/v1.30.0-rc1
This is the first release candidate of the upcoming MANDATORY Lotus v1.30.0 release, which will deliver the Filecoin network version 24, codenamed Tuk Tuk 🛺.
Note
- This release candidate does NOT set a calibration network upgrade epoch. It will be added in the second release candidate (expected October 14th).
- This release candidate does NOT set the mainnet network upgrade epoch. It will be added in the final release (expected October 30th).
- You can follow this release issue for keeping up with the release dates, epochs, and updates: #12480
☢️ Upgrade Warnings ☢️
- If you are running the v1.28.x version of Lotus, please go through the Upgrade Warnings section for the v1.28.* releases and v1.29.*, before upgrading to this RC.
- This release requires a minimum Go version of v1.22.7 or higher.
- The
releases
branch has been deprecated with the 202408 split of 'Lotus Node' and 'Lotus Miner'. See https://github.com/filecoin-project/lotus/blob/master/LOTUS_RELEASE_FLOW.md#why-is-the-releases-branch-deprecated-and-what-are-alternatives for more info and alternatives for getting the latest release for both the 'Lotus Node' and 'Lotus Miner' based on the Branch and Tag Strategy.- To get the latest Lotus Node tag: git tag -l 'v*' | sort -V -r | head -n 1
- To get the latest Lotus Miner tag: git tag -l 'miner/v*' | sort -V -r | head -n 1
🏛️ Filecoin network version 24 FIPs
- FIP-0081: Introduce lower bound for sector initial pledge
- FIP-0086: Fast Finality in Filecoin (F3)
- FIP-0094: Add Support for EIP-5656 (MCOPY Opcode) in the FEVM
- FIP-0095: Add FEVM precompile to fetch beacon digest from chain history
📦 v15 Builtin Actor Bundle
This release candidate uses the v15.0.0-rc1
🚚 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 NV24 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.
📝 Changelog
For the set of changes since the last stable release:
- Node: v1.29.2...v1.30.0-rc1
- Miner: v1.28.3...miner/v1.30.0-rc1
👨👩👧👦 Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
Krishang | 2 | +34106/-0 | 109 |
Rod Vagg | 86 | +10643/-8291 | 456 |
Masih H. Derkani | 59 | +7700/-4725 | 298 |
Steven Allen | 55 | +6113/-3169 | 272 |
kamuik16 | 7 | +4618/-1333 | 285 |
Jakub Sztandera | 10 | +3995/-1226 | 94 |
Peter Rabbitson | 26 | +2313/-2718 | 275 |
Viraj Bhartiya | 5 | +2624/-580 | 50 |
Phi | 7 | +1337/-1519 | 257 |
Mikers | 1 | +1274/-455 | 23 |
Phi-rjan | 29 | +736/-600 | 92 |
Andrew Jackson (Ajax) | 3 | +732/-504 | 75 |
LexLuthr | 3 | +167/-996 | 8 |
Aarsh Shah | 12 | +909/-177 | 47 |
web3-bot | 40 | +445/-550 | 68 |
Piotr Galar | 6 | +622/-372 | 15 |
aarshkshah1992 | 18 | +544/-299 | 40 |
Steve Loeppky | 14 | +401/-196 | 22 |
Frrist | 1 | +403/-22 | 5 |
Łukasz Magiera | 4 | +266/-27 | 13 |
winniehere | 1 | +146/-144 | 3 |
Jon | 1 | +209/-41 | 4 |
Aryan Tikarya | 2 | +183/-8 | 7 |
adlrocha | 2 | +123/-38 | 21 |
dependabot[bot] | 11 | +87/-61 | 22 |
Jiaying Wang | 8 | +61/-70 | 12 |
Ian Davis | 2 | +60/-38 | 5 |
Aayush Rajasekaran | 2 | +81/-3 | 3 |
hanabi1224 | 4 | +46/-4 | 5 |
Laurent Senta | 1 | +44/-1 | 2 |
jennijuju | 6 | +21/-20 | 17 |
parthshah1 | 1 | +23/-13 | 1 |
Brendan O'Brien | 1 | +25/-10 | 2 |
Jennifer Wang | 4 | +24/-8 | 6 |
Matthew Rothenberg | 3 | +10/-18 | 6 |
riskrose | 1 | +8/-8 | 7 |
linghuying | 1 | +5/-5 | 5 |
fsgerse | 2 | +3/-7 | 3 |
PolyMa | 1 | +5/-5 | 5 |
zhangguanzhang | 1 | +3/-3 | 2 |
luozexuan | 1 | +3/-3 | 3 |
Po-Chun Chang | 1 | +6/-0 | 2 |
Kevin Martin | 1 | +4/-1 | 2 |
simlecode | 1 | +2/-2 | 2 |
ZenGround0 | 1 | +2/-2 | 2 |
GFZRZK | 1 | +2/-1 | 1 |
DemoYeti | 1 | +2/-1 | 1 |
qwdsds | 1 | +1/-1 | 1 |
Samuel Arogbonlo | 1 | +2/-0 | 2 |
Elias Rad | 1 | +1/-1 | 1 |
v1.29.2
This is the stable release for Lotus node v1.29.2. Key updates in this release include:
- 🆕 New API Support: Added support for
EthGetBlockReceipts
RPC method to retrieve transaction receipts for a specified block. This method allows users to obtain Ethereum format receipts of all transactions included in a given tipset as specified by its Ethereum block equivalent. (filecoin-project/lotus#12478) - 🆙 Dependency Update: Upgraded go-libp2p to version v0.35.5 (filecoin-project/lotus#12511), and go-multiaddr-dns to v0.4.0 (filecoin-project/lotus#12540).
- 🐛 Bug Fix: Legacy/historical Drand lookups via
StateGetBeaconEntry
now work again for all historical epochs.StateGetBeaconEntry
now uses the on-chain beacon entries and follows the same rules for historical Drand round matching asStateGetRandomnessFromBeacon
and theget_beacon_randomness
FVM syscall. Be aware that there will be some some variance in matching Filecoin epochs to Drand rounds where null Filecoin rounds are involved prior to network version 14. (filecoin-project/lotus#12428).
☢️ Upgrade Warnings ☢️
- This release requires a minimum Go version of v1.22.7 or higher (filecoin-project/lotus#12459)
📝 Changelog
See v1.29.1...release/v1.29.2 for the set of changes since the last release.
👨👩👧👦 Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
aarshkshah1992 | 2 | +1753/-662 | 12 |
Viraj Bhartiya | 1 | +770/-38 | 18 |
Rod Vagg | 1 | +480/-83 | 14 |
Phi-rjan | 2 | +20/-13 | 9 |
Phi | 2 | +6/-25 | 7 |
v1.29.2-rc1
This is the first release candidate for Lotus node v1.29.2. Key updates in this release include:
- New API Support: Added support for
EthGetBlockReceipts
RPC method to retrieve transaction receipts for a specified block. This method allows users to obtain Ethereum format receipts of all transactions included in a given tipset as specified by its Ethereum block equivalent. (filecoin-project/lotus#12478) - Dependency Update: Upgraded go-libp2p to version v0.35.5 (filecoin-project/lotus#12511)
- Bug Fix: Legacy/historical Drand lookups via
StateGetBeaconEntry
now work again for all historical epochs.StateGetBeaconEntry
now uses the on-chain beacon entries and follows the same rules for historical Drand round matching asStateGetRandomnessFromBeacon
and theget_beacon_randomness
FVM syscall. Be aware that there will be some some variance in matching Filecoin epochs to Drand rounds where null Filecoin rounds are involved prior to network version 14. (filecoin-project/lotus#12428).
📝 Changelog
See v1.29.1...release/v1.29.2-rc1 for the set of changes since the last release.
v1.29.1
This is a Lotus Node patch release that addresses a critical sync issue affecting users of the v1.29.0 release. The primary fix in this release is:
- Downgrade of a dependency that was causing invalid BLS signatures, leading to sync failures for many Lotus nodes. See #12467 for more information about the bug.
We strongly recommend that all users currently running Lotus v1.29.0 upgrade to this version to resolve the syncing problems.
Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
Phi | 1 | +14/-6 | 7 |
Jiaying Wang | 1 | +9/-2 | 3 |
v1.28.3
v1.29.0
This is a Lotus Node only release, which includes a variety of new features, improvements, and fixes, particularly focused on enhancing ETH RPC functionality. Key highlights of this release include:
-
New Features:
- Trace Filter API: Added support for the
trace_filter
RPC method, allowing users to configureEthTraceFilterMaxResults
to limit the number of results returned in any individualtrace_filter
RPC API call. (filecoin-project/lotus#12123) - Filecoin to ETH Address Conversion: The
FilecoinAddressToEthAddress
RPC can now return ETH addresses for all Filecoin address types ("f0"/"f1"/"f2"/"f3") based on the client's re-org tolerance. Note that this is a breaking change if you are using the API via the go-jsonrpc library or by using Lotus as a library, but it is non-breaking when using the API via any other RPC method as it adds an optional second argument. (filecoin-project/lotus#12324) - Sending to ETH addresses The
lotus send
command now supports sending to ETH address recipients. (filecoin-project/lotus#12319)
- Trace Filter API: Added support for the
-
Improvements:
- Gateway Enhancements: Significant improvements to the
lotus-gateway
including better rate limiting and stateful handling. The--per-conn-rate-limit
now works as advertised, and a new--eth-max-filters-per-conn
option allows setting the maximum number of filters and subscriptions per connection, defaulting to 16. Stateful Ethereum APIs are now disabled for plain HTTP connections and require websockets. Additionally, the default value for theEvents.FilterTTL
config option has been reduced from 24h to 1h. (filecoin-project/lotus#12315) - Performance Improvements: Addressed SQLite index selection performance regressions, significantly improving query times for event-related data. (filecoin-project/lotus#12261).
- Gateway Enhancements: Significant improvements to the
☢️ Upgrade Warnings ☢️
lotus-gateway
behaviour, CLI-arguments and APIs have received minor changes. See the improvements section in theOrganised Changelog
section below for more information.- The
FilecoinAddressToEthAddress
RPC introduces a breaking change for users of the go-jsonrpc library or Lotus as a library. - We are aware that legacy/historical Drand lookups via
StateGetBeaconEntry
are currently broken. If you rely onStateGetBeaconEntry
for looking up historic beacons, we recommend waiting for the Lotus v1.29.1 release. You can follow the progress on this issue in #12414.
📝 Changelog
See v1.28.2...release/v1.29.0 for the set of changes since the last release.
Organized Changelog
New features
- feat: Add trace filter API supporting RPC method
trace_filter
(filecoin-project/lotus#12123). ConfiguringEthTraceFilterMaxResults
sets a limit on how many results are returned in any individualtrace_filter
RPC API call. - feat:
FilecoinAddressToEthAddress
RPC can now return ETH addresses for all Filecoin address types ("f0"/"f1"/"f2"/"f3") based on client's re-org tolerance. This is a breaking change if you are using the API via the go-jsonrpc library or by using Lotus as a library, but is a non-breaking change when using the API via any other RPC method as it adds an optional second argument.
(filecoin-project/lotus#12324). - feat: Added
lotus-shed indexes inspect-events
health-check command (filecoin-project/lotus#12346). - feat(libp2p): expose libp2p bandwidth metrics (#12402) (filecoin-project/lotus#12402)
- feat: Lotus Send CLI: Lotus send should work with ETH address receipients (#12319)
Improvements
- feat!: gateway: fix rate limiting, better stateful handling (filecoin-project/lotus#12327).
- CLI usage documentation has been improved for
lotus-gateway
--per-conn-rate-limit
now works as advertised.--eth-max-filters-per-conn
is new and allows you to set the maximum number of filters and subscription per connection, it defaults to 16.- Previously, this limit was set to
16
and applied separately to filters and subscriptions. This limit is now unified and applies to both filters and subscriptions.
- Previously, this limit was set to
- Stateful Ethereum APIs (those involving filters and subscriptions) are now disabled for plain HTTP connections. A client must be using websockets to access these APIs.
- These APIs are also now automatically removed from the node by the gateway when a client disconnects.
- Some APIs have changed which may impact users consuming Lotus Gateway code as a library.
- The default value for the
Events.FilterTTL
config option has been reduced from 24h to 1h. This means that filters will expire on a Lotus node after 1 hour of not being accessed by the client.
- CLI usage documentation has been improved for
- feat: f3: override F3BootstrapEpoch on 2k devnet with environment variable (#12354) (filecoin-project/lotus#12354)
- feat: p2p: allow overriding bootstrap nodes with environmemnt variable (#12292) (filecoin-project/lotus#12292)
- feat(f3): F3 has been updated with many performance improvements and additional metrics.
- fix: Eth Event Receipt Logs: use event index for logs (#12269) (filecoin-project/lotus#12269)
- fix: add datacap balance to circ supply internal accounting as unCirc (#12348) (filecoin-project/lotus#12348)
- feat: Use a block cache to speed up the
EthGetBlockByHash
API (#12359) (filecoin-project/lotus#12359) - fix: lotus-shed: store processed tipset after backfilling events (#12335) (filecoin-project/lotus#12335)
- fix: Eth Tx Events Bloom Filter: fix slice modification bug and flaky test (#12203) (filecoin-project/lotus#12203)
- fix(ETH RPC): receipts: use correct txtype in receipts (#12332) (filecoin-project/lotus#12332
- fix(cli): only change method for 0x recipients (#12328) (filecoin-project/lotus#12328)
- feat: api: clean API for Miners (#12112) (filecoin-project/lotus#12112)
- feat: p2p: environment variables for disabling DHT query filter and routing table filter (#12289) (filecoin-project/lotus#12289)
- fix: cli: Add delegated to cli docs (#12229) (filecoin-project/lotus#12229)
- feat: sqlite: extract common init and migration utilities (#12098) (filecoin-project/lotus#12098)
- feat: niporep: multi-sector onboarding through UnmanagedMiner (#12180) (filecoin-project/lotus#12180)
Dependencies
From v1.28.2...release/v1.29.0#diff-33ef32bf6c23acb95f5902d7097b7a1d5128ca061167ec0716715b0b9eeaa5f6
- github.com/filecoin-project/go-commp-utils (v0.1.3 -> v0.1.4):
- github.com/filecoin-project/go-commp-utils/nonffi (v0.0.0-20220905160352-62059082a837 -> v0.0.0-20240802040721-2a04ffc8ffe8):
- github.com/filecoin-project/go-hamt-ipld/v3 (v3.1.0 -> v3.4.0):
- github.com/filecoin-project/go-jsonrpc (v0.3.2 -> v0.6.0):
- github.com/filecoin-project/jackc/pgx (v5.4.1 -> v5.6.0)
- feat(f3): update from v0.0.7 to v0.1.0 (#12382) (filecoin-project/lotus#12382)
- feat: f3: update go-f3 to 0.2.0 (#12390) (filecoin-project/lotus#12390)
Chores
- chore: ffi: copy verifier iface, mock & ffi out of storage (#11581) (filecoin-project/lotus#11581)
- docs: update LOTUS_RELEASE_FLOW.MD document (#12322) (filecoin-project/lotus#12322)
- docs: update references to releases branch (#12396) (filecoin-project/lotus#12396)
- docs: pr title check fix to link to right doc (#12371) (filecoin-project/lotus#12371)
- docs: updating CONTRIBUTING.md with table of contents and TOC guidance (#12372) (filecoin-project/lotus#12372)
- docs: release template: update based on 1.28 learnings (#12356) (filecoin-project/lotus#12356)
- refactor: adjust PR Title Check workflow to reduce noise (#12373) (filecoin-project/lotus#12373)
- feat(ci): add PR title check workflow (#12340) (filecoin-project/lotus#12340)
- chore(docs): fix some function names (#12368) (filecoin-project/lotus#12368)
- feat: ci: automate the new release process (#12096) ([filecoin-proj...
v1.29.0-rc1
This is a Lotus Node only release, which includes a variety of new features, improvements, and fixes, particularly focused on enhancing ETH RPC functionality. ⭐️ Key highlights of this release include: ⭐️
-
New Features:
- Trace Filter API: Added support for the
trace_filter
RPC method, allowing users to configureEthTraceFilterMaxResults
to limit the number of results returned in any individualtrace_filter
RPC API call. (filecoin-project/lotus#12123) - Filecoin to ETH Address Conversion: The
FilecoinAddressToEthAddress
RPC can now return ETH addresses for all Filecoin address types ("f0"/"f1"/"f2"/"f3") based on the client's re-org tolerance. Note that this is a breaking change if you are using the API via the go-jsonrpc library or by using Lotus as a library, but it is non-breaking when using the API via any other RPC method as it adds an optional second argument. (filecoin-project/lotus#12324) - Sending to ETH addresses The
lotus send
command now supports sending to ETH address recipients. (filecoin-project/lotus#12319)
- Trace Filter API: Added support for the
-
Improvements:
- Gateway Enhancements: Significant improvements to the
lotus-gateway
including better rate limiting and stateful handling. The--per-conn-rate-limit
now works as advertised, and a new--eth-max-filters-per-conn
option allows setting the maximum number of filters and subscriptions per connection, defaulting to 16. Stateful Ethereum APIs are now disabled for plain HTTP connections and require websockets. Additionally, the default value for theEvents.FilterTTL
config option has been reduced from 24h to 1h. (filecoin-project/lotus#12315) - Performance Improvements: Addressed SQLite index selection performance regressions, significantly improving query times for event-related data. (filecoin-project/lotus#12261).
- Gateway Enhancements: Significant improvements to the
☢️ Upgrade Warnings ☢️
lotus-gateway
behaviour, CLI-arguments and APIs have received minor changes. See the improvements section below for more information.- The
FilecoinAddressToEthAddress
RPC introduces a breaking change for users of the go-jsonrpc library or Lotus as a library.
📝 Changelog
See v1.28.2...release/v1.29.0 for the set of changes since the last release.
Organized Changelog
New features
- feat: Add trace filter API supporting RPC method
trace_filter
(filecoin-project/lotus#12123). ConfiguringEthTraceFilterMaxResults
sets a limit on how many results are returned in any individualtrace_filter
RPC API call. - feat:
FilecoinAddressToEthAddress
RPC can now return ETH addresses for all Filecoin address types ("f0"/"f1"/"f2"/"f3") based on client's re-org tolerance. This is a breaking change if you are using the API via the go-jsonrpc library or by using Lotus as a library, but is a non-breaking change when using the API via any other RPC method as it adds an optional second argument.
(filecoin-project/lotus#12324). - feat: Added
lotus-shed indexes inspect-events
health-check command (filecoin-project/lotus#12346). - feat(libp2p): expose libp2p bandwidth metrics (#12402) (filecoin-project/lotus#12402)
- feat: Lotus Send CLI: Lotus send should work with ETH address receipients (#12319)
Improvements
- feat!: gateway: fix rate limiting, better stateful handling (filecoin-project/lotus#12315).
- CLI usage documentation has been improved for
lotus-gateway
--per-conn-rate-limit
now works as advertised.--eth-max-filters-per-conn
is new and allows you to set the maximum number of filters and subscription per connection, it defaults to 16.- Previously, this limit was set to
16
and applied separately to filters and subscriptions. This limit is now unified and applies to both filters and subscriptions.
- Previously, this limit was set to
- Stateful Ethereum APIs (those involving filters and subscriptions) are now disabled for plain HTTP connections. A client must be using websockets to access these APIs.
- These APIs are also now automatically removed from the node by the gateway when a client disconnects.
- Some APIs have changed which may impact users consuming Lotus Gateway code as a library.
- The default value for the
Events.FilterTTL
config option has been reduced from 24h to 1h. This means that filters will expire on a Lotus node after 1 hour of not being accessed by the client.
- CLI usage documentation has been improved for
- feat: f3: override F3BootstrapEpoch on 2k devnet with environment variable (#12354) (filecoin-project/lotus#12354)
- feat: p2p: allow overriding bootstrap nodes with environmemnt variable (#12292) (filecoin-project/lotus#12292)
- feat(f3): F3 has been updated with many performance improvements and additional metrics.
- fix: Eth Event Receipt Logs: use event index for logs (#12269) (filecoin-project/lotus#12269)
- fix: add datacap balance to circ supply internal accounting as unCirc (#12348) (filecoin-project/lotus#12348)
- feat: Use a block cache to speed up the
EthGetBlockByHash
API (#12359) (filecoin-project/lotus#12359) - fix: lotus-shed: store processed tipset after backfilling events (#12335) (filecoin-project/lotus#12335)
- fix: Eth Tx Events Bloom Filter: fix slice modification bug and flaky test (#12203) (filecoin-project/lotus#12203)
- fix(ETH RPC): receipts: use correct txtype in receipts (#12332) (filecoin-project/lotus#12332
- fix(cli): only change method for 0x recipients (#12328) (filecoin-project/lotus#12328)
- feat: api: clean API for Miners (#12112) (filecoin-project/lotus#12112)
Dependencies
From v1.28.2...release/v1.29.0#diff-33ef32bf6c23acb95f5902d7097b7a1d5128ca061167ec0716715b0b9eeaa5f6
- github.com/filecoin-project/go-commp-utils (v0.1.3 -> v0.1.4):
- github.com/filecoin-project/go-commp-utils/nonffi (v0.0.0-20220905160352-62059082a837 -> v0.0.0-20240802040721-2a04ffc8ffe8):
- github.com/filecoin-project/go-hamt-ipld/v3 (v3.1.0 -> v3.4.0):
- github.com/filecoin-project/go-jsonrpc (v0.3.2 -> v0.6.0):
- github.com/filecoin-project/jackc/pgx (v5.4.1 -> v5.6.0)
- feat: f3: update go-f3 to 0.2.0 (#12390) (filecoin-project/lotus#12390)
Chores
- chore: ffi: copy verifier iface, mock & ffi out of storage (#11581) (filecoin-project/lotus#11581)
- docs: update LOTUS_RELEASE_FLOW.MD document (#12322) (filecoin-project/lotus#12322)
- docs: update references to releases branch (#12396) (filecoin-project/lotus#12396)
- docs: pr title check fix to link to right doc (#12371) (filecoin-project/lotus#12371)
- docs: updating CONTRIBUTING.md with table of contents and TOC guidance (#12372) (filecoin-project/lotus#12372)
- docs: release template: update based on 1.28 learnings (#12356) (filecoin-project/lotus#12356)
- refactor: adjust PR Title Check workflow to reduce noise (#12373) (filecoin-project/lotus#12373)
- feat(ci): add PR title check workflow (#12340) (filecoin-project/lotus#12340)
- chore(docs): fix some function names (#12368) (filecoin-project/lotus#12368)
- feat: ci: automate the new release process (#12096) (filecoin-project/lotus#12096)
- feat: ci: upload junit xml reports to buildpulse (#12225) (filecoin-project/lotus#12225)
- github: improve stalebot behavior/language (#12370) (filecoin-project/lotus#12370)
- chore: docs: fix some misspellings (#12333) (filecoin-project/lotus#12333)
- docs: expand
CONTRIBUTING.md
and updateREADME.md
(#12366) (filecoin-project/lotus#12366) - chore: docs: Update step in skeleton guide (#12349) (filecoin-project/lotus#12349)
- chore: docs: Add initial
Update_Dependencies_Lotus.md
(#12107) (filecoin-project/lotus#12107) - chore: proxy single Put/Delete to the Many variants (#12313) (filecoin-project/lotus#12313)
- chore: logging: switch stdout print to...