Lightning Network Daemon
Go to file
Johan T. Halseth e4301d3a8f
lnwire: rename ErrorCode -> FundingError
To make it clear that these errors are not part of the spec, rename them
to FundingError.
2019-09-20 10:55:21 +02:00
.github CODEOWNERS: remove top level catch all 2019-07-10 12:15:38 -07:00
aezeed multi: fix dropped errors 2019-09-13 09:50:38 +02:00
autopilot multi: remove dead code 2019-09-10 17:21:59 +02:00
brontide brontide: fix goroutine in test 2019-09-13 16:50:53 +00:00
buffer buffer+pool: add buffer.Read and pool.ReadBuffer 2019-02-15 19:33:08 -08:00
build build: update version to v0.7.1-beta 2019-07-23 16:18:17 -07:00
chainntnfs chainntnfs/neutrino: start concurrent queues prior to connection 2019-09-16 08:54:06 +02:00
chanbackup multi: fix dropped errors 2019-09-13 09:50:38 +02:00
channeldb Merge pull request #3414 from joostjager/report-accept-height 2019-09-16 13:49:29 +02:00
channelnotifier multi: remove dead code 2019-09-10 17:21:59 +02:00
cmd lncli+wtclientrpc: remove wtclientrpc build tag, compile by default 2019-09-18 17:26:15 -07:00
contractcourt contractcourt/channel_arbitrator: handle breach channel at startup 2019-09-18 13:05:35 +02:00
contrib contrib: add basic bash completion for lncli 2017-01-29 18:12:53 -08:00
discovery multi: move WaitPredicate, WaitNoError, WaitInvariant to lntest/wait 2019-09-19 12:46:29 -07:00
docker Update go version to 1.13 2019-09-18 12:29:40 +01:00
docs docs: update docs to build using go 1.13 2019-09-11 05:56:47 -07:00
htlcswitch lnwire+multi: define Error() for lnwire.Error 2019-09-20 10:55:21 +02:00
input Typo corrections in various comments 2019-05-10 17:15:54 +02:00
invoices invoices: return accept height in hodl event 2019-09-16 10:10:16 +02:00
keychain keychain: fix comment about derivation path 2019-07-22 21:52:36 +02:00
lncfg config: add new legacy protocol build tag protected sub-config for legacy onion 2019-08-22 18:53:08 -07:00
lnpeer lnpeer+peer: use importable lnpeer.ErrPeerExiting 2019-04-26 20:04:49 -07:00
lnrpc lncli+wtclientrpc: remove wtclientrpc build tag, compile by default 2019-09-18 17:26:15 -07:00
lntest funding: dont's send ErrorCode on wire 2019-09-20 10:55:20 +02:00
lntypes lntypes: add ZeroHash 2019-06-05 12:41:41 +02:00
lnwallet Merge pull request #3509 from alrs/fix-lnwallet-test-goroutine 2019-09-19 14:01:45 -07:00
lnwire lnwire: rename ErrorCode -> FundingError 2019-09-20 10:55:21 +02:00
macaroons routing: Fix dropped errors in tests. 2019-09-13 06:28:05 +00:00
make Makefile: ensure submodules are linted, covered, and tested 2019-08-08 14:39:18 -07:00
mobile mobile: Updating sample_lnd.conf to contain norest config 2019-09-10 01:01:27 +02:00
monitoring multi: remove dead code 2019-09-10 17:21:59 +02:00
multimutex multimutex: add new multimutex package 2018-01-24 10:26:39 +01:00
nat server: add periodic renewal of port forwarding 2019-04-13 13:49:31 +00:00
netann multi: remove dead code 2019-09-10 17:21:59 +02:00
peernotifier peernotifier: Add peer notifier package for peer online/offline events 2019-08-02 10:15:28 -04:00
pool multi: fix spelling mistakes 2019-05-04 15:35:37 -07:00
queue ticker+queue: run go mod tidy 2019-07-26 09:29:38 +02:00
record record+tlv/onion_types: move type constants to route/hop 2019-09-04 12:05:10 -07:00
routing lnwire+htlcswitch: report height for invalid payment details failure 2019-09-16 10:10:20 +02:00
scripts scripts: update bitcoind version to 0.18 2019-05-23 18:08:58 -07:00
shachain multi: remove dead code 2019-09-10 17:21:59 +02:00
signal signal: don't attempt to catch SIGSTOP 2019-04-03 13:13:03 -07:00
subscribe subscribe: add new subscribe package 2019-02-05 18:17:54 -08:00
sweep multi: remove dead code 2019-09-10 17:21:59 +02:00
ticker ticker+queue: run go mod tidy 2019-07-26 09:29:38 +02:00
tlv tlv: return parsed types from DecodeWithParsedTypes 2019-09-05 09:30:37 -07:00
tor Merge pull request #3044 from cfromknecht/spelling-fixes 2019-05-07 08:50:36 +02:00
walletunlocker multi: remove dead code 2019-09-10 17:21:59 +02:00
watchtower multi: remove dead code 2019-09-10 17:21:59 +02:00
zpay32 multi: fix dropped errors 2019-09-13 09:50:38 +02:00
.gitignore gitignore: add mobile/build 2019-09-05 09:22:53 +02:00
.golangci.yml lint: skip files generated for mobile 2019-09-18 09:07:21 +02:00
.travis.yml build: update travis to build against go 1.13 2019-09-11 05:54:33 -07:00
breacharbiter_test.go multi: move WaitPredicate, WaitNoError, WaitInvariant to lntest/wait 2019-09-19 12:46:29 -07:00
breacharbiter.go multi: replace manual CAS with sync.Once in component start/stop 2019-05-30 17:14:04 -03:00
chainparams.go add litecoin regtest configuration to lnd 2019-04-26 21:14:26 -07:00
chainregistry.go chainregistry: properly close neutrino database upon errors 2019-07-15 13:42:01 -07:00
chancloser.go lnd: rename package main->lnd 2019-04-23 20:57:33 +02:00
channel_notifier.go lnd: rename package main->lnd 2019-04-23 20:57:33 +02:00
chanrestore.go chanrestore: return error instead of nil if failed derivation 2019-06-30 12:42:36 -04:00
config.go config: fix configfile flags 2019-09-19 17:05:56 -03:00
doc.go lnd: rename package main->lnd 2019-04-23 20:57:33 +02:00
Dockerfile Added routerrpc subsystem to LND Dockerfiles so that Loop can work with docker builds. 2019-06-27 10:33:16 +01:00
fundingmanager_test.go lnwire+multi: define Error() for lnwire.Error 2019-09-20 10:55:21 +02:00
fundingmanager.go lnwire: rename ErrorCode -> FundingError 2019-09-20 10:55:21 +02:00
go.mod build: update to latest version of neutrino 2019-09-18 20:29:51 -07:00
go.sum build: adding missing unit test dep to go.sum 2019-09-19 12:46:17 -07:00
LICENSE lnd: update copyright notice 2018-11-02 14:49:36 -07:00
lnd.go lnd+cmd/lnd/main: add ListenerCfg to Main 2019-09-05 09:22:54 +02:00
log.go rpc: add unary+streaming interceptors to log all errors 2019-08-06 19:41:41 -07:00
logo.png README: add logo to top portion of page 2017-09-29 14:06:31 -07:00
Makefile Makefile+release: only use -trimpath on release script 2019-09-19 14:34:38 -07:00
mock.go multi: remove dead code 2019-09-10 17:21:59 +02:00
nursery_store_test.go lnd: rename package main->lnd 2019-04-23 20:57:33 +02:00
nursery_store.go lnd: rename package main->lnd 2019-04-23 20:57:33 +02:00
peer_test.go lnd: rename package main->lnd 2019-04-23 20:57:33 +02:00
peer.go lnwire+multi: define Error() for lnwire.Error 2019-09-20 10:55:21 +02:00
pilot.go pilot: fix log message in initAutoPilot 2019-09-06 17:04:47 +03:00
README.md README: update link to security PGP key 2019-08-06 01:09:06 -07:00
release.sh Makefile+release: only use -trimpath on release script 2019-09-19 14:34:38 -07:00
rpcserver.go multi: fix dropped errors 2019-09-13 09:50:38 +02:00
sample-lnd.conf sample-lnd.conf: add watchtower and wtclient sample confs 2019-07-01 15:56:10 -07:00
server_test.go lnd: remove global var access from genCertPair 2019-07-22 09:26:25 +02:00
server.go multi: move active/inactive ntfns from switch to link 2019-09-19 12:46:44 -07:00
subrpcserver_config.go lnrpc/walletrpc: use current height as height hint for cpfp 2019-08-22 13:49:42 -07:00
test_utils.go routing: Fix dropped errors in tests. 2019-09-13 06:28:05 +00:00
utxonursery_test.go multi: remove dead code 2019-09-10 17:21:59 +02:00
utxonursery.go utxonursery: lower shutdown message log level 2019-09-12 13:37:04 +02:00
witness_beacon.go witness_beacon: do not look up invoice preimages 2019-05-15 14:41:58 +02:00

Lightning Network Daemon

Build Status MIT licensed Irc Godoc

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 talks, articles, and example applications can be found at: dev.lightning.community.

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.freenode.net
  • channel #lnd
  • webchat

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