Key Features - KaleidoSwap Documentation

Core Capabilities

RGB Lightning Node Management

Run your own RGB Lightning node or connect to existing ones

RGB Asset Trading

Trade RGB20 assets instantly on the Lightning Network

Lightning Integration

Fast, low-cost transactions through payment channels

Security First

Non-custodial architecture with encrypted backups

🚀 RGB Lightning Node Management

Full Node Control

KaleidoSwap allows you to run a self-hosted RGB Lightning Node or connect to a remote one.

Run Your Own Node
Connect to Existing Node

Self-Hosted RGB Lightning NodeTake full control of your infrastructure with a locally running node.

Maximum privacy
Direct P2P connections
No reliance on third parties

# Start your RGB Lightning node
kaleidoswap-node start

Node Features

Channel Management

Open/close Lightning channels
Monitor channel states
Rebalance liquidity
Set channel policies

Asset Allocation

Allocate RGB assets to channels
Multi-asset channel support
Asset-specific routing
Balance tracking per asset

Automated Backups

Encrypted channel backups
Automatic backup scheduling
Cloud or local storage
One-click restore

Monitoring & Alerts

Real-time node monitoring
Channel status alerts
Payment notifications
Performance metrics

💱 RGB Asset Trading

Atomic Swaps

Execute trustless, instant asset swaps without intermediaries. Supported Swap Types:

Lightning to Lightning

Instant RGB Asset Swaps Swap RGB assets (like USDT) directly for BTC through Lightning channels.

On-Chain to Lightning

Liquidity Management Open channels with your on-chain funds for instant trading.

Lightning to On-Chain

Settlement Move assets from Lightning channels back to the Bitcoin blockchain for cold storage.

Trading Features

Real-Time Quotes

Get live market rates for asset pairs with price impact calculations

Slippage Protection

Configure maximum acceptable slippage for trades

Order History

Track all your swaps with detailed execution data

Multiple LSP Support

Connect to multiple liquidity providers for best rates

Asset availability depends on connected LSP. Different LSPs may support different asset sets.

⚡ Lightning Network Integration

Fast & Low-Cost Transactions

Leverage the Lightning Network for high-performance trading.

Instant Settlement

Transactions complete in milliseconds with immediate balance updates.

Minimal Fees

Pay a fraction of on-chain costs, making micro-transactions viable.

High Throughput

Execute millions of transactions per second without blockchain bottlenecks.

Privacy Enhanced

Off-chain transactions with onion routing for maximum privacy.

Channel Operations

Opening Channels

Select LSP or Peer
Choose Channel Capacity
Allocate RGB Assets (optional)
Set Channel Parameters
Confirm and Open

Channel Options:

Public Channels: Participate in routing, earn fees
Private Channels: Direct payments only, more privacy
Anchor Channels: Use anchor outputs for security
Zero Reserve: Spend full channel capacity

Managing Liquidity

Inbound Liquidity
Outbound Liquidity
Circular Rebalancing

Receive PaymentsGet inbound liquidity from LSPs:

Order channels with inbound capacity
Submarine swaps
Lightning Service Provider services

🔒 Security Features

Non-Custodial Architecture

KaleidoSwap is built on the principle of “Your Keys, Your Coins”.

✓ Private keys never leave your device

✓ No third-party access to funds

✓ Complete control over transactions

✓ Trustless trading protocol via atomic swaps

Secure Key Management

Encryption Layer:

Software Wallet
- AES-256 Encryption
- Password Protection
- Mnemonic Backup
Hardware Wallet Support (Soon)
- Ledger
- Trezor

Channel Backups

Automatic Backups

Channels are automatically backed up after every state change

Encrypted Storage

Backups are encrypted with your password before storage

Multiple Locations

Save backups locally and to cloud storage for redundancy

Easy Restore

Restore channels with mnemonic phrase + backup file

Security Best Practices

Important Security Tips:

Always verify binary signatures before installation
Store your mnemonic phrase securely offline
Use strong, unique passwords
Enable automatic backups
Keep your software updated

🎯 Additional Features

User Interface

Intuitive Design

Clean, modern interface designed for both beginners and power users

Dark Mode

Easy on the eyes with beautiful dark theme support

Multi-Platform

Available for macOS, Windows, and Linux

