Nip88: Adding dtag, typos

- A kind 37001 dtag is referenced in the 7003 description, but was missing in the example -A etag is referenced in the kind 7001 description but an a tag was referenced in the example
payment verification, relay where content can be found, perks, actor definitions
2025-12-09 00:28:51 +00:00 · 2024-03-13 11:27:11 -03:00 · 2024-02-11 17:05:39 +00:00 · 2024-01-06 00:54:31 +00:00 · 2023-11-23 17:52:48 +02:00 · 2023-11-23 15:47:22 +00:00
4 changed files with 333 additions and 179 deletions
--- a/11.md
+++ b/11.md
@@ -79,6 +79,7 @@ are rejected or fail immediately.
    "min_pow_difficulty": 30,
    "auth_required": true,
    "payment_required": true,
+    "restricted_writes": true,
    "created_at_lower_limit": 31536000,
    "created_at_upper_limit": 3
  },
@@ -124,6 +125,12 @@ Even if set to False, authentication may be required for specific actions.

 - `payment_required`: this relay requires payment before a new connection may perform any action.

+- `restricted_writes`: this relay requires some kind of condition to be fulfilled in order to
+accept events (not necessarily, but including `payment_required` and `min_pow_difficulty`).
+This should only be set to `true` when users are expected to know the relay policy before trying
+to write to it -- like belonging to a special pubkey-based whitelist or writing only events of
+a specific niche kind or content. Normal anti-spam heuristics, for example, do not qualify.
+
 - `created_at_lower_limit`: 'created_at' lower limit as defined in [NIP-22](22.md)

 - `created_at_upper_limit`: 'created_at' upper limit as defined in [NIP-22](22.md)
--- a/51.md
+++ b/51.md
@@ -6,148 +6,107 @@ Lists

 `draft` `optional`

-A "list" event is defined as having a list of public and/or private tags. Public tags will be listed in the event `tags`. Private tags will be encrypted in the event `content`. Encryption for private tags will use [NIP-04 - Encrypted Direct Message](04.md) encryption, using the list author's private and public key for the shared secret. A distinct event kind should be used for each list type created.
+This NIP defines lists of things that users can create. Lists can contain references to anything, and these references can be **public** or **private**.

