Struct lightning_signer::invoice::bolt12::Invoice

pub struct Invoice { /* private fields */ }

An Invoice is a payment request, typically corresponding to an Offer or a Refund.

An invoice may be sent in response to an InvoiceRequest in the case of an offer or sent directly after scanning a refund. It includes all the information needed to pay a recipient.

Implementations

impl Invoice

pub fn description(&self) -> PrintableString<'_>

A complete description of the purpose of the originating offer or refund. Intended to be displayed to the user but with the caveat that it has not been verified in any way.

pub fn payment_paths(&self) -> &[(BlindedPath, BlindedPayInfo)]

Paths to the recipient originating from publicly reachable nodes, including information needed for routing payments across them.

Blinded paths provide recipient privacy by obfuscating its node id. Note, however, that this privacy is lost if a public node id is used for Invoice::signing_pubkey.

pub fn created_at(&self) -> Duration

Duration since the Unix epoch when the invoice was created.

pub fn relative_expiry(&self) -> Duration

Duration since Invoice::created_at when the invoice has expired and therefore should no longer be paid.

pub fn is_expired(&self) -> bool

Whether the invoice has expired.

pub fn payment_hash(&self) -> PaymentHash

SHA256 hash of the payment preimage that will be given in return for paying the invoice.

pub fn amount_msats(&self) -> u64

The minimum amount required for a successful payment of the invoice.

pub fn fallbacks(&self) -> Vec<Address, Global>

Fallback addresses for paying the invoice on-chain, in order of most-preferred to least-preferred.

pub fn features(&self) -> &Features<Bolt12InvoiceContext>

Features pertaining to paying an invoice.

pub fn signing_pubkey(&self) -> PublicKey

The public key corresponding to the key used to sign the invoice.

pub fn signature(&self) -> Signature

Signature of the invoice verified using Invoice::signing_pubkey.

pub fn signable_hash(&self) -> [u8; 32]

Hash that was used for signing the invoice.

pub fn verify<T>(&self, key: &ExpandedKey, secp_ctx: &Secp256k1<T>) -> boolwhere T: Signing,

Verifies that the invoice was for a request or refund created using the given key.

Trait Implementations

impl Clone for Invoice

fn clone(&self) -> Invoice

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Invoice

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl TryFrom<ParsedMessage<(PayerTlvStream, OfferTlvStream, InvoiceRequestTlvStream, InvoiceTlvStream, SignatureTlvStream)>> for Invoice

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from( invoice: ParsedMessage<(PayerTlvStream, OfferTlvStream, InvoiceRequestTlvStream, InvoiceTlvStream, SignatureTlvStream)> ) -> Result<Invoice, <Invoice as TryFrom<ParsedMessage<(PayerTlvStream, OfferTlvStream, InvoiceRequestTlvStream, InvoiceTlvStream, SignatureTlvStream)>>>::Error>

Performs the conversion.

impl TryFrom<Vec<u8, Global>> for Invoice

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from( bytes: Vec<u8, Global> ) -> Result<Invoice, <Invoice as TryFrom<Vec<u8, Global>>>::Error>

Performs the conversion.

impl Writeable for Invoice

fn write<W>(&self, writer: &mut W) -> Result<(), Error>where W: Writer,

Writes self out to the given Writer.

fn encode(&self) -> Vec<u8, Global>

Writes self out to a Vec<u8>.

fn serialized_length(&self) -> usize

Gets the length of this object after it has been serialized. This can be overridden to optimize cases where we prepend an object with its length.