mirrors/core-lightning
1
0
Fork 0
mirror of https://github.com/ElementsProject/lightning.git synced 2024-11-19 18:11:28 +01:00
Code Issues Projects Releases Wiki Activity
ae522229f0
core-lightning/doc/lightning-openchannel_signed.7.md
Vincenzo Palazzo bd3c0ef85c jsonschema: Formatting json schema and regenerate docs 
Signed-off-by: Vincenzo Palazzo <vincenzopalazzodev@gmail.com>
2021-11-28 10:55:48 +10:30

2.1 KiB
Raw Blame History

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 commitments_secured true.

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

channel_id is the id of the channel.

signed_psbt is the PSBT returned from openchannel_update (where commitments_secured was true) with partial signatures or finalized witness stacks included for every input that we contributed to the PSBT.

RETURN VALUE

On success, an object is returned, containing:

  • channel_id (hex): the channel id of the channel (always 64 characters)
  • tx (hex): the funding transaction
  • txid (txid): The txid of the tx

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

SEE ALSO

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

AUTHOR

@niftynei <niftynei@gmail.com> is mainly responsible.

RESOURCES

Main web site: https://github.com/ElementsProject/lightning comment: # ( SHA256STAMP:d85297e1ab0b3bbf206082c479dcfdc6469461e531321ce5576c6ff7f296d481)