|
|
|
.TH "LIGHTNING-TXDISCARD" "7" "" "" "lightning-txdiscard"
|
|
|
|
.SH NAME
|
|
|
|
lightning-txdiscard - Abandon a transaction from txprepare, release inputs
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
|
|
|
\fBtxdiscard\fR \fItxid\fR
|
|
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
|
|
|
The \fBtxdiscard\fR RPC command releases inputs which were reserved for
|
|
|
|
use of the \fItxid\fR from \fBlightning-txprepare\fR(7)\.
|
|
|
|
|
|
|
|
.SH RETURN VALUE
|
|
|
|
|
|
|
|
On success, an object with attributes \fIunsigned_tx\fR and \fItxid\fR will be
|
|
|
|
returned, exactly as from \fBlightning-txprepare\fR(7)\.
|
|
|
|
|
|
|
|
|
|
|
|
If there is no matching \fItxid\fR, an error is reported\. Note that this may
|
|
|
|
happen due to incorrect usage (such as \fBtxdiscard\fR or \fBtxsend\fR
|
|
|
|
already being called for \fItxid\fR) or due to lightningd restarting, which
|
|
|
|
implicitly calls \fBtxdiscard\fR on all outputs\.
|
|
|
|
|
|
|
|
|
|
|
|
The following error codes may occur:
|
|
|
|
|
|
|
|
.RS
|
|
|
|
.IP \[bu]
|
|
|
|
-1: An unknown \fItxid\fR\.
|
|
|
|
|
|
|
|
.RE
|
|
|
|
.SH AUTHOR
|
|
|
|
|
|
|
|
Rusty Russell \fI<rusty@rustcorp.com.au\fR> is mainly responsible\.
|
|
|
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
|
|
|
\fBlightning-txprepare\fR(7), \fBlightning-txsend\fR(7)
|
|
|
|
|
|
|
|
.SH RESOURCES
|
|
|
|
|
|
|
|
Main web site: \fIhttps://github.com/ElementsProject/lightning\fR
|
|
|
|
|
|
|
|
\" SHA256STAMP:cd4c671bd56e7afbe224cceb4e454da314e4ac08bb15618780e06da6c12310ed
|