Migrate FFI wrapper objects to UniFFI proc-macro export

Migrate `Bolt11Invoice`, `Offer`, `HumanReadableName`, `Refund`, and
`Bolt12Invoice` from UDL interface definitions to proc-macro derives
(`uniffi::Object`) with `#[uniffi::export]` on impl blocks and
`#[uniffi::constructor]` on constructors.

For types with `[Traits=(Debug, Display, Eq)]`, use
`#[uniffi::export(Debug, Display, Eq)]` on the struct.

Replace UDL interface definitions with `typedef interface` references.

Co-Authored-By: HAL 9000

Author: tnull

bindings/ldk_node.udl

@@ -455,95 +455,17 @@ typedef enum AsyncPaymentsRole;
 
 typedef dictionary RouteHintHop;
 
-[Traits=(Debug, Display, Eq)]
-interface Bolt11Invoice {
-	[Throws=NodeError, Name=from_str]
-	constructor([ByRef] string invoice_str);
-	sequence<u8> signable_hash();
-	PaymentHash payment_hash();
-	PaymentSecret payment_secret();
-	u64? amount_milli_satoshis();
-	u64 expiry_time_seconds();
-	u64 seconds_since_epoch();
-	u64 seconds_until_expiry();
-	boolean is_expired();
-	boolean would_expire(u64 at_time_seconds);
-	Bolt11InvoiceDescription invoice_description();
-	u64 min_final_cltv_expiry_delta();
-	Network network();
-	Currency currency();
-	sequence<Address> fallback_addresses();
-	sequence<sequence<RouteHintHop>> route_hints();
-	PublicKey recover_payee_pub_key();
-};
+typedef interface Bolt11Invoice;
 
 typedef enum OfferAmount;
 
-[Traits=(Debug, Display, Eq)]
-interface Offer {
-	[Throws=NodeError, Name=from_str]
-	constructor([ByRef] string offer_str);
-	OfferId id();
-	boolean is_expired();
-	string? offer_description();
-	string? issuer();
-	OfferAmount? amount();
-	boolean is_valid_quantity(u64 quantity);
-	boolean expects_quantity();
-	boolean supports_chain(Network chain);
-	sequence<Network> chains();
-	sequence<u8>? metadata();
-	u64? absolute_expiry_seconds();
-	PublicKey? issuer_signing_pubkey();
-};
+typedef interface Offer;
 
-interface HumanReadableName {
-	[Throws=NodeError, Name=from_encoded]
-	constructor([ByRef] string encoded);
-	string user();
-	string domain();
-};
+typedef interface HumanReadableName;
 
-[Traits=(Debug, Display, Eq)]
-interface Refund {
-	[Throws=NodeError, Name=from_str]
-	constructor([ByRef] string refund_str);
-	string refund_description();
-	u64? absolute_expiry_seconds();
-	boolean is_expired();
-	string? issuer();
-	sequence<u8> payer_metadata();
-	Network? chain();
-	u64 amount_msats();
-	u64? quantity();
-	PublicKey payer_signing_pubkey();
-	string? payer_note();
-};
+typedef interface Refund;
 
-interface Bolt12Invoice {
-	[Throws=NodeError, Name=from_str]
-	constructor([ByRef] string invoice_str);
-	PaymentHash payment_hash();
-	u64 amount_msats();
-	OfferAmount? amount();
-	PublicKey signing_pubkey();
-	u64 created_at();
-	u64? absolute_expiry_seconds();
-	u64 relative_expiry();
-	boolean is_expired();
-	string? invoice_description();
-	string? issuer();
-	string? payer_note();
-	sequence<u8>? metadata();
-	u64? quantity();
-	sequence<u8> signable_hash();
-	PublicKey payer_signing_pubkey();
-	PublicKey? issuer_signing_pubkey();
-	sequence<u8> chain();
-	sequence<sequence<u8>>? offer_chains();
-	sequence<Address> fallback_addresses();
-	sequence<u8> encode();
-};
+typedef interface Bolt12Invoice;
 
 [Custom]
 typedef string Txid;

