@fased/fased 0.1.67 → 0.1.69

package/install.sh

@@ -36,16 +36,61 @@ if [[ "$install_entry_legacy_ts_authkey" -eq 1 ]]; then
 fi
 
 if [[ "$install_entry_is_stream" -eq 1 && "$install_entry_hosting" -eq 1 ]]; then
-  echo "Refusing streamed VPS Hosting execution." >&2
-  echo "Download and verify the exact tagged install.sh before execution:" >&2
-  echo "  https://docs.fased.ai/install/vps" >&2
-  exit 1
+  if [[ "${#install_entry_args[@]}" -ne 1 || "${install_entry_args[0]:-}" != "--hosting" ]]; then
+    echo "Streamed VPS Hosting accepts only the exact fresh-install selector: --hosting" >&2
+    echo "Use an exact tagged, attested installer for repair, release overrides, or advanced selectors." >&2
+    exit 1
+  fi
+  install_entry_exported_env=()
+  mapfile -t install_entry_exported_env < <(compgen -e)
+  for install_entry_env_name in "${install_entry_exported_env[@]}"; do
+    if [[ "$install_entry_env_name" == FASED_* ]]; then
+      echo "Refusing Fased environment overrides during streamed VPS Hosting: ${install_entry_env_name}" >&2
+      exit 1
+    fi
+  done
+  install_entry_unsafe_env=(
+    HTTP_PROXY HTTPS_PROXY ALL_PROXY NO_PROXY http_proxy https_proxy all_proxy no_proxy
+    CURL_HOME CURL_CA_BUNDLE SSL_CERT_FILE SSL_CERT_DIR GIT_SSL_NO_VERIFY
+    GH_HOST GH_REPO GH_CONFIG_DIR TMPDIR LD_PRELOAD LD_LIBRARY_PATH BASH_ENV ENV CDPATH
+  )
+  for install_entry_env_name in "${install_entry_unsafe_env[@]}"; do
+    if [[ -n "${!install_entry_env_name+x}" ]]; then
+      echo "Refusing unsafe environment override during streamed VPS Hosting: ${install_entry_env_name}" >&2
+      exit 1
+    fi
+  done
+  install_entry_existing_hosting_paths=(
+    /etc/fased
+    /opt/fased
+    /var/lib/fased-installer
+    /var/lib/fased-gateway
+    /var/lib/fased-signerd
+    /etc/systemd/system/fased-gateway.service
+    /etc/systemd/system/fased-signerd.service
+    /usr/local/libexec/fased-gateway-launch
+    /usr/local/libexec/fased-host-updater
+  )
+  for install_entry_existing_path in "${install_entry_existing_hosting_paths[@]}"; do
+    if [[ -e "$install_entry_existing_path" || -L "$install_entry_existing_path" ]]; then
+      echo "Streamed VPS Hosting is only for a fresh host; existing Fased state was found." >&2
+      echo "Use the exact tagged repair or the installed updater instead of the mutable main bootstrap." >&2
+      exit 1
+    fi
+  done
+  PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
+  LANG="C.UTF-8"
+  LC_ALL="C.UTF-8"
+  export PATH LANG LC_ALL
+  unset -f curl gh jq tar sha256sum awk stat find grep flock install mv cp chown chmod sync 2>/dev/null || true
+  hash -r 2>/dev/null || true
 fi
 
-# A Hosting request always enters the attest-and-extract bootstrap unless it is
+# A Hosting file request enters the attest-and-extract bootstrap unless it is
 # the exact inner invocation carrying the root-owned verified bundle marker.
-# Streamed Hosting was rejected above; standalone Hosting must be downloaded
-# and verified before execution.
+# Streamed Hosting reaches this block only for the exact fresh --hosting
+# selector validated above. Repair and advanced Hosting selectors remain
+# exact-tag-only.
 if [[ "$install_entry_is_stream" -eq 1 || \
   ( "$install_entry_hosting" -eq 1 && -z "$install_entry_verified_bundle" ) ]]; then
   install_repo_url="${FASED_INSTALL_REPO:-https://github.com/fased-ai/fased.git}"
