@@ -10547,7 +10547,7 @@ where
10547
10547
}
10548
10548
10549
10549
/// Pays for an [`Offer`] looked up using [BIP 353] Human Readable Names resolved by the DNS
10550
- /// resolver(s) at `dns_resolvers` which resolve names according to bLIP 32.
10550
+ /// resolver(s) at `dns_resolvers` which resolve names according to [ bLIP 32] .
10551
10551
///
10552
10552
/// If the wallet supports paying on-chain schemes, you should instead use
10553
10553
/// [`OMNameResolver::resolve_name`] and [`OMNameResolver::handle_dnssec_proof_for_uri`] (by
@@ -10567,29 +10567,35 @@ where
10567
10567
///
10568
10568
/// To revoke the request, use [`ChannelManager::abandon_payment`] prior to receiving the
10569
10569
/// invoice. If abandoned, or an invoice isn't received in a reasonable amount of time, the
10570
- /// payment will fail with an [`Event::InvoiceRequestFailed`].
10570
+ /// payment will fail with an [`PaymentFailureReason::UserAbandoned`] or
10571
+ /// [`PaymentFailureReason::InvoiceRequestExpired`], respectively.
10571
10572
///
10572
10573
/// # Privacy
10573
10574
///
10574
10575
/// For payer privacy, uses a derived payer id and uses [`MessageRouter::create_blinded_paths`]
10575
- /// to construct a [`BlindedPath `] for the reply path. For further privacy implications, see the
10576
+ /// to construct a [`BlindedMessagePath `] for the reply path. For further privacy implications, see the
10576
10577
/// docs of the parameterized [`Router`], which implements [`MessageRouter`].
10577
10578
///
10578
10579
/// # Limitations
10579
10580
///
10580
10581
/// Requires a direct connection to the given [`Destination`] as well as an introduction node in
10581
- /// [`Offer::paths`] or to [`Offer::signing_pubkey `], if empty. A similar restriction applies to
10582
+ /// [`Offer::paths`] or to [`Offer::issuer_signing_pubkey `], if empty. A similar restriction applies to
10582
10583
/// the responding [`Bolt12Invoice::payment_paths`].
10583
10584
///
10584
10585
/// # Errors
10585
10586
///
10586
10587
/// Errors if:
10587
10588
/// - a duplicate `payment_id` is provided given the caveats in the aforementioned link,
10588
10589
///
10590
+ /// [BIP 353]: https://github.com/bitcoin/bips/blob/master/bip-0353.mediawiki
10591
+ /// [bLIP 32]: https://github.com/lightning/blips/blob/master/blip-0032.md
10589
10592
/// [`Bolt12Invoice::payment_paths`]: crate::offers::invoice::Bolt12Invoice::payment_paths
10590
10593
/// [`OMNameResolver::resolve_name`]: crate::onion_message::dns_resolution::OMNameResolver::resolve_name
10591
10594
/// [`OMNameResolver::handle_dnssec_proof_for_uri`]: crate::onion_message::dns_resolution::OMNameResolver::handle_dnssec_proof_for_uri
10592
10595
/// [Avoiding Duplicate Payments]: #avoiding-duplicate-payments
10596
+ /// [`BlindedMessagePath`]: crate::blinded_path::message::BlindedMessagePath
10597
+ /// [`PaymentFailureReason::UserAbandoned`]: crate::events::PaymentFailureReason::UserAbandoned
10598
+ /// [`PaymentFailureReason::InvoiceRequestRejected`]: crate::events::PaymentFailureReason::InvoiceRequestRejected
10593
10599
#[cfg(feature = "dnssec")]
10594
10600
pub fn pay_for_offer_from_human_readable_name(
10595
10601
&self, name: HumanReadableName, amount_msats: u64, payment_id: PaymentId, payer_note: Option<String>,
0 commit comments