github filecoin-project/lotus miner/v1.36.0-rc1

pre-release7 hours ago

This is the first release candidate of the upcoming MANDATORY Lotus v1.36.0 release, which will deliver the Filecoin network version 28, codenamed Fire Horse” 🔥🐎. This release candidate sets the upgrade epoch for the Calibration network to Epoch 3694534: 2026-05-07T14:00:00Z. See the local time for other timezones.

Mainnet activation is not yet scheduled in this release candidate, and will be determined after a succesful upgrade on Calibration network.

☢️ Upgrade Warnings ☢️

  • All Lotus node and Storage Provider (SP) operators on Calibration network must upgrade to this release candidate before the specified upgrade date for the Calibration network.
  • The minimum supported Go version is now 1.25.7. (filecoin-project/lotus#13594)

🏛️ Filecoin network version 28 FIPs and FRCs

📦 v18 Builtin Actor Bundle

This release candidate uses the v18.0.0 actor bundle

🚚 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 NV28 upgrade is expected to be light with no heavy pre-migrations:

  • Pre-Migration is expected to take less then 3 minutes.
  • The migration on the upgrade epoch is expected to take approximately 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 around 1 minute.
  • RAM usages is expected to be under 20GiB RAM for both the pre-migration and migration.

We recommend node operators (who haven’t enabled splitstore discard mode) that do not care about historical chain states, to prune the chain blockstore by syncing from a snapshot 1-2 days before the upgrade.

For certain node operators, such as full archival nodes or systems that need to keep large amounts of state (RPC providers), we recommend skipping the pre-migration and run the non-cached migration (i.e., just running the migration at the network upgrade epoch), and schedule for some additional downtime. Operators of such nodes can read the How to disable premigration in network upgrade tutorial.

⭐ New Features highlight

  • feat(cli): lotus wallet export gains a --format flag with a new hex-eth value that emits the raw 32-byte private key as hex, directly importable into Ethereum tools such as MetaMask, ethers.js, and Foundry. hex-eth is also accepted by lotus wallet import together with a --type flag (secp256k1 or delegated, defaulting to delegated). (filecoin-project/lotus#13586)
  • feat(cliutil): accept non-JWT API tokens in TOKEN:ADDRESS, enabling use of third-party RPC providers that issue opaque API keys. Multiaddrs using /wss or /tls now dial with wss://. (filecoin-project/lotus#13578)

🐛 Bug Fixes

  • fix(state): move StateGetRandomnessDigestFromBeacon into StateModule so lite nodes can serve the method correctly. (filecoin-project/lotus#13579)

📝 Changelog

For the set of changes since the last stable release:

👨‍👩‍👧‍👦 Contributors

Contributor Commits Lines ± Files Changed
Rod Vagg 8 +1931/-457 89
dependabot[bot] 14 +676/-103 28
Phi-rjan 9 +401/-353 47
Aryan Tikarya 1 +322/-11 5
beck 2 +182/-13 4
Phi 2 +71/-16 12
William Morriss 1 +4/-40 9
ledigang 1 +11/-11 11
Aditya Belgaonkar 1 +15/-0 9
hanabi1224 1 +4/-0 2
web3-bot 1 +1/-1 1

Don't miss a new lotus release

NewReleases is sending notifications on new releases.