You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Alex Bosworth f26115effc
Merge pull request #517 from lightninglabs/bump-to-v0.20.1-beta
2 weeks ago
.github github: initial docker workflow 4 months ago
cmd loopin: enable p2tr htlcs without keyspend 1 month ago
docs Fixed a typo in autoloop.md 7 months ago
labels multi: update autoloop labels to support both swap types 2 years ago
liquidity multi: bump lndclient and lnd version to latest 1 month ago
loopd multi: bump lndclient and lnd version to latest 1 month ago
loopdb loopdb: add the local pubkey's keylocator to the persisted contract 1 month ago
looprpc loopin: enable p2tr htlcs without keyspend 1 month ago
regtest bump lnd versions from 12.1-beta to 13.4-beta 9 months ago
swap loopout: attempt cooperative musig2 sweep 1 month ago
swapserverrpc loopout: use psbt when obtaining the MuSig2 signature 1 month ago
sweep loopout: use psbt when obtaining the MuSig2 signature 1 month ago
test multi: bump lndclient and lnd version to latest 1 month ago
tools make+tools: tidy makefile, add gosimports 3 months ago
.gitignore makefile+travis: add install and build commands 2 years ago
.golangci.yml make: dockerize linter 3 months ago
.travis.yml travis+docker: bump golang version to v1.17.x 5 months ago
DOCKER.md docs: remove weird character in DOCKER.md 2 years ago
Dockerfile docker: add support for multiarch builds 4 months ago
LICENSE Update LICENSE 7 months ago
Makefile make+tools: tidy makefile, add gosimports 3 months ago
README.md Merge branch 'master' into patch-1 1 year ago
client.go loopout: add unit test for the MuSig2 sweep case 1 month ago
client_test.go loopout: attempt cooperative musig2 sweep 1 month ago
config.go multi: use aperture instead of local lsat library 1 year ago
executor.go loopout: add unit test for the MuSig2 sweep case 1 month ago
go.mod multi: bump lndclient and lnd version to latest 1 month ago
go.sum multi: bump lndclient and lnd version to latest 1 month ago
interface.go loopout: enable p2tr without keyspend 1 month ago
log.go multi: add persistent logger 3 years ago
loopin.go multi: bump lndclient and lnd version to latest 1 month ago
loopin_test.go loopin: enable p2tr htlcs without keyspend 1 month ago
loopin_testcontext_test.go multi: bump btcec/v2 and btcutil to new versions 5 months ago
loopout.go loopout: log failed sweeps to allow out of band publish 2 weeks ago
loopout_test.go loopout: add unit test for the MuSig2 sweep case 1 month ago
release.sh release: remove support for darwin 386 2 years ago
release_notes.md version: bump version to v0.20.0-beta 3 weeks ago
routing_plugin.go multi: bump btcec/v2 and btcutil to new versions 5 months ago
routing_plugin_test.go multi: bump btcec/v2 and btcutil to new versions 5 months ago
server_mock_test.go loopout: use psbt when obtaining the MuSig2 signature 1 month ago
store_mock_test.go loopdb: add new bucket to save liquidity params 2 months ago
swap.go loopin: enable p2tr htlcs without keyspend 1 month ago
swap_server_client.go loopout: use psbt when obtaining the MuSig2 signature 1 month ago
testcontext_test.go loopout: add unit test for the MuSig2 sweep case 1 month ago
uncharge_state.go loop: extract code from client package into new loop primary package 3 years ago
updates.go multi: consume and log sever state updates 2 years ago
utils.go multi: bump btcec/v2 and btcutil to new versions 5 months ago
version.go version: bump version to v0.20.1-beta 2 weeks ago

README.md

Lightning Loop

Lightning Loop is a non-custodial service offered by Lightning Labs that makes it easy to move bitcoin into and out of the Lightning Network.

Features

  • Automated channel balancing
  • Privacy-forward non-custodial swaps
  • Opportunistic transaction batching to save on fees
  • Progress monitoring of in-flight swaps

Use Cases

  • Automate channel balancing with AutoLoop (Learn more)
  • Deposit to a Bitcoin address without closing channels with Loop In
  • Convert outbound liquidity into inbound liquidity with Loop Out
  • Refill depleted Lightning channels with Loop In

Installation

Download the latest binaries from the releases page.

Execution

The Loop client needs its own short-lived daemon to facilitate swaps. To start loopd:

loopd

To use Loop in testnet, simply pass the network flag:

loopd --network=testnet

By default loopd attempts to connect to the lnd instance running on localhost:10009 and reads the macaroon and tls certificate from ~/.lnd. This can be altered using command line flags. See loopd --help.

Usage

AutoLoop

AutoLoop makes it easy to keep your channels balanced. Checkout our autoloop documentation for details.

Loop Out

Use Loop Out to move bitcoins on Lightning into an on-chain Bitcoin address.

To execute a Loop Out:

loop out <amt_in_satoshis>

Other notable options:

  • Use the --fast flag to swap immediately (Note: This opts-out of fee savings made possible by transaction batching)
  • Use the --channel flag to loop out on specific channels
  • Use the --addr flag to specify the address the looped out funds should be sent to (Note: By default funds are sent to the lnd wallet)

Run loop monitor to monitor the status of a swap.

Loop In

Use Loop In to convert on-chain bitcoin into spendable Lightning funds.

To execute a Loop In:

loop in <amt_in_satoshis>

More info

For more information about using Loop checkout our Loop FAQs.

Development

Regtest

To get started with local development against a stripped down dummy Loop server running in a local regtest Bitcoin network, take a look at the regtest server environment example documentation.

Testnet

To use Loop in testnet, simply pass the network flag:

loopd --network=testnet

Submit feature requests

The GitHub issue tracker can be used to request specific improvements or report bugs.

Join us on Slack

Join us on the LND Slack and join the #loop channel to ask questions and interact with the community.

LND

Note that Loop requires lnd to be built with all of its subservers. 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"

API

The Loop daemon exposes a gRPC API (defaults to port 11010) and a REST API (defaults to port 8081).

The gRPC and REST connections of loopd are encrypted with TLS and secured with macaroon authentication the same way lnd is.

If no custom loop directory is set then the TLS certificate is stored in ~/.loop/<network>/tls.cert and the base macaroon in ~/.loop/<network>/loop.macaroon.

The loop command will pick up these file automatically on mainnet if no custom loop directory is used. For other networks it should be sufficient to add the --network flag to tell the CLI in what sub directory to look for the files.

For more information on macaroons, see the macaroon documentation of lnd.

NOTE: Loop's macaroons are independent from lnd's. The same macaroon cannot be used for both loopd and lnd.

Build from source

If you’d prefer to build from source:

git clone https://github.com/lightninglabs/loop.git
cd loop/cmd
go install ./...