A CLN hold invoice plugin

Requirements:

• Rust (latest stable version recommended)
• gcc
• protoc
• libpq-dev
• libsqlite3-dev

To compile hold run:

cargo build --release

hold-database sets the database that should be used

This can be:

• SQLite: sqlite://<path>
• PostgreSQL: postgresql://<username>:<password>@<host>:<port>/<database>

hold-grpc-host the host on which the gRPC server should listen to

hold-grpc-port the port on which the gRPC server should listen to

hold-expiry-deadline specifies the number of blocks before the shortest HTLC of a hold invoice expires at which point the invoice will be automatically cancelled. Default is 3. Set to 0 to disable.

hold-mpp-timeout the MPP timeout of payment shards in seconds. Default is 60. Should only be changed for debugging and testing purposes

• holdinvoice payment_hash amount: creates a new hold invoice
• injectinvoice invoice: injects a new invoice into the hold plugin
• listholdinvoices [payment_hash] [invoice]: lists existing hold invoices
• settleholdinvoice preimage: settles a hold invoice
• cancelholdinvoice payment_hash: cancels a hold invoice

More hold invoice creation parameters and streaming calls for updates are available in the gRPC interface.

hold also exposes a gRPC interface. The server is serving with TLS, and the client needs to authenticate itself with the client certificates and the plugin creates. Similarly to how the gRPC plugin itself does it

The protobuf definitions can be found here