diff --git a/16.md b/16.md index dba1b9c6..3f229018 100644 --- a/16.md +++ b/16.md @@ -21,7 +21,7 @@ Upon an ephemeral event being received, the relay SHOULD send it to all clients Client Behavior --------------- -Clients SHOULD use the `supported_nips` field to learn if a relay supports generic tag queries. Clients SHOULD NOT send ephemeral events to relays that do not support this NIP; they will most likely be persisted. Clients MAY send replaceable events to relays that may not support this NIP, and clients querying SHOULD be prepared for the relay to send multiple events and should use the latest one. +Clients SHOULD use the `supported_nips` field to learn if a relay supports this NIP. Clients SHOULD NOT send ephemeral events to relays that do not support this NIP; they will most likely be persisted. Clients MAY send replaceable events to relays that may not support this NIP, and clients querying SHOULD be prepared for the relay to send multiple events and should use the latest one. Suggested Use Cases ------------------- diff --git a/25.md b/25.md new file mode 100644 index 00000000..b2942558 --- /dev/null +++ b/25.md @@ -0,0 +1,49 @@ + +NIP-25 +====== + +Reactions +--------- + +`draft` `optional` `author:jb55` + +A reaction is a `kind 7` note that is used to react to `kind 1` text notes. + +The generic reaction, represented by the `content` set to a `+` string, SHOULD +be interpreted as a "like" or "upvote". + +A reaction with `content` set to `-` SHOULD be interepreted as a "dislike" or +"downvote". It SHOULD NOT be counted as a "like", and MAY be displayed as a +downvote or dislike on a post. A client MAY also choose to tally likes against +dislikes in a reddit-like system of upvotes and downvotes, or display them as +separate tallys. + +The `content` MAY be an emoji, in this case it MAY be interpreted as a "like", +or the client MAY display this emoji reaction on the post. + +Tags +---- + +The reaction event SHOULD include `e` and `p` tags from the note the user is +reacting to. This allows users to be notified of reactions to posts they were +mentioned in. Including the `e` tags enables clients to pull all the reactions +associated with individual posts or all the posts in a thread. + +The last `e` tag MUST be the `id` of the note that is being reacted to. + +The last `p` tag MUST be the `pubkey` of the event being reacted to. + +Example code + +```swift +func make_like_event(pubkey: String, privkey: String, liked: NostrEvent) -> NostrEvent { + var tags: [[String]] = liked.tags.filter { + tag in tag.count >= 2 && (tag[0] == "e" || tag[0] == "p") + } + tags.append(["e", liked.id]) + tags.append(["p", liked.pubkey]) + let ev = NostrEvent(content: "", pubkey: pubkey, kind: 7, tags: tags) + ev.calculate_id() + ev.sign(privkey: privkey) + return ev +} diff --git a/README.md b/README.md index 446003ea..acf86894 100644 --- a/README.md +++ b/README.md @@ -18,6 +18,7 @@ NIPs stand for **Nostr Implementation Possibilities**. They exist to document wh - [NIP-14: Subject tag in text events.](14.md) - [NIP-15: End of Stored Events Notice](15.md) - [NIP-16: Event Treatment](16.md) +- [NIP-25: Reactions](25.md) ## Event Kinds @@ -29,6 +30,7 @@ NIPs stand for **Nostr Implementation Possibilities**. They exist to document wh | 3 | Contacts | 2 | | 4 | Encrypted Direct Messages | 4 | | 5 | Event Deletion | 9 | +| 7 | Reaction | 25 | Please update this list when proposing NIPs introducing new event kinds.