fedimint_client_rpc/

lib.rs

use std::collections::HashMap;
use std::str::FromStr;
use std::sync::Arc;
use std::time::Duration;

use async_stream::try_stream;
use fedimint_api_client::api::{ClientConfigDownloadError, FederationError};
use fedimint_bip39::{Bip39RootSecretStrategy, Mnemonic};
use fedimint_client::error::{
    ClientBuildError, ClientModuleError, GlobalRpcError, ModuleLookupError,
};
use fedimint_client::module::ClientModule;
use fedimint_client::secret::RootSecretStrategy;
use fedimint_client::{ClientHandleArc, ClientPreview, RootSecret};
use fedimint_connectors::ConnectorRegistry;
use fedimint_core::config::{FederationId, FederationIdPrefix};
use fedimint_core::db::{Database, IDatabaseTransactionOpsCoreTyped};
use fedimint_core::encoding::{Decodable, Encodable};
use fedimint_core::invite_code::{InviteCode, InviteCodeParseError};
use fedimint_core::task::{MaybeSend, MaybeSync};
use fedimint_core::util::{BoxFuture, BoxStream, FmtCompact as _};
use fedimint_core::{Amount, TieredCounts, impl_db_record};
use fedimint_derive_secret::{ChildId, DerivableSecret};
use fedimint_ln_client::{LightningClientInit, LightningClientModule};
use fedimint_meta_client::{MetaClientInit, MetaClientModule};
use fedimint_mint_client::{MintClientInit, MintClientModule, OOBNotes, OOBNotesParseError};
use fedimint_wallet_client::{WalletClientInit, WalletClientModule};
use futures::StreamExt;
use futures::future::{AbortHandle, Abortable};
use lightning_invoice::{Bolt11InvoiceDescriptionRef, ParseOrSemanticError};
use rand::thread_rng;
use serde::{Deserialize, Serialize};
use serde_json::json;
use tokio::sync::Mutex;
use tracing::info;

// Key prefixes for the unified database
#[repr(u8)]
#[derive(Clone, Copy, Debug)]
pub enum DbKeyPrefix {
    ClientDatabase = 0x00,
    Mnemonic = 0x01,
}

#[derive(Debug, Clone, Encodable, Decodable, Eq, PartialEq, Hash)]
pub struct MnemonicKey;

impl_db_record!(
    key = MnemonicKey,
    value = Vec<u8>,
    db_prefix = DbKeyPrefix::Mnemonic,
);

/// Parsed details from an OOB note.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ParsedNoteDetails {
    /// Total amount of all notes in the OOB notes
    pub total_amount: Amount,
    /// Federation ID prefix (always present)
    pub federation_id_prefix: FederationIdPrefix,
    /// Full federation ID (if invite is present)
    pub federation_id: Option<FederationId>,
    /// Invite code to join the federation (if present)
    pub invite_code: Option<InviteCode>,
    /// Number of notes per denomination
    pub note_counts: TieredCounts,
}

#[derive(Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub struct RpcRequest {
    pub request_id: u64,
    #[serde(flatten)]
    pub kind: RpcRequestKind,
}

#[derive(Serialize, Deserialize)]
#[serde(tag = "type", rename_all = "snake_case")]
pub enum RpcRequestKind {
    SetMnemonic {
        words: Vec<String>,
    },
    GenerateMnemonic,
    GetMnemonic,
    HasMnemonicSet,
    /// Join federation (requires mnemonic to be set first)
    JoinFederation {
        invite_code: String,
        force_recover: bool,
        client_name: String,
    },
    OpenClient {
        client_name: String,
    },
    CloseClient {
        client_name: String,
    },
    ClientRpc {
        client_name: String,
        module: String,
        method: String,
        payload: serde_json::Value,
    },
    CancelRpc {
        cancel_request_id: u64,
    },
    ParseInviteCode {
        invite_code: String,
    },
    ParseBolt11Invoice {
        invoice: String,
    },
    PreviewFederation {
        invite_code: String,
    },
    ParseOobNotes {
        oob_notes: String,
    },
    ParseLightningAddress {
        address: String,
    },
}

#[derive(Serialize, Deserialize, Clone, Debug)]
pub struct RpcResponse {
    pub request_id: u64,
    #[serde(flatten)]
    pub kind: RpcResponseKind,
}

