feat: phoenixd ln backend

.github/workflows/ci.yml

@@ -34,10 +34,11 @@ jobs:
             -p cdk-sqlite,
             -p cdk-axum,
             -p cdk-cln,
-            -p cdk-fake-wallet,
+            -p cdk-phoenixd,
             -p cdk-strike,
             -p cdk-lnbits
             -p cdk-integration-tests,
+            -p cdk-fake-wallet,
             --bin cdk-cli,
             --bin cdk-mintd,
           ]

Cargo.toml

@@ -34,6 +34,7 @@ cdk-sqlite = { version = "0.3", path = "./crates/cdk-sqlite", default-features =
 cdk-redb = { version = "0.3", path = "./crates/cdk-redb", default-features = false }
 cdk-cln = { version = "0.3", path = "./crates/cdk-cln", default-features = false }
 cdk-lnbits = { version = "0.3", path = "./crates/cdk-lnbits", default-features = false }
+cdk-phoenixd = { version = "0.3", path = "./crates/cdk-phoenixd", default-features = false }
 cdk-axum = { version = "0.3", path = "./crates/cdk-axum", default-features = false }
 cdk-fake-wallet = { version = "0.3", path = "./crates/cdk-fake-wallet", default-features = false }
 cdk-strike = { version = "0.3", path = "./crates/cdk-strike", default-features = false }

crates/cdk-axum/src/router_handlers.rs

@@ -158,7 +158,7 @@ pub async fn get_melt_bolt11_quote(
             payload.request.to_string(),
             payload.unit,
             payment_quote.amount,
-            payment_quote.fee.into(),
+            payment_quote.fee,
             unix_time() + state.quote_ttl,
             payment_quote.request_lookup_id,
         )

crates/cdk-cln/src/lib.rs

@@ -45,7 +45,7 @@ pub struct Cln {
 }
 
 impl Cln {
-    /// Create new ['Cln]
+    /// Create new [`Cln`]
     pub async fn new(
         rpc_socket: PathBuf,
         fee_reserve: FeeReserve,
@@ -144,7 +144,8 @@ impl MintLightning for Cln {
         Ok(PaymentQuoteResponse {
             request_lookup_id: melt_quote_request.request.payment_hash().to_string(),
             amount,
-            fee,
+            fee: fee.into(),
+            state: MeltQuoteState::Unpaid,
         })
     }
 

crates/cdk-fake-wallet/src/lib.rs

@@ -110,7 +110,8 @@ impl MintLightning for FakeWallet {
         Ok(PaymentQuoteResponse {
             request_lookup_id: melt_quote_request.request.payment_hash().to_string(),
             amount,
-            fee,
+            fee: fee.into(),
+            state: MeltQuoteState::Unpaid,
         })
     }
 

crates/cdk-lnbits/src/lib.rs

@@ -146,7 +146,8 @@ impl MintLightning for LNbits {
         Ok(PaymentQuoteResponse {
             request_lookup_id: melt_quote_request.request.payment_hash().to_string(),
             amount,
-            fee,
+            fee: fee.into(),
+            state: MeltQuoteState::Unpaid,
         })
     }
 

crates/cdk-mintd/Cargo.toml

@@ -17,6 +17,7 @@ cdk-redb = { workspace = true, default-features = false, features = ["mint"] }
 cdk-sqlite = { workspace = true, default-features = false, features = ["mint"] }
 cdk-cln = { workspace = true, default-features = false }
 cdk-lnbits = { workspace = true, default-features = false }
+cdk-phoenixd = { workspace = true, default-features = false }
 cdk-fake-wallet = { workspace = true, default-features = false }
 cdk-strike.workspace = true
 cdk-axum = { workspace = true, default-features = false }
@@ -31,3 +32,4 @@ bip39.workspace = true
 tower-http = { version = "0.5.2", features = ["cors"] }
 lightning-invoice.workspace = true
 home.workspace = true
+url.workspace = true

crates/cdk-mintd/example.config.toml

@@ -43,3 +43,7 @@ ln_backend = "cln"
 # admin_api_key = ""
 # invoice_api_key = ""
 # lnbits_api = ""
+
+# [phoenixd]
+# api_password = ""
+# api_url = ""

crates/cdk-mintd/src/config.rs

@@ -23,8 +23,7 @@ pub enum LnBackend {
     Strike,
     LNbits,
     FakeWallet,
-    //  Greenlight,
-    //  Ldk,
+    Phoenixd,
 }
 
 #[derive(Debug, Clone, Serialize, Deserialize, Default)]
@@ -53,6 +52,12 @@ pub struct Cln {
     pub rpc_path: PathBuf,
 }
 
+#[derive(Debug, Clone, Serialize, Deserialize, Default)]
+pub struct Phoenixd {
+    pub api_password: String,
+    pub api_url: String,
+}
+
 #[derive(Debug, Clone, Serialize, Deserialize)]
 pub struct FakeWallet {
     pub supported_units: Vec<CurrencyUnit>,
@@ -87,6 +92,7 @@ pub struct Settings {
     pub cln: Option<Cln>,
     pub strike: Option<Strike>,
     pub lnbits: Option<LNbits>,
+    pub phoenixd: Option<Phoenixd>,
     pub fake_wallet: Option<FakeWallet>,
     pub database: Database,
 }
@@ -152,6 +158,7 @@ impl Settings {
             LnBackend::Cln => assert!(settings.cln.is_some()),
             LnBackend::Strike => assert!(settings.strike.is_some()),
             LnBackend::LNbits => assert!(settings.lnbits.is_some()),
+            LnBackend::Phoenixd => assert!(settings.phoenixd.is_some()),
             LnBackend::FakeWallet => (),
         }
 

crates/cdk-mintd/src/main.rs

@@ -8,7 +8,7 @@ use std::path::PathBuf;
 use std::str::FromStr;
 use std::sync::Arc;
 
-use anyhow::{anyhow, Result};
+use anyhow::{anyhow, bail, Result};
 use axum::Router;
 use bip39::Mnemonic;
 use cdk::cdk_database::{self, MintDatabase};
@@ -24,6 +24,7 @@ use cdk_axum::LnKey;
 use cdk_cln::Cln;
 use cdk_fake_wallet::FakeWallet;
 use cdk_lnbits::LNbits;
+use cdk_phoenixd::Phoenixd;
 use cdk_redb::MintRedbDatabase;
 use cdk_sqlite::MintSqliteDatabase;
 use cdk_strike::Strike;
@@ -34,6 +35,7 @@ use futures::StreamExt;
 use tokio::sync::Mutex;
 use tower_http::cors::CorsLayer;
 use tracing_subscriber::EnvFilter;
+use url::Url;
 
 mod cli;
 mod config;
@@ -84,8 +86,8 @@ async fn main() -> anyhow::Result<()> {
 
     let mut contact_info: Option<Vec<ContactInfo>> = None;
 
-    if let Some(nostr_contact) = settings.mint_info.contact_nostr_public_key {
-        let nostr_contact = ContactInfo::new("nostr".to_string(), nostr_contact);
+    if let Some(nostr_contact) = &settings.mint_info.contact_nostr_public_key {
+        let nostr_contact = ContactInfo::new("nostr".to_string(), nostr_contact.to_string());
 
         contact_info = match contact_info {
             Some(mut vec) => {
@@ -96,8 +98,8 @@ async fn main() -> anyhow::Result<()> {
         };
     }
 
-    if let Some(email_contact) = settings.mint_info.contact_email {
-        let email_contact = ContactInfo::new("email".to_string(), email_contact);
+    if let Some(email_contact) = &settings.mint_info.contact_email {
+        let email_contact = ContactInfo::new("email".to_string(), email_contact.to_string());
 
         contact_info = match contact_info {
             Some(mut vec) => {
@@ -232,6 +234,55 @@ async fn main() -> anyhow::Result<()> {
             ln_backends.insert(ln_key, Arc::new(lnbits));
 
             supported_units.insert(unit, (input_fee_ppk, 64));
+            vec![router]
+        }
+        LnBackend::Phoenixd => {
+            let api_password = settings
+                .clone()
+                .phoenixd
+                .expect("Checked at config load")
+                .api_password;
+
+            let api_url = settings
+                .clone()
+                .phoenixd
+                .expect("Checked at config load")
+                .api_url;
+
+            if fee_reserve.percent_fee_reserve < 0.04 {
+                bail!("Fee reserve is too low needs to be at least 0.02");
+            }
+
+            let webhook_endpoint = "/webhook/phoenixd";
+
+            let mint_url = Url::parse(&settings.info.url)?;
+
+            let webhook_url = mint_url.join(webhook_endpoint)?.to_string();
+
+            let (sender, receiver) = tokio::sync::mpsc::channel(8);
+
+            let phoenixd = Phoenixd::new(
+                api_password.to_string(),
+                api_url.to_string(),
+                MintMeltSettings::default(),
+                MintMeltSettings::default(),
+                fee_reserve,
+                Arc::new(Mutex::new(Some(receiver))),
+                webhook_url,
+            )?;
+
+            let router = phoenixd
+                .create_invoice_webhook(webhook_endpoint, sender)
+                .await?;
+
+            supported_units.insert(CurrencyUnit::Sat, (input_fee_ppk, 64));
+            ln_backends.insert(
+                LnKey {
+                    unit: CurrencyUnit::Sat,
+                    method: PaymentMethod::Bolt11,
+                },
+                Arc::new(phoenixd),
+            );
 
             vec![router]
         }

crates/cdk-phoenixd/Cargo.toml

@@ -0,0 +1,24 @@
+[package]
+name = "cdk-phoenixd"
+version = { workspace = true }
+edition = "2021"
+authors = ["CDK Developers"]
+homepage.workspace = true
+repository.workspace = true
+rust-version.workspace = true # MSRV
+license.workspace = true
+description = "CDK ln backend for phoenixd"
+
+[dependencies]
+async-trait.workspace = true
+anyhow.workspace = true
+axum.workspace = true
+bitcoin.workspace = true
+cdk = { workspace = true, default-features = false, features = ["mint"] }
+futures.workspace = true
+tokio.workspace = true
+tracing.workspace = true
+thiserror.workspace = true
+phoenixd-rs = "0.2.0"
+# phoenixd-rs = { path = "../../../../phoenixd-rs" }
+uuid.workspace = true

crates/cdk-phoenixd/README.md

@@ -0,0 +1,46 @@
+# cdk-phoenixd
+
+## Run phoenixd
+
+The `phoenixd` node is included in the cdk and needs to be run separately.
+Get started here: [Phoenixd Server Documentation](https://phoenix.acinq.co/server/get-started)
+
+## Start Phoenixd
+
+By default, `phoenixd` will run with auto-liquidity enabled. While this simplifies channel management, it makes fees non-deterministic, which is not recommended for most scenarios. However, it is necessary to start with auto-liquidity enabled in order to open a channel and get started.
+
+Start the node with auto-liquidity enabled as documented by [Phoenixd](https://phoenix.acinq.co/server/get-started):
+```sh
+./phoenixd
+```
+
+> **Note:** By default the `auto-liquidity` will open a channel of 2m sats depending on the size of mint you plan to run you may want to increase this by setting the `--auto-liquidity` flag to `5m` or `10m`.
+
+## Open Channel
+
+Once the node is running, create an invoice using the phoenixd-cli to fund your node. A portion of this deposit will go to ACINQ as a fee for the provided liquidity, and a portion will cover the mining fee. These two fees cannot be refunded or withdrawn from the node. More on fees can be found [here](https://phoenix.acinq.co/server/auto-liquidity#fees). The remainder will stay as the node balance and can be withdrawn later.
+```sh
+./phoenix-cli createinvoice \
+    --description "Fund Node" \
+    --amountSat xxxxx
+```
+
+> **Note:** The amount above should be set depending on the size of the mint you would like to run as it will determine the size of the channel and amount of liquidity.
+
+## Check Channel state
+
+After paying the invoice view that a channal has been opened.
+```sh
+./phoenix-cli listchannels
+```
+
+## Restart Phoenixd without `auto-liquidity`
+
+Now that the node has a channel, it is recommended to stop the node and restart it without auto-liquidity. This will prevent phoenixd from opening new channels and incurring additional fees.
+```sh
+./phoenixd --auto-liquidity off
+```
+
+## Start cashu-mintd
+
+Once the node is running following the [cashu-mintd](../cdk-mintd/README.md) to start the mint. by default the `api_url` will be `http://127.0.0.1:9740` and the `api_password` can be found in `~/.phoenix/phoenix.conf` these will need to be set in the `cdk-mintd` config file.

crates/cdk-phoenixd/src/error.rs

@@ -0,0 +1,26 @@
+//! Error for phoenixd ln backend
+
+use thiserror::Error;
+
+/// Phoenixd Error
+#[derive(Debug, Error)]
+pub enum Error {
+    /// Invoice amount not defined
+    #[error("Unknown invoice amount")]
+    UnknownInvoiceAmount,
+    /// Unknown invoice
+    #[error("Unknown invoice")]
+    UnknownInvoice,
+    /// Unsupported unit
+    #[error("Unit Unsupported")]
+    UnsupportedUnit,
+    /// Anyhow error
+    #[error(transparent)]
+    Anyhow(#[from] anyhow::Error),
+}
+
+impl From<Error> for cdk::cdk_lightning::Error {
+    fn from(e: Error) -> Self {
+        Self::Lightning(Box::new(e))
+    }
+}