LndHub
Wrapper for Lightning Network Daemon (lnd). It provides separate accounts with minimum trust for end users.
INSTALLATION
You can use those guides or follow instructions below:
- https://github.com/dangeross/guides/blob/master/raspibolt/raspibolt_6B_lndhub.md
- https://medium.com/@jpthor/running-lndhub-on-mac-osx-5be6671b2e0c
git clone [email protected]:BlueWallet/LndHub.git
cd LndHub
npm i
Install bitcoind, lnd, and redis. Edit LndHub's config.js to set it up correctly.
Copy the files admin.macaroon (for Bitcoin mainnet, usually stored in ~/.lnd/data/chain/bitcoin/mainnet/admin.macaroon)
and tls.cert (usually stored in ~/.lnd/tls.cert) into the root folder of LndHub.
LndHub expects LND's wallet to be unlocked, if not — it will attempt to unlock it with the password stored in config.lnd.password.
Don't forget to configure disk-persistence for redis (e.g., you may want to set appendonly to yes in redis.conf (see
http://redis.io/topics/persistence for more information).
If you have no bitcoind instance, for example if you use neutrino, or you have no bitcoind wallet,
for example if you use LND for wallet managment, you can remove the bitcoind settings from config.js.
Please note that this feature is limited to Bitcoin, so you can't use it if you use any other cryptocurrency with LND (e.g., Litecoin).
Deploy to Heroku
Add config vars :
CONFIG: json serialized config objectMACAROON: hex-encodedadmin.macaroonTLSCERT: hex-encodedtls.cert
Run in docker
LndHub is available on Docker Hub as bluewalletorganization/lndhub.
Please note that this requires a separate instance of redis and LND and optionally, bitcoind.
You can also view Umbrel's implementation using docker-compose here.
Reference client implementation
Can be used in ReactNative or Nodejs environment
Tests
Acceptance tests are in https://github.com/BlueWallet/BlueWallet/blob/master/tests/integration/lightning-custodian-wallet.test.js
Responsible disclosure
Found critical bugs/vulnerabilities? Please email them to [email protected] Thanks!