Interledger Lightning Plugin
🚨 Expect breaking changes while this plugin is in beta.
ilp-plugin-lightning enables settlements between Interledger peers using the Lightning Network on Bitcoin. Using the ILP/Stream protocol, payments are chunked down into small increments, which can facilitate faster and more relaible payments compared with native Lightning!
The integration requires an existing Lightning node with connectivity to the greater Lightning network. Note that speed within the Lightning network degrades as two peers have more degrees of separation, and opening a direct channel provides a much faster experience.
Additional information on the Lightning Network is available here.
npm install ilp-plugin-lightning
Requires Node.js 10+.
Here are the available options to pass to the plugin. Additional configuration options are also inherited from ilp-plugin-btp if the plugin is a client, and ilp-plugin-mini-accounts if the plugin is a server.
Clients do not settle automatically. Sending Lightning payments can be triggered by invoking
sendMoney on the plugin, and the money handler is called upon receipt of incoming payments (set using
The balance configuration has been simplified for servers. Clients must prefund before sending any packets through a server, and if a client fulfills packets sent to them through a server, the server will automatically settle such that they owe 0 to the client. This configuration was chosen as a default due to it's security and protection against deadlocks.
"client"to connect to a single counterparty
"server"enables multiple counterparties to connect
- Credentials to create a connection to the LND node, or an already constructed LND service
To have the plugin create the connection internally, provide an object with the following properties:
- LND macaroon to used authenticate daemon requests as a Base64-encoded string or Buffer (e.g. using
- TLS certificate to authenticate the connection to the Lightning daemon as a Base64-encoded string or Buffer (e.g. using
- Hostname of the Lightning node
- Port of LND gRPC server
- Maximum amount in satoshis above which an incoming ILP packet should be rejected
This plugin uses the Bilateral Transfer Protocol over WebSockets to send messages between peers. Two subprotocols are supported:
[Identity public key]@[hostname]:[port], UTF-8 encoded
- Used for sharing peering information of our Lightning node with the peer
- The receiver of the message will subsequently attempt to peer over the Lightning network
- Format: BOLT11 encoded, then UTF-8 encoded
- Used to send a invoice to the Interledger peer, so they have the ability to send payments to our instance
- By default, peers send 20 invoices ahead of time, and share an additional invoice as each invoice expires or is paid
- LND does not currently support pruning invoices (neither automatically nor manually). As this plugin may generate several invoices per second when a peer is actively streaming money, this can significantly increase the footprint of the LND database.
- LND may soon support spontaneous payments, which would eliminate the overhead of frequently sharing invoices.
- The plugin does not perform any accounting for Lightning Network fees.