From: Jeffrey Czyz Date: Thu, 1 Aug 2024 22:25:14 +0000 (-0500) Subject: Re-write Offer::issuer_signing_pubkey documentation X-Git-Url: http://git.bitcoin.ninja/?a=commitdiff_plain;h=73512709e77c42310585ac5d920b76de32d8e88f;p=rust-lightning Re-write Offer::issuer_signing_pubkey documentation --- diff --git a/lightning/src/offers/offer.rs b/lightning/src/offers/offer.rs index 2a1a68575..37cb5df7e 100644 --- a/lightning/src/offers/offer.rs +++ b/lightning/src/offers/offer.rs @@ -631,7 +631,17 @@ macro_rules! offer_accessors { ($self: ident, $contents: expr) => { $contents.supported_quantity() } - /// The public key used by the recipient to sign invoices. + /// 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`]. + /// + /// [`InvoiceRequest`]: crate::offers::invoice_request::InvoiceRequest + /// [`Bolt12Invoice::signing_pubkey`]: crate::offers::invoice::Bolt12Invoice::signing_pubkey pub fn issuer_signing_pubkey(&$self) -> Option { $contents.issuer_signing_pubkey() }