Repository navigation
Closed
Labels
release 📦ReleaseRelease
Description
Why
In order to deploy new features, improvements and bug fixes, we need to release a new distribution.
Note
The previous distribution has been created with #2967.
What
Create and release a new distribution 2630
Important
- Delete all legacy crates publication tokens in the GitHub settings
- Rotate ancillary signer service account keys in
release-mainnet - Remove deprecated features of
mithril-client - Clean infra upgrade branches if any
- Next phase of 'Switching to Cardano database incremental certification'
- Activate DMQ network in Release GitHub workflow
- Add DMQ compatibility matrix in GitHub release notes
- Remove
CardanoImmutableFilesFullfromAGGREGATOR_SIGNED_ENTITY_TYPESin:-
pre-release-preview -
release-preprod -
release-mainnet
-
- Activate
CardanoBlocksTransactionssigned entity type:-
pre-release-preview -
release-preprod
-
Distribution +1:
Note
- Rotate ancillary signer service account keys in
release-mainnet - Remove deprecated features of
mithril-client - Clean infra upgrade branches if any
- Upgrade to Cardano node
11.1.X?-
pre-release-preview -
release-preprod -
release-mainnet
-
- Activate
CardanoBlocksTransactionssigned entity type?:-
release-mainnet
-
- Dev blog post:
- Distribution
XXXX - Create a dev blog post explaining the transition to dual genesis
- Update the Multiple Aggregators testing phase dev blog post
- Distribution
- TBD
How
Phase 1: Prepare distribution
- Refresh NPM token for publication
- Run manual successful restoration of Cardano database + restart of the Cardano node (with ancillary)
- Run a backward compatibility test in the CI on the
unstabledistribution (with theunstablebuilt e2e test) - Run an all green aggregator stress test in the CI
- Run an all green client multi-platform test in the CI
- Prepare a PR to upgrade repository dependencies (with runbook)
- Reset the CI caches just before merging the PR to upgrade repository dependencies
- Merge the PR to upgrade repository dependencies
- Check if Cardano minimum supported versions in
networks.jsonmust be updated following the runbook - Create a draft PR for rotating the documentation
-
Create a draft PR for updatingnetworks.jsonfile - Create a PR for rotating the
CHANGELOG.md(set the distribution version) - Update the PR for rotating the
CHANGELOG.md(if needed) - Merge the PR for rotating the
CHANGELOG.md - Prepare announcements and highlights
- Prepare dev blog posts
Phase 2: Rollout pre-release distribution
- Remove
CardanoImmutableFilesFullfromAGGREGATOR_SIGNED_ENTITY_TYPESin:-
pre-release-preview
-
- Tag and deploy a
2630.0pre-release distribution on thepre-release-previewnetwork - Fill information in GitHub release:
- Release notes
- Highlights
- Make sure
pre-release-previewis working as expected - Create fix deployment
jpraynaud/fix-warp-huge-backtracesbranch - Activate
CardanoBlocksTransactionssigned entity type:-
pre-release-preview
-
- Re-deploy
pre-release-previewwithjpraynaud/fix-warp-huge-backtracesbranch:- First with previous distribution image
2617.0-2478748 - Then with new distribution
2630.0-23e124d
- First with previous distribution image
- Make sure
pre-release-previewis working as expected - Merge fix deployment
jpraynaud/fix-warp-huge-backtracesbranch on main - Make sure Grafana dashboards are fetching data for
pre-release-preview - Make sure libraries version
nexthave been published on npm registry - Run an all green client multi-platform test in the CI
- Run a Cardano transaction prover benchmark:
- Store results in the issue
- Make sure that there is no performance regression since last release
- Announce the pre-release on discord channel
- Announce any breaking change in:
- #cardano-scaling slack channel for pre-release
- #blockfrost-scaling slack channel for pre-release
- #ddz-iog-daedalus slack channel for pre-release
- Wait for at least
2epochs and check that:- Previous signers have registered in the current epoch
- New signers have registered in the current epoch
- Previous signers have signed in the
2epochs - New signers have signed in the
2epochs - Certificates are created for the
CardanoBlocksTransactions
Phase 3: Rollout release distribution
- Rotate KMS credentials:
- Destroy the previous key for the ancillary signer service account of
release-mainnet - Create a new key for the ancillary signer service account of
release-mainnet - Configure
release-mainnetenvironment with new service account credentials - Check that KMS credentials are working with the creation of the next Cardano database snapshot
- Destroy the previous key for the ancillary signer service account of
- Release the
2630.0distribution - Fill information in GitHub release:
- Cardano node compatibility
- Networks compatibility
- Make sure
release-mainnetis working as expected - Make sure
release-preprodis working as expected - Remove
CardanoImmutableFilesFullfromAGGREGATOR_SIGNED_ENTITY_TYPESin:-
release-preprod -
release-mainnet
-
- Activate
CardanoBlocksTransactionssigned entity type:-
release-preprod
-
- Update
CardanoBlocksTransactionsconfiguration parameterAGGREGATOR_CARDANO_BLOCKS_TRANSACTIONS_SIGNING_CONFIG_SECURITY_PARAMETERto5:-
release-preprod
-
- Re-deploy
release-mainnetandrelease-preprodwithjpraynaud/fix-warp-huge-backtracesbranch- First with previous distribution image
2617.0-2478748 - Then with new distribution
2630.0-23e124d
- First with previous distribution image
- Make sure
release-mainnetis working as expected - Make sure
release-preprodis working as expected - Make sure libraries have been published on crates.io
- Make sure libraries version
latesthave been published on npm registry - Make sure Grafana dashboards are fetching data for
release-mainnet - Make sure Grafana dashboards are fetching data for
release-preprod - Merge the PR for rotating the documentation
- Merge the PR for updating
networks.jsonfile - Merge the PR for rotating the
CHANGELOG.md - Announce the release on discord channel (with breaking-change, upcoming features activation, ...)
- Announce any breaking/new feature change in:
- #cardano-scaling slack channel for release
- #blockfrost-scaling slack channel for release
- #ddz-iog-daedalus slack channel for release
-
Update Hydra tutorial if client breaking change for database restoration - Dev blog post:
- Distribution
2630 - Update the
Switching to Cardano database incremental certificationdev blog post
- Distribution
- Update roadmap with new distribution
- Update the signer version in the next Cardano node release
Metadata
Metadata
Assignees
Labels
release 📦ReleaseRelease
Activity
v1backend #3268[-]Release `2623` distribution[/-][+]Release `2624` distribution[/+]jpraynaud commentedon Jun 11, 2026
Manual deletion of old certificates
pre-release-preview
jpraynaud commentedon Jun 11, 2026
Cardano transactions prover benchmark
Note
run on GCP with
e2-highmem-4machine with4vCPUs and64GBof RAMnot during Cardano database snapshotting
vs previous results
[-]Release `2624` distribution[/-][+]Release `2625` distribution[/+][-]Release `2625` distribution[/-][+]Release `2626` distribution[/+]0.7.0.0#3358[-]Release `2626` distribution[/-][+]Release `2627` distribution[/+][-]Release `2627` distribution[/-][+]Release `2628` distribution[/+][-]Release `2628` distribution[/-][+]Release `2630` distribution[/+]jpraynaud commentedon Jul 30, 2026
Cardano transactions prover benchmark
Note
run on GCP with
e2-highmem-4machine with4vCPUs and32GBof RAMnot during Cardano database snapshotting.
vs previous results
0.7.0.0#3358