Lightning Network Daemon
Go to file
Olaoluwa Osuntokun c304c2a8bb
tlv: run go generate for new set of TLV types
This shouldn't need to be run again, as this implementation restricts
things to just values 0-99, due to a hard upper limit with the way Go
unions work under the hood.
2023-12-12 17:47:04 -08:00
.github meta: update PR template to remind contributors about lncli docs 2023-11-20 14:48:26 -07:00
.vscode meta: add build tags to workspace settings for lsp support 2023-11-14 17:10:31 -08:00
aezeed
aliasmgr
amp
autopilot multi: move DB schemas to channeldb/models 2023-11-08 14:50:35 +02:00
batch
blockcache
brontide
buffer
build build: bump version to v0.17.0 2023-10-03 10:20:31 -07:00
cert trivial: Fix spelling errors 2023-09-21 22:35:33 -04:00
chainntnfs chainntnfs: stop lnd when received witness stack is empty 2023-10-31 01:44:43 +08:00
chainreg chainreg: Add BestBlockTracker to ChainControl 2023-10-19 09:22:07 -07:00
chanacceptor chanacceptor: add simple taproot channels 2023-09-26 21:45:16 +02:00
chanbackup multi: add debug logs to catch slow shutdown 2023-10-06 16:34:47 -07:00
chanfitness multi: add debug logs to catch slow shutdown 2023-10-06 16:34:47 -07:00
channeldb channeldb+discovery: use timestamps to maybe revive zombie 2023-12-11 09:12:05 +02:00
channelnotifier multi: add debug logs to catch slow shutdown 2023-10-06 16:34:47 -07:00
clock
cluster
cmd lncli: add new removetx cmd. 2023-12-12 14:18:17 +01:00
contractcourt contractcourt: log amount if incoming htlc times out 2023-11-08 09:56:03 +01:00
contrib
discovery channeldb+discovery: use timestamps to maybe revive zombie 2023-12-11 09:12:05 +02:00
docker docker: remove litcoin docker scripts 2023-10-06 16:34:47 -07:00
docs docs: add release-notes 2023-12-12 14:18:17 +01:00
feature
fn fn: create new sub-module 2023-12-06 17:00:10 -08:00
funding multi: move DB schemas to channeldb/models 2023-11-08 14:50:35 +02:00
healthcheck build(deps): bump github.com/btcsuite/btcd in /healthcheck (#8051) 2023-10-16 12:44:27 +02:00
htlcswitch Merge pull request #7702 from ellemouton/towerClientMux 2023-12-05 12:27:05 +02:00
input input: use lnutils.SyncMap to store musig2 sessions 2023-11-25 07:25:18 +08:00
internal/musig2v040
invoices invoices: add verbose errors to catch flakes in 2023-10-31 16:31:44 +08:00
itest itest: add an itest for the removal of a tx. 2023-12-12 14:18:16 +01:00
keychain multi: add tag option to SignMessageSchnorr 2023-10-30 21:39:39 -05:00
kvdb build(deps): bump google.golang.org/grpc from 1.53.0 to 1.56.3 in /kvdb 2023-10-25 22:28:42 +00:00
labels
lncfg multi: start asking for update timestamps in QueryChannelRange 2023-12-11 09:12:04 +02:00
lnencrypt
lnmock
lnpeer
lnrpc walletrpc: add new RemoveTransaction endpoint. 2023-12-12 14:18:16 +01:00
lntest itest: add an itest for the removal of a tx. 2023-12-12 14:18:16 +01:00
lntypes
lnutils
lnwallet itest: add gettransactiondetails 2023-12-10 22:14:18 +01:00
lnwire lnwire: add timestamps to ReplyChannelRange msg 2023-12-11 09:12:04 +02:00
macaroons macaroons: reject unknown macaroon versions 2023-10-31 13:23:50 -07:00
make
mobile
monitoring
multimutex
nat
netann multi: move DB schemas to channeldb/models 2023-11-08 14:50:35 +02:00
peer Merge pull request #7702 from ellemouton/towerClientMux 2023-12-05 12:27:05 +02:00
peernotifier multi: add debug logs to catch slow shutdown 2023-10-06 16:34:47 -07:00
pool trivial: Fix spelling errors 2023-09-21 22:35:33 -04:00
queue
record multi: add blinded path TLVs to onion payload / hops 2023-10-06 16:38:33 -07:00
routing multi: extract and pass through IsZombieChannel method 2023-12-11 09:12:05 +02:00
rpcperms
scripts CI: upgrade bitcoind version to 0.25 2023-11-01 16:34:07 +08:00
shachain
signal
sqldb
subscribe trivial: Fix spelling errors 2023-09-21 22:35:33 -04:00
sweep sweeper+lntest: remove conflicting tx 2023-12-12 13:11:48 +01:00
ticker
tlv tlv: run go generate for new set of TLV types 2023-12-12 17:47:04 -08:00
tools
tor build(deps): bump golang.org/x/net from 0.10.0 to 0.17.0 in /tor 2023-10-16 10:45:20 +00:00
walletunlocker
watchtower wtclient+server: unexport and rename TowerClient 2023-11-28 11:01:51 +02:00
zpay32 zpay32: remove litecoin tests 2023-10-06 16:34:47 -07:00
.editorconfig
.gitignore
.golangci.yml multi: disable linter paralleltest 2023-10-13 13:50:09 +08:00
.travis.yml
channel_notifier.go
chanrestore.go multi: remove litecoin references and comments 2023-10-06 16:34:47 -07:00
config_builder.go multi: remove ChainRegistry 2023-10-06 16:34:47 -07:00
config.go lntest: add http header timeout to config 2023-10-17 11:25:06 -06:00
dev.Dockerfile
doc.go
Dockerfile
go.mod build: bump to fn/v1.0.0 2023-12-08 14:08:17 -08:00
go.sum build: bump to fn/v1.0.0 2023-12-08 14:08:17 -08:00
intercepted_forward.go
LICENSE
lnd.go lnd: add http header timeout to config 2023-10-11 22:05:50 -06:00
log.go
logo.png
Makefile build: build+install using GOEXPERIMENT=loopvar 2023-10-24 18:40:58 -07:00
pilot.go
README.md docs(readme): add release build and go report status badges 2023-10-30 08:44:06 +01:00
rpcserver_test.go
rpcserver.go Merge pull request #7702 from ellemouton/towerClientMux 2023-12-05 12:27:05 +02:00
sample-lnd.conf multi: start asking for update timestamps in QueryChannelRange 2023-12-11 09:12:04 +02:00
SECURITY.md
server_test.go multi: remove Litecoin config options 2023-10-06 16:34:47 -07:00
server.go multi: extract and pass through IsZombieChannel method 2023-12-11 09:12:05 +02:00
sqlc.yaml
subrpcserver_config.go wtclient+server: unexport and rename TowerClient 2023-11-28 11:01:51 +02:00
sweeper_wallet.go
tls_manager_test.go
tls_manager.go lnd: add http header timeout to config 2023-10-11 22:05:50 -06:00
witness_beacon_test.go
witness_beacon.go

Lightning Network Daemon

Release build MIT licensed Irc Godoc Go Report Card

The Lightning Network Daemon (lnd) - is a complete implementation of a Lightning Network node. lnd has several pluggable back-end chain services including btcd (a full-node), bitcoind, and neutrino (a new experimental light client). The project's codebase uses the btcsuite set of Bitcoin libraries, and also exports a large set of isolated re-usable Lightning Network related libraries within it. In the current state lnd is capable of:

  • Creating channels.
  • Closing channels.
  • Completely managing all channel states (including the exceptional ones!).
  • Maintaining a fully authenticated+validated channel graph.
  • Performing path finding within the network, passively forwarding incoming payments.
  • Sending outgoing onion-encrypted payments through the network.
  • Updating advertised fee schedules.
  • Automatic channel management (autopilot).

Lightning Network Specification Compliance

lnd fully conforms to the Lightning Network specification (BOLTs). BOLT stands for: Basis of Lightning Technology. The specifications are currently being drafted by several groups of implementers based around the world including the developers of lnd. The set of specification documents as well as our implementation of the specification are still a work-in-progress. With that said, the current status of lnd's BOLT compliance is:

  • BOLT 1: Base Protocol
  • BOLT 2: Peer Protocol for Channel Management
  • BOLT 3: Bitcoin Transaction and Script Formats
  • BOLT 4: Onion Routing Protocol
  • BOLT 5: Recommendations for On-chain Transaction Handling
  • BOLT 7: P2P Node and Channel Discovery
  • BOLT 8: Encrypted and Authenticated Transport
  • BOLT 9: Assigned Feature Flags
  • BOLT 10: DNS Bootstrap and Assisted Node Location
  • BOLT 11: Invoice Protocol for Lightning Payments

Developer Resources

The daemon has been designed to be as developer friendly as possible in order to facilitate application development on top of lnd. Two primary RPC interfaces are exported: an HTTP REST API, and a gRPC service. The exported API's are not yet stable, so be warned: they may change drastically in the near future.

An automatically generated set of documentation for the RPC APIs can be found at api.lightning.community. A set of developer resources including guides, articles, example applications and community resources can be found at: docs.lightning.engineering.

Finally, we also have an active Slack where protocol developers, application developers, testers and users gather to discuss various aspects of lnd and also Lightning in general.

Installation

In order to build from source, please see the installation instructions.

Docker

To run lnd from Docker, please see the main Docker instructions

IRC

  • irc.libera.chat
  • channel #lnd
  • webchat

Safety

When operating a mainnet lnd node, please refer to our operational safety guidelines. It is important to note that lnd is still beta software and that ignoring these operational guidelines can lead to loss of funds.

Security

The developers of lnd take security very seriously. The disclosure of security vulnerabilities helps us secure the health of lnd, privacy of our users, and also the health of the Lightning Network as a whole. If you find any issues regarding security or privacy, please disclose the information responsibly by sending an email to security at lightning dot engineering, preferably encrypted using our designated PGP key (91FE464CD75101DA6B6BAB60555C6465E5BCB3AF) which can be found here.

Further reading