Skip to main content

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:
Always verify the binary signatures before installing. Learn how →
2

Create Wallet

Launch KaleidoSwap and create a new wallet:
  1. Click “Create New Wallet”
  2. Save your 12-word recovery phrase securely
  3. Set a strong password
  4. Confirm your seed phrase
Never share your recovery phrase! Anyone with access to it can steal your funds.
3

Deposit Funds

Get your Bitcoin address and deposit funds:
  1. Navigate to “Wallet” → “Receive”
  2. Copy your Bitcoin address
  3. Send BTC to this address from your exchange or wallet
  4. Wait for confirmations (usually 10-60 minutes)
4

Open a Channel

Connect to a Lightning Service Provider:
  1. Go to “Channels” → “Open Channel”
  2. Select an LSP or use the default
  3. Choose channel capacity (recommended: 1M sats minimum)
  4. Select RGB assets to allocate (e.g., USDT)
  5. Confirm and wait for channel to open
5

Make Your First Swap

Execute an atomic swap:
  1. Go to “Swap” tab
  2. Select assets: BTC → USDT (or vice versa)
  3. Enter amount to swap
  4. Review the quote
  5. Confirm swap
  6. 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:
  1. Extract the zip archive
  2. Open chrome://extensions and enable Developer mode
  3. Click Load unpacked and select the extracted folder
  4. Pin the KaleidoSwap icon to your toolbar
Full walkthrough, including checksum verification: Installation Guide →
2

Create Wallet

Open the extension and create a new wallet:
  1. Choose “Create New Wallet”
  2. Set a secure password
  3. Save your 12-word recovery phrase securely
  4. Optionally register a passkey and set up your Nostr identity
Never share your recovery phrase! Anyone with access to it can steal your funds.
3

Fund Your Wallet

Deposit BTC or assets into a connected account:
  1. Click “Deposit” on the dashboard
  2. Choose a route: Bitcoin on-chain, Lightning, Spark, Arkade, Liquid, or RGB
  3. Copy the address or invoice and send funds from your exchange or another wallet
  4. 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:
  1. Click “Swap”
  2. Select the From and To assets
  3. Enter the amount and review the quote
  4. Confirm the swap before the quote expires
  5. 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

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