Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

refactor: move docs to gitbook #61

Merged
merged 38 commits into from
Oct 3, 2023
Merged
Show file tree
Hide file tree
Changes from 8 commits
Commits
Show all changes
38 commits
Select commit Hold shift + click to select a range
113da33
GITBOOK-1: change request with no subject merged in GitBook
armurbalda Jul 7, 2023
839544b
Update README.md
armurbalda Jul 26, 2023
298dc71
Update README.md
armurbalda Jul 26, 2023
fdf312b
docs: fixes
armurbalda Jul 26, 2023
cc9a705
Update README.md
armurbalda Jul 26, 2023
7ef4f5d
Merge pull request #60 from BoltzExchange/README-Prep
armurbalda Jul 26, 2023
411f6b4
fix: renaming error
armurbalda Jul 26, 2023
a01e146
Delete README.md
armurbalda Jul 26, 2023
88585e3
GITBOOK-3: change request with no subject merged in GitBook
armurbalda Jul 27, 2023
f55af61
GITBOOK-4: change request with no subject merged in GitBook
armurbalda Jul 27, 2023
5269e8a
Rename README.md to index.md
armurbalda Jul 27, 2023
7d8d018
Delete README (1).md
armurbalda Jul 27, 2023
ddca8b0
Update SUMMARY.md
armurbalda Jul 27, 2023
4a39a75
GITBOOK-5: change request with no subject merged in GitBook
armurbalda Jul 27, 2023
45c3d9d
GITBOOK-6: change request with no subject merged in GitBook
armurbalda Jul 27, 2023
7c96bc9
GITBOOK-7: change request with no subject merged in GitBook
armurbalda Jul 27, 2023
968296b
GITBOOK-8: change request with no subject merged in GitBook
armurbalda Jul 27, 2023
c5846db
GITBOOK-9: change request with no subject merged in GitBook
armurbalda Jul 27, 2023
f8b1eba
GITBOOK-10: change request with no subject merged in GitBook
armurbalda Jul 27, 2023
9189217
GITBOOK-11: change request with no subject merged in GitBook
armurbalda Jul 27, 2023
1fff8ab
fix: gitbook auto-renaming
armurbalda Jul 27, 2023
bb1d3a9
fix: gitbook stuff
armurbalda Jul 27, 2023
3cddd3f
GITBOOK-12: change request with no subject merged in GitBook
armurbalda Jul 31, 2023
3638804
GITBOOK-13: change request with no subject merged in GitBook
armurbalda Aug 1, 2023
9d7bead
GITBOOK-14: change request with no subject merged in GitBook
armurbalda Aug 1, 2023
e1a2a14
GITBOOK-15: change request with no subject merged in GitBook
armurbalda Aug 1, 2023
8f19ffe
GITBOOK-16: change request with no subject merged in GitBook
armurbalda Aug 2, 2023
435ac0c
Update grpc.md
kilrau Sep 13, 2023
52e7acb
Update grpc.md
kilrau Sep 13, 2023
ff5a1f2
revert: grpc.md changes
kilrau Sep 13, 2023
88a9a08
GITBOOK-17: change request with no subject merged in GitBook
kilrau Sep 18, 2023
3b2deab
GITBOOK-18: change request with no subject merged in GitBook
kilrau Sep 18, 2023
b7ae8fa
GITBOOK-19: change request with no subject merged in GitBook
kilrau Sep 19, 2023
4ff84ed
GITBOOK-20: change request with no subject merged in GitBook
kilrau Sep 19, 2023
46c6d66
Delete docs/.gitbook/assets/Screenshot from 2023-07-27 15-24-08.png
kilrau Sep 19, 2023
7e7338a
Delete docs/.gitbook/assets/Screenshot from 2023-09-19 18-09-36.png
kilrau Sep 19, 2023
3674b92
GITBOOK-21: change request with no subject merged in GitBook
kilrau Sep 19, 2023
09ae831
Delete docs/.gitbook/assets/lnd_header
kilrau Sep 19, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 6 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,17 @@
# Boltz LND

