Add lightning address support for Cashu via npub.cash

Implement get_lightning_address and register_lightning_address for the
Cashu wallet using CDK's built-in npub.cash integration. When configured
with a npubcash_url, the wallet enables npub.cash during init, starts
background polling for incoming quotes, and returns deterministic
lightning addresses derived from the wallet's Nostr keys.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: benthecarman

orange-sdk/Cargo.toml

@@ -16,7 +16,7 @@ name = "orange_sdk"
 default = ["spark"]
 uniffi = ["dep:uniffi", "spark", "cashu", "rand", "pin-project-lite"]
 spark = ["breez-sdk-spark", "uuid", "serde_json"]
-cashu = ["cdk", "serde_json"]
+cashu = ["cdk", "cdk/npubcash", "nostr-sdk", "serde_json"]
 _test-utils = ["corepc-node", 'electrsd', "cashu", "uuid/v7", "rand"]
 _cashu-tests = ["_test-utils", "cdk-ldk-node", "cdk/mint", "cdk-sqlite", "cdk-axum", "axum"]
 
@@ -32,6 +32,7 @@ breez-sdk-spark = { git = "https://github.com/breez/spark-sdk.git", rev = "ef76a
 tokio = { version = "1.0", default-features = false, features = ["rt-multi-thread", "sync", "macros"] }
 uuid = { version = "1.0", default-features = false, optional = true }
 cdk = { version = "0.15.1", default-features = false, features = ["wallet"], optional = true }
+nostr-sdk = { version = "0.44.1", default-features = false, optional = true }
 serde_json = { version = "1.0", optional = true }
 async-trait = "0.1"
 log = "0.4.28"

orange-sdk/src/ffi/cashu.rs

@@ -45,24 +45,34 @@ pub struct CashuConfig {
 	pub mint_url: String,
 	/// The currency unit to use (typically Sat)
 	pub unit: CurrencyUnit,
+	/// Optional npub.cash URL for lightning address support
+	pub npubcash_url: Option<String>,
 }
 
 #[uniffi::export]
 impl CashuConfig {
 	#[uniffi::constructor]
-	pub fn new(mint_url: String, unit: CurrencyUnit) -> Self {
-		CashuConfig { mint_url, unit }
+	pub fn new(mint_url: String, unit: CurrencyUnit, npubcash_url: Option<String>) -> Self {
+		CashuConfig { mint_url, unit, npubcash_url }
 	}
 }
 
 impl From<CashuConfig> for OrangeCashuConfig {
 	fn from(config: CashuConfig) -> Self {
-		OrangeCashuConfig { mint_url: config.mint_url, unit: config.unit.into() }
+		OrangeCashuConfig {
+			mint_url: config.mint_url,
+			unit: config.unit.into(),
+			npubcash_url: config.npubcash_url,
+		}
 	}
 }
 
 impl From<OrangeCashuConfig> for CashuConfig {
 	fn from(config: OrangeCashuConfig) -> Self {
-		CashuConfig { mint_url: config.mint_url, unit: config.unit.into() }
+		CashuConfig {
+			mint_url: config.mint_url,
+			unit: config.unit.into(),
+			npubcash_url: config.npubcash_url,
+		}
 	}
 }

orange-sdk/src/trusted_wallet/cashu/mod.rs

@@ -31,6 +31,7 @@ use cdk::{Amount as CdkAmount, StreamExt};
 
 use graduated_rebalancer::ReceivedLightningPayment;
 
+use nostr_sdk::ToBech32;
 use tokio::sync::{mpsc, watch};
 
 use std::collections::HashMap;
@@ -52,6 +53,8 @@ pub struct CashuConfig {
 	pub mint_url: String,
 	/// The currency unit to use (typically Sat)
 	pub unit: CurrencyUnit,
+	/// Optional npub.cash URL for lightning address support (e.g., `https://npub.cash`)
+	pub npubcash_url: Option<String>,
 }
 
 /// A wallet implementation using the Cashu (CDK) SDK.
@@ -68,6 +71,7 @@ pub struct Cashu {
 	event_queue: Arc<EventQueue>,
 	tx_metadata: TxMetadataStore,
 	runtime: Arc<Runtime>,
+	npubcash_url: Option<String>,
 }
 
 impl TrustedWalletInterface for Cashu {
@@ -497,13 +501,32 @@ impl TrustedWalletInterface for Cashu {
 	fn get_lightning_address(
 		&self,
 	) -> Pin<Box<dyn Future<Output = Result<Option<String>, TrustedError>> + Send + '_>> {
-		Box::pin(async { Ok(None) })
+		Box::pin(async {
+			if let Some(ref url) = self.npubcash_url {
+				let keys = self.cashu_wallet.get_npubcash_keys().map_err(|e| {
+					TrustedError::WalletOperationFailed(format!(
+						"Failed to get npub.cash keys: {e}"
+					))
+				})?;
+				let npub = keys.public_key().to_bech32().map_err(|e| {
+					TrustedError::WalletOperationFailed(format!("Failed to encode npub: {e}"))
+				})?;
+				let domain = url.trim_start_matches("https://").trim_start_matches("http://");
+				return Ok(Some(format!("{npub}@{domain}")));
+			}
+			Ok(None)
+		})
 	}
 
 	fn register_lightning_address(
 		&self, _name: String,
 	) -> Pin<Box<dyn Future<Output = Result<(), TrustedError>> + Send + '_>> {
 		Box::pin(async {
+			if self.npubcash_url.is_some() {
+				// npub.cash addresses are deterministic from the Nostr keys,
+				// and set_mint_url is called during init. Nothing to do here.
+				return Ok(());
+			}
 			Err(TrustedError::UnsupportedOperation(
 				"register_lightning_address is not supported in Cashu Wallet".to_string(),
 			))
@@ -652,6 +675,57 @@ impl Cashu {
 			});
 		}
 
+		// Initialize npub.cash if configured
+		let npubcash_url = cashu_config.npubcash_url.clone();
+
+		if let Some(ref url) = npubcash_url {
+			if let Err(e) = cashu_wallet.enable_npubcash(url.clone()).await {
+				log_error!(logger, "Failed to enable npub.cash: {e}");
+			} else {
+				log_info!(logger, "npub.cash enabled with URL: {url}");
+
+				// Start background polling for npub.cash quotes
+				let wallet_for_npubcash = Arc::clone(&cashu_wallet);
+				let sender_for_npubcash = mint_quote_sender.clone();
+				let logger_for_npubcash = Arc::clone(&logger);
+				let mut shutdown_for_npubcash = shutdown_sender.subscribe();
+				runtime.spawn_cancellable_background_task(async move {
+					let poll_interval = Duration::from_secs(30);
+					loop {
+						tokio::select! {
+							_ = shutdown_for_npubcash.changed() => {
+								log_info!(logger_for_npubcash, "npub.cash polling shutdown");
+								return;
+							}
+							_ = tokio::time::sleep(poll_interval) => {
+								match wallet_for_npubcash.sync_npubcash_quotes().await {
+									Ok(quotes) => {
+										for quote in quotes {
+											if matches!(quote.state, cdk::nuts::MintQuoteState::Paid) {
+												let id = quote.id.clone();
+												if let Err(e) = sender_for_npubcash.send(quote).await {
+													log_error!(
+														logger_for_npubcash,
+														"Failed to send npub.cash quote {id} for monitoring: {e}"
+													);
+												}
+											}
+										}
+									},
+									Err(e) => {
+										log_error!(
+											logger_for_npubcash,
+											"Failed to sync npub.cash quotes: {e}"
+										);
+									},
+								}
+							}
+						}
+					}
+				});
+			}
+		}
+
 		Ok(Cashu {
 			cashu_wallet,
 			unit: cashu_config.unit,
@@ -664,6 +738,7 @@ impl Cashu {
 			event_queue,
 			tx_metadata,
 			runtime,
+			npubcash_url,
 		})
 	}
 

orange-sdk/tests/test_utils.rs

@@ -498,6 +498,7 @@ async fn build_test_nodes() -> TestParams {
 			extra_config: ExtraConfig::Cashu(orange_sdk::CashuConfig {
 				mint_url: format!("http://127.0.0.1:{}", mint_addr.port()),
 				unit: orange_sdk::CurrencyUnit::Sat,
+				npubcash_url: None,
 			}),
 		};
 		let wallet = Arc::new(Wallet::new(wallet_config).await.unwrap());