Lightning Network Daemon
Go to file
Wilmer Paulino e075817e44
discovery: introduce GossipSyncer signal delivery of chansSynced state
In this commit, we introduce another feature to the GossipSyncer in
which it can deliver a signal to an external caller once it reaches its
terminal chansSynced state. This is yet to be used, but will serve
useful with a round-robin sync mechanism, where we wait for to finish
syncing with a specific peer before moving on to the next.
2019-04-03 15:08:31 -07:00
.github docs: expand contributor checklist w/ commit structure 2018-12-19 17:02:25 -08:00
aezeed Add a links to KDF and BIP39 2019-02-02 17:45:13 +01:00
autopilot autopilot/prefattach: count small channels negatively 2019-03-27 15:06:30 +01:00
brontide brontide/conn: expose ReadNextHeader+ReadNextBody 2019-02-21 20:11:19 -08:00
buffer buffer+pool: add buffer.Read and pool.ReadBuffer 2019-02-15 19:33:08 -08:00
build build: bump to psuedo version 0.5.2-99-beta 2019-02-22 15:31:07 -08:00
chainntnfs chainntnfs/bitcoindnotify: improve historical conf dispatch logging 2019-04-01 18:21:07 -07:00
chanbackup chanbackup: extend channel backups to include entire local+remote chan config 2019-03-28 17:53:38 -07:00
channeldb channeldb: write chan updates through reject+channel cache 2019-04-01 16:34:51 -07:00
channelnotifier lnd: introduce the ChannelNotifier. 2019-02-05 18:17:54 -08:00
cmd/lncli cmd/lncli: add new verifychanbackup command 2019-03-28 17:54:03 -07:00
contractcourt Merge pull request #2839 from joostjager/htlc-expiry-check 2019-04-01 18:15:56 -07:00
contrib contrib: add basic bash completion for lncli 2017-01-29 18:12:53 -08:00
discovery discovery: introduce GossipSyncer signal delivery of chansSynced state 2019-04-03 15:08:31 -07:00
docker Change simtest to testnet for connection to testnet faucet 2019-02-25 22:12:33 -06:00
docs Merge pull request #2831 from philippgille/patch-3 2019-03-26 20:54:38 -07:00
htlcswitch Merge pull request #2839 from joostjager/htlc-expiry-check 2019-04-01 18:15:56 -07:00
input sweep/input: adds NewBaseInput to return reference 2019-02-05 18:27:07 -08:00
invoices htlcswitch: hodl invoice 2019-03-15 10:09:17 +01:00
keychain keychain: add new KeyFamily: KeyFamilyStaticBackup for SCB encryption keys 2019-01-23 18:11:11 -08:00
lncfg lncfg/caches: adds Caches sub config 2019-04-01 16:34:04 -07:00
lnpeer peer: add SendMessageLazy 2019-03-05 17:08:22 -08:00
lnrpc lnrpc: add REST endpoints for new SCB related calls 2019-04-02 20:46:33 -07:00
lntest lntest: extend the restore/restart methods to also accept optional SCBs 2019-03-28 17:54:07 -07:00
lntypes lntypes: return a value from constructors 2019-03-15 10:08:38 +01:00
lnwallet contractcourt: only look for local force close for non-recovered channel 2019-03-28 17:53:59 -07:00
lnwire lnwire: add bool types to codec for SCB format 2019-03-28 17:53:44 -07:00
macaroons multi: move Input interface and related code 2019-01-31 13:25:33 +01:00
make build: add routerrpc tag in itest 2019-03-21 10:25:58 +01:00
multimutex multimutex: add new multimutex package 2018-01-24 10:26:39 +01:00
nat nat: introduce new NAT traversal package with UPnP/NAT-PMP implementations 2018-06-12 18:36:27 -07:00
netann netann/chan_status_manager: remove unknown edges from passive disable 2019-03-12 17:35:12 -07:00
pool pool/worker_test: add tests for concrete Worker pools 2019-02-21 20:10:40 -08:00
queue Merge pull request #2419 from cfromknecht/brontide-buffer-pool 2019-02-18 17:51:17 -08:00
routing routing: expose VerifyChannelUpdateSignature function 2019-03-27 13:07:47 -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 multi: move Input interface and related code 2019-01-31 13:25:33 +01:00
ticker ticker: add module support 2019-02-12 16:05:24 -08:00
tor tor: add support for NULL authentication to controller 2019-01-18 22:45:31 -07: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/wtclient: fix linter issue 2019-03-20 19:36:59 -07:00
zpay32 zpay32: move HopHint and DefaultFinalCLTVDelta 2019-03-15 10:08:32 +01:00
.gitignore gitignore: ignore .minerlogs folder 2019-01-16 10:11:47 +01:00
.travis.yml travis: use go 1.12.x 2019-02-26 12:19:00 -03:00
breacharbiter_test.go breacharbiter_test: add table-driven breach spend tests 2019-03-19 19:25:57 -07:00
breacharbiter.go breacharbiter: detect all spends, add terminal states 2019-03-19 19:22:35 -07:00
chainparams.go test+lnd: update unit test mocks to adhere to new interface API's 2018-07-31 21:28:58 -07:00
chainregistry.go chains: upgrade the keyRing instance in chainControl to a SecretKeyRing 2019-03-28 17:38:07 -07:00
chancloser.go chancloser+cnct: disable channel before closing 2019-03-12 17:34:28 -07:00
channel_notifier.go lnd: add new channelNotifier impl of chanbackup.ChannelNotifier 2019-03-28 17:53:31 -07:00
chanrestore.go server: convert Start/Stop methods to use sync.Once 2019-03-28 17:54:05 -07:00
config.go config: expose Caches subconfig 2019-04-01 16:34:17 -07:00
doc.go add some daemon related skeleton files 2015-12-26 00:09:17 -06:00
Dockerfile fix dockerfile dependency bug 2018-12-01 22:53:14 -06:00
fundingmanager_test.go peer: add SendMessageLazy 2019-03-05 17:08:22 -08:00
fundingmanager.go multi: remove ErrDoubleSpend check for PublishTransaction 2019-03-13 17:57:19 -07:00
go.mod build: update btcwallet to latest version 2019-03-26 20:49:43 -07:00
go.sum build: update btcwallet to latest version 2019-03-26 20:49:43 -07:00
LICENSE lnd: update copyright notice 2018-11-02 14:49:36 -07:00
lnd_test.go Merge pull request #2839 from joostjager/htlc-expiry-check 2019-04-01 18:15:56 -07:00
lnd.go lnd: pass CLI reject+channel cache sizes to channeldb Open 2019-04-01 16:34:30 -07:00
log.go log: hook up chanbackup logger 2019-03-28 17:53:34 -07:00
logo.png README: add logo to top portion of page 2017-09-29 14:06:31 -07:00
Makefile Merge pull request #2745 from cfromknecht/make-install-btcd 2019-03-08 18:41:18 -08:00
mock.go mock: support late registration of spend ntfns 2019-03-19 19:22:47 -07:00
nursery_store_test.go utxonursery: connect to time-based sweeper 2018-12-18 10:50:20 +01:00
nursery_store.go utxonursery: connect to time-based sweeper 2018-12-18 10:50:20 +01:00
peer_test.go htlcswitch: remove lnrpc dependency 2019-01-03 09:07:56 +01:00
peer.go Merge pull request #2839 from joostjager/htlc-expiry-check 2019-04-01 18:15:56 -07:00
pilot.go lnd+pilot+autopilot: use config to set active autopilot heuristics 2019-01-23 09:05:42 +01:00
README.md README: remove testnet3 specificity 2019-03-17 11:10:46 -07:00
release.sh build: update release.sh to contain vendor archive + source code 2019-01-17 23:40:11 -08:00
rpcserver.go rpc: implement new VerifyChanBackup command 2019-03-28 17:54:02 -07:00
sample-lnd.conf Merge pull request #1108 from sangaman/sever-server 2018-09-27 22:23:45 -07:00
server_test.go Improved color validation - now with fixes and a table driven test 2018-11-09 03:09:39 +01:00
server.go server: stop chansubswapper on shutdown instead of start 2019-04-02 09:58:13 +02:00
subrpcserver_config.go routerrpc: adapt to changed interfaces of routing subsystem 2019-03-21 10:25:55 +01:00
test_utils.go test_utils: start chan status manager 2019-03-12 17:34:57 -07:00
utxonursery_test.go utxonursery: report unconfirmed htlc on commit tx 2019-02-01 09:36:54 +01:00
utxonursery.go utoxnursery: allow nursery to start up if timeout spend happens 2019-03-19 16:50:30 -07:00
witness_beacon.go channeldb: store hold invoice 2019-03-15 10:08:55 +01: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