Lotus Node v1.36.2 is a recommended patch release focused on Ethereum RPC correctness and compatibility, StateWaitMsg confidence handling, dependency reliability, and operator tooling.

☢️ Upgrade Warnings ☢️

• Tracing configuration has changed: the deprecated Jaeger exporter has been replaced by an OTLP HTTP exporter. The LOTUS_JAEGER_* environment variables are no longer supported; configure LOTUS_OTEL_EXPORTER_ENDPOINT and LOTUS_OTEL_EXPORTER_INSECURE instead. (filecoin-project/lotus#13533)

⭐ New Features

• feat(lotus-shed): accept Ethereum transaction hashes in msg (filecoin-project/lotus#13727)
• feat(cli): lotus-miner actor settle-deal now uses gas-aware adaptive batching — deal batches whose estimated gas would exceed a fraction of the block gas limit (tunable via --max-gas-fraction, default 1/4) are automatically split so no single SettleDealPaymentsExported message hogs block capacity (filecoin-project/lotus#13669)

🐛 Bug Fixes

• fix(eth): eth_call and eth_estimateGas now accept a from address that is an EVM contract or that doesn't exist on chain, matching Geth and unblocking tooling that simulates from such senders (Safe SDK EIP-1271 signature checks, gas estimation before an account is funded). (filecoin-project/lotus#13724)
• fix(api): StateWaitMsg now honors non-zero confidence when the message was executed by the current head at call time, waiting for the requested depth and tracking reverts instead of returning immediately. Full nodes reject confidence above chain finality (currently 900 epochs); lotus-gateway defaults to a 20-epoch maximum, configurable with --api-wait-confidence-limit (filecoin-project/lotus#13705)
• fix(eth): resolve native Filecoin transaction recipients in eth_getTransactionByBlockHashAndIndex and eth_getTransactionByBlockNumberAndIndex against the block post-state, matching eth_getBlockByNumber and eth_getTransactionByHash for transfers that create the recipient account (filecoin-project/lotus#13699)
• fix(eth): return ErrNullRound for explicit null epochs in singleton block-execution ETH APIs. eth_getBlockReceipts / EthGetBlockReceiptsLimited now reject a null block number instead of returning receipts for the previous non-null tipset. State-at-epoch APIs such as eth_getBalance, eth_getCode, eth_getStorageAt, eth_getTransactionCount, eth_call, eth_estimateGas, and FilecoinAddressToEthAddress continue to resolve null epochs to the previous non-null tipset because Filecoin state is defined at the null epoch and is unchanged from that previous state. Range/sampling APIs such as eth_feeHistory also continue to walk real tipsets and skip null epochs, including when resolving a null newestBlock anchor to the previous non-null tipset. (filecoin-project/lotus#13694)
• fix(eth): return null from eth_getTransactionByHash and eth_getTransactionReceipt for transaction hashes that were replaced before execution, matching Ethereum replacement semantics (filecoin-project/lotus#13664)
• fix(eth): eth_getLogs, eth_newFilter and the logs variant of eth_subscribe now reject a filter that specifies more than 4 topic positions, matching the Ethereum JSON-RPC spec and go-ethereum. Previously the surplus positions were accepted but could never match an event (EVM logs carry at most t1..t4), so the filter silently returned no results while still adding one event-index join per position. (filecoin-project/lotus#13676)
• fix(eth): reject malformed EthNonce JSON values that do not decode to exactly 8 bytes instead of panicking on short inputs or silently truncating long inputs. (filecoin-project/lotus#13696)

👌 Improvements

• chore(deps): update go-libp2p-pubsub to v0.17.0. Lotus now uses the replacement outbound-stream trace events and the Google Protobuf size API. (filecoin-project/lotus#13707)
• chore(deps): update libp2p networking dependencies. This includes libp2p's updated handling of unspecified listen addresses, so nodes listening on 0.0.0.0/:: may report or advertise concrete interface addresses returned by libp2p. (filecoin-project/lotus#13588)
• chore(deps): update go-jsonrpc to v0.10.2 and go-f3 to v0.8.14, including WebSocket ping handling, response/channel hardening, and delayed F3 bootstrap retry throttling. (filecoin-project/lotus#13726)
• chore(bootstrap): use /dnsaddr for ChainSafe bootstrap peers to allow peer changes through DNS, and remove the inactive fil.devtty.eu peers. (filecoin-project/lotus#13715)

📝 Changelog

For the full set of changes since the last stable release:

• Node: release/v1.36.1...release/v1.36.2

👨‍👩‍👧‍👦 Contributors

This is the stable release of Lotus Node and Miner v1.36.1, a recommended patch release focused on Ethereum RPC correctness, gateway API alignment, and release/build reliability.

☢️ Upgrade Warnings ☢️

• There are no upgrade warnings for this release.

⭐ New Features

• feat(eth): add eth_baseFee JSON-RPC method returning the base fee for the next block, matching geth behavior via ComputeBaseFee on the current tipset (filecoin-project/lotus#13615)

🐛 Bug Fixes

• fix(rpc): GasEstimateMessageGas no longer panics when estimating messages with an empty To or From address (filecoin-project/lotus#13672)
• fix(api): trace transaction api returns the correct error (filecoin-project/lotus#13614)
• fix(cli): warn when lotus daemon --api overrides the configured API.ListenAddress / LOTUS_API_LISTENADDRESS, making the selected API endpoint visible to operators (filecoin-project/lotus#13670)
• fix(cli): RPC API URLs ending with a trailing slash no longer produce duplicate slashes before /rpc/<version> (filecoin-project/lotus#13662)
• Fix off-by-one in transactionPosition returned by trace_block, trace_filter and trace_transaction. Positions were 1-indexed; per the Ethereum trace API spec they are 0-indexed and must match the corresponding transactionIndex from eth_getBlockByNumber. (filecoin-project/lotus#13610)
• fix(eth): eth_getTransactionReceipt no longer fails when another transaction in the same block emits a large number of events. MaxFilterResults now caps only multi-tipset event queries; single-block calls (eth_getLogs with BlockHash, eth_getBlockReceipts, eth_getTransactionReceipt) bypass it. Public RPC operators should apply rate and response-size limits at the proxy layer for these calls; a single response can be large when a block contains log-heavy transactions (filecoin-project/lotus#13617)
• fix(eth): return indexed block-level logsBloom for eth_getBlockByHash, eth_getBlockByNumber, and new-head subscription payloads when chain-index bloom data is available; existing tipsets without bloom rows continue to fall back to the previous full bloom. This adds a chain index DB migration for the tipset_bloom table and requires no RPC-provider config changes. (filecoin-project/lotus#13618)
• fix(gateway): align v2 RPC surface (/rpc/v2) with v1; remove *Limited and *Untrusted eth method variants (filecoin-project/lotus#13628)
• fix(eth): eth_call, eth_estimateGas and StateCall are no longer refused at the epoch immediately after an expensive network-upgrade migration; that block's migrated state is already available, so only the upgrade epoch itself is refused. This unblocks indexers that replay eth_call at the block of each event. The refusal now returns a typed error with the registered JSON-RPC code -32002 and a recognisable message, instead of the generic application code 1 (filecoin-project/lotus#13644)
• fix: update Filecoin FFI to v1.36.1 (filecoin-project/lotus#13663)
• fix(build): ffi-version-check now depends on the module update (filecoin-project/lotus#13658)
• fix: docker builds Lotus on bullseye again (filecoin-project/lotus#13611)
• fix: remove F3 data with existing chain cleanup (filecoin-project/lotus#13609)

👌 Improvements

• Silence libp2p config log spam (filecoin-project/lotus#13612)
• feat(mempool): raise the default per-actor cap on the untrusted push path (MaxUntrustedActorPendingMessages) from 10 to 100, reducing spurious ErrTooManyPendingMessages rejections for normal-cadence senders relaying through lotus-gateway / public RPC (filecoin-project/lotus#13636)
• chore(cli): lotus-miner info supports --actor to query any miner without a local miner repo; miner-daemon-only sections are skipped when --actor is set (filecoin-project/lotus#13641)
• chore: remove obsolete network-version guards across CLI, state-manager, storage, and miner code. (filecoin-project/lotus#13680)
• feat: update mainnet.pi to remove the Venus bootstrap peer (filecoin-project/lotus#13648)

📝 Changelog

For the full set of changes since the last stable release:

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

Changes since RC1

• fix(cli): warn when lotus daemon --api overrides the configured API listen address (filecoin-project/lotus#13670)
• chore: bump go-state-types to v0.19.0-rc1 (filecoin-project/lotus#13671)
• fix(rpc): harden GasEstimateMessageGas handling for messages with empty To or From addresses (filecoin-project/lotus#13672)
• chore: remove obsolete network-version guards across CLI, state-manager, storage, and miner code (filecoin-project/lotus#13680)

👨‍👩‍👧‍👦 Contributors

This is the stable release of Lotus Node and Miner v1.36.1, a recommended patch release focused on Ethereum RPC correctness, gateway API alignment, and release/build reliability.

☢️ Upgrade Warnings ☢️

• There are no upgrade warnings for this release.

⭐ New Features

• feat(eth): add eth_baseFee JSON-RPC method returning the base fee for the next block, matching geth behavior via ComputeBaseFee on the current tipset (filecoin-project/lotus#13615)

🐛 Bug Fixes

• fix(rpc): GasEstimateMessageGas no longer panics when estimating messages with an empty To or From address (filecoin-project/lotus#13672)
• fix(api): trace transaction api returns the correct error (filecoin-project/lotus#13614)
• fix(cli): warn when lotus daemon --api overrides the configured API.ListenAddress / LOTUS_API_LISTENADDRESS, making the selected API endpoint visible to operators (filecoin-project/lotus#13670)
• fix(cli): RPC API URLs ending with a trailing slash no longer produce duplicate slashes before /rpc/<version> (filecoin-project/lotus#13662)
• Fix off-by-one in transactionPosition returned by trace_block, trace_filter and trace_transaction. Positions were 1-indexed; per the Ethereum trace API spec they are 0-indexed and must match the corresponding transactionIndex from eth_getBlockByNumber. (filecoin-project/lotus#13610)
• fix(eth): eth_getTransactionReceipt no longer fails when another transaction in the same block emits a large number of events. MaxFilterResults now caps only multi-tipset event queries; single-block calls (eth_getLogs with BlockHash, eth_getBlockReceipts, eth_getTransactionReceipt) bypass it. Public RPC operators should apply rate and response-size limits at the proxy layer for these calls; a single response can be large when a block contains log-heavy transactions (filecoin-project/lotus#13617)
• fix(eth): return indexed block-level logsBloom for eth_getBlockByHash, eth_getBlockByNumber, and new-head subscription payloads when chain-index bloom data is available; existing tipsets without bloom rows continue to fall back to the previous full bloom. This adds a chain index DB migration for the tipset_bloom table and requires no RPC-provider config changes. (filecoin-project/lotus#13618)
• fix(gateway): align v2 RPC surface (/rpc/v2) with v1; remove *Limited and *Untrusted eth method variants (filecoin-project/lotus#13628)
• fix(eth): eth_call, eth_estimateGas and StateCall are no longer refused at the epoch immediately after an expensive network-upgrade migration; that block's migrated state is already available, so only the upgrade epoch itself is refused. This unblocks indexers that replay eth_call at the block of each event. The refusal now returns a typed error with the registered JSON-RPC code -32002 and a recognisable message, instead of the generic application code 1 (filecoin-project/lotus#13644)
• fix: update Filecoin FFI to v1.36.1 (filecoin-project/lotus#13663)
• fix(build): ffi-version-check now depends on the module update (filecoin-project/lotus#13658)
• fix: docker builds Lotus on bullseye again (filecoin-project/lotus#13611)
• fix: remove F3 data with existing chain cleanup (filecoin-project/lotus#13609)

👌 Improvements

• Silence libp2p config log spam (filecoin-project/lotus#13612)
• feat(mempool): raise the default per-actor cap on the untrusted push path (MaxUntrustedActorPendingMessages) from 10 to 100, reducing spurious ErrTooManyPendingMessages rejections for normal-cadence senders relaying through lotus-gateway / public RPC (filecoin-project/lotus#13636)
• chore(cli): lotus-miner info supports --actor to query any miner without a local miner repo; miner-daemon-only sections are skipped when --actor is set (filecoin-project/lotus#13641)
• chore: remove obsolete network-version guards across CLI, state-manager, storage, and miner code. (filecoin-project/lotus#13680)
• feat: update mainnet.pi to remove the Venus bootstrap peer (filecoin-project/lotus#13648)

📝 Changelog

For the full set of changes since the last stable release:

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

Changes since RC1

• fix(cli): warn when lotus daemon --api overrides the configured API listen address (filecoin-project/lotus#13670)
• chore: bump go-state-types to v0.19.0-rc1 (filecoin-project/lotus#13671)
• fix(rpc): harden GasEstimateMessageGas handling for messages with empty To or From addresses (filecoin-project/lotus#13672)
• chore: remove obsolete network-version guards across CLI, state-manager, storage, and miner code (filecoin-project/lotus#13680)

👨‍👩‍👧‍👦 Contributors

☢️ Upgrade Warnings ☢️

⭐ New Features

• feat(eth): add eth_baseFee JSON-RPC method returning the base fee for the next block, matching geth behavior via ComputeBaseFee on the current tipset (filecoin-project/lotus#13615)

🐛 Bug Fixes

• fix(api): trace transaction api returns the correct error (filecoin-project/lotus#13614)
• fix(cli): RPC API URLs ending with a trailing slash no longer produce duplicate slashes before /rpc/<version> (filecoin-project/lotus#13662)
• Fix off-by-one in transactionPosition returned by trace_block, trace_filter and trace_transaction. Positions were 1-indexed; per the Ethereum trace API spec they are 0-indexed and must match the corresponding transactionIndex from eth_getBlockByNumber. (filecoin-project/lotus#13610)
• fix(eth): eth_getTransactionReceipt no longer fails when another transaction in the same block emits a large number of events. MaxFilterResults now caps only multi-tipset event queries; single-block calls (eth_getLogs with BlockHash, eth_getBlockReceipts, eth_getTransactionReceipt) bypass it. Public RPC operators should apply rate and response-size limits at the proxy layer for these calls; a single response can be large when a block contains log-heavy transactions (filecoin-project/lotus#13617)
• fix(eth): return indexed block-level logsBloom for eth_getBlockByHash, eth_getBlockByNumber, and new-head subscription payloads when chain-index bloom data is available; existing tipsets without bloom rows continue to fall back to the previous full bloom. This adds a chain index DB migration for the tipset_bloom table and requires no RPC-provider config changes. (filecoin-project/lotus#13618)
• fix(gateway): align v2 RPC surface (/rpc/v2) with v1; remove *Limited and *Untrusted eth method variants (filecoin-project/lotus#13628)
• fix(eth): eth_call, eth_estimateGas and StateCall are no longer refused at the epoch immediately after an expensive network-upgrade migration; that block's migrated state is already available, so only the upgrade epoch itself is refused. This unblocks indexers (e.g. The Graph) that replay eth_call at the block of each event. The refusal now returns a typed error with the registered JSON-RPC code -32002 and a recognisable message, instead of the generic application code 1 (filecoin-project/lotus#13644)

👌 Improvements

• Silence libp2p config log spam (filecoin-project/lotus#13612)
• feat(mempool): raise the default per-actor cap on the untrusted push path (MaxUntrustedActorPendingMessages) from 10 to 100, reducing spurious ErrTooManyPendingMessages rejections for normal-cadence senders relaying through lotus-gateway / public RPC (filecoin-project/lotus#13636)
• chore(cli): lotus-miner info supports --actor to query any miner without a local miner repo; miner-daemon-only sections (subsystems, start time, alerts, workers, sectors) are skipped when --actor is set

Release Log

• github.com/filecoin-project/lotus:
  • Merge 2844f13 into 3865dcc
  • fix(eth): return indexed block logsBloom (#13618) (filecoin-project/lotus#13618)
  • fix: update filecoin-ffi to v1.36.1 (#13663) (filecoin-project/lotus#13663)
  • fix(cli): join API info RPC paths safely (#13662) (filecoin-project/lotus#13662)
  • fix(build): ffi-version-check should depend on module update (#13658) (filecoin-project/lotus#13658)
  • fix(eth): serve eth_call at the epoch after an expensive migration (#13644) (filecoin-project/lotus#13644)
  • chore: create nv29 Lotus skeleton (#13640) (filecoin-project/lotus#13640)
  • chore(cli): lotus-miner info supports --actor (#13641) (filecoin-project/lotus#13641)
  • feat: update mainnet.pi to remove venus bootstrap (#13648) (filecoin-project/lotus#13648)
  • build(deps): bump github.com/buger/jsonparser from 1.1.1 to 1.1.2 (#13646) (filecoin-project/lotus#13646)
  • build(deps): bump google.golang.org/grpc from 1.78.0 to 1.79.3 (#13647) (filecoin-project/lotus#13647)
  • docs: improve network skeleton workflow (#13639) (filecoin-project/lotus#13639)
  • feat(mempool): raise MaxUntrustedActorPendingMessages from 10 to 100 (#13636) (filecoin-project/lotus#13636)
  • fix(api): trace transaction api to return correct error (#13614) (filecoin-project/lotus#13614)
  • chore(release): cherry-pick v1.36.0 changelog back to master (#13627) (filecoin-project/lotus#13627)
  • fix(gateway): align v2 RPC surface with v1 (#13628) (filecoin-project/lotus#13628)
  • chore: fix sync issue (#13620) (filecoin-project/lotus#13620)
  • feat(eth): add eth_baseFee RPC method returning next block base fee (#13615) (filecoin-project/lotus#13615)
  • chore: set mainnet nv28 upgrade epoch (#13619) (filecoin-project/lotus#13619)
  • fix(eth): scope receipt logs by message, cap event filter across tipsets (#13617) (filecoin-project/lotus#13617)
  • chore(libp2p): silence libp2p config log spam (#13612) (filecoin-project/lotus#13612)
  • fix(eth): use 0-indexed transactionPosition in trace_block (#13610) (filecoin-project/lotus#13610)
  • fix: docker build Lotus on bullseye (#13611) (filecoin-project/lotus#13611)
  • fix: remove F3 data with existing chain cleanup (#13609) (filecoin-project/lotus#13609)
  • docs: fix some minor issues in the comments (#13583) (filecoin-project/lotus#13583)
  • build(deps): bump github.com/mattn/go-sqlite3 from 1.14.42 to 1.14.44 in the data-storage group across 1 directory (#13600) (filecoin-project/lotus#13600)
  • build(deps): bump github.com/gdamore/tcell/v2 from 2.13.8 to 2.13.9 (#13601) (filecoin-project/lotus#13601)
  • build(deps): bump github.com/Masterminds/semver/v3 from 3.4.0 to 3.5.0 (#13602) (filecoin-project/lotus#13602)
  • build(deps): bump github.com/mattn/go-isatty from 0.0.20 to 0.0.22 (#13603) (filecoin-project/lotus#13603)
  • build(deps): bump go.opentelemetry.io/otel/bridge/opencensus from 1.40.0 to 1.43.0 (#13604) (filecoin-project/lotus#13604)
  • build(deps): bump github.com/samber/lo from 1.52.0 to 1.53.0 (#13605) (filecoin-project/lotus#13605)
  • build(deps): bump golang.org/x/tools from 0.43.0 to 0.44.0 (#13606) (filecoin-project/lotus#13606)
  • chore: bump deps for release prep (#13597) (filecoin-project/lotus#13597)
  • build: update Lotus Node and Miner version to v1.36.1-dev in master (#13595) (filecoin-project/lotus#13595)
• github.com/filecoin-project/filecoin-ffi (v1.34.0 -> v1.36.1):
  • Bump version to v1.36.1 (#583) (filecoin-project/filecoin-ffi#583)
  • fix(deps): bump sppark to 0.1.15 (#582) (filecoin-project/filecoin-ffi#582)
  • chore: v1.36.1-dev release (#581) (filecoin-project/filecoin-ffi#581)
  • chore: add nv29 skeleton (#580) (filecoin-project/filecoin-ffi#580)
  • build(deps): bump wasmtime from 36.0.7 to 36.0.9 in /rust (#577) (filecoin-project/filecoin-ffi#577)
  • build(deps): bump rand from 0.8.5 to 0.8.6 in /rust (#575) (filecoin-project/filecoin-ffi#575)
  • chore: update version to stable (#576) (filecoin-project/filecoin-ffi#576)
  • chore: reduce install script output noise (#574) ([filecoin-project/filecoin-ffi#574](https://github.com/filecoin-projec...

☢️ Upgrade Warnings ☢️

⭐ New Features

• feat(eth): add eth_baseFee JSON-RPC method returning the base fee for the next block, matching geth behavior via ComputeBaseFee on the current tipset (filecoin-project/lotus#13615)

🐛 Bug Fixes

• fix(api): trace transaction api returns the correct error (filecoin-project/lotus#13614)
• fix(cli): RPC API URLs ending with a trailing slash no longer produce duplicate slashes before /rpc/<version> (filecoin-project/lotus#13662)
• Fix off-by-one in transactionPosition returned by trace_block, trace_filter and trace_transaction. Positions were 1-indexed; per the Ethereum trace API spec they are 0-indexed and must match the corresponding transactionIndex from eth_getBlockByNumber. (filecoin-project/lotus#13610)
• fix(eth): eth_getTransactionReceipt no longer fails when another transaction in the same block emits a large number of events. MaxFilterResults now caps only multi-tipset event queries; single-block calls (eth_getLogs with BlockHash, eth_getBlockReceipts, eth_getTransactionReceipt) bypass it. Public RPC operators should apply rate and response-size limits at the proxy layer for these calls; a single response can be large when a block contains log-heavy transactions (filecoin-project/lotus#13617)
• fix(eth): return indexed block-level logsBloom for eth_getBlockByHash, eth_getBlockByNumber, and new-head subscription payloads when chain-index bloom data is available; existing tipsets without bloom rows continue to fall back to the previous full bloom. This adds a chain index DB migration for the tipset_bloom table and requires no RPC-provider config changes. (filecoin-project/lotus#13618)
• fix(gateway): align v2 RPC surface (/rpc/v2) with v1; remove *Limited and *Untrusted eth method variants (filecoin-project/lotus#13628)
• fix(eth): eth_call, eth_estimateGas and StateCall are no longer refused at the epoch immediately after an expensive network-upgrade migration; that block's migrated state is already available, so only the upgrade epoch itself is refused. This unblocks indexers (e.g. The Graph) that replay eth_call at the block of each event. The refusal now returns a typed error with the registered JSON-RPC code -32002 and a recognisable message, instead of the generic application code 1 (filecoin-project/lotus#13644)

👌 Improvements

• Silence libp2p config log spam (filecoin-project/lotus#13612)
• feat(mempool): raise the default per-actor cap on the untrusted push path (MaxUntrustedActorPendingMessages) from 10 to 100, reducing spurious ErrTooManyPendingMessages rejections for normal-cadence senders relaying through lotus-gateway / public RPC (filecoin-project/lotus#13636)
• chore(cli): lotus-miner info supports --actor to query any miner without a local miner repo; miner-daemon-only sections (subsystems, start time, alerts, workers, sectors) are skipped when --actor is set

Release Log

• github.com/filecoin-project/lotus:
  • Merge 2844f13 into 3865dcc
  • fix(eth): return indexed block logsBloom (#13618) (filecoin-project/lotus#13618)
  • fix: update filecoin-ffi to v1.36.1 (#13663) (filecoin-project/lotus#13663)
  • fix(cli): join API info RPC paths safely (#13662) (filecoin-project/lotus#13662)
  • fix(build): ffi-version-check should depend on module update (#13658) (filecoin-project/lotus#13658)
  • fix(eth): serve eth_call at the epoch after an expensive migration (#13644) (filecoin-project/lotus#13644)
  • chore: create nv29 Lotus skeleton (#13640) (filecoin-project/lotus#13640)
  • chore(cli): lotus-miner info supports --actor (#13641) (filecoin-project/lotus#13641)
  • feat: update mainnet.pi to remove venus bootstrap (#13648) (filecoin-project/lotus#13648)
  • build(deps): bump github.com/buger/jsonparser from 1.1.1 to 1.1.2 (#13646) (filecoin-project/lotus#13646)
  • build(deps): bump google.golang.org/grpc from 1.78.0 to 1.79.3 (#13647) (filecoin-project/lotus#13647)
  • docs: improve network skeleton workflow (#13639) (filecoin-project/lotus#13639)
  • feat(mempool): raise MaxUntrustedActorPendingMessages from 10 to 100 (#13636) (filecoin-project/lotus#13636)
  • fix(api): trace transaction api to return correct error (#13614) (filecoin-project/lotus#13614)
  • chore(release): cherry-pick v1.36.0 changelog back to master (#13627) (filecoin-project/lotus#13627)
  • fix(gateway): align v2 RPC surface with v1 (#13628) (filecoin-project/lotus#13628)
  • chore: fix sync issue (#13620) (filecoin-project/lotus#13620)
  • feat(eth): add eth_baseFee RPC method returning next block base fee (#13615) (filecoin-project/lotus#13615)
  • chore: set mainnet nv28 upgrade epoch (#13619) (filecoin-project/lotus#13619)
  • fix(eth): scope receipt logs by message, cap event filter across tipsets (#13617) (filecoin-project/lotus#13617)
  • chore(libp2p): silence libp2p config log spam (#13612) (filecoin-project/lotus#13612)
  • fix(eth): use 0-indexed transactionPosition in trace_block (#13610) (filecoin-project/lotus#13610)
  • fix: docker build Lotus on bullseye (#13611) (filecoin-project/lotus#13611)
  • fix: remove F3 data with existing chain cleanup (#13609) (filecoin-project/lotus#13609)
  • docs: fix some minor issues in the comments (#13583) (filecoin-project/lotus#13583)
  • build(deps): bump github.com/mattn/go-sqlite3 from 1.14.42 to 1.14.44 in the data-storage group across 1 directory (#13600) (filecoin-project/lotus#13600)
  • build(deps): bump github.com/gdamore/tcell/v2 from 2.13.8 to 2.13.9 (#13601) (filecoin-project/lotus#13601)
  • build(deps): bump github.com/Masterminds/semver/v3 from 3.4.0 to 3.5.0 (#13602) (filecoin-project/lotus#13602)
  • build(deps): bump github.com/mattn/go-isatty from 0.0.20 to 0.0.22 (#13603) (filecoin-project/lotus#13603)
  • build(deps): bump go.opentelemetry.io/otel/bridge/opencensus from 1.40.0 to 1.43.0 (#13604) (filecoin-project/lotus#13604)
  • build(deps): bump github.com/samber/lo from 1.52.0 to 1.53.0 (#13605) (filecoin-project/lotus#13605)
  • build(deps): bump golang.org/x/tools from 0.43.0 to 0.44.0 (#13606) (filecoin-project/lotus#13606)
  • chore: bump deps for release prep (#13597) (filecoin-project/lotus#13597)
  • build: update Lotus Node and Miner version to v1.36.1-dev in master (#13595) (filecoin-project/lotus#13595)
• github.com/filecoin-project/filecoin-ffi (v1.34.0 -> v1.36.1):
  • Bump version to v1.36.1 (#583) (filecoin-project/filecoin-ffi#583)
  • fix(deps): bump sppark to 0.1.15 (#582) (filecoin-project/filecoin-ffi#582)
  • chore: v1.36.1-dev release (#581) (filecoin-project/filecoin-ffi#581)
  • chore: add nv29 skeleton (#580) (filecoin-project/filecoin-ffi#580)
  • build(deps): bump wasmtime from 36.0.7 to 36.0.9 in /rust (#577) (filecoin-project/filecoin-ffi#577)
  • build(deps): bump rand from 0.8.5 to 0.8.6 in /rust (#575) (filecoin-project/filecoin-ffi#575)
  • chore: update version to stable (#576) (filecoin-project/filecoin-ffi#576)
  • chore: reduce install script output noise (#574) ([filecoin-project/filecoin-ffi#574](https://github.com/filecoin-projec...

This is the stable release of the MANDATORY Lotus v1.36.0 release, which delivers the Filecoin network version 28, codenamed “Fire Horse” 🔥🐎. This release sets the upgrade epoch for the Mainnet network to Epoch 6052800: 2026-05-27T14:00:00Z. See the local time for other timezones.

☢️ Upgrade Warnings ☢️

• All Lotus node and Storage Provider (SP) operators on Mainnet must upgrade to v1.36.0 before epoch 6052800, corresponding to 2026-05-27T14:00:00Z.
• 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 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 than 5 minutes.
• The migration on the upgrade epoch is expected to take approximately 1 minute on a node with a NVMe drive and a newer CPU. For nodes running on slower disks/CPU, it is expected to take around 1-2 minutes.
• RAM usage is expected to be under 20GiB RAM for both the pre-migration and migration.

We recommend node operators who have not enabled splitstore discard mode, and 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, running the non-cached 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.

⭐ 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)
• fix(eth): eth_getTransactionReceipt no longer fails when another transaction in the same block emits a large number of events. MaxFilterResults now caps only multi-tipset event queries; single-block calls (eth_getLogs with BlockHash, eth_getBlockReceipts, eth_getTransactionReceipt) bypass it. Public RPC operators should apply rate and response-size limits at the proxy layer for these calls; a single response can be large when a block contains log-heavy transactions. (filecoin-project/lotus#13617)

📝 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 the MANDATORY Lotus v1.36.0 release, which delivers the Filecoin network version 28, codenamed “Fire Horse” 🔥🐎. This release sets the upgrade epoch for the Mainnet network to Epoch 6052800: 2026-05-27T14:00:00Z. See the local time for other timezones.

☢️ Upgrade Warnings ☢️

• All Lotus node and Storage Provider (SP) operators on Mainnet must upgrade to v1.36.0 before epoch 6052800, corresponding to 2026-05-27T14:00:00Z.
• 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 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 than 5 minutes.
• The migration on the upgrade epoch is expected to take approximately 1 minute on a node with a NVMe drive and a newer CPU. For nodes running on slower disks/CPU, it is expected to take around 1-2 minutes.
• RAM usage is expected to be under 20GiB RAM for both the pre-migration and migration.

We recommend node operators who have not enabled splitstore discard mode, and 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, running the non-cached 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.

⭐ 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)
• fix(eth): eth_getTransactionReceipt no longer fails when another transaction in the same block emits a large number of events. MaxFilterResults now caps only multi-tipset event queries; single-block calls (eth_getLogs with BlockHash, eth_getBlockReceipts, eth_getTransactionReceipt) bypass it. Public RPC operators should apply rate and response-size limits at the proxy layer for these calls; a single response can be large when a block contains log-heavy transactions. (filecoin-project/lotus#13617)

📝 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 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