Skip to main content

​
Frequently Asked Questions

Rate is a Chrome extension and works on all Chromium-based browsers:
  • Google Chrome
  • Brave
  • Microsoft Edge
  • Opera
Firefox and Safari are not yet supported.
Yes. Rate connects to an RGB Lightning Node (RLN) for core wallet functionality. Without a node connection, you cannot view balances, send, or receive assets.You can connect to:
  • A local node running on your machine
  • A remote node accessible via URL
No. Rate connects to your RGB Lightning Node. Your keys and funds are managed by your node, not by Rate or KaleidoSwap. Rate is a user interface for your node.
No. The maker API connection is optional. Without it:
  • Send, receive, and balance features work normally
  • Only the swap feature is disabled
Rate supports:
  • BTC - Bitcoin (on-chain and Lightning)
  • RGB-20 tokens - Any RGB-20 asset on your node (e.g., USDT, XAUT)
Additional protocol support (Spark, Arkade, Liquid) is planned.
Go to Settings > Backup Wallet to export your wallet data. You should also separately back up:
  • Your Nostr private key (nsec) from Settings > Nostr Account
  • Your node seed phrase (managed by your node, not Rate)
Rate cannot recover your password. If you forget it, you will need to:
  1. Uninstall and reinstall the extension
  2. Set up a new password
  3. Reconnect to your node
Your funds are safe on your node — only the local extension data is lost.
Rate connects to one node at a time. You can switch between nodes in Settings > Networks using the connection history (last 10 connections are saved).
Rate automatically locks after a period of inactivity (default: 10 minutes). When locked, you must enter your password to unlock. Configure the timeout in Settings > Preferences.
Yes. Rate works as a wallet for the web app:
  1. Connect Rate on app.kaleidoswap.com
  2. Create swap orders in the web app
  3. Pay deposit invoices directly from Rate using the “Pay with Wallet” button

​
Troubleshooting

​
Connection Issues

Symptoms: Connection fails or shows “Disconnected”Solutions:
  1. Verify the node URL is correct
  2. Check that the node is running and accessible
  3. If using a local node, ensure it is running on the expected port
  4. If using a remote node, check network/firewall settings
  5. If using JWT auth, verify the token is valid
  6. Try disconnecting and reconnecting in Settings > Networks
Symptoms: Swap feature is disabled or shows connection errorSolutions:
  1. Check the maker URL in Settings > Networks
  2. Verify the maker API is accessible
  3. The maker connection is non-blocking — the extension still works without it
  4. Try refreshing the connection
Symptoms: Web apps don’t detect Rate as a walletSolutions:
  1. Ensure Rate is installed and unlocked
  2. Refresh the web page
  3. Check that the extension is enabled for the site
  4. Some apps look for window.webln — Rate provides window.rgbwebln
  5. The KaleidoSwap Web App specifically supports Rate

​
Payment Issues

Symptoms: Send payment shows errorSolutions:
  1. Check your balance is sufficient
  2. Verify the destination is correct
  3. For Lightning, ensure there is a route to the destination
  4. Check that your node is online and synced
  5. Try again after a few moments
Symptoms: Cannot generate receive invoiceSolutions:
  1. Check your node connection
  2. Ensure the node has inbound liquidity (for Lightning)
  3. Try generating a different type (on-chain instead of Lightning)
  4. Restart the extension and try again

​
Extension Issues

Symptoms: Clicking the icon does nothing or shows blank popupSolutions:
  1. Go to chrome://extensions and check Rate is enabled
  2. Try disabling and re-enabling the extension
  3. Clear browser cache
  4. Restart the browser
  5. For manual installs, try reloading the extension
Symptoms: Cannot unlock the extensionSolutions:
  1. Rate cannot recover passwords
  2. Uninstall the extension and reinstall
  3. Set up a new password and reconnect to your node
  4. Your funds are safe on the node — only local extension data is lost
Symptoms: Stale balances shownSolutions:
  1. Check your node connection status
  2. Pull down to refresh on the dashboard
  3. Close and reopen the extension popup
  4. Verify the node is synced

​
Getting Help

Telegram Community

Join our community for quick help

GitHub Issues

Report bugs or request features

Email Support

Direct support for urgent issues

Documentation

Browse Rate documentation

​
Reporting Issues

When reporting problems, include:
  1. Browser name and version
  2. Rate extension version (Settings > About)
  3. Node type and version
  4. Steps to reproduce
  5. Error messages or screenshots
  6. Console logs (right-click extension popup > Inspect > Console)