Struct lightning_signer::invoice::bolt12::InvoiceBuilder

pub struct InvoiceBuilder<'a, S>where
    S: SigningPubkeyStrategy,{ /* private fields */ }

Builds an Invoice from either:

• an InvoiceRequest for the “offer to be paid” flow or
• a Refund for the “offer for money” flow.

See module-level documentation for usage.

Implementations

impl<'a, S> InvoiceBuilder<'a, S>where S: SigningPubkeyStrategy,

pub fn relative_expiry(self, relative_expiry_secs: u32) -> InvoiceBuilder<'a, S>

Sets the Invoice::relative_expiry as seconds since Invoice::created_at. Any expiry that has already passed is valid and can be checked for using Invoice::is_expired.

Successive calls to this method will override the previous setting.

pub fn fallback_v0_p2wsh( self, script_hash: &WScriptHash ) -> InvoiceBuilder<'a, S>

Adds a P2WSH address to Invoice::fallbacks.

Successive calls to this method will add another address. Caller is responsible for not adding duplicate addresses and only calling if capable of receiving to P2WSH addresses.

pub fn fallback_v0_p2wpkh( self, pubkey_hash: &WPubkeyHash ) -> InvoiceBuilder<'a, S>

Adds a P2WPKH address to Invoice::fallbacks.

Successive calls to this method will add another address. Caller is responsible for not adding duplicate addresses and only calling if capable of receiving to P2WPKH addresses.

pub fn fallback_v1_p2tr_tweaked( self, output_key: &TweakedPublicKey ) -> InvoiceBuilder<'a, S>

Adds a P2TR address to Invoice::fallbacks.

Successive calls to this method will add another address. Caller is responsible for not adding duplicate addresses and only calling if capable of receiving to P2TR addresses.

pub fn allow_mpp(self) -> InvoiceBuilder<'a, S>

Sets Invoice::features to indicate MPP may be used. Otherwise, MPP is disallowed.

impl<'a> InvoiceBuilder<'a, ExplicitSigningPubkey>

pub fn build(self) -> Result<UnsignedInvoice<'a>, SemanticError>

Builds an unsigned Invoice after checking for valid semantics. It can be signed by UnsignedInvoice::sign.

impl<'a> InvoiceBuilder<'a, DerivedSigningPubkey>

pub fn build_and_sign<T>( self, secp_ctx: &Secp256k1<T> ) -> Result<Invoice, SemanticError>where T: Signing,

Builds a signed Invoice after checking for valid semantics.