Skip to main content

​
Onboarding

When you first open Rate, the onboarding flow guides you through initial setup.
1

Welcome

The welcome screen introduces Rate. Click Get Started to begin.
2

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 — it cannot be recovered.
3

Nostr Key Setup

Rate generates a Nostr keypair for identity and signing:
  • Generate new - A fresh keypair is created automatically
  • Import existing - Enter your existing Nostr private key (nsec)
Your Nostr keys enable NIP-07 signing for Nostr-based applications.
4

Connect to Your Node

Enter your RGB Lightning Node (RLN) connection details:
  • Node URL - The URL of your RLN (e.g., http://localhost:3001)
  • JWT Token (optional) - Authentication token if your node requires it
Rate connects to your node via the Kaleidoswap SDK to manage wallets, assets, and payments.
5

Done

Your wallet is ready. You are taken to the dashboard.
An RGB Lightning Node (RLN) connection is required for core wallet features. Without a node, you cannot view balances, send, or receive assets.

​
Connecting to an RGB Lightning Node

​
Node URL

Enter the URL where your RGB Lightning Node is running. Common configurations:
SetupURL
Local nodehttp://localhost:3001
Remote nodehttps://your-node.example.com

​
Authentication

If your node requires authentication, enter the JWT token in the authentication field. This is optional for nodes without auth configured.

​
Connection History

Rate saves your last 10 node connections for quick switching. Access them from Settings > Networks.

​
Connection Status

After connecting, the dashboard shows the node connection status:
  • Connected - Node is reachable and synced
  • Disconnected - Unable to reach the node

​
Maker API Connection (Optional)

To enable swap functionality, Rate optionally connects to the Kaleidoswap maker API:
  • Default URL: https://api.regtest.kaleidoswap.com
  • Configurable in Settings > Networks
The maker connection is not required for core wallet features. Without it, send, receive, and asset management work normally, but the swap feature is disabled.

​
Dashboard Overview

After setup, the dashboard shows:

​
Balance Card

  • Total BTC balance across all layers
  • Breakdown: on-chain BTC and Lightning BTC

​
Action Buttons

ActionDescription
DepositReceive BTC on-chain
WithdrawSend BTC on-chain
ReceiveGenerate a Lightning or RGB invoice
SwapSwap between BTC and RGB assets

​
Asset List

  • Lists all RGB-20 tokens with balances
  • Filter by layer: All Assets, On-chain, Lightning
  • Tap an asset to see details (ticker, name, precision, balance breakdown)

​
Activity Tab

  • View recent transactions
  • Filter by type and status
  • Click a transaction for details

​
Lock and Unlock

​
Auto-Lock

Rate automatically locks after a period of inactivity (default: 10 minutes). When locked, the extension shows a lock screen requiring your password.

​
Manual Lock

Click the lock icon in the extension header to lock immediately.

​
Changing Lock Timeout

Go to Settings > Preferences to adjust the auto-lock timeout.

​
Next Steps

Wallet Features

Send, receive, and manage assets

Swaps

Swap assets within the extension

DApp Connectivity

Use Rate with web apps and Nostr

FAQ

Common questions and troubleshooting