mirror of
https://github.com/ElementsProject/lightning.git
synced 2024-11-19 18:11:28 +01:00
ba7d4a8f6b
We were including the entire list of prerequisites when generating a shastamp, which for schemas includes the `tools/fromschema.py` doc. This meant all of our shasums were updating anytime this tool file changed. Instead, we just include the first prerequisite. See: https://www.gnu.org/software/make/manual/html_node/Automatic-Variables.html#Automatic-Variables
2.5 KiB
2.5 KiB
lightning-listoffers -- Command for listing offers
SYNOPSIS
(WARNING: experimental-offers only)
listoffers [offer_id] [active_only]
DESCRIPTION
The listoffers RPC command list all offers, or with offer_id
,
only the offer with that offer_id (if it exists). If active_only
is
set and is true, only offers with active
true are returned.
EXAMPLE JSON REQUEST
{
"id": 82,
"method": "listoffers",
"params": {
"active_only": false
}
}
RETURN VALUE
On success, an object containing offers is returned. It is an array of objects, where each object contains:
- offer_id (hex): the id of this offer (merkle hash of non-signature fields) (always 64 characters)
- active (boolean): whether this can still be used
- single_use (boolean): whether this expires as soon as it's paid
- bolt12 (string): the bolt12 encoding of the offer
- bolt12_unsigned (string): the bolt12 encoding of the offer, without signature
- used (boolean): True if an associated invoice has been paid
- label (string, optional): the (optional) user-specified label
EXAMPLE JSON RESPONSE
{
"offers": [
{
"offer_id": "053a5c566fbea2681a5ff9c05a913da23e45b95d09ef5bd25d7d408f23da7084",
"active": true,
"single_use": false,
"bolt12": "lno1qgsqvgnwgcg35z6ee2h3yczraddm72xrfua9uve2rlrm9deu7xyfzrcgqvqcdgq2z9pk7enxv4jjqen0wgs8yatnw3ujz83qkc6rvp4j28rt3dtrn32zkvdy7efhnlrpr5rp5geqxs783wtlj550qs8czzku4nk3pqp6m593qxgunzuqcwkmgqkmp6ty0wyvjcqdguv3pnpukedwn6cr87m89t74h3auyaeg89xkvgzpac70z3m9rn5xzu28c",
"used": false
},
{
"offer_id": "3247d3597fec19e362ca683416a48a0f76a44c1600725a7ee1936548feadacca",
"active": true,
"single_use": false,
"bolt12": "lno1qgsqvgnwgcg35z6ee2h3yczraddm72xrfua9uve2rlrm9deu7xyfzrcxqd24x3qgqgqlgzs3gdhkven9v5sxvmmjype82um50ys3ug9kxsmqdvj3c6ut2cuu2s4nrf8k2dulccgaqcdzxgp583utjlu49rcyqt8hc3s797umxn3r9367rdqc577rma7key58fywkajxnuzyapge86hj2pg80rjrma40xdqrxnsnva5l3ce7hz4ua8wf755dees4y9vnq",
"used": true
}
]
}
AUTHOR
Rusty Russell <rusty@rustcorp.com.au> is mainly responsible.
SEE ALSO
lightning-offer(7), lightning-offerout(7), lightning-listoffers(7).
RESOURCES
Main web site: https://github.com/ElementsProject/lightning comment: # ( SHA256STAMP:aad235e8255da495032f638a7066b05d651e2c99b668f7b3afffb21d908c788a)