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

• FIP-0112: Export Sector Status to FEVM
• FIP-0113: secp256r1 (P-256) P256VERIFY Precompile for FEVM
• FIP-0114: Add Support for EIP-7939 (CLZ Opcode) in the FEVM
• FIP-0115: Premium Percentile Base Fee Target

📦 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:

• Node and Miner: release/v1.35.1...release/v1.36.0

👨‍👩‍👧‍👦 Contributors

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

• FIP-0112: Export Sector Status to FEVM
• FIP-0113: secp256r1 (P-256) P256VERIFY Precompile for FEVM
• FIP-0114: Add Support for EIP-7939 (CLZ Opcode) in the FEVM
• FIP-0115: Premium Percentile Base Fee Target

📦 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:

• Node and Miner: release/v1.35.1...release/v1.36.0

👨‍👩‍👧‍👦 Contributors

This is the stable release of Lotus node v1.35.1, a patch release that extends EC finality tooling into the v2 API, Eth RPC, and lotus-shed, improves Ethereum RPC and gas estimation behavior, lowers several CLI batch defaults to reduce out-of-gas failures, and raises the minimum supported Golang version to 1.25.0. The final release also includes late backports for Ethereum RLP hardening, proof-parameter fetch robustness, indexed StateSearchMsg lookback handling, tightened Ethereum filter block-range enforcement, and null-round-aware EC finality chain walks.

☢️ Upgrade Warnings ☢️

