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

# Getting Started

> Create or import a KaleidoSwap Extension wallet and choose your network accounts

## Onboarding

When you first open the KaleidoSwap Extension, the onboarding flow guides you through initial setup.

<img src="https://mintcdn.com/kaleidoswap/5xy3HFtNZLAeg5m3/images/kaleidoswap-extension/01-welcome.png?fit=max&auto=format&n=5xy3HFtNZLAeg5m3&q=85&s=06c60e7e2618b47e78d0e153e55a88a6" alt="KaleidoSwap Extension welcome screen" style={{ maxWidth: "360px", width: "100%", height: "auto" }} width="800" height="1688" data-path="images/kaleidoswap-extension/01-welcome.png" />

<Steps>
  <Step title="Welcome">
    Choose **Create New Wallet** or **Import Existing Wallet**.
  </Step>

  <Step title="Create a Password">
    Set a secure password to protect your wallet. This password is used to:

    * Unlock the extension after it auto-locks
    * Encrypt your stored wallet data

    Choose a strong password and remember it (this cannot be recovered).
  </Step>

  <Step title="Back Up the Recovery Phrase">
    The KaleidoSwap Extension generates a 12-word recovery phrase for new wallets. This phrase controls Spark, Arkade, and the Nostr identity derived by the extension.
  </Step>

  <Step title="Choose RGB Lightning">
    Decide whether to connect an RGB Lightning Node during onboarding. RLN support is optional and experimental; Spark and Arkade can be used without it.
  </Step>

  <Step title="Done">
    Continue to the wallet. The KaleidoSwap Extension starts with Spark and Arkade accounts and adds RLN features when you connect a node.
  </Step>
</Steps>

<img src="https://mintcdn.com/kaleidoswap/5xy3HFtNZLAeg5m3/images/kaleidoswap-extension/02-password.png?fit=max&auto=format&n=5xy3HFtNZLAeg5m3&q=85&s=732362240173fd7071d010f89d6b5873" alt="KaleidoSwap Extension password step" style={{ maxWidth: "360px", width: "100%", height: "auto" }} width="800" height="1688" data-path="images/kaleidoswap-extension/02-password.png" />

## RGB Lightning Node

RLN is optional. Connect it if you want RGB assets, RGB invoices, RGB Lightning channels, or maker-based RGB swaps.

<img src="https://mintcdn.com/kaleidoswap/5xy3HFtNZLAeg5m3/images/kaleidoswap-extension/04-rln-optional.png?fit=max&auto=format&n=5xy3HFtNZLAeg5m3&q=85&s=8225b5794a5846cf2b289019174431a5" alt="KaleidoSwap Extension RLN opt-in" style={{ maxWidth: "360px", width: "100%", height: "auto" }} width="800" height="1688" data-path="images/kaleidoswap-extension/04-rln-optional.png" />

### Connection Details

When opting in, enter:

* **RLN Node URL** - The node endpoint, such as `http://localhost:3001`
* **Biscuit token** - Optional authentication token when your node requires one

<img src="https://mintcdn.com/kaleidoswap/5xy3HFtNZLAeg5m3/images/kaleidoswap-extension/05-rln-connect.png?fit=max&auto=format&n=5xy3HFtNZLAeg5m3&q=85&s=e6842b568052dd1d39d9a2ee0429b919" alt="KaleidoSwap Extension RLN connection form" style={{ maxWidth: "360px", width: "100%", height: "auto" }} width="800" height="1688" data-path="images/kaleidoswap-extension/05-rln-connect.png" />

<Note>
  RGB Lightning is shown as an experimental test-network feature in onboarding. You can skip it and connect later from Settings.
</Note>

## Dashboard Overview

After setup, the dashboard shows account status and assets across the connected protocols.

<img src="https://mintcdn.com/kaleidoswap/5xy3HFtNZLAeg5m3/images/kaleidoswap-extension/08-dashboard.png?fit=max&auto=format&n=5xy3HFtNZLAeg5m3&q=85&s=afc193b9ca5a3322a2e63a12da774183" alt="KaleidoSwap dashboard" style={{ maxWidth: "360px", width: "100%", height: "auto" }} width="800" height="1688" data-path="images/kaleidoswap-extension/08-dashboard.png" />

### Account Status

The dashboard surfaces Spark, Arkade, and RLN account state. Each account shows whether it is ready, offline, optional, or still syncing.

### Asset Filters

Use the asset and network filters to focus on:

* BTC across all protocols
* Spark assets
* Arkade assets
* RGB assets when RLN is connected
* Bitcoin L1, Lightning, Spark, and Arkade network slices

### Actions

| Action       | Description                                                                    |
| ------------ | ------------------------------------------------------------------------------ |
| **Deposit**  | Generate a receive address or invoice for the selected asset and account route |
| **Withdraw** | Send to a detected destination type through the best compatible route          |
| **Swap**     | Open the in-extension swap interface                                           |

## Lock and Unlock

### Auto-Lock

The KaleidoSwap Extension automatically locks after a period of inactivity. When locked, the extension requires your password before it decrypts the mnemonic in memory again.

### Manual Lock

Use **Settings > Lock Wallet** to lock immediately.

### Changing Lock Timeout

Go to **Settings > Preferences** to adjust the auto-lock timeout and Bitcoin unit display.

<img src="https://mintcdn.com/kaleidoswap/5xy3HFtNZLAeg5m3/images/kaleidoswap-extension/06-wallet-ready.png?fit=max&auto=format&n=5xy3HFtNZLAeg5m3&q=85&s=1b48dc89682a80dec5511f06f7d41963" alt="KaleidoSwap Extension ready" style={{ maxWidth: "360px", width: "100%", height: "auto" }} width="800" height="1942" data-path="images/kaleidoswap-extension/06-wallet-ready.png" />

## Next Steps

<CardGroup cols={2}>
  <Card title="Wallet Features" icon="wallet" href="/extensions/kaleidoswap-extension/wallet-features">
    Send, receive, and manage assets
  </Card>

  <Card title="Swaps" icon="arrows-rotate" href="/extensions/kaleidoswap-extension/swaps">
    Swap assets within the extension
  </Card>

  <Card title="DApp Connectivity" icon="plug" href="/extensions/kaleidoswap-extension/dapp-connectivity">
    Use the KaleidoSwap Extension with trusted DApps and Nostr
  </Card>

  <Card title="FAQ" icon="circle-question" href="/extensions/kaleidoswap-extension/faq">
    Common questions and troubleshooting
  </Card>
</CardGroup>
