lightning-openchannel_bump -- Command to initiate a channel RBF


openchannel_bump channel_id amount initialpsbt [funding_feerate]


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 (msat): Satoshi value that we will contribute to the channel. This value will be _added_ to the provided PSBT in the output which is encumbered 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 input. An error (code 309) will be returned if this requirement is not met.
  • funding_feerate (feerate, optional): Feerate for the funding transaction. The default is 1/64th greater than the last feerate used for this channel.


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 channel_type. (added v24.02):
      • (string, optional) (one of "static_remotekey/even", "anchor_outputs/even", "anchors_zero_fee_htlc_tx/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 complete.
  • funding_serial (u64): The serial_id of the funding output in the psbt.
  • requires_confirmed_inputs (boolean, optional): Does peer require confirmed 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.


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


Lisa Neigut <[email protected]> is mainly responsible.


lightning-openchannel_init(7), lightning-openchannel_update(7), lightning-openchannel_signed(7), lightning-openchannel_abort(7), lightning-fundchannel_start(7), lightning-fundchannel_complete(7), lightning-fundchannel(7), lightning-fundpsbt(7), lightning-utxopsbt(7), lightning-multifundchannel(7)


Main web site: