Skip to main content

​
Browser Requirements

The KaleidoSwap Extension is built as a Manifest V3 web extension. The first closed beta is distributed as a Chromium-compatible zip archive for Developer Mode installation.

​
Installation

​
Closed Beta Zip (Developer Mode)

The first KaleidoSwap Extension release is an invite-only closed beta. There is no browser-store listing yet, and the extension source repository is not public yet. Invited testers receive a personal download link from the KaleidoSwap team, of the form https://kaleidoswap.com/dl?t=.... It always serves the latest beta build, so keep the email — the same link works for every update.
Only install beta archives shared through the official KaleidoSwap invite or support channel. Do not install forwarded archives from unverified sources. Your download link is personal to you; treat it as private.
1

Download the Beta Zip

Open the download link from your beta invite. It serves the current build as a zip archive.
2

Verify What You Downloaded

The published checksum and the maintainer’s detached signature are available on the same link:
Compare it against the archive you downloaded:
To check the signature as well, fetch it with &file=asc and verify against the KaleidoSwap release signing key (696F19C9DA0ADBE8B38E5346E007BFF05941433B):
3

Extract the Archive

Unzip the archive into a stable folder on your machine. Keep this extracted folder in place while the extension is installed, because the browser loads the extension from that folder.
4

Open Extensions Page

Navigate to chrome://extensions in your Chromium-based browser.
5

Enable Developer Mode

Toggle Developer mode in the top-right corner.
6

Load Unpacked

Click Load unpacked and select the extracted folder that contains manifest.json.
7

Pin the Extension

Pin the KaleidoSwap icon in your toolbar for easy access.

​
Not Available Yet

Closed beta testers should install only the zip served by their personal download link. Source-build instructions will be added when the extension repository is made public.

​
First Launch

After installation, clicking the KaleidoSwap icon in your toolbar opens the wallet in the browser side panel (on browsers that don’t support the side panel API, it falls back to a toolbar popup). On first launch, you are guided through the onboarding flow: KaleidoSwap Extension first launch
  1. Welcome screen - Create New Wallet or Import Existing Wallet (12 or 24-word phrase). When importing, choose whether the wallet holds real bitcoin (Mainnet) or is a test wallet (Test networks: Signet, regtest, Liquid Testnet)
  2. Password setup - Create a password that encrypts the wallet on this device
  3. Recovery phrase (new wallets) - Save the 12 words that control Spark, Arkade, Liquid, RGB, and the derived Nostr identity
  4. Passkey (optional) - Unlock with biometrics or a security key
  5. Nostr identity (new wallets) - Keep the derived identity or import an existing key
  6. RGB setup - Use this device (recommended) or connect your own RGB Lightning Node
  7. Beta notice - Acknowledge the beta risk notice; the dashboard opens
See Getting Started for more information.

​
Permissions

The KaleidoSwap Extension requests the following Chrome extension permissions: The manifest also declares host_permissions for the specific endpoints the wallet talks to: KaleidoSwap services, block explorers and indexers, the RGB proxy, Spark/Flashnet, Arkade, and price APIs. The manifest also lists optional host permissions. The wallet asks for access only when you point it at your own endpoint (for example an LND node, an Esplora indexer, or a VSS server).
The KaleidoSwap Extension stores the encrypted mnemonic in chrome.storage.local. Network calls are made only for the accounts and services you connect.If Chrome Sync is on, Chrome may copy the encrypted seed, password hash and salts to Google’s servers; you can disable extension sync in chrome://settings/syncSetup/advanced.

​
Updating

Closed beta builds do not auto-update through a browser store. When a new beta is available, open your download link again — it always serves the current build — extract it, then return to chrome://extensions and click Reload on the KaleidoSwap Extension card. If you extracted the new build into a different folder, point Load unpacked at the new folder instead. Do not remove the old extension first: removing it deletes the wallet data stored in the browser, and you would have to restore from your recovery phrase. Because beta builds ship a fixed extension ID (mmldlmkphefjjbpbajnhnkbiahiabiog), your accounts, balances and settings carry over across updates. Keep your recovery phrase to hand regardless.

​
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.

Access the Beta

Request access to the KaleidoSwap Extension closed beta.