Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

Repository files navigation

refueler-mint

A closed-loop, FCA-considered digital loyalty stamp mint — built on CDK (Cashu Development Kit) in Rust, with Orchard as the management GUI.

Live at: mint.refueler.io (internal / pre-launch)
Part of the Refueler ecosystem


What This Is

refueler-mint is the internal accounting engine powering Refueler's digital loyalty stamp system. It issues, validates, and destroys cryptographic blind-signature tokens (stamps) redeemable exclusively for goods and services at participating venues.

This is not an e-money system. Stamps have no monetary redemption path and cannot be exchanged for sats or fiat. They are closed-loop loyalty instruments — structurally equivalent to a coffee stamp card, backed by cryptographic blind signatures instead of ink.


Design Principles

No external mint. Ever.
All validation and issuance runs within our own infrastructure. No dependency on Minibits, Nutshell, or any third-party Cashu mint — not even for testing.

Closed-loop redemption only.
Stamps issued → accumulated → redeemed for goods/services at venue. No ecash-to-sats path unless UK FCA regulatory position changes.

Zero identity linkage.
The mint signs blinded messages. It cannot link a stamp serial number to the user who received it. The ledger records that a stamp was spent — not who spent it.

FCA-considered architecture.
Reverse-solicitation framing throughout. The customer initiates the reward claim; Refueler fulfils. Refueler does not hold, transmit, or custody funds at any point.


Stack

Layer Technology
Mint core CDK (Cashu Development Kit) — Rust
Storage cdk-redb (default) — pure Rust key-value store
GUI Orchard
Lightning backend Blink (BOLT11)
Integration Supabase (stamp lifecycle events) · Refueler App (consumer-facing wallet)

Cashu NUT Support

NUT Description Status
NUT-00 Blind signatures & double-spend prevention Core
NUT-01 Mint public key rotation Core
NUT-02 Keyset management Core
NUT-04 Minting via Lightning payment Core
NUT-07 Token melt (redemption at venue) Core
NUT-11 Programmable spending conditions Planned
NUT-17 WebSocket subscriptions Verify at build time

NUT-11 and NUT-17 support to be verified against CDK's current implementation before build session begins.


Stamp Lifecycle

Customer completes qualifying order
        ↓
Refueler App requests blinded stamp from mint
        ↓
Mint signs blinded message (never sees serial number)
        ↓
Customer accumulates stamps in Refueler App wallet
        ↓
Customer redeems stamps at venue for goods/services
        ↓
Mint records serial as spent — prevents double-redemption
        ↓
Token destroyed (NUT-07 melt)

Upstream Tracking

CDK and the wider cashubtc organisation move fast. This repo tracks:

Weekly Sync Routine

Every Monday: review the cashubtc project board for changes affecting keyset rotation or NUT-07/NUT-11 behaviour. Anything relevant gets logged in SESSIONS.md as a pending decision for the next build session. We are not chasing every commit — only changes that touch our two critical concerns: keyset management and stamp redemption logic.


Relationship to refueler-share

refueler-share uses Cashu blind signatures as an anonymous authentication primitive for file upload access — stripping all monetary semantics. refueler-mint is the actual Cashu mint for loyalty stamps. They share the same underlying cryptographic protocol but serve entirely different purposes and run as separate deployments.

The BLAKE3 integration story from refueler-share and refueler-multi-core does not apply here in the same way — CDK's internal storage crate (cdk-redb) is a potential BLAKE3 target for lookup performance, but this is a future optimisation, not a launch requirement.


Development Sessions Queue

Session Description Status
Session A Internal mint architecture — CDK setup, keyset rotation, Lightning channel strategy, key backup Queued
Session B Digital stamp lifecycle integration + FCA compliance review Queued

Both sessions must complete before any live mint deployment.


Ecosystem Position

              [ refueler.io ] (Master Brand & Funnel)
             /       |        \
            /        |         \
[multi-core]         |      [share.refueler.io]
(Bitcoin Indexer     |      (Encrypted P2P
 & Stream Engine)    |       file transfer)
                     |
              [mint.refueler.io]
              (This repo — Closed-loop
               digital loyalty stamp mint)

Status

🔴 Pre-build. Architecture locked. Repository initialised.
REFUELER_MINT_URL placeholder: REFUELER_INTERNAL_MINT_URL_PENDING — do not populate until internal mint is live.

Active development begins after Session A completes.


Licence

MIT — open infrastructure.
This mint operates in closed-loop mode only. It is not a general-purpose Cashu mint and does not interact with external wallets or mints.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors