Release v2024‐07‐19

Prepare the release process

• Made a copy of the latest release Release-v2024-07-07 documented as a new page on cardano-wallet's wiki called Release-v2024-07-19.

• Pick up the latest green commit from the release pipeline and prove it's green by linking the successful buildkite and github actions builds here.

  • relelase pipeline build: https://buildkite.com/cardano-foundation/cardano-wallet-release/builds/311

  • release pipeline master commit: https://github.com/cardano-foundation/cardano-wallet/commit/258d22279d539b7a722f55cee44eefa12fcc3a76

  • main pipeline build: https://buildkite.com/cardano-foundation/cardano-wallet/builds/6249

  • release commit: https://github.com/cardano-foundation/cardano-wallet/commit/44b2fd53aaaab47a149ecf90e8d39ab549b862a5

  • Check Windows E2E tests on branch commit artifacts, note that the github action code is taken from master

    • https://github.com/cardano-foundation/cardano-wallet/actions/runs/10006580433/job/27659560769

  • Check Windows unit tests on branch commit artifacts

    • https://github.com/cardano-foundation/cardano-wallet/actions/runs/10006580435/job/27659805475
    • we have a failure in the windows unit tests, but it is not related to the release artifacts It seems to be related to the windows environment, as the same test passes on linux and macos. Also the problem is the node crashing, not the wallet.

• Check for performance regressions on the branch commit artifacts . This was don by hand by running a script that is going to be merged next week

Prepare the release

• Trigger a release build on CI (GitHub Actions) for this release branch.

  export RELEASE_GIT_COMMIT=44b2fd53aaaab47a149ecf90e8d39ab549b862a5
  export NEW_GIT_TAG=v2024-07-19
  git tag --sign -m $NEW_GIT_TAG $NEW_GIT_TAG $RELEASE_GIT_COMMIT
  git push origin $NEW_GIT_TAG

Hand generate the API change record

We use bump.sh to generate a record of all API changes between the last release and this release. This is the result: no structural changes in the API since the last release.

Update the release page

• Write release notes in the release page

• Add the relevant artifacts to the release page from the 5952 buldkite build

  • Linux
  • Windows
  • MacOS-intel
  • MacOS-arm64

Verify release artifacts

• Verify that the documentations have been correctly exported on https://github.com/cardano-foundation/cardano-wallet/commit/e4c6ade16482ba5fa2116d9583bfb85cbe32a0ba

• Make a commit with redirects to the documentation for the release like

  ```bash
  git checkout gh-pages
  git pull origin gh-pages
  cd releases
  ./make_redirects.sh $NEW_GIT_TAG
  git push origin gh-pages
  ```
  

• Make sure the Command-Line Interface manual is up to date.

Manual ad-hoc verifications

• Verify that sensitive fields listed in Cardano/Wallet/Api/Server are still accurate and aren't missing any new ones.

  sensitive =
      [ "passphrase"
      , "old_passphrase"
      , "new_passphrase"
      , "mnemonic_sentence"
      , "mnemonic_second_factor"
      ]
  

Publication

• Once everyone has signed off (i.e. Tech lead, QA & Release manager), publish the release draft.

• Merge the (administrative) commits created for the release tag back into the master branch.

• Remember to leave this checklist in an up-to-date status for the next releaser