Previously we've used the term 'funder' to refer to the peer paying the fees for a transaction; v2 of openchannel will make this no longer true. Instead we rename this to 'opener', or the peer sending the 'open_channel' message, since this will be universally true in a dual-funding world.
1.4 KiB
lightning-fundchannel_cancel -- Command for completing channel establishment
SYNOPSIS
fundchannel_cancel id
DESCRIPTION
fundchannel_cancel
is a lower level RPC command. It allows channel opener
to cancel a channel before funding broadcast with a connected peer.
id is the node id of the remote peer with which to cancel.
Note that the funding transaction MUST NOT be broadcast before
fundchannel_cancel
. Broadcasting transaction before fundchannel_cancel
WILL lead to unrecoverable loss of funds.
If fundchannel_cancel
is called after fundchannel_complete
, the remote
peer may disconnect when command succeeds. In this case, user need to connect
to remote peer again before opening channel.
RETURN VALUE
On success, returns confirmation that the channel establishment has been canceled.
On error the returned object will contain code
and message
properties,
with code
being one of the following:
- -32602: If the given parameters are wrong.
- -1: Catchall nonspecific error.
- 306: Unknown peer id.
AUTHOR
Lisa Neigut <niftynei@gmail.com> is mainly responsible.
SEE ALSO
lightning-connect(7), lightning-fundchannel(7), lightning-fundchannel_start(7), lightning-fundchannel_complete(7)
RESOURCES
Main web site: https://github.com/ElementsProject/lightning