mirror of
https://github.com/ElementsProject/lightning.git
synced 2024-11-19 09:54:16 +01:00
46 lines
1.3 KiB
Plaintext
46 lines
1.3 KiB
Plaintext
LIGHTNING-WAITANYINVOICE(7)
|
|
===========================
|
|
:doctype: manpage
|
|
|
|
NAME
|
|
----
|
|
lightning-waitanyinvoice - Protocol for waiting for payments.
|
|
|
|
SYNOPSIS
|
|
--------
|
|
*waitanyinvoice* ['lastpay_index']
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
The *waitanyinvoice* RPC command waits until an invoice is paid, then
|
|
returns a single entry as per *listinvoice*. It will not return for
|
|
any invoices paid prior to or including the 'lastpay_index'.
|
|
|
|
This is usually called iteratively: once with no arguments, then
|
|
repeatedly with the returned 'pay_index' entry. This ensures that no paid
|
|
invoice is missed.
|
|
|
|
The 'pay_index' is a monotonically-increasing number assigned to an
|
|
invoice when it gets paid. The first valid 'pay_index' is 1; specifying
|
|
'lastpay_index' of 0 equivalent to not specifying a 'lastpay_index'.
|
|
Negative 'lastpay_index' is invalid.
|
|
|
|
|
|
RETURN VALUE
|
|
------------
|
|
On success, an invoice description will be returned as per lightning-listinvoice(7): 'complete' will always be 'true'.
|
|
|
|
//FIXME:Enumerate errors
|
|
|
|
AUTHOR
|
|
------
|
|
Rusty Russell <rusty@rustcorp.com.au> is mainly responsible.
|
|
|
|
SEE ALSO
|
|
--------
|
|
lightning-waitinvoice(7), lightning-listinvoice(7), lightning-delinvoice(7), lightning-invoice(7).
|
|
|
|
RESOURCES
|
|
---------
|
|
Main web site: https://github.com/ElementsProject/lightning
|