Skip to main content

​
Frequently Asked Questions

The closed beta supports Google Chrome (Developer Mode), Brave, and Arc, installed from a private beta zip. Edge and Opera are Chromium-based but not covered by the beta guide. Firefox is not shipped (there is no Firefox AMO listing), and Safari is not yet supported.
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. The extension is not listed in browser stores yet, and the source repository is not public yet, so closed beta testers should install only the zip served by their personal download link.
No. Spark, Arkade, Liquid, and node-less RGB-L1 accounts are all derived from the KaleidoSwap Extension recovery phrase and run without any node — including RGB assets on Bitcoin L1, which run entirely in the extension via WebAssembly.An RGB Lightning Node (RLN) is only needed if you want RGB Lightning channels and maker-based RGB swaps. For RLN features, you can connect to:Note that the node-less RGB-L1 account and the RLN account are mutually exclusive backings for RGB assets.For Lightning, Settings > Lightning Node lets you connect one external node at a time: an RGB Lightning node, LND (REST URL and macaroon), or any Nostr Wallet Connect wallet. Its balance counts in the portfolio and it appears as a payment source in Send.
No. The KaleidoSwap Extension stores the wallet mnemonic encrypted locally and derives protocol accounts from it. For optional RLN use, the extension connects to the node you configure.
No. Swap venues are optional. Without them:
  • Send, receive, and balance features work normally
  • Only the swap feature is disabled
The KaleidoSwap Extension supports:
  • BTC across Spark, Arkade, Liquid (L-BTC), Bitcoin L1, and RLN Lightning where connected
  • Spark-native assets when available on the Spark account
  • Arkade-native assets when available on the Arkade account
  • Liquid assets such as USDt on the Liquid account; USDT held on RGB and on Liquid is shown together in one Tether USD card
  • RGB assets on Bitcoin L1 through the node-less RGB-L1 account, or over Lightning when an RGB Lightning Node is connected
Go to Settings > Security > Backup Wallet to decrypt and copy your recovery phrase with your password. Node-less RGB backups (automatic cloud backup, encrypted backup file, restore) are under Settings > RGB > Backup.Keep separate offline copies of:
  • Your KaleidoSwap Extension recovery phrase for Spark, Arkade, Liquid, RGB-L1, and the derived Nostr identity
  • A recent RGB node backup file if you use an RGB Lightning Node
  • Your RLN node seed phrase or node backup material if the node is managed separately
The node-less RGB-L1 account backs itself up automatically to an encrypted cloud (VSS) backup after wallet activity such as sends, receives, and UTXO changes. A local encrypted backup file can also be exported manually from Settings > RGB > Backup. When you re-import the wallet, onboarding offers to restore from the cloud backup — restore only happens with your explicit consent.
The KaleidoSwap Extension cannot recover your password. If you forget it, you will need to:
  1. On the lock screen, select Forgot password? Reset wallet and type RESET to confirm. This erases the wallet from this browser.
  2. Choose Import Existing Wallet and enter your recovery phrase
  3. Set a new password
  4. Restore RGB state (cloud backup prompt or a backup file) and reconnect optional services such as your Lightning node
Spark, Arkade, Liquid, and the derived Nostr identity are recoverable from the recovery phrase, and node-less RGB-L1 state can be restored from its cloud (VSS) backup during onboarding. RGB Lightning Node state must be recovered from the node’s own backup material.
The KaleidoSwap Extension manages Spark, Arkade, Liquid, RGB-L1, and optional RLN accounts. For RLN, connect one node endpoint at a time (direct URL or NWC). For Lightning, Settings > Lightning Node lets you connect one external node at a time: an RGB Lightning node, LND (REST URL and macaroon), or any Nostr Wallet Connect wallet. Its balance counts in the portfolio and it appears as a payment source in Send.
The KaleidoSwap Extension automatically locks after a period of inactivity (default: 10 minutes). When locked, you must enter your password to unlock. Configure the timeout in Settings > Security.
Yes. Trusted DApps can request wallet actions through the KaleidoSwap Extension’s browser provider. Review each connection, payment, asset, or signing request before approving it.

​
Get Help

Check the Troubleshooting for errors rather than questions, and Additional Resources for upstream documentation and links. For anything else, report a problem through your preferred channel from the options below, including:
  1. Browser name and version
  2. KaleidoSwap Extension version (Settings > About)
  3. Lightning node type (RGB Lightning node, LND, NWC), if connected
  4. Steps to reproduce
  5. Error messages or screenshots
  6. Diagnostics: Settings > Send Feedback → Append diagnostics to message, or Download diagnostics

Telegram Community

Ask the community.

Report a bug

Bug reports and beta feedback.

Access the Beta

Request access to the KaleidoSwap Extension closed beta.