home | help 
LIGHTNING-FUNDCHANNEL_COMPLETE(7)	       LIGHTNING-FUNDCHANNEL_COMPLETE(7)

NAME
     fundchannel_complete -- Command for completing channel establishment

SYNOPSIS
     fundchannel_complete id psbt [withhold]

DESCRIPTION
     fundchannel_complete is a lower level RPC command. It allows a user to com-
     plete an initiated channel establishment with a connected peer.

     Note that the funding transaction MUST NOT be broadcast until after channel
     establishment  has  been successfully completed, as the commitment transac-
     tions for this channel are not secured until this command successfully com-
     pletes. Broadcasting transaction before can lead to unrecoverable	loss  of
     funds.

     *	id (pubkey): Node id of the remote peer.
     *	psbt  (string):  Transaction  to  use  for  funding (does not need to be
	signed but must be otherwise complete).
     *	withhold (boolean, optional): Mark this channel 'withheld' so we know we
	haven't broadcast the funding transaction.  If the channel is closed be-
	fore we call sendpsbt on this psbt, it will  simply  be  closed  immedi-
	ately. (added v25.12)

RETURN VALUE
     On success, an object is returned, containing:

     *	channel_id (hash): The channel_id of the resulting channel.
     *	commitments_secured  (boolean) (always true): Indication that channel is
	safe to use.

ERRORS
     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.
     *	309: PSBT does not have a unique, correct output to fund the channel.

AUTHOR
     Lisa Neigut niftynei@gmail.com is mainly responsible.

SEE ALSO
     lightning-connect(7),  lightning-fundchannel(7),	lightning-multifundchan-
     nel(7),   lightning-fundchannel_start(7),	lightning-fundchannel_cancel(7),
     lightning-openchannel_init(7), lightning-openchannel_update(7),  lightning-
     openchannel_signed(7),  lightning-openchannel_bump(7),  lightning-openchan-
     nel_abort(7)

RESOURCES
     Main web site: https://github.com/ElementsProject/lightning

EXAMPLES
     Example 1:

     Request:

     $ lightning-cli fundchannel_complete "nodeid101010101010101010101010101010101010101010101010101010101010" "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000"

     {
       "id": "example:fundchannel_complete#1",
       "method": "fundchannel_complete",
       "params": [
	 "nodeid101010101010101010101010101010101010101010101010101010101010",
	 "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000201000"
       ]
     }

     Response:

     {
       "channel_id": "channelid0910109101091010910109101091010910109101091010910109101",
       "commitments_secured": true
     }

     Example 2:

     Request:

     $ lightning-cli fundchannel_complete -k "id"="nodeid101010101010101010101010101010101010101010101010101010101010" "psbt"="cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000"

     {
       "id": "example:fundchannel_complete#2",
       "method": "fundchannel_complete",
       "params": {
	 "id": "nodeid101010101010101010101010101010101010101010101010101010101010",
	 "psbt": "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000401000"
       }
     }

     Response:

     {
       "channel_id": "channelid0910209102091020910209102091020910209102091020910209102",
       "commitments_secured": true
     }

Core Lightning v26.06.1 		       LIGHTNING-FUNDCHANNEL_COMPLETE(7)
home | help