#[derive(Serialize, Deserialize, Clone, Debug)]
#[serde(tag = "type", rename_all = "snake_case")]
pub enum RpcResponseKind {
    Data { data: serde_json::Value },
    Error { error: String },
    Aborted {},
    End {},
}

pub trait RpcResponseHandler: MaybeSend + MaybeSync {
    fn handle_response(&self, response: RpcResponse);
}

pub struct RpcGlobalState {
    /// Endpoints used for all global-state functionality
    connectors: ConnectorRegistry,
    clients: Mutex<HashMap<String, ClientHandleArc>>,
    rpc_handles: std::sync::Mutex<HashMap<u64, AbortHandle>>,
    unified_database: Database,
    preview_cache: std::sync::Mutex<Option<ClientPreview>>,
}

pub struct HandledRpc<'a> {
    pub task: Option<BoxFuture<'a, ()>>,
}

impl RpcGlobalState {
    pub fn new(connectors: ConnectorRegistry, unified_database: Database) -> Self {
        Self {
            connectors,
            clients: Mutex::new(HashMap::new()),
            rpc_handles: std::sync::Mutex::new(HashMap::new()),
            unified_database,
            preview_cache: std::sync::Mutex::new(None),
        }
    }

    async fn add_client(&self, client_name: String, client: ClientHandleArc) {
        let mut clients = self.clients.lock().await;
        clients.insert(client_name, client);
    }

    async fn get_client(&self, client_name: &str) -> Option<ClientHandleArc> {
        let clients = self.clients.lock().await;
        clients.get(client_name).cloned()
    }

    fn add_rpc_handle(&self, request_id: u64, handle: AbortHandle) {
        let mut handles = self.rpc_handles.lock().unwrap();
        if handles.insert(request_id, handle).is_some() {
            tracing::error!("RPC CLIENT ERROR: request id reuse detected");
        }
    }

    fn remove_rpc_handle(&self, request_id: u64) -> Option<AbortHandle> {
        let mut handles = self.rpc_handles.lock().unwrap();
        handles.remove(&request_id)
    }

    async fn client_builder() -> fedimint_client::ClientBuilder {
        let mut builder = fedimint_client::Client::builder().await;
        builder.with_module(MintClientInit);
        builder.with_module(LightningClientInit::default());
        builder.with_module(WalletClientInit(None));
        builder.with_module(MetaClientInit);
        builder
    }

    /// Get client-specific database with proper prefix
    async fn client_db(&self, client_name: String) -> Database {
        assert_eq!(client_name.len(), 36);

        let unified_db = &self.unified_database;
        let mut client_prefix = vec![DbKeyPrefix::ClientDatabase as u8];
        client_prefix.extend_from_slice(client_name.as_bytes());
        unified_db.with_prefix(client_prefix)
    }

    /// Handle joining federation using unified database
    async fn handle_join_federation(
        &self,

        invite_code: String,
        client_name: String,
        force_recover: bool,
    ) -> Result<(), RpcRequestError> {
        // Check if wallet mnemonic is set
        let mnemonic = self
            .get_mnemonic_from_db()
            .await?
            .ok_or(RpcRequestError::NoMnemonic)?;

        let client_db = self.client_db(client_name.clone()).await;

        let invite_code = InviteCode::from_str(&invite_code)?;
        let federation_id = invite_code.federation_id();

        // Derive federation-specific secret from wallet mnemonic
        let federation_secret = self.derive_federation_secret(&mnemonic, &federation_id);

        // Try to consume cached preview, otherwise create new one
        let cached_preview = self.preview_cache.lock().unwrap().take();
        let preview = match cached_preview {
            Some(preview) if preview.config().calculate_federation_id() == federation_id => preview,
            _ => {
                let builder = Self::client_builder().await;
                builder
                    .preview(self.connectors.clone(), &invite_code)
                    .await?
            }
        };

        // Check if backup exists
        #[allow(deprecated)]
        let backup = preview
            .download_backup_from_federation(RootSecret::StandardDoubleDerive(
                federation_secret.clone(),
            ))
            .await?;

        let client = if force_recover || backup.is_some() {
            Arc::new(
                preview
                    .recover(
                        client_db,
                        RootSecret::StandardDoubleDerive(federation_secret),
                        backup,
                    )
                    .await?,
            )
        } else {
            Arc::new(
                preview
                    .join(
                        client_db,
                        RootSecret::StandardDoubleDerive(federation_secret),
                    )
                    .await?,
            )
        };

        self.add_client(client_name, client).await;
        Ok(())
    }

