Payment request consolidation (and extra fees for non-preferred mints)#381
Open
robwoodgate wants to merge 13 commits into
Open
Payment request consolidation (and extra fees for non-preferred mints)#381robwoodgate wants to merge 13 commits into
robwoodgate wants to merge 13 commits into
Conversation
Co-authored-by: Rob Woodgate <robwoodgate@users.noreply.github.com>
This was referenced May 27, 2026
Closed
This was referenced May 28, 2026
robwoodgate
added a commit
to d4rp4t/cashu-ts
that referenced
this pull request
May 28, 2026
Spec moved from cashubtc/nuts#380 to cashubtc/nuts#381, adding fee_reserve (fr) and supported_methods (sm) alongside the existing mint-strict flag. Adds an isMintListStrict resolver for the spec default-to-true semantic.
a1denvalu3
approved these changes
May 31, 2026
4 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Consolidates and Supersedes: #355, #380
Summary
Consolidates the two open NUT-18 payment request proposals around mint preferences, strict mint lists, fee reserve signalling, and required mint payment methods.
This PR keeps the existing
mmint list as the single mint-list field, and adds small companion fields to clarify how that list should be interpreted.Changes
ms(mint_strict) to signal whether themmint list is strict or preferred from feat: preferred mints #380:true: receiver only accepts proofs from listed mintsfalse: listed mints are preferred, but other mints may be acceptedsm(supported_methods) to require that the mint used by the payer supports at least one listed payment method, e.g.bolt11,bolt12,onchainfrom feat(nut-18, nut-26): add preferred_mints to payment requests #355fr(fee_reserve) to signal an additional amount the payer MUST include when paying from a non-preferred mint, to cover potential swap/melt feesRationale
There were overlapping proposals for preferred mints and strict mint lists. Instead of introducing a separate preferred mint list, this keeps the request format minimal:
mremains the mint listmsdefines whether that list is strict or advisoryfrgives wallets a way to compensate for extra fees when ignoring the preferencesmlets receivers express the mint capabilities required for the payment flowThis avoids two competing mint-list fields while covering the three desired behaviours.