Enum PaymentMethod 

pub enum PaymentMethod {
    Onchain {
        address: Address,
        amount: Option<Amount>,
        label: Option<String>,
        message: Option<String>,
    },
    Invoice {
        invoice: Invoice,
        lud12_comment: Option<String>,
    },
    Offer {
        offer: Offer,
        bip321_amount: Option<Amount>,
        human_bitcoin_address: Option<String>,
    },
    LnurlPay {
        pay_request: LnurlPayRequest,
        lnurl: String,
        lightning_address: Option<String>,
    },
}

A single “payment method” – each kind here should correspond with a single linear (outbound) payment flow for a user, where there are no other alternate methods.

For example, a Unified BTC QR code contains a single BIP321 URI, which may contain multiple discrete payment methods (an onchain address, a BOLT11 invoice, a BOLT12 offer).

Compare with ClaimMethod, which is the inbound equivalent.

Variants

Onchain

Fields

address: Address

An onchain Bitcoin address.

amount: Option<Amount>

The amount to pay to the onchain address, if specified.

Parsed from a BIP321 URI or BOLT11 invoice containing the onchain address.

label: Option<String>

A label for the onchain address.

Parsed from a BIP321 URI containing the onchain address.

message: Option<String>

A message describing the transaction or its purpose.

Parsed from a BIP321 URI or BOLT11 invoice containing the onchain address.

Invoice

Fields

invoice: Invoice

A BOLT11 invoice.

lud12_comment: Option<String>

The LUD-12 comment the payer already sent in the LNURL-pay callback that produced this invoice, to record as the payment’s message. Parsed from a BIP321 URI containing the invoice.

Offer

Fields

offer: Offer

A BOLT12 offer.

bip321_amount: Option<Amount>

The amount to pay to the offer, if specified.

Parsed from a BIP321 URI containing the offer.

human_bitcoin_address: Option<String>

The original Human Bitcoin Address this offer was resolved from, if it originated from one. Includes ₿ prefix: “₿user@domain”.

LnurlPay

Fields

pay_request: LnurlPayRequest

The LNURL-pay request, which includes information about the amount constraints, callback, etc. associated with the LNURL.

lnurl: String

The original LNURL-pay LNURL, e.g. lnurlp://...

lightning_address: Option<String>

The original Lightning Address (user@domain) this was resolved from, if it originated from one rather than a raw LNURL.

Implementations

impl PaymentMethod

pub fn is_onchain(&self) -> bool

Check if the payment method is an onchain address.

pub fn is_invoice(&self) -> bool

Check if the payment method is a BOLT11 invoice.

pub fn is_offer(&self) -> bool

Check if the payment method is a BOLT12 offer.

pub fn is_lnurl_pay(&self) -> bool

Check if the payment method is an LNURL-pay endpoint.

Trait Implementations

impl PaymentUriMethod for PaymentMethod

fn kind(&self) -> &'static str

The method’s kind as a stable string, e.g. “invoice”, “lnurl-withdraw”.

fn supports_network(&self, network: Network) -> bool

Whether the method is valid for network.

fn priority(&self) -> usize

Higher priority methods are preferred. For sort_by_key and friends.