Daml Finance Release Journal for `SDK 2.8.0`

[johan-da]

Daml Finance Release Journal for SDK 2.8.0

Release of Daml 2.8.0

Daml Finance: on GitHub Daml Bundle: on Artifactory (including Daml Finance) and on GitHub Release notes: 2.8.0

Useful links

Daml Finance Release instructions Daml Release Planning Slack temp-release-2-8-0 channel Github daml-finance rc-8 Github daml release/2.8.x branch Github docs.daml.com main SDK release notes Daml Finance release notes Release Journal for 2.7.0

Updates to Release Process

1. Get Daml SDK from github with fallback artifactory: https://github.com/digital-asset/daml-finance/pull/1166
2. Create a daml-finance bundle to be included in the SDK bundle: git tag sdk/2.8.0-rc.1 followed by git push origin sdk/2.8.0-rc.1 now creates a bundle including snapshot packages. Consider adjusting the script to optionally include snapshots --> https://github.com/digital-asset/daml-finance/issues/1176
3. Keep shell.nix in sync (CI will notice & fail): If sdk-version or daml-version is changed (in the daml.yaml file), run bin/update-daml-hashes. You may need to comment out daml from the buildInputs list to get the Nix shell to run while you update the hashes. --> https://github.com/digital-asset/daml-finance/pull/1166
4. Test quick-starter and tutorial with a script: There is a new script for testing the quick-starter and tutorials with the newest SDK (installed from os Github with fallback ee Artifactory). We might want to integrate this script in our CI. --> https://github.com/digital-asset/daml-finance/issues/1175
5. Improvement Idea: For an SDK release, we could consider making use of the Daml Finance bundle as the default package set for both the quick-starter and the tutorials. Initially, this approach eliminates the need for a quick-starter and tutorial configuration file (0.0.4.conf), simplifying the setup. Only in scenarios where we need to override the default packages would we create a configuration file (i.e., 0.0.4.conf). Should such a file exist (in main), it would specify the package versions to be used in the quick-starter and tutorials for the corresponding version (0.0.4) which is set in the daml.yaml.template file. --> https://github.com/digital-asset/daml-finance/issues/1177

Release Journal

20231215 Cleanup

• [x] Update README files--> https://github.com/digital-asset/daml-finance/pull/1178
• [x] Clean up main after release --> https://github.com/digital-asset/daml-finance/pull/1188
  • Flush changelog in main
  • Forward port doc changes to main
  • Bump assembly version in main to 1.4.0
  • Create a new tutorial configutation file (0.0.5.conf) and change the version in daml.yaml and daml.yaml.template, accordingly
• [x] Forward port changes to 2.8 docs to 2.9/3.0 --> already up to date
• [x] Make new assembly for 1.4.0 abd point 2.9/3.0 daml finance docs to new 1.4.0 assembly --> https://github.com/digital-asset/daml-finance/tree/assembly-1.4.0 https://github.com/digital-asset/docs.daml.com/pull/590
• [x] Update daml hashes in main once SDK is officially released --> https://github.com/digital-asset/daml-finance/pull/1189

20231215 Release Candidate Announced Stable

• [x] Bump to official package versions (in daml-finance rc-2.8) --> https://github.com/digital-asset/daml-finance/pull/1184 (includes a script to check that versions match the expected ones)
• [x] Bump to official SDK version (in daml-finance rc-2.8) --> https://github.com/digital-asset/daml-finance/pull/1185
• [x] Test e2e scripts
• [x] Test quick-starter and tutorials (once the new SDK candidate is released)
• [x] Release official packages --> https://github.com/digital-asset/daml-finance/tree/
• [x] Release official package bundle in Github (and communicate tag to SDK release coordinator) --> https://github.com/digital-asset/daml-finance/releases/tag/sdk%2F2.8.0
  • git tag sdk/2.8.0 + git push sdk/2.8.0 triggers the bundle of the latest released versions
  • double check that the bundle contains the right versions
• [x] Update the 0.0.4.conf file in the daml-finance in main branch with the latest released packages --> merged the rc-2.8 to main https://github.com/digital-asset/daml-finance/pull/1186

20231214 Daml RC5

• [x] Bump SDK version, package versions, and update hashes (in daml-finance rc-2.8) --> https://github.com/digital-asset/daml-finance/tree/test-sdk-rc5
• [x] Make snapshot release --> Previous was used
• [x] Update the 0.0.4.conf file in the daml-finance main branch with the latest released snapshot packages --> Previous was used
• [x] Update version in daml (can be skipped if the quick-starter and tutorials did not change since last update) --> Previous was used
• [x] Create bundle --> Previous was used
• [x] Test quick-starter and tutorials (once the new SDK candidate is released)

