Skip to content

feat: preferred mints #380

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
d4rp4t wants to merge 3 commits into from
Closed

feat: preferred mints #380

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
266cc47
feat: preferred mints
d4rp4t May 26, 2026
7ed9694
feat: add mint_strict to nut28
d4rp4t May 26, 2026
803cd16
fix: prettier
d4rp4t May 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions 18.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ A Payment Request is defined as follows
"u": str <optional>,
"s": bool <optional>,
"m": Array[str] <optional>,
"ms": bool <optional>,
"d": str <optional>,
"t": Array[Transport] <optional>,
"nut10": NUT10Option <optional>,
Expand All @@ -37,10 +38,15 @@ Here, the fields are
- `u`: The unit of the requested payment (MUST be set if `a` is set)
- `s`: Whether the payment request is for single use
- `m`: A set of mints from which the payment is requested
- `ms`: A flag indicating whether the mint list is strict; defaults to `true`
- `d`: A human readable description that the sending wallet will display after scanning the request
- `t`: The method of `Transport` chosen to transmit the payment (can be multiple, sorted by preference)
- `nut10`: The required [NUT-10][10] locking condition

## Mint list

A Payment Request containing a mint list `m` describes the mints it accepts payments from. If `ms` is not present, or is `true`, the recipient **MUST** reject payments from mints not in the list. If `ms` is set to `false`, the list is just a suggestion for the payer.

## Locking conditions

The payment request can include _optional_ locking conditions the payee requires from the payer. For example, the payee might require a P2PK-locked token so that they can receive payments offline.
Expand Down
21 changes: 11 additions & 10 deletions 26.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,16 +33,17 @@ The payment request is encoded as a sequence of TLV fields. Each TLV entry consi

### Top-Level TLV Tags

| Tag | Field | Type | Description |
| ---- | ----------- | --------- | -------------------------------------------------------------------- |
| 0x01 | id | string | Payment identifier (corresponds to `i` in JSON) |
| 0x02 | amount | u64 | Amount in base units (corresponds to `a` in JSON) |
| 0x03 | unit | u8/string | Currency unit (corresponds to `u` in JSON) |
| 0x04 | single_use | u8 | Single-use flag: 0=false, 1=true (corresponds to `s` in JSON) |
| 0x05 | mint | string | Mint URL (repeatable for multiple mints, corresponds to `m` in JSON) |
| 0x06 | description | string | Human-readable description (corresponds to `d` in JSON) |
| 0x07 | transport | sub-TLV | Transport configuration (repeatable, corresponds to `t` in JSON) |
| 0x08 | nut10 | sub-TLV | NUT-10 spending conditions (corresponds to `nut10` in JSON) |
| Tag | Field | Type | Description |
| ---- | ----------- | --------- | ---------------------------------------------------------------------------------------------- |
| 0x01 | id | string | Payment identifier (corresponds to `i` in JSON) |
| 0x02 | amount | u64 | Amount in base units (corresponds to `a` in JSON) |
| 0x03 | unit | u8/string | Currency unit (corresponds to `u` in JSON) |
| 0x04 | single_use | u8 | Single-use flag: 0=false, 1=true (corresponds to `s` in JSON) |
| 0x05 | mint | string | Mint URL (repeatable for multiple mints, corresponds to `m` in JSON) |
| 0x06 | description | string | Human-readable description (corresponds to `d` in JSON) |
| 0x07 | transport | sub-TLV | Transport configuration (repeatable, corresponds to `t` in JSON) |
| 0x08 | nut10 | sub-TLV | NUT-10 spending conditions (corresponds to `nut10` in JSON) |
| 0x09 | mint_strict | u8 | Mint list strict flag: 0=false, 1=true; if absent, defaults to 1 (corresponds to `ms` in JSON) |

All fields are optional. Unknown tags MUST be ignored to maintain forward compatibility.

Expand Down
Loading