Builder's Guide
  • Welcome to the Builder's Guide to the LND Galaxy!
  • The Lightning Network
    • Overview
    • Payment Channels
      • Lifecycle of a Payment Channel
      • Watchtowers
      • Understanding Sweeping
      • Etymology
    • The Gossip Network
      • Identifying Good Peers on the Lightning Network
    • Pathfinding
      • Finding routes in the Lightning Network
      • Channel Fees
      • Multipath Payments (MPP)
    • Lightning Network Invoices
      • Understanding Lightning Invoices
    • Making Payments
      • The Payment Cycle
      • Timelocks
      • ⭐Hashed Timelock Contract (HTLC)
      • Payment Etymology
      • ⭐What Makes a Good Routing Node
      • Understanding Submarine Swaps
      • Instant Submarine Swaps
    • Liquidity
      • ⭐Understanding Liquidity
      • Managing Liquidity on the Lightning Network
      • Liquidity Management for Lightning Merchants
      • How to Get Inbound Capacity on the Lightning Network
      • Lightning Service Provider
    • L402: Lightning HTTP 402 Protocol
      • Macaroons
      • L402
      • 📋Protocol Specification
      • Implementations and Links
    • Taproot Assets
      • Taproot Assets Protocol
      • Taproot Assets on Lightning
      • Edge Nodes
      • Taproot Assets Trustless Swap
      • FAQ
      • Glossary
  • Lightning Network Tools
    • LND
      • 🛠️Get Started
      • lnd.conf
      • First Steps With LND
      • Wallet Management
      • Sending Payments
      • Atomic Multi-path Payments (AMP)
      • Receiving Payments
      • Unconfirmed Bitcoin Transactions
      • Channel Fees
      • Inbound Channel Fees
      • Macaroons
      • Configuring Watchtowers
      • Pathfinding
      • Blinded Paths
      • Key Import
      • Secure Your Lightning Network Node
      • Configuration of a Routing Node
      • Quick Tor Setup
      • Configuring Tor
      • Enable ‘Neutrino mode’ in Bitcoin Core
      • Send Messages With Keysend
      • Partially Signed Bitcoin Transactions
      • Bulk onchain actions with PSBTs
      • Sweeper
      • Debugging LND
      • Fuzzing LND
      • LND API documentation
      • Channel Acceptor
      • RPC Middleware Interceptor
      • HTLC Interceptor
      • NAT Traversal
      • Recovery: Planning for Failure
      • Migrating LND
      • Disaster recovery
      • Contribute to LND
    • Lightning Terminal
      • What is Lightning Terminal?
      • 🛠️Get litd
      • Run litd
      • Integrating litd
      • Demo: Litd Speed Run
      • Connect to Terminal
      • Recommended Channels
      • Rankings
      • Health Checks
      • Liquidity Report
      • Opening Lightning Network Channels
      • Managing Channel Liquidity
      • Autofees
      • AutoOpen
      • LND Accounts
      • Loop and Lightning Terminal
      • Loop Fees
      • Pool and Lightning Terminal
      • Command Line Interface
      • Troubleshooting
      • Lightning Node Connect: Under the hood
      • LNC Node Package
      • LITD API Documentation
      • Privacy and Security
      • Privacy Policy
      • Terms of Use
    • Loop
      • 🛠️Get Started
      • The Loop CLI
      • Autoloop
      • Static Loop In Addresses
      • Instant Loop Outs
      • Peer with Loop
      • Loop API Documentation
    • Pool
      • Overview
      • Quickstart
      • 🛠️Installation
      • First Steps
      • Accounts
      • Orders and Asks
      • Sidecar Channels
      • Zero-confirmation Channels
      • Channel Leases
      • Batch Execution
      • Account Recovery
      • Pool API Documentation
      • FAQs
    • Taproot Assets
      • Get Started
      • First Steps
      • Taproot Assets Channels
      • Asset Decimal Display
      • Become an Edge Node
      • RFQ
      • Collectibles
      • Universes
      • Asset Loop
      • Debugging Tapd
      • Multisignature
      • Minting Assets With an External Signer
      • Lightning Polar
      • Operational Safety Guidelines
      • Taproot Assets API Documentation
    • Aperture
      • ⚒️Get Aperture
      • LNC Backend
      • LNC Mailbox
      • Pricing
    • Faraday
      • 🛠️Get Started
      • The Faraday CLI
      • Faraday API Documentation
  • LAPPs
    • Guides
      • Use Polar to Build Your First LAPP
        • Setup: Local Cluster with Polar
        • Setup: Run the Completed App
        • Setup: Run the App Without LND
      • Add Features
        • Feature 1: Connect to LND
        • Feature 2: Display Node Alias and Balance
        • Feature 3: Sign and Verify Posts
        • Feature 4: Modify Upvote Action
      • Make Your own LNC-powered Application
    • Next Steps
  • Community Resources
    • Resource List
    • Lightning Bulb 💡
    • Glossary
    • FAQ
