Struct Offer

pub struct Offer { /* private fields */ }

An Offer is a potentially long-lived proposal for payment of a good or service.

An offer is a precursor to an InvoiceRequest. A merchant publishes an offer from which a customer may request an Bolt12Invoice for a specific quantity and using an amount sufficient to cover that quantity (i.e., at least quantity * amount). See Offer::amount.

Offers may be denominated in currency other than bitcoin but are ultimately paid using the latter.

Through the use of BlindedMessagePaths, offers provide recipient privacy.

Implementations

impl Offer

pub fn chains(&self) -> Vec<ChainHash>

The chains that may be used when paying a requested invoice (e.g., bitcoin mainnet). Payments must be denominated in units of the minimal lightning-payable unit (e.g., msats) for the selected chain.

pub fn metadata(&self) -> Option<&Vec<u8>>

Opaque bytes set by the originator. Useful for authentication and validating fields since it is reflected in invoice_request messages along with all the other fields from the offer.

pub fn amount(&self) -> Option<Amount>

The minimum amount required for a successful payment of a single item.

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

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

pub fn offer_features(&self) -> &Features<OfferContext>

Features pertaining to the offer.

pub fn absolute_expiry(&self) -> Option<Duration>

Duration since the Unix epoch when an invoice should no longer be requested.

If None, the offer does not expire.

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

The issuer of the offer, possibly beginning with user@domain or domain. Intended to be displayed to the user but with the caveat that it has not been verified in any way.

pub fn paths(&self) -> &[BlindedMessagePath]

Paths to the recipient originating from publicly reachable nodes. Blinded paths provide recipient privacy by obfuscating its node id.

pub fn supported_quantity(&self) -> Quantity

The quantity of items supported.

pub fn issuer_signing_pubkey(&self) -> Option<PublicKey>

The public key corresponding to the key used by the recipient to sign invoices.

• If Offer::paths is empty, MUST be Some and contain the recipient’s node id for sending an InvoiceRequest.
• If Offer::paths is not empty, MAY be Some and contain a transient id.
• If None, the signing pubkey will be the final blinded node id from the BlindedMessagePath in Offer::paths used to send the InvoiceRequest.

See also Bolt12Invoice::signing_pubkey.

pub fn id(&self) -> OfferId

Returns the id of the offer.

pub fn supports_chain(&self, chain: ChainHash) -> bool

Returns whether the given chain is supported by the offer.

pub fn is_expired(&self) -> bool

Whether the offer has expired.

pub fn is_expired_no_std(&self, duration_since_epoch: Duration) -> bool

Whether the offer has expired given the duration since the Unix epoch.

pub fn is_valid_quantity(&self, quantity: u64) -> bool

Returns whether the given quantity is valid for the offer.

pub fn expects_quantity(&self) -> bool

Returns whether a quantity is expected in an InvoiceRequest for the offer.

impl Offer

pub fn request_invoice<'a, 'b, T>( &'a self, expanded_key: &ExpandedKey, nonce: Nonce, secp_ctx: &'b Secp256k1<T>, payment_id: PaymentId, ) -> Result<InvoiceRequestBuilder<'a, 'b, T>, Bolt12SemanticError>

where T: Signing,

Creates an InvoiceRequestBuilder for the offer, which

• derives the InvoiceRequest::payer_signing_pubkey such that a different key can be used for each request in order to protect the sender’s privacy,
• sets InvoiceRequest::payer_metadata when InvoiceRequestBuilder::build_and_sign is called such that it can be used by Bolt12Invoice::verify_using_metadata to determine if the invoice was requested using a base ExpandedKey from which the payer id was derived, and
• includes the PaymentId encrypted in InvoiceRequest::payer_metadata so that it can be used when sending the payment for the requested invoice.

Errors if the offer contains unknown required features.

Trait Implementations

impl AsRef<[u8]> for Offer

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Offer

fn clone(&self) -> Offer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Offer

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

Formats the value using the given formatter.

impl Display for Offer

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

Formats the value using the given formatter.

impl FromStr for Offer

type Err = Bolt12ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Offer, <Offer as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for Offer

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Offer

fn eq(&self, other: &Offer) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Readable for Offer

fn read<R>(reader: &mut R) -> Result<Offer, DecodeError>

where R: Read,

Reads a Self in from the given Read.

impl TryFrom<Vec<u8>> for Offer

type Error = Bolt12ParseError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl Writeable for Offer

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

where W: Writer,

Writes self out to the given Writer.

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

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.

impl Eq for Offer