KaleidoSwap: Bitcoin DEX on Lightning

Abstract KaleidoSwap emblem: a faceted purple and green gem mark surrounded by lightning bolts and coin icons over a dark circuit-board background

KaleidoSwap is building the liquidity layer for Bitcoin-native atomic swaps, enabling anyone to exchange Bitcoin-based assets freely, privately, and without intermediaries. Its vertically integrated stack spans end-user applications such as the Desktop App and the Browser Extension, a multi-language SDK, AI tools for autonomous AI agents and local AI brains, and market-maker software.

Why KaleidoSwap?

Multi-Protocol

Hold, spend, and swap assets across Bitcoin Layers. BTC ↔ RGB swaps settle atomically over Lightning; other routes run through supported venues

Non-Custodial

Your keys, your coins. No accounts, no intermediaries. Just connect your wallet or run your own node

Open Source

The desktop app, SDKs, CLI, and wallet engine are MIT-licensed, and the AI tooling is Apache 2.0. Inspect the code, contribute, or build your own integration

Multi-Platform

Desktop App available for macOS, Windows, and Linux. Extension available in the browser

Platform Overview

KaleidoSwap platform diagram: Desktop, Extension, Mobile, and Web App clients connecting through the swap-sdk and wallet-sdk integration layer to Bitcoin, Lightning, and Layer 2 protocol icons, the KaleidoSwap LSP and market makers, and the KaleidoMind and KaleidoAgent intelligence layer

The stack is vertically integrated: the same SDKs power every client we ship and every third-party integration, so each surface talks to the same swap engine, the same protocols, and the same liquidity.

Clients & integrators — Desktop, Extension, Mobile, and Web App, alongside third-party wallets, neobanks, payment processors, and AI agents building on the same interfaces.
Integration layer — the Swap SDK (@kaleidorg/swap-sdk: TypeScript, Python, React Native, and Rust) for non-custodial swaps against the maker, and @kaleidorg/wallet-engine for wallet primitives (TypeScript). Start with the SDK →
Protocols — Bitcoin on-chain and Lightning, plus the Bitcoin Layer protocols swaps can settle on. How it works →
Liquidity layer — the KaleidoSwap LSP bootstraps liquidity today; external market makers join from 2027.
Intelligence layer — KaleidoMind, the self-hosted AI brain (QVAC runtime, Skills and MCP libraries, fine-tuned models), and KaleidoAgent, an autonomous trading agent that runs against a local model or Claude and OpenAI. Explore AI Tools →

Components marked LIVE are in production today; the rest are on the roadmap.

For Traders

Trade from your own wallet with our apps and extensions:

Getting Started

Install the app

Download for macOS, Windows, or Linux. Installation Guide →

Create a wallet

Generate a new wallet and save your recovery phrase. Wallet Setup →

Deposit & open channels

Fund your wallet and open Lightning channels. Deposit Guide → · Channel Guide →

Start trading

Execute atomic swaps with RGB assets. Trading Guide →

Guides

Desktop Guide

Nodes, wallets, channels, and trading

Extensions

Multi-layer wallet, swaps, and DApp connectivity

AI Tools

Autonomous agent for portfolio management and local-AI brain

For Builders

Build on KaleidoSwap with our SDKs, APIs, and AI Tools:

Getting Started

Install the Swap SDK

npm install @kaleidorg/swap-sdk for TypeScript, pip install kaleidorg_swap_sdk for Python. Installation →

List what the maker trades

Connect to the signet maker and read its routes, limits, and fees. Mainnet is coming soon. Quickstart →

Make a swap

Create a swap, verify it against your own keys, fund it, and claim. The SDK builds and signs every transaction on your side. Receive on-chain from Lightning →

Go deeper

Every maker endpoint, if you are building your own client. Maker API →

import { init, SwapClient } from "@kaleidorg/swap-sdk";

await init();
const client = SwapClient.forNetwork("signet");

// Lightning -> on-chain routes, with limits and fees
const reverse = await client.reversePairs();
console.log(reverse.BTC["L-BTC"]);

import asyncio
import kaleidorg_swap_sdk as sdk

async def main():
    client = sdk.SwapClient.default(sdk.Network.SIGNET)
    # Lightning -> on-chain routes, with limits and fees
    print(await client.get_reverse_pairs())

asyncio.run(main())

Guides

SDK

Swap SDK guides, reference, and examples

API Reference

The maker’s /v2 endpoints and swap flow

CLI

Run local nodes, swaps, and channel flows from the terminal

AI Tools

MCP servers for wallet operations and Skills files for specific behaviors

Community & Support

Join our community chat

Twitter/X

GitHub

Contribute to the project

KaleidoSwap is open source software licensed under the MIT License.

Introduction

System Design

Reference

Why KaleidoSwap?

Multi-Protocol

Non-Custodial

Open Source

Multi-Platform

Platform Overview

For Traders

Getting Started

Guides

Desktop Guide

Extensions

AI Tools

For Builders

Getting Started

Guides

SDK

API Reference

CLI

AI Tools

Community & Support

Telegram

Twitter/X

GitHub

​Why KaleidoSwap?

Multi-Protocol

Non-Custodial

Open Source

Multi-Platform

​Platform Overview

​For Traders

​Getting Started

​Guides

Desktop Guide

Extensions

AI Tools

​For Builders

​Getting Started

​Guides

SDK

API Reference

CLI

AI Tools

​Community & Support

Telegram

Twitter/X

GitHub

Why KaleidoSwap?

Platform Overview

For Traders

Getting Started

Guides

For Builders

Getting Started

Guides

Community & Support