Powered by GitBook
On this page
  • General
  • What happens when I buy inbound channel liquidity?
  • How is the price of inbound channel liquidity determined?
  • How much will I pay for a purchased channel?
  • How will I know if my order was fulfilled?
  • How soon after my order is filled will the seller open a channel to me?
  • Can I buy a channel for someone else?
  • Channels
  • How is the channel opened?
  • How long will the channel stay open?
  • Does the channel close after the maturity date?
  • Is there a way to ensure that the channels are of a certain size?
  • Are there limits on what I can do with the channel?
  • What happens if the seller force closes a channel before the maturity date?
  • If off-chain funds have moved over to my side, must I keep them there?
  • Accounts
  • How do I create an account?
  • Why do accounts expire?
  • What do I do if my account expires?
  • Matching
  • Can I choose who to buy from?
  • Can sellers choose their buyers or blacklist certain buyers?
  • Will I be matched to Tor nodes as a clearnet buyer?
  • What is my recourse if the peer goes offline or has other issues?
  • Fees
  • What are the fees for using Pool?
  • Who pays the on-chain fees?
  • Who earns the routing fees from the channel that is opened with me?
  • Can the seller increase their fee rate after opening the channel?
  • Can I specify the maximum fee rate of a peer I’m buying liquidity from?
  • Technical questions
  • How do I buy a channel?
  • How do I see the channel I bought?
  • Do I need to keep poold running the whole time?
  • I want to move poold to another machine, what files do I need to move?

Was this helpful?

  1. Lightning Network Tools
  2. Pool

FAQs

Lightning Pool is a non-custodial, peer-to-peer marketplace for Lightning node operators to buy and sell inbound channel liquidity.

General

What happens when I buy inbound channel liquidity?

A channel is opened to you after paying an upfront premium for inbound channel liquidity of a specific size for a set duration of time (2016 blocks). Once the upfront premium is paid a channel is opened to the buyer.

How is the price of inbound channel liquidity determined?

Set your buy price to according to the time you are willing to wait for a match and of course your own internal cost and benefit analysis.

If there is a market match, you will pay the lower of the two prices between the bid and the ask.

How much will I pay for a purchased channel?

You pay based on a percentage across time and it is not quite straightforward to describe the cost, so allow the software to calculate the cost for you and you will be able to confirm it.

If you want to pay a specific amount, use trial and error of creating bids until the confirmation shows you your desired fee payment size.

It will not show you an exact total, but you can see how much you will pay in fee to the seller in the confirmation, in the confirmation the seller is called the “maker”

How will I know if my order was fulfilled?

You can check the status of your order at any time by running the following command:

pool orders list

How soon after my order is filled will the seller open a channel to me?

A channel will be opened as soon as the batch transaction has received a sufficient number of confirmations. Batches are processed whenever the market clears or approximately every 10 minutes or whichever is longer.

The seller has to be online when the batch clears or the match won't be included

Can I buy a channel for someone else?

Not at this time but this is something we plan to add in the future.

Channels

How is the channel opened?

The channel is opened automatically by the seller once the market clears.

How long will the channel stay open?

It will stay open for a minimum of 2016 blocks (approximately 2 weeks).

Does the channel close after the maturity date?

