> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cooket.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Safe responses to wallet, transaction, indexing, and realtime problems.

| 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                          |

Use [ArcScan](https://testnet.arcscan.app) for transaction and address inspection. For reproducible non-sensitive bugs, open a [GitHub issue](https://github.com/cooketfun/cooket/issues) without secrets.