    async fn handle_open_client(&self, client_name: String) -> Result<(), RpcRequestError> {
        // Check if wallet mnemonic is set
        let mnemonic = self
            .get_mnemonic_from_db()
            .await?
            .ok_or(RpcRequestError::NoMnemonic)?;

        let client_db = self.client_db(client_name.clone()).await;

        if !fedimint_client::Client::is_initialized(&client_db).await {
            return Err(RpcRequestError::ClientNotInitialized);
        }

        // Get the client config to retrieve the federation ID
        let client_config = fedimint_client::Client::get_config_from_db(&client_db)
            .await
            .ok_or(RpcRequestError::NoClientConfig)?;

        let federation_id = client_config.calculate_federation_id();

        // Derive federation-specific secret from wallet mnemonic
        let federation_secret = self.derive_federation_secret(&mnemonic, &federation_id);

        let builder = Self::client_builder().await;
        let client = Arc::new(
            builder
                .open(
                    self.connectors.clone(),
                    client_db,
                    RootSecret::StandardDoubleDerive(federation_secret),
                )
                .await?,
        );

        self.add_client(client_name, client).await;
        Ok(())
    }

    async fn handle_close_client(&self, client_name: String) -> Result<(), RpcRequestError> {
        let mut clients = self.clients.lock().await;
        let mut client = clients
            .remove(&client_name)
            .ok_or(RpcRequestError::ClientToCloseNotFound)?;

        // RPC calls might have cloned the client Arc before we remove the client.
        for attempt in 0.. {
            info!(attempt, "waiting for RPCs to drop the federation object");
            match Arc::try_unwrap(client) {
                Ok(client) => {
                    client.shutdown().await;
                    break;
                }
                Err(client_val) => client = client_val,
            }
            fedimint_core::task::sleep(Duration::from_millis(100)).await;
        }
        Ok(())
    }

