| Symptom | Safe action |
|---|---|
| Wallet cannot connect | Verify the Reown configuration, browser wallet, and exact application origin |
| Wrong network | Switch to Arc Testnet chain ID 5042002 |
| Create/trade button stays unavailable | Check wallet readiness, canonical address configuration, and the explicit testnet write gate; do not bypass it |
| Quote or allowance expired | Refresh canonical state and request a new quote |
| Approval confirmed but swap is blocked | Wait for the authoritative allowance re-read; do not force the dependent transaction |
| Transaction timed out | Keep the original hash and resolve receipt/nonce/replacement state before retrying |
| Token or metadata is missing | Wait for canonical indexing; metadata finalization can return 409 not_indexed |
| Realtime update disappeared | A removed log or canonical reconciliation may have retracted the provisional event |
| SSE missed events after reconnect | This is expected for a live-only stream; canonical API polling recovers history |
| API is unavailable | Repository configuration is not health proof; check the target environment separately |
Troubleshooting
Safe responses to wallet, transaction, indexing, and realtime problems.
Use ArcScan for transaction and address inspection. For reproducible non-sensitive bugs, open a GitHub issue without secrets.