aljaz/cdk

mirror of https://github.com/aljazceru/cdk.git synced 2025-12-19 13:44:55 +01:00

Files

C b5b8ee557c Fix race conditions in minting tests (#1043 )

There was a race conditions between the database storing the mint quote and the
fake wallet paying the invoice of a yet not existing mint quote

Add a delay of seconds before paying all invoices

To recreate the slow conditions that would make our database slower than the
external Fakewallet in Linux

```
sudo tc qdisc add dev lo root netem delay 200ms 50ms
ionice -c3  nix develop -i -L .#stable --command just itest-payment-processor FAKEWALLET
```

To reset

```
sudo tc qdisc del dev lo root

```

2025-09-08 13:02:45 +01:00

src

Fix race conditions in minting tests (#1043 )

2025-09-08 13:02:45 +01:00

build.rs

Rust docs (#681 )

2025-03-25 23:27:38 +00:00

Cargo.toml

feat: uuid version (#891 )

2025-08-18 16:25:24 +01:00

README.md

feat: payment processor

2025-03-10 14:44:57 +00:00

README.md

CDK Payment Processor

The cdk-payment-processor is a Rust crate that provides both a binary and a library for handling payments to and from a cdk mint.

Overview

Library Components

Payment Processor Server: Handles interaction with payment processor backend implementations
Client: Used by mintd to query the server for payment information
Backend Implementations: Supports CLN, LND, and a fake wallet (for testing)

Features

Modular backend system supporting multiple Lightning implementations
Extensible design allowing for custom backend implementations

Building from Source

Prerequisites

Install Nix package manager
Enter development environment:

nix develop

Configuration

The server requires different environment variables depending on your chosen Lightning Network backend.

Core Settings

# Choose backend: CLN, LND, or FAKEWALLET
export CDK_PAYMENT_PROCESSOR_LN_BACKEND="CLN"

# Server configuration
export CDK_PAYMENT_PROCESSOR_LISTEN_HOST="127.0.0.1"
export CDK_PAYMENT_PROCESSOR_LISTEN_PORT="8090"

Backend-Specific Configuration

Core Lightning (CLN)

# Path to CLN RPC socket
export CDK_PAYMENT_PROCESSOR_CLN_RPC_PATH="/path/to/lightning-rpc"

Lightning Network Daemon (LND)

# LND connection details
export CDK_PAYMENT_PROCESSOR_LND_ADDRESS="localhost:10009"
export CDK_PAYMENT_PROCESSOR_LND_CERT_FILE="/path/to/tls.cert"
export CDK_PAYMENT_PROCESSOR_LND_MACAROON_FILE="/path/to/macaroon"

Building and Running

Build and run the binary with your chosen backend:

# For CLN backend
cargo run --bin cdk-payment-processor --no-default-features --features cln

# For LND backend
cargo run --bin cdk-payment-processor --no-default-features --features lnd

# For fake wallet (testing only)
cargo run --bin cdk-payment-processor --no-default-features --features fake

Development

To implement a new backend:

Create a new module implementing the payment processor traits
Add appropriate feature flags
Update the binary to support the new backend

For library usage examples and API documentation, refer to the crate documentation.