mirror of
https://github.com/ElementsProject/lightning.git
synced 2025-01-04 04:54:47 +01:00
b9ac032329
The idea is that you regenerate the man pages in the same commit you alter them: that's how we know whether to try regenerating them or not (git doesn't store timestamps, so it can't really tell). Travis will now check this, so force them all to sync to this commit. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
57 lines
1.6 KiB
Markdown
57 lines
1.6 KiB
Markdown
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.
|
|
- 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.
|
|
|
|
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>
|
|
|