51 lines
1.5 KiB
Plaintext
51 lines
1.5 KiB
Plaintext
LIGHTNING-LISTSENDPAYS(7)
|
|
========================
|
|
:doctype: manpage
|
|
|
|
NAME
|
|
----
|
|
lightning-listsendpays - Low-level command for querying sendpay status
|
|
|
|
SYNOPSIS
|
|
--------
|
|
*listsendpays* ['bolt11'] ['payment_hash']
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
|
|
The *listsendpays* RPC command gets the status of all 'sendpay'
|
|
commands (which is also used by the 'pay' command), or with 'bolt11'
|
|
or 'payment_hash' limits results to that specific payment. You cannot
|
|
specify both.
|
|
|
|
Note that in future there may be more than one concurrent 'sendpay'
|
|
command per 'pay', so this command should be used with caution.
|
|
|
|
RETURN VALUE
|
|
------------
|
|
On success, an array of objects is returned. Each object contains:
|
|
|
|
'id':: unique internal value assigned at creation
|
|
'payment_hash':: the hash of the 'payment_preimage' which will prove payment.
|
|
'destination':: the final destination of the payment.
|
|
'amount_msat':: the amount the destination received, in "NNNmsat" format.
|
|
'created_at':: the UNIX timestamp showing when this payment was initiated.
|
|
'status':: one of 'complete', 'failed' or 'pending'.
|
|
'payment_preimage':: (if 'status' is 'complete') proves payment was received.
|
|
'label':: optional 'label', if provided to 'sendpay'.
|
|
'bolt11':: the 'bolt11' argument given to 'pay' (may be missing for pre-0.7 payments).
|
|
|
|
//FIXME:Enumerate errors
|
|
|
|
AUTHOR
|
|
------
|
|
Christian Decker <decker.christian@gmail.com> is mainly responsible.
|
|
|
|
SEE ALSO
|
|
--------
|
|
lightning-listpays(7), lightning-sendpay(7), lightning-listinvoice(7).
|
|
|
|
RESOURCES
|
|
---------
|
|
Main web site: https://github.com/ElementsProject/lightning
|