88 lines
2.6 KiB
Groff
88 lines
2.6 KiB
Groff
.TH "LIGHTNING-LISTOFFERS" "7" "" "" "lightning-listoffers"
|
|
.SH NAME
|
|
lightning-listoffers - Command for listing offers
|
|
.SH SYNOPSIS
|
|
|
|
\fB(WARNING: experimental-offers only)\fR
|
|
|
|
|
|
\fBlistoffers\fR [\fIoffer_id\fR] [\fIactive_only\fR]
|
|
|
|
.SH DESCRIPTION
|
|
|
|
The \fBlistoffers\fR RPC command list all offers, or with \fBoffer_id\fR,
|
|
only the offer with that offer_id (if it exists)\. If \fBactive_only\fR is
|
|
set and is true, only offers with \fBactive\fR true are returned\.
|
|
|
|
.SH EXAMPLE JSON REQUEST
|
|
.nf
|
|
.RS
|
|
{
|
|
"id": 82,
|
|
"method": "listoffers",
|
|
"params": {
|
|
"active_only": false
|
|
}
|
|
}
|
|
.RE
|
|
|
|
.fi
|
|
.SH RETURN VALUE
|
|
|
|
On success, an object containing \fBoffers\fR is returned\. It is an array of objects, where each object contains:
|
|
|
|
.RS
|
|
.IP \[bu]
|
|
\fBoffer_id\fR (hex): the id of this offer (merkle hash of non-signature fields) (always 64 characters)
|
|
.IP \[bu]
|
|
\fBactive\fR (boolean): whether this can still be used
|
|
.IP \[bu]
|
|
\fBsingle_use\fR (boolean): whether this expires as soon as it's paid
|
|
.IP \[bu]
|
|
\fBbolt12\fR (string): the bolt12 encoding of the offer
|
|
.IP \[bu]
|
|
\fBbolt12_unsigned\fR (string): the bolt12 encoding of the offer, without signature
|
|
.IP \[bu]
|
|
\fBused\fR (boolean): True if an associated invoice has been paid
|
|
.IP \[bu]
|
|
\fBlabel\fR (string, optional): the (optional) user-specified label
|
|
|
|
.RE
|
|
.SH EXAMPLE JSON RESPONSE
|
|
.nf
|
|
.RS
|
|
{
|
|
"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
|
|
}
|
|
]
|
|
}
|
|
.RE
|
|
|
|
.fi
|
|
.SH AUTHOR
|
|
|
|
Rusty Russell \fI<rusty@rustcorp.com.au\fR> is mainly responsible\.
|
|
|
|
.SH SEE ALSO
|
|
|
|
\fBlightning-offer\fR(7), \fBlightning-offerout\fR(7), \fBlightning-listoffers\fR(7)\.
|
|
|
|
.SH RESOURCES
|
|
|
|
Main web site: \fIhttps://github.com/ElementsProject/lightning\fR
|
|
|
|
\" SHA256STAMP:bf83e52cc56aaef876eb1039a6fbbcd9d2e15703c54f33163176c7ba41523261
|