FAQ & Troubleshooting
My swap is stuck on "Pending"
PuzzleSwap checks for on-chain confirmation periodically. Most swaps confirm within a minute or two. If a swap stays pending for more than 30 minutes, it will automatically be marked as failed and no funds should have moved — check your wallet's transaction history to confirm.
My wallet won't connect
- Make sure your wallet app supports TON Connect (Tonkeeper, MyTonWallet, Tonhub, etc.).
- Try closing and reopening PuzzleSwap, then reconnecting.
- Update your wallet app to the latest version.
- If you're using the Telegram Mini App, make sure Telegram itself is up to date.
My swap failed
Common reasons a swap doesn't go through:
- Insufficient TON for network fees — keep a small TON balance in your wallet.
- Price moved before confirmation — for volatile tokens, the price may shift between getting a quote and confirming; request a new quote and try again.
- Transaction rejected in wallet — the swap won't proceed unless you approve it in your wallet app.
Why did I get a different price than expected?
The quote shown includes the current market rate plus an estimate of network and liquidity costs (price impact). Prices can move slightly between when you request a quote and when you confirm — this is normal for on-chain trading. If the difference seems unusually large, get a fresh quote before swapping.
What tokens can I swap?
PuzzleSwap supports TON-based tokens available through its supported liquidity sources. Use the token search in the app to check whether a specific token is available.
Is PuzzleSwap custodial?
No. PuzzleSwap never holds your funds. Every swap happens directly from your own wallet, and you must approve each transaction yourself.
I didn't receive my referral reward
- Rewards are credited automatically after your referral's swap is confirmed on-chain — check that their swap actually completed.
- Each user can only be referred once; if your friend already had a PuzzleSwap account, the referral won't be recorded.
- Check your XP balance in the Referrals section — see XP & Rewards.
Still need help?
Reach out through PuzzleSwap's official support channel linked in the app.