Lightning Network Daemon
Go to file
2019-07-11 19:49:45 +02:00
.github CODEOWNERS: remove top level catch all 2019-07-10 12:15:38 -07:00
aezeed Add a links to KDF and BIP39 2019-02-02 17:45:13 +01:00
autopilot Merge pull request #3177 from halseth/autopilot-targetconf-conf 2019-06-17 16:05:00 -07:00
brontide brontide/conn: expose WriteMessage and Flush on brontide.Conn 2019-04-22 16:04:53 -07:00
buffer buffer+pool: add buffer.Read and pool.ReadBuffer 2019-02-15 19:33:08 -08:00
build lnd: bump version to 0.7 2019-06-14 13:54:27 -07:00
chainntnfs chainntnfs/interface: stricter conf dispatch for txindex 2019-06-27 20:24:23 -07:00
chanbackup multi: replace manual CAS with sync.Once in component start/stop 2019-05-30 17:14:04 -03:00
channeldb Merge pull request #3156 from joostjager/extended-fail 2019-07-08 19:12:03 -07:00
channelnotifier channelnotifier: remove ChannelNotifier instance from log string 2019-06-12 09:38:35 -03:00
cmd Merge pull request #3246 from tyzbit/fwdinghistory_3240 2019-07-10 09:56:00 +02:00
contractcourt contractcourt/briefcase: avoid bucket modification in ForEach loop 2019-06-14 21:09:02 +02:00
contrib contrib: add basic bash completion for lncli 2017-01-29 18:12:53 -08:00
discovery Merge pull request #3178 from federicobond/once-refactor 2019-07-08 20:33:44 -07:00
docker Added routerrpc subsystem to LND Dockerfiles so that Loop can work with docker builds. 2019-06-27 10:33:16 +01:00
docs Update recovery.md 2019-07-10 16:04:55 -07:00
htlcswitch htlcswitch: use distinct error for unreadable failures 2019-07-11 19:49:45 +02:00
input Typo corrections in various comments 2019-05-10 17:15:54 +02:00
invoices invoices: check invoice amount even when already accepted or settled 2019-06-10 16:12:10 +02:00
keychain keychain/derivation: add KeyFamilyTowerKey distinct from NodeID 2019-06-20 17:04:04 -07:00
lncfg lncfg: add Watchtower config 2019-06-13 19:54:19 -07:00
lnpeer lnpeer+peer: use importable lnpeer.ErrPeerExiting 2019-04-26 20:04:49 -07:00
lnrpc htlcswitch: use distinct error for unreadable failures 2019-07-11 19:49:45 +02:00
lntest Merge pull request #3156 from joostjager/extended-fail 2019-07-08 19:12:03 -07:00
lntypes lntypes: add ZeroHash 2019-06-05 12:41:41 +02:00
lnwallet Add test for unmined transaction DestAddresses 2019-07-10 09:39:46 +03:00
lnwire lnwire: export failureMessageLength constant 2019-04-30 20:13:33 -07:00
macaroons multi: move Input interface and related code 2019-01-31 13:25:33 +01:00
make lntest+make: build w/ watchtowerrpc tag, add grpc client to harness 2019-06-20 17:04:04 -07:00
monitoring monitoring: add monitoring package for Prometheus metric exports. 2019-06-11 11:26:05 -07: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: replace manual CAS with sync.Once in several more modules 2019-06-12 09:37:26 -03:00
pool multi: fix spelling mistakes 2019-05-04 15:35:37 -07:00
queue multi: replace manual CAS with sync.Once in several more modules 2019-06-12 09:37:26 -03:00
routing htlcswitch: use distinct error for unreadable failures 2019-07-11 19:49:45 +02:00
scripts scripts: update bitcoind version to 0.18 2019-05-23 18:08:58 -07:00
shachain multi: sort import paths with gofmt 2018-08-02 18:20:49 -07: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 sweep: allow fee bumps of inputs/transactions within UtxoSweeper 2019-06-11 15:06:38 -07:00
ticker ticker: add module support 2019-02-12 16:05:24 -08:00
tor Merge pull request #3044 from cfromknecht/spelling-fixes 2019-05-07 08:50:36 +02:00
walletunlocker walletunlock: exend the Init and Unlock methods to also return optional SCB's 2019-03-28 17:53:23 -07:00
watchtower watchtower/wtpolicy/policy: bump default fee rate to 10 sat/byte 2019-07-01 15:56:03 -07:00
zpay32 routing+zpay32: copy pubkeys before nilling Curve and spewing 2019-06-12 12:19:43 +02:00
.gitignore gitignore: ignore new output file location 2019-06-12 16:43:53 +02:00
.travis.yml travis: fix log upload regression after itest move 2019-06-04 15:03:54 -07:00
breacharbiter_test.go multi: address lingering TODO by no longer wiping out local HTLCs on remote close 2019-05-27 14:34:13 -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 lnd: add secondary DNS seed for mainnet 2019-06-28 16:10:52 -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 Merge pull request #3177 from halseth/autopilot-targetconf-conf 2019-06-17 16:05:00 -07: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 discovery,fundingmanager: avoid serialization in NotifyWhenOnline 2019-06-04 16:36:21 -03:00
fundingmanager.go Merge pull request #3145 from federicobond/avoid-pubkey-serialization 2019-06-12 10:50:35 +02:00
go.mod htlcswitch+routing+routerrpc: return error source as index 2019-07-11 10:37:26 +02:00
go.sum htlcswitch+routing+routerrpc: return error source as index 2019-07-11 10:37:26 +02:00
LICENSE lnd: update copyright notice 2018-11-02 14:49:36 -07:00
lnd.go lnd: fallback to localhost if failing getting hostname 2019-07-08 14:00:25 +02:00
log.go log: add watchtower client logs 2019-06-13 19:54:18 -07:00
logo.png README: add logo to top portion of page 2017-09-29 14:06:31 -07:00
Makefile Merge pull request #1881 from halseth/neutrino-integration-tests 2019-05-27 16:09:44 -07:00
mock.go lnwallet: make BlockChainIO.GetUTXO take cancel chan 2019-05-09 14:44:47 +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 peer: pass watchtower client's to active links 2019-06-13 19:54:19 -07:00
pilot.go config+autopilot: make conftarget configurable 2019-06-08 17:29:33 +02:00
README.md README: remove testnet3 specificity 2019-03-17 11:10:46 -07:00
release.sh release: update to include tower rpc build tag 2019-06-20 18:18:08 -07:00
rpcserver.go rpc: add channel reserve fields in RPC responses. 2019-07-11 00:03:20 +03: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: rename package main->lnd 2019-04-23 20:57:33 +02:00
server.go htlcswitch+routing+routerrpc: return error source as index 2019-07-11 10:37:26 +02:00
subrpcserver_config.go lnrpc/watchtowerrpc: prevent watchtowerrpc panic when tower not active 2019-07-02 15:06:12 -07:00
test_utils.go channel+cnct: remove preimage from channel and resolution 2019-05-15 14:41:49 +02:00
utxonursery_test.go multi: support arbitrary client fee preferences to UtxoSweeper 2019-05-24 15:30:38 -07:00
utxonursery.go server+utxonursery: generate pkscript closures 2019-06-13 19:54:19 -07: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