General Questions
What is KaleidoSwap?
KaleidoSwap is an open-source desktop application that enables trading of RGB assets on the Lightning Network. It provides a user-friendly interface for managing RGB Lightning nodes and connecting to Lightning Service Providers (LSPs).What assets can I trade on KaleidoSwap?
Currently, KaleidoSwap supports RGB20 assets on the Lightning Network. These are client-validated smart contracts on Bitcoin that represent fungible tokens.Is KaleidoSwap custodial?
No, KaleidoSwap is non-custodial. You maintain full control of your private keys and assets at all times. The application provides secure key management and encrypted backups.Technical Questions
Do I need to run my own RGB Lightning node?
No, you have two options:- Run your own RGB Lightning node
- Connect to existing nodes through the application
How does the trading protocol work?
KaleidoSwap uses a taker-maker model for trading:- Makers provide liquidity and set prices
- Takers can view real-time price updates
- Trades are executed through atomic swaps via RLN API
- All trades are secured by Lightning Network and RGB Protocol
Why can’t I trade all the sats on my side of the channel?
There are two protocol limits in place:- Dust reserve (3,000 sats): In RGB Lightning swaps, the taker (you) must always send 3,000 sats to the maker as part of the swap. These sats aren’t lost — they act as a temporary “dust amount.” When the maker completes the HTLC and sends assets back, you also receive 3,000 sats with the assets on top. So, you need to keep at least 3,000 sats untradeable in your balance to make the swap process work.
- Per-swap limit (10%): You can only trade up to 10% of the total channel capacity in a single swap.
Security
How secure are my assets?
KaleidoSwap implements multiple security measures:- Non-custodial architecture
- Encrypted channel backups
- Secure key management
- Trustless trading protocol
- Client-side validation for RGB assets
Are my trades private?
Yes, KaleidoSwap prioritizes privacy:- Channel operations can be private
- Trade details are only known to participants
- No KYC required for basic operations
Troubleshooting
What should I do if a trade fails?
If a trade fails:- Check your channel liquidity
- Verify the RGB asset details
- Ensure your node is properly synced
- Contact support if issues persist
How do I restore my wallet?
To restore your wallet:- Use the backup file you created
- Decrypt the backup file with your password
- Wait for the node to sync
Why can’t I connect to an LSP?
Common connection issues:- Network connectivity problems
- Incorrect node configuration
- LSP maintenance
- Insufficient channel capacity
Getting Started
What do I need to start trading?
To start trading on KaleidoSwap:- Install the desktop application
- Create or import a wallet
- Fund your wallet with Bitcoin
- Open Lightning channels
- Acquire RGB assets
How do I get RGB assets?
You can acquire RGB assets by:- Trading through KaleidoSwap
- Connecting to RGB LSPs
- Participating in RGB token distributions
What are the minimum requirements?
Minimum requirements for running KaleidoSwap:- Modern operating system (Windows, macOS, Linux)
- 2GB RAM minimum (4GB recommended)
- Stable internet connection
- Sufficient storage for blockchain data if running a full node
Support
Where can I get help?
Support channels:How do I report bugs?
To report bugs:- Check existing GitHub issues
- Provide detailed reproduction steps
- Include relevant logs and system information
- Submit through GitHub issues