Skip to content

add method field to quote responses, closes #378 #387

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 2 commits into from
Jul 4, 2026
Merged

add method field to quote responses, closes #378 #387

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
450f38d
add method field to quote responses, closes #378
callebtc Jun 10, 2026
f364a04
Merge branch 'main' into add-method-field-to-quote-responses
robwoodgate Jul 3, 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
3 changes: 2 additions & 1 deletion 04.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,11 +52,12 @@ The mint `Bob` responds with a quote that includes some common fields for all me
"quote": <str>, // UUID v7
"request": <str>,
"unit": <str_enum[UNIT]>,
"method": <str>
// Additional method-specific fields will be included
}
```

Where `quote` is the quote ID string in UUID v7 format, `request` is the payment request for the quote, and `unit` corresponds to the value provided in the request.
Where `quote` is the quote ID string in UUID v7 format, `request` is the payment request for the quote, `unit` corresponds to the value provided in the request, and `method` is the payment method of the quote.

> [!CAUTION]
>
Expand Down
4 changes: 3 additions & 1 deletion 05.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,13 +58,14 @@ The mint `Bob` responds with a quote that includes some common fields for all me
"quote": <str>, // UUID v7
"amount": <int>,
"unit": <str_enum[UNIT]>,
"method": <str>,
"state": <str_enum[STATE]>,
"expiry": <int>
// Additional method-specific fields will be included
}
```

Where `quote` is the quote ID string in UUID v7 format with all 74 variable bits generated by a CSPRNG, `amount` and `unit` the amount and unit that need to be provided, and `expiry` is the Unix timestamp until which the melt quote is valid.
Where `quote` is the quote ID string in UUID v7 format with all 74 variable bits generated by a CSPRNG, `amount` and `unit` the amount and unit that need to be provided, `method` is the payment method of the quote, and `expiry` is the Unix timestamp until which the melt quote is valid.

`state` is an enum string field with possible values `"UNPAID"`, `"PENDING"`, `"PAID"`:

