mirror of
https://github.com/ElementsProject/lightning.git
synced 2024-12-28 01:24:42 +01:00
ba7d4a8f6b
We were including the entire list of prerequisites when generating a shastamp, which for schemas includes the `tools/fromschema.py` doc. This meant all of our shasums were updating anytime this tool file changed. Instead, we just include the first prerequisite. See: https://www.gnu.org/software/make/manual/html_node/Automatic-Variables.html#Automatic-Variables
70 lines
2.1 KiB
Markdown
70 lines
2.1 KiB
Markdown
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
|
|
------------
|
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-START)
|
|
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**
|
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-END)
|
|
|
|
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:304d819b092e1d9ce7b4cd8ef08ecdd7952b454fed59e908ab1af02b50e9a0b0)
|