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

NAME
     openchannel_bump -- Command to initiate a channel RBF

SYNOPSIS
     openchannel_bump channel_id amount initialpsbt [funding_feerate]

DESCRIPTION
     openchannel_bump  is  a RPC command which initiates a channel RBF (Replace-
     By-Fee) for the specified channel. It uses the openchannel  protocol  which
     allows for interactive transaction construction.

     Warning: bumping a leased channel will lose the lease.

     *	channel_id (hash): Id of the channel to RBF.
     *	amount (sat): Satoshi value that we will contribute to the channel. This
	value will be _added_ to the provided PSBT in the output which is encum-
	bered by the 2-of-2 script for this channel.
     *	initialpsbt  (string):	The  funded,  incomplete PSBT that specifies the
	UTXOs and change output for our channel contribution. It can be updated,
	see openchannel_update; initialpsbt must have at least one  input.  Must
	have  the  Non-Witness UTXO (PSBT_IN_NON_WITNESS_UTXO) set for every in-
	put. An error (code 309) will be returned if  this  requirement  is  not
	met.
     *	funding_feerate  (feerate,  optional):	Feerate for the funding transac-
	tion. The default is 1/64th greater than the last feerate used for  this
	channel.

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

     *	channel_id (hash): The channel id of the channel.
     *	channel_type  (object):  Channel_type  as  negotiated  with peer. (added
	v24.02):
	*  bits (array of u32s): Each  bit  set  in  this  channel_type.  (added
	   v24.02):
	*  (u32, optional): Bit number.
	*  names (array of strings): Feature name for each bit set in this chan-
	   nel_type.  Note that anchors_zero_fee_htlc_tx is a deprecated synonym
	   for anchors. (added v24.02):
	*  (string,  optional)	(one  of  "static_remotekey/even",  "anchor_out-
	   puts/even",	    "anchors_zero_fee_htlc_tx/even",	 "anchors/even",
	   "scid_alias/even", "zeroconf/even"): Name of feature bit.
     *	psbt (string): The (incomplete) PSBT of the RBF transaction.
     *	commitments_secured (boolean) (always false): Whether the psbt	is  com-
	plete.
     *	funding_serial (u64): The serial_id of the funding output in the psbt.
     *	requires_confirmed_inputs  (boolean,  optional):  Does peer require con-
	firmed inputs in psbt?

     If the peer does not support option_dual_fund, this command will return  an
     error.

     If  the  channel  is  not in a state that is eligible for RBF, this command
     will return an error.

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.
     *	300: The amount exceeded the maximum configured funding amount.
     *	301: The provided PSBT cannot afford the funding amount.
     *	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_signed(7),  lightning-openchannel_abort(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_bump "b020c1c6818daf024954c9ee578caad058cbcae7dd75b2c4d38b8f6f81901ff5" "1000000" "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000" "15000perkw"

     {
       "id": "example:openchannel_bump#1",
       "method": "openchannel_bump",
       "params": [
	 "b020c1c6818daf024954c9ee578caad058cbcae7dd75b2c4d38b8f6f81901ff5",
	 1000000,
	 "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000",
	 "15000perkw"
       ]
     }

     Response:

     {
       "channel_id": "channelid0111200111200111200111200111200111200111200111200111200",
       "psbt": "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000810000",
       "channel_type": {
	 "bits": [
	   12,
	   22
	 ],
	 "names": [
	   "static_remotekey/even",
	   "anchors/even"
	 ]
       },
       "commitments_secured": false,
       "funding_serial": 17725655605188030000,
       "requires_confirmed_inputs": false
     }

     Example 2:

     Request:

     $ lightning-cli openchannel_bump -k "channel_id"="channelid0111200111200111200111200111200111200111200111200111200" "amount"=1000000 "initialpsbt"="cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000" "funding_feerate"="15000perkw"

     {
       "id": "example:openchannel_bump#2",
       "method": "openchannel_bump",
       "params": {
	 "channel_id": "channelid0111200111200111200111200111200111200111200111200111200",
	 "amount": 1000000,
	 "initialpsbt": "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000510000",
	 "funding_feerate": "15000perkw"
       }
     }

     Response:

     {
       "channel_id": "channelid0111200111200111200111200111200111200111200111200111200",
       "psbt": "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000910000",
       "channel_type": {
	 "bits": [
	   12,
	   22
	 ],
	 "names": [
	   "static_remotekey/even",
	   "anchors/even"
	 ]
       },
       "commitments_secured": false,
       "funding_serial": 17725655605188040000,
       "requires_confirmed_inputs": false
     }

     Example 3:

     Request:

     $ lightning-cli openchannel_bump "b020c1c6818daf024954c9ee578caad058cbcae7dd75b2c4d38b8f6f81901ff5" "2000000" "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000" "18750perkw"

     {
       "id": "example:openchannel_bump#3",
       "method": "openchannel_bump",
       "params": [
	 "b020c1c6818daf024954c9ee578caad058cbcae7dd75b2c4d38b8f6f81901ff5",
	 2000000,
	 "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000520000",
	 "18750perkw"
       ]
     }

     Response:

     {
       "channel_id": "channelid0111200111200111200111200111200111200111200111200111200",
       "psbt": "cHNidP8BAgQCAAAAAQMEbwAAAAEEAQpsbt101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000101000",
       "channel_type": {
	 "bits": [
	   12,
	   22
	 ],
	 "names": [
	   "static_remotekey/even",
	   "anchors/even"
	 ]
       },
       "commitments_secured": false,
       "funding_serial": 17725655605188050000,
       "requires_confirmed_inputs": false
     }

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