Expand Down Expand Up @@ -177,6 +178,7 @@ Content-Type: application/json
"quote": "019e6d5a-2347-7000-89e2-35fe79f92c0e",
"amount": 10,
"unit": "sat",
"method": "bolt11",
"state": "PENDING",
"expiry": 1701704757
}
Expand Down
6 changes: 6 additions & 0 deletions 23.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ The mint responds with a `PostMintQuoteBolt11Response`:
"request": <str>, // The bolt11 invoice to pay
"amount": <int>,
"unit": <str_enum[UNIT]>,
"method": "bolt11",
"state": <str_enum[STATE]>,
"expiry": <int|null>
}
Expand Down Expand Up @@ -57,6 +58,7 @@ Response:
"request": "lnbc100n1pj4apw9...",
"amount": 10,
"unit": "sat",
"method": "bolt11",
"state": "UNPAID",
"expiry": 1701704757
}
Expand Down Expand Up @@ -152,6 +154,7 @@ The mint responds with a `PostMeltQuoteBolt11Response`:
"request": <str>,
"amount": <int>,
"unit": <str_enum[UNIT]>,
"method": "bolt11",
"fee_reserve": <int>,
"state": <str_enum[STATE]>,
"expiry": <int>,
Expand Down Expand Up @@ -181,6 +184,7 @@ If the `outputs` field is included and there is excess from the `fee_reserve`, t
"request": <str>,
"amount": <int>,
"unit": <str_enum[UNIT]>,
"method": "bolt11",
"fee_reserve": <int>,
"state": <str_enum[STATE]>,
"expiry": <int>,
Expand All @@ -206,6 +210,7 @@ Melt quote response:
"request": "lnbc100n1p3kdrv5sp5lpdxzghe5j67q...",
"amount": 10,
"unit": "sat",
"method": "bolt11",
"fee_reserve": 2,
"state": "UNPAID",
"expiry": 1701704757
Expand Down Expand Up @@ -233,6 +238,7 @@ Successful melt response:
"request": "lnbc100n1p3kdrv5sp5lpdxzghe5j67q...",
"amount": 10,
"unit": "sat",
"method": "bolt11",
"fee_reserve": 2,
"state": "PAID",
"expiry": 1701704757,
Expand Down
6 changes: 6 additions & 0 deletions 25.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,7 @@ The mint responds with a `PostMintQuoteBolt12Response`:
"request": <str>,
"amount": <int|null>,
"unit": <str_enum[UNIT]>,
"method": "bolt12",
"expiry": <int|null>,
"pubkey": <str>,
"amount_paid": <int>,
Expand Down Expand Up @@ -66,6 +67,7 @@ curl -X POST http://localhost:3338/v1/mint/quote/bolt12 -d \
"request": "lno1qcp...",
"amount": 10,
"unit": "sat",
"method": "bolt12",
"expiry": 1701704757,
"pubkey": "03d56ce4e446a85bbdaa547b4ec2b073d40ff802831352b8272b7dd7a4de5a7cac",
"amount_paid": 0,
Expand Down Expand Up @@ -167,6 +169,7 @@ The mint responds with a `PostMeltQuoteBolt12Response`:
"request": <str>,
"amount": <int>,
"unit": <str_enum[UNIT]>,
"method": "bolt12",
"fee_reserve": <int>,
"state": <str_enum[STATE]>,
"expiry": <int>,
Expand Down Expand Up @@ -202,6 +205,7 @@ If the `outputs` field is included and there is excess from the `fee_reserve`, t
"request": <str>,
"amount": <int>,
"unit": <str_enum[UNIT]>,
"method": "bolt12",
"fee_reserve": <int>,
"state": <str_enum[STATE]>,
"expiry": <int>,
Expand All @@ -227,6 +231,7 @@ curl -X POST https://mint.host:3338/v1/melt/quote/bolt12 -d \
"request": "lno1qcp4256ypqpq86q69t5wv5629arxqurn8cxg9p5qmmqy2e5xq...",
"amount": 10,
"unit": "sat",
"method": "bolt12",
"fee_reserve": 2,
"state": "UNPAID",
"expiry": 1701704757
Expand Down Expand Up @@ -254,6 +259,7 @@ curl -X POST https://mint.host:3338/v1/melt/bolt12 -d \
"request": "lno1qcp4256ypqpq86q69t5wv5629arxqurn8cxg9p5qmmqy2e5xq...",
"amount": 10,
"unit": "sat",
"method": "bolt12",
"fee_reserve": 2,
"state": "PAID",
"expiry": 1701704757,
Expand Down
4 changes: 4 additions & 0 deletions 30.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ The mint responds with a `PostMintQuoteOnchainResponse`:
"quote": <str>,
"request": <str>,
"unit": <str_enum[UNIT]>,
"method": "onchain",
"expiry": <int|null>,
"pubkey": <str>,
"amount_paid": <int>,
Expand Down Expand Up @@ -63,6 +64,7 @@ curl -X POST http://localhost:3338/v1/mint/quote/onchain -d \
"quote": "019e6d5a-2347-7000-8850-39c85ed1b5d3",
"request": "bc1q...",
"unit": "sat",
"method": "onchain",
"expiry": 1701704757,
"pubkey": "03d56ce4e446a85bbdaa547b4ec2b073d40ff802831352b8272b7dd7a4de5a7cac",
"amount_paid": 0,
Expand Down Expand Up @@ -188,6 +190,7 @@ The mint responds with a `PostMeltQuoteOnchainResponse`:
"quote": <str>,
"amount": <int>,
"unit": <str_enum[UNIT]>,
"method": "onchain",
"state": <str_enum[STATE]>,
"expiry": <int>,
"request": <str>,
Expand Down Expand Up @@ -239,6 +242,7 @@ If the `outputs` field is included and the mint does not claim the full `selecte
"quote": <str>,
"amount": <int>,
"unit": <str_enum[UNIT]>,
"method": "onchain",
"state": <str_enum[STATE]>,
"expiry": <int>,
"request": <str>,
Expand Down
Loading