nostr Kind 7 Codex

Unofficial Registry of nostr kind 7 events

Status

Draft

This document is informational. The catalogue is non-normative.

Background

NIP-25 [1] defines event kind 7 as a reaction to a referenced note. The NIP suggests that clients SHOULD interpret + as like or upvote, and - as dislike or downvote.

With the proliferation of clients has come a little Wild West of kind 7 reaction texts, with no central catalogue of what is in use making it difficult for client (or relay) writers to confidently capture as many as possible.

Fortunately, what has emerged so far is logical, with for example a thumbs up emoji (👍) being emitted/interpreted like + and thumbs down emoji (👎) being emitted or interpreted like -.

Other clients, like nostr_console, use other kind 7 events as notes-to-self. For example, the ! is used to hide a post. It is expected that other kind 7 messages will emerge with additional semantic meanings.

One recent note suggests consideration of emojis like ⚠️ and 🔞 which convey (relatively) obvious meanings to human readers, and are just as short as a binary serialization of some message like "inappropriate", "flagged", "NSFW", etc.

By providing a centralized record of who-supports-what and which-encodes-something, the nostr ecosystem might be able to more quickly coalesce around standardized kind 7 signals.

Kind 7 event messages

seen in the wild or widely implemented

	Interpretation	Reference
+	Like	Defined in NIP-25
-	Dislike or Flag	Defined in NIP-25
!	Hide post	nostr_console
⚠️	Report post	amethyst
❤️	Like
🤙	Like
👍	Like
👎	Dislike

Client Support

Client	+	-	❤️	🤙	👍	⚠️	comments
Amethyst	✅		👀	👀	👀	✅	+ , 🤙 , 👍 are converted into ❤️
astral							no kind 7 reactions
Blockcore Notes	👀	👀			👀		Also recognizes 👎. Permits arbitrary emoji reaction. Tallies and displays several kind 7
Branle
Coracle	✅	✅	👀	👀	👀		also recognizes empty kind 7
Daisy	✅
Damus	👀	👀	👀	✅	👀	👀	Damus aggregates all reactions as "like". Originated the Shaka 🤙
futur							parsed but not emitted
Gossip	✅						also recognizes empty kind 7 as like
Iris	✅
Minds	?	?
more-speech							no kind 7 reactions
noscl							does not support KindReaction
nostr-java	✅	✅
Nostrid	✅						also recognizes empty kind 7 as like
snort.social	👀	👀	👀	👀	👀		also recognizes 💯 and empty kind 7 as like; also 👎 as dislike

✅ Emits 👀 Recognizes

Relay Support

TBD; filtering and interpretation is likely to be mostly client-side, but Relays will probably be informed by kind 7 reactions in the future.

References

1. Reactions, defined in NIP-25
2. Client list