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

NAME
     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  re-
     ceive 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 finalized  wit-
	ness 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),  lightning-
     openchannel_abort(7),   lightning-openchannel_bump(7),  lightning-fundchan-
     nel_start(7), lightning-fundchannel_complete(7),  lightning-fundchannel(7),
     lightning-fundpsbt(7), lightning-utxopsbt(7), lightning-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 v26.06.1 			 LIGHTNING-OPENCHANNEL_SIGNED(7)
home | help