> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kaleidoswap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Key Features

> Core capabilities and features of KaleidoSwap

## Core Capabilities

<CardGroup cols={2}>
  <Card title="RGB Lightning Node Management" icon="server">
    Run your own RGB Lightning node or connect to existing ones
  </Card>

  <Card title="RGB Asset Trading" icon="coins">
    Trade RGB NIA assets instantly on the Lightning Network
  </Card>

  <Card title="Lightning Integration" icon="bolt">
    Fast, low-cost transactions through payment channels
  </Card>

  <Card title="Security First" icon="shield-check">
    Non-custodial architecture with encrypted backups
  </Card>
</CardGroup>

***

## 🚀 RGB Lightning Node Management

### Full Node Control

KaleidoSwap allows you to run a self-hosted RGB Lightning Node or connect to a remote one.

<Tabs>
  <Tab title="Run Your Own Node">
    **Self-Hosted RGB Lightning Node**

    Take full control of your infrastructure with a locally running node.

    * Maximum privacy
    * Direct P2P connections
    * No reliance on third parties

    ```bash theme={null}
    # Start your RGB Lightning node
    kaleidoswap-node start
    ```
  </Tab>

  <Tab title="Connect to Existing Node">
    **Remote Node Connection**

    Connect to a professionally hosted node or your own remote server.

    * Access from multiple devices
    * Managed infrastructure options
    * Connect via REST, gRPC, or WebSocket
  </Tab>
</Tabs>

### Node Features

<AccordionGroup>
  <Accordion title="Channel Management" icon="network-wired">
    * Open/close Lightning channels
    * Monitor channel states
    * Rebalance liquidity
    * Set channel policies
  </Accordion>

  <Accordion title="Asset Allocation" icon="layer-group">
    * Allocate RGB assets to channels
    * Multi-asset channel support
    * Asset-specific routing
    * Balance tracking per asset
  </Accordion>

  <Accordion title="Automated Backups" icon="cloud-arrow-up">
    * Encrypted channel backups
    * Automatic backup scheduling
    * Cloud or local storage
    * One-click restore
  </Accordion>

  <Accordion title="Monitoring & Alerts" icon="bell">
    * Real-time node monitoring
    * Channel status alerts
    * Payment notifications
    * Performance metrics
  </Accordion>
</AccordionGroup>

***

## 💱 RGB Asset Trading

### Atomic Swaps

Execute trustless, instant asset swaps without intermediaries.

**Supported Swap Types**:

<CardGroup cols={3}>
  <Card title="Lightning to Lightning" icon="bolt">
    **Instant RGB Asset Swaps**
    Swap RGB assets (like USDT) directly for BTC through Lightning channels.
  </Card>

  <Card title="On-Chain to Lightning" icon="arrow-right-arrow-left">
    **Liquidity Management**
    Open channels with your on-chain funds for instant trading.
  </Card>

  <Card title="Lightning to On-Chain" icon="bitcoin">
    **Settlement**
    Move assets from Lightning channels back to the Bitcoin blockchain for cold storage.
  </Card>
</CardGroup>

### Trading Features

<Steps>
  <Step title="Real-Time Quotes">
    Get live market rates for asset pairs with price impact calculations
  </Step>

  <Step title="Slippage Protection">
    Configure maximum acceptable slippage for trades
  </Step>

  <Step title="Order History">
    Track all your swaps with detailed execution data
  </Step>

  <Step title="Multiple LSP Support">
    Connect to multiple liquidity providers for best rates
  </Step>
</Steps>

<Note>
  Asset availability depends on connected LSP. Different LSPs may support different asset sets.
</Note>

***

## ⚡ Lightning Network Integration

### Fast & Low-Cost Transactions

Leverage the Lightning Network for high-performance trading.

<CardGroup cols={2}>
  <Card title="Instant Settlement" icon="bolt-lightning">
    Transactions complete in milliseconds with immediate balance updates.
  </Card>

  <Card title="Minimal Fees" icon="coins">
    Pay a fraction of on-chain costs, making micro-transactions viable.
  </Card>

  <Card title="High Throughput" icon="gauge-high">
    Execute millions of transactions per second without blockchain bottlenecks.
  </Card>

  <Card title="Privacy Enhanced" icon="user-shield">
    Off-chain transactions with onion routing for maximum privacy.
  </Card>
</CardGroup>

### Channel Operations

#### Opening Channels

1. **Select LSP or Peer**
2. **Choose Channel Capacity**
3. **Allocate RGB Assets** (optional)
4. **Set Channel Parameters**
5. **Confirm and Open**

**Channel Options**:

* **Public Channels**: Participate in routing, earn fees
* **Private Channels**: Direct payments only, more privacy
* **Anchor Channels**: Use anchor outputs for security
* **Zero Reserve**: Spend full channel capacity

#### Managing Liquidity

