Cashu NUTs (Notation, Usage, and Terminology)

These documents each specify parts of the Cashu protocol. Read the specifications for the legacy API here.

Specifications

Wallets and mints MUST implement all mandatory specs and CAN implement optional specs.

Mandatory

NUT #	Description
00	Cryptography and Models
01	Mint public keys
02	Keysets and fees
03	Swapping tokens
04	Minting tokens
05	Melting tokens
06	Mint info

Optional

#	Description	Wallets	Mints
07	Token state check	Nutshell, Nutstash, cashu-ts, cdk-cli, Minibits, macadamia	Nutshell, cdk-mintd, nutmix
08	Overpaid Lightning fees	Nutshell, Nutstash, cashu-ts, cdk-cli, Minibits, macadamia	Nutshell, cdk-mintd, nutmix
09	Signature restore	Nutshell, cdk-cli, Cashu.me, Minibits, macadamia	Nutshell, cdk-mintd
10	Spending conditions	Nutshell, cdk-cli, cashu-ts, Minibits	Nutshell, cdk-mintd, nutmix
11	Pay-To-Pubkey (P2PK)	Nutshell, cdk-cli, Cashu.me, Minibits	Nutshell, cdk-mintd, nutmix
12	DLEQ proofs	Nutshell, cdk-cli, cashu-ts	Nutshell, cdk-mintd, nutmix
13	Deterministic secrets	Nutshell, cashu-ts, cdk-cli, macadamia, Minibits	-
14	Hashed Timelock Contracts (HTLCs)	Nutshell, cdk-cli	Nutshell, cdk-mintd, nutmix
15	Partial multi-path payments (MPP)	Nutshell, cdk-cli	Nutshell, cdk-mintd, nutmix
16	Animated QR codes	Cashu.me, macadamia, Minibits	-
17	WebSocket subscriptions	Nutshell, cdk-cli, Cashu.me, Minibits	Nutshell, cdk-mintd, nutmix
18	Payment requests	Cashu.me, Boardwalk, cdk-cli, Minibits	-
19	Cached Responses	-	Nutshell, cdk-mintd
20	Signature on Mint Quote	cdk-cli, Nutshell	cdk-mintd, Nutshell
21	Clear authentication	Nutshell, cdk-cli	Nutshell, cdk-mintd, nutmix
22	Blind authentication	Nutshell, cdk-cli	Nutshell, cdk-mintd, nutmix
23	Payment Method: BOLT11	Nutshell, cdk-cli	Nutshell, cdk-mintd, nutmix
24	HTTP 402 Payment Required	-	-
25	Payment Method: BOLT12	cdk-cli, cashu-ts	cdk-mintd

Wallets:

• Nutshell
• CDK-cli
• cashu-ts
• Macadamia
• Minibits
• Nutstash
• Cashu.me
• Boardwalk

Mints:

• Nutshell
• cdk-mintd
• Nutmix