1
- # Shushtar
1
+ # Lightning Terminal (LiT)
2
2
3
- ![ CI] ( https://github.com/lightninglabs/shushtar /workflows/CI/badge.svg )
3
+ ![ CI] ( https://github.com/lightninglabs/lightning-terminal /workflows/CI/badge.svg )
4
4
5
5
![ screenshot] ( ./app/src/assets/images/screenshot.png )
6
6
7
- Shushtar is a browser-based interface for managing the off-chain liquidity of your ` lnd `
8
- Lightning Network node. It presents a visual representation of your channels and balances,
9
- while allowing you to perform submarine swaps via the
7
+ Lightning Terminal (LiT) is a browser-based interface for managing the off-chain liquidity
8
+ of your ` lnd ` Lightning Network node. It presents a visual representation of your channels
9
+ and balances, while allowing you to perform submarine swaps via the
10
10
[ Lightning Loop] ( https://lightning.engineering/loop ) service using a graphical interface.
11
11
With a bird's eye view of all of your open channels, you can instantly see which ones need
12
12
your immediate attention.
@@ -24,61 +24,61 @@ You can configure the UI to classify channels according to your node's operating
24
24
25
25
## Architecture
26
26
27
- Shushtar is packaged as a single binary which contains the
27
+ LiT is packaged as a single binary which contains the
28
28
[ ` lnd ` ] ( https://github.com/lightningnetwork/lnd ) ,
29
29
[ ` loopd ` ] ( https://github.com/lightninglabs/loop ) and
30
30
[ ` faraday ` ] ( https://github.com/lightninglabs/faraday ) daemons all in one. It also contains
31
31
an HTTP server to serve the web assets (html/js/css) and a GRPC proxy to forward web
32
32
requests from the browser to the appropriate GRPC server. This deployment strategy was
33
33
chosen as it greatly simplifies the operational overhead of installation, configuration
34
34
and maintenance that would be necessary to run each of these servers independently. You
35
- only need to download one executable and run one command to get Shushtar up and running.
36
- We include the CLI binaries ` lncli ` , ` loop ` and ` frcli ` for convenience in the
37
- downloadable archives as well.
35
+ only need to download one executable and run one command to get LiT up and running. We
36
+ include the CLI binaries ` lncli ` , ` loop ` and ` frcli ` for convenience in the downloadable
37
+ archives as well.
38
38
39
39
## Installation
40
40
41
- There are two options for installing Shushtar : download the published binaries for your
41
+ There are two options for installing LiT : download the published binaries for your
42
42
platform, or compile from source code.
43
43
44
44
#### Download Binaries
45
45
46
- Shushtar binaries for many platforms are made available on the GitHub
47
- [ Releases] ( https://github.com/lightninglabs/shushtar /releases ) page in this repo. There
48
- you can download the latest version and extract the archive into a directory on your
49
- computer.
46
+ LiT binaries for many platforms are made available on the GitHub
47
+ [ Releases] ( https://github.com/lightninglabs/lightning-terminal /releases ) page in this
48
+ repo. There you can download the latest version and extract the archive into a directory
49
+ on your computer.
50
50
51
51
#### Compile from Source Code
52
52
53
53
To compile from source code, you'll need to have some prerequisite developer tooling
54
54
installed on your machine.
55
55
56
- - ** Go** : Shushtar 's backend web server is written in Go. Instructions for installing Go
57
- for your operating system can be found on the
56
+ - ** Go** : LiT 's backend web server is written in Go. Instructions for installing Go for
57
+ your operating system can be found on the
58
58
[ golang install] ( https://golang.org/doc/install ) page. The minimum version supported is
59
59
Go v1.13.
60
- - ** NodeJS** : Shushtar 's frontend is written in TypeScript and built on top of the React
61
- JS web framework. To bundle the assets into Javascript & CSS compatible with web
62
- browsers, NodeJS is required. It can be downloaded and installed by following the
63
- instructions on the [ NodeJS download] ( https://nodejs.org/en/download/ ) page.
60
+ - ** NodeJS** : LiT 's frontend is written in TypeScript and built on top of the React JS web
61
+ framework. To bundle the assets into Javascript & CSS compatible with web browsers,
62
+ NodeJS is required. It can be downloaded and installed by following the instructions on
63
+ the [ NodeJS download] ( https://nodejs.org/en/download/ ) page.
64
64
- ** Yarn** : a popular package manager for NodeJS application dependencies. Installation
65
65
information can be found on the
66
66
[ Yarn Installation] ( https://classic.yarnpkg.com/en/docs/install ) page.
67
67
68
- Once you have the necessary prerequisites, Shushtar can be compiled by running the
69
- following commands:
68
+ Once you have the necessary prerequisites, LiT can be compiled by running the following
69
+ commands:
70
70
71
71
```
72
- git clone https://github.com/lightninglabs/shushtar .git
73
- cd shushtar
72
+ git clone https://github.com/lightninglabs/lightning-terminal .git
73
+ cd lightning-terminal
74
74
make && make install
75
75
```
76
76
77
- This will produce the ` shushtar ` executable and add it to your ` GOPATH ` .
77
+ This will produce the ` litd ` executable and add it to your ` GOPATH ` .
78
78
79
79
## Configuration
80
80
81
- Shushtar only has a few configuration parameters itself.
81
+ LiT only has a few configuration parameters itself.
82
82
83
83
#### Required
84
84
@@ -94,18 +94,18 @@ provided by [LetsEncrypt](https://letsencrypt.org/). This is recommended if you
94
94
access the website from a remote computer and do not want to deal with the browser warning
95
95
you about the self-signed certificate. You just need to specify the domain name you wish
96
96
to use, and make sure port 80 is open in your in your firewall. LetsEncrypt requires this
97
- to verify that you own the domain name. Shushtar will listen on port 80 to handle the
97
+ to verify that you own the domain name. LiT will listen on port 80 to handle the
98
98
verification requests.
99
99
100
- On some linux-based platforms, you may need to run Shushtar with superuser privileges
101
- since port 80 is a system port. You can permit the
100
+ On some linux-based platforms, you may need to run LiT with superuser privileges since
101
+ port 80 is a system port. You can permit the
102
102
[ ` CAP_NET_BIND_SERVICE ` ] ( https://www.man7.org/linux/man-pages/man7/capabilities.7.html )
103
- capability using ` setcap 'CAP_NET_BIND_SERVICE=+eip' /path/to/shushtar ` to allow binding
104
- on port 80 without needing to run the daemon as root.
103
+ capability using ` setcap 'CAP_NET_BIND_SERVICE=+eip' /path/to/litd ` to allow binding on
104
+ port 80 without needing to run the daemon as root.
105
105
106
- > Note: Shushtar only serves content over ** HTTPS** . If you do not use ` letsencrypt ` ,
107
- > Shushtar will use the self-signed certificate that is auto-generated by ` lnd ` to encrypt
108
- > the browser-to-server communication. Web browsers will display a warning when using the
106
+ > Note: LiT only serves content over ** HTTPS** . If you do not use ` letsencrypt ` , LiT will
107
+ > use the self-signed certificate that is auto-generated by ` lnd ` to encrypt the
108
+ > browser-to-server communication. Web browsers will display a warning when using the
109
109
> self-signed certificate.
110
110
111
111
```
@@ -121,19 +121,19 @@ Application Options:
121
121
certificate (default: /Users/jamal/Library/Application Support/Lnd/letsencrypt)
122
122
```
123
123
124
- In addition to the Shushtar specific parameters, you must also provide configuration to
125
- the ` lnd ` , ` loop ` and ` faraday ` daemons. For ` lnd ` , each flag must be prefixed with ` lnd. `
124
+ In addition to the LiT specific parameters, you must also provide configuration to the
125
+ ` lnd ` , ` loop ` and ` faraday ` daemons. For ` lnd ` , each flag must be prefixed with ` lnd. `
126
126
(ex: ` lnd.lnddir=~/.lnd ` ). Please see the
127
127
[ sample-lnd.conf] ( https://github.com/lightningnetwork/lnd/blob/master/sample-lnd.conf )
128
128
file for more details on the available parameters. Note that ` loopd ` and ` faraday ` will
129
129
automatically connect to the in-process ` lnd ` node, so you do not need to provide them
130
130
with any additional parameters unless you want to override them. If you do override them,
131
131
be sure to add the ` loop. ` and ` faraday. ` prefixes.
132
132
133
- Here is an example command to start ` shushtar ` on testnet with a local ` bitcoind ` node:
133
+ Here is an example command to start ` litd ` on testnet with a local ` bitcoind ` node:
134
134
135
135
```
136
- $ ./shushtar \
136
+ $ ./litd \
137
137
--httpslisten=0.0.0.0:443 \
138
138
--uipassword=My$trongP@ssword \
139
139
--letsencrypt \
@@ -208,7 +208,7 @@ The default location for the `lnd.conf` file will depend on your operating syste
208
208
### Upgrade Existing Nodes
209
209
210
210
If you already have existing ` lnd ` , ` loop ` , or ` faraday ` nodes, you can easily upgrade
211
- them to the Shushtar single executable while keeping all of your past data.
211
+ them to the LiT single executable while keeping all of your past data.
212
212
213
213
For ` lnd ` :
214
214
@@ -230,7 +230,7 @@ For `lnd`:
230
230
```
231
231
232
232
- if you use command line arguments for configuration, add the ` lnd. ` prefix to each
233
- argument to ` shushtar `
233
+ argument to ` litd `
234
234
235
235
Before:
236
236
@@ -241,13 +241,13 @@ For `lnd`:
241
241
After:
242
242
243
243
```
244
- $ shushtar lnd.lnddir=~/.lnd --lnd.alias=merchant ...
244
+ $ litd lnd.lnddir=~/.lnd --lnd.alias=merchant ...
245
245
```
246
246
247
247
For ` loop ` :
248
248
249
249
- if you use an ` loop.conf ` file for configurations, copy the parameters into the
250
- ` lnd.conf ` file that ` shushtar ` uses, and add the ` loop. ` prefix to each of the
250
+ ` lnd.conf ` file that ` litd ` uses, and add the ` loop. ` prefix to each of the
251
251
configuration parameters.
252
252
253
253
Before: (in ` loop.conf ` )
@@ -265,7 +265,7 @@ For `loop`:
265
265
```
266
266
267
267
- if you use command line arguments for configuration, add the ` loop. ` prefix to each
268
- argument to ` shushtar `
268
+ argument to ` litd `
269
269
270
270
Before:
271
271
@@ -276,14 +276,14 @@ For `loop`:
276
276
After:
277
277
278
278
```
279
- $ shushtar --loop.loopoutmaxparts=5 --loop.debuglevel=debug ...
279
+ $ litd --loop.loopoutmaxparts=5 --loop.debuglevel=debug ...
280
280
```
281
281
282
282
For ` faraday ` :
283
283
284
284
- the standalone ` faraday ` daemon does not load configuration from a file, but you can now
285
- store the parameters into the ` lnd.conf ` file that ` shushtar ` uses. Just add the
286
- ` faraday. ` prefix to each of the configuration parameters.
285
+ store the parameters into the ` lnd.conf ` file that ` litd ` uses. Just add the ` faraday. `
286
+ prefix to each of the configuration parameters.
287
287
288
288
Before: (from command line)
289
289
@@ -299,7 +299,7 @@ For `faraday`:
299
299
```
300
300
301
301
- if you use command line arguments for configuration, add the ` faraday. ` prefix to each
302
- argument to ` shushtar `
302
+ argument to ` litd `
303
303
304
304
Before:
305
305
@@ -310,7 +310,7 @@ For `faraday`:
310
310
After:
311
311
312
312
```
313
- $ shushtar --faraday.min_monitored=48h --faraday.debuglevel=debug...
313
+ $ litd --faraday.min_monitored=48h --faraday.debuglevel=debug...
314
314
```
315
315
316
316
### Troubleshooting
@@ -320,8 +320,8 @@ If there are errors relating to one of the embedded servers, then you should ope
320
320
in their respective GitHub repos ([ lnd] ( https://github.com/lightningnetwork/lnd/issues ) ,
321
321
[ loop] ( https://github.com/lightninglabs/loop/issues ) ,
322
322
[ faraday] ( https://github.com/lightninglabs/faraday/issues ) . If the issue is related to the
323
- web app, then you should open an [ issue ] ( https://github.com/lightninglabs/shushtar/issues )
324
- here in this repo.
323
+ web app, then you should open an
324
+ [ issue ] ( https://github.com/lightninglabs/lightning-terminal/issues ) here in this repo.
325
325
326
326
#### Server
327
327
0 commit comments