#!/usr/bin/env node
/**
* Archipelago Mock Backend Server
* Pure Archipelago implementation - NO StartOS dependencies
* Supports dev modes: setup, onboarding, existing
*/
import express from 'express'
import cors from 'cors'
import cookieParser from 'cookie-parser'
import { WebSocketServer } from 'ws'
import http from 'http'
import { exec } from 'child_process'
import { promisify } from 'util'
import fs from 'fs/promises'
import path from 'path'
import { fileURLToPath } from 'url'
import Docker from 'dockerode'
const __filename = fileURLToPath(import.meta.url)
const __dirname = path.dirname(__filename)
const execPromise = promisify(exec)
// Find container socket: Podman (macOS/Linux) or Docker
import { existsSync } from 'fs'
function findContainerSocket() {
// DOCKER_HOST env var (set by podman machine start)
if (process.env.DOCKER_HOST) {
const p = process.env.DOCKER_HOST.replace('unix://', '')
if (existsSync(p)) return p
}
// Podman machine socket (macOS) â check TMPDIR-based path
if (process.env.TMPDIR) {
const podmanDir = path.join(path.dirname(process.env.TMPDIR), 'podman')
const sock = path.join(podmanDir, 'podman-machine-default-api.sock')
if (existsSync(sock)) return sock
}
// Docker socket
if (existsSync('/var/run/docker.sock')) return '/var/run/docker.sock'
// Linux podman rootless
const uid = process.getuid?.() || 1000
const linuxSock = `/run/user/${uid}/podman/podman.sock`
if (existsSync(linuxSock)) return linuxSock
return null
}
const containerSocket = findContainerSocket()
const docker = containerSocket ? new Docker({ socketPath: containerSocket }) : null
if (containerSocket) {
console.log(`[Container] Socket: ${containerSocket}`)
} else {
console.log('[Container] No socket found â simulation mode (no Docker/Podman)')
}
const app = express()
const PORT = 5959
// Dev mode from environment (setup, onboarding, existing, boot, or default)
const DEV_MODE = process.env.VITE_DEV_MODE || 'default'
// Boot mode: simulate server startup delay
let BOOT_START_TIME = Date.now()
const BOOT_DELAY_MS = 25000 // 25 seconds of simulated startup (slower for analysis)
// CORS configuration
const corsOptions = {
credentials: true,
origin: (origin, callback) => {
if (!origin) return callback(null, true)
callback(null, true)
}
}
app.use(cors(corsOptions))
// Skip JSON body parsing for filebrowser upload routes (binary file bodies)
app.use((req, res, next) => {
if (req.path.startsWith('/app/filebrowser/api/resources') && req.method === 'POST') {
return next()
}
express.json({ limit: '50mb' })(req, res, next)
})
app.use(cookieParser())
// Mock session storage
const sessions = new Map()
const MOCK_PASSWORD = 'password123'
// User state (simulated file-based storage)
let userState = {
setupComplete: false,
onboardingComplete: false,
passwordHash: null, // In real app, this would be bcrypt hash
}
// Initialize user state based on dev mode
function initializeUserState() {
switch (DEV_MODE) {
case 'setup':
// Setup mode: Original StartOS node setup - user needs to set password
// This is the simple password setup, NOT the experimental onboarding
userState = {
setupComplete: false, // User hasn't set password yet
onboardingComplete: false, // Onboarding not relevant for setup mode
passwordHash: null,
}
break
case 'onboarding':
// Onboarding mode: Experimental onboarding flow
// User has set password (via setup) but needs to go through experimental onboarding
userState = {
setupComplete: true, // Password already set
onboardingComplete: false, // Needs experimental onboarding
passwordHash: MOCK_PASSWORD,
}
break
case 'existing':
// Existing user: Fully set up, just needs to login
userState = {
setupComplete: true,
onboardingComplete: true,
passwordHash: MOCK_PASSWORD,
}
break
case 'boot':
// Boot mode: Simulate server startup delay (shows boot screen)
// Server responds with 502 for the first 10 seconds, then works like onboarding mode
userState = {
setupComplete: true,
onboardingComplete: false,
passwordHash: MOCK_PASSWORD,
}
break
default:
// Default: Fully set up (for UI development)
userState = {
setupComplete: true,
onboardingComplete: true,
passwordHash: MOCK_PASSWORD,
}
}
console.log(`[Auth] Dev mode: ${DEV_MODE}`)
console.log(`[Auth] Setup: ${userState.setupComplete}, Onboarding: ${userState.onboardingComplete}`)
}
initializeUserState()
// WebSocket clients for broadcasting updates
const wsClients = new Set()
// Helper: Broadcast data update to all WebSocket clients
function broadcastUpdate(patch) {
const message = JSON.stringify({
rev: Date.now(),
patch: patch
})
wsClients.forEach(client => {
if (client.readyState === 1) { // OPEN
client.send(message)
}
})
}
// Track used ports and running containers
const usedPorts = new Set([5959, 8100])
const runningContainers = new Map()
// Predefined port mappings for known apps
const portMappings = {
'atob': 8102,
'k484': 8103,
'amin': 8104,
'filebrowser': 8083,
'bitcoin-knots': 8332,
'electrs': 50001,
'btcpay-server': 23000,
'lnd': 8080,
'mempool': 4080,
'homeassistant': 8123,
'grafana': 3000,
'searxng': 8888,
'ollama': 11434,
'nextcloud': 8082,
'vaultwarden': 8222,
'jellyfin': 8096,
'photoprism': 2342,
'immich': 2283,
'portainer': 9443,
'uptime-kuma': 3001,
'tailscale': 41641,
'fedimint': 8175,
'thunderhub': 3010,
'nostr-rs-relay': 7000,
'syncthing': 8384,
'penpot': 9001,
'onlyoffice': 8044,
'nginx-proxy-manager': 8181,
'indeedhub': 8190,
'dwn': 3000,
'tor': 9050,
}
// Auto-assign port for unknown apps (start at 8200, increment)
let nextAutoPort = 8200
// Helper: Query real Docker containers
async function getDockerContainers() {
if (!docker) return {}
try {
const containers = await docker.listContainers({ all: true })
// Map of container names to app IDs
const containerMapping = {
'archy-bitcoin': 'bitcoin',
'archy-btcpay': 'btcpay-server',
'archy-homeassistant': 'homeassistant',
'archy-grafana': 'grafana',
'archy-endurain': 'endurain',
'archy-fedimint': 'fedimint',
'archy-morphos': 'morphos-server',
'archy-lnd': 'lightning-stack',
'archy-mempool-web': 'mempool',
'mempool-electrs': 'mempool-electrs',
'archy-ollama': 'ollama',
'archy-searxng': 'searxng',
'archy-onlyoffice': 'onlyoffice',
'archy-penpot-frontend': 'penpot'
}
const apps = {}
for (const container of containers) {
const name = container.Names[0].replace(/^\//, '')
const appId = containerMapping[name]
if (!appId) continue
const isRunning = container.State === 'running'
const ports = container.Ports || []
const hostPort = ports.find(p => p.PublicPort)?.PublicPort || null
// Get app metadata
const appMetadata = {
'bitcoin': {
title: 'Bitcoin Core',
icon: '/assets/img/app-icons/bitcoin.svg',
description: 'Full Bitcoin node implementation'
},
'btcpay-server': {
title: 'BTCPay Server',
icon: '/assets/img/app-icons/btcpay-server.png',
description: 'Self-hosted Bitcoin payment processor'
},
'homeassistant': {
title: 'Home Assistant',
icon: '/assets/img/app-icons/homeassistant.png',
description: 'Open source home automation platform'
},
'grafana': {
title: 'Grafana',
icon: '/assets/img/grafana.png',
description: 'Analytics and monitoring platform'
},
'endurain': {
title: 'Endurain',
icon: '/assets/img/endurain.png',
description: 'Application platform'
},
'fedimint': {
title: 'Fedimint',
icon: '/assets/img/app-icons/fedimint.png',
description: 'Federated Bitcoin mint'
},
'morphos-server': {
title: 'MorphOS Server',
icon: '/assets/img/morphos.png',
description: 'Server platform'
},
'lightning-stack': {
title: 'Lightning Stack',
icon: '/assets/img/app-icons/lightning-stack.png',
description: 'Lightning Network (LND)'
},
'mempool': {
title: 'Mempool',
icon: '/assets/img/app-icons/mempool.png',
description: 'Bitcoin blockchain explorer'
},
'mempool-electrs': {
title: 'Electrs',
icon: '/assets/img/app-icons/electrs.svg',
description: 'Electrum protocol indexer for Bitcoin'
},
'ollama': {
title: 'Ollama',
icon: '/assets/img/app-icons/ollama.png',
description: 'Run large language models locally'
},
'searxng': {
title: 'SearXNG',
icon: '/assets/img/app-icons/searxng.png',
description: 'Privacy-respecting metasearch engine'
},
'onlyoffice': {
title: 'OnlyOffice',
icon: '/assets/img/onlyoffice.webp',
description: 'Office suite and document collaboration'
},
'penpot': {
title: 'Penpot',
icon: '/assets/img/penpot.webp',
description: 'Open-source design and prototyping'
}
}
const metadata = appMetadata[appId] || {
title: appId,
icon: '/assets/icon/pwa-192x192-v2.png',
description: `${appId} application`
}
apps[appId] = {
title: metadata.title,
version: '1.0.0',
status: isRunning ? 'running' : 'stopped',
state: isRunning ? 'running' : 'stopped',
'static-files': {
license: 'MIT',
instructions: metadata.description,
icon: metadata.icon
},
manifest: {
id: appId,
title: metadata.title,
version: '1.0.0',
description: {
short: metadata.description,
long: metadata.description
},
'release-notes': 'Initial release',
license: 'MIT',
'wrapper-repo': '#',
'upstream-repo': '#',
'support-site': '#',
'marketing-site': '#',
'donation-url': null,
interfaces: hostPort ? {
main: {
name: 'Web Interface',
description: `${metadata.title} web interface`,
ui: true
}
} : {}
},
installed: {
'current-dependents': {},
'current-dependencies': {},
'last-backup': null,
'interface-addresses': hostPort ? {
main: {
'tor-address': `${appId}.onion`,
'lan-address': `http://localhost:${hostPort}`
}
} : {},
status: isRunning ? 'running' : 'stopped'
}
}
}
return apps
} catch (error) {
console.error('[Docker] Error querying containers:', error.message)
return {}
}
}
// Helper: Check if Docker/Podman is available
async function isContainerRuntimeAvailable() {
try {
// Try Podman first (Archipelago's choice)
await execPromise('podman ps')
return { available: true, runtime: 'podman' }
} catch {
try {
// Fallback to Docker
await execPromise('docker ps')
return { available: true, runtime: 'docker' }
} catch {
return { available: false, runtime: null }
}
}
}
// Marketplace metadata lookup for install (title, description, icon, version)
const marketplaceMetadata = {
'bitcoin-knots': { title: 'Bitcoin Knots', shortDesc: 'Full Bitcoin node â validate and relay blocks and transactions', icon: '/assets/img/app-icons/bitcoin-knots.webp' },
'electrs': { title: 'Electrs', shortDesc: 'Electrum protocol indexer for Bitcoin', icon: '/assets/img/app-icons/electrs.svg' },
'btcpay-server': { title: 'BTCPay Server', shortDesc: 'Self-hosted Bitcoin payment processor', icon: '/assets/img/app-icons/btcpay-server.png' },
'lnd': { title: 'LND', shortDesc: 'Lightning Network Daemon', icon: '/assets/img/app-icons/lnd.svg' },
'mempool': { title: 'Mempool Explorer', shortDesc: 'Bitcoin blockchain and mempool visualizer', icon: '/assets/img/app-icons/mempool.webp' },
'homeassistant': { title: 'Home Assistant', shortDesc: 'Open-source home automation platform', icon: '/assets/img/app-icons/homeassistant.png' },
'grafana': { title: 'Grafana', shortDesc: 'Analytics and monitoring dashboards', icon: '/assets/img/app-icons/grafana.png' },
'searxng': { title: 'SearXNG', shortDesc: 'Privacy-respecting metasearch engine', icon: '/assets/img/app-icons/searxng.png' },
'ollama': { title: 'Ollama', shortDesc: 'Run large language models locally', icon: '/assets/img/app-icons/ollama.png' },
'onlyoffice': { title: 'OnlyOffice', shortDesc: 'Office suite for document collaboration', icon: '/assets/img/app-icons/onlyoffice.webp' },
'penpot': { title: 'Penpot', shortDesc: 'Open-source design and prototyping platform', icon: '/assets/img/app-icons/penpot.webp' },
'nextcloud': { title: 'Nextcloud', shortDesc: 'Self-hosted cloud storage and collaboration', icon: '/assets/img/app-icons/nextcloud.webp' },
'vaultwarden': { title: 'Vaultwarden', shortDesc: 'Self-hosted password manager (Bitwarden-compatible)', icon: '/assets/img/app-icons/vaultwarden.webp' },
'jellyfin': { title: 'Jellyfin', shortDesc: 'Free media server for movies, music, and photos', icon: '/assets/img/app-icons/jellyfin.webp' },
'photoprism': { title: 'PhotoPrism', shortDesc: 'AI-powered photo management', icon: '/assets/img/app-icons/photoprism.svg' },
'immich': { title: 'Immich', shortDesc: 'High-performance photo and video backup', icon: '/assets/img/app-icons/immich.png' },
'filebrowser': { title: 'File Browser', shortDesc: 'Web-based file manager', icon: '/assets/img/app-icons/file-browser.webp' },
'nginx-proxy-manager': { title: 'Nginx Proxy Manager', shortDesc: 'Easy proxy management with SSL', icon: '/assets/img/app-icons/nginx.svg' },
'portainer': { title: 'Portainer', shortDesc: 'Container management UI', icon: '/assets/img/app-icons/portainer.webp' },
'uptime-kuma': { title: 'Uptime Kuma', shortDesc: 'Self-hosted monitoring tool', icon: '/assets/img/app-icons/uptime-kuma.webp' },
'tailscale': { title: 'Tailscale', shortDesc: 'Zero-config VPN for secure remote access', icon: '/assets/img/app-icons/tailscale.webp' },
'fedimint': { title: 'Fedimint', shortDesc: 'Federated Bitcoin mint with Guardian UI', icon: '/assets/img/app-icons/fedimint.png' },
'indeedhub': { title: 'Indeehub', shortDesc: 'Bitcoin documentary streaming platform', icon: '/assets/img/app-icons/indeedhub.png' },
'dwn': { title: 'Decentralized Web Node', shortDesc: 'Store and sync personal data with DID-based access', icon: '/assets/img/app-icons/dwn.svg' },
'nostr-rs-relay': { title: 'Nostr Relay', shortDesc: 'Run your own Nostr relay', icon: '/assets/img/app-icons/nostr-rs-relay.svg' },
'syncthing': { title: 'Syncthing', shortDesc: 'Peer-to-peer file synchronization', icon: '/assets/img/app-icons/syncthing.png' },
'thunderhub': { title: 'ThunderHub', shortDesc: 'Lightning node management UI with channel management and payments', icon: '/assets/img/app-icons/thunderhub.svg' },
'tor': { title: 'Tor', shortDesc: 'Anonymous communication over the Tor network', icon: '/assets/img/app-icons/tor.png' },
'amin': { title: 'Amin', shortDesc: 'Administrative interface for Archipelago', icon: '/assets/icon/pwa-192x192-v2.png' },
}
// Helper: Install package with container runtime (if available) or simulate
async function installPackage(id, manifestUrl, opts = {}) {
console.log(`[Package] đĻ Installing ${id}...`)
try {
// Check if already installed
if (mockData['package-data'][id]) {
throw new Error(`Package ${id} is already installed`)
}
const version = opts.version || '0.1.0'
const runtime = await isContainerRuntimeAvailable()
// Get package metadata from marketplace lookup, then fallback
const metadata = marketplaceMetadata[id] || {
title: id.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' '),
shortDesc: `${id} application`,
icon: `/assets/img/app-icons/${id}.png`
}
// Determine port â use known mapping, or auto-assign a unique one
let assignedPort = portMappings[id]
if (!assignedPort) {
while (usedPorts.has(nextAutoPort)) nextAutoPort++
assignedPort = nextAutoPort++
}
usedPorts.add(assignedPort)
let containerMode = false
let actuallyRunning = false
// Try to run with container runtime if available
if (runtime.available) {
try {
console.log(`[Package] đŗ ${runtime.runtime} available, attempting to run container...`)
const containerName = `${id}-archipelago`
const stopCmd = runtime.runtime === 'podman'
? `podman stop ${containerName} 2>/dev/null || true`
: `docker stop ${containerName} 2>/dev/null || true`
const rmCmd = runtime.runtime === 'podman'
? `podman rm ${containerName} 2>/dev/null || true`
: `docker rm ${containerName} 2>/dev/null || true`
// Stop and remove existing container if it exists
await execPromise(stopCmd)
await execPromise(rmCmd)
// Check if image exists
const imageCheckCmd = runtime.runtime === 'podman'
? `podman images -q ${id}:${version}`
: `docker images -q ${id}:${version}`
let { stdout } = await execPromise(imageCheckCmd)
if (stdout.trim()) {
// Image exists, start container
const runCmd = runtime.runtime === 'podman'
? `podman run -d --name ${containerName} -p ${assignedPort}:80 ${id}:${version}`
: `docker run -d --name ${containerName} -p ${assignedPort}:80 ${id}:${version}`
await execPromise(runCmd)
// Wait for container to be ready
await new Promise(resolve => setTimeout(resolve, 2000))
// Verify container is running
const statusCmd = runtime.runtime === 'podman'
? `podman ps --filter name=${containerName} --format "{{.Status}}"`
: `docker ps --filter name=${containerName} --format "{{.Status}}"`
const { stdout: containerStatus } = await execPromise(statusCmd)
if (containerStatus.includes('Up')) {
containerMode = true
actuallyRunning = true
runningContainers.set(id, {
port: assignedPort,
containerId: containerName,
runtime: runtime.runtime
})
console.log(`[Package] đŗ ${runtime.runtime} container running on port ${assignedPort}`)
}
} else {
console.log(`[Package] âšī¸ Container image ${id}:${version} not found, using simulation mode`)
}
} catch (containerError) {
console.log(`[Package] â ī¸ Container error (${containerError.message}), falling back to simulation`)
}
} else {
console.log(`[Package] âšī¸ Container runtime not available, using simulation mode`)
}
// If container didn't work, simulate installation
if (!containerMode) {
await new Promise(resolve => setTimeout(resolve, 1500))
runningContainers.set(id, { port: assignedPort, containerId: null, runtime: null })
}
// Add to mock data using staticApp format for consistency
mockData['package-data'][id] = {
...staticApp({
id,
title: metadata.title,
version,
shortDesc: metadata.shortDesc,
longDesc: metadata.shortDesc,
state: 'running',
lanPort: assignedPort,
icon: metadata.icon,
}),
port: assignedPort,
containerMode: containerMode,
actuallyRunning: actuallyRunning,
}
// Broadcast update
broadcastUpdate([
{
op: 'add',
path: `/package-data/${id}`,
value: mockData['package-data'][id]
}
])
if (containerMode) {
console.log(`[Package] â
${id} installed and RUNNING at http://localhost:${assignedPort}`)
} else {
console.log(`[Package] â
${id} installed (simulated)`)
}
return { success: true, port: assignedPort, containerMode }
} catch (error) {
console.error(`[Package] â Installation failed:`, error.message)
throw error
}
}
// Helper: Uninstall package
async function uninstallPackage(id) {
console.log(`[Package] đī¸ Uninstalling ${id}...`)
try {
if (staticDevApps[id]) {
throw new Error(`${id} is a demo app and cannot be uninstalled`)
}
if (!mockData['package-data'][id]) {
throw new Error(`Package ${id} is not installed`)
}
// Stop container if it's running
const containerInfo = runningContainers.get(id)
if (containerInfo && containerInfo.containerId) {
try {
const runtime = containerInfo.runtime || 'docker'
const stopCmd = runtime === 'podman'
? `podman stop ${containerInfo.containerId} 2>/dev/null || true`
: `docker stop ${containerInfo.containerId} 2>/dev/null || true`
const rmCmd = runtime === 'podman'
? `podman rm ${containerInfo.containerId} 2>/dev/null || true`
: `docker rm ${containerInfo.containerId} 2>/dev/null || true`
console.log(`[Package] đŗ Stopping container ${containerInfo.containerId}...`)
await execPromise(stopCmd)
await execPromise(rmCmd)
console.log(`[Package] đŗ Container stopped`)
} catch (error) {
console.log(`[Package] â ī¸ Error stopping container: ${error.message}`)
}
}
await new Promise(resolve => setTimeout(resolve, 1000))
const port = mockData['package-data'][id].port
if (port) {
usedPorts.delete(port)
}
runningContainers.delete(id)
delete mockData['package-data'][id]
broadcastUpdate([
{
op: 'remove',
path: `/package-data/${id}`
}
])
console.log(`[Package] â
${id} uninstalled successfully`)
return { success: true }
} catch (error) {
console.error(`[Package] â Uninstall failed:`, error.message)
throw error
}
}
// Mock data
const mockData = {
'server-info': {
id: 'archipelago-demo',
version: '0.1.0',
name: 'Archipelago',
pubkey: 'a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456',
'status-info': {
restarting: false,
'shutting-down': false,
updated: false,
'backup-progress': null,
'update-progress': null,
},
'lan-address': 'localhost',
'tor-address': 'archydemox7k3pnw4hv5qz2jcbr6dwefys3ockqzf4mzjlvxot2ioad.onion',
unread: 3,
'wifi-ssids': ['Home-5G', 'Archipelago-Mesh', 'Neighbors-Open'],
'zram-enabled': true,
},
'package-data': {}, // Will be populated from Docker + static apps
ui: {
name: 'Archipelago',
'ack-welcome': '0.1.0',
marketplace: {
'selected-hosts': [],
'known-hosts': {},
},
theme: 'dark',
},
}
// Helper to build a static app entry
function staticApp({ id, title, version, shortDesc, longDesc, license, state, lanPort, torHost, icon }) {
return {
title,
version,
status: state,
state,
'static-files': {
license: license || 'MIT',
instructions: shortDesc,
icon: icon || `/assets/img/app-icons/${id}.png`,
},
manifest: {
id,
title,
version,
description: { short: shortDesc, long: longDesc || shortDesc },
'release-notes': 'Latest stable release',
license: license || 'MIT',
'wrapper-repo': '#',
'upstream-repo': '#',
'support-site': '#',
'marketing-site': '#',
'donation-url': null,
interfaces: {
main: { name: 'Web Interface', description: `${title} web interface`, ui: true },
},
},
installed: {
'current-dependents': {},
'current-dependencies': {},
'last-backup': null,
'interface-addresses': {
main: {
'tor-address': torHost ? `${torHost}.onion` : `${id}.onion`,
'lan-address': lanPort ? `http://localhost:${lanPort}` : '',
},
},
status: state,
},
}
}
// Static dev apps (always shown in My Apps when using mock backend)
const staticDevApps = {
bitcoin: staticApp({
id: 'bitcoin',
title: 'Bitcoin Core',
version: '27.1',
shortDesc: 'Full Bitcoin node',
longDesc: 'Validate every transaction and block. Full consensus enforcement â the bedrock of sovereignty.',
state: 'running',
lanPort: 8332,
}),
lnd: staticApp({
id: 'lnd',
title: 'LND',
version: '0.18.3',
shortDesc: 'Lightning Network Daemon',
longDesc: 'Instant Bitcoin payments with near-zero fees. Open channels, route payments, earn sats.',
state: 'running',
lanPort: 8080,
}),
electrs: staticApp({
id: 'electrs',
title: 'Electrs',
version: '0.10.6',
shortDesc: 'Electrum Server in Rust',
longDesc: 'Private blockchain indexing for wallet lookups. Connect Sparrow, BlueWallet, or any Electrum-compatible wallet.',
state: 'running',
lanPort: 50001,
}),
mempool: staticApp({
id: 'mempool',
title: 'Mempool',
version: '3.0.0',
shortDesc: 'Blockchain explorer & fee estimator',
longDesc: 'Real-time mempool visualization, transaction tracking, and fee estimation â all on your own node.',
license: 'AGPL-3.0',
state: 'running',
lanPort: 4080,
}),
lorabell: staticApp({
id: 'lorabell',
title: 'LoraBell',
version: '1.0.0',
shortDesc: 'LoRa doorbell',
longDesc: 'Receive doorbell notifications over LoRa radio â no WiFi or internet required.',
state: 'running',
lanPort: null,
}),
filebrowser: staticApp({
id: 'filebrowser',
title: 'File Browser',
version: '2.27.0',
shortDesc: 'Web-based file manager',
longDesc: 'Browse, upload, and manage files through an elegant web interface. Drag-and-drop uploads, media previews, and sharing.',
state: 'running',
lanPort: 8083,
icon: '/assets/img/app-icons/file-browser.webp',
}),
thunderhub: staticApp({
id: 'thunderhub',
title: 'ThunderHub',
version: '0.13.31',
shortDesc: 'Lightning node management UI',
longDesc: 'Full Lightning node management â channels, payments, routing fees, and node health. Connect to your LND and manage everything from one dashboard.',
state: 'running',
lanPort: 3010,
}),
fedimint: staticApp({
id: 'fedimint',
title: 'Fedimint',
version: '0.10.0',
shortDesc: 'Federated Bitcoin mint',
longDesc: 'Federated Chaumian e-cash mint with Guardian UI. Community custody, private payments, and Lightning gateways.',
state: 'running',
lanPort: 8175,
}),
}
function mergePackageData(dockerApps) {
return { ...dockerApps, ...staticDevApps }
}
// Initialize package data from Docker on startup
async function initializePackageData() {
console.log('[Docker] Querying running containers...')
const dockerApps = await getDockerContainers()
mockData['package-data'] = mergePackageData(dockerApps)
const appCount = Object.keys(mockData['package-data']).length
const runningCount = Object.values(mockData['package-data']).filter(app => app.state === 'running').length
console.log(`[Docker] Found ${appCount} containers (${runningCount} running)`)
if (appCount > 0) {
console.log('[Docker] Apps detected:')
Object.entries(mockData['package-data']).forEach(([id, app]) => {
const port = app.installed?.['interface-addresses']?.main?.['lan-address']
console.log(` - ${app.title} (${app.state})${port ? ` â ${port}` : ''}`)
})
} else {
console.log('[Docker] No containers found. Start docker-compose to see apps.')
}
}
// Handle CORS preflight
app.options('/rpc/v1', (req, res) => {
res.status(200).end()
})
// RPC endpoint
app.post('/rpc/v1', (req, res) => {
const { method, params } = req.body
console.log(`[RPC] ${method}`)
// Boot mode: return 502 during simulated startup delay
if (DEV_MODE === 'boot') {
// Reset boot timer when browser does a fresh page load (server.echo with 'boot' message)
if (method === 'server.echo' && params?.message === 'boot-reset') {
BOOT_START_TIME = Date.now()
console.log(`[Boot] Timer RESET â simulating ${BOOT_DELAY_MS / 1000}s startup`)
return res.status(502).json({ error: 'Server starting up (reset)' })
}
const elapsed = Date.now() - BOOT_START_TIME
if (elapsed < BOOT_DELAY_MS) {
const secs = Math.round(elapsed / 1000)
const total = Math.round(BOOT_DELAY_MS / 1000)
console.log(`[Boot] Server starting... ${secs}s / ${total}s`)
return res.status(502).json({ error: 'Server starting up' })
}
if (elapsed < BOOT_DELAY_MS + 2000) {
console.log(`[Boot] Server is now READY (took ${Math.round(elapsed / 1000)}s)`)
}
}
try {
switch (method) {
// Authentication endpoints
case 'auth.setup': {
const { password } = params
if (!password || password.length < 8) {
return res.json({
error: {
code: -32602,
message: 'Password must be at least 8 characters',
},
})
}
// Set up user
userState.setupComplete = true
userState.passwordHash = password // In real app, bcrypt hash
console.log(`[Auth] User setup completed`)
return res.json({ result: { success: true } })
}
case 'auth.isSetup': {
return res.json({ result: userState.setupComplete })
}
case 'auth.onboardingComplete': {
userState.onboardingComplete = true
console.log(`[Auth] Onboarding completed`)
return res.json({ result: true })
}
case 'auth.isOnboardingComplete': {
return res.json({ result: userState.onboardingComplete })
}
case 'auth.resetOnboarding': {
userState.onboardingComplete = false
console.log('[Auth] Onboarding reset')
return res.json({ result: true })
}
case 'node.did': {
const mockDid = 'did:key:z6MkpTHR8VNsBxYAAWHut2Geadd9jSwuBV8xRoAnwWsdvktH'
const mockPubkey = 'a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456'
return res.json({ result: { did: mockDid, pubkey: mockPubkey } })
}
case 'node.nostr-publish': {
return res.json({ result: { event_id: 'mock-event-id', success: 2, failed: 0 } })
}
case 'node.nostr-pubkey': {
return res.json({ result: { nostr_pubkey: 'mock-nostr-pubkey-hex' } })
}
case 'node.signChallenge': {
const { challenge } = params || {}
const mockSig = Buffer.from(`mock-sig-${challenge || 'challenge'}`).toString('hex')
return res.json({ result: { signature: mockSig } })
}
case 'node.createBackup': {
const { passphrase } = params || {}
if (!passphrase) {
return res.json({ error: { code: -32602, message: 'Missing passphrase' } })
}
const mockDid = 'did:key:z6MkpTHR8VNsBxYAAWHut2Geadd9jSwuBV8xRoAnwWsdvktH'
const mockPubkey = 'a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456'
return res.json({
result: {
version: 1,
did: mockDid,
pubkey: mockPubkey,
kid: `${mockDid}#key-1`,
encrypted: true,
blob: Buffer.from(`mock-encrypted-backup-${passphrase}`).toString('base64'),
timestamp: new Date().toISOString(),
},
})
}
case 'auth.login': {
const { password } = params
if (!userState.setupComplete) {
return res.json({
error: {
code: -32603,
message: 'User not set up. Please complete setup first.',
},
})
}
// Simple password check (in real app, use bcrypt)
if (password !== userState.passwordHash && password !== MOCK_PASSWORD) {
return res.json({
error: {
code: -32603,
message: 'Password Incorrect',
},
})
}
const sessionId = `session-${Date.now()}`
sessions.set(sessionId, {
createdAt: new Date(),
})
res.cookie('session', sessionId, {
httpOnly: true,
maxAge: 24 * 60 * 60 * 1000,
})
return res.json({ result: null })
}
case 'auth.logout': {
const sessionId = req.cookies?.session
if (sessionId) {
sessions.delete(sessionId)
}
res.clearCookie('session')
return res.json({ result: null })
}
case 'server.set-name': {
const name = (params?.name || '').trim()
if (!name || name.length > 64) {
return res.json({ error: { code: -1, message: 'Name must be 1-64 characters' } })
}
mockData['server-info'].name = name
broadcastUpdate()
return res.json({ result: { name } })
}
case 'server.echo': {
return res.json({ result: { message: params?.message || 'Hello from Archipelago!' } })
}
case 'server.time': {
return res.json({
result: {
now: new Date().toISOString(),
uptime: process.uptime(),
},
})
}
case 'server.metrics': {
// Slightly randomize so the dashboard feels alive
return res.json({
result: {
cpu: +(12 + Math.random() * 18).toFixed(1),
memory: +(58 + Math.random() * 8).toFixed(1),
disk: +(34 + Math.random() * 3).toFixed(1),
},
})
}
case 'marketplace.get': {
const mockApps = [
{
id: 'bitcoin',
title: 'Bitcoin Core',
description: 'Full Bitcoin node â validate transactions, enforce consensus rules, and support the network. The foundation of sovereignty.',
version: '27.1',
icon: '/assets/img/app-icons/bitcoin.png',
author: 'Bitcoin Core',
license: 'MIT',
category: 'Bitcoin',
},
{
id: 'lnd',
title: 'LND',
description: 'Lightning Network Daemon â instant, low-fee Bitcoin payments. Open channels, route payments, earn routing fees.',
version: '0.18.3',
icon: '/assets/img/app-icons/lnd.png',
author: 'Lightning Labs',
license: 'MIT',
category: 'Bitcoin',
},
{
id: 'electrs',
title: 'Electrs',
description: 'Electrum Server in Rust â index the blockchain for fast wallet lookups. Connect your hardware wallets privately.',
version: '0.10.6',
icon: '/assets/img/app-icons/electrs.png',
author: 'Roman Zeyde',
license: 'MIT',
category: 'Bitcoin',
},
{
id: 'mempool',
title: 'Mempool',
description: 'Bitcoin blockchain explorer and mempool visualizer. Monitor transactions, fees, and network activity in real time.',
version: '3.0.0',
icon: '/assets/img/app-icons/mempool.png',
author: 'Mempool Space',
license: 'AGPL-3.0',
category: 'Bitcoin',
},
{
id: 'btcpay',
title: 'BTCPay Server',
description: 'Self-hosted Bitcoin payment processor. Accept Bitcoin payments in your store â no fees, no middlemen, no KYC.',
version: '2.0.4',
icon: '/assets/img/app-icons/btcpay.png',
author: 'BTCPay Server',
license: 'MIT',
category: 'Commerce',
},
{
id: 'fedimint',
title: 'Fedimint',
description: 'Federated Chaumian e-cash mint â community custody, private payments, and Lightning gateways for your tribe.',
version: '0.10.0',
icon: '/assets/img/app-icons/fedimint.png',
author: 'Fedimint',
license: 'MIT',
category: 'Bitcoin',
},
{
id: 'thunderhub',
title: 'ThunderHub',
description: 'Lightning node management UI â manage channels, send and receive payments, view routing fees, and monitor your node health.',
version: '0.13.31',
icon: '/assets/img/app-icons/thunderhub.svg',
author: 'Anthony Potdevin',
license: 'MIT',
category: 'Bitcoin',
},
{
id: 'vaultwarden',
title: 'Vaultwarden',
description: 'Self-hosted password manager compatible with Bitwarden clients. Keep your credentials under your own roof.',
version: '1.32.5',
icon: '/assets/img/app-icons/vaultwarden.png',
author: 'Vaultwarden',
license: 'AGPL-3.0',
category: 'Privacy',
},
{
id: 'nextcloud',
title: 'Nextcloud',
description: 'Your personal cloud â files, calendar, contacts, and collaboration. Replace Google Drive and Dropbox entirely.',
version: '29.0.0',
icon: '/assets/img/app-icons/nextcloud.png',
author: 'Nextcloud GmbH',
license: 'AGPL-3.0',
category: 'Cloud',
},
{
id: 'nostr-relay',
title: 'Nostr Relay',
description: 'Run your own Nostr relay â sovereign social networking. Publish notes, follow friends, no censorship possible.',
version: '0.34.0',
icon: '/assets/img/app-icons/nostr-relay.png',
author: 'nostr-rs-relay',
license: 'MIT',
category: 'Social',
},
{
id: 'home-assistant',
title: 'Home Assistant',
description: 'Open-source home automation â control lights, locks, cameras, and sensors. Smart home without the cloud dependency.',
version: '2024.12.0',
icon: '/assets/img/app-icons/home-assistant.png',
author: 'Home Assistant',
license: 'Apache-2.0',
category: 'IoT',
},
{
id: 'syncthing',
title: 'Syncthing',
description: 'Continuous peer-to-peer file synchronization. Sync folders across devices without any cloud service.',
version: '1.28.1',
icon: '/assets/img/app-icons/syncthing.png',
author: 'Syncthing Foundation',
license: 'MPL-2.0',
category: 'Cloud',
},
{
id: 'tor',
title: 'Tor',
description: 'Anonymous communication â route traffic through the Tor network. Access your node from anywhere, privately.',
version: '0.4.8.13',
icon: '/assets/img/app-icons/tor.png',
author: 'Tor Project',
license: 'BSD-3',
category: 'Privacy',
},
]
return res.json({ result: mockApps })
}
case 'server.update':
case 'server.restart':
case 'server.shutdown': {
return res.json({ result: 'ok' })
}
case 'package.install': {
const { id, url, dockerImage, version } = params
installPackage(id, url, { dockerImage, version }).catch(err => {
console.error(`[RPC] Installation failed:`, err.message)
})
return res.json({ result: `job-${Date.now()}` })
}
case 'package.uninstall': {
const { id } = params
uninstallPackage(id).catch(err => {
console.error(`[RPC] Uninstall failed:`, err.message)
})
return res.json({ result: 'ok' })
}
case 'package.start':
case 'package.stop':
case 'package.restart': {
return res.json({ result: 'ok' })
}
case 'auth.totp.status': {
return res.json({ result: { enabled: false } })
}
case 'auth.totp.setup.begin': {
return res.json({
result: {
qr_svg: '',
secret_base32: 'JBSWY3DPEHPK3PXP',
pending_token: 'mock-pending-token',
},
})
}
case 'auth.totp.setup.confirm': {
return res.json({
result: {
enabled: true,
backup_codes: ['ABCD-EFGH', 'JKLM-NPQR', 'STUV-WXYZ', '2345-6789', 'ABCD-2345', 'EFGH-6789', 'JKLM-STUV', 'NPQR-WXYZ'],
},
})
}
case 'auth.totp.disable': {
return res.json({ result: { disabled: true } })
}
case 'auth.login.totp':
case 'auth.login.backup': {
return res.json({ result: { success: true } })
}
// =========================================================================
// Identity & Onboarding
// =========================================================================
case 'identity.create': {
const { name, purpose } = params || {}
console.log(`[Identity] Created identity: "${name || 'Personal'}" (${purpose || 'personal'})`)
return res.json({ result: { success: true, id: `identity-${Date.now()}` } })
}
case 'identity.register-name': {
const { name } = params || {}
console.log(`[Identity] Registered name: ${name}`)
return res.json({ result: { success: true, id: `name-${Date.now()}` } })
}
case 'identity.remove-name': {
return res.json({ result: { success: true } })
}
case 'identity.set-default': {
return res.json({ result: { success: true } })
}
case 'identity.delete': {
return res.json({ result: { success: true } })
}
case 'identity.issue-credential': {
return res.json({ result: { success: true, credential_id: `cred-${Date.now()}` } })
}
case 'identity.revoke-credential': {
return res.json({ result: { success: true } })
}
// =========================================================================
// Nostr
// =========================================================================
case 'nostr.add-relay': {
const { url } = params || {}
console.log(`[Nostr] Added relay: ${url}`)
return res.json({ result: { success: true } })
}
case 'nostr.remove-relay': {
return res.json({ result: { success: true } })
}
case 'nostr.toggle-relay': {
return res.json({ result: { success: true } })
}
// =========================================================================
// Content & Network
// =========================================================================
case 'content.remove': {
return res.json({ result: { success: true } })
}
case 'content.set-pricing': {
return res.json({ result: { success: true } })
}
case 'network.accept-request': {
return res.json({ result: { success: true } })
}
case 'network.reject-request': {
return res.json({ result: { success: true } })
}
// =========================================================================
// Server & Auth extras
// =========================================================================
case 'server.health': {
return res.json({
result: {
status: 'healthy',
uptime: Math.floor(process.uptime()),
services: {
backend: 'running',
nginx: 'running',
podman: 'running',
tor: 'running',
},
},
})
}
case 'auth.changePassword': {
const { currentPassword } = params || {}
if (currentPassword !== userState.passwordHash && currentPassword !== MOCK_PASSWORD) {
return res.json({ error: { code: -32603, message: 'Current password is incorrect' } })
}
userState.passwordHash = params.newPassword
console.log('[Auth] Password changed')
return res.json({ result: { success: true } })
}
// =========================================================================
// Router (port forwarding)
// =========================================================================
case 'router.add-forward': {
console.log(`[Router] Added forward: ${JSON.stringify(params)}`)
return res.json({ result: { success: true, id: `fwd-${Date.now()}` } })
}
case 'router.remove-forward': {
return res.json({ result: { success: true } })
}
// =========================================================================
// Tor & Peer Networking
// =========================================================================
case 'node.tor-address': {
return res.json({
result: {
tor_address: 'archydemox7k3pnw4hv5qz2jcbr6dwefys3ockqzf4mzjlvxot2ioad.onion',
},
})
}
case 'node-list-peers': {
return res.json({
result: {
peers: [
{ onion: 'peer1abc2def3ghi4jkl5mno6pqr7stu8vwx9yz.onion', pubkey: 'a1b2c3d4e5f6', name: 'satoshi-node' },
{ onion: 'peer2xyz9wvu8tsr7qpo6nml5kji4hgf3edc2ba.onion', pubkey: 'f6e5d4c3b2a1', name: 'lightning-lab' },
{ onion: 'peer3mno6pqr7stu8vwx9yzabc2def3ghi4jkl5.onion', pubkey: 'c3d4e5f6a1b2', name: 'sovereign-relay' },
],
},
})
}
case 'node-check-peer': {
return res.json({ result: { onion: params?.onion || '', reachable: Math.random() > 0.2 } })
}
case 'node-add-peer': {
console.log(`[Peers] Added peer: ${params?.onion}`)
return res.json({ result: { success: true } })
}
case 'node-send-message': {
console.log(`[Peers] Sent message to: ${params?.onion}`)
return res.json({ result: { ok: true, sent_to: params?.onion || '' } })
}
case 'node-nostr-discover': {
return res.json({
result: {
nodes: [
{ did: 'did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2ReMkBe4bR6XBIDNq9', onion: 'disc1abc2def3ghi4jkl5mno6pqr7stu8vwx9yz.onion', pubkey: 'disc1pub', node_address: '192.168.1.50' },
{ did: 'did:key:z6MkpTHR8VNsBxYAAWHut2Geadd9jSwuBV8xRoAnwWsdvktH', onion: 'disc2xyz9wvu8tsr7qpo6nml5kji4hgf3edc2ba.onion', pubkey: 'disc2pub', node_address: '192.168.1.51' },
],
},
})
}
case 'node-messages-received':
case 'node.messages': {
return res.json({
result: {
messages: [
{ from_pubkey: 'a1b2c3d4e5f6', message: 'Hey, your relay is online! Nice uptime.', timestamp: new Date(Date.now() - 3600000).toISOString() },
{ from_pubkey: 'f6e5d4c3b2a1', message: 'Channel opened successfully. 500k sats capacity.', timestamp: new Date(Date.now() - 7200000).toISOString() },
{ from_pubkey: 'c3d4e5f6a1b2', message: 'Backup sync complete. All good on my end.', timestamp: new Date(Date.now() - 86400000).toISOString() },
],
},
})
}
case 'node.notifications': {
return res.json({
result: [
{
id: 'notif-1',
type: 'info',
title: 'Bitcoin Core synced',
message: 'Blockchain fully synced at block 892,451. IBD complete.',
timestamp: new Date(Date.now() - 1800000).toISOString(),
read: false,
},
{
id: 'notif-2',
type: 'success',
title: 'LND channel opened',
message: 'Channel opened with ACINQ (500,000 sats capacity). 6 confirmations received.',
timestamp: new Date(Date.now() - 7200000).toISOString(),
read: false,
},
{
id: 'notif-3',
type: 'warning',
title: 'Disk usage above 80%',
message: 'Storage at 82% capacity. Consider pruning old blockchain data or expanding storage.',
timestamp: new Date(Date.now() - 14400000).toISOString(),
read: true,
},
{
id: 'notif-4',
type: 'info',
title: 'System update available',
message: 'Archipelago v0.1.1 is available. Review changelog before updating.',
timestamp: new Date(Date.now() - 86400000).toISOString(),
read: true,
},
{
id: 'notif-5',
type: 'success',
title: 'Fedimint guardian connected',
message: 'Guardian consensus achieved. Mint is operational with 3/4 guardians online.',
timestamp: new Date(Date.now() - 43200000).toISOString(),
read: false,
},
],
})
}
// =====================================================================
// Federation (multi-node clusters)
// =====================================================================
case 'federation.list-nodes': {
return res.json({
result: {
nodes: [
{
did: 'did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2ReMkBe4bR6XBIDNq9',
pubkey: 'a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2',
onion: 'peer1abc2def3ghi4jkl5mno6pqr7stu8vwx9yz.onion',
trust_level: 'trusted',
added_at: '2026-02-15T10:30:00Z',
name: 'archy-198',
last_seen: new Date(Date.now() - 120000).toISOString(),
last_state: {
timestamp: new Date(Date.now() - 120000).toISOString(),
apps: [
{ id: 'bitcoin-knots', status: 'running', version: '27.1' },
{ id: 'lnd', status: 'running', version: '0.18.0' },
{ id: 'mempool', status: 'running', version: '3.0' },
{ id: 'electrs', status: 'running', version: '0.10.0' },
],
cpu_usage_percent: 18.3,
mem_used_bytes: 6_200_000_000,
mem_total_bytes: 16_000_000_000,
disk_used_bytes: 820_000_000_000,
disk_total_bytes: 1_800_000_000_000,
uptime_secs: 604800,
tor_active: true,
},
},
{
did: 'did:key:z6MkpTHR8VNsBxYAAWHut2Geadd9jSwuBV8xRoAnwWsdvktH',
pubkey: 'f6e5d4c3b2a1f6e5d4c3b2a1f6e5d4c3b2a1f6e5d4c3b2a1f6e5d4c3b2a1f6e5',
onion: 'peer2xyz9wvu8tsr7qpo6nml5kji4hgf3edc2ba.onion',
trust_level: 'trusted',
added_at: '2026-03-01T14:00:00Z',
name: 'arch-tailscale-1',
last_seen: new Date(Date.now() - 300000).toISOString(),
last_state: {
timestamp: new Date(Date.now() - 300000).toISOString(),
apps: [
{ id: 'bitcoin-knots', status: 'running', version: '27.1' },
{ id: 'lnd', status: 'running', version: '0.18.0' },
{ id: 'nextcloud', status: 'running', version: '29.0' },
],
cpu_usage_percent: 42.1,
mem_used_bytes: 10_500_000_000,
mem_total_bytes: 32_000_000_000,
disk_used_bytes: 1_200_000_000_000,
disk_total_bytes: 2_000_000_000_000,
uptime_secs: 259200,
tor_active: true,
},
},
{
did: 'did:key:z6MkrHKPxJP6tvCvXMaJKZd3rRA2Y44tyftVhR8FDCMKGFjb',
pubkey: 'c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4',
onion: 'peer3mno6pqr7stu8vwx9yzabc2def3ghi4jkl5.onion',
trust_level: 'observer',
added_at: '2026-03-10T09:15:00Z',
name: 'bunker-alpha',
last_seen: new Date(Date.now() - 3600000).toISOString(),
last_state: {
timestamp: new Date(Date.now() - 3600000).toISOString(),
apps: [
{ id: 'bitcoin-knots', status: 'running', version: '27.1' },
{ id: 'vaultwarden', status: 'running', version: '1.31.0' },
],
cpu_usage_percent: 5.8,
mem_used_bytes: 2_100_000_000,
mem_total_bytes: 8_000_000_000,
disk_used_bytes: 450_000_000_000,
disk_total_bytes: 1_000_000_000_000,
uptime_secs: 1209600,
tor_active: false,
},
},
],
},
})
}
case 'federation.invite': {
const mockCode = 'fed1:' + Buffer.from(JSON.stringify({
did: 'did:key:z6MkTest228NodeInvite',
onion: 'self228abc2def3ghi4jkl5mno6pqr7stu8vwx.onion',
pubkey: 'aabbccdd',
token: 'mock-invite-token-' + Date.now(),
})).toString('base64url')
return res.json({
result: {
code: mockCode,
did: 'did:key:z6MkTest228NodeInvite',
onion: 'self228abc2def3ghi4jkl5mno6pqr7stu8vwx.onion',
},
})
}
case 'federation.join': {
console.log(`[Federation] Joining with code: ${params?.code?.substring(0, 20)}...`)
return res.json({
result: {
joined: true,
node: {
did: 'did:key:z6MkNewJoinedNode',
onion: 'newnode123abc456def789ghi012jkl345mno6pqr.onion',
pubkey: 'ddeeff11',
trust_level: 'trusted',
},
},
})
}
case 'federation.sync-state': {
return res.json({
result: {
synced: 3,
failed: 0,
results: [
{ did: 'did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2ReMkBe4bR6XBIDNq9', status: 'synced', apps: 4 },
{ did: 'did:key:z6MkpTHR8VNsBxYAAWHut2Geadd9jSwuBV8xRoAnwWsdvktH', status: 'synced', apps: 3 },
{ did: 'did:key:z6MkrHKPxJP6tvCvXMaJKZd3rRA2Y44tyftVhR8FDCMKGFjb', status: 'synced', apps: 2 },
],
},
})
}
case 'federation.set-trust': {
console.log(`[Federation] Set trust: ${params?.did} -> ${params?.trust_level}`)
return res.json({ result: { updated: true, did: params?.did, trust_level: params?.trust_level } })
}
case 'federation.remove-node': {
console.log(`[Federation] Remove node: ${params?.did}`)
return res.json({ result: { removed: true, nodes_remaining: 2 } })
}
case 'federation.deploy-app': {
console.log(`[Federation] Deploy app: ${params?.app_id} to ${params?.target_did}`)
return res.json({ result: { deployed: true, app_id: params?.app_id } })
}
// =====================================================================
// DWN (Decentralized Web Node)
// =====================================================================
case 'dwn.status': {
return res.json({
result: {
running: true,
protocols_registered: 3,
messages_stored: 47,
peers_synced: 2,
last_sync: new Date(Date.now() - 600000).toISOString(),
protocols: [
{ uri: 'https://archipelago.dev/protocols/node-identity/v1', published: true, messages: 12 },
{ uri: 'https://archipelago.dev/protocols/federation/v1', published: false, messages: 28 },
{ uri: 'https://archipelago.dev/protocols/app-deploy/v1', published: false, messages: 7 },
],
},
})
}
case 'dwn.sync': {
console.log('[DWN] Syncing with peers...')
return res.json({ result: { synced: true, messages_pulled: 5, messages_pushed: 3 } })
}
// =====================================================================
// Mesh Networking (LoRa radio via Meshcore)
// =====================================================================
case 'mesh.status': {
return res.json({
result: {
enabled: true,
device_type: 'Meshcore',
device_path: '/dev/ttyUSB0',
device_connected: true,
firmware_version: '2.3.1',
self_node_id: 42,
self_advert_name: 'archy-228',
peer_count: 4,
channel_name: 'archipelago',
messages_sent: 23,
messages_received: 47,
detected_devices: ['/dev/ttyUSB0'],
},
})
}
case 'mesh.peers': {
return res.json({
result: {
peers: [
{
contact_id: 1,
advert_name: 'archy-198',
did: 'did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2ReMkBe4bR6XBIDNq9',
pubkey_hex: 'a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2',
rssi: -67,
snr: 9.5,
last_heard: new Date(Date.now() - 30000).toISOString(),
hops: 0,
},
{
contact_id: 2,
advert_name: 'satoshi-relay',
did: 'did:key:z6MkpTHR8VNsBxYAAWHut2Geadd9jSwuBV8xRoAnwWsdvktH',
pubkey_hex: 'f6e5d4c3b2a1f6e5d4c3b2a1f6e5d4c3b2a1f6e5d4c3b2a1f6e5d4c3b2a1f6e5',
rssi: -82,
snr: 4.2,
last_heard: new Date(Date.now() - 120000).toISOString(),
hops: 1,
},
{
contact_id: 3,
advert_name: 'mountain-node',
did: null,
pubkey_hex: null,
rssi: -95,
snr: 1.8,
last_heard: new Date(Date.now() - 600000).toISOString(),
hops: 2,
},
{
contact_id: 4,
advert_name: 'bunker-alpha',
did: 'did:key:z6MkrHKPxJP6tvCvXMaJKZd3rRA2Y44tyftVhR8FDCMKGFjb',
pubkey_hex: 'c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4',
rssi: -74,
snr: 7.1,
last_heard: new Date(Date.now() - 45000).toISOString(),
hops: 0,
},
],
count: 4,
},
})
}
case 'mesh.messages': {
const limit = params?.limit || 100
const now = Date.now()
const allMessages = [
{ id: 1, direction: 'received', peer_contact_id: 1, peer_name: 'archy-198', plaintext: 'Node online. Bitcoin Knots synced to tip.', timestamp: new Date(now - 3600000).toISOString(), delivered: true, encrypted: true, message_type: 'text' },
{ id: 2, direction: 'sent', peer_contact_id: 1, peer_name: 'archy-198', plaintext: 'Good. Electrs index at 98%. Channel capacity 2.5M sats.', timestamp: new Date(now - 3540000).toISOString(), delivered: true, encrypted: true, message_type: 'text' },
{ id: 3, direction: 'received', peer_contact_id: 2, peer_name: 'satoshi-relay', plaintext: 'Block #890,413 relayed. Fees avg 12 sat/vB.', timestamp: new Date(now - 3000000).toISOString(), delivered: true, encrypted: true, message_type: 'block_header', typed_payload: { alert_type: 'block_header', message: 'Block #890,413 â 2,847 txs, 12 sat/vB avg fee', signed: true } },
{ id: 4, direction: 'received', peer_contact_id: 1, peer_name: 'archy-198', plaintext: 'Invoice: 50,000 sats â Channel opening fee', timestamp: new Date(now - 1800000).toISOString(), delivered: true, encrypted: true, message_type: 'invoice', typed_payload: { bolt11: 'lnbc500000n1pjmesh...truncated...', amount_sats: 50000, memo: 'Channel opening fee', paid: false } },
{ id: 5, direction: 'sent', peer_contact_id: 4, peer_name: 'bunker-alpha', plaintext: 'Running mesh-only mode. No internet for 48h. All good.', timestamp: new Date(now - 900000).toISOString(), delivered: true, encrypted: true, message_type: 'text' },
{ id: 6, direction: 'received', peer_contact_id: 4, peer_name: 'bunker-alpha', plaintext: 'Copy. Block height 890,412 via compact headers.', timestamp: new Date(now - 840000).toISOString(), delivered: true, encrypted: true, message_type: 'text' },
{ id: 7, direction: 'received', peer_contact_id: 3, peer_name: 'mountain-node', plaintext: 'EMERGENCY: Solar array failure. Running on battery reserve.', timestamp: new Date(now - 600000).toISOString(), delivered: true, encrypted: false, message_type: 'alert', typed_payload: { alert_type: 'emergency', message: 'Solar array failure. Running on battery reserve. ETA 4h before shutdown.', coordinate: { lat: 39507400, lng: -106042800, label: 'Mountain relay site' }, signed: true } },
{ id: 8, direction: 'sent', peer_contact_id: 1, peer_name: 'archy-198', plaintext: 'Opening 1M sat channel to your node. Approve?', timestamp: new Date(now - 300000).toISOString(), delivered: true, encrypted: true, message_type: 'text' },
{ id: 9, direction: 'received', peer_contact_id: 1, peer_name: 'archy-198', plaintext: 'Approved. Waiting for funding tx confirmation.', timestamp: new Date(now - 240000).toISOString(), delivered: true, encrypted: true, message_type: 'text' },
{ id: 10, direction: 'sent', peer_contact_id: 3, peer_name: 'mountain-node', plaintext: 'Location shared', timestamp: new Date(now - 120000).toISOString(), delivered: true, encrypted: false, message_type: 'coordinate', typed_payload: { lat: 30267200, lng: -97743100, label: 'Supply drop point' } },
{ id: 11, direction: 'received', peer_contact_id: 4, peer_name: 'bunker-alpha', plaintext: 'Dead man switch check-in. All systems nominal. Battery 78%.', timestamp: new Date(now - 60000).toISOString(), delivered: true, encrypted: true, message_type: 'alert', typed_payload: { alert_type: 'status', message: 'All systems nominal. Battery 78%. Mesh uptime 14d.', signed: true } },
{ id: 12, direction: 'received', peer_contact_id: 1, peer_name: 'archy-198', plaintext: 'Invoice paid: 50,000 sats', timestamp: new Date(now - 30000).toISOString(), delivered: true, encrypted: true, message_type: 'invoice', typed_payload: { bolt11: 'lnbc500000n1pjmesh...truncated...', amount_sats: 50000, memo: 'Channel opening fee', paid: true, payment_hash: 'a1b2c3d4e5f6...' } },
]
return res.json({
result: {
messages: allMessages.slice(0, limit),
count: allMessages.length,
},
})
}
case 'mesh.send': {
const contactId = params?.contact_id
const message = params?.message || ''
const peer = [
{ id: 1, name: 'archy-198', encrypted: true },
{ id: 2, name: 'satoshi-relay', encrypted: true },
{ id: 3, name: 'mountain-node', encrypted: false },
{ id: 4, name: 'bunker-alpha', encrypted: true },
].find(p => p.id === contactId)
console.log(`[Mesh] Send to ${peer?.name || contactId}: ${message}`)
return res.json({
result: {
sent: true,
message_id: Math.floor(Math.random() * 10000) + 100,
encrypted: peer?.encrypted ?? false,
},
})
}
case 'mesh.broadcast': {
console.log('[Mesh] Broadcasting identity over LoRa')
return res.json({ result: { broadcast: true } })
}
case 'mesh.configure': {
console.log(`[Mesh] Configure:`, params)
return res.json({ result: { configured: true } })
}
case 'mesh.send-invoice': {
console.log(`[Mesh] Send invoice: ${params?.amount_sats} sats to contact ${params?.contact_id}`)
return res.json({
result: {
sent: true,
message_id: Math.floor(Math.random() * 10000) + 200,
amount_sats: params?.amount_sats,
bolt11: `lnbc${params?.amount_sats}n1pjmesh...`,
},
})
}
case 'mesh.send-coordinate': {
console.log(`[Mesh] Send coordinate: ${params?.lat}, ${params?.lng} to contact ${params?.contact_id}`)
return res.json({
result: {
sent: true,
message_id: Math.floor(Math.random() * 10000) + 300,
lat: Math.round((params?.lat || 0) * 1000000),
lng: Math.round((params?.lng || 0) * 1000000),
},
})
}
case 'mesh.send-alert': {
console.log(`[Mesh] Send alert: ${params?.alert_type} â ${params?.message}`)
return res.json({
result: {
sent: true,
alert_type: params?.alert_type || 'status',
signed: true,
},
})
}
case 'mesh.outbox': {
return res.json({
result: {
messages: [
{
id: 1,
dest_did: 'did:key:z6MkrHKPxJP6tvCvXMaJKZd3rRA2Y44tyftVhR8FDCMKGFjb',
from_did: 'did:key:z6MkSelf',
created_at: new Date(Date.now() - 1800000).toISOString(),
ttl_secs: 86400,
retry_count: 3,
relay_hops: 0,
expired: false,
},
{
id: 2,
dest_did: 'did:key:z6MknGc3ocHs3zdPiJbnaaqDi58NGb4pk1Sp7NQD5EjEREWh',
from_did: 'did:key:z6MkSelf',
created_at: new Date(Date.now() - 7200000).toISOString(),
ttl_secs: 86400,
retry_count: 8,
relay_hops: 1,
expired: false,
},
],
count: 2,
},
})
}
case 'mesh.session-status': {
const hasSess = (params?.contact_id === 1 || params?.contact_id === 4)
return res.json({
result: {
has_session: hasSess,
forward_secrecy: hasSess,
message_count: hasSess ? 23 : 0,
ratchet_generation: hasSess ? 7 : 0,
peer_did: hasSess ? 'did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2ReMkBe4bR6XBIDNq9' : null,
},
})
}
case 'mesh.rotate-prekeys': {
console.log('[Mesh] Rotating prekeys...')
return res.json({
result: {
rotated: true,
signed_prekey_id: Math.floor(Math.random() * 1000000),
one_time_prekeys: 10,
},
})
}
// =====================================================================
// Transport Layer (unified routing: mesh > lan > tor)
// =====================================================================
case 'transport.status': {
return res.json({
result: {
transports: [
{ kind: 'mesh', available: true },
{ kind: 'lan', available: true },
{ kind: 'tor', available: true },
],
mesh_only: false,
peer_count: 5,
},
})
}
case 'transport.peers': {
return res.json({
result: {
peers: [
{
did: 'did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2ReMkBe4bR6XBIDNq9',
pubkey_hex: 'a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2',
name: 'archy-198',
trust_level: 'trusted',
mesh_contact_id: 1,
lan_address: '192.168.1.198:5678',
onion_address: 'peer1abc2def3ghi4jkl5mno6pqr7stu8vwx9yz.onion',
preferred_transport: 'lan',
available_transports: ['mesh', 'lan', 'tor'],
last_seen: new Date(Date.now() - 30000).toISOString(),
},
{
did: 'did:key:z6MkpTHR8VNsBxYAAWHut2Geadd9jSwuBV8xRoAnwWsdvktH',
pubkey_hex: 'f6e5d4c3b2a1f6e5d4c3b2a1f6e5d4c3b2a1f6e5d4c3b2a1f6e5d4c3b2a1f6e5',
name: 'satoshi-relay',
trust_level: 'trusted',
mesh_contact_id: 2,
lan_address: null,
onion_address: 'peer2xyz9wvu8tsr7qpo6nml5kji4hgf3edc2ba.onion',
preferred_transport: 'mesh',
available_transports: ['mesh', 'tor'],
last_seen: new Date(Date.now() - 120000).toISOString(),
},
{
did: 'did:key:z6MkrHKPxJP6tvCvXMaJKZd3rRA2Y44tyftVhR8FDCMKGFjb',
pubkey_hex: 'c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4',
name: 'bunker-alpha',
trust_level: 'observer',
mesh_contact_id: 4,
lan_address: null,
onion_address: null,
preferred_transport: 'mesh',
available_transports: ['mesh'],
last_seen: new Date(Date.now() - 45000).toISOString(),
},
{
did: 'did:key:z6MkjchhfUsD6mmvni8mCdXHw216Xrm9bQe2mBH1P5RDjVJG',
pubkey_hex: 'd4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5',
name: 'office-node',
trust_level: 'trusted',
mesh_contact_id: null,
lan_address: '192.168.1.42:5678',
onion_address: 'peer4mno6pqr7stu8vwx9yzabc2def3ghi4jkl5.onion',
preferred_transport: 'lan',
available_transports: ['lan', 'tor'],
last_seen: new Date(Date.now() - 60000).toISOString(),
},
{
did: 'did:key:z6MknGc3ocHs3zdPiJbnaaqDi58NGb4pk1Sp7NQD5EjEREWh',
pubkey_hex: 'e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6',
name: 'remote-cabin',
trust_level: 'trusted',
mesh_contact_id: null,
lan_address: null,
onion_address: 'peer5xyz9abc2def3ghi4jkl5mno6pqr7stu8vw.onion',
preferred_transport: 'tor',
available_transports: ['tor'],
last_seen: new Date(Date.now() - 300000).toISOString(),
},
],
},
})
}
case 'transport.send': {
const targetDid = params?.did
console.log(`[Transport] Send to ${targetDid} via best transport`)
return res.json({
result: {
sent: true,
transport_used: 'mesh',
did: targetDid,
},
})
}
case 'transport.set-mode': {
const meshOnly = params?.mesh_only ?? false
console.log(`[Transport] Set mesh_only mode: ${meshOnly}`)
return res.json({ result: { mesh_only: meshOnly, configured: true } })
}
// =====================================================================
// LND / Lightning
// =====================================================================
case 'lnd.getinfo': {
return res.json({
result: {
alias: 'archy-signet',
color: '#f7931a',
num_active_channels: 4,
num_inactive_channels: 1,
num_pending_channels: 1,
block_height: 892451,
synced_to_chain: true,
synced_to_graph: true,
version: '0.17.4-beta',
identity_pubkey: '03a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456',
chains: [{ chain: 'bitcoin', network: 'signet' }],
// Balances (Home.vue reads these from getinfo)
balance_sats: 2_350_000,
channel_balance_sats: 8_250_000,
},
})
}
case 'lnd.gettransactions': {
return res.json({
result: {
transactions: [
{ tx_hash: 'ab12cd34ef5678901234567890abcdef12345678', amount_sats: 2_000_000, num_confirmations: 142, block_height: 892310, time_stamp: Math.floor(Date.now()/1000) - 86400, label: 'Channel funding' },
{ tx_hash: 'cd34ef5678901234567890abcdef1234567890ab', amount_sats: 250_000, num_confirmations: 28, block_height: 892420, time_stamp: Math.floor(Date.now()/1000) - 7200, label: 'Faucet deposit' },
{ tx_hash: 'ff99ee88dd7766554433221100aabbccddeeff00', amount_sats: 100_000, num_confirmations: 0, block_height: 0, time_stamp: Math.floor(Date.now()/1000) - 600, label: 'Incoming from faucet' },
],
incoming_pending_count: 1,
},
})
}
case 'lnd.channelbalance': {
return res.json({
result: {
local_balance: { sat: 8250000 },
remote_balance: { sat: 11750000 },
pending_open_local_balance: { sat: 500000 },
},
})
}
case 'lnd.walletbalance': {
return res.json({
result: {
total_balance: 2450000,
confirmed_balance: 2350000,
unconfirmed_balance: 100000,
},
})
}
case 'lnd.listchannels': {
return res.json({
result: {
channels: [
{ chan_id: '840921088114688', remote_pubkey: '02778f4a', capacity: 5000000, local_balance: 2450000, remote_balance: 2550000, active: true, peer_alias: 'ACINQ Signet' },
{ chan_id: '840921088114689', remote_pubkey: '03abcdef', capacity: 2000000, local_balance: 1200000, remote_balance: 800000, active: true, peer_alias: 'WalletOfSatoshi' },
{ chan_id: '840921088114690', remote_pubkey: '02fedcba', capacity: 10000000, local_balance: 4500000, remote_balance: 5500000, active: true, peer_alias: 'Voltage' },
{ chan_id: '840921088114691', remote_pubkey: '03456789', capacity: 3000000, local_balance: 100000, remote_balance: 2900000, active: true, peer_alias: 'Kraken' },
],
},
})
}
case 'lnd.newaddress': {
const addrType = params?.type || 'p2wkh'
const mockAddr = addrType === 'p2tr'
? 'tb1p' + Array.from({length: 58}, () => '0123456789abcdef'[Math.floor(Math.random()*16)]).join('')
: 'tb1q' + Array.from({length: 38}, () => '0123456789abcdef'[Math.floor(Math.random()*16)]).join('')
return res.json({ result: { address: mockAddr } })
}
case 'lnd.addinvoice':
case 'lnd.createinvoice': {
const amt = params?.amt || params?.value || params?.amount_sats || 1000
const memo = params?.memo || ''
const rHash = Array.from({length: 32}, () => Math.floor(Math.random()*256).toString(16).padStart(2,'0')).join('')
return res.json({
result: {
r_hash: rHash,
payment_request: `lnsb${amt}n1pjmock${Date.now().toString(36)}qqqxqyz5vqsp5mock${rHash.slice(0,20)}`,
add_index: Date.now(),
payment_addr: Array.from({length: 32}, () => Math.floor(Math.random()*256).toString(16).padStart(2,'0')).join(''),
},
})
}
case 'lnd.payinvoice':
case 'lnd.sendpayment': {
return res.json({
result: {
payment_hash: Array.from({length: 32}, () => Math.floor(Math.random()*256).toString(16).padStart(2,'0')).join(''),
payment_preimage: Array.from({length: 32}, () => Math.floor(Math.random()*256).toString(16).padStart(2,'0')).join(''),
status: 'SUCCEEDED',
fee_sat: Math.floor(Math.random() * 10) + 1,
value_sat: params?.amt || params?.amount_sats || 1000,
},
})
}
case 'lnd.sendcoins': {
const amt = params?.amount || params?.amt || 50000
return res.json({
result: {
txid: Array.from({length: 32}, () => Math.floor(Math.random()*256).toString(16).padStart(2,'0')).join(''),
amount: amt,
},
})
}
case 'lnd.decodepayreq': {
return res.json({
result: {
destination: '03a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456',
num_satoshis: params?.pay_req?.match(/lnsb(\d+)/)?.[1] || '1000',
description: 'Mock decoded invoice',
expiry: 3600,
timestamp: Math.floor(Date.now() / 1000),
},
})
}
case 'lnd.openchannel': {
return res.json({
result: {
funding_txid: Array.from({length: 32}, () => Math.floor(Math.random()*256).toString(16).padStart(2,'0')).join(''),
output_index: 0,
},
})
}
case 'lnd.closechannel': {
return res.json({
result: {
closing_txid: Array.from({length: 32}, () => Math.floor(Math.random()*256).toString(16).padStart(2,'0')).join(''),
},
})
}
case 'lnd.listinvoices': {
return res.json({ result: { invoices: MOCK_LND_DATA.invoices } })
}
case 'lnd.listpayments': {
return res.json({ result: { payments: MOCK_LND_DATA.payments } })
}
case 'lnd.create-psbt':
case 'lnd.finalize-psbt':
case 'lnd.create-raw-tx': {
return res.json({
result: {
psbt: 'cHNidP8BAH0CAAAA...mockPSBT',
txid: Array.from({length: 32}, () => Math.floor(Math.random()*256).toString(16).padStart(2,'0')).join(''),
},
})
}
// =====================================================================
// Wallet / Ecash (Fedimint)
// =====================================================================
case 'wallet.ecash-balance': {
return res.json({
result: {
balance_sats: 250_000,
balance_msat: 250_000_000,
token_count: 12,
federations: [
{ federation_id: 'fed1-demo', name: 'Archy Signet Mint', balance_msat: 250_000_000, gateway_active: true },
],
},
})
}
case 'wallet.ecash-send': {
const amt = params?.amount_sats || 1000
return res.json({
result: {
token: `cashuSend_mock_${amt}_${Date.now().toString(36)}`,
amount_sats: amt,
},
})
}
case 'wallet.ecash-receive': {
return res.json({
result: {
amount_sats: 5000,
federation_id: 'fed1-demo',
},
})
}
case 'wallet.ecash-history': {
return res.json({
result: {
transactions: [
{ type: 'receive', amount_sats: 50000, timestamp: new Date(Date.now() - 86400000).toISOString(), note: 'Minted from Lightning' },
{ type: 'send', amount_sats: 5000, timestamp: new Date(Date.now() - 43200000).toISOString(), note: 'Sent ecash token' },
{ type: 'receive', amount_sats: 10000, timestamp: new Date(Date.now() - 3600000).toISOString(), note: 'Redeemed token' },
],
},
})
}
case 'wallet.networking-profits': {
return res.json({
result: {
total_earned_sats: 42,
total_forwarded_sats: 35025,
forward_count: 3,
period_days: 30,
daily_avg_sats: 1.4,
},
})
}
case 'dev.faucet': {
// Dev-only: add mock funds to all wallet types
const amount = params?.amount_sats || 1_000_000
console.log(`[Dev Faucet] Adding ${amount} sats to all wallets`)
return res.json({
result: {
onchain: { txid: Array.from({length: 32}, () => Math.floor(Math.random()*256).toString(16).padStart(2,'0')).join(''), amount_sats: amount },
lightning: { payment_hash: Array.from({length: 32}, () => Math.floor(Math.random()*256).toString(16).padStart(2,'0')).join(''), amount_sats: amount },
ecash: { token: `cashuSend_faucet_${amount}_${Date.now().toString(36)}`, amount_sats: Math.floor(amount / 10) },
message: `Added ${amount} sats on-chain, ${amount} sats Lightning, ${Math.floor(amount / 10)} sats ecash`,
},
})
}
case 'bitcoin.getinfo': {
return res.json({
result: {
chain: 'signet',
blocks: 892451,
headers: 892451,
bestblockhash: 'a1b2c3d4e5f6' + '0'.repeat(58),
difficulty: 0.001126515290698186,
mediantime: Math.floor(Date.now() / 1000) - 300,
verificationprogress: 1.0,
chainwork: '000000000000000000000000000000000000000000000000000000000001a2b3',
size_on_disk: 210_000_000,
pruned: false,
network: 'signet',
},
})
}
// =====================================================================
// System / Network / Updates
// =====================================================================
case 'system.stats': {
return res.json({
result: {
cpu_percent: +(12 + Math.random() * 18).toFixed(1),
mem_used_bytes: 6_200_000_000 + Math.floor(Math.random() * 500_000_000),
mem_total_bytes: 16_000_000_000,
disk_used_bytes: 620_000_000_000 + Math.floor(Math.random() * 10_000_000_000),
disk_total_bytes: 1_800_000_000_000,
uptime_secs: Math.floor(process.uptime()) + 604800,
load_avg: [+(0.5 + Math.random() * 1.5).toFixed(2), +(0.8 + Math.random()).toFixed(2), +(0.6 + Math.random()).toFixed(2)],
net_rx_bytes: 12_400_000_000,
net_tx_bytes: 8_900_000_000,
},
})
}
case 'update.status': {
return res.json({
result: {
current_version: '0.1.0',
latest_version: '0.1.1',
update_available: true,
release_notes: 'Bug fixes and performance improvements.',
channel: 'stable',
},
})
}
case 'network.list-requests': {
return res.json({
result: {
requests: [
{ id: 'req-1', from_did: 'did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2ReMkBe4bR6XBIDNq9', from_name: 'archy-198', type: 'federation-join', status: 'pending', created_at: new Date(Date.now() - 3600000).toISOString() },
],
},
})
}
default: {
console.log(`[RPC] Unknown method: ${method}`)
return res.json({
error: {
code: -32601,
message: `Method not found: ${method}`,
},
})
}
}
} catch (error) {
console.error('[RPC Error]', error)
return res.json({
error: {
code: -32603,
message: error.message,
},
})
}
})
// =============================================================================
// Mock FileBrowser API (for Cloud page in demo/Docker deployments)
// =============================================================================
const MOCK_FILES = {
'/': [
{ name: 'Music', path: '/Music', size: 0, modified: '2025-03-01T10:00:00Z', isDir: true, type: '' },
{ name: 'Documents', path: '/Documents', size: 0, modified: '2025-02-28T14:30:00Z', isDir: true, type: '' },
{ name: 'Photos', path: '/Photos', size: 0, modified: '2025-02-20T09:15:00Z', isDir: true, type: '' },
{ name: 'Videos', path: '/Videos', size: 0, modified: '2025-01-15T18:00:00Z', isDir: true, type: '' },
],
'/Music': [
{ name: 'Bad Actors Reveal.mp3', path: '/Music/Bad Actors Reveal.mp3', size: 8_400_000, modified: '2025-01-10T12:00:00Z', isDir: false, type: 'audio' },
{ name: 'Architects of Tomorrow.wav', path: '/Music/Architects of Tomorrow.wav', size: 42_000_000, modified: '2025-01-08T15:00:00Z', isDir: false, type: 'audio' },
{ name: 'Sats or Shackles.mp3', path: '/Music/Sats or Shackles.mp3', size: 6_200_000, modified: '2024-12-20T10:00:00Z', isDir: false, type: 'audio' },
{ name: 'The Four Horseman of Technocracy.mp3', path: '/Music/The Four Horseman of Technocracy.mp3', size: 7_800_000, modified: '2024-12-15T11:00:00Z', isDir: false, type: 'audio' },
{ name: 'Inverse Dylan (Remix).mp3', path: '/Music/Inverse Dylan (Remix).mp3', size: 5_600_000, modified: '2024-12-10T16:00:00Z', isDir: false, type: 'audio' },
{ name: 'Hootcoiner.mp3', path: '/Music/Hootcoiner.mp3', size: 4_200_000, modified: '2024-11-28T09:00:00Z', isDir: false, type: 'audio' },
{ name: 'decentrealisation.mp3', path: '/Music/decentrealisation.mp3', size: 5_100_000, modified: '2024-11-20T14:00:00Z', isDir: false, type: 'audio' },
{ name: 'neo-morality.mp3', path: '/Music/neo-morality.mp3', size: 6_800_000, modified: '2024-11-15T11:00:00Z', isDir: false, type: 'audio' },
{ name: 'death is a gift.mp3', path: '/Music/death is a gift.mp3', size: 4_500_000, modified: '2024-11-10T08:00:00Z', isDir: false, type: 'audio' },
{ name: 'Wash the fucking dishes.mp3', path: '/Music/Wash the fucking dishes.mp3', size: 3_900_000, modified: '2024-11-05T13:00:00Z', isDir: false, type: 'audio' },
{ name: 'All the leaves are brown.mp3', path: '/Music/All the leaves are brown.mp3', size: 5_300_000, modified: '2024-10-28T10:00:00Z', isDir: false, type: 'audio' },
{ name: 'Builders not talkers.mp3', path: '/Music/Builders not talkers.mp3', size: 4_700_000, modified: '2024-10-20T15:00:00Z', isDir: false, type: 'audio' },
{ name: 'SMRI.mp3', path: '/Music/SMRI.mp3', size: 5_900_000, modified: '2024-10-15T12:00:00Z', isDir: false, type: 'audio' },
{ name: 'Shadrap.mp3', path: '/Music/Shadrap.mp3', size: 3_400_000, modified: '2024-10-10T09:00:00Z', isDir: false, type: 'audio' },
{ name: 'The Wehrman.mp3', path: '/Music/The Wehrman.mp3', size: 6_100_000, modified: '2024-10-05T14:00:00Z', isDir: false, type: 'audio' },
{ name: 'An Exploited Substrate.mp3', path: '/Music/An Exploited Substrate.mp3', size: 4_800_000, modified: '2024-09-28T11:00:00Z', isDir: false, type: 'audio' },
{ name: 'Govcucks.wav', path: '/Music/Govcucks.wav', size: 38_000_000, modified: '2024-09-20T16:00:00Z', isDir: false, type: 'audio' },
],
'/Documents': [
{ name: 'bitcoin-whitepaper-notes.md', path: '/Documents/bitcoin-whitepaper-notes.md', size: 820, modified: '2025-02-28T14:30:00Z', isDir: false, type: 'text' },
{ name: 'node-setup-checklist.md', path: '/Documents/node-setup-checklist.md', size: 950, modified: '2025-02-25T10:00:00Z', isDir: false, type: 'text' },
{ name: 'lightning-channels.csv', path: '/Documents/lightning-channels.csv', size: 680, modified: '2025-02-20T16:00:00Z', isDir: false, type: 'text' },
{ name: 'sovereignty-manifesto.txt', path: '/Documents/sovereignty-manifesto.txt', size: 1100, modified: '2025-02-15T12:00:00Z', isDir: false, type: 'text' },
{ name: 'backup-log.json', path: '/Documents/backup-log.json', size: 1450, modified: '2025-03-01T02:00:00Z', isDir: false, type: 'text' },
],
'/Photos': [
{ name: 'node-rack-setup.jpg', path: '/Photos/node-rack-setup.jpg', size: 2_400_000, modified: '2025-02-20T09:15:00Z', isDir: false, type: 'image' },
{ name: 'bitcoin-conference-2024.jpg', path: '/Photos/bitcoin-conference-2024.jpg', size: 3_100_000, modified: '2024-12-15T14:30:00Z', isDir: false, type: 'image' },
{ name: 'lightning-network-visualization.png', path: '/Photos/lightning-network-visualization.png', size: 1_800_000, modified: '2025-01-10T11:00:00Z', isDir: false, type: 'image' },
{ name: 'home-server-build.jpg', path: '/Photos/home-server-build.jpg', size: 2_900_000, modified: '2024-11-20T16:45:00Z', isDir: false, type: 'image' },
{ name: 'sunset-from-balcony.jpg', path: '/Photos/sunset-from-balcony.jpg', size: 4_200_000, modified: '2025-02-14T18:30:00Z', isDir: false, type: 'image' },
],
'/Videos': [
{ name: 'node-unboxing-timelapse.mp4', path: '/Videos/node-unboxing-timelapse.mp4', size: 85_000_000, modified: '2024-11-01T10:00:00Z', isDir: false, type: 'video' },
{ name: 'bitcoin-explained-5min.mp4', path: '/Videos/bitcoin-explained-5min.mp4', size: 42_000_000, modified: '2024-10-15T14:00:00Z', isDir: false, type: 'video' },
{ name: 'lightning-payment-demo.mp4', path: '/Videos/lightning-payment-demo.mp4', size: 28_000_000, modified: '2025-01-20T12:00:00Z', isDir: false, type: 'video' },
],
}
const MOCK_FILE_CONTENTS = {
'/Documents/bitcoin-whitepaper-notes.md': `# Bitcoin Whitepaper Notes\n\n## Key Concepts\n\n### Peer-to-Peer Electronic Cash\n- No trusted third party needed\n- Double-spending solved via proof-of-work\n- Longest chain = truth\n\n### Proof of Work\n- SHA-256 based hashing\n- Difficulty adjusts every 2016 blocks (~2 weeks)\n- Incentive: block reward + transaction fees\n\n## My Thoughts\n- The 21M supply cap is genius - digital scarcity\n- Lightning Network solves the scaling concern\n- Self-custody is the whole point`,
'/Documents/node-setup-checklist.md': `# Archipelago Node Setup Checklist\n\n## Hardware\n- [x] Intel NUC / Mini PC (16GB RAM minimum)\n- [x] 2TB NVMe SSD\n- [x] USB drive for installer\n- [x] Ethernet cable\n\n## Core Apps\n- [x] Bitcoin Knots\n- [x] LND\n- [x] Mempool Explorer\n- [ ] BTCPay Server\n- [ ] Fedimint`,
'/Documents/lightning-channels.csv': `channel_id,peer_alias,capacity_sats,local_balance,remote_balance,status\nch_001,ACINQ,5000000,2450000,2550000,active\nch_002,WalletOfSatoshi,2000000,1200000,800000,active\nch_003,Voltage,10000000,4500000,5500000,active\nch_004,Kraken,3000000,1800000,1200000,active`,
'/Documents/sovereignty-manifesto.txt': `THE SOVEREIGNTY MANIFESTO\n=========================\n\nWe hold these truths to be self-evident:\n\n1. Your data belongs to you.\n2. Your money should be uncensorable.\n3. Your communications should be private.\n4. Your compute should be sovereign.\n5. Your identity should be self-issued.\n\nRun your own node. Hold your own keys. Own your own data. Be sovereign.`,
'/Documents/backup-log.json': JSON.stringify({ backups: [{ id: 'bkp-2025-03-01', timestamp: '2025-03-01T02:00:00Z', type: 'full', apps: ['bitcoin-knots', 'lnd', 'mempool'], size_mb: 2340, status: 'success' }] }, null, 2),
}
// FileBrowser UI (demo placeholder when launched directly)
app.get('/app/filebrowser/', (req, res) => {
res.type('html').send(`
File Browser
File Browser
File Browser is running. Use the Cloud page in Archipelago to manage your files.
| ${c.peer_alias} |
${(c.capacity/1e6).toFixed(1)}M |
${(c.local_balance/1e3).toFixed(0)}k |
${(c.remote_balance/1e3).toFixed(0)}k |
${c.active ? 'Active' : 'Offline'} |
`).join('')
const invoiceRows = d.invoices.slice().reverse().map(inv => `
| ${inv.memo} |
${inv.value.toLocaleString()} sats |
${inv.settled ? 'Settled' : 'Open'} |
${new Date(inv.creation_date * 1000).toLocaleString()} |
`).join('')
const paymentRows = d.payments.map(p => `
| ${p.payment_hash.slice(0,12)}... |
${p.value_sat.toLocaleString()} sats |
${p.fee_sat} sats |
Succeeded |
`).join('')
res.type('html').send(`
ThunderHub â archy-signet
ThunderHubsignet
${d.info.alias} — block ${d.info.block_height.toLocaleString()} — ${d.info.num_active_channels} active channels
On-chain Balance
${(d.balance.confirmed_balance/1e6).toFixed(2)}M sats
Channel Capacity
${(totalCap/1e6).toFixed(1)}M sats
Local Balance
${(totalLocal/1e6).toFixed(1)}M sats
Remote Balance
${(totalRemote/1e6).toFixed(1)}M sats
Routing Fees Earned
${totalFees} sats
Payments Sent
${d.payments.length}
Channels (${d.channels.length})
| Peer | Capacity | Local | Remote | Status |
|---|
${channelRows}
Recent Invoices
| Memo | Amount | Status | Created |
|---|
${invoiceRows}
Recent Payments
| Hash | Amount | Fee | Status |
|---|
${paymentRows}
Forwarding History
| In Channel | Out Channel | Amount | Fee | Time |
|---|
${d.forwarding.map(f => {
const inPeer = d.channels.find(c => c.chan_id === f.chan_id_in)?.peer_alias || f.chan_id_in
const outPeer = d.channels.find(c => c.chan_id === f.chan_id_out)?.peer_alias || f.chan_id_out
return `| ${inPeer} | ${outPeer} | ${f.amt_in.toLocaleString()} sats | ${f.fee} sats | ${new Date(f.timestamp_ns/1e6).toLocaleString()} |
`
}).join('')}
Mock ThunderHub — Archipelago Dev Mode — No Docker Required
`)
})
// ThunderHub API stubs (for any programmatic access)
app.get('/app/thunderhub/api/info', (req, res) => res.json(MOCK_LND_DATA.info))
app.get('/app/thunderhub/api/balance', (req, res) => res.json(MOCK_LND_DATA.balance))
app.get('/app/thunderhub/api/channels', (req, res) => res.json(MOCK_LND_DATA.channels))
app.get('/app/thunderhub/api/invoices', (req, res) => res.json(MOCK_LND_DATA.invoices))
app.get('/app/thunderhub/api/payments', (req, res) => res.json(MOCK_LND_DATA.payments))
app.get('/app/thunderhub/api/forwards', (req, res) => res.json(MOCK_LND_DATA.forwarding))
// Health check
app.get('/health', (req, res) => {
res.status(200).send('healthy')
})
// WebSocket endpoint
const server = http.createServer(app)
const wss = new WebSocketServer({ server, path: '/ws/db' })
wss.on('connection', (ws, req) => {
console.log('[WebSocket] Client connected from', req.socket.remoteAddress)
wsClients.add(ws)
// Set up ping/pong to keep connection alive
const pingInterval = setInterval(() => {
if (ws.readyState === 1) { // OPEN
try {
ws.ping()
} catch (err) {
console.error('[WebSocket] Ping error:', err)
clearInterval(pingInterval)
clearInterval(heartbeatInterval)
}
} else {
clearInterval(pingInterval)
clearInterval(heartbeatInterval)
}
}, 30000) // Ping every 30 seconds
// Send periodic heartbeat data so clients don't think the connection is dead
const heartbeatInterval = setInterval(() => {
if (ws.readyState === 1) {
try {
ws.send(JSON.stringify({ type: 'heartbeat', rev: Date.now() }))
} catch { /* ignore */ }
}
}, 45000) // Every 45s (client expects data within 60s)
// Send initial data immediately
try {
ws.send(JSON.stringify({
type: 'initial',
data: mockData,
}))
console.log('[WebSocket] Initial data sent')
} catch (err) {
console.error('[WebSocket] Error sending initial data:', err)
}
ws.on('pong', () => {
// Client responded to ping, connection is alive
})
ws.on('message', (message) => {
// Handle incoming messages if needed
try {
const data = JSON.parse(message.toString())
console.log('[WebSocket] Received message:', data)
} catch (err) {
console.error('[WebSocket] Error parsing message:', err)
}
})
ws.on('close', (code, reason) => {
console.log('[WebSocket] Client disconnected', { code, reason: reason.toString() })
clearInterval(pingInterval)
clearInterval(heartbeatInterval)
wsClients.delete(ws)
})
ws.on('error', (error) => {
console.error('[WebSocket Error]', error)
clearInterval(pingInterval)
clearInterval(heartbeatInterval)
wsClients.delete(ws)
})
})
server.listen(PORT, '0.0.0.0', async () => {
const runtime = await isContainerRuntimeAvailable()
// Initialize package data from Docker
await initializePackageData()
console.log(`
ââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
â â
â đ Archipelago Mock Backend Server â
â â
â RPC: http://localhost:${PORT}/rpc/v1 â
â WebSocket: ws://localhost:${PORT}/ws/db â
â â
â Dev Mode: ${DEV_MODE.padEnd(47)}â
â Setup: ${userState.setupComplete ? 'â
Complete' : 'â Not done'.padEnd(47)}â
â Onboarding: ${userState.onboardingComplete ? 'â
Complete' : 'â Not done'.padEnd(46)}â
â â
â Mock Password: ${MOCK_PASSWORD.padEnd(40)}â
â â
â Container Runtime: ${runtime.available ? `â
${runtime.runtime}`.padEnd(40) : 'âī¸ Simulation mode'.padEnd(40)}â
â Claude API Key: ${process.env.ANTHROPIC_API_KEY ? 'â
Set (' + process.env.ANTHROPIC_API_KEY.slice(0, 12) + '...)' : 'â Not set (chat disabled)'.padEnd(40)}â
â â
ââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
`)
console.log('Mock backend is running. Press Ctrl+C to stop.\n')
// Pre-check Anthropic API connectivity
if (process.env.ANTHROPIC_API_KEY) {
try {
const dns = await import('dns')
dns.lookup('api.anthropic.com', (err, address) => {
if (err) {
console.error('[Claude Proxy] â DNS lookup failed for api.anthropic.com:', err.message)
console.error('[Claude Proxy] Chat will fail. Check container DNS settings.')
} else {
console.log('[Claude Proxy] â
api.anthropic.com resolves to', address)
}
})
} catch { /* ignore */ }
}
// Periodically update package data from Docker (merge with static dev apps)
// Only poll if container runtime is available (avoids log spam in demo/Docker deployments)
if (runtime.available) {
setInterval(async () => {
const dockerApps = await getDockerContainers()
mockData['package-data'] = mergePackageData(dockerApps)
// Broadcast update to connected clients
broadcastUpdate([
{
op: 'replace',
path: '/package-data',
value: mockData['package-data']
}
])
}, 5000) // Update every 5 seconds
}
})
process.on('SIGINT', () => {
console.log('\n\nShutting down mock backend...')
server.close(() => {
console.log('Server stopped.')
process.exit(0)
})
})