Real-Time Updates

Live balance updates, market data, and notifications

Developer Tools

For developers building on KaleidoSwap:

Python SDK
TypeScript SDK
REST API

from kaleidoswap_sdk import KaleidoClient

client = KaleidoClient.create(
    base_url="https://api.signet.kaleidoswap.com"
)
pairs = client.maker.list_pairs()
quote = client.maker.get_quote({
    "from_asset": {"asset_id": "BTC", "layer": "BTC_LN", "amount": 100000},
    "to_asset": {"asset_id": "USDT", "layer": "RGB_LN"}
})

Explore Python SDK →

import { KaleidoClient } from 'kaleidoswap-sdk';

const client = KaleidoClient.create({
  baseUrl: 'https://api.signet.kaleidoswap.com'
});
const pairs = await client.maker.listPairs();
const quote = await client.maker.getQuote({
  from_asset: { asset_id: 'BTC', layer: 'BTC_LN', amount: 100000 },
  to_asset: { asset_id: 'USDT', layer: 'RGB_LN' }
});

Explore TypeScript SDK →

curl https://api.signet.kaleidoswap.com/api/v1/market/pairs

Explore API Reference →

Advanced Features

WebSocket Streaming

Real-time market data and quote updates via WebSocket connections

Multi-Asset Channels

Allocate multiple RGB assets to a single Lightning channel

Custom Fee Policies

Set your own routing fees for public channels

Payment Routing

Automatic optimal path finding for Lightning payments

Invoice Management

Create, track, and manage Lightning invoices

Transaction History

Complete history of all swaps, payments, and channel operations

Web App & Extensions

In addition to the desktop application, KaleidoSwap is also available as:

Web App

Browser-Based TradingTrade RGB assets directly from your browser. The web app currently uses order-based swaps — you create an order, pay, and the maker fulfills it.

No installation required
Multiple wallet support (Alby, Xverse, BitMask, Rate)
Real-time order tracking

Rate Extension

Bitcoin Layer 2 WalletSelf-custodial Chrome extension wallet for Bitcoin Layer 2 networks.

Built-in asset swaps via Kaleidoswap
RGB protocol support (Spark, Arkade, Liquid planned)
WebLN and Nostr DApp connectivity

Coming Soon

Upcoming Features:

Mobile app (iOS & Android)
Hardware wallet integration
Advanced trading features (limit orders, DCA)
Multi-signature wallet support
More RGB asset types (RGB21 NFTs, RGB25 UDAs)
Atomic swaps in the web app

Get Started

Desktop App

Install KaleidoSwap and start trading with atomic swaps

Web App

Trade from your browser with order-based swaps

Rate Extension

Install the Bitcoin Layer 2 wallet extension

Introduction

Architecture & Background

Reference

​Core Capabilities

RGB Lightning Node Management

RGB Asset Trading

Lightning Integration

Security First

​🚀 RGB Lightning Node Management

​Full Node Control

​Node Features

​💱 RGB Asset Trading

​Atomic Swaps

Lightning to Lightning

On-Chain to Lightning

Lightning to On-Chain

​Trading Features

​⚡ Lightning Network Integration

​Fast & Low-Cost Transactions

Instant Settlement

Minimal Fees

High Throughput

Privacy Enhanced

​Channel Operations

​Opening Channels

​Managing Liquidity

​🔒 Security Features

​Non-Custodial Architecture

​Secure Key Management

​Channel Backups

​Security Best Practices

​🎯 Additional Features

​User Interface

Intuitive Design

Dark Mode

Multi-Platform

Real-Time Updates

​Developer Tools

​Advanced Features

​Web App & Extensions

Web App

Rate Extension

​Coming Soon

​Get Started

Desktop App

Web App

Rate Extension

Core Capabilities

🚀 RGB Lightning Node Management

Full Node Control

Node Features

💱 RGB Asset Trading

Atomic Swaps

Trading Features

⚡ Lightning Network Integration

Fast & Low-Cost Transactions

Channel Operations

Opening Channels

Managing Liquidity

🔒 Security Features

Non-Custodial Architecture

Secure Key Management

Channel Backups

Security Best Practices

🎯 Additional Features

User Interface

Developer Tools

Advanced Features

Web App & Extensions

Coming Soon

Get Started