Skip to main content
When you first launch the app, the welcome screen asks what to run: Node + Mind (default), Only Node or Only Mind. With a node mode you then pick Remote Node (connect to a node you or a provider already run) or Local Node (the app runs one on this device). For a local node you choose a backend: Native Binary (macOS and Linux) or Docker Container (Recommended, all platforms, requires Docker Desktop to be running). This guide follows the local node path.

Create New Wallet

Choose Local Node, select a backend, then click Create New Wallet. Then, you will need proceed with the following steps:
  1. Accept the terms: a Terms & Privacy Policy dialog opens first. Read the linked Terms of Service and Privacy Policy, then click Accept & Continue.
  2. Assign a name to your new account (the shuffle icon generates one) and select the network. Mutinynet is the default; Regtest, Local Regtest, Local Docker Regtest, Signet and Testnet are also listed. Mainnet is not yet selectable. Advanced Settings holds the indexer, RGB proxy and optional Bitcoin Core node. Click Set Password.
  3. Set a Secure Password: enter and confirm a password of at least 8 characters (the checklist also suggests an uppercase letter and a number), then click View Recovery Phrase. This starts and initializes the node on your machine, which takes a moment.
  4. Backup: click the blurred area or Reveal to show your 12-word recovery phrase (make sure no one can see your screen). Write it down and store it offline. Copy works only while the phrase is visible. Click Verify Recovery Phrase. Skip backup (not recommended) is available but leaves you without a verified backup.
  5. Verify: type the full phrase in order (words autocomplete), then click Complete Setup. The node unlocks and the dashboard opens.
After that, some moments will be required to unlock your new local node and you will then land to the home page of KaleidoSwap, ready to start operating with it!
Wallets created with the bundled node of v0.5.0 or earlier, and their backups, cannot be opened by v0.5.1. Before upgrading, close channels and move funds out with v0.5.0, then create a new wallet.

Select Account

If instead of creating a new account you need to select an existing one, you can select it among the ones that has been previously saved on the left menu, even if it has not been initialized. Here is the procedure:
  1. Click the account under Your Accounts on the left.
  2. In the Switch Node dialog, check the connection details and click Switch to This Node.
  3. On Unlock Your Wallet, enter the password and click Unlock Wallet.
Please note that unlocking your node could take a while due to a current limitation experienced in the RGB Lightning Network code. KaleidoSwap home screen with saved accounts in the left menu

Download the Desktop App

Get the latest KaleidoSwap Desktop App release for macOS, Windows, or Linux.