No description
  • Rust 89.6%
  • Nix 9.9%
  • Just 0.5%
Find a file
tsk 69f0900835
Some checks failed
CI / flake-check (push) Failing after 2s
fix: error
2026-08-24 20:28:11 +00:00
.github init commit 2026-08-23 11:29:36 +00:00
crates fix: error 2026-08-24 20:28:11 +00:00
docs fix(api): expose locked-quote settings endpoint 2026-08-24 10:28:00 +00:00
migrations init commit 2026-08-23 11:29:36 +00:00
nix fix: ratelimiting 2026-08-24 18:46:37 +00:00
.env.example fix: ratelimiting 2026-08-24 18:46:37 +00:00
.gitignore init commit 2026-08-23 11:29:36 +00:00
AGENTS.md init commit 2026-08-23 11:29:36 +00:00
Cargo.lock init commit 2026-08-23 11:29:36 +00:00
Cargo.toml init commit 2026-08-23 11:29:36 +00:00
CODE_STYLE.md init commit 2026-08-23 11:29:36 +00:00
compose.yaml init commit 2026-08-23 11:29:36 +00:00
deny.toml init commit 2026-08-23 11:29:36 +00:00
DEVELOPMENT.md init commit 2026-08-23 11:29:36 +00:00
flake.lock init commit 2026-08-23 11:29:36 +00:00
flake.nix init commit 2026-08-23 11:29:36 +00:00
justfile init commit 2026-08-23 11:29:36 +00:00
OPERATIONS.md fix: ratelimiting 2026-08-24 18:46:37 +00:00
PLAN.md fix(api): expose locked-quote settings endpoint 2026-08-24 10:28:00 +00:00
README.md init commit 2026-08-23 11:29:36 +00:00
rust-toolchain.toml init commit 2026-08-23 11:29:36 +00:00
rustfmt.toml init commit 2026-08-23 11:29:36 +00:00
SECURITY.md init commit 2026-08-23 11:29:36 +00:00

npubcash-rust

A Rust implementation of the npub.cash v2 protocol for the pinned cdk-npubcash client. Cashu operations are delegated to CDK and Nostr operations to the Rust Nostr crates.

The first-release implementation targets CDK v0.18.0-rc.0. The compatibility contract and implementation decisions are in docs/contract/v2.md and docs/adr/0001-upstream-pins-and-operating-policy.md.

Development

nix develop
just quick-check

PostgreSQL is the sole application database. Start a local server, create a database, and export DATABASE_URL before running integration tests.

The flake provides an explicit runnable app:

nix run .# -- --version

Running the service requires PostgreSQL, applied migrations, runtime secrets, a NUT-04/NUT-20-compatible mint, and at least one reachable Nostr relay. See docs/nixos-module.md for the recommended NixOS deployment, including automatic PostgreSQL provisioning and migrations.

See DEVELOPMENT.md for contributor workflows and OPERATIONS.md for configuration, secrets, backup, monitoring, upgrades, and rollback.