2.0 KiB
NIP-51
Lists
draft optional author:fiatjaf author:arcbtc author:monlovesmango author:eskema author:gzuuus
This NIP defines lists of things that users can create. Lists can contain references to anything, and these references can be public or private.
Public items in a list are specified in the event tags array, while private items are specified in a JSON array that mimics the structure of the event tags array, but stringified and encrypted using the same scheme from NIP-04 (the shared key is computed using the author's public and private key) and stored in the .content.
Generic lists
The kinds 30000 and 30001 have been reserved for generic lists. These must be accompanied by a d tag identifying the list, but these are generally client-specific, except in the standard cases specified below.
Standard lists
| name | kind | "d" tag | description | expected tag items |
|---|---|---|---|---|
| Muted list | 30000 | "mute" |
things the user doesn't want to see in their feeds | "p" (pubkeys), "t" (hashtags) |
| Bookmarks list | 30001 | "bookmark" |
things the user intends to save for the future | "e" (kind:1 notes), "a" (kind:30023 articles) |
| Pin list | 30001 | "pin" |
events the user intends to showcase in their profile page | "e" (kind:1 notes) |
| Relay sets | 30002 | (user-defined) | user-defined relay groups the user can easily pick and choose from during variadic operations | "relay" (relay URLs) |