Boltz Docs
Client: Boltz LND
Comment on page


boltz-lnd is a Boltz client for LND. It supports Normal Submarine Swaps (mainchain Bitcoin -> Lightning) and Reverse Submarine Swaps (Lightning -> mainchain Bitcoin). Other layers like Liquid are currently not supported. It consists of two main components:


boltzd is the daemon that runs alongside your LND node. It connects to your LND node and hooks it up with the Boltz API to create and execute swaps.


boltzcli is the CLI tool to interact with the gRPC interface that boltzd exposes.


The LND node to which the daemon connects has to be version v0.10.0-beta or higher. Also, LND needs to be compiled with these build flags (official binaries from Lightning Labs releases include them already):
  • invoicerpc (hold invoices)
  • routerrpc (multi path payments)
  • chainrpc (block listener)
  • walletrpc (fee estimations)
Binaries of boltz-lnd can be found here. If no binaries are available for your platform, you can build them yourself with the instructions provided here.


boltzd requires a connection to a LND node. In most cases the CLI flags --lnd.certificate <path to the tls.cert of LND> and --lnd.macaroon <path to the admin.macaroon of LND> should be enough. To view all CLI flags use --help.
boltzd can also be configured via a TOML file. The full documentation for the configuration file can be found in the configuration section.


Macaroons for the gRPC server of boltzd can be found in the macaroons folder inside the data directory of the daemon. By default, that data directory is ~/.boltz-lnd on Linux.
Last modified 4mo ago