Kind 7374: Cashu Quote

Overview

A Cashu Quote event (Kind 7374) is used to store the state of a mint quote ID, which is used to check when a payment has been completed. This is an optional event that helps applications track the status of Lightning Network quotes for Cashu mints. These events are typically temporary and include an expiration tag.

Specification

Property	Value
Kind Number	7374
Event Range	Regular
Defined in	NIP-60

Content Format

The content field contains a NIP-44 encrypted quote ID from a Cashu mint.

Schema

{
  "content": "<nip44-encrypted-quote-id>"
}

Tags

Tag Name	Description	Format	Required
expiration	Timestamp when the quote expires	["expiration", "<unix-timestamp>"]	Yes
mint	URL of the mint that issued the quote	["mint", "<mint-url>"]	Yes

Client Behavior

Clients should:

1. Create this event only when tracking a quote from a mint across different devices or applications is necessary
2. Prefer using local state when possible, to avoid unnecessary event creation
3. Include an expiration tag with a timestamp about 2 weeks in the future (maximum Lightning payment in-flight time)
4. Encrypt the quote ID using NIP-44
5. Include the mint URL in a mint tag
6. Check for the completion of the quote by querying the mint directly

Relay Behavior

Relays should handle this event like any other regular event, but may choose to automatically delete expired events based on the expiration tag.

Use Cases

• Tracking the status of pending Lightning Network payments across devices
• Enabling payment state consistency between different Nostr clients
• Supporting interoperable payment workflows in Cashu-enabled applications

Example

{
  "id": "7a1deced3a42dcf551486650cc752ab354347dd413b307484e4fd1818ab53f991",
  "pubkey": "79dff8f82963424e0bb02708a22e44b4980893e3a4be0fa3cb60a43b946764e3",
  "created_at": 1684328102,
  "kind": 7374,
  "content": "8cI2MgJ2nSgpYsFNjmXQ3Wvg2+NYW7tjNVE75TYV8RM4OZvLUHf4kx+NS=?iv=yjCT0gzTuYbOTFM3EbqxaA==",
  "tags": [
    ["expiration", "1685537902"],
    ["mint", "https://stablenut.umint.cash"]
  ],
  "sig": "908a15e46fb4d8675bab026fc230a0e3542bfade63da02d542fb78b2a8513fcd0092619a2c8c1221e581946e0191f2af505dfdf8657a414dbca329186f009262"
}

When decrypted, the content would reveal a quote ID string like:

"qs-afcd1234-9876-fe45-0987-abcdef012345"

References

• NIP-60: Cashu Wallets
• NIP-44: Encrypted Direct Messages
• NIP-40: Expiration Timestamp

Related Kinds

• Kind 17375: Cashu Wallet - Stores wallet configuration
• Kind 7375: Cashu Token - Stores unspent Cashu proofs
• Kind 7376: Nutzap Redemption - Records spending history

Notes

• This event is considered optional according to NIP-60
• Application developers should prefer using local state when possible
• The expiration tag is important since Lightning Network payments have a limited time in-flight
• This event primarily serves to synchronize payment state across multiple devices or applications