Lightning backends #

qpayd supports Phoenixd and barkd for Lightning invoice creation and reconciliation.

Phoenixd:

[stores.lightning]
backend = "phoenixd"
url = "http://127.0.0.1:9740"
api_password_env = "PHOENIXD_LIMITED_PASSWORD"

barkd:

[stores.lightning]
backend = "barkd"
url = "http://127.0.0.1:3000"
api_password_env = "BARKD_AUTH_TOKEN"

Sweeping uses the Lightning payout config:

[stores.lightning_payout]
backend = "barkd"
url = "http://127.0.0.1:3000"
full_api_password_env = "BARKD_SWEEP_AUTH_TOKEN"

[stores.lightning_payout.sweep]
destination_descriptor_env = "QPAYD_MAIN_TREASURY_DESCRIPTOR"
min_balance_sats = 100000
target_balance_sats = 25000
interval_seconds = 3600

Run the sweep service separately when you want a stronger security split:

qpayd --config qpayd.toml sweep

Lightning refund execution uses the same payout wallet access. Keep those credentials with the wallet host when splitting public receive from wallet operations:

[stores.lightning_payout]
backend = "barkd"
url = "http://127.0.0.1:3000"
full_api_password_env = "BARKD_FULL_AUTH_TOKEN"

[stores.lightning_payout.refunds]
enabled = true
max_refund_sats = 100000
daily_refund_limit_sats = 500000