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

FreeBSD Manual Pages

  
 
  

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

NAME
       lightning-fundchannel_complete -- Command for completing	channel	estab-
       lishment

SYNOPSIS
       fundchannel_complete id psbt

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).

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.02			     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+14.3.quarterly>

home | help