Deprecate functions in invoice_utils module

ChannelManager::create_bolt11_invoice is a simpler and more flexible way
of creating a BOLT11 invoice, so deprecate the corresponding functions
in the invoice_utils module.

diff --git a/lightning/src/ln/invoice_utils.rs b/lightning/src/ln/invoice_utils.rs
index be1b430dd67a084ce43b7610e48e397724f532d8..a39222c3fcbae38d21a11ffea0922af8e5d9a2fe 100644 (file)
--- a/lightning/src/ln/invoice_utils.rs
+++ b/lightning/src/ln/invoice_utils.rs
@@ -313,6 +313,7 @@ fn rotate_through_iterators<T, I: Iterator<Item = T>>(mut vecs: Vec<I>) -> impl
        })
 }
 
+#[deprecated(note = "Use ChannelManager::create_bolt11_invoice instead.")]
 /// Utility to construct an invoice. Generally, unless you want to do something like a custom
 /// cltv_expiry, this is what you should be using to create an invoice. The reason being, this
 /// method stores the invoice's payment secret and preimage in `ChannelManager`, so (a) the user
@@ -354,6 +355,7 @@ where
        channelmanager.create_bolt11_invoice(params)
 }
 
+#[deprecated(note = "Use ChannelManager::create_bolt11_invoice instead.")]
 /// Utility to construct an invoice. Generally, unless you want to do something like a custom
 /// cltv_expiry, this is what you should be using to create an invoice. The reason being, this
 /// method stores the invoice's payment secret and preimage in `ChannelManager`, so (a) the user
@@ -396,6 +398,7 @@ where
        channelmanager.create_bolt11_invoice(params)
 }
 
+#[deprecated(note = "Use ChannelManager::create_bolt11_invoice instead.")]
 /// See [`create_invoice_from_channelmanager`].
 ///
 /// This version allows for providing custom [`PaymentHash`] and description hash for the invoice.
@@ -429,6 +432,7 @@ where
        channelmanager.create_bolt11_invoice(params)
 }
 
+#[deprecated(note = "Use ChannelManager::create_bolt11_invoice instead.")]
 /// See [`create_invoice_from_channelmanager`].
 ///
 /// This version allows for providing a custom [`PaymentHash`] for the invoice.