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

The Swap SDK adds non-custodial swaps to any wallet or app. This lists the routes the signet maker trades, with no keys or funds needed.

Swap SDK Quickstart

Continue to a full swap, from creation to claim →

Maker API

Building your own client? See the maker’s /v2 API →

Available Networks

Maker API: https://maker.signet.kaleidoswap.com/v2WebSocket: wss://maker.signet.kaleidoswap.com/v2/wsChain access: https://esplora.signet.kaleidoswap.com
  • Mutinynet, a custom Bitcoin signet with 30-second blocks. Use Mutinynet wallets and the Mutinynet faucet
  • Recommended for integration testing before mainnet
  • Currently live