Troubleshooting
A symptom-to-check guide for market, engine, database, wallet, and UI failures.
#Symptoms
| Symptom | Check |
|---|---|
| MARKET API UNAVAILABLE | Upstream reachability, base URL, schema errors |
| RPC UNAVAILABLE | RPC URL, eth_chainId, network response |
| Observation count unchanged | generatedAt uniqueness, market hours, halts, engine logs |
| Ledger unavailable | DB path, permissions, D1 binding, quick_check |
| Duplicate worker lease | PM2 instance count and stale process |
| Wallet not detected | Extension unlocked, EIP-6963 support, browser permissions |
| Wrong chain | Switch/add chain 4663 |
| Docs route 404 | Exact nested path and current deployment |
#Diagnostic order
Start at /status, then inspect the affected page provenance, PM2 status/logs, database health, and upstream response. Preserve the database before invasive repair.
#Avoid
Do not seed observations, delete the database, clear a live lease, or expose secret environment values to make a status surface appear healthy.