20231212 Daml RC4

• [x] Bump SDK version, package versions, and update hashes (in daml-finance rc-2.8) --> https://github.com/digital-asset/daml-finance/commit/a614ab4f05ac41fa249c4980e8df442cfadf4d4a
• [x] Test e2e scripts
• [x] Make snapshot release --> Previous was used
• [x] Update the 0.0.4.conf file in the daml-finance main branch with the latest released snapshot packages --> Previous was used
• [x] Update version in daml (can be skipped if the quick-starter and tutorials did not change since last update) --> Previous was used
• [x] Create bundle --> Previous was used
• [x] Test quick-starter and tutorials (once the new SDK candidate is released)

20231207 Daml RC3

• [x] Bump SDK version, package versions, and update hashes (in daml-finance rc-2.8) --> https://github.com/digital-asset/daml-finance/commit/1a24b27ad85f3bc7eeeab1dff64e8eb2307b862a
  • fixed the script: https://github.com/digital-asset/daml-finance/commit/16e23ce34bbead294173f57162de4c97c5dacd70
• [x] Test e2e scripts
• [x] Make snapshot release --> Previous was used
• [x] Update the 0.0.4.conf file in the daml-finance main branch with the latest released snapshot packages --> Previous was used
• [x] Update version in daml (can be skipped if the quick-starter and tutorials did not change since last update) --> Previous was used
• [x] Create bundle --> Previous was used
• [x] Test quick-starter and tutorials (once the new SDK candidate is released)

20231207 Daml RC2

• [x] Bump SDK version, package versions, and update hashes (in daml-finance rc-2.8) --> https://github.com/digital-asset/daml-finance/pull/1182
  • the hash computation was adjusted due to lacking --to-base-64 flag for the nix-hash function
  • the --allow-install-non-release=yes install flag was changed to --install-with-internal-version yes , so had to adjust scripts accordingly
• [x] Test e2e scripts
• [x] Make snapshot release --> Previous was used
• [x] Update the 0.0.4.conf file in the daml-finance main branch with the latest released snapshot packages --> Previous was used
• [x] Update version in daml (can be skipped if the quick-starter and tutorials did not change since last update) --> Previous was used
• [x] Create bundle --> Previous was used
• [x] Test quick-starter and tutorials (once the new SDK candidate is released)

20231205 Scripts

• [x] Add test-sdk-daml-finance-templates script
  • Install SDK from os with ee as fallback
  • Get latest SDK version from github tag
• [x] Add script for sorting Daml imports --> https://github.com/digital-asset/daml-finance/pull/1181

20231129 Rename conf file (2.8.0.conf to 0.0.4.conf)

• [x] Change in daml-finance main --> https://github.com/digital-asset/daml-finance/pull/1172
• [x] Backport change to daml-finance rc-2.8
• [x] Update version in daml (to effectuate name change) --> https://github.com/digital-asset/daml/pull/17948
• [x] Backport change to 2.8.x --> https://github.com/digital-asset/daml/pull/17949/files
• [x] Had to add back 2.8.0.conf to main after revival of the RC1 testing --> https://github.com/digital-asset/daml-finance/pull/1179
• [x] Remove 2.8.0.conf file from main in case of RC2 --> https://github.com/digital-asset/daml-finance/pull/1183

20231127 Daml RC1

sdk-version: 2.8.0-snapshot.20231127.12403.0.vf5c2e6da (sourced from Jfrog Artifactory) daml-version: 2.8.0-rc1 (not used when sourced from artifactory, and will soon be the same as sdk-version again)

