[!Warning] This project is in early development, it does however work with real sats! Always use amounts you don't mind losing.

Cashu Development Kit

CDK is a collection of rust crates for Cashu wallets and mints written in Rust.

ALPHA This library is in early development, the api will change and should be used with caution.

Quick Start

CDK uses Nix flakes to manage development environments. We provide a lean default shell for standard development and a full-stack shell for integration testing.

# Enter the lean development shell (Rust + PostgreSQL)
nix develop

# OR enter the full regtest environment (Bitcoind + Lightning Nodes)
nix develop .#regtest

For more details on available environments, see the Development Guide.

Project structure

The project is split up into several crates in the crates/ directory:

• Libraries:
  • cashu: Core Cashu protocol implementation.
  • cdk: Rust implementation of Cashu protocol.
  • cdk-http-client: HTTP client abstraction for wallet-to-mint communication.
  • cdk-sqlite: SQLite Storage backend.
  • cdk-postgres: PostgreSQL Storage backend.
  • cdk-redb: Redb Storage backend.
  • cdk-supabase: Supabase Storage backend.
  • cdk-axum: Axum webserver for mint.
  • cdk-cln: CLN Lightning backend for mint.
  • cdk-lnd: Lnd Lightning backend for mint.
  • cdk-lnbits: LNbits Lightning backend for mint. Note: Only LNBits v1 API is supported.
  • cdk-ldk-node: LDK Node Lightning backend for mint.
  • cdk-bdk: Onchain Bitcoin backend using BDK.
  • cdk-fake-wallet: Fake Lightning backend for mint. To be used only for testing, quotes are automatically filled.
  • cdk-common: Common utilities and shared code.
  • cdk-sql-common: Common SQL utilities for storage backends.
  • cdk-signatory: Signing utilities and cryptographic operations.
  • cdk-payment-processor: Payment processing functionality.
  • cdk-prometheus: Prometheus metrics integration.
  • cdk-npubcash: npub.cash SDK integration.
  • cdk-ffi: Foreign Function Interface bindings for other languages.
  • cdk-integration-tests: Integration test suite.
  • cdk-mint-rpc: Mint management gRPC server and cli.
• Binaries:
  • cdk-cli: Cashu wallet CLI.
  • cdk-mintd: Cashu Mint Binary.
  • cdk-mint-cli: Cashu Mint management gRPC client cli.

Implemented NUTs:

Mandatory

Optional

License

Code is under the MIT License

Contribution

All contributions are welcome.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, shall be licensed as above, without any additional terms or conditions.

Please see the development guide.