Troubleshooting

Start here when the widget does not behave as expected.

First checks

1. Confirm the widget is registered or initialized.
2. Open the browser console and look for TokenFlight errors.
3. Open the Network tab and check /v1/chains, /v1/tokens, and /v1/quotes.
4. Confirm your wallet adapter is configured if the user should connect a wallet.
5. Confirm the selected chains and tokens are supported by your API endpoint.

Pick the right page

FAQShort answers for common setup and product questions.Common IssuesDebug blank widgets, missing tokens, stuck quotes, wallet failures, and stuck orders.Known IssuesCurrent limits around rate limits, offline behavior, multiple widgets, and platform support.

If this is a payment flow

Frontend callbacks are useful for UI, but they are not a source of truth. For business-critical payments, verify completion from your backend.

Read Backend Verification after you fix the immediate issue.

Getting help

If you cannot resolve the issue, include this information when you contact support:

• SDK version from package.json.
• Browser and wallet.
• Adapter package and version.
• Console error text.
• Failed network request and response body.
• The flow you are using: swap, receive, or card payments.