If you want to experiment with
lightningd, there's a script to set up a
bitcoind regtest test network of two local lightning nodes, which provides a convenient
start_ln helper. See the notes at the top of the
startup_regtest.sh file for details on how to use it.
To test with real bitcoin, you will need to have a local
bitcoind node running:
bitcoind has synchronized with the network.
Make sure that you do not have
walletbroadcast=0 in your
~/.bitcoin/bitcoin.conf, or you may run into trouble.
Notice that running
lightningd against a pruned node may cause some issues if not managed carefully, see pruning for more information.
You can start
lightningd with the following command:
lightningd --network=bitcoin --log-level=debug
This creates a
.lightning/ subdirectory in your home directory: see
man -l doc/lightningd.8 (or ???) for more runtime options.
You can use
[lightning-cli](ref:lightning-cli) help to print a table of RPC methods;
[lightning-cli](lightning-cli) help <command> will offer specific information on that command.
- lightning-newaddr: get a bitcoin address to deposit funds into your lightning node.
- lightning-listfunds: see where your funds are.
- lightning-connect: connect to another lightning node.
- lightning-fundchannel: create a channel to another connected node.
- lightning-invoice: create an invoice to get paid by another node.
- lightning-pay: pay someone else's invoice.
- lightning-plugin: commands to control extensions.
Once you've started for the first time, there's a script called
contrib/bootstrap-node.sh which will connect you to other nodes on the lightning network.
There are also numerous plugins available for Core Lightning which add capabilities: see the Plugins guide, and check out the plugin collection at: https://github.com/lightningd/plugins, including helpme which guides you through setting up your first channels and customising your node.
For a less reckless experience, you can encrypt the HD wallet seed: see HD wallet encryption.
Updated 10 days ago