continue receive flow on offer/invoice creation failure

Author: Camillarhi

src/payment/unified_qr.rs

@@ -64,20 +64,33 @@ impl UnifiedQrPayment {
 	/// Generates a URI with an on-chain address, [BOLT 11] invoice and [BOLT 12] offer.
 	///
 	/// The URI allows users to send the payment request allowing the wallet to decide
-	/// which payment method to use. This enables a fallback mechanism: older wallets
-	/// can always pay using the provided on-chain address, while newer wallets will
-	/// typically opt to use the provided BOLT11 invoice or BOLT12 offer.
+	/// which payment method to use. This enables a fallback mechanism:
+	/// - Older wallets can always pay using the provided on-chain address
+	/// - Newer wallets will typically opt to use the provided BOLT11 invoice or BOLT12 offer
+	///
+	/// The URI will always include an on-chain address, and will include a BOLT11 invoice and BOLT12 offer
+	/// when they can be successfully generated. Offer generation may fail in certain conditions while still
+	/// allowing invoice generation (see examples below).
 	///
 	/// # Parameters
 	/// - `amount_sats`: The amount to be received, specified in satoshis.
 	/// - `description`: A description or note associated with the payment.
 	///   This message is visible to the payer and can provide context or details about the payment.
 	/// - `expiry_sec`: The expiration time for the payment, specified in seconds.
 	///
+	/// # Examples
+	/// ## When BOLT12 offer generation might fail
+	/// A BOLT12 offer requires:
+	/// - Sufficiently connected channels for pathfinding
+	/// - Available liquidity in channels
+	/// - Valid route hints
+	/// If these conditions aren't met (e.g., when first setting up a node with no channels),
+	/// the URI will still be generated but without the BOLT12 offer.
+	///
 	/// Returns a payable URI that can be used to request and receive a payment of the amount
-	/// given. In case of an error, the function returns `Error::WalletOperationFailed`for on-chain
-	/// address issues, `Error::InvoiceCreationFailed` for BOLT11 invoice issues, or
-	/// `Error::OfferCreationFailed` for BOLT12 offer issues.
+	/// given. Failure to generate the on-chain address will result in an error return
+	/// (`Error::WalletOperationFailed`), while failures in invoice or offer generation will
+	/// result in those components being omitted from the URI.
 	///
 	/// The generated URI can then be given to a QR code library.
 	///
@@ -95,7 +108,7 @@ impl UnifiedQrPayment {
 			Ok(offer) => Some(offer),
 			Err(e) => {
 				log_error!(self.logger, "Failed to create offer: {}", e);
-				return Err(Error::OfferCreationFailed);
+				None
 			},
 		};
 
@@ -111,7 +124,7 @@ impl UnifiedQrPayment {
 			Ok(invoice) => Some(invoice),
 			Err(e) => {
 				log_error!(self.logger, "Failed to create invoice {}", e);
-				return Err(Error::InvoiceCreationFailed);
+				None
 			},
 		};
 

tests/integration_tests_rust.rs

@@ -1083,6 +1083,21 @@ fn generate_bip21_uri() {
 	let address_a = node_a.onchain_payment().new_address().unwrap();
 	let premined_sats = 5_000_000;
 
+	let expected_amount_sats = 100_000;
+	let expiry_sec = 4_000;
+
+	// Test 1: Verify URI generation (on-chain + BOLT11) works
+	// even before any channels are opened. This checks the graceful fallback behavior.
+	let initial_uqr_payment = node_b
+		.unified_qr_payment()
+		.receive(expected_amount_sats, "asdf", expiry_sec)
+		.expect("Failed to generate URI");
+	println!("Initial URI (no channels): {}", initial_uqr_payment);
+
+	assert!(initial_uqr_payment.contains("bitcoin:"));
+	assert!(initial_uqr_payment.contains("lightning="));
+	assert!(!initial_uqr_payment.contains("lno=")); // BOLT12 requires channels
+
 	premine_and_distribute_funds(
 		&bitcoind.client,
 		&electrsd.client,
@@ -1100,20 +1115,16 @@ fn generate_bip21_uri() {
 	expect_channel_ready_event!(node_a, node_b.node_id());
 	expect_channel_ready_event!(node_b, node_a.node_id());
 
-	let expected_amount_sats = 100_000;
-	let expiry_sec = 4_000;
-
-	let uqr_payment = node_b.unified_qr_payment().receive(expected_amount_sats, "asdf", expiry_sec);
+	// Test 2: Verify URI generation (on-chain + BOLT11 + BOLT12) works after channels are established.
+	let uqr_payment = node_b
+		.unified_qr_payment()
+		.receive(expected_amount_sats, "asdf", expiry_sec)
+		.expect("Failed to generate URI");
 
-	match uqr_payment.clone() {
-		Ok(ref uri) => {
-			println!("Generated URI: {}", uri);
-			assert!(uri.contains("bitcoin:"));
-			assert!(uri.contains("lightning="));
-			assert!(uri.contains("lno="));
-		},
-		Err(e) => panic!("Failed to generate URI: {:?}", e),
-	}
+	println!("Generated URI: {}", uqr_payment);
+	assert!(uqr_payment.contains("bitcoin:"));
+	assert!(uqr_payment.contains("lightning="));
+	assert!(uqr_payment.contains("lno="));
 }
 
 #[test]