core-lightning/doc/lightning-unreserveinputs.7.md
niftynei ba7d4a8f6b make-schema: don't include tools/fromschema.py in SHASUMS
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
2022-07-14 12:24:48 -05:00

1.6 KiB

lightning-unreserveinputs -- Release reserved UTXOs

SYNOPSIS

unreserveinputs psbt [reserve]

DESCRIPTION

The unreserveinputs RPC command releases (or reduces reservation) on UTXOs which were previously marked as reserved, generally by lightning-reserveinputs(7).

The inputs to unreserve are the inputs specified in the passed-in psbt.

If reserve is specified, it is the number of blocks to decrease reservation by; default is 72.

RETURN VALUE

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 (usually true)
  • reserved (boolean): whether the input is now reserved (may still be true if it was reserved for a long time)

If reserved is true:

  • reserved_to_block (u32): what blockheight the reservation will expire

On failure, an error is reported and no UTXOs are unreserved.

The following error codes may occur:

  • -32602: Invalid parameter, i.e. an unparseable 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