• [x] Bump SDK version, package versions, and update hashes (in daml-finance rc-2.8) --> https://github.com/digital-asset/daml-finance/pull/1166
• [x] Test e2e scripts
• [x] Make snapshot release --> https://github.com/digital-asset/daml-finance/tree/release-snapshot-20231127
• [x] Update the 2.8.0.conf file in the daml-finance main branch with the latest released snapshot packages
• [x] Update version in daml --> https://github.com/digital-asset/daml/pull/17874
• [x] Create bundle --> https://github.com/digital-asset/daml-finance/releases/tag/sdk%2F2.8.0-rc.1 (Bundle script had to be amended to include snapshot packages --> https://github.com/digital-asset/daml-finance/commit/94c9fbb007e065db675df6d8bf48180f2e2426ef)
• [x] Test quick-starter and tutorials (once the new SDK candidate is released):
  • 20231129 Last line in conf file must be empty (for the scripts to work properly) --> https://github.com/digital-asset/daml-finance/pull/1171
    • 20231129 Reported on an issue damlc: user error (Package dependencies from different SDK versions: 2.8.0-rc1, 2.8.0-snapshot.20231127.12403.0.vf5c2e6da) --> There will be a new release candidate.
    • 20231130 All tests ran successfully for RC1

20231118 SDK Snapshot

sdk-version: 2.8.0-snapshot.20231118.12382.0.v86cb8054 daml-version: 2.8.0-snapshot.20231122.0

• [x] Bump SDK versions (in daml-finance rc-2.8) --> https://github.com/digital-asset/daml-finance/pull/1163
• [x] Test e2e scripts
• [x] Test quick-starter and tutorials (with the latest SDK snapshot)

20231116 SDK Snapshot

sdk-version: 2.8.0-snapshot.20231116.12377.0.va821d52f daml-version: 2.8.0-snapshot.20231117.0

• [x] Bump SDK version in daml-finance rc-2.8
• [x] Test e2e scripts
• [x] Test quick-starter and tutorials (with the latest SDK snapshot)

20231121 Daml Finance Snapshot

sdk-version: 2.8.0-snapshot.20231116.12377.0.va821d52f daml-version: 2.8.0-snapshot.20231117.0

• [x] Bump the SDK version and package versions (in daml-finance rc-2.8) (had to amend scripts to handle multiple versions -->
  https://github.com/digital-asset/daml-finance/pull/1159 https://github.com/digital-asset/daml-finance/pull/1160)
• [x] Test e2e scripts
• [x] Make snapshot release --> https://github.com/digital-asset/daml-finance/tree/release-snapshot-20231121
• [x] Update the 2.8.0.conf file in the daml-finance main branch with the latest released snapshot packages. Added 2.8.0.latest.conf to keep track of the upcoming unreleased packages. Once released, simply copy and paste their details into 2.8.0.conf (make sure there is an empty line at the end) --> https://github.com/digital-asset/daml-finance/pull/1161
  • [x] Update version in daml --> https://github.com/digital-asset/daml/pull/17874
  • [x] Test quick-starter and tutorials (with the latest SDK snapshot). (Added a daml-finance/scripts/test-quickstarter-and-tutorials.sh bash script to facilitate the testing --> https://github.com/digital-asset/daml-finance/pull/1164.)

20231115 Daml Finance Snapshot

sdk-version: 2.7.4

• [x] Bump SDK version and package versions (in daml-finance rc-2.8) --> https://github.com/digital-asset/daml-finance/pull/1146
• [x] Test e2e scripts
• [x] Make snapshot release
• [x] Update the 2.8.0.conf file in the daml-finance main branch (NOTE: it was later renamed to 0.0.4.conf)
• [x] Update version in daml --> https://github.com/digital-asset/daml/pull/17845
• [x] Test quick-starter and tutorials (with the latest SDK snapshot)

Preparation

Update Docs

• [x] Bump assembly version for docs --> https://github.com/digital-asset/daml-finance/tree/assembly-1.3.10
• [x] Polish change-log (update it, reword it, hide non-user-facing changes) --> https://github.com/digital-asset/daml-finance/pull/1149
• [x] Update list of released packages / deprecated packages --> https://github.com/digital-asset/docs.daml.com/pull/549
• [x] Add per-package changelog --> https://github.com/digital-asset/docs.daml.com/pull/549
• [x] Add 'Major Updates' section to the docs --> https://github.com/digital-asset/docs.daml.com/pull/549 https://github.com/digital-asset/docs.daml.com/pull/552
• [x] Review release notes

Update Quick-Starter and Tutorials

• [x] Add new tutorial to daml repo --> 196435d4dae4d3a40795bd09c24d73c132ea95bd https://github.com/digital-asset/daml/pull/17840#pullrequestreview-1731519491
• [x] Update daml_finance_dep.bzl version in the daml repo and backport change to daml release branch release/2.8.x (if already available)--> https://github.com/digital-asset/daml/pull/17840#pullrequestreview-1731519491
• [x] Test quick-starter and tutorials (with the latest SDK snapshot release)