Migration Guide
Migration Checklist

Migration Checklist

🚫

🚨 P0 — Wallet Tags API must move hosts.
Tags are currently on tpslapi.polyinsiders.com (a standalone CH-fed service), not on the main ClickHouse pipeline. Any change to tpslapi silently breaks tags across leaderboard, wallet detail, copy-trade UI, and trader search. Consolidate into apiclick.polyinsiders.com or the main CH query layer before any infra work on tpslapi.

Phase 1 — Documentation

  • Collect all Insiders API routes
  • Collect all PolyEyes API routes
  • Collect all TPSL API routes
  • Collect all Copy Trading API routes
  • Collect all Trading Tools API routes
  • Map all service-to-service dependencies
  • Confirm all database schemas

Phase 2 — Audit

  • Confirm auto-refresh-stats dependencies
  • Confirm cache-prewarmer dependencies
  • Confirm correction-worker dependencies
  • Confirm lense active usage
  • Confirm mirror-dashboard active usage
  • Confirm insiders-agent status
  • Review Nomad jobs vs PM2 overlap
  • Review DevServer vs Cherry overlap

Phase 2.5 — P0 Migrations (do before cleanup)

  • Move wallet tags API off tpslapi.polyinsiders.com → into main ClickHouse layer (apiclick.polyinsiders.com or standalone CH endpoint)
  • Update VITE_WALLET_TAGS_API_URL env var across all environments after migration
  • Confirm tags still render in leaderboard, wallet detail, copy-trade UI, trader search after cutover

Phase 3 — Cleanup

  • Stop confirmed-unused stopped PM2 processes
  • Remove old Nomad jobs
  • Clean up stale DNS records
  • Archive deprecated repos in /opt
  • Consolidate staging vs prod bots

Phase 4 — Verify

  • Frontend loads correctly
  • Insiders API health check passes
  • PolyEyes data pipeline running
  • TPSL service operational
  • Copy trading operational
  • Telegram bot responsive
  • WebSocket connections stable

Update this checklist as migration progresses.

Services to Deprecate