Lightning Network Daemon ⚡️
Clone or download
Roasbeef Merge pull request #1295 from joostjager/forget
rpc: add support for a `forgetchannel` RPC only enabled w/ the debug flag
Latest commit f430509 Sep 22, 2018
Permalink
Failed to load latest commit information.
.github github: add GitHub issue template Mar 28, 2018
aezeed aezeed/errors: add missing space in error message Jun 27, 2018
autopilot autopilot/multi: replace PubKey -> NodeKey on directive Sep 6, 2018
brontide multi: sort import paths with gofmt Aug 3, 2018
chainntnfs chainntnfs/neutrinonotify/neutrino: remove height shadowing Sep 21, 2018
channeldb rpcserver+lnrpc+lncli: add AbandonChannel rpc call Sep 18, 2018
cmd/lncli rpcserver+lnrpc+lncli: add AbandonChannel rpc call Sep 18, 2018
contractcourt contractcourt+server: make IncubateOutputs take broadcastHeight Sep 20, 2018
contrib contrib: add basic bash completion for lncli Jan 30, 2017
discovery Merge pull request #1738 from joostjager/validation Sep 18, 2018
docker docker/lnd/start-lnd.sh: pass noseedbackup instead of noencryptwallet Sep 5, 2018
docs Merge pull request #1843 from cfromknecht/change-noencryptwallet Sep 13, 2018
htlcswitch htlcswitch: return concrete error from GetLinksByInterface Aug 29, 2018
keychain keychain: use t.Helper() instead of manually fetching the line no fro… Aug 15, 2018
lncfg multi: fix linting errors Aug 3, 2018
lnpeer lnpeer: extend Peer interface with new QuitSignal method Aug 26, 2018
lnrpc rpcserver+lnrpc+lncli: add AbandonChannel rpc call Sep 18, 2018
lntest Merge pull request #1843 from cfromknecht/change-noencryptwallet Sep 13, 2018
lnwallet lnwallet: add test to execrise unconfirmed transcations notified by S… Sep 13, 2018
lnwire lnwire: check length of payload in decodeShortChanIDs Sep 13, 2018
macaroons macaroons/README: update noencryptwallet -> noseedbackup Sep 5, 2018
make make: if timeout not set, use 20m instead of default 10m Jul 26, 2018
multimutex multimutex: add new multimutex package Jan 24, 2018
nat nat: introduce new NAT traversal package with UPnP/NAT-PMP implementa… Jun 13, 2018
routing Merge pull request #1738 from joostjager/validation Sep 18, 2018
shachain multi: sort import paths with gofmt Aug 3, 2018
signal signal/log: adds signal logger Jun 28, 2018
ticker ticker: fix linter error Aug 10, 2018
tor tor/controller: fix response parsing for values containing the '=' ch… Sep 18, 2018
walletunlocker walletunlocker/service: change noencryptwallet reference to noseedbackup Sep 5, 2018
watchtower/blob watchtower/blob/justice_kit_test: add encrypt/decrypt test vectors Jul 25, 2018
zpay32 multi: sort import paths with gofmt Aug 3, 2018
.gitignore gitignore: ignore visual studio code config Sep 18, 2018
.travis.yml test: upload integration test logs from TravisCI to file.io May 1, 2018
Dockerfile lnd+docker: add "Production" Docker Image May 17, 2018
Gopkg.lock build: update to point to latest version of neutrino Sep 13, 2018
Gopkg.toml build: update to point to latest version of neutrino Sep 13, 2018
LICENSE LICENSE: update year to 2018 Apr 6, 2018
Makefile Merge pull request #1901 from cfromknecht/clean-vendor-new Sep 14, 2018
README.md README: add security section in readme Sep 13, 2018
breacharbiter.go multi: switch to transaction weight to calculate transaction fees Aug 10, 2018
breacharbiter_test.go multi: update to latest fee estimation interface Aug 10, 2018
chainparams.go test+lnd: update unit test mocks to adhere to new interface API's Aug 1, 2018
chainregistry.go multi: update to new BitcoindClient API Sep 13, 2018
chan_series.go chanseries: fix panic bug by ensuring we access a non-nil edge Sep 6, 2018
chancloser.go chancloser: remove error returned from unregisterChannel Aug 10, 2018
config.go config: fix linter error Sep 13, 2018
config_debug.go rpcserver+lnrpc+lncli: add AbandonChannel rpc call Sep 18, 2018
config_production.go rpcserver+lnrpc+lncli: add AbandonChannel rpc call Sep 18, 2018
doc.go add some daemon related skeleton files Dec 26, 2015
fundingmanager.go cmd/lncli+fundingmanager: use a default num min confs for 1 for openc… Sep 8, 2018
fundingmanager_test.go htlcswitch+funding+discovery: update mock peers to add new QuitSignal… Aug 26, 2018
invoiceregistry.go invoiceregistry: make the invoice ntfn chan buffered Jul 17, 2018
lnd.go Merge pull request #1843 from cfromknecht/change-noencryptwallet Sep 13, 2018
lnd_test.go lnd_test: add AbandonChannel test Sep 21, 2018
log.go multi: switch over import paths from roasbeef/* to btcsuite/* Jul 14, 2018
logo.png README: add logo to top portion of page Sep 29, 2017
mock.go multi: update to latest RegisterBlockEpochNtfn interface Aug 10, 2018
nodesigner.go multi: sort import paths with gofmt Aug 3, 2018
nursery_store.go multi: sort import paths with gofmt Aug 3, 2018
nursery_store_test.go multi: sort import paths with gofmt Aug 3, 2018
peer.go peer: prune persistent peer connection on zero on-disk channels Sep 6, 2018
peer_test.go multi: update to latest fee estimation interface Aug 10, 2018
pilot.go pilot: improve error when unable to reach any of a peer's addresses Aug 29, 2018
release.sh release: Add ARMv6 platform to release.sh Sep 10, 2018
rpcserver.go rpcserver+lnrpc+lncli: add AbandonChannel rpc call Sep 18, 2018
sample-lnd.conf sample-lnd.conf: remove noencryptwallet flag from sample Sep 5, 2018
server.go utxonursery: pass broadcastHeight to registerPreschoolConf Sep 20, 2018
server_test.go server test: add !rpctest build flag Apr 13, 2018
test_utils.go peer: prune persistent peer connection on zero on-disk channels Sep 6, 2018
utxonursery.go utxonursery: pass broadcastHeight to registerPreschoolConf Sep 20, 2018
utxonursery_test.go utxonursery test: run tests in parallel Sep 20, 2018
version.go lnd+cmd/lncli: bump version to 0.5-beta Aug 27, 2018
witness_beacon.go multi: sort import paths with gofmt Aug 3, 2018

README.md

Lightning Network Daemon

Build Status MIT licensed Irc Godoc

The Lightning Network Daemon (lnd) - is a complete implementation of a Lightning Network node and currently deployed on testnet3 - the Bitcoin Test Network. 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: Basic of Lightning Technologies. 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 security 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