Skip to content

Latest commit

 

History

History
170 lines (125 loc) · 6.38 KB

README.md

File metadata and controls

170 lines (125 loc) · 6.38 KB

Workshop: The Lightning Network

Slides, links and tutorials used for the workshop on the Lightning Network.

Links to slides:

Task 1: Install Lightning Network wallet

In this first task we are going to install one of the already many software wallets that exist for the Lightning Network.

For the workshop we are going to focus on these three options even if there are others available. So please choose one, preferably based on your skill.

Option 1a (easy, Android only): Eclair Wallet Testnet

Option 1b (easy, iOS only): CoinClip Testnet

  • Go to the Apple App Store and install the CoinClip Testnet
  • Start the app, wait for it to sync and find your wallet's Bitcoin address (button "Receive" in the section with the chain icon, should start with 2... for Testnet)
  • Go to testnet.manu.backend.hamburg/faucet and send yourself some Testnet Bitcoins

Option 2 (advanced, GUI): Zap desktop wallet

Requirements:

  • Node.js version >= 8
  • npm version >= 5
  • yarn

Once you have installed the tools mentioned above continue here:

Option 3a (advanced, CLI): Command line

Create a directory where the data for the lnd process will be stored. For the example we will assume that the directory is /tmp/lnd. Also add the binaries from LND binary releases and add them to the PATH environment variable.

Open one command line window and run the following command:

lnd \
  --lnddir=/tmp/lnd \
  --logdir=/tmp/lnd \
  --bitcoin.active \
  --bitcoin.testnet \
  --bitcoin.node=neutrino \
  --neutrino.addpeer=btcd0.lightning.computer:18333 \
  --neutrino.addpeer=faucet.lightning.community \
  --neutrino.addpeer=lnd.bitrefill.com:18333 \
  --autopilot.maxchannels=0 \
  --autopilot.allocation=0 \
  --debuglevel=debug

If no critical error messages are printed and you see the message Waiting for wallet encryption password, you can create a wallet with the command:

lncli --lnddir=/tmp/lnd create

This should create a new wallet and sync the blockchain.

You can get the status of your node with the command:

lncli --lnddir=/tmp/lnd getinfo

To get an overview of all available commands, run:

lncli --lnddir=/tmp/lnd help

To get a wallet address, run the following command:

lncli --lnddir=/tmp/lnd newaddress np2wkh

This might take a while if the wallet is not yet synced to the chain. But finally an address starting with 2... should be printed.

Option 3b (advanced, CLI): Docker container

Create a directory where the data for the lnd process will be stored. For the example we will assume that the directory is /tmp/lnd.

Run the following command to pull and run a docker image:

docker run -d \
  -v /tmp/lnd:/root/.lnd \
  --restart=unless-stopped \
  --name=lnd \
  --entrypoint= \
  guggero/lnd \
  lnd \
  --logdir="/root/.lnd" \
  --bitcoin.active \
  --bitcoin.testnet \
  --bitcoin.node=neutrino \
  --neutrino.addpeer=btcd0.lightning.computer:18333 \
  --neutrino.addpeer=faucet.lightning.community \
  --neutrino.addpeer=lnd.bitrefill.com:18333 \
  --autopilot.maxchannels=0 \
  --autopilot.allocation=0 \
  --debuglevel=debug

This should start lnd in a container. The log can be viewed with docker logs -f lnd.

Now create a wallet with the command line tool that comes with lnd:

docker exec -ti lnd lncli create

To use the command line tool that comes with lnd, use the following command (for example, to get the node info with getinfo):

docker exec -ti lnd lncli getinfo

To get an overview of all available commands, run:

docker exec -ti lnd lncli help

To get a wallet address, run the following command:

docker exec -ti lnd lncli newaddress np2wkh

This might take a while if the wallet is not yet synced to the chain. But finally an address starting with 2... should be printed.

Go to testnet.manu.backend.hamburg/faucet and send yourself some Testnet Bitcoins!

Task 2: Open a Payment Channel

  • Go to lightning-test.puzzle.ch
  • Connect to the node that is described there and open a channel
    • Android app: Find a menu that reads "Scan node URI"
    • iOS app: Find a button that reads "Open channel", then click "Scan Pubkey@HostIP"
    • Zap: Add a new "Contact". This will connect and also open a payment channel
    • Command line:
      • lncli --lnddir=/tmp/lnd connect pubkey@ip:port
      • lncli --lnddir=/tmp/lnd openchannel pubkey amount
      • lncli --lnddir=/tmp/lnd listchannels
    • Docker:
      • docker exec -ti lnd lncli connect pubkey@ip:port
      • docker exec -ti lnd lncli openchannel pubkey amount
      • docker exec -ti lnd lncli listchannels