Archipelago — open-source initial import

2026-08-12 10:55:49 +00:00
commit 57a39f4b86
1642 changed files with 353148 additions and 0 deletions
@@ -0,0 +1,146 @@
+#!/usr/bin/env bats
+# tests/lifecycle/bats/btcpay.bats
+#
+# Lifecycle tests for the btcpay-server multi-container stack:
+#   - btcpay-server      (the main app)
+#   - archy-btcpay-db    (postgres)
+#   - archy-nbxplorer    (Bitcoin watcher)
+#
+# Multi-container variant of bitcoin-knots.bats / lnd.bats / electrumx.bats.
+# UI URL coverage is in ui-coverage.bats; this suite is L1 (RPC API) + L3
+# (lifecycle survival).
+#
+# Pre-req: btcpay-server installed, bitcoin-knots running.
+
+load '../lib/rpc.bash'
+
+setup_file() {
+  : "${ARCHY_PASSWORD:?Set ARCHY_PASSWORD env var to the UI password}"
+  export ARCHY_FORCE_LOGIN=1
+  rpc_login
+  unset ARCHY_FORCE_LOGIN
+}
+
+teardown_file() {
+  rpc_logout_local
+}
+
+btcpay_components=(
+  "btcpay-server"
+  "archy-btcpay-db"
+  "archy-nbxplorer"
+)
+
+@test "container-list includes every btcpay-stack component" {
+  run rpc_result container-list
+  [ "$status" -eq 0 ]
+  for c in "${btcpay_components[@]}"; do
+    echo "$output" | jq -e --arg n "$c" '.[] | select(.name == $n)' >/dev/null \
+      || skip "btcpay component $c not present (stack not installed)"
+  done
+}
+
+@test "container-list reports valid states for every btcpay component" {
+  run rpc_result container-list
+  [ "$status" -eq 0 ]
+  local present=0
+  for c in "${btcpay_components[@]}"; do
+    local state
+    state=$(echo "$output" | jq -r --arg n "$c" '.[] | select(.name == $n) | .state')
+    [[ -n "$state" ]] || continue
+    present=$((present + 1))
+    [[ "$state" =~ ^(running|stopped|exited|created|paused)$ ]] \
+      || fail "invalid state for $c: $state"
+  done
+  (( present > 0 )) || skip "btcpay stack not installed"
+}
+
+@test "no orphan btcpay-related containers beyond the known set" {
+  local total known
+  total=$(podman ps -a --format '{{.Names}}' \
+    | grep -Ec '^(btcpay|archy-btcpay|archy-nbxplorer)' || true)
+  known=$(podman ps -a --format '{{.Names}}' \
+    | grep -Ec '^(btcpay-server|archy-btcpay-db|archy-nbxplorer)$' || true)
+  [ "$total" -eq "$known" ]
+}
+
+# ────────────────────────────────────────────────────────────────────
+# Destructive tier
+# ────────────────────────────────────────────────────────────────────
+
+@test "package.stop transitions btcpay-server to stopped" {
+  [[ "${ARCHY_ALLOW_DESTRUCTIVE:-0}" == "1" ]] || skip "ARCHY_ALLOW_DESTRUCTIVE not set"
+  podman inspect btcpay-server --format '{{.State.Status}}' >/dev/null 2>&1 \
+    || skip "btcpay-server not installed"
+
+  run rpc_result package.stop '{"id":"btcpay-server"}'
+  [ "$status" -eq 0 ]
+
+  run wait_for_container_status btcpay-server stopped 60
+  [ "$status" -eq 0 ]
+}
+
+@test "package.start brings btcpay-server back to running" {
+  [[ "${ARCHY_ALLOW_DESTRUCTIVE:-0}" == "1" ]] || skip "ARCHY_ALLOW_DESTRUCTIVE not set"
+  podman inspect btcpay-server --format '{{.State.Status}}' >/dev/null 2>&1 \
+    || skip "btcpay-server not installed"
+
+  run rpc_result package.start '{"id":"btcpay-server"}'
+  [ "$status" -eq 0 ]
+
+  run wait_for_container_status btcpay-server running 180
+  [ "$status" -eq 0 ]
+}
+
+@test "package.restart leaves btcpay-server in running state" {
+  [[ "${ARCHY_ALLOW_DESTRUCTIVE:-0}" == "1" ]] || skip "ARCHY_ALLOW_DESTRUCTIVE not set"
+  podman inspect btcpay-server --format '{{.State.Status}}' >/dev/null 2>&1 \
+    || skip "btcpay-server not installed"
+
+  run rpc_result package.restart '{"id":"btcpay-server"}'
+  [ "$status" -eq 0 ]
+
+  run wait_for_container_status btcpay-server running 180
+  [ "$status" -eq 0 ]
+}
+
+@test "db + nbxplorer remain running across btcpay-server restart" {
+  [[ "${ARCHY_ALLOW_DESTRUCTIVE:-0}" == "1" ]] || skip "ARCHY_ALLOW_DESTRUCTIVE not set"
+  for c in archy-btcpay-db archy-nbxplorer; do
+    podman inspect "$c" --format '{{.State.Status}}' >/dev/null 2>&1 \
+      || skip "btcpay supporting container $c not installed"
+  done
+
+  for c in archy-btcpay-db archy-nbxplorer; do
+    local state
+    state=$(podman inspect --format '{{.State.Status}}' "$c" 2>/dev/null)
+    [[ "$state" == "running" ]] \
+      || fail "supporting btcpay container $c is not running (state=$state) — package.restart cascaded into it"
+  done
+}
+
+@test "package.uninstall removes the whole btcpay stack" {
+  [[ "${ARCHY_ALLOW_CASCADE_DESTRUCTIVE:-0}" == "1" ]] || skip "ARCHY_ALLOW_CASCADE_DESTRUCTIVE not set"
+  podman inspect btcpay-server --format '{{.State.Status}}' >/dev/null 2>&1 \
+    || skip "btcpay-server not installed"
+
+  run rpc_result package.uninstall '{"id":"btcpay-server","preserve_data":true}'
+  [ "$status" -eq 0 ]
+
+  for c in "${btcpay_components[@]}"; do
+    run wait_for_container_status "$c" absent 120
+    [ "$status" -eq 0 ] || fail "btcpay component $c not removed by uninstall"
+  done
+}
+
+@test "package.install restores the whole btcpay stack" {
+  [[ "${ARCHY_ALLOW_CASCADE_DESTRUCTIVE:-0}" == "1" ]] || skip "ARCHY_ALLOW_CASCADE_DESTRUCTIVE not set"
+
+  run rpc_result package.install '{"manifest_path":"btcpay-server/manifest.yaml"}'
+  [ "$status" -eq 0 ]
+
+  for c in "${btcpay_components[@]}"; do
+    run wait_for_container_status "$c" running 240
+    [ "$status" -eq 0 ] || fail "btcpay component $c never reached running after reinstall"
+  done
+}