29 releases (11 breaking)
| new 0.14.3 | Jan 11, 2026 |
|---|---|
| 0.14.2 | Dec 5, 2025 |
| 0.14.2-rc.3 | Nov 27, 2025 |
| 0.11.0 | Jun 29, 2025 |
| 0.5.0 | Nov 19, 2024 |
#9 in #cashu
Used in cdk-mintd
250KB
5.5K
SLoC
CDK LNBits
ALPHA This library is in early development, the API will change and should be used with caution.
LNBits backend implementation for the Cashu Development Kit (CDK). This provides integration with LNBits for Lightning Network functionality.
Note: Only LNBits v1 API is supported. This backend uses the websocket-based v1 API for real-time payment notifications.
Installation
Add this to your Cargo.toml:
[dependencies]
cdk-lnbits = "*"
Configuration for cdk-mintd
Config File
[ln]
ln_backend = "lnbits"
[lnbits]
admin_api_key = "your-admin-api-key"
invoice_api_key = "your-invoice-api-key"
lnbits_api = "https://your-lnbits-instance.com/api/v1"
fee_percent = 0.02 # Optional, defaults to 2%
reserve_fee_min = 2 # Optional, defaults to 2 sats
Environment Variables
All configuration can be set via environment variables:
| Variable | Description | Required |
|---|---|---|
CDK_MINTD_LN_BACKEND |
Set to lnbits |
Yes |
CDK_MINTD_LNBITS_ADMIN_API_KEY |
LNBits admin API key | Yes |
CDK_MINTD_LNBITS_INVOICE_API_KEY |
LNBits invoice API key | Yes |
CDK_MINTD_LNBITS_LNBITS_API |
LNBits API URL | Yes |
CDK_MINTD_LNBITS_FEE_PERCENT |
Fee percentage (default: 0.02) |
No |
CDK_MINTD_LNBITS_RESERVE_FEE_MIN |
Minimum fee in sats (default: 2) |
No |
Example
export CDK_MINTD_LN_BACKEND=lnbits
export CDK_MINTD_LNBITS_ADMIN_API_KEY=your-admin-api-key
export CDK_MINTD_LNBITS_INVOICE_API_KEY=your-invoice-api-key
export CDK_MINTD_LNBITS_LNBITS_API=https://your-lnbits-instance.com/api/v1
cdk-mintd
Getting API Keys
- Log in to your LNBits instance
- Go to your wallet
- Click on "API Info" to find your admin and invoice API keys
License
This project is licensed under the MIT License.
Dependencies
~42–61MB
~1M SLoC