feat(bitcoin): multi-version support for Core & Knots (install/switch/pin/auto-update)
Lets a node runner choose which Bitcoin Core / Knots version to install
(latest pre-selected), then switch, pin, or opt into auto-update from the
app's interface — all manifest/catalog-driven, rootless, signed-registry,
zero-data-loss. Motivated by upcoming BIP-110 signalling: runners need a
real choice of software version.
Backend:
- version_config.rs: per-app pin + auto-update persistence (atomic, merge-
preserving), downgrade detection, auto-update enumeration (+ unit tests).
- app_catalog.rs: CatalogVersion / versions[] schema, catalog_versions(),
catalog_image_for_version() (same-repo guard); a pin suppresses the update
badge.
- prod_orchestrator.rs: pinned version wins over the catalog default on every
install/recreate.
- install.rs: install-time `version` param persisted (default = unpinned).
- set_config.rs: package.versions (read) + package.set-config (write) RPCs;
downgrade is gated behind explicit confirm (warn + confirm + allow).
- update.rs/main.rs: hourly per-app auto-update tick via the orchestrator
(opt-in, pin-respecting); fix handle_package_update to be non-fatal for
orchestrator-managed apps lacking a catalog primary image (bitcoin-core).
UI:
- MarketplaceAppDetails.vue: install-time version selector (shown when an app
offers >=2 versions).
- appDetails/AppSidebar.vue: "Version & Updates" card (switch / pin / auto-
update toggle / downgrade warning), per app.
- rpc-client.ts + en.json: RPC methods, types, strings.
Phase 0 image pipeline:
- scripts/build-bitcoin-image.sh: download official tarball + SHA256SUMS(.asc),
verify SHA-256 + pinned-maintainer OpenPGP signature (fail-closed), build a
minimal rootless image, smoke-test, tag + push.
- apps/bitcoin-core/Dockerfile rewritten (drops stale community base);
apps/bitcoin-knots/Dockerfile added.
- generate-app-catalog.sh: emit curated versions[]; published + catalog now
offers Core 25.2/26.2/27.2/28.4/29.3/30.2/31.0 + Knots 29.3.knots20260508.
docs/bitcoin-multi-version-design.md: live progress tracker.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
6aa74c7386