2019-08-31 14:30:56 +02:00
|
|
|
lightning-fundchannel\_complete -- Command for completing channel establishment
|
|
|
|
|
===============================================================================
|
2019-08-10 01:54:18 +02:00
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
|
|
|
|
|
2021-03-15 05:27:56 +01:00
|
|
|
**fundchannel\_complete** *id* *psbt*
|
2019-08-10 01:54:18 +02:00
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
`fundchannel_complete` is a lower level RPC command. It allows a user to
|
2019-08-21 10:55:49 +02:00
|
|
|
complete an initiated channel establishment with a connected peer.
|
2019-08-10 01:54:18 +02:00
|
|
|
|
2019-08-21 10:55:49 +02:00
|
|
|
*id* is the node id of the remote peer.
|
2019-08-10 01:54:18 +02:00
|
|
|
|
2021-03-15 05:27:56 +01:00
|
|
|
*psbt* is the transaction to use for funding (does not need to be
|
|
|
|
|
signed but must be otherwise complete).
|
2019-08-10 01:54:18 +02:00
|
|
|
|
2019-08-21 10:55:49 +02:00
|
|
|
Note that the funding transaction MUST NOT be broadcast until after
|
2019-08-10 01:54:18 +02:00
|
|
|
channel establishment has been successfully completed, as the commitment
|
|
|
|
|
transactions for this channel are not secured until this command
|
2019-08-21 10:55:49 +02:00
|
|
|
successfully completes. Broadcasting transaction before can lead to
|
|
|
|
|
unrecoverable loss of funds.
|
2019-08-10 01:54:18 +02:00
|
|
|
|
|
|
|
|
RETURN VALUE
|
|
|
|
|
------------
|
|
|
|
|
|
doc/schemas: disableoffer, disconnect, feerates, fetchinvoice, fundchannel, fundchannel_cancel, fundchannel_complete, fundchannel_start, fundpsbt, getinfo, getlog, getroute.
We also add a test for getlog, since it was never called by the
testsuite.
Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2021-05-26 09:35:01 +02:00
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-START)
|
|
|
|
|
On success, an object is returned, containing:
|
|
|
|
|
- **channel_id** (hex): The channel_id of the resulting channel (always 64 characters)
|
|
|
|
|
- **commitments_secured** (boolean): Indication that channel is safe to use (always *true*)
|
2021-09-03 12:07:59 +02:00
|
|
|
|
doc/schemas: disableoffer, disconnect, feerates, fetchinvoice, fundchannel, fundchannel_cancel, fundchannel_complete, fundchannel_start, fundpsbt, getinfo, getlog, getroute.
We also add a test for getlog, since it was never called by the
testsuite.
Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2021-05-26 09:35:01 +02:00
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-END)
|
2019-08-10 01:54:18 +02:00
|
|
|
|
2020-01-05 16:40:17 +01:00
|
|
|
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.
|
|
|
|
|
- 305: Peer is not connected.
|
|
|
|
|
- 306: Unknown peer id.
|
2021-03-15 05:27:56 +01:00
|
|
|
- 309: PSBT does not have a unique, correct output to fund the channel.
|
2019-08-10 01:54:18 +02:00
|
|
|
|
|
|
|
|
AUTHOR
|
|
|
|
|
------
|
|
|
|
|
|
|
|
|
|
Lisa Neigut <<niftynei@gmail.com>> is mainly responsible.
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
|
|
|
|
|
2021-03-11 05:33:47 +01:00
|
|
|
lightning-connect(7), lightning-fundchannel(7), lightning-multifundchannel(7),
|
|
|
|
|
lightning-fundchannel\_start(7), lightning-fundchannel\_cancel(7),
|
|
|
|
|
lightning-openchannel\_init(7), lightning-openchannel\_update(7),
|
2021-03-09 22:14:08 +01:00
|
|
|
lightning-openchannel\_signed(7), lightning-openchannel\_bump(7),
|
|
|
|
|
lightning-openchannel\_abort(7)
|
2019-08-10 01:54:18 +02:00
|
|
|
|
|
|
|
|
RESOURCES
|
|
|
|
|
---------
|
|
|
|
|
|
|
|
|
|
Main web site: <https://github.com/ElementsProject/lightning>
|
2020-08-25 03:33:16 +02:00
|
|
|
|
2022-07-13 17:45:39 +02:00
|
|
|
[comment]: # ( SHA256STAMP:f7b14faee0218a2eee7c0df17c52b1d4502c898d1767644bd891027116eb8868)
|
