From b9f157d325277736bbecbd52af6738f85d846a97 Mon Sep 17 00:00:00 2001
From: arthurfranca <arthur.a.franca@gmail.com>
Date: Tue, 13 Jun 2023 19:12:31 -0300
Subject: [PATCH] Add NIP-17 - Event Metadata

---
 17.md | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 17.md

diff --git a/17.md b/17.md
new file mode 100644
index 00000000..4db4ecad
--- /dev/null
+++ b/17.md
@@ -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
+  }
+}
+```