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

FreeBSD Manual Pages

  
 
  

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

NAME
       lightning-openchannel_signed -- Command to conclude a channel open

SYNOPSIS
       openchannel_signed channel_id signed_psbt

DESCRIPTION
       openchannel_signed is a low level RPC command which concludes a channel
       open  with  the	specified  peer.  It uses the v2 openchannel protocol,
       which allows for	interactive transaction	construction.

       This command should be called after openchannel_update returns  commit-
       ments_secured true.

       This  command  will  broadcast the finalized funding transaction, if we
       receive valid signatures	from the peer.

       •  channel_id (hash): Id	of the channel.
       •  signed_psbt (string):	 The  PSBT  returned  from  openchannel_update
	  (where  commitments_secured was true)	with partial signatures	or fi-
	  nalized witness stacks included for every input that we  contributed
	  to the PSBT.

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

       •  channel_id (hash): The channel id of the channel.
       •  tx (hex): The	funding	transaction.
       •  txid (txid): The txid	of the tx.

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.
       •  303: Funding transaction broadcast failed.
       •  305: Peer is not connected.
       •  309: PSBT missing required fields.
       •  311: Unknown channel id.
       •  312: Channel in an invalid state

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

SEE ALSO
       lightning-openchannel_init(7),  lightning-openchannel_update(7),	light-
       ning-openchannel_abort(7),  lightning-openchannel_bump(7),   lightning-
       fundchannel_start(7),   lightning-fundchannel_complete(7),   lightning-
       fundchannel(7),	lightning-fundpsbt(7),	lightning-utxopsbt(7),	light-
       ning-multifundchannel(7)

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

EXAMPLES
       Example 1:

       Request:

       $ lightning-cli openchannel_signed -k "channel_id"="channelid0111200111200111200111200111200111200111200111200111200" "signed_psbt"="cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000"

       {
	 "id": "example:openchannel_signed#1",
	 "method": "openchannel_signed",
	 "params": {
	   "channel_id": "channelid0111200111200111200111200111200111200111200111200111200",
	   "signed_psbt": "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000111000"
	 }
       }

       Response:

       {
	 "tx": "02000000000101sgpsbt11000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000110001100011000",
	 "txid": "txidocsigned1011000110001100011000110001100011000110001100011000",
	 "channel_id": "channelid0111200111200111200111200111200111200111200111200111200"
       }

       Example 2:

       Request:

       $ lightning-cli openchannel_signed "b020c1c6818daf024954c9ee578caad058cbcae7dd75b2c4d38b8f6f81901ff5" "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000"

       {
	 "id": "example:openchannel_signed#2",
	 "method": "openchannel_signed",
	 "params": [
	   "b020c1c6818daf024954c9ee578caad058cbcae7dd75b2c4d38b8f6f81901ff5",
	   "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000121000"
	 ]
       }

       Response:

       {
	 "tx": "02000000000101sgpsbt12000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000120001200012000",
	 "txid": "txidocsigned1012000120001200012000120001200012000120001200012000",
	 "channel_id": "channelid0111200111200111200111200111200111200111200111200111200"
       }

Core Lightning v25.02			       LIGHTNING-OPENCHANNEL_SIGNED(7)

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

home | help