Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kaleidoswap.com/llms.txt

Use this file to discover all available pages before exploring further.

​
What is the KaleidoSwap Extension?

The KaleidoSwap Extension is the KaleidoSwap browser wallet for Bitcoin Layer 2 networks. It gives users one popup for Spark, Arkade, optional RGB Lightning Node (RLN), swaps, Nostr identity, and DApp connectivity. KaleidoSwap Extension dashboard

Multi-Protocol

Supports Spark, Arkade, and optional RGB Lightning Node accounts

Built-in Swaps

Routes through KaleidoSwap maker pairs and supported Spark/Flashnet venues

DApp Integration

Exposes window.rgbwebln for trusted DApp wallet requests

Secure

Argon2id password checks, AES-GCM encrypted mnemonic, and auto-lock

​
Key Features

​
Wallet Management

  • Create or import a wallet from a 12 or 24-word recovery phrase
  • Derive Spark, Arkade, and Nostr identity state from the same phrase
  • Opt into RGB Lightning Node support when you want RGB assets and RLN channels
  • View BTC by account and layer: Spark, Arkade, Bitcoin L1, and Lightning/RLN
  • Filter assets by protocol account and network

​
Send and Receive

  • Send to Bitcoin addresses, Lightning invoices, Lightning addresses, LNURL-pay, Spark addresses, Arkade routes, and RGB invoices where supported
  • Receive through Spark, Arkade, Bitcoin on-chain, Lightning, or RGB invoice flows depending on the selected account and asset
  • QR code generation for easy sharing
  • Auto-detection of destination type and compatible route

​
Asset Swaps

  • Fetch KaleidoSwap maker pairs when RLN is connected
  • Use Spark/Flashnet venues when Spark pools are available
  • Review quote output, fee, expiry, and venue before execution
  • Track swap progress and failures directly in the extension

​
DApp Connectivity

  • RGB WebLN provider (window.rgbwebln) for node info, address, invoice, asset, and payment requests
  • Nostr identity derived from the recovery phrase and visible in settings
  • Permission prompts for sensitive DApp operations

​
Security

  • Argon2id-derived password hash and a separate Argon2id-derived AES-GCM encryption key
  • Master mnemonic encrypted in chrome.storage.local; decrypted only in memory while unlocked
  • Nostr private key kept in session storage after derivation
  • Auto-lock timeout configurable from Preferences

​
Architecture

The KaleidoSwap Extension uses a multi-protocol adapter architecture:
ProtocolStatusDescription
SparkImplementedNative Spark wallet, Spark BTC, Spark assets, Lightning send/receive, and Flashnet routes
ArkadeImplementedArkade BTC, Arkade-native assets, boarding/offboarding, and VTXO lifecycle settings
RGBExperimental opt-inRGB Lightning Node, RGB assets, RGB invoices, and maker-based RGB swaps
The background service worker owns protocol adapter lifecycle and message routing. The popup is a React wallet interface, while the content and injected scripts bridge web pages to the background service worker for DApp requests.

​
How It Works

KaleidoSwap Extension Architecture
  • The extension UI runs as a popup with a clean wallet interface
  • The background service worker manages protocol adapters and cross-context messaging
  • Spark and Arkade are derived from the wallet recovery phrase
  • RGB Lightning Node is optional and currently presented as an experimental feature
  • DApp connectivity is handled through content scripts, window.rgbwebln, and Nostr signing support

​
Get Started

Install the KaleidoSwap Extension

Install the extension in your browser

First Steps

Set up your wallet and connect to a node

Wallet Features

Learn about send, receive, and asset management

Swaps

Swap assets directly in the extension