| Symptom | Probable Cause | Recommended Resolution |
|---|---|---|
| Wallet prompts wrong network | Wallet configured to Ethereum or Polygon | Switch network to Celo Mainnet (Chain ID: 42220) in your wallet settings. |
| SIWE challenge fails with 401 | Nonce expired (> 5 minutes old) | Refresh the page to obtain a fresh cryptographic nonce and re-sign. |
| Quote displays "Expired" | Accept deadline lapsed before broadcast | Textile firm quotes expire in ~30s. Click Refresh Quote to request a live price. |
| Trade rejected with PER_TRADE_CAP | Requested trade exceeds mandate limit | Adjust the trade amount or update your mandate per-trade ceiling in Settings. |
| Balances show 0 or fail to refresh | Celo RPC endpoint rate limit | MOI automatically falls back across redundant Celo RPC endpoints; check network connection. |
Troubleshooting
Resolving common issues: wallet connection errors, nonce expiration, and RPC timeouts.