Lightning Network Daemon
  • Go 99.3%
  • Shell 0.5%
  • Makefile 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Yong 8464116a05
Merge pull request #11057 from starius/add-boris-key
scripts/keys: add pub key for boris
2026-08-11 13:23:32 +08:00
.claude/commands multi: add issue dedupe command and workflow 2026-02-11 13:06:42 +02:00
.gemini .gemini: ignore char wrapping during code review 2025-09-01 10:16:44 +02:00
.github Merge pull request #10955 from lightningnetwork/ci/workflow-job-split 2026-08-04 03:16:06 +08:00
.vscode meta: add build tags to workspace settings for lsp support 2023-11-14 17:10:31 -08:00
actor multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
aezeed multi: Fix typos and grammar in multiple docs 2024-07-22 20:08:12 -07:00
aliasmgr lint: remove redundant loop var copies in test files 2026-06-03 15:32:45 -03:00
amp lint: remove redundant loop var copies in test files 2026-06-03 15:32:45 -03:00
autopilot multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
batch multi: context.Background() -> t.Context() 2025-08-30 14:13:44 -03:00
blockcache multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
bolt12 Merge pull request #10958 from bitromortac/2604-bolt12-1d 2026-07-24 14:16:13 -03:00
brontide brontide+peer: use internal sync/pool to reduce allocations 2025-09-24 11:52:01 -07:00
buffer lnwire: remove unused MaxMessagePayload const 2021-08-10 05:36:07 +08:00
build Merge pull request #10872 from erickcestari/enable-copyloopvar-linter 2026-06-11 05:23:47 +08:00
cert build: bump Go versions 2026-06-08 17:02:58 -03:00
chainio chainio: use package logger instead of instance logger 2025-06-18 19:43:27 +08:00
chainntnfs multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
chainparams multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
chainreg lnwallet+walletrpc: add SubmitPackage for v3 CPFP package relay 2026-06-30 11:07:52 -07:00
chanacceptor multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
chanbackup chanstate: use channel types in backups 2026-07-07 07:18:57 -03:00
chanfitness chanstate: use channel types in fitness 2026-07-07 07:18:56 -03:00
channeldb channeldb: recover missing db version 2026-07-22 11:44:01 -07:00
channelnotifier chanstate: use channel types in consumers 2026-07-07 07:18:56 -03:00
chanstate chanstate: match active htlcs by identity 2026-07-07 09:07:54 -03:00
clock build: bump Go versions 2026-06-08 17:02:58 -03:00
cluster multi: context.Background() -> t.Context() 2025-08-30 14:13:44 -03:00
cmd lncli: add wallet submitpackage command 2026-06-30 11:07:52 -07:00
contractcourt contractcourt: retain deadline across contest resolution 2026-08-05 23:31:51 -03:00
contrib docs: remove PIDFile from example systemd service 2022-01-11 14:08:18 +01:00
discovery discovery: bound channel range reply buffering 2026-07-30 15:19:26 -07:00
docker build: bump Go versions 2026-06-08 17:02:58 -03:00
docs docs: add 0.20.2 and 0.20.3 release notes to master 2026-08-07 13:55:36 -03:00
feature lint: remove redundant loop var copies in test files 2026-06-03 15:32:45 -03:00
fn build: bump Go versions 2026-06-08 17:02:58 -03:00
funding funding: use channel state open channel 2026-07-07 07:18:58 -03:00
graph htlcswitch: fix outgoing cltv spelling 2026-06-25 19:06:26 -03:00
healthcheck multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
htlcswitch Merge pull request #11023 from ellemouton/update-fee-log 2026-08-07 12:30:57 +08:00
input multi: fix lint findings from btcd v2 migration 2026-06-24 11:57:10 -07:00
internal/musig2v040 multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
invoices invoices: refine update handling 2026-08-05 08:28:51 -03:00
itest itest: cover blinded route next_node_id forwarding 2026-07-30 08:57:19 +00:00
keychain multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
kvdb kvdb/sqlbase: relax bulk migration isolation 2026-07-17 21:57:20 -03:00
labels multi: fix make fmt 2022-08-23 22:10:24 +08:00
lncfg Merge pull request #10813 from erickcestari/tor-v2-cleanup 2026-05-26 18:25:07 +08:00
lnencrypt lint: remove redundant loop var copies in test files 2026-06-03 15:32:45 -03:00
lnmock lnwallet+walletrpc: add SubmitPackage for v3 CPFP package relay 2026-06-30 11:07:52 -07:00
lnpeer chanstate: use channel type in lnpeer 2026-07-07 07:18:57 -03:00
lnrpc htlcswitch+lnrpc: report node-ID next hop to the off-chain HTLC interceptor 2026-07-30 08:57:18 +00:00
lntest itest: add SubmitPackage integration test 2026-06-30 11:07:52 -07:00
lntypes refactor: replace min/max helpers with built-in min/max 2025-02-06 09:45:10 +08:00
lnutils lint: remove redundant loop var copies in test files 2026-06-03 15:32:45 -03:00
lnwallet Merge pull request #11023 from ellemouton/update-fee-log 2026-08-07 12:30:57 +08:00
lnwire lnwire: cap decoded short channel IDs 2026-07-29 19:16:55 -07:00
macaroons multi: golang.org/x/net/context -> context 2025-08-30 14:13:44 -03:00
make build: bump Go versions 2026-06-08 17:02:58 -03:00
mobile build: bump Go versions 2026-06-08 17:02:58 -03:00
monitoring multi: start updating various loggers to use the new v2 type 2024-10-22 17:03:55 +02:00
msgmux multi: actor-based onion message forwarding 2026-03-02 15:46:21 +01:00
multimutex multimutex: add unit tests 2025-03-24 00:40:35 -03:00
nat multi: Fix typos [skip ci] 2022-01-24 12:19:02 +02:00
netann chanstate: use channel type in status manager 2026-07-07 07:18:57 -03:00
onionmessage Merge pull request #10789 from bitromortac/2604-bolt12-1a 2026-06-15 22:10:31 -03:00
payments/db htlcswitch/hop: decode next_node_id blinded hops 2026-07-30 08:54:35 +00:00
peer peer+lnwallet/chancloser: advance the legacy closer from one goroutine 2026-08-05 12:22:56 -07:00
peernotifier multi: start updating various loggers to use the new v2 type 2024-10-22 17:03:55 +02:00
pool multi: fix fmt.Errorf error wrapping 2024-02-27 11:13:40 +00:00
protofsm multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
queue multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
record htlcswitch/hop: decode next_node_id blinded hops 2026-07-30 08:54:35 +00:00
routing multi: represent the blinded forwarding next hop as an fn.Either 2026-07-29 14:02:00 +00:00
rpcperms multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
scripts scripts/keys: add pub key for boris 2026-08-10 15:57:48 -05:00
shachain multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
signal multi: start updating various loggers to use the new v2 type 2024-10-22 17:03:55 +02:00
sqldb sqldb/v2: bump pgx to v5.9.2 2026-06-09 07:56:53 -03:00
subscribe trivial: Fix spelling errors 2023-09-21 22:35:33 -04:00
sweep sweep: account for aux extra budget when filtering inputs 2026-07-09 08:52:50 -02:30
ticker build: bump Go versions 2026-06-08 17:02:58 -03:00
tlv tlv: use btcd v2 submodules 2026-06-12 15:38:06 +02:00
tools multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
tor multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
walletunlocker multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
watchtower chanstate: use channel types in watchtower 2026-07-07 07:18:58 -03:00
zpay32 multi: fix lint findings from btcd v2 migration 2026-06-24 11:57:10 -07:00
.editorconfig .editorconfig: add editor settings for most editors 2022-07-06 13:33:02 +02:00
.gitignore gitignore: ignore .worktrees 2026-03-26 17:07:12 +08:00
.golangci.yml Merge pull request #10872 from erickcestari/enable-copyloopvar-linter 2026-06-11 05:23:47 +08:00
.protolint.yaml protolint: configure protolint and fix the protolinting issues 2024-01-22 22:00:00 +02:00
accessman.go accessman: fix structured logging formatting 2025-07-01 07:43:26 +02:00
accessman_test.go multi: context.Background() -> t.Context() 2025-08-30 14:13:44 -03:00
channel_notifier.go chanstate: use channel type in backup notifier 2026-07-07 07:18:57 -03:00
chanrestore.go chanrestore: use channel state open channel 2026-07-07 07:18:59 -03:00
config.go config: check cltv expiry policy range 2026-06-25 18:56:39 -03:00
config_builder.go multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
config_onion_ratelimit_test.go lint: remove redundant loop var copies in test files 2026-06-03 15:32:45 -03:00
config_prod.go lnd: add clarifiying comment when introducing a new db 2026-03-17 20:55:23 +01:00
config_test.go config: check cltv expiry policy range 2026-06-25 18:56:39 -03:00
config_test_native_sql.go lnd: use sql store for payments in normal build 2026-03-17 20:55:23 +01:00
dev.Dockerfile dev.Dockerfile: use cache mounts to speed up rebuilding 2026-06-16 15:28:20 -04:00
doc.go lnd: rename package main->lnd 2019-04-23 20:57:33 +02:00
Dockerfile build: bump Go versions 2026-06-08 17:02:58 -03:00
go.mod Merge pull request #10900 from ellemouton/walletkit-submitpackage 2026-07-01 05:42:09 +08:00
go.sum Merge pull request #10900 from ellemouton/walletkit-submitpackage 2026-07-01 05:42:09 +08:00
intercepted_forward.go multi: update to fn v2 2024-12-04 13:19:00 -07:00
LICENSE multi: Update Licenses to 2022 [skip ci] 2022-02-09 00:25:20 +02:00
lnd.go multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
log.go chanstate: introduce Store interface 2026-05-11 18:54:30 -03:00
logo.png README: add logo to top portion of page 2017-09-29 14:06:31 -07:00
Makefile build: bump Go versions 2026-06-08 17:02:58 -03:00
pilot.go multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
README.md security: update security@ PGP key 2025-11-11 14:44:50 -08:00
rpcserver.go rpcserver: fix stats undercount in GetNetworkInfo 2026-07-13 09:29:09 -04:00
rpcserver_test.go multi: update to fn v2 2024-12-04 13:19:00 -07:00
sample-lnd.conf Merge pull request #10813 from erickcestari/tor-v2-cleanup 2026-05-26 18:25:07 +08:00
SECURITY.md security: update security@ PGP key 2025-11-11 14:44:50 -08:00
server.go server: use channel state open channel 2026-07-07 07:18:58 -03:00
server_test.go multi: drop tor v2 onion production, keep wire codec faithful 2026-05-22 09:42:37 -03:00
sqlc.yaml multi: add sqlc support 2023-07-10 17:36:58 -07:00
subrpcserver_config.go chanstate: remove store generics 2026-07-06 15:51:20 -03:00
sweeper_wallet.go multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
tls_manager.go tls_manager.go: handle case when either TLS pair files exist 2025-11-27 13:33:14 +00:00
tls_manager_test.go lint: remove redundant loop var copies in test files 2026-06-03 15:32:45 -03:00
types.go multi: upgrade to btcd v2 modules 2026-06-24 10:58:36 -07:00
witness_beacon.go witness beacon: report node-ID next hop to the on-chain HTLC interceptor 2026-07-30 08:57:19 +00:00
witness_beacon_test.go witness beacon: report node-ID next hop to the on-chain HTLC interceptor 2026-07-30 08:57:19 +00:00

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 APIs 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.

First-time contributors are highly encouraged to start with code review first, before creating their own Pull Requests.

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