• The minimum supported Golang version is now 1.25.0. (filecoin-project/lotus#13538)

⭐ New Features

• feat(api): integrate FRC-0089 EC finality calculator into v2 API and Eth RPC, so "finalized" and "safe" tags reflect actual chain health (~20-30 epochs) rather than worst-case static 900-epoch fallback. Adds ChainGetTipSetFinalityStatus v2 endpoint for finality diagnostics. (filecoin-project/lotus#13547)
• feat(shed): add lotus-shed finality-calculator for EC finality probability computation per FRC-0089 (filecoin-project/lotus#12093)

🐛 Bug Fixes

• fix(rlp): modernize and harden Ethereum RLP decoding with tighter canonical-encoding validation, explicit nesting and input bounds, and expanded roundtrip coverage for transaction parsing (filecoin-project/lotus#13555)
• fix(gateway): return ErrFilterNotFound instead of an empty result for unknown filter IDs in EthGetFilterLogs (filecoin-project/lotus#13519)
• fix(eth): handle failed contract creates with nil result addresses in trace_filter (filecoin-project/lotus#13549)
• fix(chainstore): remove expected CBOR decode warnings in GetCMessage for Ethereum-style transactions, reducing log spam on busy nodes (filecoin-project/lotus#13524)
• fix(net): update FIL DevTTY WebTransport certhashes in the mainnet bootstrap list (filecoin-project/lotus#13530)
• fix(gas): stricter bounds for GasEstimateGasPremium lookback (filecoin-project/lotus#13556)
• fix: remove duplicate SQL statement entries from preparedStatementMapping (filecoin-project/lotus#13545)
• fix(api): make StateSearchMsg respect lookbackLimit when returning indexed results (filecoin-project/lotus#13562)
• fix(eth): tighten block range handling for trace_filter and eth_getLogs, including consistent -32005 limit-exceeded errors and gateway range enforcement for trace_filter (filecoin-project/lotus#13561)
• fix(ecfinality): account for null rounds in EC finality calculator chain walk, aligning with FRC-0089 theoretical model and fixing depth-to-height conversion (filecoin-project/lotus#13565)

👌 Improvements

• perf(MessagePool): cache Pending() snapshots to reduce repeated message pool reconstruction work (filecoin-project/lotus#13542)
• chore(cli): lower default batch sizes for claim extension, deal settlement, and sector extension commands to reduce out-of-gas failures (filecoin-project/lotus#13537)
• chore(paramfetch): bump go-paramfetch to v0.0.5, improving parameter downloads by rejecting unexpected HTTP responses and avoiding redundant concurrent fetches (filecoin-project/lotus#13559)
• build(deps): bump github.com/ipfs/boxo to 0.37.0, github.com/drand/drand/v2 to 2.1.4, github.com/drand/kyber to 1.3.2, and github.com/libp2p/go-libp2p-kad-dht to 0.38.0 (filecoin-project/lotus#13541, filecoin-project/lotus#13510, filecoin-project/lotus#13516, filecoin-project/lotus#13502)

📝 Changelog

For the set of changes since the last stable release:

• Node: release/v1.35.0...release/v1.35.1

👨‍👩‍👧‍👦 Contributors

This is the stable release of Lotus node v1.35.1, a patch release that extends EC finality tooling into the v2 API, Eth RPC, and lotus-shed, improves Ethereum RPC and gas estimation behavior, lowers several CLI batch defaults to reduce out-of-gas failures, and raises the minimum supported Golang version to 1.25.0. The final release also includes late backports for Ethereum RLP hardening, proof-parameter fetch robustness, indexed StateSearchMsg lookback handling, tightened Ethereum filter block-range enforcement, and null-round-aware EC finality chain walks.

☢️ Upgrade Warnings ☢️

• The minimum supported Golang version is now 1.25.0. (filecoin-project/lotus#13538)

⭐ New Features

• feat(api): integrate FRC-0089 EC finality calculator into v2 API and Eth RPC, so "finalized" and "safe" tags reflect actual chain health (~20-30 epochs) rather than worst-case static 900-epoch fallback. Adds ChainGetTipSetFinalityStatus v2 endpoint for finality diagnostics. (filecoin-project/lotus#13547)
• feat(shed): add lotus-shed finality-calculator for EC finality probability computation per FRC-0089 (filecoin-project/lotus#12093)

🐛 Bug Fixes

• fix(rlp): modernize and harden Ethereum RLP decoding with tighter canonical-encoding validation, explicit nesting and input bounds, and expanded roundtrip coverage for transaction parsing (filecoin-project/lotus#13555)
• fix(gateway): return ErrFilterNotFound instead of an empty result for unknown filter IDs in EthGetFilterLogs (filecoin-project/lotus#13519)
• fix(eth): handle failed contract creates with nil result addresses in trace_filter (filecoin-project/lotus#13549)
• fix(chainstore): remove expected CBOR decode warnings in GetCMessage for Ethereum-style transactions, reducing log spam on busy nodes (filecoin-project/lotus#13524)
• fix(net): update FIL DevTTY WebTransport certhashes in the mainnet bootstrap list (filecoin-project/lotus#13530)
• fix(gas): stricter bounds for GasEstimateGasPremium lookback (filecoin-project/lotus#13556)
• fix: remove duplicate SQL statement entries from preparedStatementMapping (filecoin-project/lotus#13545)
• fix(api): make StateSearchMsg respect lookbackLimit when returning indexed results (filecoin-project/lotus#13562)
• fix(eth): tighten block range handling for trace_filter and eth_getLogs, including consistent -32005 limit-exceeded errors and gateway range enforcement for trace_filter (filecoin-project/lotus#13561)
• fix(ecfinality): account for null rounds in EC finality calculator chain walk, aligning with FRC-0089 theoretical model and fixing depth-to-height conversion (filecoin-project/lotus#13565)

👌 Improvements

• perf(MessagePool): cache Pending() snapshots to reduce repeated message pool reconstruction work (filecoin-project/lotus#13542)
• chore(cli): lower default batch sizes for claim extension, deal settlement, and sector extension commands to reduce out-of-gas failures (filecoin-project/lotus#13537)
• chore(paramfetch): bump go-paramfetch to v0.0.5, improving parameter downloads by rejecting unexpected HTTP responses and avoiding redundant concurrent fetches (filecoin-project/lotus#13559)
• build(deps): bump github.com/ipfs/boxo to 0.37.0, github.com/drand/drand/v2 to 2.1.4, github.com/drand/kyber to 1.3.2, and github.com/libp2p/go-libp2p-kad-dht to 0.38.0 (filecoin-project/lotus#13541, filecoin-project/lotus#13510, filecoin-project/lotus#13516, filecoin-project/lotus#13502)

📝 Changelog

For the set of changes since the last stable release:

• Node: release/v1.35.0...release/v1.35.1

👨‍👩‍👧‍👦 Contributors

This is a release candidate of a patch release that extends EC finality tooling into the v2 API, Eth RPC, and lotus-shed, improves Ethereum RPC and gas estimation behavior. It also lowers several CLI batch defaults to reduce out-of-gas failures and raises the minimum supported Golang version to 1.25.0.

☢️ Upgrade Warnings ☢️

• The minimum supported Golang version is now 1.25.0. (filecoin-project/lotus#13538)

⭐ New Features

• feat(api): integrate FRC-0089 EC finality calculator into v2 API and Eth RPC, so "finalized" and "safe" tags reflect actual chain health (~20-30 epochs) rather than worst-case static 900-epoch fallback. Adds ChainGetTipSetFinalityStatus v2 endpoint for finality diagnostics. (filecoin-project/lotus#13547)
• feat(shed): add lotus-shed finality-calculator for EC finality probability computation per FRC-0089 (filecoin-project/lotus#12093)

🐛 Bug Fixes

• fix(gateway): return ErrFilterNotFound instead of an empty result for unknown filter IDs in EthGetFilterLogs (filecoin-project/lotus#13519)
• fix(eth): handle failed contract creates with nil result addresses in trace_filter (filecoin-project/lotus#13549)
• fix(chainstore): remove expected CBOR decode warnings in GetCMessage for Ethereum-style transactions, reducing log spam on busy nodes (filecoin-project/lotus#13524)
• fix(net): update FIL DevTTY WebTransport certhashes in the mainnet bootstrap list (filecoin-project/lotus#13530)
• fix(gas): stricter bounds for GasEstimateGasPremium lookback (filecoin-project/lotus#13556)
• fix: remove duplicate SQL statement entries from preparedStatementMapping (filecoin-project/lotus#13545)

👌 Improvements

• perf(MessagePool): cache Pending() snapshots to reduce repeated message pool reconstruction work (filecoin-project/lotus#13542)
• chore(cli): lower default batch sizes for claim extension, deal settlement, and sector extension commands to reduce out-of-gas failures (filecoin-project/lotus#13537)
• build(deps): bump github.com/ipfs/boxo to 0.37.0, github.com/drand/drand/v2 to 2.1.4, github.com/drand/kyber to 1.3.2, and github.com/libp2p/go-libp2p-kad-dht to 0.38.0 (filecoin-project/lotus#13541, filecoin-project/lotus#13510, filecoin-project/lotus#13516, filecoin-project/lotus#13502)

📝 Changelog

For the set of changes since the last stable release:

• Node: release/v1.35.0...phi/prep-release-v1351-rc1

👨‍👩‍👧‍👦 Contributors

This is a release candidate of a patch release that extends EC finality tooling into the v2 API, Eth RPC, and lotus-shed, improves Ethereum RPC and gas estimation behavior. It also lowers several CLI batch defaults to reduce out-of-gas failures and raises the minimum supported Golang version to 1.25.0.

☢️ Upgrade Warnings ☢️

• The minimum supported Golang version is now 1.25.0. (filecoin-project/lotus#13538)

⭐ New Features

• feat(api): integrate FRC-0089 EC finality calculator into v2 API and Eth RPC, so "finalized" and "safe" tags reflect actual chain health (~20-30 epochs) rather than worst-case static 900-epoch fallback. Adds ChainGetTipSetFinalityStatus v2 endpoint for finality diagnostics. (filecoin-project/lotus#13547)
• feat(shed): add lotus-shed finality-calculator for EC finality probability computation per FRC-0089 (filecoin-project/lotus#12093)

🐛 Bug Fixes

• fix(gateway): return ErrFilterNotFound instead of an empty result for unknown filter IDs in EthGetFilterLogs (filecoin-project/lotus#13519)
• fix(eth): handle failed contract creates with nil result addresses in trace_filter (filecoin-project/lotus#13549)
• fix(chainstore): remove expected CBOR decode warnings in GetCMessage for Ethereum-style transactions, reducing log spam on busy nodes (filecoin-project/lotus#13524)
• fix(net): update FIL DevTTY WebTransport certhashes in the mainnet bootstrap list (filecoin-project/lotus#13530)
• fix(gas): stricter bounds for GasEstimateGasPremium lookback (filecoin-project/lotus#13556)
• fix: remove duplicate SQL statement entries from preparedStatementMapping (filecoin-project/lotus#13545)

👌 Improvements

• perf(MessagePool): cache Pending() snapshots to reduce repeated message pool reconstruction work (filecoin-project/lotus#13542)
• chore(cli): lower default batch sizes for claim extension, deal settlement, and sector extension commands to reduce out-of-gas failures (filecoin-project/lotus#13537)
• build(deps): bump github.com/ipfs/boxo to 0.37.0, github.com/drand/drand/v2 to 2.1.4, github.com/drand/kyber to 1.3.2, and github.com/libp2p/go-libp2p-kad-dht to 0.38.0 (filecoin-project/lotus#13541, filecoin-project/lotus#13510, filecoin-project/lotus#13516, filecoin-project/lotus#13502)

📝 Changelog

For the set of changes since the last stable release:

• Node: release/v1.35.0...phi/prep-release-v1351-rc1

👨‍👩‍👧‍👦 Contributors

The Lotus and Lotus-Miner v1.35.0 release includes Ethereum RPC compatibility improvements, CLI enhancements, and numerous dependency updates. Highlights include FRC-0102 signing envelope support, an Ethereum RPC error code correction for tooling compatibility, and updated OpenTelemetry tracing.

☢️ Upgrade Warnings ☢️

• Ethereum RPC error code change: EExecutionReverted now uses error code 3 (was 11) and EActorNotFound now uses error code 11 (was 3), aligning with standard Ethereum RPC tooling expectations. Mismatched client/server versions will deserialize these errors as the wrong Go type, breaking errors.Is/errors.As checks. (filecoin-project/lotus#13467)

⭐ New Features

• feat(cli): implement FRC-0102 signing envelope for wallet sign and wallet verify (filecoin-project/lotus#13388)
• feat(cli): add --order-by-nonce flag to list messages sequentially when filtering by sender (filecoin-project/lotus#13394)
• feat: add slog integration for libp2p log level control (filecoin-project/lotus#13442)

🐛 Bug Fixes

• fix(eth): use error code 3 for EExecutionReverted for Ethereum RPC tooling compatibility (filecoin-project/lotus#13467)
• fix(eth): fix eth_syncing result property casing & implement UnmarshalJSON for EthSyncingResult (filecoin-project/lotus#13484)
• fix(f3): set initial power table CID in calibnet F3 manifest (filecoin-project/lotus#13496)
• fix(itests): prevent wdPostLoop deadline skip race condition (filecoin-project/lotus#13464)

👌 Improvements

• chore(tracing): update OpenTelemetry semconv from v1.7.0 to v1.39.0 (filecoin-project/lotus#13511)
• chore(deps): replace golang.org/x/crypto/sha3 with go-keccak, upgrade x/crypto (filecoin-project/lotus#13477)
• chore: bump FFI to v1.34.6 (filecoin-project/lotus#13521)

📝 Changelog

For the set of changes since the last stable release:

• Node: release/v1.34.4...release/v1.35.0
• Miner: release/v1.34.4...release/miner/v1.35.0

👨‍👩‍👧‍👦 Contributors

Contributors

The Lotus and Lotus-Miner v1.35.0 release includes Ethereum RPC compatibility improvements, CLI enhancements, and numerous dependency updates. Highlights include FRC-0102 signing envelope support, an Ethereum RPC error code correction for tooling compatibility, and updated OpenTelemetry tracing.

☢️ Upgrade Warnings ☢️

• Ethereum RPC error code change: EExecutionReverted now uses error code 3 (was 11) and EActorNotFound now uses error code 11 (was 3), aligning with standard Ethereum RPC tooling expectations. Mismatched client/server versions will deserialize these errors as the wrong Go type, breaking errors.Is/errors.As checks. (filecoin-project/lotus#13467)

⭐ New Features

• feat(cli): implement FRC-0102 signing envelope for wallet sign and wallet verify (filecoin-project/lotus#13388)
• feat(cli): add --order-by-nonce flag to list messages sequentially when filtering by sender (filecoin-project/lotus#13394)
• feat: add slog integration for libp2p log level control (filecoin-project/lotus#13442)

🐛 Bug Fixes

• fix(eth): use error code 3 for EExecutionReverted for Ethereum RPC tooling compatibility (filecoin-project/lotus#13467)
• fix(eth): fix eth_syncing result property casing & implement UnmarshalJSON for EthSyncingResult (filecoin-project/lotus#13484)
• fix(f3): set initial power table CID in calibnet F3 manifest (filecoin-project/lotus#13496)
• fix(itests): prevent wdPostLoop deadline skip race condition (filecoin-project/lotus#13464)

👌 Improvements

• chore(tracing): update OpenTelemetry semconv from v1.7.0 to v1.39.0 (filecoin-project/lotus#13511)
• chore(deps): replace golang.org/x/crypto/sha3 with go-keccak, upgrade x/crypto (filecoin-project/lotus#13477)
• chore: bump FFI to v1.34.6 (filecoin-project/lotus#13521)

📝 Changelog

For the set of changes since the last stable release:

• Node: release/v1.34.4...release/v1.35.0
• Miner: release/v1.34.4...release/miner/v1.35.0

👨‍👩‍👧‍👦 Contributors

Contributors

This is a patch release that includes bug fixes and backports, notably the fr32 fix for Storage Provider compatibility and the F3 restart on calibnet.

Bug Fixes

• fix(eth): trace_filter returns [] for null round ranges (filecoin-project/lotus#13483)
• fix(f3): Update F3 manifest to restart F3 on calibnet (filecoin-project/lotus#13488)
• fix: drain F3 data reader when skipping F3 import during snapshot import (filecoin-project/lotus#13491)
• fix(fr32): Update go-commp-utils to include fr32 fixes for Storage Provider compatibility (filecoin-project/lotus#13455)

📝 Changelog

For the set of changes since the last stable release:

• Node: release/v1.34.3...release/v1.34.4-rc1

👨‍👩‍👧‍👦 Contributors

This is a patch release that includes bug fixes and backports, notably the fr32 fix for Storage Provider compatibility and the F3 restart on calibnet.

Bug Fixes

• fix(eth): trace_filter returns [] for null round ranges (filecoin-project/lotus#13483)
• fix(f3): Update F3 manifest to restart F3 on calibnet (filecoin-project/lotus#13488)
• fix: drain F3 data reader when skipping F3 import during snapshot import (filecoin-project/lotus#13491)
• fix(fr32): Update go-commp-utils to include fr32 fixes for Storage Provider compatibility (filecoin-project/lotus#13455)

📝 Changelog

For the set of changes since the last stable release:

• Node: release/v1.34.3...release/v1.34.4-rc1

👨‍👩‍👧‍👦 Contributors