Documentation Portal

lightning-openchannel_update

lightning-openchannel_update -- Command to update a collab channel open

SYNOPSIS

openchannel_update channel_id psbt

DESCRIPTION

openchannel_update is a low level RPC command which continues an open
channel, as specified by channel_id. An updated psbt is passed in; any
changes from the PSBT last returned (either from openchannel_init or
a previous call to openchannel_update) will be communicated to the peer.

Must be called after openchannel_init and before openchannel_signed.

Must be called until commitments_secured is returned as true, at which point
openchannel_signed should be called with a signed version of the PSBT
returned by the last call to openchannel_update.

channel_id is the id of the channel.

psbt is the updated PSBT to be sent to the peer. May be identical to
the PSBT last returned by either openchannel_init or openchannel_update.

RETURN VALUE

On success, an object is returned, containing:

  • channel_id (hex): the channel id of the channel (always 64 characters)
  • 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):
      • Bit number
    • names (array of strings): Feature name for each bit set in this channel_type (added v24.02):
      • Name of feature bit (one of "static_remotekey/even", "anchor_outputs/even", "anchors_zero_fee_htlc_tx/even", "scid_alias/even", "zeroconf/even")
  • psbt (string): the PSBT of the funding transaction
  • commitments_secured (boolean): whether the psbt is complete (if true, sign psbt and call openchannel_signed to complete the channel open)
  • funding_outnum (u32): The index of the funding output in the psbt
  • close_to (hex, optional): scriptPubkey which we have to close to if we mutual close
  • requires_confirmed_inputs (boolean, optional): Does peer require confirmed inputs in psbt?

If commitments_secured is true, will also return:

  • The derived channel_id.
  • A close_to script, iff a close_to address was provided to
    openchannel_init and the peer supports option_upfront_shutdownscript.
  • The funding_outnum, the index of the funding output for this channel
    in the funding transaction.

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.
  • 309: PSBT missing required fields
  • 311: Unknown channel id.
  • 312: Channel in an invalid state

SEE ALSO

lightning-openchannel_init(7), lightning-openchannel_signed(7),
lightning-openchannel_bump(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)

AUTHOR

@niftynei <[email protected]> is mainly responsible.

RESOURCES

Main web site: https://github.com/ElementsProject/lightning