> For the complete documentation index, see [llms.txt](https://flowrouter.gitbook.io/flowrouter-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://flowrouter.gitbook.io/flowrouter-docs/use-flowrouter/troubleshooting.md).

# Troubleshooting

Resolve common wallet, quote, allowance, and transaction issues.

Use the message in the app to identify the next step. When a transaction hash exists, check that transaction before attempting another swap.

| What you see                                     | What to check or do                                                                                                    |
| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| Connect wallet                                   | Connect or sign in, then confirm the intended account is selected.                                                     |
| Wrong network or a network prompt                | Switch the wallet to Robinhood Chain mainnet, chain ID `4663`.                                                         |
| Insufficient balance                             | Check the sell token's balance on Robinhood Chain and reduce the amount if needed.                                     |
| Insufficient ETH for network fees                | Keep native ETH on Robinhood Chain for approval and swap gas. WETH is not the gas balance.                             |
| Max is unavailable                               | The balance may still be loading, be zero, or be reserved for network fees.                                            |
| No route                                         | Check the token addresses and try another amount or pair. The app can retry a temporarily missing route automatically. |
| Quote expired                                    | Refresh the quote. Review the new output before trying again.                                                          |
| Swaps open after launch or execution unavailable | Quotes and execution are controlled separately. Wait until the app enables execution.                                  |
| Service temporarily unavailable                  | Allow the app to retry. Your entered pair and amount can remain in place.                                              |
| Simulation failed                                | Refresh and check balances, allowance, and token restrictions. Do not reuse the failed transaction.                    |
| Transaction does not match the quote             | Start a new quote and transaction attempt. Do not edit the old call to force it through.                               |

## I approved, but my tokens did not swap

Approval only authorizes spending. Look for the next swap action or wallet prompt. The app obtains a fresh quote after approval; the swap may still need your confirmation.

If execution becomes unavailable after approval, the allowance can remain even though no swap was submitted.

## My transaction is pending

Open the transaction in the explorer. Confirm that the hash belongs to the expected wallet, network, and action. A pending transaction has not yet established a successful swap.

Check your wallet for other pending transactions from the same account. Avoid submitting repeated swaps while the first one's status is unresolved.

## The transaction reverted

A reverted swap does not complete its token exchange, but the chain can still charge gas. Prices may have moved, the minimum output may no longer be attainable, or a token or venue may have rejected execution.

Refresh the quote and review the new conditions. A previous successful simulation cannot guarantee success in a later block.

## The token or dollar value is missing

Verify the token's address and network. Address metadata, catalog admission, route availability, and price availability are separate checks. A missing dollar estimate does not by itself prove that the token has no executable route.

## Report an issue

Use the links on [Official links](/flowrouter-docs/reference/official-links.md). Include the pair's contract addresses, the amount, the visible error, and a transaction hash if one exists. These details make the issue reproducible. Keep wallet recovery phrases and private keys out of reports.