Repository navigation
chore: bump canton-barebones to 0.8.0 - #290
Open
fernandomg wants to merge 5 commits into
Open
fernandomg wants to merge 5 commits into
fernandomg wants to merge 5 commits into
Conversation
- 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.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
There was a problem hiding this comment.
🔵 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-barebonesto 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
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
No related issue. Bumps canton-barebones to 0.8.0, which runs Splice 0.10.2.
Changes
upmoves the LocalNet's Postgres 14 data to 18 and keeps a backup;Test plan
Automated tests
pnpm test.Manual verification
pnpm dev:amulet-vesting up: it migrates, keeps the backup, and the ledger keeps its data.Breaking changes
None.
Checklist
Screenshots
None.