@@ -98,6 +143,10 @@ if [[ "$install_entry_is_stream" -eq 1 || \
     esac
   done
 
+  if [[ "$hosting_bootstrap" -eq 1 && "$hosting_repair_bootstrap" -eq 0 && -z "$hosting_release" ]]; then
+    hosting_release="latest"
+  fi
+
   bootstrap_as_root() {
     if [[ "$(id -u)" -eq 0 ]]; then
       "$@"
@@ -123,7 +172,7 @@ if [[ "$install_entry_is_stream" -eq 1 || \
       local source_tmp=""
       keyring_tmp="$(mktemp)"
       source_tmp="$(mktemp)"
-      curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg -o "$keyring_tmp"
+      curl -q -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg -o "$keyring_tmp"
       printf 'deb [arch=%s signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main\n' "$(dpkg --print-architecture)" >"$source_tmp"
       bootstrap_as_root install -d -m 0755 /etc/apt/keyrings
       bootstrap_as_root install -m 0644 "$keyring_tmp" /etc/apt/keyrings/githubcli-archive-keyring.gpg
@@ -157,7 +206,7 @@ if [[ "$install_entry_is_stream" -eq 1 || \
   }
 
   resolve_public_latest_release_tag() {
-    curl -fsSL --proto '=https' --tlsv1.2 \
+    curl -q -fsSL --proto '=https' --tlsv1.2 \
       -H 'Accept: application/vnd.github+json' \
       -H 'X-GitHub-Api-Version: 2022-11-28' \
       -H 'User-Agent: fased-installer' \
@@ -175,11 +224,10 @@ if [[ "$install_entry_is_stream" -eq 1 || \
       echo "Refusing a caller-supplied verified bundle marker." >&2
       exit 1
     fi
-    if [[ -z "$hosting_release" ]]; then
-      echo "VPS Hosting requires an explicit tagged release." >&2
-      echo "Pass --release vX.Y.Z (recommended) or --release latest." >&2
+    [[ -n "$hosting_release" ]] || {
+      echo "VPS Hosting release resolution failed before verification." >&2
       exit 1
-    fi
+    }
 
     install_hosting_bootstrap_tools() {
       [[ "$auto_install" -eq 1 ]] || return 0
@@ -225,22 +273,37 @@ if [[ "$install_entry_is_stream" -eq 1 || \
     fi
 
     local architecture=""
+    local signer_platform=""
     case "$(uname -m)" in
-      x86_64|amd64) architecture="x64" ;;
-      aarch64|arm64) architecture="arm64" ;;
+      x86_64|amd64)
+        architecture="x64"
+        signer_platform="linux-amd64"
+        ;;
+      aarch64|arm64)
+        architecture="arm64"
+        signer_platform="linux-arm64"
+        ;;
       *)
         echo "Unsupported Hosting architecture: $(uname -m)" >&2
         exit 1
         ;;
     esac
-    local asset="fased-hosted-app-linux-${architecture}-v${release_version}.tar.gz"
+    local asset="fased-hosted-app-v2-linux-${architecture}-v${release_version}.tar.gz"
     local release_url="https://github.com/fased-ai/fased/releases/download/v${release_version}"
     local release_parent="/var/lib/fased-installer/releases/v${release_version}"
     local staging="${release_parent}/.staging.$$"
     local preflight=""
     preflight="$(mktemp -d "${TMPDIR:-/tmp}/fased-hosting-bootstrap.XXXXXX")"
     local archive="${preflight}/${asset}"
+    local dependency_archive=""
+    local dependency_asset=""
+    local dependency_expected=""
+    local dependency_hash=""
+    local signer_binary=""
+    local signer_asset=""
+    local signer_expected=""
     local release_manifest="${preflight}/fased-hosted-release-v2.json"
+    local release_manifest_bundle="${preflight}/fased-hosted-release-v2.json.attestation.json"
     local expected=""
     local actual=""
     local manifest_digest=""
@@ -248,16 +311,43 @@ if [[ "$install_entry_is_stream" -eq 1 || \
     local manifest_signer_commit=""
 
     umask 077
-    trap 'rm -rf -- "${preflight:-}" "${staging:-}"' EXIT
-    curl -fL --proto '=https' --tlsv1.2 "$release_url/fased-hosted-release-v2.json" -o "$release_manifest"
+    hosting_bootstrap_cleanup() {
+      local status="$?"
+      rm -rf -- "${preflight:-}" "${staging:-}"
+      if [[ "$status" -ne 0 ]]; then
+        if [[ -e /var/lib/fased-installer || -L /var/lib/fased-installer ]]; then
+          echo "Hosting bootstrap stopped without activating Fased services." >&2
+          echo "Persistent installer state exists; retry only with the exact tagged, attested repair procedure." >&2
+        else
+          echo "Hosting bootstrap stopped before persistent Fased state was created; fix the reported problem and rerun the exact --hosting command." >&2
+        fi
+      fi
+      return "$status"
+    }
+    trap hosting_bootstrap_cleanup EXIT
+    curl -q -fL --proto '=https' --tlsv1.2 "$release_url/fased-hosted-release-v2.json" -o "$release_manifest"
+    curl -q -fL --proto '=https' --tlsv1.2 "$release_url/fased-hosted-release-v2.json.attestation.json" -o "$release_manifest_bundle"
     GH_PROMPT_DISABLED=1 gh attestation verify "$release_manifest" \
       --repo fased-ai/fased \
+      --bundle "$release_manifest_bundle" \
       --signer-workflow fased-ai/fased/.github/workflows/hosted-runtime-release.yml \
       --source-ref "refs/tags/v${release_version}" \
       --deny-self-hosted-runners >/dev/null
     local manifest_selection=""
-    manifest_selection="$(jq -er --arg version "$release_version" --arg architecture "$architecture" '
-      if .schemaVersion == 2 and
+    manifest_selection="$(jq -er --arg version "$release_version" --arg architecture "$architecture" --arg signer_platform "$signer_platform" '
+      if (keys == ["application", "release", "schemaVersion", "signer"]) and
+        .schemaVersion == 2 and
+        (.release | keys == ["commit", "tag", "version"]) and
+        (.application | keys == ["linux"]) and
+        (.application.linux | keys == ["arm64", "x64"]) and
+        (.application.linux[$architecture] | keys == ["artifact", "dependencies"]) and
+        (.application.linux[$architecture].artifact | keys == ["asset", "sha256"]) and
+        (.application.linux[$architecture].dependencies | keys == ["asset", "dependencyHash", "sha256"]) and
+        (.signer | keys == ["capabilities", "capabilitiesDigest", "platforms", "release"]) and
+        (.signer.release | keys == ["buildInputDigest", "commit", "development", "version"]) and
+        (.signer.platforms | keys == ["darwin-amd64", "darwin-arm64", "linux-amd64", "linux-arm64"]) and
+        (.signer.platforms[$signer_platform] | keys == ["asset", "sha256"]) and
+        (.signer.capabilitiesDigest | test("^sha256:[a-f0-9]{64}$")) and
         (.release.version == $version) and (.release.tag == ("v" + $version)) and
         (.release.commit | test("^[a-f0-9]{40}$")) and
         (.signer.release.version == $version) and
@@ -265,38 +355,107 @@ if [[ "$install_entry_is_stream" -eq 1 || \
         (.signer.release.development == false) and
         (.signer.release.buildInputDigest | test("^sha256:[a-f0-9]{64}$")) and
         (.application.linux[$architecture].artifact.asset | test("^[A-Za-z0-9][A-Za-z0-9._-]+$")) and
-        (.application.linux[$architecture].artifact.sha256 | test("^[a-f0-9]{64}$"))
+        (.application.linux[$architecture].artifact.sha256 | test("^[a-f0-9]{64}$")) and
+        (.application.linux[$architecture].dependencies.asset | test("^[A-Za-z0-9][A-Za-z0-9._-]+$")) and
+        (.application.linux[$architecture].dependencies.sha256 | test("^[a-f0-9]{64}$")) and
+        (.application.linux[$architecture].dependencies.dependencyHash | test("^[a-f0-9]{64}$")) and
+        (.signer.platforms[$signer_platform].asset | test("^[A-Za-z0-9][A-Za-z0-9._-]+$")) and
+        (.signer.platforms[$signer_platform].sha256 | test("^[a-f0-9]{64}$"))
       then [
         .release.commit,
         .signer.release.commit,
         .application.linux[$architecture].artifact.asset,
-        .application.linux[$architecture].artifact.sha256
+        .application.linux[$architecture].artifact.sha256,
+        .application.linux[$architecture].dependencies.asset,
+        .application.linux[$architecture].dependencies.sha256,
+        .application.linux[$architecture].dependencies.dependencyHash,
+        .signer.platforms[$signer_platform].asset,
+        .signer.platforms[$signer_platform].sha256
       ] | @tsv
       else error("invalid hosted release manifest") end
     ' "$release_manifest")" || {
       echo "Hosted release manifest does not bind this exact app and signer release." >&2
       exit 1
     }
-    IFS=$'\t' read -r manifest_commit manifest_signer_commit asset expected <<<"$manifest_selection"
-    [[ "$manifest_commit" == "$manifest_signer_commit" && "$asset" == "fased-hosted-app-linux-${architecture}-v${release_version}.tar.gz" ]] || {
+    IFS=$'\t' read -r manifest_commit manifest_signer_commit asset expected dependency_asset dependency_expected dependency_hash signer_asset signer_expected <<<"$manifest_selection"
+    [[ "$manifest_commit" == "$manifest_signer_commit" && \
+      "$asset" == "fased-hosted-app-v2-linux-${architecture}-v${release_version}.tar.gz" && \
+      "$dependency_asset" == "fased-hosted-deps-linux-${architecture}-${dependency_hash}.tar.gz" && \
+      "$signer_asset" == "fased-signerd-${signer_platform}" ]] || {
       echo "Hosted release manifest selects a mixed commit or unexpected app artifact." >&2
       exit 1
     }
     archive="${preflight}/${asset}"
-    curl -fL --proto '=https' --tlsv1.2 "$release_url/$asset" -o "$archive"
+    dependency_archive="${preflight}/${dependency_asset}"
+    signer_binary="${preflight}/${signer_asset}"
+    curl -q -fL --proto '=https' --tlsv1.2 "$release_url/$asset" -o "$archive"
+    curl -q -fL --proto '=https' --tlsv1.2 "$release_url/$dependency_asset" -o "$dependency_archive"
+    curl -q -fL --proto '=https' --tlsv1.2 "$release_url/$signer_asset" -o "$signer_binary"
     actual="$(sha256sum "$archive" | awk '{print tolower($1)}')"
+    local dependency_actual=""
+    local signer_actual=""
+    dependency_actual="$(sha256sum "$dependency_archive" | awk '{print tolower($1)}')"
+    signer_actual="$(sha256sum "$signer_binary" | awk '{print tolower($1)}')"
     manifest_digest="$(sha256sum "$release_manifest" | awk '{print tolower($1)}')"
-    if [[ ! "$expected" =~ ^[a-f0-9]{64}$ || "$actual" != "$expected" ]]; then
-      echo "Hosted release checksum verification failed." >&2
+    if [[ ! "$expected" =~ ^[a-f0-9]{64}$ || "$actual" != "$expected" || \
+      ! "$dependency_expected" =~ ^[a-f0-9]{64}$ || "$dependency_actual" != "$dependency_expected" || \
+      ! "$signer_expected" =~ ^[a-f0-9]{64}$ || "$signer_actual" != "$signer_expected" ]]; then
+      echo "Hosted app, dependency, or signer release checksum verification failed." >&2
       exit 1
     fi
-    GH_PROMPT_DISABLED=1 gh attestation verify "$archive" \
-      --repo fased-ai/fased \
-      --signer-workflow fased-ai/fased/.github/workflows/hosted-runtime-release.yml \
-      --source-ref "refs/tags/v${release_version}" \
-      --deny-self-hosted-runners >/dev/null
-    # Only after the exact unified manifest and selected app artifact are both
-    # attested and digest-bound may the bootstrap create persistent root state.
+    local entry=""
+    while IFS= read -r entry; do
+      entry="${entry%/}"
+      if [[ -z "$entry" || "$entry" == /* || "$entry" == *\\* || \
+        ( "$entry" != "package" && "$entry" != package/* ) || \
+        "$entry" == *"/../"* || "$entry" == ../* || "$entry" == */.. || \
+        "$entry" == *"/./"* || "$entry" == ./* || "$entry" == */. ]]; then
+        echo "Hosted app archive contains an unsafe path: $entry" >&2
+        exit 1
+      fi
+    done < <(tar -tzf "$archive")
+    while IFS= read -r entry; do
+      entry="${entry%/}"
+      if [[ -z "$entry" || "$entry" == /* || "$entry" == *\\* || \
+        ( "$entry" != "node_modules" && "$entry" != node_modules/* ) || \
+        "$entry" == *"/../"* || "$entry" == ../* || "$entry" == */.. || \
+        "$entry" == *"/./"* || "$entry" == ./* || "$entry" == */. ]]; then
+        echo "Hosted dependency archive contains an unsafe path: $entry" >&2
+        exit 1
+      fi
+    done < <(tar -tzf "$dependency_archive")
+
+    local verified_extract="$preflight/verified-app"
+    install -d -m 0700 "$verified_extract"
+    tar -xzf "$archive" -C "$verified_extract" --no-same-owner --no-same-permissions
+    local verified_package_root="$verified_extract/package"
+    [[ -f "$verified_package_root/install.sh" && -f "$verified_package_root/package.json" && \
+      ! -L "$verified_package_root/install.sh" && -f "$verified_package_root/dist/build-info.json" && \
+      ! -L "$verified_package_root/dist/build-info.json" ]] || {
+      echo "Attested Hosting bundle is incomplete or has an invalid entrypoint." >&2
+      exit 1
+    }
+    local packaged_version=""
+    local packaged_commit=""
+    local build_info_version=""
+    packaged_version="$(awk -F'"' '/^[[:space:]]*"version"[[:space:]]*:/ { print $4; exit }' "$verified_package_root/package.json")"
+    packaged_commit="$(awk -F'"' '/^[[:space:]]*"commit"[[:space:]]*:/ { print $4; exit }' "$verified_package_root/dist/build-info.json")"
+    build_info_version="$(awk -F'"' '/^[[:space:]]*"version"[[:space:]]*:/ { print $4; exit }' "$verified_package_root/dist/build-info.json")"
+    [[ "$packaged_version" == "$release_version" && "$build_info_version" == "$release_version" && \
+      "$packaged_commit" =~ ^[a-f0-9]{40}$ && "$packaged_commit" == "$manifest_commit" ]] || {
+      echo "Attested Hosting application identity does not match the unified release manifest." >&2
+      exit 1
+    }
+    if find "$verified_package_root" -xdev ! -type f ! -type d -print -quit | grep -q . || \
+      find "$verified_package_root" -xdev -type f -links +1 -print -quit | grep -q . || \
+      find "$verified_package_root" -xdev \( ! -user root -o -perm /022 \) -print -quit | grep -q .; then
+      echo "Attested Hosting bundle violates the file, link, ownership, or writable-mode policy." >&2
+      exit 1
+    fi
+
+    # Only after the exact unified manifest, app/dependency layers, signer
+    # binary, archive layout, and build identity are verified may the
+    # bootstrap create persistent Fased root state.
     install -d -m 0700 -o root -g root /var/lib/fased-installer /var/lib/fased-installer/releases "$release_parent"
     exec 9>/var/lib/fased-installer/install.lock
     chmod 0600 /var/lib/fased-installer/install.lock
@@ -335,52 +494,9 @@ if [[ "$install_entry_is_stream" -eq 1 || \
       exit 1
     fi
 
-    local entry=""
-    while IFS= read -r entry; do
-      entry="${entry%/}"
-      if [[ -z "$entry" || "$entry" == /* || "$entry" == *\\* || \
-        ( "$entry" != "package" && "$entry" != package/* ) || \
-        "$entry" == *"/../"* || "$entry" == ../* || "$entry" == */.. || \
-        "$entry" == *"/./"* || "$entry" == ./* || "$entry" == */. ]]; then
-        echo "Hosted release archive contains an unsafe path: $entry" >&2
-        exit 1
-      fi
-    done < <(tar -tzf "$archive")
-
     install -d -m 0700 -o root -g root "$staging/extract"
-    tar -xzf "$archive" -C "$staging/extract" --no-same-owner --no-same-permissions
+    cp -a "$verified_package_root" "$staging/extract/package"
     local package_root="$staging/extract/package"
-    [[ -f "$package_root/install.sh" && -f "$package_root/package.json" && ! -L "$package_root/install.sh" ]] || {
-      echo "Attested Hosting bundle is incomplete." >&2
-      exit 1
-    }
-    local packaged_version=""
-    packaged_version="$(awk -F'"' '/^[[:space:]]*"version"[[:space:]]*:/ { print $4; exit }' "$package_root/package.json")"
-    [[ "$packaged_version" == "$release_version" ]] || {
-      echo "Attested Hosting bundle version does not match v${release_version}." >&2
-      exit 1
-    }
-    [[ -f "$package_root/dist/build-info.json" && ! -L "$package_root/dist/build-info.json" ]] || {
-      echo "Attested Hosting bundle is missing immutable build identity." >&2
-      exit 1
-    }
-    local packaged_commit=""
-    local build_info_version=""
-    packaged_commit="$(awk -F'"' '/^[[:space:]]*"commit"[[:space:]]*:/ { print $4; exit }' "$package_root/dist/build-info.json")"
-    build_info_version="$(awk -F'"' '/^[[:space:]]*"version"[[:space:]]*:/ { print $4; exit }' "$package_root/dist/build-info.json")"
-    [[ "$packaged_commit" =~ ^[a-f0-9]{40}$ && "$build_info_version" == "$release_version" ]] || {
-      echo "Attested Hosting bundle build identity is invalid or does not match v${release_version}." >&2
-      exit 1
-    }
-    [[ "$packaged_commit" == "$manifest_commit" ]] || {
-      echo "Attested Hosting application commit does not match the unified release manifest." >&2
-      exit 1
-    }
-    if find "$package_root" -xdev ! -type f ! -type d -print -quit | grep -q . || \
-      find "$package_root" -xdev -type f -links +1 -print -quit | grep -q .; then
-      echo "Attested Hosting bundle contains a symlink, special file, or hardlinked regular file." >&2
-      exit 1
-    fi
     chown -R root:root "$staging"
     chmod -R go-w "$staging"
     if find "$staging" -xdev \( ! -user root -o -perm /022 \) -print -quit | grep -q .; then
@@ -3956,14 +4072,22 @@ EOF
 
 install_fixed_host_gateway_service() {
   local target_user="${FASED_INSTALL_USER:-app}"
+  local gateway_user="${FASED_GATEWAY_USER:-fased-gateway}"
+  local gateway_group="${FASED_GATEWAY_GROUP:-fased-gateway}"
+  local config_group="${FASED_CONFIG_GROUP:-fased-config}"
   local target_home
   target_home="$(getent passwd "$target_user" | cut -d: -f6)"
   [[ -n "$target_home" ]] || target_home="/home/$target_user"
   local target_repo_dir="${1:-$target_home/fased}"
-  [[ "$target_user" != "root" && "$target_user" =~ ^[A-Za-z0-9_.@-]+$ ]] || {
-    echo "Invalid hosted Gateway app account." >&2
+  [[ "$target_user" != "root" && "$target_user" != "$gateway_user" && "$target_user" =~ ^[A-Za-z0-9_.@-]+$ && "$gateway_user" =~ ^[A-Za-z0-9_.@-]+$ ]] || {
+    echo "Invalid or overlapping hosted operator and Gateway accounts." >&2
     exit 1
   }
+
+  install -d -m 2770 -o "$target_user" -g "$config_group" "${target_home}/.fased"
+  chgrp -R "$config_group" "${target_home}/.fased"
+  chmod -R g+rwX,o-rwx "${target_home}/.fased"
+  find "${target_home}/.fased" -type d -exec chmod g+s {} +
   [[ "$target_repo_dir" == "$target_home/"* && "$target_repo_dir" =~ ^/[A-Za-z0-9_./@-]+$ ]] || {
     echo "Hosted Gateway checkout must remain below the app account home." >&2
     exit 1
@@ -3981,8 +4105,9 @@ EOF
   chown root:root /usr/local/libexec/fased-gateway-launch
   chmod 0755 /usr/local/libexec/fased-gateway-launch
 
-  # The root-owned unit has fixed inputs. It may execute app-owned application code only as
-  # the app account; no app-supplied unit text or privileged lifecycle hook is accepted.
+  # The root-owned unit has fixed inputs. The non-login Gateway identity can read the
+  # operator-installed runtime and share application configuration through fased-config,
+  # but it is not a member of the restricted signer-operator socket group.
   cat >/etc/systemd/system/fased-gateway.service <<EOF
 [Unit]
 Description=Fased Gateway (managed)
@@ -3991,19 +4116,21 @@ Wants=fased-signerd.service network-online.target
 
 [Service]
 Type=simple
-User=${target_user}
-Group=${target_user}
+User=${gateway_user}
+Group=${gateway_group}
+SupplementaryGroups=${config_group}
 WorkingDirectory=${target_repo_dir}
 Environment=HOME=${target_home}
 Environment=FASED_GATEWAY_MODE=managed
 Environment=FASED_MANAGED_INTERNAL=1
+Environment=FASED_GATEWAY_SERVICE=1
 Environment=FASED_GATEWAY_PORT=18789
 Environment=FASED_HOST_PROFILE=hosting
 Environment=FASED_WALLET_LOCAL_SIGNER_SOCKET=/run/fased-signerd/app.sock
 ExecStart=/usr/local/libexec/fased-gateway-launch
 Restart=always
 RestartSec=5
-UMask=0077
+UMask=0007
 NoNewPrivileges=true
 PrivateTmp=true
 PrivateDevices=true
@@ -4214,8 +4341,15 @@ EOF
 
 ensure_host_boundary_accounts() {
   local target_user="${FASED_INSTALL_USER:-app}"
+  local gateway_user="${FASED_GATEWAY_USER:-fased-gateway}"
   local signer_user="${FASED_SIGNER_USER:-fased-signer}"
   local gateway_group="${FASED_GATEWAY_GROUP:-fased-gateway}"
+  local operator_group="${FASED_OPERATOR_GROUP:-fased-operator}"
+  local config_group="${FASED_CONFIG_GROUP:-fased-config}"
+  [[ "$target_user" != "$gateway_user" && "$target_user" != "$signer_user" && "$gateway_user" != "$signer_user" ]] || {
+    echo "Hosting operator, Gateway, and signer accounts must be distinct." >&2
+    exit 1
+  }
   if ! id -u "$target_user" >/dev/null 2>&1; then
     if need_cmd useradd; then
       useradd -m -s /bin/bash "$target_user"
@@ -4224,6 +4358,15 @@ ensure_host_boundary_accounts() {
     fi
   fi
   getent group "$gateway_group" >/dev/null 2>&1 || groupadd --system "$gateway_group"
+  getent group "$operator_group" >/dev/null 2>&1 || groupadd --system "$operator_group"
+  getent group "$config_group" >/dev/null 2>&1 || groupadd --system "$config_group"
+  if ! id -u "$gateway_user" >/dev/null 2>&1; then
+    if need_cmd useradd; then
+      useradd --system --gid "$gateway_group" --home-dir /var/lib/fased-gateway --shell /usr/sbin/nologin "$gateway_user"
+    else
+      adduser --system --ingroup "$gateway_group" --home /var/lib/fased-gateway --shell /usr/sbin/nologin "$gateway_user"
+    fi
+  fi
   if ! id -u "$signer_user" >/dev/null 2>&1; then
     if need_cmd useradd; then
       useradd --system --home-dir /var/lib/fased-signerd --shell /usr/sbin/nologin "$signer_user"
@@ -4231,8 +4374,13 @@ ensure_host_boundary_accounts() {
       adduser --system --home /var/lib/fased-signerd --shell /usr/sbin/nologin "$signer_user"
     fi
   fi
+  usermod -g "$gateway_group" -s /usr/sbin/nologin "$gateway_user"
+  passwd -l "$gateway_user" >/dev/null 2>&1 || true
   passwd -l "$signer_user" >/dev/null 2>&1 || true
-  usermod -aG "$gateway_group" "$target_user"
+  usermod -aG "$config_group" "$gateway_user"
+  usermod -aG "$operator_group,$config_group" "$target_user"
+  gpasswd -d "$target_user" "$gateway_group" >/dev/null 2>&1 || true
+  gpasswd -d "$gateway_user" "$operator_group" >/dev/null 2>&1 || true
   for admin_group in sudo wheel; do
     if getent group "$admin_group" >/dev/null 2>&1; then
       gpasswd -d "$target_user" "$admin_group" >/dev/null 2>&1 || true
@@ -4241,7 +4389,8 @@ ensure_host_boundary_accounts() {
   rm -f \
     "/etc/sudoers.d/fased-install-${target_user}" \
     "/etc/sudoers.d/fased-host-maintenance-${target_user}" \
-    "/etc/sudoers.d/fased-gateway-${target_user}-maintenance"
+    "/etc/sudoers.d/fased-gateway-${target_user}-maintenance" \
+    "/etc/sudoers.d/fased-signer-wallet-import-${target_user}"
   if need_cmd sudo && runuser -u "$target_user" -- sudo -n true >/dev/null 2>&1; then
     echo "Hosting security boundary cannot use an app account with passwordless sudo: $target_user" >&2
     echo "Remove custom sudoers access for this dedicated account, then rerun the exact tagged repair from the provider root console." >&2
@@ -4251,14 +4400,22 @@ ensure_host_boundary_accounts() {
 
 install_host_signer_and_updater_services() {
   local target_user="${FASED_INSTALL_USER:-app}"
+  local gateway_user="${FASED_GATEWAY_USER:-fased-gateway}"
   local signer_user="${FASED_SIGNER_USER:-fased-signer}"
   local gateway_group="${FASED_GATEWAY_GROUP:-fased-gateway}"
+  local operator_group="${FASED_OPERATOR_GROUP:-fased-operator}"
   local gateway_gid
+  local gateway_uid
+  local operator_uid
+  local signer_uid
   local version
   gateway_gid="$(getent group "$gateway_group" | cut -d: -f3)"
+  gateway_uid="$(id -u "$gateway_user")"
+  operator_uid="$(id -u "$target_user")"
+  signer_uid="$(id -u "$signer_user")"
   version="$(node -p "require(process.argv[1]).version" "$FASED_DIR/package.json" 2>/dev/null || true)"
-  [[ "$gateway_gid" =~ ^[0-9]+$ && "$version" =~ ^[0-9]+\.[0-9]+\.[0-9]+([.-][0-9A-Za-z.-]+)?$ ]] || {
-    echo "Could not resolve hosted signer group or release version." >&2
+  [[ "$gateway_gid" =~ ^[0-9]+$ && "$gateway_uid" =~ ^[0-9]+$ && "$operator_uid" =~ ^[0-9]+$ && "$signer_uid" =~ ^[0-9]+$ && "$version" =~ ^[0-9]+\.[0-9]+\.[0-9]+([.-][0-9A-Za-z.-]+)?$ ]] || {
+    echo "Could not resolve hosted signer principals, socket group, or release version." >&2
     exit 1
   }
   if [[ -n "${FASED_HOST_SIGNER_BINARY:-}" ]]; then
@@ -4266,6 +4423,19 @@ install_host_signer_and_updater_services() {
     echo "The root updater must fetch and attest the exact tagged signer artifact." >&2
     exit 1
   fi
+  local sat_runtime_value=""
+  if [[ -n "${FASED_SAT_PROGRAM_ID:-}${FASED_SAT_BOND_PROGRAM_ID:-}${FASED_SAT_MINT_ADDRESS:-}${FASED_SAT_MINT_PROGRAM_ID:-}" ]]; then
+    for sat_runtime_value in \
+      "${FASED_SAT_PROGRAM_ID:-}" \
+      "${FASED_SAT_BOND_PROGRAM_ID:-}" \
+      "${FASED_SAT_MINT_ADDRESS:-}" \
+      "${FASED_SAT_MINT_PROGRAM_ID:-}"; do
+      [[ "$sat_runtime_value" =~ ^[1-9A-HJ-NP-Za-km-z]{32,44}$ ]] || {
+        echo "Hosted signer SAT runtime requires one complete valid signed-manifest ID tuple." >&2
+        exit 1
+      }
+    done
+  fi
   local existing_signer_dropins
   existing_signer_dropins="$(systemctl show fased-signerd.service --property=DropInPaths --value 2>/dev/null || true)"
   if [[ -n "$existing_signer_dropins" ]]; then
@@ -4282,6 +4452,7 @@ install_host_signer_and_updater_services() {
   install -m 0755 -o root -g root "$FASED_DIR/scripts/fased-host-updater.mjs" /usr/local/libexec/fased-host-updater.mjs
   install -m 0755 -o root -g root "$FASED_DIR/scripts/fased-host-updaterctl.mjs" /usr/local/libexec/fased-host-updaterctl.mjs
   rm -f /usr/local/libexec/fased-host-bootstrapd.mjs /usr/local/libexec/fased-host-bootstrapctl.mjs
+  rm -f /usr/local/sbin/fased-signer-wallet-import
   rm -rf /run/fased-host-bootstrap
   rm -f /var/log/fased-host-bootstrap.log
   install -m 0755 -o root -g root "$FASED_DIR/scripts/migrate-hosted-signer-v2.mjs" /usr/local/libexec/migrate-hosted-signer-v2.mjs
@@ -4301,6 +4472,20 @@ install_host_signer_and_updater_services() {
   if [[ ! -f /etc/fased/signerd-webauthn.env ]]; then
     install -m 0644 -o root -g root /dev/null /etc/fased/signerd-webauthn.env
   fi
+  install -m 0644 -o root -g root /dev/null /etc/fased/signerd-sat-runtime.env
+  if [[ -n "${FASED_SAT_PROGRAM_ID:-}" ]]; then
+    cat >/etc/fased/signerd-sat-runtime.env <<EOF
+FASED_SAT_PROGRAM_ID=${FASED_SAT_PROGRAM_ID}
+FASED_SAT_BOND_PROGRAM_ID=${FASED_SAT_BOND_PROGRAM_ID}
+FASED_SAT_MINT_ADDRESS=${FASED_SAT_MINT_ADDRESS}
+FASED_SAT_MINT_PROGRAM_ID=${FASED_SAT_MINT_PROGRAM_ID}
+FASED_SAT_RUNTIME_MANIFEST_PATH=${FASED_SAT_RUNTIME_MANIFEST_PATH:-}
+FASED_SAT_RUNTIME_MANIFEST_SHA256=${FASED_SAT_RUNTIME_MANIFEST_SHA256:-}
+FASED_SAT_RUNTIME_MANIFEST_SIGNATURE_PATH=${FASED_SAT_RUNTIME_MANIFEST_SIGNATURE_PATH:-}
+EOF
+    chown root:root /etc/fased/signerd-sat-runtime.env
+    chmod 0644 /etc/fased/signerd-sat-runtime.env
+  fi
   install -d -m 0755 -o root -g root /etc/systemd/system/fased-gateway.service.d
   cat >/etc/systemd/system/fased-gateway.service.d/20-fased-update-gate.conf <<'EOF'
 [Unit]
@@ -4390,7 +4575,7 @@ Wants=network-online.target
 Type=simple
 User=${signer_user}
 Group=${signer_user}
-SupplementaryGroups=${gateway_group}
+SupplementaryGroups=${gateway_group} ${operator_group}
 RuntimeDirectory=fased-signerd
 RuntimeDirectoryMode=0755
 StateDirectory=fased-signerd
@@ -4398,7 +4583,8 @@ StateDirectoryMode=0700
 UMask=0077
 Environment=HOME=/var/lib/fased-signerd
 EnvironmentFile=-/etc/fased/signerd-webauthn.env
-ExecStart=/opt/fased/signer/fased-signerd -socket /run/fased-signerd/app.sock -control-socket /run/fased-signerd/control.sock -socket-mode 0660 -socket-group ${gateway_group} -state-db /var/lib/fased-signerd/state.db -master-key /var/lib/fased-signerd/master.key -update-gate /var/lib/fased-signer-update-gate/active -pid-file /run/fased-signerd/fased-signerd.pid -audit-log /var/lib/fased-signerd/audit.jsonl
+EnvironmentFile=-/etc/fased/signerd-sat-runtime.env
+ExecStart=/opt/fased/signer/fased-signerd -socket /run/fased-signerd/app.sock -operator-socket /run/fased-signerd/operator.sock -control-socket /run/fased-signerd/control.sock -socket-mode 0660 -socket-group ${gateway_group} -operator-socket-group ${operator_group} -application-uid ${gateway_uid} -operator-uid ${operator_uid} -control-uid ${signer_uid} -state-db /var/lib/fased-signerd/state.db -master-key /var/lib/fased-signerd/master.key -update-gate /var/lib/fased-signer-update-gate/active -pid-file /run/fased-signerd/fased-signerd.pid -audit-log /var/lib/fased-signerd/audit.jsonl
 Restart=always
 RestartSec=3
 NoNewPrivileges=true
@@ -4443,22 +4629,10 @@ EOF
   cat <<'EOF'
 Hosted signer owner handoff
 ---------------------------
-Fresh signer-owned wallets remain deny-all. Enrollment and policy activation are
-separate host-administrator actions; neither the Gateway nor the app account can run them.
-
-After onboarding creates a signer-owned wallet, use a root SSH/provider-console session:
-  1. Copy /usr/local/share/fased/signer-policies/network.json.template to a
-     root-owned mode-0600 file, set the exact RPC endpoints, then run:
-       /usr/local/sbin/fased-signer-network --wallet-id <native-id> --network-file /root/fased-network.json
-  2. /usr/local/sbin/fased-signer-enroll [authenticator-label]
-  3. cp /usr/local/share/fased/signer-policies/<role>.json.template /root/fased-<role>-policy.json
-  4. Set walletId to the canonical native signer ID (lowercase, separators become
-     underscores; do not use a different friendly registry ID), replace every
-     REPLACE_WITH_ value, review the exact destinations/caps, then run:
-       chmod 0600 /root/fased-<role>-policy.json
-       /usr/local/sbin/fased-signer-policy --initial-install --policy-file /root/fased-<role>-policy.json
-
-Copying a template or enrolling a passkey does not enable signing.
+Fresh wallets receive their versioned Agent, Mining, or Vault baseline from the
+native signer after the primary RPC is verified. Normal setup does not require a
+root policy or network helper. Optional approval-device enrollment and advanced
+custom policy changes remain separate owner operations.
 EOF
 }
 
@@ -4794,6 +4968,11 @@ if [[ -n "${FASED_SAT_PROGRAM_ID:-}" && -n "${FASED_SAT_BOND_PROGRAM_ID:-}" && -
   persist_managed_env_var "FASED_SAT_BOND_PROGRAM_ID" "$FASED_SAT_BOND_PROGRAM_ID"
   persist_managed_env_var "FASED_SAT_MINT_ADDRESS" "$FASED_SAT_MINT_ADDRESS"
   persist_managed_env_var "FASED_SAT_MINT_PROGRAM_ID" "$FASED_SAT_MINT_PROGRAM_ID"
+  if [[ -n "${FASED_SAT_RUNTIME_MANIFEST_PATH:-}" && -n "${FASED_SAT_RUNTIME_MANIFEST_SHA256:-}" && -n "${FASED_SAT_RUNTIME_MANIFEST_SIGNATURE_PATH:-}" ]]; then
+    persist_managed_env_var "FASED_SAT_RUNTIME_MANIFEST_PATH" "$FASED_SAT_RUNTIME_MANIFEST_PATH"
+    persist_managed_env_var "FASED_SAT_RUNTIME_MANIFEST_SHA256" "$FASED_SAT_RUNTIME_MANIFEST_SHA256"
+    persist_managed_env_var "FASED_SAT_RUNTIME_MANIFEST_SIGNATURE_PATH" "$FASED_SAT_RUNTIME_MANIFEST_SIGNATURE_PATH"
+  fi
 else
   :
 fi