64 lines
1.8 KiB
Groff
64 lines
1.8 KiB
Groff
.TH "LIGHTNING-OPENCHANNEL_ABORT" "7" "" "" "lightning-openchannel_abort"
|
|
.SH NAME
|
|
lightning-openchannel_abort - Command to abort a channel to a peer
|
|
.SH SYNOPSIS
|
|
|
|
\fBopenchannel_abort\fR \fIchannel_id\fR
|
|
|
|
.SH DESCRIPTION
|
|
|
|
\fBopenchannel_init\fR is a low level RPC command which initiates a channel
|
|
open with a specified peer\. It uses the openchannel protocol
|
|
which allows for interactive transaction construction\.
|
|
|
|
|
|
\fIchannel_id\fR is id of this channel\.
|
|
|
|
.SH RETURN VALUE
|
|
|
|
On success, an object is returned, containing:
|
|
|
|
.RS
|
|
.IP \[bu]
|
|
\fBchannel_id\fR (hex): the channel id of the aborted channel (always 64 characters)
|
|
.IP \[bu]
|
|
\fBreason\fR (string): usually "Abort requested", but if it happened to fail at the same time it could be different
|
|
.IP \[bu]
|
|
\fBchannel_canceled\fR (boolean, optional): whether this is completely canceled (there may be remaining in-flight transactions)
|
|
|
|
.RE
|
|
|
|
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: Catchall nonspecific error\.
|
|
.IP \[bu]
|
|
305: Peer is not connected\.
|
|
.IP \[bu]
|
|
311: Unknown channel id\.
|
|
.IP \[bu]
|
|
312: Channel in an invalid state
|
|
|
|
.RE
|
|
.SH SEE ALSO
|
|
|
|
lightning-openchannel_\fBinit\fR(7), lightning-openchannel_\fBupdate\fR(7),
|
|
lightning-openchannel_\fBsigned\fR(7), lightning-openchannel_\fBbump\fR(7),
|
|
lightning-fundchannel_\fBstart\fR(7), lightning-fundchannel_\fBcomplete\fR(7),
|
|
\fBlightning-fundchannel\fR(7), \fBlightning-fundpsbt\fR(7), \fBlightning-utxopsbt\fR(7),
|
|
\fBlightning-multifundchannel\fR(7)
|
|
|
|
.SH AUTHOR
|
|
|
|
@niftynei \fI<niftynei@gmail.com\fR> is mainly responsible\.
|
|
|
|
.SH RESOURCES
|
|
|
|
Main web site: \fIhttps://github.com/ElementsProject/lightning\fR
|
|
|
|
\" SHA256STAMP:d2ed75d41e90988cf4a1919afb443e7a8f4b9c52fb8aa404af16d6feb44cacc8
|