Skip to content

feat: add NUT-29 batch minting error codes #366

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

Merged
thesimplekid merged 1 commit into from
May 13, 2026
Merged

feat: add NUT-29 batch minting error codes #366

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
4 changes: 2 additions & 2 deletions 29.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -180,7 +180,7 @@ Content-Type: application/json
The mint MUST validate the following before processing a batch mint request:

1. **Non-empty batch**: The `quotes` array MUST NOT be empty
2. **Unique quotes**: All quote IDs in the `quotes` array MUST be unique (no duplicates)
2. **Unique quotes**: All quote IDs in the `quotes` array MUST be unique (no duplicates) — error code `11016`
3. **Valid quote IDs**: All quote IDs MUST exist in the mint's database
4. **Payment method consistency**: All quotes MUST have the same payment method, matching `{method}` in the URL path
5. **Currency unit consistency**: All quotes MUST use the same currency unit
Expand Down Expand Up @@ -268,7 +268,7 @@ Mints MAY advertise a maximum batch size through the [NUT-06][06] mint info endp

Fields:

- `max_batch_size` (optional): Maximum number of quotes allowed in a single batch request. If omitted, the batch size limit is implementation-defined and clients MUST handle `BATCH_SIZE_EXCEEDED` errors gracefully.
- `max_batch_size` (optional): Maximum number of quotes allowed in a single batch request. If omitted, the batch size limit is implementation-defined and clients MUST handle error code `11017` gracefully.
- `methods` (optional): Array of payment methods supported for batch minting. If omitted, all methods supported by the mint (per NUT-04) are available for batching.

[00]: 00.md
Expand Down
2 changes: 2 additions & 0 deletions error_codes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,8 @@
| 11013 | Unit in request is not supported | [NUT-04][04], [NUT-05][05] |
| 11014 | Max inputs exceeded | [NUT-03][03], [NUT-05][05] |
| 11015 | Max outputs exceeded | [NUT-03][03], [NUT-04][04], [NUT-05][05] |
| 11016 | Duplicate quote IDs provided | [NUT-29][29] |
| 11017 | Max batch size exceeded | [NUT-29][29] |
| 12001 | Keyset is not known | [NUT-02][02], [NUT-04][04] |
| 12002 | Keyset is inactive, cannot sign messages | [NUT-02][02], [NUT-03][03], [NUT-04][04] |
| 20001 | Quote request is not paid | [NUT-04][04] |
Expand Down
2 changes: 1 addition & 1 deletion tests/29-tests.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@ The following is an invalid batch mint request with duplicate quote IDs.

Expected behavior:

- The mint rejects the request because quote IDs must be unique.
- The mint rejects the request because quote IDs must be unique (error code `11016`).
- No outputs are signed.

## Batch mint rejects mixed payment methods
Expand Down
Loading