Troubleshooting

"No safe route found"

This means our AI couldn't find a route that meets the 90/100 safety threshold for your token pair. Possible causes:

• The token isn't supported by any whitelisted bridge for your destination chain
• The amount is too small (some bridges have minimums)
• There isn't enough liquidity right now
• One of the chains is currently experiencing issues

Fix: Try a different destination chain, a more common token (USDC, ETH), or wait a few minutes and retry.

"Coinbase Wallet not detected"

You clicked Connect → Coinbase Wallet but the extension isn't being detected.

Fix:

1. Make sure the Coinbase Wallet extension is installed and enabled in your browser
2. If you have both MetaMask and Coinbase installed, MetaMask sometimes hijacks the connection. Disable MetaMask temporarily, or upgrade both extensions to the latest version (they support EIP-6963 multi-wallet discovery).
3. Refresh the Riverforge dashboard after enabling the extension

Wallet connects but no token balances show

You connected a wallet but the swap form says "no tokens found".

Fix:

1. Check which chain your wallet is currently on. Click the network selector at the top of your wallet extension.
2. Riverforge reads balances on the chain your wallet is currently set to. Switch to the chain where your tokens are.
3. Refresh the dashboard. Your balances should appear.

Transaction failed: "insufficient funds for gas"

Your swap was rejected because you don't have enough native token (ETH, MATIC, BNB, etc.) to pay for gas.

Fix: Buy or transfer a small amount of the native token to your wallet. As a rule of thumb:

• Ethereum: $5-30 worth of ETH for gas
• Polygon: $0.10 worth of MATIC
• Base / Arbitrum / Optimism: $0.50 worth of ETH
• BNB Chain: $0.10 worth of BNB

"Rate limit exceeded"

You're hitting our API rate limit. Default limit is 60 requests per minute, with a stricter 20/min limit specifically for the AI route endpoint.

Fix: Wait a minute and try again. If you're hitting this regularly, contact us — you may be a candidate for higher limits.

"Account locked due to too many failed login attempts"

You entered the wrong password 5 times. Your account is locked for 10 minutes as a security measure.

Fix: Wait 10 minutes and try again. If you've forgotten your password, click Forgot Password to reset it via email.

Swap completed but I don't see the destination tokens

For cross-chain swaps, the destination tokens take time to arrive depending on the bridge. Wait 1-15 minutes.

If they still haven't arrived:

1. Check the transaction hash in the dashboard — copy it and look it up on the destination chain's block explorer (etherscan.io, polygonscan.com, basescan.org, etc.)
2. Make sure your wallet is on the correct destination chain to see the new balance
3. Some tokens require manual import in MetaMask: click Import tokens and paste the contract address

Verification email never arrived

Fix:

1. Check your spam/junk folder
2. Make sure you entered the correct email at registration
3. Add noreply@riverforge.ai to your address book
4. Wait 5 minutes — sometimes there's a delivery delay
5. If still nothing, contact support

"Account mismatch" when verifying a wallet

You're trying to verify wallet address A but your connected wallet is currently set to address B.

Fix: In your wallet extension, switch to the account matching the address you're verifying. Then click Verify again.

The dashboard keeps showing "Loading…"

The page is stuck on the loading screen.

Fix:

1. Hard refresh: Ctrl+Shift+R (Cmd+Shift+R on Mac)
2. Clear browser cache for riverforge.ai
3. Try in an incognito/private window — if it works there, an extension is interfering
4. Check our status page to confirm the site is up