Skip to main content
This guide explains how to purchase a new Lightning Network channel with outbound liquidity from a KaleidoSwap LSP (Lightning Service Provider). This is particularly useful for users who want to quickly start trading new assets on the platform.

Overview

The Buy Channel wizard has five steps:
  1. LSP Connection.
  2. Configure Channel.
  3. Channel Order.
  4. Payment.
  5. Complete.

Step 1: Connect to LSP

In the sidebar, open Liquidity → Buy Channel. Your account’s LSP appears under Connected LSP (KaleidoSwap LSP on Mutinynet). To use another one, enter its URL under Connect New LSP → LSP server URL and click Fetch LSP Info. Then click Configure Channel.

Step 2: Configure Channel Order

  1. Set Channel Capacity (sats): presets 100k/250k/500k/1M or the slider. The minimum is 50,000 sats; the maximum is the lower of 16,777,215 sats and the LSP’s limit.
  2. Set Outbound Balance, the amount Available to send now that you buy; the rest is what you Can receive. Example: For a 1M sat channel with 700k outbound, you’ll have 300k inbound capacity.
  3. Select how long the LSP needs to guarantee to keep the channel open (channel duration), among the following options:
  • 1 month (4,320 blocks)
  • 3 months (12,960 blocks)
  • 6 months (25,920 blocks)
  1. [Optional] Under Add RGB Asset, pick an asset (e.g. USDT) instead of No Asset and set the amount. You can also buy part of it upfront by setting the asset’s Available to send now; the price comes from a live quote.
Click Review Details, check the Channel Order summary, then click Continue to Payment.

Step 3: Make Payment

To proceed with the channel opening, you will need to execute the payment. You will pay for:
  • Your outbound liquidity, i.e. the funds that you will have immediately available to spend.
  • The LSP service fee, which is different for each provider. Below you can find the fee structure of the default KaleidoSwap LSP.

KaleidoSwap LSP Fee Structure

The form shows the LSP’s live estimate (setup, capacity and duration fees); the figures below are an example. When using KaleidoSwap LSP:
  • Setup fee: 1,000 sats (one-time, per channel)
  • Capacity fee: 1% of total channel capacity
  • Duration fee: 1 sat per block of guaranteed channel lifetime
  • The total fee is capped between a minimum of 2,000 sats and a maximum of 100,000 sats
  • Example calculation:
The Payment step shows Amount to Pay, a Payment expires in countdown, and one Unified payment QR (on-chain + Lightning) with the on-chain address and Lightning invoice beside it. Pay from any external wallet, or click Pay with Wallet Funds, choose Lightning or on-chain (with a fee rate), and confirm with Pay. The amount covers your outbound balance, any asset bought upfront, and the LSP fees.

Step 4: Channel Opening

After payment confirmation:
  1. The LSP initiates channel opening and the order completes.
  2. The channel appears in Manage Channels as Pending until its funding transaction confirms (the LSP advertises around 6 blocks, roughly an hour on mainnet).
  3. Your channel becomes active with the specified:
    • Total capacity.
    • Outbound liquidity.
    • RGB assets (if requested).
    • Lock period.

Order States

Your channel order can be in these states:
  • CREATED: Order accepted by the LSP, waiting for payment and channel opening.
  • COMPLETED: Channel successfully opened.
  • FAILED: An error occurred during the process.
While an order is in the CREATED state, its payment moves through these sub-states:
  • EXPECT_PAYMENT: Waiting for your payment.
  • HOLD: Lightning payment received and held while the channel opens.
  • PAID: Payment settled.
  • TIMEOUT / EXPIRED: No payment arrived in time and the order lapsed.

Refund Policy

If the order fails after payment, an on-chain refund is processed automatically to your wallet. If it has not arrived within 24 hours, contact the LSP with the Order ID shown on the failure screen (Copy Order ID).

Best Practices

  1. Capacity Planning
    • Calculate your required outbound/inbound ratio.
    • Consider future RGB asset needs.
    • Account for fees in your budget.
  2. During Order
    • Keep the application open during payment.
    • Save your order ID.
    • Wait for all the required confirmations.
  3. After Opening
    • Verify channel parameters.
    • Test with small transactions.
    • Monitor channel status.

Support

For assistance:
  1. Check the FAQ
  2. Join our Telegram Group
  3. Open an issue on GitHub

Next: Asset Swaps

Download the Desktop App

Get the latest KaleidoSwap Desktop App release for macOS, Windows, or Linux.