Skip to main content

​
Frequently Asked Questions

Currently supported:
  • Alby - Lightning browser wallet
  • Xverse - Bitcoin Web3 wallet
  • BitMask - RGB & Lightning wallet
  • Rate - Bitcoin Layer 2 extension with built-in RGB and swap support
More wallets may be added in the future.
No. KaleidoSwap does not hold your keys or funds:
  • Your keys stay in your wallet extension
  • No account or registration needed
However, in this phase swaps are order-based, not atomic. When you create a swap order, you pay a deposit first. The maker then processes the swap and sends the asset to your recipient address. This means there is a trust component during the execution window — you rely on the maker to fulfill the order after receiving your payment.
The swap process has several steps:
  1. Create an order - Select assets, enter amount and recipient address, confirm the swap
  2. Pay the deposit - You are shown a deposit address or invoice. Pay the exact amount.
  3. Maker executes - Once your payment is confirmed, the maker processes the swap and sends the asset to your recipient address.
  4. Order complete - The order page shows the final status.
Swaps are not atomic in this phase. You pay first, then wait for the maker to send the swapped asset.
Swap speed depends on:
  • Payment confirmation - Lightning payments are detected quickly. On-chain payments require block confirmations.
  • Maker execution - After your payment is confirmed, the maker processes the swap. This typically takes a short time but is not instant.
Overall, Lightning-based swaps are faster than on-chain swaps.
Fees include:
  • Network fee - Lightning/Bitcoin network costs
  • Protocol fee - Small percentage for market makers
All fees are shown before you confirm the swap order.
Current supported assets:
  • BTC - Bitcoin (Lightning & On-chain)
  • USDT - Tether USD (RGB)
  • XAUT - Tether Gold (RGB)
More RGB assets are added regularly.
The recipient address field is on the swap panel, below the “To” card. This is where the maker will send the swapped asset after your payment is confirmed.The address format depends on the destination layer:
  • Lightning - A BOLT11 invoice
  • Bitcoin on-chain - A Bitcoin address (bc1q…, etc.)
  • RGB - An RGB invoice
If the exchange rate changes after your order is created, you may see a Rate Decision screen on the order page. You have two options:
  • Accept the new rate - The swap continues with the updated rate
  • Cancel and request a refund - The order is cancelled and your payment is refunded
If you do not respond before the order expires, it is automatically cancelled and a refund is initiated.
If your payment does not match the expected amount, the order page will show a Payment Issue screen displaying the expected amount, the amount received, and the difference.Payment discrepancies require manual resolution through support. Use the email or Telegram links on the payment issue screen.
Orders cannot be manually cancelled once created. However:
  • If you do not pay the deposit before the expiry countdown, the order expires automatically.
  • If you are presented with a rate decision, you can choose to cancel and request a refund.
If the maker does not fulfill your order after payment, the order will eventually show a Failed status. Contact support via email or Telegram to resolve the issue and initiate a refund.
Yes, each pair has min/max limits:
  • Limits are shown below the input field
  • Depend on available liquidity
  • May change based on market conditions
Yes! The web app is responsive and works on mobile browsers.For best experience:
  • Use Chrome or Safari on mobile
  • Scan the deposit QR code with your mobile wallet
  • Ensure your wallet app is installed
  • Bitcoin Mainnet - Production trading
  • Bitcoin Signet - Testing environment
  • Regtest - Development/testing
The app connects to the appropriate network automatically.

​
Troubleshooting

​
Wallet Issues

Symptoms: “No wallets found” or wallet not in listSolutions:
  1. Install a supported wallet extension
  2. Enable the extension for app.kaleidoswap.com
  3. Refresh the page after installing
  4. Try restarting your browser
  5. Check if extension is up to date
Symptoms: Clicking connect does nothing or shows errorSolutions:
  1. Unlock your wallet first
  2. Check if another site has wallet locked
  3. Disconnect from wallet settings, then reconnect
  4. Clear browser cache and cookies
  5. Try incognito/private mode
Symptoms: Address shown doesn’t match expected walletSolutions:
  1. Check which account is active in wallet
  2. Switch accounts in wallet extension
  3. Disconnect and reconnect
  4. Verify you’re using the right wallet

​
Trading Issues

Symptoms: Spinning loader, no quote appearsSolutions:
  1. Check internet connection
  2. Refresh the page
  3. Try different asset pair
  4. Amount might be outside valid range
  5. Server might be under maintenance
Symptoms: Red error message about amountSolutions:
  1. Check min/max limits shown below input
  2. Adjust amount to be within limits
  3. Different pairs have different limits
  4. Ensure proper decimal format
Symptoms: Button is grayed outPossible causes:
  • No wallet connected - Connect wallet
  • Invalid amount - Adjust amount
  • Missing asset selection - Select both assets
  • Quote expired - Wait for new quote
  • Invalid pair - Select valid pair
  • Missing recipient address - Enter a valid address
Symptoms: Order page shows “Expired” statusCauses:
  • The deposit was not paid within the expiry window
Solutions:
  1. Create a new swap order with a fresh quote
  2. Pay the deposit promptly after order creation
Symptoms: Order still shows “Awaiting Deposit” after paymentSolutions:
  1. For on-chain payments, wait for block confirmations
  2. Check your wallet to confirm the transaction was sent
  3. Verify you paid the exact amount shown
  4. Wait for the next status poll (every 10 seconds)
  5. Contact support if the issue persists

​
Display Issues

Solutions:
  1. Clear browser cache
  2. Disable ad blockers temporarily
  3. Try different browser
  4. Check if JavaScript is enabled
  5. Verify URL is app.kaleidoswap.com
Symptoms: Stale prices, no real-time updatesSolutions:
  1. WebSocket connection may be lost
  2. Refresh the page
  3. Check internet stability
  4. Browser tab may be throttled (bring to focus)
Solutions:
  1. Rotate device to portrait mode
  2. Clear browser cache
  3. Update mobile browser
  4. Try Chrome or Safari

​
Error Messages

ErrorMeaningSolution
”Wallet not connected”No wallet linkedClick Connect button
”Amount too low”Below minimumIncrease amount
”Amount too high”Above maximumDecrease amount
”Quote expired”Quote timed outWait for fresh quote
”Insufficient balance”Not enough fundsAdd funds to wallet
”Network error”Connection issueCheck internet, retry
”Transaction rejected”User cancelledTry again, approve in wallet
”Order expired”Deposit not paid in timeCreate a new order
”Rate changed”Exchange rate updatedAccept or reject new rate
”Payment issue”Deposit mismatchContact support

​
Getting Help

Telegram Community

Join our community for quick help

GitHub Issues

Report bugs or request features

Email Support

Direct support for urgent issues

Documentation

Browse all documentation

​
Reporting Issues

When reporting problems, include:
  1. Browser and version
  2. Wallet extension name and version
  3. Order ID (if applicable)
  4. Steps to reproduce
  5. Error messages (screenshots help)
  6. Network (Mainnet/Signet/Regtest)