No description
Find a file
positiveblue 7ecc726b4e
poolscript: add RecoveryHelper
RecoveryHelper is a type that helps speed up account recovery by
caching the tweaked trader and auctioneer keys for faster script
lookups.
2022-01-27 16:34:59 -08:00
.github mock: Add mockgen workflow 2021-11-10 14:05:10 -08:00
account account/recovery: add struct for auctioneer data 2022-01-26 01:17:31 -08:00
auctioneer auctioneer+order: rename CurrentBatchVersion->LatestBatchVersion 2021-12-22 09:47:45 +01:00
auctioneerrpc auctioneerrpc: add auto_renew_extension_blocks to TermsResponse 2021-12-02 22:53:46 -08:00
chaninfo chaninfo: allow channel info submission for script enforced channels 2021-11-02 16:48:03 -07:00
clientdb clientdb: store new channel type field as part of tlv stream 2021-11-02 16:47:50 -07:00
cmd cmd/pool: user server assisted recovery by default 2022-01-26 01:17:30 -08:00
docs docs: update documentation 2021-12-14 20:28:14 -08:00
event multi: prepare for upcoming lnd v0.14.0-beta release 2021-10-20 19:25:54 -07:00
funding funding: support opening script enforced channels based on order matched 2021-11-02 16:47:58 -07:00
gen mock: Add mockgen workflow 2021-11-10 14:05:10 -08:00
internal/test mocks: add account/watcher mocks 2021-12-07 12:22:37 -08:00
make build: remove darwin/386 as no longer supported by Go 1.15 2020-10-30 20:00:22 -07:00
order order: only extend re-created accounts 2022-01-03 16:57:02 +01:00
poolrpc poolrpc: add fields to Recovery Requests 2022-01-26 01:17:28 -08:00
poolscript poolscript: add RecoveryHelper 2022-01-27 16:34:59 -08:00
scripts build: add release script ane Makefile modifications 2020-10-30 19:07:21 -07:00
sidecar mocks: udpate TestRegisterSidecar to use gomock 2021-11-11 09:59:36 -08:00
terms auctioneerrpc: add auto_renew_extension_blocks to TermsResponse 2021-12-02 22:53:46 -08:00
.gitignore multi: rename project from llm to pool 2020-09-09 19:55:10 -07:00
.golangci.yml Makefile+lint: only limit concurrency on Travis 2020-06-24 09:58:17 +02:00
auto_sidecar.go multi: inform other side about ticket cancellation 2021-10-29 17:20:18 +02:00
backoff.go sidecar: add simple exponential back off for mailbox reads 2021-06-25 14:59:11 -07:00
book.json docs: re-organize docs into new Gitbook compatible structure 2020-10-13 17:02:46 -07:00
channel_acceptor.go funding: enforce correct channel type is extended to bidder 2021-11-02 16:48:00 -07:00
config.go config: add DebugConfig struct 2021-12-21 14:29:37 +01:00
Dockerfile multi: rename project from llm to pool 2020-09-09 19:55:10 -07:00
gen.go rpcserver: add Marshaler interface 2021-12-14 20:40:02 -08:00
go.mod multi: use lndclient MacaroonService 2022-01-17 16:04:03 +02:00
go.sum multi: use lndclient MacaroonService 2022-01-17 16:04:03 +02:00
interfaces.go rpcserver: add Marshaler interface 2021-12-14 20:40:02 -08:00
LICENSE pool: add MIT license 2021-02-02 10:09:45 +01:00
log.go multi: bump lnd to version v0.13.0-beta.rc3 2021-05-25 20:25:16 +02:00
macaroons.go multi: use lndclient MacaroonService 2022-01-17 16:04:03 +02:00
Makefile mock: Add mockgen workflow 2021-11-10 14:05:10 -08:00
marshaler.go rpcserver: add Marshaler interface 2021-12-14 20:40:02 -08:00
mock_interfaces.go rpcserver: add Marshaler interface 2021-12-14 20:40:02 -08:00
README.md README: fix inprecise wording for execution fee 2021-12-16 10:42:47 +01:00
rpcserver.go account: add target to GenerateRecoveryKeys 2022-01-26 01:17:31 -08:00
rpcserver_test.go rpcserver: add tests for RenewAccount endpoint 2021-12-14 20:40:02 -08:00
run.go multi: bump lnd to version v0.13.0-beta.rc3 2021-05-25 20:25:16 +02:00
server.go server: rename createDefaultMacaroonFile 2022-01-17 16:04:03 +02:00
sidecar_acceptor.go multi: inform other side about ticket cancellation 2021-10-29 17:20:18 +02:00
sidecar_acceptor_test.go mocks: udpate TestRegisterSidecar to use gomock 2021-11-11 09:59:36 -08:00
version.go version: bump version to v0.5.4-alpha 2022-01-03 16:57:04 +01:00

Lightning Pool

Lightning Pool is a non-custodial, peer-to-peer marketplace that allows node operators that need inbound liquidity to pay node operators with available capital to open channels in their direction while retaining full custody of their funds. Pools first product is a Lightning Channel Lease - an inbound channel with a pre-agreed duration.

Efficient capital allocation is one of the most widely felt pain points when using the Lightning Network. Existing node operators do not have access to pricing signals to help determine where in the network their outbound liquidity should be allocated, and new node operators have no way to signal that they need new inbound liquidity. Lightning Pool brings these two sides together into a single market while allowing them to maintain custody of their funds.

Checkout our documentation to learn more. For more technical details, check out the technical white paper.

How it works

Lightning Pool is a non-custodial auction for liquidity where bids are kept private and trades clear periodically. Key aspects of Pool include:

  • Periodic clearing - Market does not clear continuously, instead, it clears every block (or after multiple blocks, if there are no bids that match with existing asks).

  • Non-custodial - Clients maintain an on-chain account that is a timelocked, 2-of-2 multisig with the auctioneer. These funds are fully in the users control at all times.

  • Sealed-bid - All orders are submitted off-chain to the auctioneer, so bidders dont have visibility into the bids of other participants

  • Uniform clearing price - All participants in a batch clear at the same price. If your ask is for 2% annualized interest, you will receive >=2%. If you bid 5%, you will pay <=5%.

  • Batched execution - Due to the account structure, the auctioneer is able to batch all completed orders into a single transaction, greatly reducing individual chain fees.

Installation

Download the latest binaries from the releases page.

LND

Note that Pool requires lnd to be built with all of its subservers and requires running at least v0.12.0. Download the latest official release binary or build lnd from source by following the installation instructions. If you choose to build lnd from source, use the following command to enable all the relevant subservers:

make install tags="signrpc walletrpc chainrpc invoicesrpc"

Usage

Read our quickstart guide to learn more about how to use Pool.

Marketplace Fee

Fees are calculated based on the amount of liquidity purchased. During the mainnet alpha, fees will range from 5-25 basis points of the matched amount.

Development

The Pool client is currently in early alpha and offers a simple command line application.

The Pool daemon exposes a gRPC API and REST API.

Troubleshooting

Join us on Slack and we'd be happy to help in any way we can. In the meantime please see our FAQs.

Build from source

If youd prefer to compile from source code, youll need at least go 1.14 and make.

Run the following commands to download the code, compile and install Pool:

$ git clone https://github.com/lightninglabs/pool
$ cd pool
$ make install

This will install the binaries into your $GOPATH/bin directory.

Compatibility

Lightning Pool requires lnd version 0.12.0-beta or higher (v0.13.3-beta or later is recommended).