src/ffi/types.rs

@@ -233,12 +233,15 @@ impl From<LdkAmount> for OfferAmount {
 /// [`InvoiceRequest`]: lightning::offers::invoice_request::InvoiceRequest
 /// [`Bolt12Invoice`]: lightning::offers::invoice::Bolt12Invoice
 /// [`Offer`]: lightning::offers::Offer:amount
-#[derive(Debug, Clone, PartialEq, Eq)]
+#[derive(Debug, Clone, PartialEq, Eq, uniffi::Object)]
+#[uniffi::export(Debug, Display, Eq)]
 pub struct Offer {
 	pub(crate) inner: LdkOffer,
 }
 
+#[uniffi::export]
 impl Offer {
+	#[uniffi::constructor]
 	pub fn from_str(offer_str: &str) -> Result<Self, Error> {
 		offer_str.parse()
 	}
@@ -376,15 +379,18 @@ impl std::fmt::Display for Offer {
 /// This struct can also be used for LN-Address recipients.
 ///
 /// [Homograph Attacks]: https://en.wikipedia.org/wiki/IDN_homograph_attack
+#[derive(uniffi::Object)]
 pub struct HumanReadableName {
 	pub(crate) inner: LdkHumanReadableName,
 }
 
+#[uniffi::export]
 impl HumanReadableName {
 	/// Constructs a new [`HumanReadableName`] from the standard encoding - `user`@`domain`.
 	///
 	/// If `user` includes the standard BIP 353 ₿ prefix it is automatically removed as required by
 	/// BIP 353.
+	#[uniffi::constructor]
 	pub fn from_encoded(encoded: &str) -> Result<Self, Error> {
 		let hrn = match LdkHumanReadableName::from_encoded(encoded) {
 			Ok(hrn) => Ok(hrn),
@@ -438,12 +444,15 @@ impl AsRef<LdkHumanReadableName> for HumanReadableName {
 ///
 /// [`Bolt12Invoice`]: lightning::offers::invoice::Bolt12Invoice
 /// [`Offer`]: lightning::offers::offer::Offer
-#[derive(Debug, Clone, PartialEq, Eq)]
+#[derive(Debug, Clone, PartialEq, Eq, uniffi::Object)]
+#[uniffi::export(Debug, Display, Eq)]
 pub struct Refund {
 	pub(crate) inner: LdkRefund,
 }
 
+#[uniffi::export]
 impl Refund {
+	#[uniffi::constructor]
 	pub fn from_str(refund_str: &str) -> Result<Self, Error> {
 		refund_str.parse()
 	}
@@ -550,12 +559,14 @@ impl std::fmt::Display for Refund {
 	}
 }
 
-#[derive(Debug, Clone, PartialEq, Eq)]
+#[derive(Debug, Clone, PartialEq, Eq, uniffi::Object)]
 pub struct Bolt12Invoice {
 	pub(crate) inner: LdkBolt12Invoice,
 }
 
+#[uniffi::export]
 impl Bolt12Invoice {
+	#[uniffi::constructor]
 	pub fn from_str(invoice_str: &str) -> Result<Self, Error> {
 		invoice_str.parse()
 	}
@@ -1055,12 +1066,15 @@ impl From<lightning::routing::router::RouteHintHop> for RouteHintHop {
 }
 
 /// Represents a syntactically and semantically correct lightning BOLT11 invoice.
-#[derive(Debug, Clone, PartialEq, Eq)]
+#[derive(Debug, Clone, PartialEq, Eq, uniffi::Object)]
+#[uniffi::export(Debug, Display, Eq)]
 pub struct Bolt11Invoice {
 	pub(crate) inner: LdkBolt11Invoice,
 }
 
+#[uniffi::export]
 impl Bolt11Invoice {
+	#[uniffi::constructor]
 	pub fn from_str(invoice_str: &str) -> Result<Self, Error> {
 		invoice_str.parse()
 	}