Desktop App
Atomic swaps via the desktop application
Extension
A wallet and swaps in your browser
SDK
Integrate KaleidoSwap into your application
Desktop App Quickstart
1
Download & Install
Download the latest release for your platform:
2
Create Wallet
Launch KaleidoSwap and create a new wallet:
- Click “Create New Wallet”
- Save your 12-word recovery phrase securely
- Set a strong password
- Confirm your seed phrase
3
Deposit Funds
Get your Bitcoin address and deposit funds:
- Navigate to “Wallet” → “Receive”
- Copy your Bitcoin address
- Send BTC to this address from your exchange or wallet
- Wait for confirmations (usually 10-60 minutes)
4
Open a Channel
Connect to a Lightning Service Provider:
- Go to “Channels” → “Open Channel”
- Select an LSP or use the default
- Choose channel capacity (recommended: 1M sats minimum)
- Select RGB assets to allocate (e.g., USDT)
- Confirm and wait for channel to open
5
Make Your First Swap
Execute an atomic swap:
- Go to “Swap” tab
- Select assets: BTC → USDT (or vice versa)
- Enter amount to swap
- Review the quote
- Confirm swap
- Wait for completion (usually less than 30 seconds)
Congratulations! You’ve completed your first atomic RGB asset swap on Lightning Network.
Extension Quickstart
1
Install the Extension
Download the latest closed beta zip from your invite, then load it into your browser:
- Extract the zip archive
- Open
chrome://extensionsand enable Developer mode - Click Load unpacked and select the extracted folder
- Pin the KaleidoSwap icon to your toolbar
2
Create Wallet
Open the extension and create a new wallet:
- Choose “Create New Wallet”
- Set a secure password
- Save your 12-word recovery phrase securely
- Optionally register a passkey and set up your Nostr identity
3
Fund Your Wallet
Deposit BTC or assets into a connected account:
- Click “Deposit” on the dashboard
- Choose a route: Bitcoin on-chain, Lightning, Spark, Arkade, Liquid, or RGB
- Copy the address or invoice and send funds from your exchange or another wallet
- Wait for confirmation (instant on Spark/Arkade, block-time on-chain)
4
Connect a Swap Venue
Swaps need a compatible venue connected:
- Spark pools become available once your Spark account is funded
- For RGB swaps, connect an RGB Lightning Node from “Settings” → “Accounts” → “RGB” (direct URL or Nostr Wallet Connect)
5
Make Your First Swap
Execute a swap from the dashboard:
- Click “Swap”
- Select the From and To assets
- Enter the amount and review the quote
- Confirm the swap before the quote expires
- Track status until it completes
Congratulations! You’ve completed your first swap in the KaleidoSwap Extension.
SDK Quickstart
Python SDK
Python SDK Documentation
Explore the complete SDK documentation →
TypeScript SDK
TypeScript SDK Documentation
Explore the complete SDK documentation →
API Quick Reference
API Reference
View complete API documentation →
Available Networks
- Signet
- Mainnet
API URL:
https://api.signet.kaleidoswap.com/api/v1WebSocket: wss://api.signet.kaleidoswap.com/api/v1/market/ws/{client_id}- Bitcoin Signet (MutinyNet) — public testnet with realistic conditions
- Recommended for integration testing before mainnet
- Currently live