Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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
       complete	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 commit-
       ment transactions for this channel are not secured until	 this  command
       successfully completes. Broadcasting transaction	before can lead	to un-
       recoverable 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 before we call sendpsbt on this psbt, it  will  simply  be
	  closed immediately. (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	 chan-
	  nel.

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

SEE ALSO
       lightning-connect(7),   lightning-fundchannel(7),  lightning-multifund-
       channel(7), lightning-fundchannel_start(7),  lightning-fundchannel_can-
       cel(7), lightning-openchannel_init(7), lightning-openchannel_update(7),
       lightning-openchannel_signed(7),	 lightning-openchannel_bump(7),	light-
       ning-openchannel_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 v25.12.1			     LIGHTNING-FUNDCHANNEL_COMPLETE(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=lightning-fundchannel_complete&sektion=7&manpath=FreeBSD+Ports+15.1.quarterly>

home | help