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
67 lines
2.2 KiB
Markdown
67 lines
2.2 KiB
Markdown
lightning-reserveinputs -- Construct a transaction and reserve the UTXOs it spends
|
|
==================================================================================
|
|
|
|
SYNOPSIS
|
|
--------
|
|
|
|
**reserveinputs** *psbt* [*exclusive*] [*reserve*]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
|
|
The **reserveinputs** RPC command places (or increases) reservations on any
|
|
inputs specified in *psbt* which are known to lightningd. It will fail
|
|
with an error if any of the inputs are known to be spent, and ignore inputs
|
|
which are unknown.
|
|
|
|
Normally the command will fail (with no reservations made) if an input
|
|
is already reserved. If *exclusive* is set to *False*, then existing
|
|
reservations are simply extended, rather than causing failure.
|
|
|
|
By default, reservations are for the next 72 blocks (approximately 6
|
|
hours), but this can be changed by setting *reserve*.
|
|
|
|
RETURN VALUE
|
|
------------
|
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-START)
|
|
On success, an object containing **reservations** is returned. It is an array of objects, where each object contains:
|
|
- **txid** (txid): the transaction id
|
|
- **vout** (u32): the output number which was reserved
|
|
- **was_reserved** (boolean): whether the input was already reserved
|
|
- **reserved** (boolean): whether the input is now reserved (always *true*)
|
|
- **reserved_to_block** (u32): what blockheight the reservation will expire
|
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-END)
|
|
|
|
On success, a *reservations* array is returned, with an entry for each input
|
|
which was reserved:
|
|
|
|
- *txid* is the input transaction id.
|
|
- *vout* is the input index.
|
|
- *was_reserved* indicates whether the input was already reserved.
|
|
- *reserved* indicates that the input is now reserved (i.e. true).
|
|
- *reserved_to_block* indicates what blockheight the reservation will expire.
|
|
|
|
On failure, an error is reported and no UTXOs are reserved.
|
|
|
|
The following error codes may occur:
|
|
- -32602: Invalid parameter, such as specifying a spent/reserved input in *psbt*.
|
|
|
|
AUTHOR
|
|
------
|
|
|
|
niftynei <<niftynei@gmail.com>> is mainly responsible.
|
|
|
|
SEE ALSO
|
|
--------
|
|
|
|
lightning-unreserveinputs(7), lightning-signpsbt(7), lightning-sendpsbt(7)
|
|
|
|
RESOURCES
|
|
---------
|
|
|
|
Main web site: <https://github.com/ElementsProject/lightning>
|
|
|
|
[comment]: # ( SHA256STAMP:45c13e920465d313c693db6bfea8ac2f66d1e40226ef78241f82f51df9b715b2)
|