crate-only several BOLT12 methods that require unbounded generics

These are not expressible in C/most languages, and thus must be
hidden.

Author: TheBlueMatt

lightning/src/offers/invoice.rs

@@ -16,7 +16,7 @@
 //! The payment recipient must include a [`PaymentHash`], so as to reveal the preimage upon payment
 //! receipt, and one or more [`BlindedPaymentPath`]s for the payer to use when sending the payment.
 //!
-//! ```
+//! ```ignore
 //! extern crate bitcoin;
 //! extern crate lightning;
 //!
@@ -243,8 +243,7 @@ macro_rules! invoice_explicit_signing_pubkey_builder_methods { ($self: ident, $s
 		Self::new(&refund.bytes, contents, ExplicitSigningPubkey {})
 	}
 
-	/// Builds an unsigned [`Bolt12Invoice`] after checking for valid semantics. It can be signed by
-	/// [`UnsignedBolt12Invoice::sign`].
+	/// Builds an unsigned [`Bolt12Invoice`] after checking for valid semantics.
 	pub fn build($self: $self_type) -> Result<UnsignedBolt12Invoice, Bolt12SemanticError> {
 		#[cfg(feature = "std")] {
 			if $self.invoice.is_offer_or_refund_expired() {
@@ -579,7 +578,9 @@ macro_rules! unsigned_invoice_sign_method { ($self: ident, $self_type: ty $(, $s
 	/// Signs the [`TaggedHash`] of the invoice using the given function.
 	///
 	/// Note: The hash computation may have included unknown, odd TLV records.
-	pub fn sign<F: SignBolt12InvoiceFn>(
+	///
+	/// This is not exported to bindings users as functions aren't currently mapped.
+	pub(crate) fn sign<F: SignBolt12InvoiceFn>(
 		$($self_mut)* $self: $self_type, sign: F
 	) -> Result<Bolt12Invoice, SignError> {
 		let pubkey = $self.contents.fields().signing_pubkey;

lightning/src/offers/invoice_request.rs

@@ -531,7 +531,9 @@ macro_rules! unsigned_invoice_request_sign_method { (
 	/// Signs the [`TaggedHash`] of the invoice request using the given function.
 	///
 	/// Note: The hash computation may have included unknown, odd TLV records.
-	pub fn sign<F: SignInvoiceRequestFn>(
+	///
+	/// This is not exported to bindings users as functions are not yet mapped.
+	pub(crate) fn sign<F: SignInvoiceRequestFn>(
 		$($self_mut)* $self: $self_type, sign: F
 	) -> Result<InvoiceRequest, SignError> {
 		let pubkey = $self.contents.payer_signing_pubkey;

lightning/src/sign/mod.rs

@@ -883,9 +883,6 @@ pub trait NodeSigner {
 
 	/// Signs the [`TaggedHash`] of a BOLT 12 invoice.
 	///
-	/// May be called by a function passed to [`UnsignedBolt12Invoice::sign`] where `invoice` is the
-	/// callee.
-	///
 	/// Implementors may check that the `invoice` is expected rather than blindly signing the tagged
 	/// hash. An `Ok` result should sign `invoice.tagged_hash().as_digest()` with the node's signing
 	/// key or an ephemeral key to preserve privacy, whichever is associated with