-If a list should only be defined once per user (like the "mute" list) the list is declared as a _replaceable event_. These lists may be referred to as "replaceable lists". Otherwise, the list is a _parameterized replaceable event_ and the list name will be used as the `d` tag. These lists may be referred to as "parameterized replaceable lists".
+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](04.md) (the shared key is computed using the author's public and private key) and stored in the `.content`.

-## Replaceable List Event Example
+## Types of lists

-Lets say a user wants to create a 'Mute' list and has keys:
-```
-priv: fb505c65d4df950f5d28c9e4d285ee12ffaf315deef1fc24e3c7cd1e7e35f2b1
-pub: b1a5c93edcc8d586566fde53a20bdb50049a97b15483cb763854e57016e0fa3d
-```
-The user wants to publicly include these users:
+## Standard lists

-```json
-["p", "3bf0c63fcb93463407af97a5e5ee64fa883d107ef9e558472c4eb9aaaefa459d"],
-["p", "32e1827635450ebb3c5a7d12c1f8e7b2b514439ac10a67eef3d9fd9c5c68e245"]
-```
-and privately include these users (below is the JSON that would be encrypted and placed in the event content):
+Standard lists use non-parameterized replaceable events, meaning users may only have a single list of each kind. They have special meaning and clients may rely on them to augment a user's profile or browsing experience.

-```json
-[
-    ["p", "9ec7a778167afb1d30c4833de9322da0c08ba71a69e1911d5578d3144bb56437"],
-    ["p", "8c0da4862130283ff9e67d889df264177a508974e2feb96de139804ea66d6168"]
-]
-```
+For example, _mute lists_ can contain the public keys of spammers and bad actors users don't want to see in their feeds or receive annoying notifications from.

-Then the user would create a 'Mute' list event like below:
+| name           | kind  | description                                                 | expected tag items                                                                |
+| ---            | ---   | ---                                                         | ---                                                                               |
+| Mute list      | 10000 | things the user doesn't want to see in their feeds          | `"p"` (pubkeys), `"t"` (hashtags), `"word"` (lowercase string), `"e"` (threads)   |
+| Pinned notes   | 10001 | events the user intends to showcase in their profile page   | `"e"` (kind:1 notes)                                                              |
+| Bookmarks      | 10003 | uncategorized, "global" list of things a user wants to save | `"e"` (kind:1 notes), `"a"` (kind:30023 articles), `"t"` (hashtags), `"r" (URLs)` |
+| Communities    | 10004 | [NIP-72](72.md) communities the user belongs to             | `"a"` (kind:34550 community definitions)                                          |
+| Public chats   | 10005 | [NIP-28](28.md) chat channels the user is in                | `"e"` (kind:40 channel definitions)                                             |
+| Blocked relays | 10006 | relays clients should never connect to                      | `"relay"` (relay URLs)                                                            |
+| Search relays  | 10007 | relays clients should use when performing search queries    | `"relay"` (relay URLs)                                                            |
+| Interests      | 10015 | topics a user may be interested in and pointers             | `"t"` (hashtags) and `"a" (kind:30015 interest set)`                              |
+| Emojis         | 10030 | user preferred emojis and pointers to emoji sets            | `"emoji"` (see [NIP-30](30.md)) and `"a"` (kind:30030 emoji set)                  |
+
+## Sets
+
+Sets are lists with well-defined meaning that can enhance the functionality and the UI of clients that rely on them. Unlike standard lists, users are expected to have more than one set of each kind, therefore each of them must be assigned a different `"d"` identifier.
+
+For example, _relay sets_ can be displayed in a dropdown UI to give users the option to switch to which relays they will publish an event or from which relays they will read the replies to an event; _curation sets_ can be used by apps to showcase curations made by others tagged to different topics.
+
+Aside from their main identifier, the `"d"` tag, sets can optionally have a `"title"`, an `"image"` and a `"description"` tags that can be used to enhance their UI.
+
+| name          | kind  | description                                                                                  | expected tag items                                                                |
+| ---           | ---   | ---                                                                                          | ---                                                                               |
+| Follow sets   | 30000 | categorized groups of users a client may choose to check out in different circumstances      | `"p"` (pubkeys)                                                                   |
+| Relay sets    | 30002 | user-defined relay groups the user can easily pick and choose from during various operations | `"relay"` (relay URLs)                                                            |
+| Bookmark sets | 30003 | user-defined bookmarks categories , for when bookmarks must be in labeled separate groups    | `"e"` (kind:1 notes), `"a"` (kind:30023 articles), `"t"` (hashtags), `"r" (URLs)` |
+| Curation sets | 30004 | groups of articles picked by users as interesting and/or belonging to the same category      | `"a"` (kind:30023 articles), `"e"` (kind:1 notes)                                 |
+| Interest sets | 30015 | interest topics represented by a bunch of "hashtags"                                         | `"t"` (hashtags)                                                                  |
+| Emoji sets    | 30030 | categorized emoji groups                                                                     | `"emoji"` (see [NIP-30](30.md))                                                   |
+
+## Deprecated standard lists
+
+Some clients have used these lists in the past, but they should work on transitioning to the [standard formats](#standard-lists) above.
+
+| kind  | "d" tag         | use instead                   |
+| ---   | ---             | ---                           |
+| 30000 | `"mute"`        | kind 10000 _mute list_        |
+| 30001 | `"pin"`         | kind 10001 _pin list_         |
+| 30001 | `"bookmark"`    | kind 10003 _bookmarks list_   |
+| 30001 | `"communities"` | kind 10004 _communities list_ |
+
+## Examples
+
+### A _mute list_ with some public items and some encrypted items

 ```json
 {
+  "id": "a92a316b75e44cfdc19986c634049158d4206fcc0b7b9c7ccbcdabe28beebcd0",
+  "pubkey": "854043ae8f1f97430ca8c1f1a090bdde6488bd5115c7a45307a2a212750ae4cb",
+  "created_at": 1699597889,
  "kind": 10000,
  "tags": [
-    ["p", "3bf0c63fcb93463407af97a5e5ee64fa883d107ef9e558472c4eb9aaaefa459d"],
-    ["p", "32e1827635450ebb3c5a7d12c1f8e7b2b514439ac10a67eef3d9fd9c5c68e245"],
+    ["p", "07caba282f76441955b695551c3c5c742e5b9202a3784780f8086fdcdc1da3a9"],
+    ["p", "a55c15f5e41d5aebd236eca5e0142789c5385703f1a7485aa4b38d94fd18dcc4"]
  ],
-  "content": "VezuSvWak++ASjFMRqBPWS3mK5pZ0vRLL325iuIL4S+r8n9z+DuMau5vMElz1tGC/UqCDmbzE2kwplafaFo/FnIZMdEj4pdxgptyBV1ifZpH3TEF6OMjEtqbYRRqnxgIXsuOSXaerWgpi0pm+raHQPseoELQI/SZ1cvtFqEUCXdXpa5AYaSd+quEuthAEw7V1jP+5TDRCEC8jiLosBVhCtaPpLcrm8HydMYJ2XB6Ixs=?iv=/rtV49RFm0XyFEwG62Eo9A==",
-  ...other fields
+  "content": "TJob1dQrf2ndsmdbeGU+05HT5GMnBSx3fx8QdDY/g3NvCa7klfzgaQCmRZuo1d3WQjHDOjzSY1+MgTK5WjewFFumCcOZniWtOMSga9tJk1ky00tLoUUzyLnb1v9x95h/iT/KpkICJyAwUZ+LoJBUzLrK52wNTMt8M5jSLvCkRx8C0BmEwA/00pjOp4eRndy19H4WUUehhjfV2/VV/k4hMAjJ7Bb5Hp9xdmzmCLX9+64+MyeIQQjQAHPj8dkSsRahP7KS3MgMpjaF8nL48Bg5suZMxJayXGVp3BLtgRZx5z5nOk9xyrYk+71e2tnP9IDvSMkiSe76BcMct+m7kGVrRcavDI4n62goNNh25IpghT+a1OjjkpXt9me5wmaL7fxffV1pchdm+A7KJKIUU3kLC7QbUifF22EucRA9xiEyxETusNludBXN24O3llTbOy4vYFsq35BeZl4v1Cse7n2htZicVkItMz3wjzj1q1I1VqbnorNXFgllkRZn4/YXfTG/RMnoK/bDogRapOV+XToZ+IvsN0BqwKSUDx+ydKpci6htDRF2WDRkU+VQMqwM0CoLzy2H6A2cqyMMMD9SLRRzBg==?iv=S3rFeFr1gsYqmQA7bNnNTQ==",
+  "sig": "1173822c53261f8cffe7efbf43ba4a97a9198b3e402c2a1df130f42a8985a2d0d3430f4de350db184141e45ca844ab4e5364ea80f11d720e36357e1853dba6ca"
 }
 ```

+### A _curation set_ of articles and notes about yaks

-## Parameterized Replaceable List Event Example
-
-Lets say a user wants to create a 'Categorized People' list of `nostr` people and has keys:
 ```
-priv: fb505c65d4df950f5d28c9e4d285ee12ffaf315deef1fc24e3c7cd1e7e35f2b1
-pub: b1a5c93edcc8d586566fde53a20bdb50049a97b15483cb763854e57016e0fa3d
-```
-The user wants to publicly include these users:
-
-```json
-["p", "3bf0c63fcb93463407af97a5e5ee64fa883d107ef9e558472c4eb9aaaefa459d"],
-["p", "32e1827635450ebb3c5a7d12c1f8e7b2b514439ac10a67eef3d9fd9c5c68e245"]
-```
-and privately include these users (below is the JSON that would be encrypted and placed in the event content):
-
-```json
-[
-    ["p", "9ec7a778167afb1d30c4833de9322da0c08ba71a69e1911d5578d3144bb56437"],
-    ["p", "8c0da4862130283ff9e67d889df264177a508974e2feb96de139804ea66d6168"]
-]
-```
-
-Then the user would create a 'Categorized People' list event like below:
-
-```json
 {
-  "kind": 30000,
+  "id": "567b41fc9060c758c4216fe5f8d3df7c57daad7ae757fa4606f0c39d4dd220ef",
+  "pubkey": "d6dc95542e18b8b7aec2f14610f55c335abebec76f3db9e58c254661d0593a0c",
+  "created_at": 1695327657,
+  "kind": 30004,
  "tags": [
-    ["d", "nostr"],
-    ["p", "3bf0c63fcb93463407af97a5e5ee64fa883d107ef9e558472c4eb9aaaefa459d"],
-    ["p", "32e1827635450ebb3c5a7d12c1f8e7b2b514439ac10a67eef3d9fd9c5c68e245"],
+    ["d", "jvdy9i4"],
+    ["name", "Yaks"],
+    ["picture", "https://cdn.britannica.com/40/188540-050-9AC748DE/Yak-Himalayas-Nepal.jpg"],
+    ["about", "The domestic yak, also known as the Tartary ox, grunting ox, or hairy cattle, is a species of long-haired domesticated cattle found throughout the Himalayan region of the Indian subcontinent, the Tibetan Plateau, Gilgit-Baltistan, Tajikistan and as far north as Mongolia and Siberia."],
+    ["a", "30023:26dc95542e18b8b7aec2f14610f55c335abebec76f3db9e58c254661d0593a0c:95ODQzw3ajNoZ8SyMDOzQ"],
+    ["a", "30023:54af95542e18b8b7aec2f14610f55c335abebec76f3db9e58c254661d0593a0c:1-MYP8dAhramH9J5gJWKx"],
+    ["a", "30023:f8fe95542e18b8b7aec2f14610f55c335abebec76f3db9e58c254661d0593a0c:D2Tbd38bGrFvU0bIbvSMt"],
+    ["e", "d78ba0d5dce22bfff9db0a9e996c9ef27e2c91051de0c4e1da340e0326b4941e"]
  ],
-  "content": "VezuSvWak++ASjFMRqBPWS3mK5pZ0vRLL325iuIL4S+r8n9z+DuMau5vMElz1tGC/UqCDmbzE2kwplafaFo/FnIZMdEj4pdxgptyBV1ifZpH3TEF6OMjEtqbYRRqnxgIXsuOSXaerWgpi0pm+raHQPseoELQI/SZ1cvtFqEUCXdXpa5AYaSd+quEuthAEw7V1jP+5TDRCEC8jiLosBVhCtaPpLcrm8HydMYJ2XB6Ixs=?iv=/rtV49RFm0XyFEwG62Eo9A==",
-  ...other fields
+  "content": "",
+  "sig": "a9a4e2192eede77e6c9d24ddfab95ba3ff7c03fbd07ad011fff245abea431fb4d3787c2d04aad001cb039cb8de91d83ce30e9a94f82ac3c5a2372aa1294a96bd"
 }
 ```

-Lets say a user wants to create a 'Categorized Bookmarks' list of `bookmarks` and has keys:
-```
-priv: fb505c65d4df950f5d28c9e4d285ee12ffaf315deef1fc24e3c7cd1e7e35f2b1
-pub: b1a5c93edcc8d586566fde53a20bdb50049a97b15483cb763854e57016e0fa3d
-```
-The user wants to publicly include these bookmarks:
+## Encryption process pseudocode

-```json
-["e", "5c83da77af1dec6d7289834998ad7aafbd9e2191396d75ec3cc27f5a77226f36", "wss://nostr.example.com"],
-["a", "30023:f7234bd4c1394dda46d09f35bd384dd30cc552ad5541990f98844fb06676e9ca:abcd", "wss://nostr.example.com"],
-["r", "https://github.com/nostr-protocol/nostr", "Nostr repository"],
-```
-and privately include these bookmarks (below is the JSON that would be encrypted and placed in the event content):
-
-```json
-[
-    ["r", "https://my-private.bookmark", "My private bookmark"],
-    ["a", "30001:f7234bd4c1394dda46d09f35bd384dd30cc552ad5541990f98844fb06676e9ca:abcd", "wss://nostr.example.com"],
+```scala
+val private_items = [
+  ["p", "07caba282f76441955b695551c3c5c742e5b9202a3784780f8086fdcdc1da3a9"],
+  ["a", "a55c15f5e41d5aebd236eca5e0142789c5385703f1a7485aa4b38d94fd18dcc4"],
 ]
+val base64blob = nip04.encrypt(json.encode_to_string(private_items))
+event.content = base64blob
 ```
-
-Then the user would create a 'Categorized Bookmarks' list event like below:
-
-```json
-{
-  "kind": 30001,
-  "tags": [
-    ["d", "bookmarks"],
-    ["e", "5c83da77af1dec6d7289834998ad7aafbd9e2191396d75ec3cc27f5a77226f36", "wss://nostr.example.com"],
-    ["a", "30023:f7234bd4c1394dda46d09f35bd384dd30cc552ad5541990f98844fb06676e9ca:abcd", "wss://nostr.example.com"],
-    ["r", "https://github.com/nostr-protocol/nostr", "Nostr repository"],
-  ],
-  "content": "y3AyaLJfnmYr9x9Od9o4aYrmL9+Ynmsim5y2ONrU0urOTq+V81CyAthQ2mUOWE9xwGgrizhY7ILdQwWhy6FK0sA33GHtC0egUJw1zIdknPe7BZjznD570yk/8RXYgGyDKdexME+RMYykrnYFxq1+y/h00kmJg4u+Gpn+ZjmVhNYxl9b+TiBOAXG9UxnK/H0AmUqDpcldn6+j1/AiStwYZhD1UZ3jzDIk2qcCDy7MlGnYhSP+kNmG+2b0T/D1L0Z7?iv=PGJJfPE84gacAh7T0e6duQ==",
-  ...other fields
-}
-```
-
-## List Event Kinds
-
-| kind   | list type               |
-| ------ | ----------------------- |
-| 10000  | Mute                    |
-| 10001  | Pin                     |
-| 30000  | Categorized People      |
-| 30001  | Categorized Bookmarks   |
-| 30002  | Categorized Relay Sets  |
-
-
-### Mute List
-
-An event with kind `10000` is defined as a replaceable list event for listing content a user wants to mute. Any standardized tag can be included in a Mute List.
-
-### Pin List
-
-An event with kind `10001` is defined as a replaceable list event for listing content a user wants to pin. Any standardized tag can be included in a Pin List.
-
-### Categorized People List
-
-An event with kind `30000` is defined as a parameterized replaceable list event for categorizing people. The 'd' parameter for this event holds the category name of the list. The tags included in these lists MUST follow the format of kind 3 events as defined in [NIP-02 - Contact List and Petnames](02.md).
-
-### Categorized Bookmarks List
-
-An event of kind `30001` is defined as a parameterized replaceable list event for categorizing bookmarks. The 'd' parameter for this event holds the category name of the list. The bookmark lists may contain metadata tags such as 'title', 'image', 'summary' as defined in [NIP-23 - Long-form Content](23.md). Any standardized tag can be included in a Categorized Bookmark List.
-
-### Categorized Relay Set
-
-An event of kind `30002` is defined as a parameterized replaceable list event for categorizing relays. The 'd' parameter for this event holds the category name of the list. The relays lists may contain metadata tags such as 'title', 'image', 'summary' as defined in [NIP-23 - Long-form Content](23.md). These sets can be used by clients in order to determine which relays to query in different scenarios.
--- a/88.md
+++ b/88.md
@@ -0,0 +1,171 @@
+NIP-88
+======
+
+Recurring Subscriptions
+-----------------------
+
+`draft` `optional`
+
+This NIP defines a way for a pubkey to create recurring subscription payments to another pubkey.
+
+Actors in this flow:
+* Recipient: A pubkey that receives recurring payments
+* Subscriber: A pubkey that sends recurring payments
+* Payment verifier: An optional pubkey recipients can designate to verify payments on their behalf
+
+# Kinds
+`kind:37001` - Tier Event -- Optionally published by recipients
+`kind:7001` - Subscribe Event -- Published by subscribers
+`kind:7002` - Unsubscribe Event -- Published by subscribers
+`kind:7003` - Subscription Payment Receipt -- Published by payment-verifier-pubkey
+
+## `kind:37001`: Tier Event
+A pubkey that wants to provide others the ability to subscribe to them can create "tiers". These tiers might provide certain benefits to the supporters who subscribe to these.
+
+```js
+{
+    "kind": 37001,
+    "content": "<description of the tier>",
+    "tags": [
+        [ "title", "..." ],
+        [ "image", "..." ],
+
+        // Perks
+        [ "perk", "<description>" ],
+        [ "perk", "<description>" ],
+
+        // Amount possibilities
+        [ "amount", "<amount-in-base-unit>", "currency", "<monthly>" ],
+        [ "amount", "<amount-in-base-unit>", "currency", "<quarterly>" ],
+
+        // Zap-splits
+        [ "zap", "<recipient-pubkey>", "relay-url", "19" ], // 95%
+        [ "zap", "", "relay-url", "1" ], // 5%
+
+        // Relay and payment-verification
+        [ "r", "wss://my-subscribers-only-relay.com" ],
+        [ "p", "<payment-verifier-pubkey>" ],
+
+        // A unique identifier
+        [ "d", "<random-id>" ],
+    ]
+}
+```
+
+`.content`: description of what subscribers can expect.
+Tag `title` is an optional title for the tier.
+Tag `image` is an optional image for the tier.
+Zero or more `perk` tags specify the benefits of the tier; these can be rendered as a list of benefits to the user in addition to the content.
+One or more `amount` tags specify the payment required for this tier and its cadence.
+    * The first argument should be the stringified amount in cents or msats, and the second argument the currency
+    * The third argument SHOULD be one of `daily`, `monthly`, `yearly`
+One or more `amount` tags MUST exist.
+Zero or more `zap` tags can exist as defined in NIP-57.
+
+A `zap` tag with no pubkey indicates that the client can include any pubkey in the `kind:7001` event (and in the resulting recurring zaps). This way, users can offer a "referral" fee to other clients.
+
+An `r` tag can be included to specify a relay where clients can find special content for this tier.
+
+Zero or more `p` tags can be included to specify a pubkey that is trusted by the tier creator to verify payments on their behalf.
+
+#### Examples
+* `[ "amount", "100", "usd", "daily" ]`, $1.00 a day.
+* `[ "amount", "1000000", "msats", "daily" ]`, 1000000 millisats a day.
+
+## Subscribe Event
+
+```js
+{
+    "kind": 7001,
+    "content": "<optional-message>",
+    "tags": [
+        [ "p", "<recipient-pubkey>" ],
+        [ "e", "<supporting-tier-event-id>" ],
+        [ "event", "<stringied-event-subscribed-to>" ],
+        [ "amount", "<amount-in-base-unit>", "<currency>", "<cadence>" ],
+
+        // Zap-splits
+        [ "zap", "<recipient-pubkey>", "19" ], // 95%
+        [ "zap", "fa984bd7dbb282f07e16e7ae87b26a2a7b9b90b7246a44771f0cf5ae58018f52", "1" ], // 5% to client developer where subscription was created
+    ]
+}
+```
+
+When a user wants to subscribe to support a user they create a `kind:7001` event.
+
+* `.content` is an optional message the supporter can write.
+* The `p` tag MUST tag the pubkey being supported.
+* The `e` tag is optional; it should point to a `kind:37001` support tier event. There MUST be exactly 0 or 1 `e` tag.
+* The `event` tag is optional; subscribers can opt to keep the version of the event they subscribed to. There MUST be exactly 0 or 1 `event` tag.
+* The `amount` tag specifies what the supporters is committing to pay to the supported pubkey and the cadence. MUST be equal to one of the amounts specified in the
+`kind:37001` event if one is tagged. There MUST be exactly 1 `amount` tag.
+
+The `kind:7001` event can be created without an `e` tag so that users can create recurring support events without the pubkey receiving the support having explicitly created a support tier.
+
+### Zap splits
+`kind:7001` events can include zap splits as defined in NIP-57. Zap splits MUST be copied by clients as they exist in the `kind:37001` event being subscribed to. When an event has a `zap` tag with no pubkey, clients can discard it, or add the client developer's pubkey, or any other user they wish to receive a share of recurring subscriptions.
+
+## Paying
+The supporting user should create a zap `p`-tagging the receiver and e-tagging the `kind:7001`. There MUST be a single `p` and a single `e` tag in the zap request.
+
+```js
+{
+    "kind": 9734,
+    "content": "",
+    "tags": [
+        [ "p", "<recipient-pubkey>" ],
+        [ "e", "<kind-7001-event-id>" ]
+    ]
+}
+```
+
+Clients supporting this NIP can check for zaps e-tagging the `kind:7001` event to find the pubkeys that have a valid, paid subscriptions at each different period.
+
+The same `kind:7001` is re-zapped on a regular basis per the cadence specified in the event.
+
+## Stopping a subscription
+A user who wants to signal they are no longer subscribed can publish a `kind:7002` event tagging the `kind:7001` they are stopping and `p`-tagging the pubkey they are no longer subscribed to.
+
+```js
+{
+    "kind": 7002,
+    "content": "<optional-message>",
+    "tags": [
+        [ "p", "<recipient-pubkey>" ],
+        [ "e", "<kind-7001-event-id>" ],
+    ]
+}
+```
+
+## Subscription Payment Receipt
+When a subscription payment is made and a `payment-verifier-pubkey` is set on the `kind:37001` this pubkey publishes `kind:7003` events tagging the `kind:7001` event that was paid and `p`-tagging the pubkey that received the payment.
+
+```js
+{
+    "kind": 7003,
+    "content": "<optional-message>",
+    "tags": [
+        [ "p", "<recipient-pubkey>" ],
+        [ "P", "<subscriber-pubkey>" ],
+        [ "e", "<kind-7001-event-id>" ],
+        [ "valid", "<from-timestamp>", "<to-timestamp>" ]
+        [ "tier", "kind:37001-d-tag" ]
+    ]
+}
+```
+
+`p` is the pubkey that received the payment.
+`P` is the pubkey that made the payment.
+`e` is the `kind:7001` event that was paid.
+`valid` is the period for which the payment is valid.
+`tier` is the d-tag of the `kind:37001` that this subscription is for.
+
+# Appendix 0: Verifying Payment
+The following conditions must be met to verify a payment:
+
+* Time between zap receipts should be equal or less than the cadence specified in the `kind:7001` event.
+* Amount of the zap receipt should be equal or greater than the amount specified in the `kind:7001` event. For currencies not directly supported by the zap spec, clients should do a best effort conversion to the currency specified in the `kind:7001` event at the time of zap receipt.
+* Zap-receipts should include a zap request `e`-tagging the `kind:7001` event. Zap-receipts might not include a signature (for NWC-automated payments where the subscriber is not present to sign the zap request).
+* Validations specified in [NIP-57](https://github.com/nostr-protocol/nips/blob/master/57.md).
+
+If `kind:7003` events are published by the payment-verifier-pubkey, clients can use these to verify payments more simply.
--- a/README.md
+++ b/README.md
@@ -76,66 +76,83 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
 - [NIP-99: Classified Listings](99.md)

 ## Event Kinds
-| kind          | description                | NIP         |
-| ------------- | -------------------------- | ----------- |
-| `0`           | Metadata                   | [1](01.md)  |
-| `1`           | Short Text Note            | [1](01.md)  |
-| `2`           | Recommend Relay            |             |
-| `3`           | Contacts                   | [2](02.md)  |
-| `4`           | Encrypted Direct Messages  | [4](04.md)  |
-| `5`           | Event Deletion             | [9](09.md)  |
-| `6`           | Repost                     | [18](18.md) |
-| `7`           | Reaction                   | [25](25.md) |
-| `8`           | Badge Award                | [58](58.md) |
-| `16`          | Generic Repost             | [18](18.md) |
-| `40`          | Channel Creation           | [28](28.md) |
-| `41`          | Channel Metadata           | [28](28.md) |
-| `42`          | Channel Message            | [28](28.md) |
-| `43`          | Channel Hide Message       | [28](28.md) |
-| `44`          | Channel Mute User          | [28](28.md) |
-| `1063`        | File Metadata              | [94](94.md) |
-| `1311`        | Live Chat Message          | [53](53.md) |
-| `1040`        | OpenTimestamps             | [03](03.md) |
-| `1971`        | Problem Tracker            | [1971](https://github.com/nostrocket/NIPS/blob/main/Problems.md) |
-| `1984`        | Reporting                  | [56](56.md) |
-| `1985`        | Label                      | [32](32.md) |
-| `4550`        | Community Post Approval    | [72](72.md) |
-| `5000`-`5999` | Job Request                | [90](90.md) |
-| `6000`-`6999` | Job Result                 | [90](90.md) |
-| `7000`        | Job Feedback               | [90](90.md) |
-| `9041`        | Zap Goal                   | [75](75.md) |
-| `9734`        | Zap Request                | [57](57.md) |
-| `9735`        | Zap                        | [57](57.md) |
-| `9802`        | Highlights                 | [84](84.md) |
-| `10000`       | Mute List                  | [51](51.md) |
-| `10001`       | Pin List                   | [51](51.md) |
-| `10002`       | Relay List Metadata        | [65](65.md) |
-| `13194`       | Wallet Info                | [47](47.md) |
-| `22242`       | Client Authentication      | [42](42.md) |
-| `23194`       | Wallet Request             | [47](47.md) |
-| `23195`       | Wallet Response            | [47](47.md) |
-| `24133`       | Nostr Connect              | [46](46.md) |
-| `27235`       | HTTP Auth                  | [98](98.md) |
-| `30000`       | Categorized People List    | [51](51.md) |
-| `30001`       | Categorized Bookmark List  | [51](51.md) |
-| `30008`       | Profile Badges             | [58](58.md) |
-| `30009`       | Badge Definition           | [58](58.md) |
-| `30017`       | Create or update a stall   | [15](15.md) |
-| `30018`       | Create or update a product | [15](15.md) |
-| `30023`       | Long-form Content          | [23](23.md) |
-| `30024`       | Draft Long-form Content    | [23](23.md) |
-| `30078`       | Application-specific Data  | [78](78.md) |
-| `30311`       | Live Event                 | [53](53.md) |
-| `30315`       | User Statuses              | [38](38.md) |
-| `30402`       | Classified Listing         | [99](99.md) |
-| `30403`       | Draft Classified Listing   | [99](99.md) |
-| `31922`       | Date-Based Calendar Event  | [52](52.md) |
-| `31923`       | Time-Based Calendar Event  | [52](52.md) |
-| `31924`       | Calendar                   | [52](52.md) |
-| `31925`       | Calendar Event RSVP        | [52](52.md) |
-| `31989`       | Handler recommendation     | [89](89.md) |
-| `31990`       | Handler information        | [89](89.md) |
-| `34550`       | Community Definition       | [72](72.md) |
+| kind          | description                | NIP                                |
+| ------------- | -------------------------- | -----------                        |
+| `0`           | Metadata                   | [1](01.md)                         |
+| `1`           | Short Text Note            | [1](01.md)                         |
+| `2`           | Recommend Relay            |                                    |
+| `3`           | Contacts                   | [2](02.md)                         |
+| `4`           | Encrypted Direct Messages  | [4](04.md)                         |
+| `5`           | Event Deletion             | [9](09.md)                         |
+| `6`           | Repost                     | [18](18.md)                        |
+| `7`           | Reaction                   | [25](25.md)                        |
+| `8`           | Badge Award                | [58](58.md)                        |
+| `16`          | Generic Repost             | [18](18.md)                        |
+| `40`          | Channel Creation           | [28](28.md)                        |
+| `41`          | Channel Metadata           | [28](28.md)                        |
+| `42`          | Channel Message            | [28](28.md)                        |
+| `43`          | Channel Hide Message       | [28](28.md)                        |
+| `44`          | Channel Mute User          | [28](28.md)                        |
+| `1063`        | File Metadata              | [94](94.md)                        |
+| `1311`        | Live Chat Message          | [53](53.md)                        |
+| `1040`        | OpenTimestamps             | [03](03.md)                        |
+| `1971`        | Problem Tracker            | [nostrocket-1971][nostrocket-1971] |
+| `1984`        | Reporting                  | [56](56.md)                        |
+| `1985`        | Label                      | [32](32.md)                        |
+| `4550`        | Community Post Approval    | [72](72.md)                        |
+| `5000`-`5999` | Job Request                | [90](90.md)                        |
+| `6000`-`6999` | Job Result                 | [90](90.md)                        |
+| `7000`        | Job Feedback               | [90](90.md)                        |
+| `7001`        | Subscription Start         | [88](88.md)                        |
+| `7002`        | Subscription Stop          | [88](88.md)                        |
+| `9041`        | Zap Goal                   | [75](75.md)                        |
+| `9734`        | Zap Request                | [57](57.md)                        |
+| `9735`        | Zap                        | [57](57.md)                        |
+| `9802`        | Highlights                 | [84](84.md)                        |
+| `10000`       | Mute list                  | [51](51.md)                        |
+| `10001`       | Pin list                   | [51](51.md)                        |
+| `10002`       | Relay List Metadata        | [65](65.md)                        |
+| `10003`       | Bookmark list              | [51](51.md)                        |
+| `10004`       | Communities list           | [51](51.md)                        |
+| `10005`       | Public chats list          | [51](51.md)                        |
+| `10006`       | Blocked relays list        | [51](51.md)                        |
+| `10007`       | Search relays list         | [51](51.md)                        |
+| `10015`       | Interests list             | [51](51.md)                        |
+| `10030`       | User emoji list            | [51](51.md)                        |
+| `13194`       | Wallet Info                | [47](47.md)                        |
+| `22242`       | Client Authentication      | [42](42.md)                        |
+| `23194`       | Wallet Request             | [47](47.md)                        |
+| `23195`       | Wallet Response            | [47](47.md)                        |
+| `24133`       | Nostr Connect              | [46](46.md)                        |
+| `27235`       | HTTP Auth                  | [98](98.md)                        |
+| `30000`       | Follow sets                | [51](51.md)                        |
+| `30001`       | Generic lists              | [51](51.md)                        |
+| `30002`       | Relay sets                 | [51](51.md)                        |
+| `30003`       | Bookmark sets              | [51](51.md)                        |
+| `30004`       | Curation sets              | [51](51.md)                        |
+| `30008`       | Profile Badges             | [58](58.md)                        |
+| `30009`       | Badge Definition           | [58](58.md)                        |
+| `30015`       | Interest sets              | [51](51.md)                        |
+| `30030`       | Emoji sets                 | [51](51.md)                        |
+| `30017`       | Create or update a stall   | [15](15.md)                        |
+| `30018`       | Create or update a product | [15](15.md)                        |
+| `30023`       | Long-form Content          | [23](23.md)                        |
+| `30024`       | Draft Long-form Content    | [23](23.md)                        |
+| `30078`       | Application-specific Data  | [78](78.md)                        |
+| `30311`       | Live Event                 | [53](53.md)                        |
+| `30315`       | User Statuses              | [38](38.md)                        |
+| `30402`       | Classified Listing         | [99](99.md)                        |
+| `30403`       | Draft Classified Listing   | [99](99.md)                        |
+| `31922`       | Date-Based Calendar Event  | [52](52.md)                        |
+| `31923`       | Time-Based Calendar Event  | [52](52.md)                        |
+| `31924`       | Calendar                   | [52](52.md)                        |
+| `31925`       | Calendar Event RSVP        | [52](52.md)                        |
+| `31989`       | Handler recommendation     | [89](89.md)                        |
+| `31990`       | Handler information        | [89](89.md)                        |
+| `34550`       | Community Definition       | [72](72.md)                        |
+| `37001`      | Subscription Tier           | [88](88.md)                        |
+
+[nostrocket-1971]: https://github.com/nostrocket/NIPS/blob/main/Problems.md

 ## Message types
Author	SHA1	Message	Date
Believethehype	eb30dbe04f	Nip88: Adding dtag, typos - A kind 37001 dtag is referenced in the 7003 description, but was missing in the example -A etag is referenced in the kind 7001 description but an a tag was referenced in the example	2024-03-13 11:27:11 -03:00
Pablo Fernandez	00691c5f03	payment verification, relay where content can be found, perks, actor definitions	2024-02-11 17:05:39 +00:00
Pablo Fernandez	ab43538697	add referral options on subscription tiers	2024-01-06 00:54:31 +00:00
Pablo Fernandez	60256a6267	Merge branch 'master' into nip88	2023-11-23 17:52:48 +02:00
Pablo Fernandez	43d50ee424	update kind table	2023-11-23 15:47:22 +00:00
Pablo Fernandez	81480824ad	move tier description to NIP-33 event and add 7002 as unsubscribe event	2023-11-23 15:46:37 +00:00
Pablo Fernandez	470d656f98	start a verifying payment section	2023-11-23 15:30:42 +00:00
Pablo Fernandez	c2278d4fcc	change unit to msat	2023-11-23 15:23:49 +00:00
fiatjaf_	7822a8b126	Merge pull request #880 from nostr-protocol/save-nip-51	2023-11-19 14:47:02 -03:00
fiatjaf_	ea6d277c7c	Merge pull request #889 from nostr-protocol/nip11-restricted-writes	2023-11-19 11:18:19 -03:00
fiatjaf	438812d0a4	clarify that `restricted_writes` do not include normal anti-spam heuristics and other kinds of soft-restrictions.	2023-11-19 10:17:57 -03:00
fiatjaf	33a719f345	fix kind:40 name (following @snowcait).	2023-11-19 07:17:11 -03:00
fiatjaf	5e6e7a2bc8	get rid of these arbitrary markdown linebreaks and put everything in the same line.	2023-11-18 11:36:20 -03:00
fiatjaf	2d678bcd5a	metadata tags for lists kept at "title", "image" and "description", following @erskingardner and @darecjo.	2023-11-18 11:35:32 -03:00
fiatjaf	50d20123e2	"restricted_writes" on NIP-11.	2023-11-18 09:39:54 -03:00
fiatjaf	4a77fc5c40	add interests list and interests sets (following @erskingardner and @pablof7z).	2023-11-16 15:50:39 -03:00
fiatjaf	2a0b701ff7	add bookmark sets (following @staab).	2023-11-16 12:26:50 -03:00
fiatjaf	31382e57a1	add muted words, blocked relays, search relays, chat groups, emoji list and emoji sets. update set metadata tags. following @vitorpamplona, @frnandu, @snowcait, @hzrd149 closes https://github.com/nostr-protocol/nips/pull/559 closes https://github.com/nostr-protocol/nips/pull/673	2023-11-15 20:52:27 -03:00
fiatjaf_	6c3eebf510	clarify that standard lists use normal replaceable events Co-authored-by: hodlbod <jstaab@protonmail.com>	2023-11-15 20:06:49 -03:00
fiatjaf_	cd598bad5b	remove the point that makes kind 30001 be a grab-bag of things Co-authored-by: hodlbod <jstaab@protonmail.com>	2023-11-15 20:06:00 -03:00
fiatjaf	804ee187c2	make follow sets kind 30000 as per @monlovesmango's comment.	2023-11-15 15:39:23 -03:00
fiatjaf	4db99145d7	remove legacy communities list example.	2023-11-15 15:34:46 -03:00
fiatjaf	61b736574c	add kind 30005 follow sets.	2023-11-15 15:32:22 -03:00
fiatjaf	54befcc09a	deprecate the 30001 ad-hoc pin/bookmark/communities lists and use new kinds.	2023-11-15 15:32:09 -03:00
fiatjaf	fd288d4ea9	update readme kind list.	2023-11-15 08:28:59 -03:00
fiatjaf	cf1b17280f	bring back kind:10000 mute lists, deprecation notice about kind:30000/"mute" and more examples.	2023-11-15 08:24:46 -03:00
fiatjaf	1bbd87c42f	distinction between lists and sets.	2023-11-15 07:33:26 -03:00
fiatjaf	da05b5d915	add "communities" list and examples.	2023-11-15 00:47:15 -03:00
fiatjaf	5dc6071978	cut, simplify and update NIP-51 to reflect the real-world usage.	2023-11-15 00:22:09 -03:00
Pablo Fernandez	ce268de7b1	Update 88.md Co-authored-by: Tony Giorgio <101225832+TonyGiorgio@users.noreply.github.com>	2023-11-07 15:26:49 +07:00
Pablo Fernandez	7ad40d5159	Recurring Subscriptions	2023-11-05 13:14:43 +02:00