cdk-ffi 0.17.0

//! FFI bindings for the NpubCash client SDK
//!
//! This module provides FFI-compatible bindings for interacting with the NpubCash API.
//! The client can be used standalone without requiring a wallet.

use std::sync::Arc;

use cdk_npubcash::{JwtAuthProvider, NpubCashClient as CdkNpubCashClient};

use crate::error::FfiError;
use crate::types::MintQuote;

/// FFI-compatible NpubCash client
///
/// This client provides access to the NpubCash API for fetching quotes
/// and managing user settings.
#[derive(uniffi::Object)]
pub struct NpubCashClient {
    inner: Arc<CdkNpubCashClient>,
}

#[uniffi::export(async_runtime = "tokio")]
impl NpubCashClient {
    /// Create a new NpubCash client
    ///
    /// # Arguments
    ///
    /// * `base_url` - Base URL of the NpubCash service (e.g., <https://npub.cash>)
    /// * `nostr_secret_key` - Nostr secret key for authentication. Accepts either:
    ///   - Hex-encoded secret key (64 characters)
    ///   - Bech32 `nsec` format (e.g., "nsec1...")
    ///
    /// # Errors
    ///
    /// Returns an error if the secret key is invalid or cannot be parsed
    #[uniffi::constructor]
    pub fn new(base_url: String, nostr_secret_key: String) -> Result<Self, FfiError> {
        let keys = parse_nostr_secret_key(&nostr_secret_key)?;
        let auth_provider = Arc::new(JwtAuthProvider::new(base_url.clone(), keys));
        let client = CdkNpubCashClient::new(base_url, auth_provider);

        Ok(Self {
            inner: Arc::new(client),
        })
    }

    /// Fetch quotes from NpubCash
    ///
    /// # Arguments
    ///
    /// * `since` - Optional Unix timestamp to fetch quotes from. If `None`, fetches all quotes.
    ///
    /// # Returns
    ///
    /// A list of quotes from the NpubCash service. The client automatically handles
    /// pagination to fetch all available quotes.
    ///
    /// # Errors
    ///
    /// Returns an error if the API request fails or authentication fails
    pub async fn get_quotes(&self, since: Option<u64>) -> Result<Vec<NpubCashQuote>, FfiError> {
        let quotes = self
            .inner
            .get_quotes(since)
            .await
            .map_err(|e| FfiError::internal(e.to_string()))?;

        Ok(quotes.into_iter().map(Into::into).collect())
    }

    /// Set the mint URL for the user on the NpubCash server
    ///
    /// Updates the default mint URL used by the NpubCash server when creating quotes.
    ///
    /// # Arguments
    ///
    /// * `mint_url` - URL of the Cashu mint to use (e.g., <https://mint.example.com>)
    ///
    /// # Errors
    ///
    /// Returns an error if the API request fails or authentication fails
    pub async fn set_mint_url(&self, mint_url: String) -> Result<NpubCashUserResponse, FfiError> {
        let response = self
            .inner
            .set_mint_url(mint_url)
            .await
            .map_err(|e| FfiError::internal(e.to_string()))?;

        Ok(response.into())
    }
}

/// A quote from the NpubCash service
#[derive(Debug, Clone, uniffi::Record)]
pub struct NpubCashQuote {
    /// Unique identifier for the quote
    pub id: String,
    /// Amount in the specified unit
    pub amount: u64,
    /// Currency or unit for the amount (e.g., "sat")
    pub unit: String,
    /// Unix timestamp when the quote was created
    pub created_at: u64,
    /// Unix timestamp when the quote was paid (if paid)
    pub paid_at: Option<u64>,
    /// Unix timestamp when the quote expires
    pub expires_at: Option<u64>,
    /// Mint URL associated with the quote
    pub mint_url: Option<String>,
    /// Lightning invoice request
    pub request: Option<String>,
    /// Quote state (e.g., "PAID", "PENDING")
    pub state: Option<String>,
    /// Whether the quote is locked
    pub locked: Option<bool>,
}

impl From<cdk_npubcash::Quote> for NpubCashQuote {
    fn from(quote: cdk_npubcash::Quote) -> Self {
        Self {
            id: quote.id,
            amount: quote.amount,
            unit: quote.unit,
            created_at: quote.created_at,
            paid_at: quote.paid_at,
            expires_at: quote.expires_at,
            mint_url: quote.mint_url,
            request: quote.request,
            state: quote.state,
            locked: quote.locked,
        }
    }
}

