2022-09-13 18:37:05 +02:00
|
|
|
lightning-preapproveinvoice -- Ask the HSM to preapprove an invoice (low-level)
|
|
|
|
|
==================================================================
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
**preapproveinvoice** *bolt11*
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
The **preapproveinvoice** RPC command submits the *bolt11* invoice to
|
|
|
|
|
the HSM to check that it is approved for payment.
|
|
|
|
|
|
|
|
|
|
Generally the **preapproveinvoice** request does not need to be made
|
|
|
|
|
explicitly, it is automatically generated as part of a **pay** request.
|
|
|
|
|
|
|
|
|
|
By default, the HSM will approve all **preapproveinvoice** requests.
|
|
|
|
|
|
|
|
|
|
If a remote signer is being used it might decline an **preapproveinvoice**
|
|
|
|
|
request because it would exceed velocity controls, is not covered by
|
|
|
|
|
allowlist controls, was declined manually, or other reasons.
|
|
|
|
|
|
|
|
|
|
If a remote signer declines a **preapproveinvoice** request a subsequent
|
|
|
|
|
attempt to pay the invoice anyway will fail; the signer will refuse to sign
|
|
|
|
|
the commitment.
|
|
|
|
|
|
|
|
|
|
RETURN VALUE
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-START)
|
|
|
|
|
On success, an empty object is returned.
|
|
|
|
|
|
|
|
|
|
[comment]: # (GENERATE-FROM-SCHEMA-END)
|
|
|
|
|
|
|
|
|
|
AUTHOR
|
|
|
|
|
------
|
|
|
|
|
|
|
|
|
|
Ken Sedgwick <<ken@bonsai.com>> is mainly responsible.
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
lightning-pay(7)
|
|
|
|
|
|
|
|
|
|
RESOURCES
|
|
|
|
|
---------
|
|
|
|
|
|
|
|
|
|
Main web site: <https://github.com/ElementsProject/lightning>
|
|
|
|
|
|
2023-05-25 17:40:46 +02:00
|
|
|
[comment]: # ( SHA256STAMP:19cf1a28402f36cace4b0f667ac9ab97d53dcee78e0ae4fca6d7b1dccd797adb)
|
