How to send Bitcoin Lightning Network Payments using the terminal

In this guide I’m going to walk you through making a payment using ’s Layer 2 using to demonstrate. We will be using the command line as I’ve found this to be the most reliable way to use the network and doing so gives you a deeper understanding of how the network operates. Bitcoin Lightning Network testnet Prerequisites You have access to a lightning node that: 1. is running and and is synced to the testnet blockchain, 2. has blockstream’s cli tool, , installed and accessible in its . bitcoind lightningd c-lightning lightning-cli $PATH Check out my if you still need to set one up. guide to setting up a lightning network node 1. Generate Address and Fund Wallet Layer 1 BTC transactions = 1. Wait Time = 60 mins. Create a new address. Go to the and send yourself some bitcoin. Tip — use chrome to get that 70% bonus for using IPV6! testnet faucet Click on the transaction ID link that will appear just beneath which will take you to the with details of the transaction. blockchain explorer You need to wait for 6 confirmations — about 1 hour before the funds show up in your wallet. $ lightning-cli listfunds 2. Connect to a Peer and Create a Payment Channel Layer 1 BTC transactions = 1. Wait Time = 60 mins. In order to make payments on the network you first need to connect to it. How do you find another node to connect to? Head to Acinq’s . lightning network explorer Search for a well connected peer (one with a lot of channels) and copy its URI. I timed out on a few nodes initially, just keep trying and you’ll find one that connects immediately. $ lightning-cli connect 03e5f9d1935c67a029bf0a26af5f63109f4f4c45993a8f45177a8f2f39bcb46144 77.58.162.148 9735 $ lightning-cli list peers Now we will create a payment channel with the peer we just connected to. Opening and closing channels entails interacting with the main blockchain so we want to fund it with a decent amount (in millisatoshis) so that we can use it for several payments. $ lightning-cli fundchannel 03e5f9d1935c67a029bf0a26af5f63109f4f4c45993a8f45177a8f2f39bcb46144 50000 $ lightning-cli listpeers Again, search for the in the and wait for 3-6 confirmations before the channel is considered open. When it is you should see the status changed to . txid bitcoin testnet explorer CHANNELD_NORMAL $ lightning-cli listpeers 3. Generate Payment Request Now we have a confirmed channel established we can start using the lightning network for transactions. Go to an article on and click on the “continue reading” button to generate a payment request. This is essentially a serialised invoice. Decode it to check that you are not being overcharged! Y’alls $ lightning-cli decodepay lntb1500n1pdvp7t9pp5k5mvp8u045pdnumnt89cdc7l90lpvff7sjzkrvawg93ju3mgg3nsdp62fjkzepqg9e8g6trd3jn5gzfyp9kummhyptksmeq2dshgmmndp5jqjtnp5cqzyskw8lzg7w4hcfyhncczcaexlpx3tdefm0vjnh9dkqev23g94tdta8jjqzp87v6r9q8xwe3mnjf0tryaa7zkxxj4gwgfcqea32j0x069qqsjyjhz 4. Make the Payment Layer 2 BTC transactions = 1. Wait Time = milliseconds. Now we have everything in place to make a layer 2 bitcoin transaction which should be instantly confirmed. $ lightning-cli pay lntb1500n1pdvp7t9pp5k5mvp8u045pdnumnt89cdc7l90lpvff7sjzkrvawg93ju3mgg3nsdp62fjkzepqg9e8g6trd3jn5gzfyp9kummhyptksmeq2dshgmmndp5jqjtnp5cqzyskw8lzg7w4hcfyhncczcaexlpx3tdefm0vjnh9dkqev23g94tdta8jjqzp87v6r9q8xwe3mnjf0tryaa7zkxxj4gwgfcqea32j0x069qqsjyjhz Go back to Y’alls and click on the “check for payment” button to reveal the article. Unfortunately this didn’t work for me. When I checked on the command line I discovered that indeed no payments had been made. $ lightning-cli listpayments{ "payments": [] } To try to solve this issue, I attempted to create a payment channel with Y’alls directly (their address is listed as “peer” when they create you an invoice to continue reading). $ lightning-cli connect 039cc950286a8fa99218283d1adc2456e0d5e81be558da77dd6e85ba9a1fff5ad3 34.200.252.146 $ lightning-cli fundchannel 039cc950286a8fa99218283d1adc2456e0d5e81be558da77dd6e85ba9a1fff5ad3 500000 Apparently this is a with , which Y’alls must be using as their lightning daemon. known bug [lnd](https://github.com/lightningnetwork/lnd) As a backup plan we’ll send a payment to ourselves using a web lightning wallet. Go to and generate a wallet and then click on the “receive” tab to request a payment of 0.0001 tBTC ($0.65 tUSD). Copy the serialised invoice and check it before sending payment. htlc.me $ lightning-cli decodepay lntb100u1pdvzzc4pp5h55942ehdpy5g70sty9mnvt3k2wlvt4ucnctnellau8drhaew8lsdqqcqzyswv3n3vyzx9uua4tjl8ttcp5fp7srn80zywvg4vses6fj4q9n3v846mgkuu648u37venf93znkckadjejvddv04vyq5l2krx486z23ysqhcrxg6 This time when I attempted payment I received multiple errors. $ lightning-cli pay lntb100u1pdvzzc4pp5h55942ehdpy5g70sty9mnvt3k2wlvt4ucnctnellau8drhaew8lsdqqcqzyswv3n3vyzx9uua4tjl8ttcp5fp7srn80zywvg4vses6fj4q9n3v846mgkuu648u37venf93znkckadjejvddv04vyq5l2krx486z23ysqhcrxg6 However, when I refreshed the web page I saw that the payment had in fact succeeded. Checking in the console confirmed that payment had been made. htlc.me $ lightning-cli listpayments We sent a payment and paid just 2020 millisatoshi in transaction fees ($0.00013 USD at the time of writing)! Finally, let’s try to connect with directly so we don’t get any console errors when making payment. Copy the id from the command output above and search for it in the . Copy the URI then connect to it and create a channel. htlc.me payee decodepay lightning network explorer $ lightning-cli connect 03193d512b010997885b232ecd6b300917e5288de8785d6d9f619a8952728c78e8 34.201.11.250 9735 $ lightning-cli fundchannel 03193d512b010997885b232ecd6b300917e5288de8785d6d9f619a8952728c78e8 500000 Unfortunately we need to wait for the transaction to confirm on the blockchain so that the channel becomes usable. An hour later we can see the channel is established — the status is . **CHANNELD_NORMAL** $ lightning-cli listpeers Now generate another invoice on , this time for 0.00020000 tBTC ($1.31 tUSD) and check the details are correct before paying it. htlc.me $ lightning-cli decodepay lntb200u1pdvzvf8pp5tyjfw9ma9uj8hhrhqvmum9vzvaun45qg6mmesu3c08zkhmgl44ssdqqcqzysah4qe4zef3rssusa42cyx0gxxq6q06g50m38w7chz50en80dfh45fj7kdgpx474udehq22mv2pwxfky66kdjdrw88z34w8hjjdjdu6sq6zy2a4 Finally make the payment. $ lightning-cli pay lntb200u1pdvzvf8pp5tyjfw9ma9uj8hhrhqvmum9vzvaun45qg6mmesu3c08zkhmgl44ssdqqcqzysah4qe4zef3rssusa42cyx0gxxq6q06g50m38w7chz50en80dfh45fj7kdgpx474udehq22mv2pwxfky66kdjdrw88z34w8hjjdjdu6sq6zy2a4 This time no console errors. Your web wallet at should immediately detect the payment. You should now be able to make any number of subsequent payments instantly and with similarly low fees until you deplete the funds in your channel or it expires. htlc.me Conclusion As you can see, the nodes on testnet are sketchy to say the least. The three main lightning software implementations (lnd, c-lightning, eclair) are all still in the early stages of development so it’s not surprising that a few bugs exist. But this should at least give you a flavour of how cheap and fast transactions will be in the future when the network is bigger and the software running it more mature. Originally published at andrewgriffithsonline .com.