Releases: filecoin-project/lotus
v1.28.1
This is the MANDATORY Lotus v1.28.1 release, which will deliver the Filecoin network version 23, codenamed Waffle 🧇. v1.28.1 is also the minimal version that supports nv23.
This release sets the Mainnet to upgrade at epoch 4154640, corresponding to 2024-08-06T12:00:00Z.
☢️ Upgrade Warnings ☢️
- If you are running the
v1.26.x
version of Lotus, please go through theUpgrade Warnings
section for thev1.27.*
releases, before upgrading to this RC. - Note that v1.28.0 needed a bug fix and a feature enhancement to ensure a smooth support for nv23 and it was retracted. Please update your node to v1.28.1 or above before the nv23 upgrade!
- This upgrade includes an additional migration to the events database. Node operators running Lotus with events turned on (off by default) may experience some delay in initial start-up of Lotus as a minor database migration takes place. See filecoin-project/lotus#12080 for full details.
- All Storage Providers MUST finish onboarding all sectors that have deal IDs in the
PreCommitSectors
OnChainSectorInfo
s before upgrading the lotus miner OR THEY WILL BE WASTED. Please see more details in the next section.
The Filecoin network version 23 delivers the following FIPs:
- FIP-0065: Ignore built-in market locked balance in circulating supply calculation
- FIP-0079: Add BLS Aggregate Signatures to FVM
- FIP-0084: Remove Storage Miner Actor Method ProveCommitSectors
⚠️ Please note that onboarding viaProveCommitSectors
is deprecated in favor ofProveCommitSectors3
, which was introduced in FIP-0076 and activated in the last network upgrade (NV22).ProveCommitSectors3
will reject the activation of sectors that were precommitted with deal IDs.
Storage Providers should ensure that their pipeline is updated to adopt theProveCommitSector3
flow as soon as possible. Otherwise, they risk losing deal collateral, PCD, and sealing work for sectors that were not fully committed on-chain before the upgrade yet have deal IDs in the precommitted sector on-chain info. This release removes the deprecatedProveCommitSectors
pipeline, and the new pipeline is fully supported. Prior to this release, the onboarding pipeline would still prefer to useProveCommitSectors
for sectors containing deals. If you have any questions, please don't hesitate to reach out in #fil-curio-dev.
- FIP-0085: Convert f090 Mining Reserve Actor to Keyless Account Actor
- FIP-0091: Add support for legacy Ethereum transactions
- FIP-0092: NI-PoRep
- FIP-0086: Fast Finality Soft Launch
Note that we are only doing a "soft launch"/"passive testing" for F3 (Fast Finality) i.e. FIP-0086 in NV23. Please see this doc for more details.
v14 Builtin Actor Bundle
Builtin actor v14.0.0 is used for supporting this upgrade. Make sure that your lotus actor bundle matches the v14 actors manifest by running the following cli after upgrading:
lotus state actor-cids --network-version=23
Network Version: 23
Actor Version: 14
Manifest CID: bafy2bzacecbueuzsropvqawsri27owo7isa5gp2qtluhrfsto2qg7wpgxnkba
Actor CID
account bafk2bzacebr7ik7lng7vysm754mu5x7sakphwm4soqi6zwbox4ukpd6ndwvqy
cron bafk2bzacecwn6eiwa7ysimmk6i57i5whj4cqzwijx3xdlxwb5canmweaez6xc
datacap bafk2bzacecidw7ajvtjhmygqs2yxhmuybyvtwp25dxpblvdxxo7u4gqfzirjg
eam bafk2bzaced2cxnfwngpcubg63h7zk4y5hjwwuhfjxrh43xozax2u6u2woweju
ethaccount bafk2bzacechu4u7asol5mpcsr6fo6jeaeltvayj5bllupyiux7tcynsxby7ko
evm bafk2bzacedupohbgwrcw5ztbbsvrpqyybnokr4ylegmk7hrbt3ueeykua6zxw
init bafk2bzacecbbcshenkb6z2v4irsudv7tyklfgphhizhghix6ke5gpl4r5f2b6
multisig bafk2bzaceajcmsngu3f2chk2y7nanlen5xlftzatytzm6hxwiiw5i5nz36bfc
paymentchannel bafk2bzaceavslp27u3f4zwjq45rlg6assj6cqod7r5f6wfwkptlpi6j4qkmne
placeholder bafk2bzacedfvut2myeleyq67fljcrw4kkmn5pb5dpyozovj7jpoez5irnc3ro
reward bafk2bzacedvfnjittwrkhoar6n5xrykowg2e6rpur4poh2m572f7m7evyx4lc
storagemarket bafk2bzaceaju5wobednmornvdqcyi6khkvdttkru4dqduqicrdmohlwfddwhg
storageminer bafk2bzacea3f43rxzemmakjpktq2ukayngean3oo2de5cdxlg2wsyn53wmepc
storagepower bafk2bzacedo6scxizooytn53wjwg2ooiawnj4fsoylcadnp7mhgzluuckjl42
system bafk2bzacecak4ow7tmauku42s3u2yydonk4hx6ov6ov542hy7lcbji3nhrrhs
verifiedregistry bafk2bzacebvyzjzmvmjvpypphqsumpy6rzxuugnehgum7grc6sv3yqxzrshb4
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 NV23 upgrade is expected to be light with no heavy pre-migrations, here are some expected timings and resource consumption numbers:
- Pre-migration is expected to take less than 1 minute.
- The migration is expected to take less than 30 seconds on a node with an NVMe drive and a newer CPU. For nodes running on slower disks/CPU, it is still expected to take less than 1 minute.
- Max memory usage during benchmarking the migration in "offline mode" (i.e., node not syncing) was 23GiB.
- Max memory usage when benchmarking the migration in "online mode" (i.e., while the node is syncing) was 30GiB. Numbers here might vary depending on the load your node is under.
More details on the migration benchmarking can be found in #12128
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 running the non-cached migration (i.e., just running the migration at the network upgrade epoch), and scheduling some additional downtime. Operators of such nodes can read the How to disable premigration in network upgrade tutorial.
Fast Finality for Filecoin (f3) soft launch
We are one step closer to reduce Filecoin's finality from 7.5 hours to a minute or so, you can checkout the FIP for more details. Changing the consensus protocol is not trivial, and the f3 implementation team has designed a passive testing plan to verify the protocol and give time for client implementation teams to integrate and test F3 before it is fully activated in the network consensus. That said, the lotus team has implemented f3 & the manifest for passive testing in this release, and we would like to ask node operators, especially storage providers, to participate in the testing by participating in F3 on the mainnet (which is enabled by default in this release)! We will keep updating this discussion to capture "what can you expect" & testing status. If you notice any unexpected behaviour caused by f3, please do not hesitate to reach out to us in #fil-fast-finality.
F3 (Fast Finality) is experimental in this release. All the new F3 APIs are unstable and subject to until nv24 release (assuming f3 will be fully activated in this upgrade).
Exchanges and RPC providers are recommended to opt-out of F3 functionality for now. You can disable F3 by adding the LOTUS_DISABLE_F3 = 1
environment variable.
Dependencies
- github.com/filecoin-project/go-state-types (
v0.14.0-dev
->v0.14.0
) - github.com/filecoin-project/filecoin-ffi (
v1.27.0-rc2
->v1.28.0
) - github.com/filecoin-project/go-libp2p2 (
v0.35.3
->v0.35.4
) ref-fvm4
(as part offilecoin-ffi
) (4.2.0
->4.3.1
)- A new
github.com/filecoin-project/go-f3
dependency for F3 soft launch (v0.0.5
)
Others
- Soft launch of F3 (#12119)
- NI-PoRep changes (#12130)
- Fixes for the ETH events API (#12080)
- Support for legacy Ethereum transactions (#11969)
- Ignore market balance after nv23 (#11976)
- Add finality-related params for
eth_getBlockByNumber
(#12110) - rename
Actor.Address
toActor.DelegatedAddress
and only use it for f4 addresses (#12155) - feat:ec: integrate F3 dynamic manifest #12185
- fix: f3: Fix F3 build parameters for testground target (#12189) (filecoin-project/lotus#12189)
- fix: eth_getLogs: #12212
- chore: lotus-shed: Add support for nv23 in migrate-state cmd #12172
- feat: F3: Update go-f3, change the style of participation call #12196
- chore: f3: Upgrade go mod F3 dependency to v0.0.3 tagged release #12216
- fix: Eth Trace Block: nil access panic #12221
- chore!: markets: remove stray unixfs constants, ...
v1.28.0
Update on 2024-07-24
This release is retracted, please refer to v1.28.1 for more details
⬇️ DEPRECATED ⬇️
This is the MANDATORY Lotus v1.28.0 release, which will deliver the Filecoin network version 23, codenamed Waffle 🧇.
This release sets the Mainnet to upgrade at epoch 4154640, corresponding to 2024-08-06T12:00:00Z.
☢️ Upgrade Warnings ☢️
-
If you are running the
v1.26.x
version of Lotus, please go through theUpgrade Warnings
section for thev1.27.*
releases, before upgrading to this RC. -
This upgrade includes an additional migration to the events database. Node operators running Lotus with events turned on (off by default) may experience some delay in initial start-up of Lotus as a minor database migration takes place. See filecoin-project/lotus#12080 for full details.
The Filecoin network version 23 delivers the following FIPs:
- FIP-0065: Ignore built-in market locked balance in circulating supply calculation
- FIP-0079: Add BLS Aggregate Signatures to FVM
- FIP-0084: Remove Storage Miner Actor Method ProveCommitSectors
- FIP-0085: Convert f090 Mining Reserve Actor to Keyless Account Actor
- FIP-0091: Add support for legacy Ethereum transactions
- FIP-0092: NI-PoRep
- FIP-0086: Fast Finality Soft Launch
Note that we are only doing a "soft launch"/"passive testing" for F3 (Fast Finality) i.e. FIP-0086 in NV23. Please see this doc for more details.
v14 Builtin Actor Bundle
Builtin actor v14.0.0 is used for supporting this upgrade. Make sure that your lotus actor bundle matches the v14 actors manifest by running the following cli after upgrading:
lotus state actor-cids --network-version=23
Network Version: 23
Actor Version: 14
Manifest CID: bafy2bzacecbueuzsropvqawsri27owo7isa5gp2qtluhrfsto2qg7wpgxnkba
Actor CID
account bafk2bzacebr7ik7lng7vysm754mu5x7sakphwm4soqi6zwbox4ukpd6ndwvqy
cron bafk2bzacecwn6eiwa7ysimmk6i57i5whj4cqzwijx3xdlxwb5canmweaez6xc
datacap bafk2bzacecidw7ajvtjhmygqs2yxhmuybyvtwp25dxpblvdxxo7u4gqfzirjg
eam bafk2bzaced2cxnfwngpcubg63h7zk4y5hjwwuhfjxrh43xozax2u6u2woweju
ethaccount bafk2bzacechu4u7asol5mpcsr6fo6jeaeltvayj5bllupyiux7tcynsxby7ko
evm bafk2bzacedupohbgwrcw5ztbbsvrpqyybnokr4ylegmk7hrbt3ueeykua6zxw
init bafk2bzacecbbcshenkb6z2v4irsudv7tyklfgphhizhghix6ke5gpl4r5f2b6
multisig bafk2bzaceajcmsngu3f2chk2y7nanlen5xlftzatytzm6hxwiiw5i5nz36bfc
paymentchannel bafk2bzaceavslp27u3f4zwjq45rlg6assj6cqod7r5f6wfwkptlpi6j4qkmne
placeholder bafk2bzacedfvut2myeleyq67fljcrw4kkmn5pb5dpyozovj7jpoez5irnc3ro
reward bafk2bzacedvfnjittwrkhoar6n5xrykowg2e6rpur4poh2m572f7m7evyx4lc
storagemarket bafk2bzaceaju5wobednmornvdqcyi6khkvdttkru4dqduqicrdmohlwfddwhg
storageminer bafk2bzacea3f43rxzemmakjpktq2ukayngean3oo2de5cdxlg2wsyn53wmepc
storagepower bafk2bzacedo6scxizooytn53wjwg2ooiawnj4fsoylcadnp7mhgzluuckjl42
system bafk2bzacecak4ow7tmauku42s3u2yydonk4hx6ov6ov542hy7lcbji3nhrrhs
verifiedregistry bafk2bzacebvyzjzmvmjvpypphqsumpy6rzxuugnehgum7grc6sv3yqxzrshb4
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 NV23 upgrade is expected to be light with no heavy pre-migrations, here are some expected timings and resource consumption numbers:
- Pre-migration is expected to take less than 1 minute.
- The migration is expected to take less than 30 seconds on a node with an NVMe drive and a newer CPU. For nodes running on slower disks/CPU, it is still expected to take less than 1 minute.
- Max memory usage during benchmarking the migration in "offline mode" (i.e., node not syncing) was 23GiB.
- Max memory usage when benchmarking the migration in "online mode" (i.e., while the node is syncing) was 30GiB. Numbers here might vary depending on the load your node is under.
More details on the migration benchmarking can be found in #12128
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 running the non-cached migration (i.e., just running the migration at the network upgrade epoch), and scheduling some additional downtime. Operators of such nodes can read the How to disable premigration in network upgrade tutorial.
Fast Finality for Filecoin (f3) soft launch
We are one step closer to reduce Filecoin's finality from 7.5 hours to a minute or so, you can checkout the FIP for more details. Changing the consensus protocol is not trivial, and the f3 implementation team has designed a passive testing plan to verify the protocol and give time for client implementation teams to integrate and test F3 before it is fully activated in the network consensus. That said, the lotus team has implemented f3 & the manifest for passive testing in this release, and we would like to ask node operators, especially storage providers, to participate in the testing by participating in F3 on the mainnet (which is enabled by default in this release)! We will keep updating this discussion to capture "what can you expect" & testing status. If you notice any unexpected behaviour caused by f3, please do not hesitate to reach out to us in #fil-fast-finality.
F3 (Fast Finality) is experimental in this release. All the new F3 APIs are unstable and subject to until nv24 release (assuming f3 will be fully activated in this upgrade).
Exchanges and RPC providers are recommended to opt-out of F3 functionality for now. You can disable F3 by adding the DISABLE_F3 = 1
environment variable, which will output a log saying that F3 has been disabled.
Dependencies
- github.com/filecoin-project/go-state-types (
v0.14.0-dev
->v0.14.0
) - github.com/filecoin-project/filecoin-ffi (
v1.27.0-rc2
->v1.28.0
) - github.com/filecoin-project/go-libp2p2 (
v0.35.3
->v0.35.4
) ref-fvm4
(as part offilecoin-ffi
) (4.2.0
->4.3.1
)- A new
github.com/filecoin-project/go-f3
dependency for F3 soft launch (v0.0.5
)
Others
- Soft launch of F3 (#12119)
- NI-PoRep changes (#12130)
- Fixes for the ETH events API (#12080)
- Support for legacy Ethereum transactions (#11969)
- Ignore market balance after nv23 (#11976)
- Add finality-related params for
eth_getBlockByNumber
(#12110) - rename
Actor.Address
toActor.DelegatedAddress
and only use it for f4 addresses (#12155) - feat:ec: integrate F3 dynamic manifest #12185
- fix: f3: Fix F3 build parameters for testground target (#12189) (filecoin-project/lotus#12189)
- fix: eth_getLogs: #12212
- chore: lotus-shed: Add support for nv23 in migrate-state cmd #12172
- feat: F3: Update go-f3, change the style of participation call #12196
- chore: f3: Upgrade go mod F3 dependency to v0.0.3 tagged release #12216
- fix: Eth Trace Block: nil access panic #12221
- chore!: markets: remove stray unixfs constants, features and references #12217
- chore: metrics: Upgrade to OpenTelemetry v1.28.0 #12223
- fix: bug: Reduce log level in F3 message sending to Debug #12224
- [skip changelog] chore: config: yet more lp2p removal from miner #12252
- fix(store): correctly break weight ties based on smaller ticket #12253
- fix: exchange bug #12275
- chore: deps: Update GST, Filecoin-FFI and Actors to final versions NV23 #12276
- metrics: f3: Set up otel metrics reporting to prometheus #12285
- Upgrade to go-f3 v0.0.5 #12279
v1.27.2
This is the stable release of Lotus v1.27.2. This will be an OPTIONAL Lotus release. It contains some improvements that are relevant for node operators that are using or serving eth_*
RPC methods. It also contains an upgraded libp2p to v0.35.3 which is included in this release for additional testing of some fixes that may solve some connectivity problems experienced by some users (See libp2p/go-libp2p#2858 for more information).
☢️ Upgrade Warnings ☢️
- This Lotus release includes some correctness improvements to the events subsystem, impacting RPC APIs including
GetActorEventsRaw
,SubscribeActorEventsRaw
,eth_getLogs
and theeth
filter APIs. Part of these improvements involve an events database migration that may take some time to complete on nodes with extensive event databases. See filecoin-project/lotus#12080 for details.
Improvements
- fix: events index: record processed epochs and tipsets for events and eth_get_log blocks till requested tipset has been indexed (#12080) (filecoin-project/lotus#12080)
- feat: eth: support "safe" and "finalized" for eth_getBlockByNumber (#12110) (filecoin-project/lotus#12110)
- feat: api: sanity check the "to" address of outgoing messages (#12135) (filecoin-project/lotus#12135)
- chore: ci: remove non-existent market tests from CI workflow (#12099) (filecoin-project/lotus#12099)
- fix: bootstrap: remove unmaintained bootstrap node (#12133) (filecoin-project/lotus#12133)
- Update bootstrap list to support both IPv4 and IPv6 (#12103) (filecoin-project/lotus#12103)
Dependencies
- chore: deps: upgrade to [email protected] from v0.34.1 (filecoin-project/lotus#12249)
Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
galargh | 3 | +655/-484 | 18 |
Aarsh Shah | 2 | +424/-28 | 4 |
Steven Allen | 1 | +137/-0 | 3 |
Rod Vagg | 4 | +65/-33 | 22 |
Mikers | 1 | +63/-0 | 4 |
Phi-rjan | 1 | +10/-10 | 2 |
Peter Rabbitson | 1 | +4/-8 | 1 |
Hubert | 1 | +0/-1 | 1 |
v1.27.2-rc2
v1.27.2-rc2
New features
Improvements
- github.com/filecoin-project/lotus:
- docs: lotus v1.27.2-rc2 prep
- chore: ci: allow using pat for tag creation during release
- feat: ci: remove gorelease, create drafts and automate release notes
- docs: lotus v1.27.2-rc1 prep
- chore: ci: remove non-existent market tests from CI workflow (#12099) (filecoin-project/lotus#12099)
- fix: bootstrap: remove unmaintained bootstrap node (#12133) (filecoin-project/lotus#12133)
- feat: eth: support "safe" and "finalized" for eth_getBlockByNumber (#12110) (filecoin-project/lotus#12110)
- Update bootstrap list to support both IPv4 and IPv6 (#12103) (filecoin-project/lotus#12103)
- feat: api: sanity check the "to" address of outgoing messages (#12135) (filecoin-project/lotus#12135)
- fix: events index: record processed epochs and tipsets for events and eth_get_log blocks till requested tipset has been indexed (#12080) (filecoin-project/lotus#12080)
- feat: ci: automate the new release process
Contributors
Contributor | Commits | Lines ± | Files Changed |
---|---|---|---|
galargh | 3 | +655/-484 | 18 |
Aarsh Shah | 2 | +424/-28 | 4 |
Steven Allen | 1 | +137/-0 | 3 |
Mikers | 1 | +63/-0 | 4 |
Rod Vagg | 2 | +40/-12 | 13 |
Phi-rjan | 1 | +10/-10 | 2 |
Peter Rabbitson | 1 | +4/-8 | 1 |
Hubert | 1 | +0/-1 | 1 |
v1.28.0-rc5
v1.28.0-rc5 / 2024-07-11
This is the fifth release candidate of the upcoming MANDATORY Lotus v1.28.0 release, which will deliver the Filecoin network version 23, codenamed Waffle 🧇.
This release candidate sets the calibration network to upgrade at epoch 1779094, corresponding to 2024-07-11T12:00:00Z. This release does NOT set the mainnet upgrade epoch yet, in which will be updated in the final release.
Compared to Lotus v1.28.0-rc4
, the Lotus v1.28.0-rc5
release addresses some performance problems in the eth_getLogs
API.
It also addresses a bug in the eth_getLogs
API around handling null blocks.
☢️ Upgrade Warnings ☢️
If you are running the v1.26.0
or an earlier version of Lotus, please go through the Upgrade Warnings
section for the v1.27.*
releases, before upgrading to this RC.
- This upgrade includes an additional migration to the events database. Node operators running Lotus with events turned on (off by default) may experience some delay in initial start-up of Lotus as a minor database migration takes place. See filecoin-project/lotus#12080 for full details.
- This Lotus release includes some correctness improvements to the events subsystem, impacting RPC APIs including
GetActorEventsRaw
,SubscribeActorEventsRaw
,eth_getLogs
and theeth
filter APIs. Part of these improvements involve an events database migration that may take some time to complete on nodes with extensive event databases. See filecoin-project/lotus#12080 for details.
The Filecoin network version 23 delivers the following FIPs:
- FIP-0065: Ignore built-in market locked balance in circulating supply calculation
- FIP-0079: Add BLS Aggregate Signatures to FVM
- FIP-0084: Remove Storage Miner Actor Method ProveCommitSectors
- FIP-0085: Convert f090 Mining Reserve Actor to Keyless Account Actor
- FIP-0091: Add support for legacy Ethereum transactions
- FIP-0092: NI-PoRep
- FIP-0086: Fast Finality Soft Launch
Note that we are only doing a "soft launch"/"passive testing" for F3 (Fast Finality) i.e. FIP-0086 in NV23. Please see this doc for more details.
v14 Builtin Actor Bundle
The actor bundles for the calibration network can be checked as follows:
lotus state actor-cids --network-version=23
Network Version: 23
Actor Version: 14
Manifest CID: bafy2bzacebq3hncszqpojglh2dkwekybq4zn6qpc4gceqbx36wndps5qehtau
Actor CID
account bafk2bzaced5ecfm56dvtw26q56j4d32yoccyd7ggxn3qdki2enxpqqav45ths
cron bafk2bzacedpbtttpyvtjncqoyobr63mhqqtlrygbnudhxyp2vha56f626dkfs
datacap bafk2bzacecded3lcvo7ndsk66samyecw2trnhrgzi7jxsary3sqgopxlk6rku
eam bafk2bzacecsda4uw7dcu76a27gnrrdcm73tgms7wrte6jbou63vloktkqc5ne
ethaccount bafk2bzacebu2lcxfmohomjj3umslnylwugf5gssywdq3575tjarta7o227dls
evm bafk2bzacea4xnekruhfmdnzvzeo6cbf7jsfgco6x5wje2ckwc2ui2ojzcrlgu
init bafk2bzacedfmsdlewihdcrkdepnfata26nj7akbvexzs3chicujhjf2uxsazc
multisig bafk2bzacedwx4svscsp6wqqu2vlcunjihvvm4u2jnsqjkwutjhir7dwtl7z6m
paymentchannel bafk2bzacedbit7oo6lryhbo64uikvtjtfcth6oxwy3eebxerenu2h7rj44n24
placeholder bafk2bzacedfvut2myeleyq67fljcrw4kkmn5pb5dpyozovj7jpoez5irnc3ro
reward bafk2bzaced5rlycj7fzpscfc7p3wwxarngwqylqshj7te3uffey5tevunz4we
storagemarket bafk2bzaceatwbyrec2nnwggxc2alpqve7rl52fmbhqflebuxmmnvg3qckjb7c
storageminer bafk2bzacecr7ozkdz7l2pq3ig5qxae2ysivbnojhsn4gw3o57ov4mhksma7me
storagepower bafk2bzacedgeolvjtnw7fkji5kqmx322abv6uls2v34fuml6nw36dvfcw4mtu
system bafk2bzacederl6tlpieldsn6mkndqwd4wj5orfoqgab6p2klswfn3cjagxwla
verifiedregistry bafk2bzaceczw2kp6gjjdcjbso7mewp7guik7gr525pal6dotdja2lrct6ok3c
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 NV23 upgrade is expected to be light with no heavy pre-migrations, here are some expected timings and resource consumption numbers:
- Pre-Migration is expected to take less then 1 minute
- The migration is expected to take less then 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.
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.
Dependencies
- github.com/filecoin-project/go-state-types (
v0.14.0-dev
->v0.14.0-rc5
) - github.com/filecoin-project/filecoin-ffi (
v1.27.0-rc2
->v1.28.0-rc2
) ref-fvm4
(as part offilecoin-ffi
) (4.2.0
->4.3.1
)- A new
github.com/filecoin-project/go-f3
dependency for F3 soft launch (v0.0.2
)
Others
- Soft launch of F3 (#12119)
- NI-PoRep changes (#12130)
- Fixes for the ETH events API (#12080)
- Support for legacy Ethereum transactions (#11969)
- Ignore market balance after nv23 (#11976)
- Add finality-related params for
eth_getBlockByNumber
(#12110) - rename
Actor.Address
toActor.DelegatedAddress
and only use it for f4 addresses (#12155) - feat:ec: integrate F3 dynamic manifest #12185
- fix: f3: Fix F3 build parameters for testground target (#12189) (filecoin-project/lotus#12189)
- fix: eth_getLogs: #12212
- feat: Add trace transaction API supporting RPC method
trace_transaction
(filecoin-project/lotus#12068)
v1.28.0-rc4
This is the fourth release candidate of the upcoming MANDATORY Lotus v1.28.0 release, which will deliver the Filecoin network version 23, codenamed Waffle 🧇.
This release candidate sets the calibration network to upgrade at epoch 1779094, corresponding to 2024-07-11T12:00:00Z. This release does NOT set the mainnet upgrade epoch yet, in which will be updated in the final release.
Compared to Lotus v1.28.0-rc3, the Lotus v1.28.0-rc4
release addresses an issue that allows us to publish Docker builds.
☢️ Upgrade Warnings ☢️
- If you are running the
v1.26.0
or an earlier version of Lotus, please go through theUpgrade Warnings
section for thev1.27.*
releases, before upgrading to this RC. - This version includes an additional migration to the events database. Node operators running Lotus with events turned on (off by default) may experience some delay in initial start-up of Lotus as a minor database migration takes place. See filecoin-project/lotus#12080 for full details.
The Filecoin network version 23 delivers the following FIPs:
- FIP-0065: Ignore built-in market locked balance in circulating supply calculation
- FIP-0079: Add BLS Aggregate Signatures to FVM
- FIP-0084: Remove Storage Miner Actor Method ProveCommitSectors
- FIP-0085: Convert f090 Mining Reserve Actor to Keyless Account Actor
- FIP-0091: Add support for legacy Ethereum transactions
- FIP-0092: NI-PoRep
- FIP-0086: Fast Finality Soft Launch
Note that we are only doing a "soft launch"/"passive testing" for F3 (Fast Finality) i.e. FIP-0086 in NV23. Please see this doc for more details.
v14 Builtin Actor Bundle
The actor bundles for the calibration network can be checked as follows:
lotus state actor-cids --network-version=23
Network Version: 23
Actor Version: 14
Manifest CID: bafy2bzacebq3hncszqpojglh2dkwekybq4zn6qpc4gceqbx36wndps5qehtau
Actor CID
account bafk2bzaced5ecfm56dvtw26q56j4d32yoccyd7ggxn3qdki2enxpqqav45ths
cron bafk2bzacedpbtttpyvtjncqoyobr63mhqqtlrygbnudhxyp2vha56f626dkfs
datacap bafk2bzacecded3lcvo7ndsk66samyecw2trnhrgzi7jxsary3sqgopxlk6rku
eam bafk2bzacecsda4uw7dcu76a27gnrrdcm73tgms7wrte6jbou63vloktkqc5ne
ethaccount bafk2bzacebu2lcxfmohomjj3umslnylwugf5gssywdq3575tjarta7o227dls
evm bafk2bzacea4xnekruhfmdnzvzeo6cbf7jsfgco6x5wje2ckwc2ui2ojzcrlgu
init bafk2bzacedfmsdlewihdcrkdepnfata26nj7akbvexzs3chicujhjf2uxsazc
multisig bafk2bzacedwx4svscsp6wqqu2vlcunjihvvm4u2jnsqjkwutjhir7dwtl7z6m
paymentchannel bafk2bzacedbit7oo6lryhbo64uikvtjtfcth6oxwy3eebxerenu2h7rj44n24
placeholder bafk2bzacedfvut2myeleyq67fljcrw4kkmn5pb5dpyozovj7jpoez5irnc3ro
reward bafk2bzaced5rlycj7fzpscfc7p3wwxarngwqylqshj7te3uffey5tevunz4we
storagemarket bafk2bzaceatwbyrec2nnwggxc2alpqve7rl52fmbhqflebuxmmnvg3qckjb7c
storageminer bafk2bzacecr7ozkdz7l2pq3ig5qxae2ysivbnojhsn4gw3o57ov4mhksma7me
storagepower bafk2bzacedgeolvjtnw7fkji5kqmx322abv6uls2v34fuml6nw36dvfcw4mtu
system bafk2bzacederl6tlpieldsn6mkndqwd4wj5orfoqgab6p2klswfn3cjagxwla
verifiedregistry bafk2bzaceczw2kp6gjjdcjbso7mewp7guik7gr525pal6dotdja2lrct6ok3c
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 NV23 upgrade is expected to be light with no heavy pre-migrations, here are some expected timings and resource consumption numbers:
- Pre-Migration is expected to take less then 1 minute
- The migration is expected to take less then 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.
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.
Dependencies
- github.com/filecoin-project/go-state-types (
v0.14.0-dev
->v0.14.0-rc5
) - github.com/filecoin-project/filecoin-ffi (
v1.27.0-rc2
->v1.28.0-rc2
) ref-fvm4
(as part offilecoin-ffi
) (4.2.0
->4.3.1
)- A new
github.com/filecoin-project/go-f3
dependency for F3 soft launch (v0.0.2
)
Others
- Soft launch of F3 (#12119)
- NI-PoRep changes (#12130)
- Fixes for the ETH events API (#12080)
- Support for legacy Ethereum transactions (#11969)
- Ignore market balance after nv23 (#11976)
- Add finality-related params for
eth_getBlockByNumber
(#12110) - rename
Actor.Address
toActor.DelegatedAddress
and only use it for f4 addresses (#12155) - feat:ec: integrate F3 dynamic manifest #12185
- fix: f3: Fix F3 build parameters for testground target (#12189) (filecoin-project/lotus#12189)
v1.28.0-rc3
This is the third release candidate of the upcoming MANDATORY Lotus v1.28.0 release, which will deliver the Filecoin network version 23, codenamed Waffle 🧇.
This release candidate sets the calibration network to upgrade at epoch 1779094, corresponding to 2024-07-11T12:00:00Z. This release does NOT set the mainnet upgrade epoch yet, in which will be updated in the final release.
Compared to Lotus v1.28.0-rc2
, the Lotus v1.28.0-rc3
introduces the manifest for the "control" nodes for F3 passive testing. This change shouldn't have any impact on production nodes.
☢️ Upgrade Warnings ☢️
If you are running the v1.26.0
or an earlier version of Lotus, please go through the Upgrade Warnings
section for the v1.27.*
releases, before upgrading to this RC.
- This upgrade includes an additional migration to the events database. Node operators running Lotus with events turned on (off by default) may experience some delay in initial start-up of Lotus as a minor database migration takes place. See filecoin-project/lotus#12080 for full details.
The Filecoin network version 23 delivers the following FIPs:
- FIP-0065: Ignore built-in market locked balance in circulating supply calculation
- FIP-0079: Add BLS Aggregate Signatures to FVM
- FIP-0084: Remove Storage Miner Actor Method ProveCommitSectors
- FIP-0085: Convert f090 Mining Reserve Actor to Keyless Account Actor
- FIP-0091: Add support for legacy Ethereum transactions
- FIP-0092: NI-PoRep
- FIP-0086: Fast Finality Soft Launch
Note that we are only doing a "soft launch"/"passive testing" for F3 (Fast Finality) i.e. FIP-0086 in NV23. Please see this doc for more details.
v14 Builtin Actor Bundle
The actor bundles for the calibration network can be checked as follows:
lotus state actor-cids --network-version=23
Network Version: 23
Actor Version: 14
Manifest CID: bafy2bzacebq3hncszqpojglh2dkwekybq4zn6qpc4gceqbx36wndps5qehtau
Actor CID
account bafk2bzaced5ecfm56dvtw26q56j4d32yoccyd7ggxn3qdki2enxpqqav45ths
cron bafk2bzacedpbtttpyvtjncqoyobr63mhqqtlrygbnudhxyp2vha56f626dkfs
datacap bafk2bzacecded3lcvo7ndsk66samyecw2trnhrgzi7jxsary3sqgopxlk6rku
eam bafk2bzacecsda4uw7dcu76a27gnrrdcm73tgms7wrte6jbou63vloktkqc5ne
ethaccount bafk2bzacebu2lcxfmohomjj3umslnylwugf5gssywdq3575tjarta7o227dls
evm bafk2bzacea4xnekruhfmdnzvzeo6cbf7jsfgco6x5wje2ckwc2ui2ojzcrlgu
init bafk2bzacedfmsdlewihdcrkdepnfata26nj7akbvexzs3chicujhjf2uxsazc
multisig bafk2bzacedwx4svscsp6wqqu2vlcunjihvvm4u2jnsqjkwutjhir7dwtl7z6m
paymentchannel bafk2bzacedbit7oo6lryhbo64uikvtjtfcth6oxwy3eebxerenu2h7rj44n24
placeholder bafk2bzacedfvut2myeleyq67fljcrw4kkmn5pb5dpyozovj7jpoez5irnc3ro
reward bafk2bzaced5rlycj7fzpscfc7p3wwxarngwqylqshj7te3uffey5tevunz4we
storagemarket bafk2bzaceatwbyrec2nnwggxc2alpqve7rl52fmbhqflebuxmmnvg3qckjb7c
storageminer bafk2bzacecr7ozkdz7l2pq3ig5qxae2ysivbnojhsn4gw3o57ov4mhksma7me
storagepower bafk2bzacedgeolvjtnw7fkji5kqmx322abv6uls2v34fuml6nw36dvfcw4mtu
system bafk2bzacederl6tlpieldsn6mkndqwd4wj5orfoqgab6p2klswfn3cjagxwla
verifiedregistry bafk2bzaceczw2kp6gjjdcjbso7mewp7guik7gr525pal6dotdja2lrct6ok3c
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 NV23 upgrade is expected to be light with no heavy pre-migrations, here are some expected timings and resource consumption numbers:
- Pre-Migration is expected to take less then 1 minute
- The migration is expected to take less then 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.
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.
Dependencies
- github.com/filecoin-project/go-state-types (
v0.14.0-dev
->v0.14.0-rc5
) - github.com/filecoin-project/filecoin-ffi (
v1.27.0-rc2
->v1.28.0-rc2
) ref-fvm4
(as part offilecoin-ffi
) (4.2.0
->4.3.1
)- A new
github.com/filecoin-project/go-f3
dependency for F3 soft launch (v0.0.2
)
Others
- Soft launch of F3 (#12119)
- NI-PoRep changes (#12130)
- Fixes for the ETH events API (#12080)
- Support for legacy Ethereum transactions (#11969)
- Ignore market balance after nv23 (#11976)
- Add finality-related params for
eth_getBlockByNumber
(#12110) - rename
Actor.Address
toActor.DelegatedAddress
and only use it for f4 addresses (#12155) - feat:ec: integrate F3 dynamic manifest #12185
v1.28.0-rc2
This is the second release candidate of the upcoming MANDATORY Lotus v1.28.0 release, which will deliver the Filecoin network version 23, codenamed Waffle 🧇.
This release candidate sets the calibration network to upgrade at epoch 1779094, corresponding to 2024-07-11T12:00:00Z. This release does NOT set the mainnet upgrade epoch yet, in which will be updated in the final release.
☢️ Upgrade Warnings ☢️
- If you are running the
v1.26.x
or an earlier version of Lotus, please go through theUpgrade Warnings
section for thev1.27.*
releases, before upgrading to this RC. - This upgrade includes an additional migration to the events database. Node operators running Lotus with events turned on (off by default) may experience some delay in initial start-up of Lotus as a minor database migration takes place. See filecoin-project/lotus#12080 for full details.
The Filecoin network version 23 delivers the following FIPs:
- FIP-0065: Ignore built-in market locked balance in circulating supply calculation
- FIP-0079: Add BLS Aggregate Signatures to FVM
- FIP-0084: Remove Storage Miner Actor Method ProveCommitSectors
- FIP-0085: Convert f090 Mining Reserve Actor to Keyless Account Actor
- FIP-0091: Add support for legacy Ethereum transactions
- FIP-0092: NI-PoRep
- FIP-0086: Fast Finality Soft Launch
Note that we are only doing a "soft launch"/"passive testing" for F3 (Fast Finality) i.e. FIP-0086 in NV23. Please see this doc for more details.
v14 Builtin Actor Bundle
The actor bundles for the calibration network can be checked as follows:
lotus state actor-cids --network-version=23
Network Version: 23
Actor Version: 14
Manifest CID: bafy2bzacebq3hncszqpojglh2dkwekybq4zn6qpc4gceqbx36wndps5qehtau
Actor CID
account bafk2bzaced5ecfm56dvtw26q56j4d32yoccyd7ggxn3qdki2enxpqqav45ths
cron bafk2bzacedpbtttpyvtjncqoyobr63mhqqtlrygbnudhxyp2vha56f626dkfs
datacap bafk2bzacecded3lcvo7ndsk66samyecw2trnhrgzi7jxsary3sqgopxlk6rku
eam bafk2bzacecsda4uw7dcu76a27gnrrdcm73tgms7wrte6jbou63vloktkqc5ne
ethaccount bafk2bzacebu2lcxfmohomjj3umslnylwugf5gssywdq3575tjarta7o227dls
evm bafk2bzacea4xnekruhfmdnzvzeo6cbf7jsfgco6x5wje2ckwc2ui2ojzcrlgu
init bafk2bzacedfmsdlewihdcrkdepnfata26nj7akbvexzs3chicujhjf2uxsazc
multisig bafk2bzacedwx4svscsp6wqqu2vlcunjihvvm4u2jnsqjkwutjhir7dwtl7z6m
paymentchannel bafk2bzacedbit7oo6lryhbo64uikvtjtfcth6oxwy3eebxerenu2h7rj44n24
placeholder bafk2bzacedfvut2myeleyq67fljcrw4kkmn5pb5dpyozovj7jpoez5irnc3ro
reward bafk2bzaced5rlycj7fzpscfc7p3wwxarngwqylqshj7te3uffey5tevunz4we
storagemarket bafk2bzaceatwbyrec2nnwggxc2alpqve7rl52fmbhqflebuxmmnvg3qckjb7c
storageminer bafk2bzacecr7ozkdz7l2pq3ig5qxae2ysivbnojhsn4gw3o57ov4mhksma7me
storagepower bafk2bzacedgeolvjtnw7fkji5kqmx322abv6uls2v34fuml6nw36dvfcw4mtu
system bafk2bzacederl6tlpieldsn6mkndqwd4wj5orfoqgab6p2klswfn3cjagxwla
verifiedregistry bafk2bzaceczw2kp6gjjdcjbso7mewp7guik7gr525pal6dotdja2lrct6ok3c
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 NV23 upgrade is expected to be light with no heavy pre-migrations, here are some expected timings and resource consumption numbers:
- Pre-Migration is expected to take less then 1 minute
- The migration is expected to take less then 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.
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.
Dependencies
- github.com/filecoin-project/go-state-types (
v0.14.0-dev
->v0.14.0-rc5
) - github.com/filecoin-project/filecoin-ffi (
v1.27.0-rc2
->v1.28.0-rc2
) ref-fvm4
(as part offilecoin-ffi
) (4.2.0
->4.3.1
)- A new
github.com/filecoin-project/go-f3
dependency for F3 soft launch (v0.0.2
)
Others
- Soft launch of F3 (#12119)
- NI-PoRep changes (#12130)
- Fixes for the ETH events API (#12080)
- Support for legacy Ethereum transactions (#11969)
- Ignore market balance after nv23 (#11976)
- Add finality-related params for
eth_getBlockByNumber
(#12110) - rename
Actor.Address
toActor.DelegatedAddress
and only use it for f4 addresses (#12155)
v1.28.0-rc1
This is the first release candidate of the upcoming MANDATORY Lotus v1.28.0 release, which will deliver the Filecoin network version 23, codenamed Waffle 🧇
This release candidate does NOT set a calibration network upgrade epoch, it will be added in the second release candidate, expected to be released July 4th. This release candidate does NOT set the mainnet upgrade epoch yet, which will be updated in the final release.
☢️ Upgrade Warnings ☢️
If you are running the v1.26.0
or an earlier version of Lotus, please go through the Upgrade Warnings
section for the v1.27.*
releases, before upgrading to this RC.
The Filecoin network version 23 delivers the following FIPs:
- FIP-0065: Ignore built-in market locked balance in circulating supply calculation
- FIP-0079: Add BLS Aggregate Signatures to FVM
- FIP-0084: Remove Storage Miner Actor Method ProveCommitSectors
- FIP-0085: Convert f090 Mining Reserve Actor to Keyless Account Actor
- FIP-0091: Add support for legacy Ethereum transactions
- FIP-0092: NI-PoRep
- FIP-0086: Fast Finality Soft Launch
Note that we are only doing a "soft launch"/"passive testing" for F3 (Fast Finality) i.e. FIP-0086 in NV23. Please see this doc for more details.
v14 Builtin Actor Bundle
The actor bundles for the calibration network can be checked as follows:
lotus state actor-cids --network-version=23
Network Version: 23
Actor Version: 14
Manifest CID: bafy2bzacebq3hncszqpojglh2dkwekybq4zn6qpc4gceqbx36wndps5qehtau
Actor CID
account bafk2bzaced5ecfm56dvtw26q56j4d32yoccyd7ggxn3qdki2enxpqqav45ths
cron bafk2bzacedpbtttpyvtjncqoyobr63mhqqtlrygbnudhxyp2vha56f626dkfs
datacap bafk2bzacecded3lcvo7ndsk66samyecw2trnhrgzi7jxsary3sqgopxlk6rku
eam bafk2bzacecsda4uw7dcu76a27gnrrdcm73tgms7wrte6jbou63vloktkqc5ne
ethaccount bafk2bzacebu2lcxfmohomjj3umslnylwugf5gssywdq3575tjarta7o227dls
evm bafk2bzacea4xnekruhfmdnzvzeo6cbf7jsfgco6x5wje2ckwc2ui2ojzcrlgu
init bafk2bzacedfmsdlewihdcrkdepnfata26nj7akbvexzs3chicujhjf2uxsazc
multisig bafk2bzacedwx4svscsp6wqqu2vlcunjihvvm4u2jnsqjkwutjhir7dwtl7z6m
paymentchannel bafk2bzacedbit7oo6lryhbo64uikvtjtfcth6oxwy3eebxerenu2h7rj44n24
placeholder bafk2bzacedfvut2myeleyq67fljcrw4kkmn5pb5dpyozovj7jpoez5irnc3ro
reward bafk2bzaced5rlycj7fzpscfc7p3wwxarngwqylqshj7te3uffey5tevunz4we
storagemarket bafk2bzaceatwbyrec2nnwggxc2alpqve7rl52fmbhqflebuxmmnvg3qckjb7c
storageminer bafk2bzacecr7ozkdz7l2pq3ig5qxae2ysivbnojhsn4gw3o57ov4mhksma7me
storagepower bafk2bzacedgeolvjtnw7fkji5kqmx322abv6uls2v34fuml6nw36dvfcw4mtu
system bafk2bzacederl6tlpieldsn6mkndqwd4wj5orfoqgab6p2klswfn3cjagxwla
verifiedregistry bafk2bzaceczw2kp6gjjdcjbso7mewp7guik7gr525pal6dotdja2lrct6ok3c
Migration
The NV23 upgrade migration is expected to be extremely light as only FIP-0085 requires a migration. We don't expect null tipsets after the upgrade epoch or heavy block validation times. We will updated this sections once we have run the final benchmarks.
Dependencies
- github.com/filecoin-project/go-state-types (
v0.14.0-dev
->v0.14.0-rc5
) - github.com/filecoin-project/filecoin-ffi (
v1.27.0-rc2
->v1.28.0-rc2
) ref-fvm4
(as part offilecoin-ffi
) (4.2.0
->4.3.1
)- A new
github.com/filecoin-project/go-f3
dependency for F3 soft launch (v0.0.2
)
Others
- Soft launch of F3 (#12119)
- NI-PoRep changes (#12130)
- Fixes for the ETH events API (#12080)
- Support for legacy Ethereum transactions (#11969)
- Ignore market balance after nv23 (#11976)
- Add finality-related params for
eth_getBlockByNumber
(#12110) - rename
Actor.Address
toActor.DelegatedAddress
and only use it for f4 addresses (#12155)
v1.27.1
This release, v1.27.1, is an OPTIONAL lotus release. It is HIGHLY RECOMMENDED for node operators that are building Filecoin index off lotus!
☢️ Upgrade Warnings ☢️
- This Lotus release completely removes the Legacy Lotus/Lotus-Miner Markets sub-system from the codebase, which was announced to reach EOL on January 31, 2023.
- The Curio Storage software, designed to simplify the setup and operation of storage providers, has moved to their own Github-repository: https:/filecoin-project/curio.
- The events subsystem includes some minor correctness fixes and performance improvements. Nodes operators running Lotus with events turned on (off by default) may experience some delay in initial start-up as a minor database migration takes place and the write-ahead log is compacted. See filecoin-project/lotus#11952 and filecoin-project/lotus#12090 for full details.
- As the events database migration is relatively straightforward in this upgrade, it may be possible to undo the migration for users needing to downgrade specifically from v1.27.1 to v1.27.0, although you are advised to have backups of your Lotus repo before attempting this. Details can be found at: #12073 (comment)
JSON-RPC 2.0 Specification Conformance
The JSON-RPC 2.0 specification requires that a "result"
property be present in the case of no error from an API call. This release ensures that all API calls that return a result have a "result"
property in the response. This is a behaviour change over Lotus v1.26 and will impact any API call that only has a single error return value, where no error has occurred.
For example, a successful WalletSetDefault
in v1.26 would return:
{
"jsonrpc": "2.0",
"id": 1
}
As of this change, in conformance with the JSON-RPC 2.0 specification it will return:
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
There is no change in the behaviour when a call returns an error, as the error object will still be present in the response.
New features
- feat: Add trace transaction API supporting RPC method
trace_transaction
(filecoin-project/lotus#12068) - feat: Skeleton for nv23 (#11964) (filecoin-project/lotus#11964)
- feat: state: Ignore market balance after nv23 (#11976) (filecoin-project/lotus#11976)
- feat: ETH compatibility in Filecoin : Support Homestead and EIP-155 Ethereum transactions("legacy" transactions) in Filecoin after NV23 (#11969) (filecoin-project/lotus#11969)
- fix: hello: avoid dialing when fetching hello tipset (#12032) (filecoin-project/lotus#12032)
- feat: cli,events: speed up backfill with temporary index (#11953) (filecoin-project/lotus#11953)
Improvements
- Event index should be unique for tipsets (#11952) (filecoin-project/lotus#11952)
- cleanup: Lotus client: Remove markets and deal-making from Lotus Client (#11999) (filecoin-project/lotus#11999)
- fix: ci: use filecoin-ffi hash to cache make deps outputs (#11961) (filecoin-project/lotus#11961)
- add ETH addrs API to Gateway (#11979) (filecoin-project/lotus#11979)
- chore: remove unmaintained bootstrappers (#11983) (filecoin-project/lotus#11983)
- feat: api: add SectorNumber to MarketDealState (nv22)
- fix: copy Flags field from SectorOnChainInfo
- fix: ETH RPC API: ETH Call should use the parent state root of the subsequent tipset (filecoin-project/lotus#11905)
- fix: events: sqlite db improvements (filecoin-project/lotus#12090)
Dependencies
- chore: libp2p: update to v0.34.1 (#12027) (filecoin-project/lotus#12027)
- chore: update drand (#12021) (filecoin-project/lotus#12021)
- Bump pubsub-dep (#11966) (filecoin-project/lotus#11966)
- fix: update go-jsonrpc to v0.3.2
- Bump go-jsonrpc to v0.4.0 (#12034) (filecoin-project/lotus#12034)
- docs: rpc: document go-jsonrpc behaviour change
- chore: update go-data-transfer and go-graphsync
- github.com/filecoin-project/go-jsonrpc (v0.3.1 -> v0.3.2)
- github.com/filecoin-project/go-state-types (v0.13.3 -> v0.14.0-dev)
Lotus-Miner / Curio related changes
- fix logs (#12036) (filecoin-project/lotus#12036)
- feat: curioweb: Improve task_history indexes (#11911) (filecoin-project/lotus#11911)
- fix: curio taskstorage: Don't try to free reservations by nulled TaskID (#12018) (filecoin-project/lotus#12018)
- fix actor string (#12019) (filecoin-project/lotus#12019)
- fix: curio: Update pgx imports, fix db_storage alloc
- feat: curioweb: Show piece info on the sector page (#11955) (filecoin-project/lotus#11955)
- curio: feat: break trees task into TreeD(prefetch) and TreeRC (#11895) (filecoin-project/lotus#11895)
- fix: curio: node UI & darwin gpu count (#11950) (filecoin-project/lotus#11950)
- feat: curio: Keep more sector metadata in the DB long-term (#11933) (filecoin-project/lotus#11933)
- fix: curio/lmrpc: Check ParkPiece success before creating sectors (#11975) (filecoin-project/lotus#11975)
- feat: curio: docker devnet (#11954) (filecoin-project/lotus#11954)
- feat: curio: alertManager (#11926) (filecoin-project/lotus#11926)
- curio cfg edit: ux cleanups (#11985) (filecoin-project/lotus#11985)
- fix: curio: Drop FKs from pipeline to fix retry loops (#11973) (filecoin-project/lotus#11973)
- Produce DEB files for amd64 for openCL and cuda (#11885) (filecoin-project/lotus#11885)
- gui-listen fix (#12013) (filecoin-project/lotus#12013)
- feat: curio: allow multiple pieces per sector (#11935) (filecoin-project/lotus#11935)
- chore: update yugabyte deps (#12022) (filecoin-project/lotus#12022)
- fix: harmonydb: Use timestampz instead of timestamp across the schema (#12030) (filecoin-project/lotus#12030)
- cleanup: miner: remove markets and deal-making from Lotus Miner (#12005) (filecoin-project/lotus#12005)
- fix non existing sector (#12012) (filecoin-project/lotus#12012)
- feat: curio ffiselect: Isolate gpu calls in a subprocess (#11994) (filecoin-project/lotus#11994)
- feat: curio: jsonrpc in webui (#11904) (filecoin-project/lotus#11904)
- fix: itests: Fix flaky curio itest (#12037) (filecoin-project/lotus#12037)
- feat: curio: wdPost and wnPost alerts (#12029) (filecoin-project/lotus#12029)
- fix: storage: Fix a race in GenerateWindowPoStAdv (#12064) (filecoin-project/lotus#12064)
- Remove "provider" relics (#11992) (filecoin-project/lotus#11992)
- fix sector UI (#12016) (filecoin-project/lotus#12016)
Others
- ci: deprecate circle ci in favour of github actions (#11786) (filecoin-project/lotus#11786)
- src: chain: remove C dependency from builtin types (#12015) (filecoin-project/lotus#12015)
- chore: fix function names (#12043) (filecoin-project/lotus#12043)
- chore: bump build version in master (#11946) (filecoin-project/lotus#11946)
- fix: test: no snap deals in immutable deadlines (#12071) (filecoin-project/lotus#12071)
- test: actors: manual CC onboarding and proving integration test (#12017) (filecoin-project/lotus#12017)
- fix: ci: keep lotus checkout clean in the release workflow (#12028) ([fileco...