Add NIP-17 - Event Metadata

This commit is contained in:
arthurfranca 2023-06-13 19:12:31 -03:00
parent 3331b5610c
commit b9f157d325

43
17.md Normal file
View File

@ -0,0 +1,43 @@
NIP-17
======
Event Metadata
---------------
`draft` `optional` `author:arthurfranca`
Relays may attach event metadata to requested events.
## Motivation
To save relay bandwidth while helping clients show event metadata estimates faster.
## Fields
All fields are optional and live inside an extra nip17 key.
Some fields only make sense for a subset of kinds.
New fields may be added to this NIP later.
### Returned Event Example
```js
{
"kind": ..., // 1, 23, 0, ...
..., // regular keys
"nip17": {
"+": 8, // kind 7 "+" reaction count
"-": 0, // kind 7 "-" reaction count
"🤙️": 10, // kind 7 specific emoji reaction count
"followers": 500, // sent with kind 0
"language": "en", // ISO 639-1 code of detected event.content language
"relay": "wss://relay.url", // event found originally on this relay
"replies": 10, // direct descendant kind 1 reply count
"reposts": 20, // NIP-18 repost count
"views": 900, // request count from different IPs, device ids or pubkeys
"zaps": 7, // kind 9735 count
"zap_amount": 10000, // kind 9735 millisats amount sum
}
}
```