    fn handle_client_rpc(
        self: Arc<Self>,
        client_name: String,
        module: String,
        method: String,
        payload: serde_json::Value,
    ) -> BoxStream<'static, Result<serde_json::Value, RpcRequestError>> {
        Box::pin(try_stream! {
            let client = self
                .get_client(&client_name)
                .await
                .ok_or_else(|| RpcRequestError::ClientNotFound {
                    client_name: client_name.clone(),
                })?;
            match module.as_str() {
                "" => {
                    let mut stream = client.handle_global_rpc(method, payload);
                    while let Some(item) = stream.next().await {
                        yield item?;
                    }
                }
                "ln" => {
                    let ln = client.get_first_module::<LightningClientModule>()?.inner();
                    let mut stream = ln.handle_rpc(method, payload).await;
                    while let Some(item) = stream.next().await {
                        yield item?;
                    }
                }
                "mint" => {
                    let mint = client.get_first_module::<MintClientModule>()?.inner();
                    let mut stream = mint.handle_rpc(method, payload).await;
                    while let Some(item) = stream.next().await {
                        yield item?;
                    }
                }
                "wallet" => {
                    let wallet = client
                        .get_first_module::<WalletClientModule>()?
                        .inner();
                    let mut stream = wallet.handle_rpc(method, payload).await;
                    while let Some(item) = stream.next().await {
                        yield item?;
                    }
                }
                "meta" => {
                    let meta = client.get_first_module::<MetaClientModule>()?.inner();
                    let mut stream = meta.handle_rpc(method, payload).await;
                    while let Some(item) = stream.next().await {
                        yield item?;
                    }
                }
                _ => {
                    Err(RpcRequestError::UnknownModule { module: module.clone() })?;
                },
            };
        })
    }

    fn parse_invite_code(
        &self,
        invite_code: String,
    ) -> Result<serde_json::Value, InviteCodeParseError> {
        let invite_code = InviteCode::from_str(&invite_code)?;

        Ok(json!({
            "url": invite_code.url(),
            "federation_id": invite_code.federation_id(),
        }))
    }

    fn parse_bolt11_invoice(
        &self,
        invoice_str: String,
    ) -> Result<serde_json::Value, RpcRequestError> {
        let invoice = lightning_invoice::Bolt11Invoice::from_str(&invoice_str)
            .map_err(RpcRequestError::InvalidInvoice)?;

        let amount_msat = invoice.amount_milli_satoshis().unwrap_or(0);
        let amount_sat = amount_msat as f64 / 1000.0;

        let expiry_seconds = invoice.expiry_time().as_secs();

        // memo
        let description = match invoice.description() {
            Bolt11InvoiceDescriptionRef::Direct(desc) => desc.to_string(),
            Bolt11InvoiceDescriptionRef::Hash(_) => "Description hash only".to_string(),
        };

        Ok(json!({
            "amount": amount_sat,
            "expiry": expiry_seconds,
            "memo": description,
        }))
    }

    async fn preview_federation(
        &self,
        invite_code: String,
    ) -> Result<serde_json::Value, RpcRequestError> {
        let invite = InviteCode::from_str(&invite_code)?;
        let federation_id = invite.federation_id();

        let builder = Self::client_builder().await;
        let preview = builder.preview(self.connectors.clone(), &invite).await?;

        let json_config = preview.config().to_json();
        // Store in cache
        *self.preview_cache.lock().unwrap() = Some(preview);

        Ok(json!({
            "config": json_config,
            "federation_id": federation_id.to_string(),
        }))
    }

    fn handle_rpc_inner(
        self: Arc<Self>,
        request: RpcRequest,
    ) -> Option<BoxStream<'static, Result<serde_json::Value, RpcRequestError>>> {
        match request.kind {
            RpcRequestKind::SetMnemonic { words } => Some(Box::pin(try_stream! {
                self.set_mnemonic(words).await?;
                yield serde_json::json!({ "success": true });
            })),
            RpcRequestKind::GenerateMnemonic => Some(Box::pin(try_stream! {
                let words = self.generate_mnemonic().await?;
                yield serde_json::json!({ "mnemonic": words });
            })),
            RpcRequestKind::GetMnemonic => Some(Box::pin(try_stream! {
                let words = self.get_mnemonic_words().await?;
                yield serde_json::json!({ "mnemonic": words });
            })),
            RpcRequestKind::HasMnemonicSet => Some(Box::pin(try_stream! {
                let is_set = self.has_mnemonic_set().await?;
                yield serde_json::json!(is_set);
            })),
            RpcRequestKind::JoinFederation {
                invite_code,
                client_name,
                force_recover,
            } => Some(Box::pin(try_stream! {
                self.handle_join_federation(invite_code, client_name, force_recover)
                    .await?;
                yield serde_json::json!(null);
            })),
            RpcRequestKind::OpenClient { client_name } => Some(Box::pin(try_stream! {
                self.handle_open_client(client_name).await?;
                yield serde_json::json!(null);
            })),
            RpcRequestKind::CloseClient { client_name } => Some(Box::pin(try_stream! {
                self.handle_close_client(client_name).await?;
                yield serde_json::json!(null);
            })),
            RpcRequestKind::ClientRpc {
                client_name,
                module,
                method,
                payload,
            } => Some(self.handle_client_rpc(client_name, module, method, payload)),
            RpcRequestKind::ParseInviteCode { invite_code } => Some(Box::pin(try_stream! {
                let result = self.parse_invite_code(invite_code)?;
                yield result;
            })),
            RpcRequestKind::ParseBolt11Invoice { invoice } => Some(Box::pin(try_stream! {
                let result = self.parse_bolt11_invoice(invoice)?;
                yield result;
            })),
            RpcRequestKind::PreviewFederation { invite_code } => Some(Box::pin(try_stream! {
                let result = self.preview_federation(invite_code).await?;
                yield result;
            })),
            RpcRequestKind::ParseOobNotes { oob_notes } => Some(Box::pin(try_stream! {
                let parsed = parse_oob_notes(&oob_notes)?;
                yield serde_json::to_value(parsed)?;
            })),
            RpcRequestKind::ParseLightningAddress { address } => Some(Box::pin(try_stream! {
                let url = fedimint_lnurl::parse_address(&address)
                    .ok_or(RpcRequestError::InvalidLightningAddress)?;
                let metadata = fedimint_lnurl::request(&url).await
                    .map_err(RpcRequestError::LnurlRequest)?;

                yield serde_json::to_value(metadata)?;
            })),
            RpcRequestKind::CancelRpc { cancel_request_id } => {
                if let Some(handle) = self.remove_rpc_handle(cancel_request_id) {
                    handle.abort();
                }
                None
            }
        }
    }

    pub fn handle_rpc(
        self: Arc<Self>,
        request: RpcRequest,
        handler: impl RpcResponseHandler + 'static,
    ) -> HandledRpc<'static> {
        let request_id = request.request_id;

        let Some(stream) = self.clone().handle_rpc_inner(request) else {
            return HandledRpc { task: None };
        };

        let (abort_handle, abort_registration) = AbortHandle::new_pair();
        self.add_rpc_handle(request_id, abort_handle);

        let task = Box::pin(async move {
            let mut stream = Abortable::new(stream, abort_registration);

            while let Some(result) = stream.next().await {
                let response = match result {
                    Ok(value) => RpcResponse {
                        request_id,
                        kind: RpcResponseKind::Data { data: value },
                    },
                    Err(e) => RpcResponse {
                        request_id,
                        kind: RpcResponseKind::Error {
                            error: e.fmt_compact().to_string(),
                        },
                    },
                };
                handler.handle_response(response);
            }

            // Clean up abort handle and send end message
            let _ = self.remove_rpc_handle(request_id);
            handler.handle_response(RpcResponse {
                request_id,
                kind: if stream.is_aborted() {
                    RpcResponseKind::Aborted {}
                } else {
                    RpcResponseKind::End {}
                },
            });
        });

        HandledRpc { task: Some(task) }
    }

    /// Retrieve the wallet-level mnemonic words.
    /// Returns the mnemonic as a vector of words, or None if no mnemonic is
    /// set.
    async fn get_mnemonic_words(&self) -> Result<Option<Vec<String>>, bip39::Error> {
        let mnemonic = self.get_mnemonic_from_db().await?;

        if let Some(mnemonic) = mnemonic {
            let words = mnemonic.words().map(|w| w.to_string()).collect();
            Ok(Some(words))
        } else {
            Ok(None)
        }
    }
    /// Set a mnemonic from user-provided words
    /// Returns an error if a mnemonic is already set
    async fn set_mnemonic(&self, words: Vec<String>) -> Result<(), RpcRequestError> {
        let all_words = words.join(" ");
        let mnemonic =
            Mnemonic::parse_in_normalized(fedimint_bip39::Language::English, &all_words)?;

        let mut dbtx = self.unified_database.begin_transaction().await;

        if dbtx.get_value(&MnemonicKey).await.is_some() {
            return Err(RpcRequestError::MnemonicExistsOnSet);
        }

        dbtx.insert_new_entry(&MnemonicKey, &mnemonic.to_entropy())
            .await;

        dbtx.commit_tx().await;

        Ok(())
    }

    /// Generate a new random mnemonic and set it
    /// Returns an error if a mnemonic is already set
    async fn generate_mnemonic(&self) -> Result<Vec<String>, RpcRequestError> {
        let mnemonic = Bip39RootSecretStrategy::<12>::random(&mut thread_rng());
        let words: Vec<String> = mnemonic.words().map(|w| w.to_string()).collect();

        let mut dbtx = self.unified_database.begin_transaction().await;

        if dbtx.get_value(&MnemonicKey).await.is_some() {
            return Err(RpcRequestError::MnemonicExistsOnGenerate);
        }

        dbtx.insert_new_entry(&MnemonicKey, &mnemonic.to_entropy())
            .await;

        dbtx.commit_tx().await;

        Ok(words)
    }

    /// Derive federation-specific secret from wallet mnemonic
    fn derive_federation_secret(
        &self,
        mnemonic: &Mnemonic,
        federation_id: &FederationId,
    ) -> DerivableSecret {
        let global_root_secret = Bip39RootSecretStrategy::<12>::to_root_secret(mnemonic);
        let multi_federation_root_secret = global_root_secret.child_key(ChildId(0));
        let federation_root_secret = multi_federation_root_secret.federation_key(federation_id);
        let federation_wallet_root_secret = federation_root_secret.child_key(ChildId(0));
        federation_wallet_root_secret.child_key(ChildId(0))
    }

    /// Fetch mnemonic from database
    async fn get_mnemonic_from_db(&self) -> Result<Option<Mnemonic>, bip39::Error> {
        let mut dbtx = self.unified_database.begin_transaction_nc().await;

        if let Some(mnemonic_entropy) = dbtx.get_value(&MnemonicKey).await {
            let mnemonic = Mnemonic::from_entropy(&mnemonic_entropy)?;
            Ok(Some(mnemonic))
        } else {
            Ok(None)
        }
    }

    /// Check if mnemonic is set
    async fn has_mnemonic_set(&self) -> Result<bool, bip39::Error> {
        let mnemonic = self.get_mnemonic_from_db().await?;
        Ok(mnemonic.is_some())
    }
}

