Skip to main content
Fixes for the problems KaleidoSwap Extension users hit most often. For issues across every KaleidoSwap surface, see the full troubleshooting guide.

​
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. Try disconnecting and reconnecting in Settings > Networks
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, and window.nostr (NIP-07)
  5. Some apps wait for a ready event — the extension dispatches webln:ready, webbtc:ready, and nostr: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 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 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. Uninstall the extension and reinstall
  3. Import your recovery phrase
  4. Set up a new password and reconnect optional services
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

​
Get Help

Check the FAQ for questions rather than errors. 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. Node type and version
  4. Steps to reproduce
  5. Error messages or screenshots
  6. Console logs (right-click extension popup > Inspect > Console)

Telegram Community

Ask the community.

GitHub Issues

Report a bug on the relevant repository.

Email Support

Direct support for urgent issues.

Access the Beta

Request access to the KaleidoSwap Extension closed beta.