Skip to content

chore: bump canton-barebones to 0.8.0 - #290

Open
fernandomg wants to merge 5 commits into
mainfrom
chore/canton-barebones-0.8
Open

fernandomg wants to merge 5 commits into
mainfrom
chore/canton-barebones-0.8

Conversation

@fernandomg

@fernandomg fernandomg commented Nov 18, 2026 •

Copy link
Copy Markdown
Member

Summary

No related issue. Bumps canton-barebones to 0.8.0, which runs Splice 0.10.2.

Changes

  • up moves the LocalNet's Postgres 14 data to 18 and keeps a backup;
  • contracts target LF 2.3 (amulet-vesting 0.0.4), and walletless replaces its factory on the new package;
  • pnpm's minimum release age skips canton-barebones.

Test plan

Automated tests

pnpm test.

Manual verification

  1. On a 0.9.4 LocalNet, run pnpm dev:amulet-vesting up: it migrates, keeps the backup, and the ledger keeps its data.

Breaking changes

None.

Checklist

  • Self-reviewed my own diff
  • Tests added or updated
  • Docs updated (if applicable)
  • No unrelated changes bundled in

Screenshots

None.

- amulet-vesting and amulet-vesting-walletless: `--target=2.3` and version 0.0.4;
- a new LF build is a new package, and the participant refuses a second one at 0.0.3;
- starter: `--target=2.3`, so adding a Splice 0.10 data-dependency builds;
- a 2.3 build also reads the 2.1 packages of earlier releases and loads on Splice 0.9.4.
….10.2

- localnet layer: `@bootnodedev/canton-barebones` 0.7.0 -> 0.8.0, with the lock file;
- the `SPLICE_TAG` examples in both `.env.example` files and in fetch-daml-deps.mjs name 0.10.2.
…newer Postgres

- localnet-postgres.mjs: a new `up` step that runs before the LocalNet starts;
- when the release runs a newer Postgres major, it backs the volume up, dumps it and restores it;
- the backup volume is never removed, and the next `up` retries a move that stopped halfway;
- `reset` drops the dump a stopped move left, along with the ledger;
- `up` names Postgres when it is what kept the LocalNet from starting;
- splice-upgrade.md: shorter, with a Postgres section and a restart after the vote, not a wait;
- README, the architecture.md files and CLAUDE.md name the new step.
…than the preferred

- the bootstrap reused the active factory whatever its package;
- the server builds on that package, so new grants stayed on the old one until a reset;
- now it archives a factory on another package than the preferred one and creates a new one;
- it warns that a running server keeps the archived factory until it restarts;
- CLAUDE.md and architecture.md say so.
Copilot AI balanced review requested due to automatic review settings November 18, 2026 18:19
@vercel

vercel Bot commented Nov 18, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
amulet-vesting-dappbooster.cc Ready Ready Preview Nov 18, 2026 6:28pm UTC
components.canton-dappbooster Ready Ready Preview Nov 18, 2026 6:28pm UTC
wallet-less-vesting-dappbooster.cc Ready Ready Preview Nov 18, 2026 6:28pm UTC

Request Review

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

Because the LocalNet Postgres major-version migration (volume probing, dump/restore, backups/retries) is operationally risky and the added tests rely on doubles, it needs end-to-end validation on a real Docker/Compose LocalNet with existing ledger data across supported hosts before it can be relied on.

No open issues 🎉

1 file not reviewed
  • pnpm-lock.yaml: Generated file
What changed in this PR

Updates the LocalNet scaffold and examples to Splice 0.10.2 (Postgres 18) while preserving existing LocalNet ledger data via an automated Postgres migration step.

Changes:

  • Bump @bootnodedev/canton-barebones to 0.8.0 (Splice 0.10.2) and refresh related docs.
  • Add and wire a Postgres dump/restore migration (with backup volume retention) into pnpm stack up/reset, plus supporting tests.
  • Move example/scaffold Daml builds to LF 2.3 and bump amulet-vesting to 0.0.4, updating walletless bootstrap/docs accordingly.
File Description
pnpm-lock.yaml Updates the lockfile to reflect the dependency bumps (including canton-barebones 0.8.0).
example-dapps/​amulet-vesting/​daml/​daml.yaml Bumps amulet-vesting to 0.0.4 and targets LF 2.3 for compatibility with the upgraded stack.
example-dapps/​amulet-vesting/​.env.example Refreshes the example configuration values (including the Splice tag) for the new version.
example-dapps/​amulet-vesting-walletless/​scripts/​bootstrap-vesting.mjs Adjusts bootstrap logic to prefer the factory on the preferred package, archiving/replacing any mismatched factory on an existing ledger.
example-dapps/​amulet-vesting-walletless/​daml/​daml.yaml Aligns the walletless Daml project to LF 2.3 and the 0.0.4 contract version.
example-dapps/​amulet-vesting-walletless/​CLAUDE.md Updates walletless app guidance to match the new factory/package-preference behavior and upgrade notes.
example-dapps/​amulet-vesting-walletless/​architecture.md Updates architectural documentation to describe the factory replacement behavior across packages on persistent ledgers.
example-dapps/​amulet-vesting-walletless/​.env.example Updates the sample environment variables to match the Splice 0.10.2 setup.
CLAUDE.md Updates repo-level notes to reflect the LocalNet upgrade flow, including Postgres migration/backup behavior.
canton-create/​scaffold/​starter/​daml/​daml.yaml Updates the starter scaffold to target LF 2.3.
canton-create/​scaffold/​localnet/​splice-upgrade.md Refreshes the LocalNet upgrade guide for Splice 0.10.2 and the Postgres migration workflow.
canton-create/​scaffold/​localnet/​scripts/​localnet-postgres.test.mjs Adds unit tests for the Postgres migration helper logic and expected docker/barebones call sequencing.
canton-create/​scaffold/​localnet/​scripts/​localnet-postgres.mjs Introduces a Postgres major-version migration script that dump/restores data and retains a backup volume.
canton-create/​scaffold/​localnet/​scripts/​dev-stack.test.mjs Extends dev-stack tests to cover Postgres-exited messaging and cleanup behavior on reset.
canton-create/​scaffold/​localnet/​scripts/​dev-stack.sh Wires the Postgres migration step into up and adds reset-time cleanup and improved failure messaging.
canton-create/​scaffold/​localnet/​README.md Documents that stack up may run a Postgres migration and keep a backup volume during upgrades.
canton-create/​scaffold/​localnet/​package.json Bumps the LocalNet scaffold dependency to @bootnodedev/canton-barebones@0.8.0.
canton-create/​scaffold/​daml-tooling/​scripts/​fetch-daml-deps.mjs Updates the example Splice tag in error/help text to 0.10.2.
canton-create/​architecture.md Updates scaffold architecture documentation to include the new LocalNet Postgres migration script.
architecture.md Updates the repo-level architecture/command documentation to reference the new LocalNet Postgres migration helper.

Review effort: Balanced
Copilot was unable to complete this review at the selected tier due to model policy or plan restrictions.

- CI's frozen install refused 0.8.0, published the same day;
- it is ours, so every version is exempt, by name.

This branch was successfully deployed

2 active deployments
Preview – amulet-vesting-dappbooster.cc — de6b693b Deployed Nov 18, 2026 by vercel[bot]
Preview – components.canton-dappbooster — de6b693b Deployed Nov 18, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: In review

Development

Successfully merging this pull request may close these issues.

2 participants