mirror of
https://github.com/ElementsProject/lightning.git
synced 2024-11-20 02:27:51 +01:00
55173a56b7
Before this patch we used `int` for error codes. The problem with `int` is that we try to pass it to/from wire and the size of `int` is not defined by the standard. So a sender with 4-byte `int` would write 4 bytes to the wire and a receiver with 2-byte `int` (for example) would read just 2 bytes from the wire. To resolve this: * Introduce an error code type with a known size: `typedef s32 errcode_t`. * Change all error code macros to constants of type `errcode_t`. Constants also play better with gdb - it would visualize the name of the constant instead of the numeric value. * Change all functions that take error codes to take the new type `errcode_t` instead of `int`. * Introduce towire / fromwire functions to send / receive the newly added type `errcode_t` and use it instead of `towire_int()`. In addition: * Remove the now unneeded `towire_int()`. * Replace a hardcoded error code `-2` with a new constant `INVOICE_EXPIRED_DURING_WAIT` (903). Changelog-Changed: The waitinvoice command would now return error code 903 to designate that the invoice expired during wait, instead of the previous -2
45 lines
1.1 KiB
Groff
Generated
45 lines
1.1 KiB
Groff
Generated
.TH "LIGHTNING-WAITINVOICE" "7" "" "" "lightning-waitinvoice"
|
|
.SH NAME
|
|
lightning-waitinvoice - Command for waiting for specific payment
|
|
.SH SYNOPSIS
|
|
|
|
\fBwaitinvoice\fR \fIlabel\fR
|
|
|
|
.SH DESCRIPTION
|
|
|
|
The \fBwaitinvoice\fR RPC command waits until a specific invoice is paid,
|
|
then returns that single entry as per \fBlistinvoice\fR\.
|
|
|
|
.SH RETURN VALUE
|
|
|
|
On success, an invoice description will be returned as per
|
|
\fBlightning-listinvoice\fR(7)\. The \fIstatus\fR field will be \fIpaid\fR\.
|
|
|
|
|
|
On error the returned object will contain \fBcode\fR and \fBmessage\fR properties,
|
|
with \fBcode\fR being one of the following:
|
|
|
|
.RS
|
|
.IP \[bu]
|
|
-32602: If the given parameters are wrong\.
|
|
.IP \[bu]
|
|
-1: If the invoice is deleted while unpaid, or the invoice does not exist\.
|
|
.IP \[bu]
|
|
903: If the invoice expires before being paid, or is already expired\.
|
|
|
|
.RE
|
|
.SH AUTHOR
|
|
|
|
Christian Decker \fI<decker.christian@gmail.com\fR> is mainly
|
|
responsible\.
|
|
|
|
.SH SEE ALSO
|
|
|
|
\fBlightning-waitanyinvoice\fR(7), \fBlightning-listinvoice\fR(7),
|
|
\fBlightning-delinvoice\fR(7), \fBlightning-invoice\fR(7)
|
|
|
|
.SH RESOURCES
|
|
|
|
Main web site: \fIhttps://github.com/ElementsProject/lightning\fR
|
|
|