Skip to content
A faucet for the Lightning Network!
Branch: master
Clone or download
Pull request Compare This branch is 21 commits ahead of lightninglabs:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
static multi: add new parameters Aug 14, 2019
.gitignore Add config file support (#6) May 2, 2019
.travis.yml hook up travis Jul 17, 2019
LICENSE add README, LICENSE and gitignore Jan 19, 2017
chainparams.go multi: add new parameters Aug 14, 2019
config.go multi: add new parameters Aug 14, 2019
go.mod multi: add new parameters Aug 14, 2019
go.sum Add generate invoice form Jun 11, 2019 hook up travis Jul 17, 2019
log.go use slog for logging. May 2, 2019
main.go multi: add new parameters Aug 14, 2019
sample-dcrlnfaucet.conf multi: add new parameters Aug 14, 2019

Lightning Network Faucet

MIT licensed     

The Lightning Network Faucet is a faucet that is currently deployed on the Decred testnet. The following faucets are currently available:

The Testnet Lightning Faucet (TLF) is similar to other existing Decred faucets. However, rather then sending dcr directly on-chain to a user of the faucet, the TLF will instead open a payment channel with the target user. The user can then either use their new link to the Lightning Network to facilitate payments, or immediately close the channel (which immediately credits them on-chain like regular faucets).

Currently the TLF is only compatible with dcrlnd.


In order to build from source, the following build dependencies are required:

  • Go: Installation instructions can be found here.

Minimum Go version supported is 1.11. This project uses go modules, so either compile it with GO111MODULES=on or outside of the $GOPATH.

With the preliminary steps completed, to install the Testnet Lightning Faucet

$ git clone src/
$ cd src/
$ go install -v

Deploying The Faucet

Once you have the faucet installed, you'll need to ensure you have a local dcrlnd active and fully synced.

Once the node is synced, execute the following command (from this directory) to deploy the faucet:

lightning-faucet --lnd_node=X.X.X.X:10009

Where X.X.X.X:10009 is the IP address and port for your active dcrlnd node.

To enable HTTPS support via Let's Encrypt, specify a few additional options:

lightning-faucet -lnd_node=X.X.X.X:10009 -use_le_https -domain
You can’t perform that action at this time.