This repository contains a [Boltz](https://boltz.exchange) client for [LND](https://github.com/lightningnetwork/lnd). It supports Normal Submarine Swaps (from onchain to Lightning coins) and Reverse ones (from Lightning to onchain coins).
This repository contains `boltz-lnd`, a [Boltz](https://boltz.exchange) client for [LND](https://github.com/lightningnetwork/lnd). It supports Normal Submarine Swaps (Bitcoin -> Lightning) and Reverse Submarine Swaps (Lightning -> Bitcoin).

The full documentation can be found [here](https://lnd.docs.boltz.exchange/) or in the `docs` folder
The full documentation can be found [here](https://docs.boltz.exchange/boltz-lnd) or in the [`docs`](./docs) folder of this repo.

## Building

To build Go version 1.14 or higher is required. `boltz-lnd` also has C dependencies which means a C compiler has to be installed to compile the daemon successfully.
To build `boltz-lnd`, [go](https://github.com/golang/go) version 1.14 or higher is required. `boltz-lnd` also has C dependencies which means a C compiler has to be installed to compile the daemon successfully.

The build process requires patches for dependencies, and some build flags, therefore the `Makefile` in the repository root should be used.
The build process requires patches for dependencies, and some build flags, therefore the provided [`Makefile`](Makefile) should be used.

To start the build process, run:
```
go mod vendor
make build
```
```
6 changes: 6 additions & 0 deletions docs/SUMMARY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Table of contents

* [Configuration](README.md)
* [gRPC Documentation](grpc.md)
* [boltz-lnd v1.2.3 documentation](index.md)
* [< Back to Home](http://localhost:5000/o/SPM8mTvJyc7OIzGL3HD7/s/XUXMXrD8YTzvuqvAeom7/)
12 changes: 6 additions & 6 deletions docs/configuration.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,25 @@
# Configuration

`boltz-lnd` can be configured via CLI arguments, and a TOML config file. By default, the config file is called `boltz.toml` and located in the data directory of `boltz-lnd` (`/home/<user>/.boltz-lnd` by default on Linux).
`boltz-lnd` can be configured via a TOML config file or CLI arguments. By default, the config file is called `boltz.toml` and located in the data directory of `boltz-lnd` (`/home/<user>/.boltz-lnd` by default on Linux).

## Example

```toml
# Path the the log file
# Path to the log file
logfile = ""

# Prefix for all log messages.
# Useful in cases two boltz-lnd instances (one for BTC and LTC) are running in a single Docker container
# Useful in cases where multiple boltz-lnd instances are running in a single Docker container
logprefix = "[BTC] "

[BOLTZ]
# By default the daemon automatically connects to the official Boltz instance for the network LND is on
# This value is used to override that
url = "https://testnet.boltz.exchange/api"
url = "https://api.boltz.exchange"

[DATABASE]
# Path to the SQLite database file
path = "/home/michael/test.db"
path = "/home/me/test.db"

[LND]
# Host of the gRPC interface of LND
Expand Down Expand Up @@ -63,6 +63,6 @@ noMacaroons = false
# Path to the admin macaroon for the gRPC and REST interface
adminMacaroonPath = ""

# Path to the read only macaroon for the gRPC and REST interface
# Path to the read-only macaroon for the gRPC and REST interface
readOnlyMacaroonPath = ""
```
20 changes: 10 additions & 10 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,31 @@
# boltz-lnd v1.2.3 documentation
# Boltz-LND Documentation

`boltz-lnd` is a [Boltz](https://boltz.exchange) client for [LND](https://github.com/lightningnetwork/lnd). It supports Normal Submarine Swaps (from onchain to Lightning coins) and Reverse Submarine Swaps (from Lightning to onchain coins).
`boltz-lnd` is a [Boltz](https://boltz.exchange) client for [LND](https://github.com/lightningnetwork/lnd). It supports Normal Submarine Swaps (Bitcoin -> Lightning) and Reverse Submarine Swaps (Lightning -> Bitcoin).

## `boltzd`

`boltzd` is a daemon that should run alongside of your LND node. It connects to your LND node, and the Boltz API to create and execute Swaps.
`boltzd` is the daemon that should run alongside your LND node. It connects to your LND node and hooks it up with [Boltz's API](https://docs.boltz.exchange) to create and execute swaps.

## `boltzcli`

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

## Setup

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):

- `invoicerpc` (hold invoices)
- `routerrpc` (multi path payments)
- `chainrpc` (block listener)
- `walletrpc` (fee estimations)
* `invoicerpc` (hold invoices)
* `routerrpc` (multi path payments)
* `chainrpc` (block listener)
* `walletrpc` (fee estimations)

Binaries for the latest release of `boltz-lnd` can be found on the [releases page](https://github.com/BoltzExchange/boltz-lnd/releases). If no binaries are available for your platform, you can build them yourself with the instructions provided in the [README](https://github.com/BoltzExchange/boltz-lnd#building).
Binaries of `boltz-lnd` can be found [here](https://github.com/BoltzExchange/boltz-lnd/releases). If no binaries are available for your platform, you can build them yourself with the instructions provided in the [README](https://github.com/BoltzExchange/boltz-lnd#building).

### Configuration

`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 [here](configuration.md).
`boltzd` can also be configured via a TOML file. The full documentation for the configuration file can be found [here](./).

### Macaroons

Expand Down