Skip to content

Add reviews NIP #879

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
staab wants to merge 6 commits into
base: master
Choose a base branch
from
Open

Add reviews NIP #879

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
f92d9c8
Add reviews NIP
Nov 13, 2023
9553ef9
Add labels to 85
Nov 13, 2023
8fee224
Revise NIP 85 reviews
Sep 25, 2024
03e2b4a
Make reviews replaceable events
Sep 26, 2024
c47d286
Update 85.md
staab Mar 24, 2025
3f95687
Add book reviews
Mar 25, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
70 changes: 70 additions & 0 deletions 85.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
NIP-85
======

Reviews
-------

This NIP describes several different types of `review` which follow a single set of conventions.

In all cases, the `content` field SHOULD include a human-readable review. A review event's `d` tag indicates the object of the review.

# Ratings

Tags MAY contain additional `rating` tags each of which should have a `value` between 0 and 1,
and an optional `mark` specifying an attribute of the thing being reviewed.

# Review Kinds

## Event

Kind `31986` indicates a review of any event generated by a `pubkey`.

- The `d` tag MUST be the `id` of the event.
- The `p` tag MUST be the `pubkey` of the event.

```json
{
"kind": 31986,
"content": "Always publishing quality information about breaking news all over the world.",
...
"tags": [
["d", "<event-id>"]
["p", "<pubkey>"],
["k", "1"],
["rating", "0.8"]
],
}
```

## Relays

Kind `31987` indicates a review of a relay. The `d` tag MUST be the url of the relay.

```json
{
"kind": 31987,
"content": "This relay is fast!",
"tags": [
["d", "wss://relay.example.com/"],
Copy link
Contributor

@abh3po abh3po May 9, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Imo it should be namespaced otherwise there could be collisions with urls of other protocols that use websockets

Copy link
Member Author

@staab staab May 9, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's already namespaced, that's what kinds are for

Copy link
Contributor

@abh3po abh3po May 9, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Lol, my bad got confused between nips

["rating", "0.8"],
["rating", "0.2", "content"],
["rating", "1", "speed"]
],
}
```
Copy link

@RydalWater RydalWater Mar 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
```

Book Review

Kind 31025 indicates a review of a book. The d tag SHOULD take the form of a NIP 73 id or resulting hash of the id.
The k tag MUST be isbn.
The raw tag provides an optional field for raw rating values to be added as a fallback mechanism or for reference.
One or more t tags may be included as descriptive qualifiers to accompany reviews.

{
  "kind": 31025,
  "content": "Really enjoyed this book!",
  "tags": [
    ["d", `"isbn:9780141030586" or "648370d3279993b70d7f75625d765e08ddcbb4db5262ebd2e9db0d666c0b8412"`]
    ["k", "isbn"]
    ["rating", "0.8"]
    ["raw", "4/5"]
    ["t", "heartwarming"]
    ["t", "captivating"]
  ],
}



## Books

Kind `31985` indicates a review of a book. The `d` tag MUST be a [NIP 73](./73.md) ISBN content ID.

```json
{
"kind": 31985,
"tags": [
["d","isbn:9781529100624"],
["rating", "0.8"]
],
"content": "Good book",
}
```
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -155,7 +155,6 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
| `1971` | Problem Tracker | [nostrocket][nostrocket] |
| `1984` | Reporting | [56](56.md) |
| `1985` | Label | [32](32.md) |
| `1986` | Relay reviews | |
| `1987` | AI Embeddings / Vector lists | [NKBIP-02] |
| `2003` | Torrent | [35](35.md) |
| `2004` | Torrent Comment | [35](35.md) |
Expand Down Expand Up @@ -239,6 +238,7 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
| `31923` | Time-Based Calendar Event | [52](52.md) |
| `31924` | Calendar | [52](52.md) |
| `31925` | Calendar Event RSVP | [52](52.md) |
| `31987` | Relay Review | [85](85.md) |
| `31989` | Handler recommendation | [89](89.md) |
| `31990` | Handler information | [89](89.md) | |
| `32267` | Software Application | | |
Expand Down