filecoin-project/lotus v1.37.0-rc1

on GitHub

This is the first release candidate of the upcoming MANDATORY Lotus v1.37.0 release, which will deliver Filecoin network version 29, codenamed "Solstice". This release candidate sets the upgrade epoch for the Calibration network to Epoch 4109133: 2026-09-28T12:59:30Z. See the local time for other timezones.

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

☢️ Upgrade Warnings ☢️

• All Lotus node and Storage Provider (SP) operators on the Calibration network must upgrade to this release candidate before the specified upgrade date.
• Network version 29 (Solstice, FIP-0118) introduces built-in actors v19. Every new sector receives maximum quality-adjusted power regardless of its content, and the verified registry and DataCap actors are frozen. (filecoin-project/lotus#13747)
• The Solstice migration installs reward actor bootstrap state from per-network parameters, resolving the service-weight authority, service-rewards actor and initial orchestrator to ID addresses against the state tree at the upgrade epoch. (filecoin-project/lotus#13747)
• DataCap and verified-registry writes are refused from nv29: lotus filplus datacap commands retire, lotus-miner sectors extend --drop-claims is rejected, and --only-cc has been removed in favour of --exclude. Use lotus-miner sectors upgrade-quality to raise legacy sectors instead. (filecoin-project/lotus#13747)
• StateMinerInitialPledgeCollateral returns an error from nv29, because a SectorPreCommitInfo no longer describes any part of the pledge. Use StateMinerInitialPledgeForSector, passing the full sector size as the verified size. (filecoin-project/lotus#13747)
• PreCommitSectorBatch2 rejects a non-empty deal_ids from nv29, and the sealing pipeline refuses such a sector when it is queued. (filecoin-project/lotus#13747)
• Schedules the Calibration network upgrade to nv29 (Solstice), happening on 2026-09-28T12:59:30Z. (filecoin-project/lotus#13809)
• F3 Prometheus metric names may change: The OpenTelemetry Prometheus exporter has been bumped from v0.50.0 to v0.68.0, which changes how metric unit suffixes are applied. F3 metrics with unit "s" (seconds) or "By" (bytes) may gain _seconds or _bytes suffixes in their Prometheus names. This only affects f3_* metrics -- core Lotus metrics (lotus_*) are exported via the separate OpenCensus exporter, which is unchanged. Operators with dashboards or alerting rules that query f3_* metrics should verify metric names after upgrading. (filecoin-project/lotus#13511)

⭐ New Features

• feat(cli): lotus-miner sectors (FIP-0118 Solstice / nv29) gained an upgrade-quality subcommand to upgrade legacy 1x-QA sectors to full QA power. (filecoin-project/lotus#13781)

🐛 Bug Fixes

• fix(types): TipSetKey's JSON decoder now rejects a null element instead of silently dropping it. (filecoin-project/lotus#13755)

👌 Improvements

• chore(deps): update go-paramfetch to v0.0.6, adding a second proof-parameter download gateway with automatic fallback and removing the retired proofs.filecoin.io source. (filecoin-project/lotus#13810)
• feat(cli): lotus filplus commands now print a retirement warning ahead of nv29, when DataCap and verified-registry writes stop working. (filecoin-project/lotus#13798)
• chore(deps): update filecoin-ffi to v1.37.0, which moves to ref-fvm v4.8.3 with nv29 (Solstice) support in the FVM. (filecoin-project/lotus#13804)

Release Log

• github.com/filecoin-project/lotus:
  • Merge 5d52c77 into 1064a7a
  • chore: set nv29 Calibration upgrade epoch and Solstice contract addresses (#13809) (filecoin-project/lotus#13809)
  • chore(deps): update actors bundle to v19.0.1 (#13813) (filecoin-project/lotus#13813)
  • fix(cli): use upper limit in sector upgrade command (#13805) (filecoin-project/lotus#13805)
  • feat(solstice): nv29 node support and itest consolidation
  • test(solstice): consolidate Solstice integration suites
  • feat(solstice,actors): configure Solstice networks and contracts
  • chore(solstice,miner): print a note when faulted sectors (#13802) (filecoin-project/lotus#13802)
  • feat(solstice,actors): upgrade actors bundle to latest, fix broken APIs
  • feat(solstice,miner): update miner CLI and QA filters
  • feat(solstice): reward migration, actors v19 and genesis integration
  • chore(deps): update go-paramfetch to v0.0.6 (#13810) (filecoin-project/lotus#13810)
  • build(deps): bump go.opentelemetry.io/otel/exporters/prometheus from 0.50.0 to 0.68.0 (#13511) (filecoin-project/lotus#13511)
  • build(deps): bump github.com/libp2p/go-libp2p-kad-dht from 0.42.1 to 0.42.2 in the libp2p-ecosystem group across 1 directory (#13764) (filecoin-project/lotus#13764)
  • build(deps): bump github.com/cheggaaa/pb/v3 from 3.2.0 to 3.2.1 (#13768) (filecoin-project/lotus#13768)
  • chore(deps): update filecoin-ffi to v1.37.0 (#13804) (filecoin-project/lotus#13804)
  • feat(cli): warn about FIL+ write retirement before nv29 (#13798) (filecoin-project/lotus#13798)
  • test(itests): stop double proving-period waits at null-round deadline boundaries (#13793) (filecoin-project/lotus#13793)
  • chore(release): cherry-pick v1.36.3 changelog back to master (#13794) (filecoin-project/lotus#13794)
  • fix(types): reject undefined CIDs in TipSetKey JSON decoding (#13755) (filecoin-project/lotus#13755)
  • refactor: use WaitGroup.Go in parmap (#13756) (filecoin-project/lotus#13756)
  • build: bump Go to 1.25.14 (#13786) (filecoin-project/lotus#13786)
  • fix(docker): move builder and runtime images to Debian trixie (#13785) (filecoin-project/lotus#13785)
  • chore(docs): tweak agents instructions to trim changelog entries (#13787) (filecoin-project/lotus#13787)
• github.com/filecoin-project/filecoin-ffi (v1.36.1 -> v1.37.0):
  • chore: v1.37.0 release (#589) (filecoin-project/filecoin-ffi#589)
  • chore(deps): bump fvm to ~4.8.3 and drop nv29-dev feature (#588) (filecoin-project/filecoin-ffi#588)
  • fix(deps): use curiostorage/sppark fork (filecoin-project/filecoin-ffi#586)
  • chore: set CODEOWNERS (#585) (filecoin-project/filecoin-ffi#585)
• github.com/filecoin-project/go-paramfetch (v0.0.5 -> v0.0.6):
  • chore: bump version to v0.0.6 (#39) (filecoin-project/go-paramfetch#39)
  • feat: support multiple parameter gateways with fallback (filecoin-project/go-paramfetch#38)
  • Bump golang.org/x/crypto from 0.45.0 to 0.52.0 (#37) (filecoin-project/go-paramfetch#37)
• github.com/filecoin-project/go-state-types (v0.19.0-rc1 -> v0.19.0):
  • chore: v0.19.0 bump (#469) (filecoin-project/go-state-types#469)
  • chore: slow down dependabot (#459) (filecoin-project/go-state-types#459)
  • feat(fip-0118): actor changes and migration (#462) (filecoin-project/go-state-types#462)
  • chore(deps): bump github.com/stretchr/testify from 1.11.1 to 1.12.1 (#464) (filecoin-project/go-state-types#464)
  • chore(deps): bump golang.org/x/crypto from 0.54.0 to 0.55.0 (#463) (filecoin-project/go-state-types#463)
  • chore: set CODEOWNERS (#461) (filecoin-project/go-state-types#461)
  • chore(deps): bump github.com/ipfs/go-block-format from 0.2.3 to 0.2.4 (#456) (filecoin-project/go-state-types#456)
  • chore(deps): bump github.com/ipfs/go-ipld-cbor from 0.2.1 to 0.3.0 (#457) (filecoin-project/go-state-types#457)
  • chore(deps): bump github.com/ipfs/go-cid from 0.6.1 to 0.6.2 (#458) (filecoin-project/go-state-types#458)
  • chore(deps): bump golang.org/x/crypto from 0.53.0 to 0.54.0 (#455) (filecoin-project/go-state-types#455)
  • chore(deps): bump golang.org/x/sync from 0.21.0 to 0.22.0 (#454) (filecoin-project/go-state-types#454)

Contributors