Module lightning_invoice::utils

source · [−]
Expand description

Convenient utilities to create an invoice.

Structs

DefaultRouter

A Router implemented using find_route.

Functions

create_invoice_from_channelmanagerstd

Utility to construct an invoice. Generally, unless you want to do something like a custom cltv_expiry, this is what you should be using to create an invoice. The reason being, this method stores the invoice’s payment secret and preimage in ChannelManager, so (a) the user doesn’t have to store preimage/payment secret information and (b) ChannelManager can verify that the payment secret is valid when the invoice is paid.

create_invoice_from_channelmanager_and_duration_since_epoch

See create_invoice_from_channelmanager This version can be used in a no_std environment, where std::time::SystemTime is not available and the current time is supplied by the caller.

create_invoice_from_channelmanager_with_description_hashstd

Utility to construct an invoice. Generally, unless you want to do something like a custom cltv_expiry, this is what you should be using to create an invoice. The reason being, this method stores the invoice’s payment secret and preimage in ChannelManager, so (a) the user doesn’t have to store preimage/payment secret information and (b) ChannelManager can verify that the payment secret is valid when the invoice is paid. Use this variant if you want to pass the description_hash to the invoice.

create_invoice_from_channelmanager_with_description_hash_and_duration_since_epoch

See create_invoice_from_channelmanager_with_description_hash This version can be used in a no_std environment, where std::time::SystemTime is not available and the current time is supplied by the caller.

create_phantom_invoicestd

Utility to create an invoice that can be paid to one of multiple nodes, or a “phantom invoice.” See PhantomKeysManager for more information on phantom node payments.

create_phantom_invoice_with_description_hashstd

Utility to create an invoice that can be paid to one of multiple nodes, or a “phantom invoice.” See PhantomKeysManager for more information on phantom node payments.