All Projects → edouardparis → lntop

edouardparis / lntop

Licence: MIT license
⚡ LN terminal dashboard 📊

Programming Languages

go
31211 projects - #10 most used programming language
shell
77523 projects
Dockerfile
14818 projects

Projects that are alternatives of or similar to lntop

Eclair Mobile
An Android wallet for the Lightning Network
Stars: ✭ 231 (+35.88%)
Mutual labels:  lightning, lightning-network
Awesome Bitcoin Payment Processors
🌟 A curated list of Bitcoin payment processors enabling merchants, businesses and nonprofits to accept Bitcoin payments.
Stars: ✭ 129 (-24.12%)
Mutual labels:  lightning, lightning-network
Plugins
Community curated plugins for c-lightning
Stars: ✭ 120 (-29.41%)
Mutual labels:  lightning, lightning-network
Lightning Faucet
A faucet for the Lightning Network!
Stars: ✭ 56 (-67.06%)
Mutual labels:  lightning, lightning-network
Zeus
A mobile Bitcoin/Lightning app for lnd, c-lightning, and Eclair node operators ⚡️
Stars: ✭ 175 (+2.94%)
Mutual labels:  lightning, lightning-network
Lightning Rfc
Lightning Network Specifications
Stars: ✭ 1,224 (+620%)
Mutual labels:  lightning, lightning-network
Spark Wallet
⚡️ A minimalistic wallet GUI for c-lightning, accessible over the web or through mobile and desktop apps.
Stars: ✭ 215 (+26.47%)
Mutual labels:  lightning, lightning-network
Lnd
Lightning Network Daemon ⚡️
Stars: ✭ 5,623 (+3207.65%)
Mutual labels:  lightning, lightning-network
Webln
Spec and client library for WebLN apps and providers
Stars: ✭ 165 (-2.94%)
Mutual labels:  lightning, lightning-network
Paper
Lightning Network Paper
Stars: ✭ 136 (-20%)
Mutual labels:  lightning, lightning-network
Blixt Wallet
Bitcoin Lightning Wallet with focus on usability and user experience
Stars: ✭ 40 (-76.47%)
Mutual labels:  lightning, lightning-network
Ln Service
Node.js interface to LND
Stars: ✭ 191 (+12.35%)
Mutual labels:  lightning, lightning-network
Lightninglib
lightninglib is a fork of lnd which aims to be usable as a go library inside any application, including mobile apps.
Stars: ✭ 11 (-93.53%)
Mutual labels:  lightning, lightning-network
Lndmanage
Channel management tool for lightning network daemon (LND) operators.
Stars: ✭ 114 (-32.94%)
Mutual labels:  lightning, lightning-network
Eclair
A scala implementation of the Lightning Network.
Stars: ✭ 892 (+424.71%)
Mutual labels:  lightning, lightning-network
Phoenix
Phoenix is a non custodial Bitcoin wallet using Lightning to send/receive payments.
Stars: ✭ 129 (-24.12%)
Mutual labels:  lightning, lightning-network
Electrum
Electrum Bitcoin Wallet
Stars: ✭ 5,353 (+3048.82%)
Mutual labels:  lightning, lightning-network
Umbrel
A personal Bitcoin and Lightning node designed for everyone
Stars: ✭ 508 (+198.82%)
Mutual labels:  lightning, lightning-network
Umbrel Os
Run Umbrel Bitcoin and Lightning node on a Raspberry Pi in one click
Stars: ✭ 132 (-22.35%)
Mutual labels:  lightning, lightning-network
Lncli Web
Light-weight web client for the lnd daemon written in NodeJS / Angular.
Stars: ✭ 181 (+6.47%)
Mutual labels:  lightning, lightning-network

lntop

MIT licensed Go Report Card Godoc

lntop is an interactive text-mode channels viewer for Unix systems.

*lntop-v0.1.0*

Install

Require the go programming language (version >= 1.19.1)

