laantungir
/
nips
mirror of https://github.com/nostr-protocol/nips.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Use Minor Currency Unit

This commit is contained in:
Oscar Merry 2025-05-15 14:46:49 +01:00
parent 9d0b5fc317
commit a9875f17a3
1 changed files with 19 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
XX.md
View File

@ -14,15 +14,18 @@ Many applications that use nostr as their social layer have payments as a core p
It is still valuable to represent these payments on nostr so they can be shared, rendered, and indexed across different clients.
To avoid fake payments - the payment events are signed by a semi-trusted provider which in most cases will be the app that the user is posting from.
## Generic Payment Events - Kind `30090`
The events are parameterized replaceable events so that if the `payer` or `payee` joins nostr after the payment was made the payment events can be updated and assigned to their pubkey.
Generic payment events are kind `30090` parameterized replaceable events signed by a semi-trusted provider which could be either:
## Kind `30090`
- the app / service the user is sending the payment from
- the receiving users wallet pubkey (similar to zap receipts)
The events are parameterized replaceable so that if the `payer` or `payee` joins nostr after the payment was made, the payment events can be updated and assigned to their pubkey.
- `["d", "<unique_id>"]`
- `["currency", "BTC"]` - the ISO 4217 (https://en.wikipedia.org/wiki/ISO_4217) currency code of the payment with `BTC` used for bitcoin
- `["amount", "0.001"]` - the payment amount formatted as a string
- `["amount", "100000"]` - the payment amount in the currency's minor unit (usd cents, btc millisatoshis) formatted as a string
- `["payer", "<optional_pubkey>", "<optional_relay_hint>", "<optional_name>"]` - the entity paying
- `["payee", "<optional_pubkey>", "<optional_relay_hint>", "<optional_name>"]` - the entity being paid
- `["metadata": "{}"]` - optional generic metadata
@ -32,7 +35,7 @@ The events are parameterized replaceable events so that if the `payer` or `payee
### Examples:
_An anonymous donation to the human rights foundation with an on-chain bitcoin payment:_
_An anonymous donation to the human rights foundation with an 100,000 satoshi on-chain bitcoin payment:_
```jsonc
{
@ -40,9 +43,9 @@ _An anonymous donation to the human rights foundation with an on-chain bitcoin p
"tags": [
["d", "867038d3-5648-4f64-ab9d-0a1f38f00b67"],
["currency", "BTC"],
["amount", "0.01"],
["payer", "<payer_pubkey>"],
["payee", "<payee_pubkey>"],
["amount", "100000000"],
["payer", "", "", "Anonymous"],
["payee", "f1989a96d75aa386b4c871543626cbb362c03248b220dc9ae53d7cefbcaaf2c1", "wss://purplepag.es", "HRF"],
["metadata": "{\"program\":\"Bitcoin Development Fund\"}"]
],
"content": "",
@ -50,22 +53,23 @@ _An anonymous donation to the human rights foundation with an on-chain bitcoin p
```
_An anonymous user donating to a gofundme page in dollars:_
_A user named Bob without a nostr profile donating $100 to a donation page in dollars:_
```jsonc
{
"kind": 30090,
"tags": [
["d", "64eb241d-d05b-42ba-988a-1e24666a7cab"],
["currency", "USD"],
["amount", "1000"],
["payee", "<payee_pubkey>"],
["currency", "USD"],
["amount", "10000"],
["payer", "", "", "Bob"],
["payee"],
],
"content": "",
}
```
_A Podcasting 2.0 payment:_
_A a podcast listener supporting the Joe Rogan Experience with a 10,000 satoshi donation:_
```jsonc
{
@ -73,8 +77,8 @@ _A Podcasting 2.0 payment:_
"tags": [
["d", "f8604a8f-1ad5-4e90-a2f5-3a5e63cd7330"],
["currency", "BTC"],
["amount", "0.001"],
["payer", "<payer_pubkey>"],
["amount", "10000000"],
["payer"],
["payee", "", "", "The Joe Rogan Experience"],
["i", "podcast:guid:123"],
["i", "podcast:item:guid:123"],