You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

49 lines
2.2 KiB

# Lightning Protocol Reference Implementation
In this repository we're developing a reference implementation of
bitcoin lightning (see:
[http://lightning.network](http://lightning.network) which proposed
the original "lightning network").
This implementation is being developed in parallel with the protocol
definition, which you can find [on my fork of the protocol description repository](https://github.com/rustyrussell/lightning).
If you're interested in using the daemon to test payments, the
JSON-RPC interface is documented in the following manual pages:
* [invoice](doc/lightning-invoice.7.txt)
* [listinvoice](doc/lightning-listinvoice.7.txt)
* [waitinvoice](doc/lightning-waitinvoice.7.txt)
* [delinvoice](doc/lightning-delinvoice.7.txt)
* [getroute](doc/lightning-getroute.7.txt)
* [sendpay](doc/lightning-sendpay.7.txt)
Steps:
0. If you're running a previous version, you'll need to shut it down
(maybe close channels first) and delete the $HOME/.lightning directory.
1. [Install and compile](INSTALL.md) the requirements.
2. Make sure bitcoind is running in testnet mode, and has the latest
blocks.
3. Get some test bitcoins, such as from [TPs' testnet faucet](http://tpfaucet.appspot.com/).
3. If you want others to connect to your lightningd, create $HOME/.lightning/config and put `port=8334` in it (or any other port).
4. Run `daemon/lightningd`.
6. Run `daemon/lightning-cli getinfo` to check it's working.
7. Find a node using `daemon/lightning-cli getnodes` (this will populate
over time).
8. Create a new connection to the node using `contrib/lightning-open-channel
ADDRESS PORT AMOUNT` where AMOUNT is in BTC (.04294967 is the maximum
possible). If successful, this will return only once a block has been
mined with the funding transaction in it.
9. You can create more channels if you wish.
10. You can accept payment using `daemon/lightning-cli invoice
MILLISATOSHI LABEL`; it will give you a payment hash to give to the
payer.
11. You can send payments using `contrib/lightning-pay DEST-ID MILLISATOSHI PAYMENT-HASH`.
Final note: This is very much a testbed and work in progress; expect
All The Things to change, all the time.
Welcome aboard!
Rusty.