mirror of
https://github.com/aljazceru/lightning.git
synced 2025-12-19 07:04:22 +01:00
bcabb3825f
1. If the tool changes, you need to regenerate since the output may change. 2. This didn't just filter that out, ignored all but the first dependency, which made bisecting the bookkeeper plugin a nightmare: it didn't regenerate the .po file, causing random crashes. If we want this, try $(filter-out tools/fromschema.py) instead. But I don't think we want that. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
76 lines
2.6 KiB
Markdown
76 lines
2.6 KiB
Markdown
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
|
|
------------
|
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-START)
|
|
On success, an object is returned, containing:
|
|
|
|
- **channel_id** (hex): the channel id of the channel (always 64 characters)
|
|
- **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
|
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-END)
|
|
|
|
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.
|
|
|
|
|
|
- -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 <<niftynei@gmail.com>> is mainly responsible.
|
|
|
|
RESOURCES
|
|
---------
|
|
|
|
Main web site: <https://github.com/ElementsProject/lightning>
|
|
[comment]: # ( SHA256STAMP:92a20c9731a38c03189d7396e196c0439ef4311407529542b41af967e365c43b)
|