@fairmint/canton-node-sdk 0.0.250 → 0.0.252

package/scripts/localnet-cloud.sh

@@ -1,1178 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
-PROJECT_ROOT="${CANTON_LOCALNET_PROJECT_ROOT:-$(pwd)}"
-QUICKSTART_DIR="${CANTON_LOCALNET_QUICKSTART_DIR:-${REPO_ROOT}/libs/cn-quickstart/quickstart}"
-DOCKERD_PID_FILE="/tmp/localnet-dockerd.pid"
-DOCKERD_LOG_FILE="/tmp/localnet-dockerd.log"
-HOSTS_ENTRY="127.0.0.1 scan.localhost sv.localhost wallet.localhost"
-CURL_CONNECT_TIMEOUT=2
-CURL_MAX_TIME=5
-LOCALNET_SPLICE_VERSION="${CANTON_LOCALNET_SPLICE_VERSION:-}"
-LOCALNET_SCRIBE_VERSION="${CANTON_LOCALNET_SCRIBE_VERSION:-}"
-LOCALNET_PROTOCOL_VERSION="${CANTON_LOCALNET_PROTOCOL_VERSION:-}"
-VALIDATOR_READY_ATTEMPTS="${CANTON_LOCALNET_VALIDATOR_READY_ATTEMPTS:-90}"
-SCAN_READY_ATTEMPTS="${CANTON_LOCALNET_SCAN_READY_ATTEMPTS:-90}"
-SPLICE_CONFIG_PENDING_KEY="CANTON_NODE_SDK_SPLICE_CONFIG_PENDING"
-SPLICE_CONFIG_CHANGED="false"
-
-log() {
-  printf '[localnet] %s\n' "$*"
-}
-
-is_truthy() {
-  case "${1,,}" in
-    1 | true | yes | on)
-      return 0
-      ;;
-    *)
-      return 1
-      ;;
-  esac
-}
-
-require_command() {
-  local cmd="$1"
-  if ! command -v "${cmd}" >/dev/null 2>&1; then
-    log "Missing required command: ${cmd}"
-    exit 1
-  fi
-}
-
-require_positive_integer() {
-  local name="$1"
-  local value="$2"
-
-  if [[ ! "${value}" =~ ^[1-9][0-9]*$ ]]; then
-    log "${name} must be a positive integer; received '${value}'."
-    exit 1
-  fi
-}
-
-validate_configuration() {
-  require_positive_integer "CANTON_LOCALNET_VALIDATOR_READY_ATTEMPTS" "${VALIDATOR_READY_ATTEMPTS}"
-  require_positive_integer "CANTON_LOCALNET_SCAN_READY_ATTEMPTS" "${SCAN_READY_ATTEMPTS}"
-}
-
-ensure_sudo() {
-  if ! sudo_noninteractive_available; then
-    log "Passwordless sudo is required in this cloud environment."
-    exit 1
-  fi
-}
-
-sudo_noninteractive_available() {
-  command -v sudo >/dev/null 2>&1 && sudo -n true >/dev/null 2>&1
-}
-
-ensure_docker_packages() {
-  if command -v docker >/dev/null 2>&1 \
-    && docker compose version >/dev/null 2>&1; then
-    return
-  fi
-
-  if ! sudo_noninteractive_available || ! command -v apt-get >/dev/null 2>&1; then
-    log "Docker with Compose is required. Install Docker and start it, then retry."
-    exit 1
-  fi
-
-  log "Installing Docker packages..."
-  sudo apt-get update
-  sudo apt-get install -y docker.io docker-compose docker-compose-v2
-}
-
-ensure_legacy_iptables() {
-  if ! command -v update-alternatives >/dev/null 2>&1 \
-    || [[ ! -x /usr/sbin/iptables-legacy || ! -x /usr/sbin/ip6tables-legacy ]]; then
-    log "iptables legacy binaries unavailable; skipping backend switch."
-    return
-  fi
-
-  if ! iptables --version 2>/dev/null | grep -q 'legacy'; then
-    log "Switching iptables to legacy backend..."
-    sudo update-alternatives --set iptables /usr/sbin/iptables-legacy
-  fi
-
-  if ! ip6tables --version 2>/dev/null | grep -q 'legacy'; then
-    log "Switching ip6tables to legacy backend..."
-    sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy
-  fi
-}
-
-docker_ready() {
-  docker info >/dev/null 2>&1 || (sudo_noninteractive_available && sudo docker info >/dev/null 2>&1)
-}
-
-configure_docker_socket_permissions() {
-  if [[ ! -S /var/run/docker.sock ]]; then
-    return
-  fi
-
-  if ! sudo_noninteractive_available; then
-    return
-  fi
-
-  sudo groupadd -f docker >/dev/null 2>&1 || true
-  sudo chown root:docker /var/run/docker.sock >/dev/null 2>&1 || true
-  sudo chmod 660 /var/run/docker.sock || true
-}
-
-run_docker() {
-  if docker info >/dev/null 2>&1; then
-    docker "$@"
-    return
-  fi
-  if ! sudo_noninteractive_available || ! sudo docker info >/dev/null 2>&1; then
-    log "Docker daemon is not available."
-    exit 1
-  fi
-  sudo docker "$@"
-}
-
-resolve_quickstart_image_tag() {
-  local env_file=""
-  local splice_version=""
-  local parsed_value=""
-
-  for env_file in "${QUICKSTART_DIR}/.env" "${QUICKSTART_DIR}/.env.local"; do
-    if [[ ! -f "${env_file}" ]]; then
-      continue
-    fi
-
-    parsed_value="$(awk -F= -v key="SPLICE_VERSION" '
-      $0 ~ /^[[:space:]]*#/ { next }
-      $1 == key {
-        value = substr($0, index($0, "=") + 1)
-        gsub(/^[[:space:]]+|[[:space:]]+$/, "", value)
-        gsub(/^"|"$/, "", value)
-        gsub(/^'\''|'\''$/, "", value)
-        parsed = value
-      }
-      END {
-        if (parsed != "") {
-          print parsed
-        }
-      }
-    ' "${env_file}")"
-
-    if [[ -n "${parsed_value}" ]]; then
-      splice_version="${parsed_value}"
-    fi
-  done
-
-  printf '%s' "${splice_version}"
-}
-
-run_quickstart_command() {
-  local command="$1"
-  local docker_shim_dir=""
-  local quickstart_image_tag=""
-  local quickstart_path="${HOME}/.dpm/bin:${HOME}/.daml/bin:${PATH}"
-  local status=0
-
-  quickstart_image_tag="$(resolve_quickstart_image_tag)"
-
-  if ! docker info >/dev/null 2>&1 && sudo docker info >/dev/null 2>&1; then
-    docker_shim_dir="$(mktemp -d "/tmp/canton-localnet-docker-shim.XXXXXX")"
-    cat >"${docker_shim_dir}/docker" <<'EOF'
-#!/usr/bin/env bash
-exec sudo -E docker "$@"
-EOF
-    chmod +x "${docker_shim_dir}/docker"
-    log "Using sudo docker shim for quickstart command."
-  fi
-
-  if [[ -n "${docker_shim_dir}" ]]; then
-    quickstart_path="${docker_shim_dir}:${quickstart_path}"
-  fi
-
-  set +e
-  (
-    cd "${QUICKSTART_DIR}"
-    MODULES_DIR="${QUICKSTART_DIR}/docker/modules" \
-      LOCALNET_DIR="${QUICKSTART_DIR}/docker/modules/localnet" \
-      IMAGE_TAG="${quickstart_image_tag}" \
-      PATH="${quickstart_path}" \
-      bash -lc "${command}"
-  )
-  status=$?
-  set -e
-
-  if [[ -n "${docker_shim_dir}" ]]; then
-    rm -rf "${docker_shim_dir}"
-  fi
-
-  return "${status}"
-}
-
-run_quickstart_make() {
-  local target="$1"
-  run_quickstart_command "make ${target}"
-}
-
-run_infra_compose() {
-  local compose_args="$1"
-  local keycloak_compose_file=""
-  local keycloak_env_file=""
-  local keycloak_profile=""
-
-  if [[ "$(current_auth_mode)" == "oauth2" ]]; then
-    keycloak_compose_file='-f "${MODULES_DIR}/keycloak/compose.yaml"'
-    keycloak_env_file='--env-file "${MODULES_DIR}/keycloak/compose.env"'
-    keycloak_profile='--profile keycloak'
-  fi
-
-  run_quickstart_command "docker compose \
-    -f \"\${LOCALNET_DIR}/compose.yaml\" \
-    ${keycloak_compose_file} \
-    --env-file .env \
-    --env-file .env.local \
-    --env-file \"\${LOCALNET_DIR}/compose.env\" \
-    --env-file \"\${LOCALNET_DIR}/env/common.env\" \
-    ${keycloak_env_file} \
-    --profile app-provider \
-    --profile app-user \
-    --profile sv \
-    ${keycloak_profile} \
-    ${compose_args}"
-}
-
-start_docker_daemon() {
-  local dockerd_pid=""
-
-  if docker_ready; then
-    configure_docker_socket_permissions
-    return
-  fi
-
-  if ! sudo_noninteractive_available; then
-    log "Docker daemon is not running. Start Docker and retry."
-    exit 1
-  fi
-
-  ensure_legacy_iptables
-
-  log "Starting Docker daemon with vfs storage driver..."
-  sudo nohup dockerd --host=unix:///var/run/docker.sock --pidfile="${DOCKERD_PID_FILE}" --storage-driver=vfs >"${DOCKERD_LOG_FILE}" 2>&1 &
-
-  for _ in $(seq 1 60); do
-    if sudo docker info >/dev/null 2>&1; then
-      configure_docker_socket_permissions
-      return
-    fi
-    if [[ -f "${DOCKERD_PID_FILE}" ]]; then
-      dockerd_pid="$(cat "${DOCKERD_PID_FILE}" 2>/dev/null || true)"
-      if [[ -n "${dockerd_pid}" ]] && ! ps -p "${dockerd_pid}" >/dev/null 2>&1; then
-        log "Docker daemon exited before becoming ready."
-        log "Inspect ${DOCKERD_LOG_FILE}."
-        exit 1
-      fi
-    fi
-    sleep 1
-  done
-
-  log "Docker failed to start. Inspect ${DOCKERD_LOG_FILE}."
-  exit 1
-}
-
-ensure_submodules() {
-  if [[ -n "${CANTON_LOCALNET_QUICKSTART_DIR:-}" ]]; then
-    if [[ -d "${QUICKSTART_DIR}" ]]; then
-      return
-    fi
-    log "Configured CANTON_LOCALNET_QUICKSTART_DIR does not exist: ${QUICKSTART_DIR}"
-    exit 1
-  fi
-
-  if [[ -d "${REPO_ROOT}/libs/splice" && -d "${QUICKSTART_DIR}" ]]; then
-    return
-  fi
-
-  require_command git
-
-  if ! git -C "${REPO_ROOT}" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
-    log "Missing localnet assets and not in a git checkout. Install from npm with bundled assets or clone SDK with submodules."
-    exit 1
-  fi
-
-  if [[ ! -d "${REPO_ROOT}/libs/splice" ]]; then
-    log "Initializing libs/splice submodule..."
-    git -C "${REPO_ROOT}" submodule update --init --depth 1 libs/splice
-  fi
-
-  if [[ ! -d "${REPO_ROOT}/libs/cn-quickstart" ]]; then
-    log "Initializing libs/cn-quickstart submodule..."
-    git -C "${REPO_ROOT}" submodule update --init --recursive libs/cn-quickstart
-  fi
-
-  if [[ ! -d "${QUICKSTART_DIR}" ]]; then
-    log "cn-quickstart directory not found after submodule init."
-    exit 1
-  fi
-}
-
-ensure_hosts_entries() {
-  if ! grep -Eq '(^|[[:space:]])scan\.localhost([[:space:]]|$)' /etc/hosts \
-    || ! grep -Eq '(^|[[:space:]])sv\.localhost([[:space:]]|$)' /etc/hosts \
-    || ! grep -Eq '(^|[[:space:]])wallet\.localhost([[:space:]]|$)' /etc/hosts; then
-    log "Adding localnet host aliases to /etc/hosts..."
-    if sudo_noninteractive_available; then
-      echo "${HOSTS_ENTRY}" | sudo tee -a /etc/hosts >/dev/null
-      return
-    fi
-    if [[ -t 0 ]] && command -v sudo >/dev/null 2>&1; then
-      echo "${HOSTS_ENTRY}" | sudo tee -a /etc/hosts >/dev/null
-      return
-    fi
-    log "Missing localnet host aliases. Add this line to /etc/hosts, then retry:"
-    log "${HOSTS_ENTRY}"
-    exit 1
-  fi
-}
-
-set_quickstart_env_value() {
-  local file="$1"
-  local key="$2"
-  local value="$3"
-
-  if [[ ! -f "${file}" ]]; then
-    return
-  fi
-
-  if grep -Eq "^${key}=" "${file}"; then
-    KEY="${key}" VALUE="${value}" perl -0pi -e '
-      my $key = $ENV{"KEY"};
-      my $value = $ENV{"VALUE"};
-      s/^\Q$key\E=.*/$key=$value/m;
-    ' "${file}"
-  else
-    printf '\n%s=%s\n' "${key}" "${value}" >>"${file}"
-  fi
-}
-
-patch_quickstart_canton_healthcheck() {
-  local healthcheck="${QUICKSTART_DIR}/docker/modules/localnet/docker/canton/health-check.sh"
-
-  if [[ ! -f "${healthcheck}" ]]; then
-    log "Canton quickstart healthcheck not found: ${healthcheck}"
-    exit 1
-  fi
-
-  cat >"${healthcheck}" <<'EOF'
-#!/bin/bash
-set -eou pipefail
-
-http_check() {
-  local port="$1"
-  local path="$2"
-  local status=""
-
-  echo "Checking http://localhost:${port}${path}"
-  exec 3<>"/dev/tcp/127.0.0.1/${port}"
-  printf 'GET %s HTTP/1.1\r\nHost: localhost\r\nConnection: close\r\n\r\n' "${path}" >&3
-  IFS=$'\r' read -r status <&3 || true
-  exec 3<&-
-  exec 3>&-
-
-  case "${status}" in
-    HTTP/*\ 2*) ;;
-    *)
-      echo "Unexpected status from ${port}${path}: ${status}"
-      return 1
-      ;;
-  esac
-}
-
-if [ "${APP_USER_PROFILE:-off}" = "on" ]; then
-  http_check "2${CANTON_HTTP_HEALTHCHECK_PORT_SUFFIX}" "/health"
-fi
-if [ "${APP_PROVIDER_PROFILE:-off}" = "on" ]; then
-  http_check "3${CANTON_HTTP_HEALTHCHECK_PORT_SUFFIX}" "/health"
-fi
-if [ "${SV_PROFILE:-off}" = "on" ]; then
-  http_check "4${CANTON_HTTP_HEALTHCHECK_PORT_SUFFIX}" "/health"
-fi
-EOF
-  chmod +x "${healthcheck}"
-}
-
-patch_quickstart_splice_healthcheck() {
-  local healthcheck="${QUICKSTART_DIR}/docker/modules/localnet/docker/splice/health-check.sh"
-
-  if [[ ! -f "${healthcheck}" ]]; then
-    log "Splice quickstart healthcheck not found: ${healthcheck}"
-    exit 1
-  fi
-
-  cat >"${healthcheck}" <<'EOF'
-#!/bin/bash
-set -eou pipefail
-
-http_check() {
-  local port="$1"
-  local path="$2"
-  local status=""
-
-  echo "Checking http://localhost:${port}${path}"
-  exec 3<>"/dev/tcp/127.0.0.1/${port}"
-  printf 'GET %s HTTP/1.1\r\nHost: localhost\r\nConnection: close\r\n\r\n' "${path}" >&3
-  IFS=$'\r' read -r status <&3 || true
-  exec 3<&-
-  exec 3>&-
-
-  case "${status}" in
-    HTTP/*\ 2*) ;;
-    *)
-      echo "Unexpected status from ${port}${path}: ${status}"
-      return 1
-      ;;
-  esac
-}
-
-if [ "${APP_USER_PROFILE:-off}" = "on" ]; then
-  http_check "2${VALIDATOR_ADMIN_API_PORT_SUFFIX}" "/api/validator/readyz"
-fi
-if [ "${APP_PROVIDER_PROFILE:-off}" = "on" ]; then
-  http_check "3${VALIDATOR_ADMIN_API_PORT_SUFFIX}" "/api/validator/readyz"
-fi
-if [ "${SV_PROFILE:-off}" = "on" ]; then
-  http_check "4${VALIDATOR_ADMIN_API_PORT_SUFFIX}" "/api/validator/readyz"
-  http_check "5012" "/api/scan/readyz"
-  http_check "5014" "/api/sv/readyz"
-fi
-EOF
-  chmod +x "${healthcheck}"
-}
-
-configure_quickstart_localnet() {
-  local env_file=""
-  local canton_conf="${QUICKSTART_DIR}/docker/modules/localnet/conf/canton/app.conf"
-  local splice_sv_conf="${QUICKSTART_DIR}/docker/modules/localnet/conf/splice/sv/app.conf"
-
-  SPLICE_CONFIG_CHANGED="false"
-  if [[ "$(quickstart_env_value "${SPLICE_CONFIG_PENDING_KEY}")" == "true" ]]; then
-    SPLICE_CONFIG_CHANGED="true"
-  fi
-
-  for env_file in "${QUICKSTART_DIR}/.env" "${QUICKSTART_DIR}/.env.local"; do
-    if [[ -n "${LOCALNET_SPLICE_VERSION}" ]]; then
-      set_quickstart_env_value "${env_file}" "SPLICE_VERSION" "${LOCALNET_SPLICE_VERSION}"
-    fi
-    if [[ -n "${LOCALNET_SCRIBE_VERSION}" ]]; then
-      set_quickstart_env_value "${env_file}" "SCRIBE_VERSION" "${LOCALNET_SCRIBE_VERSION}"
-    fi
-    if [[ -n "${CANTON_LOCALNET_DAML_RUNTIME_VERSION:-}" ]]; then
-      set_quickstart_env_value "${env_file}" "DAML_RUNTIME_VERSION" "${CANTON_LOCALNET_DAML_RUNTIME_VERSION}"
-    fi
-  done
-
-  if [[ ! -f "${canton_conf}" ]]; then
-    log "Canton quickstart config not found: ${canton_conf}"
-    exit 1
-  fi
-
-  if [[ ! -f "${splice_sv_conf}" ]]; then
-    log "Splice SV quickstart config not found: ${splice_sv_conf}"
-    exit 1
-  fi
-
-  if ! grep -Eq '^[[:space:]]*canton\.scan-apps\.scan-app\.enable-forced-acs-snapshots[[:space:]]*=[[:space:]]*(true|yes|on)[[:space:]]*$' "${splice_sv_conf}"; then
-    cat >>"${splice_sv_conf}" <<'EOF'
-
-# LocalNet integration tests use this endpoint to create deterministic snapshot-backed fixtures.
-canton.scan-apps.scan-app.enable-forced-acs-snapshots = true
-EOF
-    set_quickstart_env_value "${QUICKSTART_DIR}/.env.local" "${SPLICE_CONFIG_PENDING_KEY}" "true"
-    SPLICE_CONFIG_CHANGED="true"
-  fi
-
-  if [[ -n "${LOCALNET_PROTOCOL_VERSION}" ]]; then
-    PROTOCOL_VERSION="${LOCALNET_PROTOCOL_VERSION}" perl -0pi -e '
-      my $protocol_version = $ENV{"PROTOCOL_VERSION"};
-      s/initial-protocol-version = \d+/initial-protocol-version = $protocol_version/g;
-      s/(non-standard-config = yes\n)(?![[:space:]]*alpha-version-support = yes)/$1    alpha-version-support = yes\n/;
-      s/(initial-protocol-version = \d+\n)(?![[:space:]]*alpha-version-support = yes)/$1    alpha-version-support = yes\n/;
-    ' "${canton_conf}"
-  fi
-
-  patch_quickstart_canton_healthcheck
-  patch_quickstart_splice_healthcheck
-}
-
-requested_auth_mode() {
-  printf '%s' "${CANTON_LOCALNET_AUTH_MODE:-oauth2}"
-}
-
-quickstart_env_value() {
-  local key="$1"
-  local parsed_value=""
-
-  if [[ -f "${QUICKSTART_DIR}/.env.local" ]]; then
-    parsed_value="$(awk -F= -v key="${key}" '
-      $0 ~ /^[[:space:]]*#/ { next }
-      $1 == key {
-        value = substr($0, index($0, "=") + 1)
-        gsub(/^[[:space:]]+|[[:space:]]+$/, "", value)
-        gsub(/^"|"$/, "", value)
-        gsub(/^'\''|'\''$/, "", value)
-        parsed = value
-      }
-      END {
-        if (parsed != "") {
-          print parsed
-        }
-      }
-    ' "${QUICKSTART_DIR}/.env.local")"
-  fi
-
-  printf '%s' "${parsed_value}"
-}
-
-configured_auth_mode() {
-  quickstart_env_value "AUTH_MODE"
-}
-
-quickstart_profile_config_complete() {
-  local key=""
-
-  for key in OBSERVABILITY_ENABLED AUTH_MODE PARTY_HINT TEST_MODE; do
-    if [[ -z "$(quickstart_env_value "${key}")" ]]; then
-      return 1
-    fi
-  done
-
-  return 0
-}
-
-verify_configured_auth_mode() {
-  local expected_auth_mode="$1"
-  local actual_auth_mode=""
-
-  actual_auth_mode="$(configured_auth_mode)"
-  if [[ "${actual_auth_mode}" != "${expected_auth_mode}" ]]; then
-    log "cn-quickstart setup did not configure AUTH_MODE=${expected_auth_mode}; found '${actual_auth_mode:-unset}'."
-    exit 1
-  fi
-}
-
-current_auth_mode() {
-  local configured=""
-
-  configured="$(configured_auth_mode)"
-  if [[ -n "${configured}" ]]; then
-    printf '%s' "${configured}"
-    return
-  fi
-
-  requested_auth_mode
-}
-
-run_quickstart_setup() {
-  local auth_mode=""
-
-  auth_mode="$(requested_auth_mode)"
-  case "${auth_mode}" in
-    shared-secret)
-      log "Running cn-quickstart setup (shared-secret mode)..."
-      (
-        cd "${QUICKSTART_DIR}"
-        printf 'Y\nn\n\n' | make setup || true
-      )
-      verify_configured_auth_mode "shared-secret"
-      ;;
-    oauth2)
-      log "Running cn-quickstart setup (OAuth2 enabled)..."
-      (
-        cd "${QUICKSTART_DIR}"
-        # Match CI behavior first, then fall back to prompt-based answers for newer setup flows.
-        echo "2" | make setup || true
-        if [[ "$(configured_auth_mode)" != "oauth2" ]]; then
-          printf 'y\ny\n\nn\n' | make setup
-        fi
-      )
-      verify_configured_auth_mode "oauth2"
-      ;;
-    *)
-      log "Unsupported CANTON_LOCALNET_AUTH_MODE: ${auth_mode}"
-      exit 1
-      ;;
-  esac
-}
-
-quickstart_setup() {
-  if [[ ! -f "${QUICKSTART_DIR}/.env.local" ]]; then
-    run_quickstart_setup
-  elif ! quickstart_profile_config_complete; then
-    log "Regenerating incomplete cn-quickstart config."
-    rm -f "${QUICKSTART_DIR}/.env.local"
-    run_quickstart_setup
-  elif [[ -n "${CANTON_LOCALNET_AUTH_MODE:-}" && "$(configured_auth_mode)" != "${CANTON_LOCALNET_AUTH_MODE}" ]]; then
-    log "Regenerating cn-quickstart config for CANTON_LOCALNET_AUTH_MODE=${CANTON_LOCALNET_AUTH_MODE}."
-    rm -f "${QUICKSTART_DIR}/.env.local"
-    run_quickstart_setup
-  else
-    log "Reusing existing ${QUICKSTART_DIR}/.env.local."
-  fi
-
-  if [[ ! -f "${QUICKSTART_DIR}/.env.local" ]]; then
-    log "cn-quickstart setup failed: ${QUICKSTART_DIR}/.env.local was not created."
-    exit 1
-  fi
-
-  configure_quickstart_localnet
-
-  if quickstart_infra_only_enabled; then
-    log "Skipping Daml SDK install for infrastructure-only localnet."
-    return
-  fi
-
-  if [[ ! -x "${HOME}/.daml/bin/daml" ]]; then
-    log "Installing Daml SDK..."
-    (
-      cd "${QUICKSTART_DIR}"
-      make install-daml-sdk
-    )
-  else
-    log "Reusing existing Daml SDK at ${HOME}/.daml/bin/daml."
-  fi
-}
-
-quickstart_fast_start_enabled() {
-  is_truthy "${CANTON_LOCALNET_FAST_START:-true}"
-}
-
-quickstart_force_full_start() {
-  is_truthy "${CANTON_LOCALNET_FORCE_FULL_START:-false}"
-}
-
-quickstart_infra_only_enabled() {
-  is_truthy "${CANTON_LOCALNET_INFRA_ONLY:-false}"
-}
-
-quickstart_build_artifacts_ready() {
-  local missing_paths=()
-
-  if [[ ! -f "${QUICKSTART_DIR}/backend/build/distributions/backend.tar" ]]; then
-    missing_paths+=("backend/build/distributions/backend.tar")
-  fi
-
-  if [[ ! -d "${QUICKSTART_DIR}/frontend/dist" ]]; then
-    missing_paths+=("frontend/dist")
-  fi
-
-  if ! compgen -G "${QUICKSTART_DIR}/daml/licensing/.daml/dist/*.dar" >/dev/null; then
-    missing_paths+=("daml/licensing/.daml/dist/*.dar")
-  fi
-
-  if ! compgen -G "${QUICKSTART_DIR}/backend/build/otel-agent/opentelemetry-javaagent-*.jar" >/dev/null; then
-    missing_paths+=("backend/build/otel-agent/opentelemetry-javaagent-*.jar")
-  fi
-
-  if [[ ${#missing_paths[@]} -gt 0 ]]; then
-    log "Fast start unavailable; missing quickstart build artifacts: ${missing_paths[*]}"
-    return 1
-  fi
-
-  return 0
-}
-
-extract_quickstart_compose_up_command() {
-  (
-    cd "${QUICKSTART_DIR}"
-    make -n start 2>/dev/null | awk '/docker compose .* up -d --no-recreate/{line=$0} END{print line}'
-  )
-}
-
-try_fast_start_localnet() {
-  local compose_up_command=""
-
-  compose_up_command="$(extract_quickstart_compose_up_command)"
-  if [[ -z "${compose_up_command}" ]]; then
-    log "Unable to determine quickstart compose startup command."
-    return 1
-  fi
-
-  log "Starting cn-quickstart with fast path (skip quickstart rebuild)..."
-  run_quickstart_command "${compose_up_command}"
-}
-
-start_infra_only_localnet() {
-  log "Starting cn-quickstart LocalNet infrastructure only (skip quickstart app, PQS, and onboarding)."
-  run_infra_compose 'up -d --no-recreate'
-}
-
-splice_container_running() {
-  local running=""
-
-  running="$(run_docker inspect --format '{{.State.Running}}' splice 2>/dev/null || true)"
-  [[ "${running}" == "true" ]]
-}
-
-recreate_splice_after_config_change() {
-  local should_recreate="$1"
-
-  if [[ "${should_recreate}" != "true" ]]; then
-    return
-  fi
-
-  log "Recreating the running Splice service to apply updated LocalNet configuration."
-  run_infra_compose 'up -d --no-deps --force-recreate splice'
-}
-
-mark_splice_config_applied() {
-  if [[ "${SPLICE_CONFIG_CHANGED}" != "true" ]]; then
-    return
-  fi
-
-  set_quickstart_env_value "${QUICKSTART_DIR}/.env.local" "${SPLICE_CONFIG_PENDING_KEY}" "false"
-  SPLICE_CONFIG_CHANGED="false"
-}
-
-stop_infra_only_localnet() {
-  if [[ ! -f "${QUICKSTART_DIR}/.env.local" ]]; then
-    return
-  fi
-
-  log "Stopping cn-quickstart LocalNet infrastructure-only stack..."
-  run_infra_compose down || true
-}
-
-wait_for_services() {
-  local auth_mode=""
-  local code=""
-  local ledger_code=""
-
-  auth_mode="$(current_auth_mode)"
-
-  if [[ "${auth_mode}" == "oauth2" ]]; then
-    log "Waiting for Keycloak..."
-    for _ in $(seq 1 30); do
-      if curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -fsS http://localhost:8082/realms/AppProvider >/dev/null 2>&1; then
-        break
-      fi
-      sleep 2
-    done
-    if ! curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -fsS http://localhost:8082/realms/AppProvider >/dev/null 2>&1; then
-      log "Keycloak did not become ready."
-      exit 1
-    fi
-  else
-    log "Checking for Keycloak (optional in ${auth_mode} mode)..."
-    for _ in $(seq 1 5); do
-      if curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -fsS http://localhost:8082/realms/AppProvider >/dev/null 2>&1; then
-        log "Keycloak is ready."
-        break
-      fi
-      sleep 2
-    done
-  fi
-
-  log "Waiting for Validator API..."
-  for _ in $(seq 1 "${VALIDATOR_READY_ATTEMPTS}"); do
-    code="$(curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -sS -o /dev/null -w '%{http_code}' http://localhost:3903/api/validator/v0/wallet/user-status || true)"
-    if [[ "${code}" == "200" || "${code}" == "401" ]]; then
-      break
-    fi
-    sleep 2
-  done
-  code="$(curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -sS -o /dev/null -w '%{http_code}' http://localhost:3903/api/validator/v0/wallet/user-status || true)"
-  if [[ "${code}" != "200" && "${code}" != "401" ]]; then
-    log "Validator API did not become ready."
-    exit 1
-  fi
-
-  log "Waiting for Scan API..."
-  for _ in $(seq 1 "${SCAN_READY_ATTEMPTS}"); do
-    if curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -fsS http://scan.localhost:4000/api/scan/v0/dso-party-id >/dev/null 2>&1; then
-      break
-    fi
-    sleep 2
-  done
-  if ! curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -fsS http://scan.localhost:4000/api/scan/v0/dso-party-id >/dev/null 2>&1; then
-    log "Scan API did not become ready."
-    exit 1
-  fi
-
-  log "Waiting for Ledger JSON API..."
-  for _ in $(seq 1 60); do
-    ledger_code="$(curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -sS -o /dev/null -w '%{http_code}' http://localhost:3975/v2/version || true)"
-    if [[ "${ledger_code}" == "200" || "${ledger_code}" == "401" ]]; then
-      break
-    fi
-    sleep 2
-  done
-  ledger_code="$(curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -sS -o /dev/null -w '%{http_code}' http://localhost:3975/v2/version || true)"
-  if [[ "${ledger_code}" != "200" && "${ledger_code}" != "401" ]]; then
-    log "Ledger JSON API did not become ready (HTTP ${ledger_code})."
-    exit 1
-  fi
-
-  log "All localnet services are ready."
-}
-
-start_localnet() {
-  local should_recreate_splice="false"
-
-  if [[ "${SPLICE_CONFIG_CHANGED}" == "true" ]] && splice_container_running; then
-    should_recreate_splice="true"
-  fi
-
-  if quickstart_force_full_start; then
-    log "Forcing full cn-quickstart start (CANTON_LOCALNET_FORCE_FULL_START=true)."
-    run_quickstart_make start
-    recreate_splice_after_config_change "${should_recreate_splice}"
-    wait_for_services
-    mark_splice_config_applied
-    return
-  fi
-
-  if quickstart_infra_only_enabled; then
-    start_infra_only_localnet
-    recreate_splice_after_config_change "${should_recreate_splice}"
-    wait_for_services
-    mark_splice_config_applied
-    return
-  fi
-
-  if quickstart_fast_start_enabled && quickstart_build_artifacts_ready; then
-    if try_fast_start_localnet; then
-      recreate_splice_after_config_change "${should_recreate_splice}"
-      wait_for_services
-      mark_splice_config_applied
-      return
-    fi
-    log "Fast start failed; falling back to full cn-quickstart start."
-  fi
-
-  log "Starting cn-quickstart with full build..."
-  run_quickstart_make start
-  recreate_splice_after_config_change "${should_recreate_splice}"
-  wait_for_services
-  mark_splice_config_applied
-}
-
-stop_localnet() {
-  if [[ ! -d "${QUICKSTART_DIR}" ]]; then
-    log "cn-quickstart directory not found; nothing to stop."
-    stop_managed_dockerd
-    return
-  fi
-
-  log "Stopping cn-quickstart..."
-  stop_infra_only_localnet
-  if [[ -f "${QUICKSTART_DIR}/Makefile" ]]; then
-    run_quickstart_make stop || true
-  else
-    log "Quickstart Makefile not found; skipping quickstart stop target."
-  fi
-  stop_managed_dockerd
-}
-
-stop_managed_dockerd() {
-  local pid=""
-  local cmd=""
-
-  if [[ ! -f "${DOCKERD_PID_FILE}" ]]; then
-    return
-  fi
-
-  pid="$(cat "${DOCKERD_PID_FILE}" 2>/dev/null || true)"
-  if [[ -z "${pid}" ]]; then
-    rm -f "${DOCKERD_PID_FILE}" "${DOCKERD_LOG_FILE}"
-    return
-  fi
-
-  if ! ps -p "${pid}" >/dev/null 2>&1; then
-    rm -f "${DOCKERD_PID_FILE}" "${DOCKERD_LOG_FILE}"
-    return
-  fi
-
-  cmd="$(ps -p "${pid}" -o comm= 2>/dev/null | tr -d '[:space:]')"
-  if [[ "${cmd}" != "dockerd" ]]; then
-    log "PID ${pid} is not dockerd; skipping daemon cleanup."
-    rm -f "${DOCKERD_PID_FILE}"
-    return
-  fi
-
-  if ! sudo -n true >/dev/null 2>&1; then
-    log "Cannot stop managed dockerd without passwordless sudo."
-    return
-  fi
-
-  log "Stopping managed dockerd (pid ${pid})..."
-  sudo kill -TERM "${pid}" >/dev/null 2>&1 || true
-  for _ in $(seq 1 10); do
-    if ! ps -p "${pid}" >/dev/null 2>&1; then
-      break
-    fi
-    sleep 1
-  done
-  if ps -p "${pid}" >/dev/null 2>&1; then
-    sudo kill -KILL "${pid}" >/dev/null 2>&1 || true
-  fi
-  rm -f "${DOCKERD_PID_FILE}" "${DOCKERD_LOG_FILE}"
-}
-
-status_localnet() {
-  if docker_ready; then
-    log "Docker daemon is running."
-  else
-    log "Docker daemon is not running."
-    exit 1
-  fi
-
-  run_docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'
-  echo
-
-  keycloak_ok="no"
-  validator_ok="no"
-  scan_ok="no"
-  ledger_ok="no"
-  if curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -fsS http://localhost:8082/realms/AppProvider >/dev/null 2>&1; then
-    keycloak_ok="yes"
-  fi
-  validator_code="$(curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -sS -o /dev/null -w '%{http_code}' http://localhost:3903/api/validator/v0/wallet/user-status || true)"
-  if [[ "${validator_code}" == "200" || "${validator_code}" == "401" ]]; then
-    validator_ok="yes"
-  fi
-  if curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -fsS http://scan.localhost:4000/api/scan/v0/dso-party-id >/dev/null 2>&1; then
-    scan_ok="yes"
-  fi
-  ledger_code="$(curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -sS -o /dev/null -w '%{http_code}' http://localhost:3975/v2/version || true)"
-  if [[ "${ledger_code}" == "200" || "${ledger_code}" == "401" ]]; then
-    ledger_ok="yes"
-  fi
-
-  printf 'Keycloak ready: %s\n' "${keycloak_ok}"
-  printf 'Validator ready: %s (HTTP %s)\n' "${validator_ok}" "${validator_code:-n/a}"
-  printf 'Scan ready: %s\n' "${scan_ok}"
-  printf 'Ledger JSON API ready: %s (HTTP %s)\n' "${ledger_ok}" "${ledger_code:-n/a}"
-}
-
-show_localnet_logs() {
-  log "==================== Docker Containers ===================="
-  if docker_ready; then
-    run_docker ps -a || true
-  else
-    log "Docker daemon is not running."
-  fi
-
-  echo
-  log "==================== Docker Compose Logs ===================="
-  if [[ -f "${QUICKSTART_DIR}/.env.local" ]]; then
-    run_infra_compose 'logs --tail=100' || true
-  elif [[ -d "${QUICKSTART_DIR}" ]]; then
-    log "Quickstart local env not found; skipping compose logs: ${QUICKSTART_DIR}/.env.local"
-  else
-    log "cn-quickstart directory not found: ${QUICKSTART_DIR}"
-  fi
-
-  echo
-  log "==================== Canton Logs ===================="
-  if [[ -f "${QUICKSTART_DIR}/logs/canton.log" ]]; then
-    tail -100 "${QUICKSTART_DIR}/logs/canton.log" || true
-  else
-    log "Canton log not found: ${QUICKSTART_DIR}/logs/canton.log"
-  fi
-
-  if [[ -f "${DOCKERD_LOG_FILE}" ]]; then
-    echo
-    log "==================== Managed Docker Daemon Logs ===================="
-    tail -100 "${DOCKERD_LOG_FILE}" || true
-  fi
-}
-
-run_smoke() {
-  local auth_mode=""
-  local validator_code=""
-  local ledger_code=""
-
-  log "Running localnet smoke checks..."
-  auth_mode="$(current_auth_mode)"
-
-  if curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -fsS http://localhost:8082/realms/AppProvider >/dev/null 2>&1; then
-    log "Keycloak is reachable."
-  elif [[ "${auth_mode}" == "oauth2" ]]; then
-    log "Keycloak is not reachable."
-    exit 1
-  else
-    log "Keycloak not detected (expected in ${auth_mode} mode)."
-  fi
-
-  validator_code="$(curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -sS -o /dev/null -w '%{http_code}' http://localhost:3903/api/validator/v0/wallet/user-status || true)"
-  if [[ "${validator_code}" != "200" && "${validator_code}" != "401" ]]; then
-    log "Validator API is not reachable (HTTP ${validator_code})."
-    exit 1
-  fi
-
-  if ! curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -fsS http://scan.localhost:4000/api/scan/v0/dso-party-id >/dev/null 2>&1; then
-    log "Scan API is not reachable."
-    exit 1
-  fi
-
-  ledger_code="$(curl --connect-timeout "${CURL_CONNECT_TIMEOUT}" --max-time "${CURL_MAX_TIME}" -sS -o /dev/null -w '%{http_code}' http://localhost:3975/v2/version || true)"
-  if [[ "${ledger_code}" != "200" && "${ledger_code}" != "401" ]]; then
-    log "Ledger JSON API is not reachable (HTTP ${ledger_code})."
-    exit 1
-  fi
-
-  log "Smoke checks passed."
-}
-
-read_npm_script() {
-  local target_dir="$1"
-  local script_name="$2"
-
-  if [[ ! -f "${target_dir}/package.json" ]]; then
-    return
-  fi
-
-  node -e 'const fs=require("fs"); const pkgPath=process.argv[1]; const scriptName=process.argv[2]; try { const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8")); const script = pkg?.scripts?.[scriptName]; if (typeof script === "string") process.stdout.write(script); } catch {}' "${target_dir}/package.json" "${script_name}"
-}
-
-script_is_recursive_localnet_test() {
-  local script_value="$1"
-  echo "${script_value}" | grep -Eq '(^|[[:space:]])(canton-localnet[[:space:]]+test|[^[:space:]]*localnet-cloud\.sh[[:space:]]+test)([[:space:]]|$)'
-}
-
-run_integration_tests() {
-  local script_value=""
-
-  if [[ -n "${CANTON_LOCALNET_TEST_CMD:-}" ]]; then
-    log "Running custom integration command from CANTON_LOCALNET_TEST_CMD..."
-    (
-      cd "${PROJECT_ROOT}"
-      bash -lc "${CANTON_LOCALNET_TEST_CMD}"
-    )
-    return
-  fi
-
-  script_value="$(read_npm_script "${PROJECT_ROOT}" "test:integration")"
-  if [[ -n "${script_value}" ]]; then
-    if script_is_recursive_localnet_test "${script_value}"; then
-      log "Skipping recursive test:integration script."
-    else
-      log "Running project integration tests: npm run test:integration"
-      (
-        cd "${PROJECT_ROOT}"
-        npm run test:integration
-      )
-      return
-    fi
-  fi
-
-  script_value="$(read_npm_script "${PROJECT_ROOT}" "test:localnet")"
-  if [[ -n "${script_value}" ]]; then
-    if script_is_recursive_localnet_test "${script_value}"; then
-      log "Skipping recursive test:localnet script."
-    else
-      log "Running project integration tests: npm run test:localnet"
-      (
-        cd "${PROJECT_ROOT}"
-        npm run test:localnet
-      )
-      return
-    fi
-  fi
-
-  if [[ "${PROJECT_ROOT}" == "${REPO_ROOT}" && -d "${REPO_ROOT}/test/integration/localnet" && -d "${REPO_ROOT}/node_modules" ]]; then
-    log "Running bundled SDK localnet integration tests..."
-    (
-      cd "${REPO_ROOT}"
-      npm test -- test/integration/localnet
-    )
-    return
-  fi
-
-  log "No integration test command configured; skipping test step."
-}
-
-usage() {
-  cat <<'USAGE'
-Usage: scripts/localnet/localnet-cloud.sh <command>
-
-Commands:
-  setup    Install prerequisites, init submodules, configure quickstart
-  start    Start localnet and wait for ready endpoints
-  stop     Stop localnet services
-  logs     Show localnet diagnostic logs
-  status   Show docker + endpoint status
-  smoke    Run endpoint smoke checks
-  test     Run project integration tests (if configured)
-  verify   Run setup + start + smoke + test
-
-Environment:
-  CANTON_LOCALNET_FAST_START=true|false       Enable fast startup path (default: true)
-  CANTON_LOCALNET_FORCE_FULL_START=true|false Force full startup with rebuild
-  CANTON_LOCALNET_INFRA_ONLY=true|false       Start only LocalNet + Keycloak infrastructure
-  CANTON_LOCALNET_AUTH_MODE=oauth2|shared-secret
-  CANTON_LOCALNET_QUICKSTART_DIR=<path>       Use an existing cn-quickstart/quickstart directory
-USAGE
-}
-
-main() {
-  if [[ "${1:-}" == "" ]]; then
-    usage
-    exit 1
-  fi
-
-  case "$1" in
-    setup)
-      validate_configuration
-      ensure_docker_packages
-      start_docker_daemon
-      ensure_submodules
-      ensure_hosts_entries
-      quickstart_setup
-      ;;
-    start)
-      validate_configuration
-      require_command curl
-      ensure_docker_packages
-      start_docker_daemon
-      ensure_submodules
-      ensure_hosts_entries
-      quickstart_setup
-      start_localnet
-      ;;
-    stop)
-      stop_localnet
-      ;;
-    logs)
-      show_localnet_logs
-      ;;
-    status)
-      require_command curl
-      status_localnet
-      ;;
-    smoke)
-      require_command curl
-      run_smoke
-      ;;
-    test)
-      run_integration_tests
-      ;;
-    verify)
-      validate_configuration
-      require_command curl
-      ensure_docker_packages
-      start_docker_daemon
-      ensure_submodules
-      ensure_hosts_entries
-      quickstart_setup
-      start_localnet
-      run_smoke
-      run_integration_tests
-      ;;
-    *)
-      usage
-      exit 1
-      ;;
-  esac
-}
-
-if [[ "${BASH_SOURCE[0]}" == "$0" ]]; then
-  main "$@"
-fi