No, it will remain open but the seller has no obligation to keep the channel open beyond the maturity date.

Is there a way to ensure that the channels are of a certain size?

You can specify a minimum allowable channel size which will ensure that you receive one or more inbound channels greater than or equal to the size you specified.

Are there limits on what I can do with the channel?

No. The channel behaves like a regular channel.

What happens if the seller force closes a channel before the maturity date?

If the lender force closes they will be banned from the market. This will not be possible in the future.

If off-chain funds have moved over to my side, must I keep them there?

If you cannot or do not want to move the funds out of the channel off-chain, you can close the channel before the term limit with no penalties.

Accounts

How do I create an account?

Opening an account requires first funding your lnd wallet and subsequently funding a time-locked 2-of-2 multi-sig account. This account is then debited whenever an order of is fully or partially matched.

When creating an account you must specify a time-lock so that you can gain access to your funds in the event that Pool is offline for a period of time. The account will expire once the specified amount of time has elapsed.

Why do accounts expire?

This is necessary so that users can recover funds in the event our servers were to go offline for a period of time.

What do I do if my account expires?

You will need to close your account and then re-open your account. In the future we will enable account renewals.

Matching

Can I choose who to buy from?

You are not able to choose who to buy from but by default only well-connected nodes who are on the Bos Score List are eligible to sell liquidity.

Can sellers choose their buyers or blacklist certain buyers?

A seller cannot avoid selling to a specific peer. All peers on the network are valid buyers.

Will I be matched to Tor nodes as a clearnet buyer?

Yes. They will be responsible for connecting to your node.

What is my recourse if the peer goes offline or has other issues?

In the future this node may be removed from the market.

Fees

What are the fees for using Pool?

Buyers and sellers of channels should expect service charges of 5-25 basis points each.

Who pays the on-chain fees?

When the channel is opened, the cost of opening the channel is split between the buyer and seller. When closing the channel, the rules are the same as with any other LN channel: The initiator (in the Pool case the seller) pays the closing fee.

This will be different with anchor output channels however, once they are rolled out by default (they're still experimental and need to be opt in). With those, the party initiating the force close will pay the chain fee for doing so.

Who earns the routing fees from the channel that is opened with me?

The seller earns the routing fees. You can also earn fees if that new channel is used by a routing node.

Can the seller increase their fee rate after opening the channel?

Yes they can adjust their routing policy however this will be penalized in the future.

Can I specify the maximum fee rate of a peer I’m buying liquidity from?

Not at this time but this is something we plan to add in the future.

Technical questions

How do I buy a channel?

orders submit bid --amt 100000000 --acct_key 03b5ef9a2ab19502fbb1f72d597d772eff1db1c9f8713fbe0685009a882f7c01b6 --max_batch_fee_rate 253 --interest_rate_percent 0.0001
  • amt is the total amount of inbound liquidity being bid on.

  • Key is the “trader key” from “accounts list”

  • Max batch fee rate is what you want to pay as part of the channel creation (you will pay for half of the open fees as the buyer)

How do I see the channel I bought?

accounts leases
  • This includes the capacity: channel_amt_sat

  • How much you paid to the seller: premium_sat

  • How much you paid to the service: execution_fee_sat

Do I need to keep poold running the whole time?

To participate in an auction, the poold trader daemon needs to be in constant communication with the auction server to validate and then sign potential batch transactions.

Once all orders are in a final state (either fully matched or canceled), the trader daemon can be safely shut down.

I want to move poold to another machine, what files do I need to move?

As long as there are no differences in the operating system or the processor architecture, moving poold to another machine is as easy as moving the .pool directory.

However, because poold doesn't have any private keys on its own, it always has to be connected to the same lnd node. Moving poold between nodes is not supported and will result in errors. If you need to use a different lnd node, cancel all orders and close all accounts first, then start a fresh poold with a new lnd instance.

PreviousAccount RecoveryNextTaproot Assets

Last updated 18 days ago

Was this helpful?

A one time payment of 1000 satoshi is also required to obtain an token to communicate with the auction server. That token currently does not expire and can therefore be used indefinitely.

LSAT