Skip to main content

​
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 a Biscuit/auth token, verify the token is valid
  6. Reconnect from Settings > RGB > RLN node, or Settings > Lightning Node for LND/NWC
Symptoms: Swap feature is disabled or shows connection errorSolutions:
  1. Check that the relevant account is connected
  2. Verify RLN if using KaleidoSwap maker pairs
  3. Verify Spark availability if using Flashnet routes
  4. Try refreshing the swap screen
Symptoms: A DApp does not detect the KaleidoSwap Extension as a walletSolutions:
  1. Ensure the KaleidoSwap Extension is installed and unlocked
  2. Refresh the web page
  3. Check that the extension is enabled for the site
  4. Confirm the DApp uses a standard provider — the KaleidoSwap Extension injects window.webln (WebLN), window.webbtc, window.nostr (NIP-07), window.bitcoin, and window.rgb
  5. Some apps wait for a ready event — the extension dispatches webln:ready, webbtc:ready, nostr:ready, bitcoin:ready, and rgb:ready

​
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 the sending account is online and synced
  5. Try again after a few moments
Symptoms: A Lightning payment shows as pending and Send is blocked for that destinationSolutions:
  1. The wallet keeps checking the payment status for about 3 minutes; wait for it to settle or fail
  2. While the payment is pending, Send stays blocked for that destination so it cannot be paid twice
  3. Check Activity for the final status instead of paying again
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 the KaleidoSwap Extension 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. The KaleidoSwap Extension cannot recover passwords
  2. On the lock screen, select Forgot password? Reset wallet and type RESET to confirm. This erases the wallet from this browser.
  3. Choose Import Existing Wallet and enter your recovery phrase
  4. Set a new password
  5. Restore RGB state (cloud backup prompt or a backup file) and reconnect optional services such as your Lightning node
Symptoms: Stale balances shownSolutions:
  1. Check your node connection status
  2. Tap Refresh balances on the balance card
  3. Close and reopen the extension popup
  4. Verify the node is synced

​
Get Help

Check the FAQ for questions rather than errors, 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.