/// Convert a NpubCash quote to a wallet MintQuote
///
/// This allows the quote to be used with the wallet's minting functions.
/// Note that the resulting MintQuote will not have a secret key set,
/// which may be required for locked quotes.
///
/// # Arguments
///
/// * `quote` - The NpubCash quote to convert
///
/// # Returns
///
/// A MintQuote that can be used with wallet minting functions
#[uniffi::export]
pub fn npubcash_quote_to_mint_quote(quote: NpubCashQuote) -> MintQuote {
    let cdk_quote = cdk_npubcash::Quote {
        id: quote.id,
        amount: quote.amount,
        unit: quote.unit,
        created_at: quote.created_at,
        paid_at: quote.paid_at,
        expires_at: quote.expires_at,
        mint_url: quote.mint_url,
        request: quote.request,
        state: quote.state,
        locked: quote.locked,
    };

    let mint_quote: cdk::wallet::MintQuote = cdk_quote.into();
    mint_quote.into()
}

/// Response from updating user settings on NpubCash
#[derive(Debug, Clone, uniffi::Record)]
pub struct NpubCashUserResponse {
    /// Whether the request resulted in an error
    pub error: bool,
    /// User's public key
    pub pubkey: String,
    /// Configured mint URL
    pub mint_url: Option<String>,
    /// Whether quotes are locked
    pub lock_quote: bool,
}

impl From<cdk_npubcash::UserResponse> for NpubCashUserResponse {
    fn from(response: cdk_npubcash::UserResponse) -> Self {
        Self {
            error: response.error,
            pubkey: response.data.user.pubkey,
            mint_url: response.data.user.mint_url,
            lock_quote: response.data.user.lock_quote,
        }
    }
}

/// Derive Nostr keys from a wallet seed
///
/// This function derives the same Nostr keys that a wallet would use for NpubCash
/// authentication, using the NIP-06 path `m/44'/1237'/0'/0/0`.
///
/// # Arguments
///
/// * `seed` - The wallet seed bytes (must be at least 64 bytes)
///
/// # Returns
///
/// The hex-encoded Nostr secret key that can be used with `NpubCashClient::new()`
///
/// # Errors
///
/// Returns an error if the seed is too short or key derivation fails
#[uniffi::export]
pub fn npubcash_derive_secret_key_from_seed(seed: Vec<u8>) -> Result<String, FfiError> {
    if seed.len() < 64 {
        return Err(FfiError::internal(
            "Seed must be at least 64 bytes".to_string(),
        ));
    }

    let seed: [u8; 64] = seed[..64]
        .try_into()
        .map_err(|_| FfiError::internal("Failed to read wallet seed bytes".to_string()))?;
    let secret_key = cdk::wallet::derive_npubcash_secret_key_from_seed(&seed)
        .map_err(|e| FfiError::internal(format!("Failed to derive secret key: {}", e)))?;

    Ok(secret_key.to_secret_hex())
}

/// Get the public key for a given Nostr secret key
///
/// # Arguments
///
/// * `nostr_secret_key` - Nostr secret key. Accepts either:
///   - Hex-encoded secret key (64 characters)
///   - Bech32 `nsec` format (e.g., "nsec1...")
///
/// # Returns
///
/// The hex-encoded public key
///
/// # Errors
///
/// Returns an error if the secret key is invalid
#[uniffi::export]
pub fn npubcash_get_pubkey(nostr_secret_key: String) -> Result<String, FfiError> {
    let keys = parse_nostr_secret_key(&nostr_secret_key)?;
    Ok(keys.public_key().to_hex())
}

/// Parse a Nostr secret key from either hex or nsec format
fn parse_nostr_secret_key(key: &str) -> Result<nostr_sdk::Keys, FfiError> {
    // Try parsing as nsec (bech32) first
    if key.starts_with("nsec") {
        nostr_sdk::Keys::parse(key)
            .map_err(|e| FfiError::internal(format!("Invalid nsec key: {}", e)))
    } else {
        // Try parsing as hex
        let secret_key = nostr_sdk::SecretKey::parse(key)
            .map_err(|e| FfiError::internal(format!("Invalid hex secret key: {}", e)))?;
        Ok(nostr_sdk::Keys::new(secret_key))
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn npubcash_seed_derivation_uses_wallet_nip06_key() {
        let seed = [0x42u8; 64];
        let secret_hex = npubcash_derive_secret_key_from_seed(seed.to_vec())
            .expect("npubcash key derives from wallet seed");
        let wallet_secret = cdk::wallet::derive_npubcash_secret_key_from_seed(&seed)
            .expect("wallet npubcash key derives");

        assert_eq!(secret_hex, wallet_secret.to_secret_hex());
        assert_ne!(&wallet_secret.to_secret_bytes()[..], &seed[..32]);
    }
}