pub fn parse_oob_notes(oob_notes_str: &str) -> Result<ParsedNoteDetails, OOBNotesParseError> {
    let oob_notes = OOBNotes::from_str(oob_notes_str)?;

    let total_amount = oob_notes.total_amount();
    let federation_id_prefix = oob_notes.federation_id_prefix();
    let invite_code = oob_notes.federation_invite();
    let federation_id = invite_code.as_ref().map(|inv| inv.federation_id());

    // Get note counts by denomination
    let notes = oob_notes.notes();
    let mut note_counts = TieredCounts::default();
    for (amount, _note) in notes.iter_items() {
        note_counts.inc(amount, 1);
    }

    Ok(ParsedNoteDetails {
        total_amount,
        federation_id_prefix,
        federation_id,
        invite_code,
        note_counts,
    })
}

/// Why a request to [`RpcGlobalState::handle_rpc`] failed; the chain of this
/// error is the text of the response's `error`.
#[derive(Debug, thiserror::Error)]
enum RpcRequestError {
    /// No wallet mnemonic is set yet.
    #[error("No wallet mnemonic set. Please set or generate a mnemonic first.")]
    NoMnemonic,

    /// A wallet mnemonic is already set, so another cannot be set.
    #[error(
        "Wallet mnemonic already exists. Please clear existing data before setting a new \
         mnemonic."
    )]
    MnemonicExistsOnSet,

    /// A wallet mnemonic is already set, so another cannot be generated.
    #[error(
        "Wallet mnemonic already exists. Please clear existing data before generating a new \
         mnemonic."
    )]
    MnemonicExistsOnGenerate,

    /// The words are not a valid mnemonic, or the stored mnemonic entropy is
    /// not.
    #[error(transparent)]
    Mnemonic(#[from] bip39::Error),

    /// The invite code does not parse.
    #[error(transparent)]
    InviteCode(#[from] InviteCodeParseError),

    /// The federation's config could not be downloaded, or it belongs to a
    /// different federation than the invite code names.
    #[error(transparent)]
    ConfigDownload(#[from] ClientConfigDownloadError),

    /// The federation could not be asked for a backup of the wallet.
    #[error(transparent)]
    Federation(#[from] FederationError),

    /// The client could not be joined, recovered or opened.
    #[error(transparent)]
    ClientBuild(#[from] ClientBuildError),

    /// The client's database was never joined to a federation.
    #[error("client is not initialized for this database")]
    ClientNotInitialized,

    /// The client's database has no federation config.
    #[error("Client config not found in database")]
    NoClientConfig,

    /// No open client has the name the request closes.
    #[error("client not found")]
    ClientToCloseNotFound,

    /// No open client has the name the request addresses.
    #[error("Client not found: {client_name}")]
    ClientNotFound { client_name: String },

    /// The request addresses a module the RPC does not serve.
    #[error("module not found: {module}")]
    UnknownModule { module: String },

    /// The client has no usable module of the kind the request addresses.
    #[error(transparent)]
    ModuleLookup(#[from] ModuleLookupError),

    /// The client failed a request that is not addressed to a module.
    #[error(transparent)]
    GlobalRpc(#[from] GlobalRpcError),

    /// The module failed the request.
    #[error(transparent)]
    Module(#[from] ClientModuleError),

    /// The Lightning invoice does not parse.
    #[error("Failed to parse Lightning invoice")]
    InvalidInvoice(#[source] ParseOrSemanticError),

    /// The OOB notes do not parse.
    #[error(transparent)]
    OobNotes(#[from] OOBNotesParseError),

    /// The input is not a Lightning address.
    #[error("Invalid Lightning Address")]
    InvalidLightningAddress,

    /// The LNURL request of a Lightning address failed; the payload is the
    /// reason it gives.
    #[error("{0}")]
    LnurlRequest(String),

    /// A response could not be converted to JSON.
    #[error(transparent)]
    Json(#[from] serde_json::Error),
}

#[cfg(test)]
mod tests;