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.

​
Browser Requirements

The KaleidoSwap Extension is built as a Manifest V3 web extension.
BrowserSupported
Google ChromeYes, Chromium extension support
BraveYes, Chromium extension support
EdgeYes, Chromium extension support
OperaYes, Chromium extension support
FirefoxSupported by the manifest gecko configuration
SafariNot yet

​
Installation

​
From a Browser Store

When a browser-store build is available, install it from the KaleidoSwap Extension listing for your browser and pin the extension icon in the toolbar.
1

Open the Store Listing

Open the KaleidoSwap Extension listing for your browser.
2

Install the Extension

Confirm the browser installation prompt.
3

Pin the Extension

Pin KaleidoSwap from the extensions menu so the wallet is available from the toolbar.

​
Manual Installation (Developer Mode)

Use manual installation when testing a pre-release build or building from source.
1

Build the Extension

First, download or clone the KaleidoSwap Extension source code, then open a terminal in the project root directory. If pnpm is not installed yet, install it first, then install dependencies and build:
git clone <repository-url>
cd <repository-directory>
npm install -g pnpm
pnpm install
pnpm run build
2

Open Extensions Page

Navigate to chrome://extensions in your browser.
3

Enable Developer Mode

Toggle Developer mode in the top-right corner.
4

Load Unpacked

Click Load unpacked and select the dist folder from the build output.
5

Pin the Extension

Pin the KaleidoSwap icon in your toolbar for easy access.

​
First Launch

After installation, clicking the KaleidoSwap icon in your toolbar opens the extension popup. On first launch, you are guided through the onboarding flow: KaleidoSwap Extension first launch
  1. Welcome screen - Create a new wallet or import an existing phrase
  2. Password setup - Create a secure password to protect the local wallet
  3. Recovery phrase backup - Save the phrase that controls Spark, Arkade, and Nostr identity
  4. Optional RLN setup - Connect an RGB Lightning Node, or skip and connect it later
  5. Ready - Continue to the wallet dashboard
See Getting Started for more information.

​
Permissions

The KaleidoSwap Extension requests the following Chrome extension permissions:
PermissionPurpose
StorageStore encrypted wallet data, preferences, and account configuration locally
Active TabSupport browser-page wallet interactions
ScriptingInject DApp bridge scripts
TabsCoordinate approval and confirmation windows
AlarmsRun scheduled wallet/session tasks
NotificationsNotify the user about wallet events where supported
The KaleidoSwap Extension stores the encrypted mnemonic in chrome.storage.local. Network calls are made only for the accounts and services you connect, such as Spark, Arkade, an optional RGB Lightning Node, price data, or swap venues.

​
Updating

Store-installed builds update through the browser’s extension update system. For manual installations, pull the latest code, rebuild, and reload the unpacked extension in your browser.

​
Uninstalling

To remove the KaleidoSwap Extension, follow the instructions provided by your browser.
Uninstalling the extension removes all locally stored wallet data. Make sure you have backed up your recovery phrase and any RGB Lightning Node backup material before uninstalling.