<Tabs>
  <Tab title="Inbound Liquidity">
    **Receive Payments**

    Get inbound liquidity from LSPs:

    * Order channels with inbound capacity
    * Submarine swaps
    * Lightning Service Provider services
  </Tab>

  <Tab title="Outbound Liquidity">
    **Send Payments**

    Ensure outbound capacity:

    * Fund channels with on-chain deposit
    * Receive payments to build inbound
    * Channel rebalancing services
  </Tab>

  <Tab title="Circular Rebalancing">
    **Optimize Channels**

    Balance channel liquidity:

    * Pay yourself through different route
    * Maintain optimal channel states
    * Automated rebalancing bots
  </Tab>
</Tabs>

***

## 🔒 Security Features

### Non-Custodial Architecture

KaleidoSwap is built on the principle of "Your Keys, Your Coins".

<Check>
  ✓ **Private keys never leave your device**
</Check>

<Check>
  ✓ **No third-party access to funds**
</Check>

<Check>
  ✓ **Complete control over transactions**
</Check>

<Check>
  ✓ **Trustless trading protocol via atomic swaps**
</Check>

### Secure Key Management

**Encryption Layer**:

* **Software Wallet**
  * AES-256 Encryption
  * Password Protection
  * Mnemonic Backup
* **Hardware Wallet Support (Soon)**
  * Ledger
  * Trezor

### Channel Backups

<Steps>
  <Step title="Automatic Backups">
    Channels are automatically backed up after every state change
  </Step>

  <Step title="Encrypted Storage">
    Backups are encrypted with your password before storage
  </Step>

  <Step title="Multiple Locations">
    Save backups locally and to cloud storage for redundancy
  </Step>

  <Step title="Easy Restore">
    Restore channels with mnemonic phrase + backup file
  </Step>
</Steps>

### Security Best Practices

<Warning>
  **Important Security Tips**:

  * Always verify binary signatures before installation
  * Store your mnemonic phrase securely offline
  * Use strong, unique passwords
  * Enable automatic backups
  * Keep your software updated
</Warning>

***

## 🎯 Additional Features

### User Interface

<CardGroup cols={2}>
  <Card title="Intuitive Design" icon="paintbrush">
    Clean, modern interface designed for both beginners and power users
  </Card>

  <Card title="Dark Mode" icon="moon">
    Easy on the eyes with beautiful dark theme support
  </Card>

  <Card title="Multi-Platform" icon="desktop">
    Available for macOS, Windows, and Linux
  </Card>

  <Card title="Real-Time Updates" icon="arrows-rotate">
    Live balance updates, market data, and notifications
  </Card>
</CardGroup>

### Developer Tools

For developers building on KaleidoSwap:

<Tabs>
  <Tab title="Python SDK">
    ```python theme={null}
    from kaleido_sdk import KaleidoClient

    client = KaleidoClient.create(
        base_url="https://api.signet.kaleidoswap.com"
    )
    pairs = client.maker.list_pairs()
    quote = client.maker.get_quote({
        "from_asset": {"asset_id": "BTC", "layer": "BTC_LN", "amount": 100000},
        "to_asset": {"asset_id": "USDT", "layer": "RGB_LN"}
    })
    ```

    [Explore Python SDK →](/sdk/introduction)
  </Tab>

  <Tab title="TypeScript SDK">
    ```typescript theme={null}
    import { KaleidoClient } from 'kaleido-sdk';

    const client = KaleidoClient.create({
      baseUrl: 'https://api.signet.kaleidoswap.com'
    });
    const pairs = await client.maker.listPairs();
    const quote = await client.maker.getQuote({
      from_asset: { asset_id: 'BTC', layer: 'BTC_LN', amount: 100000 },
      to_asset: { asset_id: 'USDT', layer: 'RGB_LN' }
    });
    ```

    [Explore TypeScript SDK →](/sdk/introduction)
  </Tab>

  <Tab title="REST API">
    ```bash theme={null}
    curl https://api.signet.kaleidoswap.com/api/v1/market/pairs
    ```

    [Explore API Reference →](/api-reference/introduction)
  </Tab>
</Tabs>

### Advanced Features

<AccordionGroup>
  <Accordion title="WebSocket Streaming" icon="bolt">
    Real-time market data and quote updates via WebSocket connections
  </Accordion>

  <Accordion title="Multi-Asset Channels" icon="layer-group">
    Allocate multiple RGB assets to a single Lightning channel
  </Accordion>

  <Accordion title="Custom Fee Policies" icon="sliders">
    Set your own routing fees for public channels
  </Accordion>

  <Accordion title="Payment Routing" icon="route">
    Automatic optimal path finding for Lightning payments
  </Accordion>

  <Accordion title="Invoice Management" icon="file-invoice">
    Create, track, and manage Lightning invoices
  </Accordion>

  <Accordion title="Transaction History" icon="clock-rotate-left">
    Complete history of all swaps, payments, and channel operations
  </Accordion>
</AccordionGroup>

***

## Coming Soon

<Info>
  **Upcoming Features**:

  * Mobile app (iOS & Android)
  * Hardware wallet integration
  * Advanced trading features (limit orders, DCA)
  * Multi-signature wallet support
  * More RGB asset types (UDA NFTs, CFA collectibles, IFA inflatable assets)
</Info>

## Get Started

<Card title="Desktop App" icon="download" href="/desktop-app/getting-started/installation">
  Install KaleidoSwap and start trading with atomic swaps
</Card>
