Accessing the Web App
The KaleidoSwap Web App is available at:Launch Web App
app.kaleidoswap.com
Before You Start
Install a Wallet
Install one of the supported wallet extensions:
| Wallet | Description | Install |
|---|---|---|
| Alby | Lightning-native wallet | getalby.com |
| Xverse | Bitcoin Web3 wallet | xverse.app |
| BitMask | RGB & Lightning wallet | bitmask.app |
| Rate | Bitcoin Layer 2 extension | Rate Extension |
Fund Your Wallet
Ensure your wallet has:
- Sufficient BTC for trading
- Or RGB assets you want to swap
- Small amount for network fees
Navigate to App
Open app.kaleidoswap.com in your browser.
Your First Swap
1. Connect Your Wallet
Click the Connect button in the top right corner:Connect Alby
Connect Alby
- Click Connect
- Select Alby from the wallet list
- Approve the connection in the Alby popup
- Your address will appear in the header
Connect Xverse
Connect Xverse
- Click Connect
- Select Xverse from the wallet list
- Approve the connection in Xverse
- Your address will appear in the header
Connect BitMask
Connect BitMask
- Click Connect
- Select BitMask from the wallet list
- Approve the connection request
- Your address will appear in the header
Connect Rate
Connect Rate
- Click Connect
- Select Rate from the wallet list
- Approve the connection in the Rate popup
- Your address will appear in the header
2. Select Assets to Trade
From Card (Top)- Click the asset selector
- Choose the asset you want to swap FROM
- Enter the amount
- Click the asset selector
- Choose the asset you want to RECEIVE
- The amount updates automatically based on the live quote
3. Enter Recipient Address
Enter the address where you want to receive the swapped asset. This is the destination for the maker to send your funds to after the swap is executed. The address format depends on the destination layer:- Lightning - A BOLT11 invoice
- Bitcoin on-chain - A Bitcoin address
- RGB - An RGB invoice
4. Review the Quote
Before confirming, check:- The exchange rate between the two assets
- The fees for the swap
- The output amount you will receive
5. Confirm the Order
Click the Swap button to open the confirmation modal:- Review the full summary (assets, amounts, rate, fees, recipient address)
- Click Confirm Swap to create the order
- You are redirected to the Order Page
6. Pay the Deposit
On the order page, you will see:- A QR code with the deposit address or invoice
- The exact amount to pay
- A copy button to copy the address or invoice
- A Pay with Wallet button if your connected wallet supports direct payment
7. Wait for Execution
After your payment is detected:- The order status updates to Payment Confirmed
- The maker processes the swap
- Status moves to Executing Swap
- Once complete, the order shows Swap Completed
Swaps are order-based in this phase. After you pay, the maker fulfills the order. The order page shows real-time status updates so you can track progress.
Interface Elements
Header
- Logo - Return to home
- Wallet Button - Connect/disconnect wallet
- Settings - Display options (BTC/sats)
Swap Panel
- From Card - Source asset and amount
- Swap Arrow - Click to reverse direction
- To Card - Destination asset and amount
- Recipient Address - Where the maker sends the swapped asset
- Quote Info - Rate, fees, expiry
Order Page
- Status Timeline - Visual progress through order states
- Deposit Instructions - QR code and address/invoice to pay
- Pay with Wallet - Quick payment via connected wallet
- Expiry Countdown - Time remaining to complete payment
Footer Info
- Min/Max - Amount limits for the selected pair
- Network - Protocol layer being used
Display Options
Click the Settings icon to customize:| Option | Description |
|---|---|
| BTC Display | Show as BTC or satoshis |
| Currency | USD equivalent display |
Quick Tips
Swap Direction
Swap Direction
Click the swap arrow to quickly reverse the trade direction.
Amount Shortcuts
Amount Shortcuts
- Enter amounts in the From field for exact input
- Or enter in To field for exact output
Check Limits
Check Limits
Each trading pair has min/max limits shown below the input fields.
Real-Time Updates
Real-Time Updates
Quotes refresh automatically. The displayed rate is what the order will be created with.
Order Tracking
Order Tracking
After creating an order, you can always return to the order page to check its status.
Troubleshooting
| Issue | Solution |
|---|---|
| Quote not loading | Check internet connection, try refreshing |
| Amount too low | Increase to meet minimum shown |
| Amount too high | Decrease to meet maximum shown |
| Wallet won’t connect | Restart browser, reinstall extension |
| Order page not loading | Check the order ID in the URL, try refreshing |