lightning-fundchannel_cancel – Command for completing channel establishment¶
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
WILL lead to unrecoverable loss of funds.
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.
On success, returns confirmation that the channel establishment has been canceled.
On error the returned object will contain
code being one of the following:
- -32602: If the given parameters are wrong.
- 306: Unknown peer id.
- 307: No channel currently being funded that can be cancelled.
- 308: It is unsafe to cancel the channel: the funding transaction has been broadcast, or there are HTLCs already in the channel, or the peer was the initiator and not us.
lightning-connect(7), lightning-fundchannel(7), lightning-fundchannel_start(7), lightning-fundchannel_complete(7)