🚢 Estimated shipping date

• RC1:

  • 2024-06-27 (last confirmed 2024-06-24T18:44:46Z)
  • 2024-07-01 (updated on 2024-06-28T03:58:09Z - slack thread)
    • Published https://github.com/filecoin-project/lotus/releases/tag/v1.28.0-rc1

• RC2:

  • 2024-07-04: https://github.com/filecoin-project/lotus/releases/tag/v1.28.0-rc2

• RC3:

  • 2024-07-04: https://github.com/filecoin-project/lotus/releases/tag/v1.28.0-rc3

• RC4:

  • 2024-07-05: https://github.com/filecoin-project/lotus/releases/tag/v1.28.0-rc4

• RC5:

  • 2024-07-11: https://github.com/filecoin-project/lotus/releases/tag/v1.28.0-rc5

• v1.28.0 stable estimated: 2024-07-23 2024-07-24

Dependencies for releases

This is the set of changes that need to make it a given RC. This is effectively the set of changes to cherry-pick from master.

RC1

• chore: NV23 release: backport changes from master #12147
• chore: NV23 backport: one more round of backports from master #12158
• F3 items
  • feat: ec: Integrate Fast Finality for Filecoin #12119
  • Release v0.0.1 for Lotus v1.28.0-rc1 go-f3#373
• Cherry pick chore: go-state-types: update to RC3 #12154 - backported here

RC2 (current "calibration final-candidate")

• Calibration network genesis should have a faucet account for tokens and datacap #12165 (CONFIRMED TO WORK ON BUTTERFLY)
• Butterfly network genesis should have a faucet account for tokens and datacap #12160
• feat: api: sanity check the "to" address of outgoing messages #12135
• Set upgrade epoch on Calibration
• Update upgrade warning section to warn about: 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 as a minor database migration takes place. See [filecoin-project/lotus#12080](https://github.com/filecoin-project/lotus/pull/12080) for full details.
• Backport: fix: rpc: missing re-assignment of baseFee in EthFeeHistory #12177
• Backport: fix: build: Ensure Quicknet is used when spinning up 2k/butterfly networks #12175
• Backport: feat:ec:f3: add env var to disable F3 #12176
• Backport: feat: calib: enable f3 by default #12181

Mainnet Upgrade Release

• Backport everything with the backport label (and then remove the backport labe)
• ~ Lotus sync issue: libp2p v0.34.1 libp2p/go-libp2p#2858 ~ (We have bumped go-libp2p. Will close issue once we have a bit more confidence after people have upgraded)
• Release for Lotus v1.28.0-for-mainnet-upgrade go-f3#386
• Dependency updates
  • Stable Release for NV23 builtin-actors#1569
  • Final filecoin-ffi release for NV23. filecoin-ffi#471
  • Final go-state-types release for NV23 go-state-types#292

✅ Release Checklist

• Wait for the v1.27.1 release to complete: [Shipped] Lotus Client Release v1.27.1 #12073
• Fork a new branch (release/v1.28.0) from master.
  • Any further release related changes need to be made in this branch or cherry-picked to it.
  • If any "non-trivial" changes get added to the release, uncheck all the checkboxes and return to this stage.
• (After the RC gets cut) Bump the version in build/version.go in the master branch to vX.Y.(Z+1)-dev (bump from feature release) or vX.(Y+1).0-dev (bump from mandatory release). Run make gen and make docsgen-cli before committing changes
  chore: bump version in master #12074

Prepping an RC

RC prep steps for network upgrade for Calibration

• Update Lotus dependencies following chore: docs: Add initial Update_Dependencies_Lotus.md #12107
• Set the upgrade epoch for the Calibration network

RC1 Steps

• version string in build/version.go needs to be updated to end with '-rcX' (in the release/vX.Y.Z branch)
• run make gen && make docsgen-cli
• Changelog prep
  • Generate changelog using the script at scripts/mkreleaselog
  • Add contents of generated text to lotus/CHANGELOG.md
  • Editorializing (FIPs, actor bundles, new feature callouts - example)
• Commit using PR: chore: release: Lotus v1.28.0-rc1 #12169
• tag commit with vX.Y.Z-rcN
• cut a pre-release here

We've cut the first RC using these steps at https://github.com/filecoin-project/lotus/releases/tag/v1.28.0-rc1.

RC2 Steps

• version string in build/version.go needs to be updated to end with '-rcX' (in the release/vX.Y.Z branch)
• run make gen && make docsgen-cli
• Changelog prep
  • Generate changelog using the script at scripts/mkreleaselog
  • Add contents of generated text to lotus/CHANGELOG.md
  • Editorializing (FIPs, actor bundles, new feature callouts - example)
• Commit using PR
• tag commit with vX.Y.Z-rcN
• cut a pre-release here

Stable Release

• Final preparation
  • Verify that version string in version.go has been updated.
  • Verify that codegen is up to date (make gen && make docsgen-cli)
  • Ensure that CHANGELOG.md is up to date
  • Merge release-vX.Y.Z into the releases branch.
  • Tag this merge commit (on the releases branch) with vX.Y.Z
  • Cut the release here.

Post-Release

• Merge the releases branch back into master, ignoring the changes to version.go (keep the -dev version from master). Do NOT delete the releases branch when doing so!
  • Double check that everything in releases and release/v1.28.0 are in master.
• Update RELEASE_ISSUE_TEMPLATE.md with any improvements determined from this latest release iteration.
• Create an issue using RELEASE_ISSUE_TEMPLATE.md for the next release.