eclair testnet

version

• eclair
  • Eclair v0.2-alpha10
• ptarmigan
  • tag 2018-03-13
  • When ptarmigan version up with DB change is done, you need DB clean(rm -rf db).

---

Set up nodes in separate computers

• First, IP adresses are xx.xx.xx.xx and yy.yy.yy.yy respectively for eclair and ptarmigan.

Steps

Let’s create a channel

1. Running bitcoin node

• [bitcoind] ~/.bitcoin/bitcoin.conf

rpcuser=bitcoinuser
rpcpassword=bitcoinpassword
server=1
txindex=1
testnet=1

• [eclair] ~/.eclair/eclair.conf

eclair.bitcoind.rpcuser=bitcoinuser
eclair.bitcoind.rpcpassword=bitcoinpassword
eclair.api.enabled=true
eclair.api.password=xxxxx

1. Running bitcoind

• eclair + bitcoind v0.16

bitcoind -deprecatedrpc=addwitnessaddress -daemon

• eclair + bitcoind v0.15

bitcoind -daemon

• ptarmigan

bitcoind -daemon

1. Waiting for synchronization

2. [ptarmigan] Running ptarmd

cd install
./new_nodedir.sh
cd node
../ptarmd --network=testnet&

1. [eclair] Running eclair

• Remove old DB.

rm ~/.eclair/eclair.log  ~/.eclair/eclair.sqlite  ~/.eclair/network.sqlite

• Running eclair

java -jar eclair-node-0.2-alpha10-0beca13.jar

• Downloading a client app
  • Edit eclair-cli downloaded. Fill the same words as eclair.api.password on eclair.conf in PASSWORD in the 8th line of text editor.
  • If not, you will be asked it every time.

wget https://raw.githubusercontent.com/ACINQ/eclair/master/eclair-core/eclair-cli
chmod u+x eclair-cli

1. [eclair] Getting node_id

./eclair-cli getinfo

1. [ptarmigan] Creating fund-in transaction

../pay_fundin.py 1000000 0

• Create a channel that sends you 10mBTC and the other person 0.
  • 1000000 (fund-in satoshi) is the amount of money that is sent to an adress before sending payment to the channel.
  • 1000000 (channel satoshi) is the amount of sending payment to the channel.
  • 0 (push msatoshi) is the amount out of channel satoshi to be sent to the other person.
• pay_fundin.py will create a file in fund_yyyymmddhhmmss.conf format.

1. [ptarmigan] Starting Channel Establishment

• If you get an error that feerate_per_kw is wrong, change fund_yyyymmddhhmmss.conf.
  • Add feerate_per_kw=zzzzz(zzzzz is an approximate value to an error message localFeeratePerKw) in the last line.

../ptarmcli -c [PEER NODE_ID]@[IPv4 ADDR]:[PORT]
../ptarmcli -c [PEER NODE_ID] -f fund_yyyymmddhhmmss.conf

1. [btc] Waiting for generating a block

The channel is gererated after reaching two blocks.

When status is established in a result of -l, we can confirm that if the channel is generated.
Combining watch and jq is also available for observing it.

watch -n 10 "../ptarmcli -l | jq '.result.client[].status'"

Now, we will move on how to send payment.

ptarmigan –> eclair

1. [eclair] Generating an invoice

./eclair-cli receive 100000000 abc

• A unit is msatoshi.
  • 100000000 msat = 1 mBTC
  • You don’t need to be concerned about “abc”.

1. [ptarmigan] Sending payment

../ptarmcli -r <BOLT11 invoice>

1. [ptarmigan] Confirming the amount after running it

../showdb -w | jq

eclair –> ptarmigan

1. [ptarmigan] Cenerating an invoice

../ptarmcli -i 20000

• A unit is msatoshi.
  • 20000 msat = 20 satoshi

1. [eclair] Sending payment

./eclair-cli send <BOLT11 invoice>

1. [eclair] Confirming the amount after running it

./eclair-cli channels
(getting channelId)

./eclair-cli channel <channelId>