Raspberry Pi users: be aware that Raspbian ships with Go 1.11 ( see #30 )

git clone https://github.com/edouardparis/lntop.git
cd lntop
go build   // creates a binary `lntop` in directory
go install // creates a binary and move it in your $GOBIN path

With Go version >= 1.16, you can use go-install

go install github.com/edouardparis/lntop@latest

Note: If you are using Umbrel or Citadel you can simply install the Lightning Shell app from the respective dashboard. This will give you lntop which should just work without any additional configuration.

Config

First time lntop is started, a config file .lntop/config.toml is created in the user's home directory. Change address, cert path and macaroon path according to your setup.

The following environment variables, if present, will be used in the initial config file instead of the defaults, so you won't have to have lntop fail on the first start and then manually edit the config file: LND_ADDRESS, CERT_PATH, MACAROON_PATH.

[logger]
type = "production"
dest = "/root/.lntop/lntop.log"

[network]
name = "lnd"
type = "lnd"
address = "//127.0.0.1:10009"
cert = "/root/.lnd/tls.cert"
macaroon = "/root/.lnd/data/chain/bitcoin/mainnet/readonly.macaroon"
macaroon_timeout = 60
max_msg_recv_size = 52428800
conn_timeout = 1000000
pool_capacity = 4

[network.aliases]
# Not all peers have aliases set up. In order to remember who is whom, pubkeys can be annotated.
# "Forced" aliases will be printed in a different color to be distinguished from network advertised aliases.
035e4ff418fc8b5554c5d9eea66396c227bd429a3251c8cbc711002ba215bfc226 = "Wallet of Satoshi"
03864ef025fde8fb587d989186ce6a4a186895ee44a926bfc370e2c366597a3f8f = "-=[ACINQ]=-"

[views]
# views.channels is the view displaying channel list.
[views.channels]
# It is possible to add, remove and order columns of the
# table with the array columns. The available values are:
columns = [
	"STATUS",      # status of the channel
	"ALIAS",       # alias of the channel node
	"GAUGE",       # ascii bar with percent local/capacity
	"LOCAL",       # the local amount of the channel
	"REMOTE",    # the remote amount of the channel
	#"BASE_OUT"    # the outgoing base fee of the channel
	#"RATE_OUT"    # the outgoing fee rate in ppm of the channel
	#"BASE_IN"    # the incoming base fee of the channel
	#"RATE_IN"    # the incoming fee rate in ppm of the channel
	"CAP",         # the total capacity of the channel
	"SENT",        # the total amount sent
	"RECEIVED",    # the total amount received
	"HTLC",        # the number of pending HTLC
	"UNSETTLED",   # the amount unsettled in the channel
	"CFEE",        # the commit fee
	"LAST UPDATE", # last update of the channel
	# "AGE",       # approximate channel age
	"PRIVATE",     # true if channel is private
	"ID",          # the id of the channel
	# "SCID",      # short channel id (BxTxO formatted)
	# "NUPD",      # number of channel updates
]

[views.channels.options]
# Currently only one option for the AGE column. If enabled, uses multiple colors
# from green to orange to indicate the channel age using 256 color scheme in
# supported terminals

# AGE = { color = "color" }

[views.transactions]
# It is possible to add, remove and order columns of the
# table with the array columns. The available values are:
columns = [
	"DATE",      # date of the transaction
	"HEIGHT",    # block height of the transaction
	"CONFIR",    # number of confirmations
	"AMOUNT",    # amount moved by the transaction
	"FEE",       # fee of the transaction
	"ADDRESSES", # number of transaction output addresses
]

[views.routing]
columns = [
	"DIR",            # event type:  send, receive, forward
	"STATUS",         # one of: active, settled, failed, linkfail
	"IN_CHANNEL",     # channel id of the incomming channel
	"IN_ALIAS",       # incoming channel node alias
	# "IN_SCID",      # incoming short channel id (BxTxO)
	# "IN_HTLC",      # htlc id on incoming channel
	# "IN_TIMELOCK",  # incoming timelock height
	"OUT_CHANNEL",    # channel id of the outgoing channel
	"OUT_ALIAS",      # outgoing channel node alias
	# "OUT_SCID",     # outgoing short channel id (BxTxO)
	# "OUT_HTLC",     # htlc id on outgoing channel
	# "OUT_TIMELOCK", # outgoing timelock height
	"AMOUNT",         # routed amount
	"FEE",            # routing fee
	"LAST UPDATE",    # last update
	"DETAIL",         # error description
]

[views.fwdinghist]
columns = [
         "ALIAS_IN",	# peer alias name of the incoming peer
         "ALIAS_OUT",   # peer alias name of the outgoing peer
         "AMT_IN",	# amount of sats received
         "AMT_OUT",     # amount of sats forwarded
         "FEE",      	# earned fee
         "TIMESTAMP_NS",# forwarding event timestamp
#        "CHAN_ID_IN",  # channel id of the incomming channel
#        "CHAN_ID_OUT", # channel id of the outgoing channel
]

[views.fwdinghist.options]
START_TIME = { start_time = "-6h" }
MAX_NUM_EVENTS = { max_num_events = "333" }

Routing view

Routing view displays screenful of latest routing events. This information is not persisted in LND so the view always starts empty and is lost once you exit lntop.

The events are in one of four states:

  • active - HTLC pending
  • settled - preimage revealed, HTLC removed
  • failed - payment failed at a downstream node
  • linkfail - payment failed at this node

Docker

If you prefer to run lntop from a docker container, cd docker and follow README there.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].