feat: Lightning Payment Verification

.env.example

@@ -24,3 +24,15 @@ HG_HOMESERVER_PUBKY=ufibwbmed6jeq9k4p583go95wofakh9fwpp4k734trq79pd9u1uy
 # SMS verification limits (optional, defaults to 2 per week, 4 per year)
 # HG_MAX_SMS_VERIFICATIONS_PER_WEEK=2
 # HG_MAX_SMS_VERIFICATIONS_PER_YEAR=4
+
+# Lightning Verification Settings
+# HG_LIGHTNING_INVOICE_PRICE_SAT=1000
+# HG_LIGHTNING_INVOICE_EXPIRY_SECONDS=600
+# HG_LIGHTNING_INVOICE_DESCRIPTION="Pubky Homegate Verification"
+
+# PhoenixD credentials
+# For development purpose, run phoenixd with docker: `docker run -p 9740:9740 -d acinq/phoenixd:latest`
+# Admin endpoint: http://localhost:9740
+# Password is autogenerated in ~/.phoenix/phoenix.conf in the http-password variable.
+HG_PHOENIXD_API_URL=http://localhost:9740
+HG_PHOENIXD_API_PASSWORD=

Cargo.toml

@@ -7,18 +7,19 @@ edition = "2024"
 anyhow = "1.0.100"
 argon2 = "0.5"
 async-trait = "0.1.89"
-axum = { version = "0.8.1", features = ["macros"] }
+axum = { version = "0.8.1", features = ["macros", "ws"] }
 axum-server = { version = "0.7.1", features = ["tls-rustls-no-provider"] }
 base64 = "0.22"
 blake3 = "1.5"
 chrono = "0.4"
 dotenvy = "0.15.7"
 envy = "0.4.2"
 futures-util = "0.3.31"
-getrandom = "0.2"
+getrandom = "0.3.4"
 hex = "0.4"
 regex = "1.11"
 reqwest = { version = "0.12", features = ["json"] }
+reqwest-websocket = "0.5.1"
 sea-query = { version = "0.32.6", features = [ "with-chrono", "postgres-array" ]}
 sea-query-binder = { version = "0.7.0", features = [ "with-chrono", "runtime-tokio", "sqlx-postgres", "postgres-array" ] }
 serde = { version = "1.0.228", features = ["derive"] }

README.md

@@ -2,7 +2,12 @@
 
 A backend service to gatekeep [Pubky Homeserver](https://github.com/pubky/pubky-core/) signups.
 
-# Run
+This service depends on
+
+- [Prelude](https://docs.prelude.so/) as a SMS service provider.
+- [PhoenixD](https://github.com/ACINQ/phoenixd) As a Lightning Payment provider.
+
+# Usage
 
 See `.env.example` for a description of which values you need to put in a `.env` file.
 
@@ -22,6 +27,10 @@ We use [Prelude](https://docs.prelude.so/) for SMS verification. Keep in mind th
 - Has a maximum of 10 verifications.
 - Has a single pending verification at a time. Multiple `send_code` calls reuse the existing session.
 
+## Lightning Payment Verification
+
+We use [phoenixd](https://github.com/ACINQ/phoenixd) for Lightning Payment verifications.
+
 ## Running Tests
 
 Tests require a PostgreSQL connection string for database integration tests: