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
+71 −1
Open

Add reviews NIP #879

Changes from 1 commit
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
Prev Previous commit
Next Next commit
Revise NIP 85 reviews
  • Loading branch information
Jon Staab committed Mar 24, 2025
commit 8fee22404a2d2bc098947d98b7fffc7fd75657d2
39 changes: 10 additions & 29 deletions 85.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,49 +4,30 @@ NIP-85
Reviews
-------

Kind `1986` MAY be used to leave a review with optional ratings.
This NIP describes several different types of `review` which follow a single set of conventions.

The `content` field SHOULD include a human-readable review.
In all cases, the `content` field SHOULD include a human-readable review. A single [NIP 73](./73.md) `i` tag indicates the object of the review. This allows for reviews of events, people, topics, relays, or external guids.

The review event MUST include one or more `e`, `a`, `p`, `t`, or `r` tags indicating
the object of the review. This allows for reviews of events, people, topics, and relays
or external resources. As with NIP-01, a relay hint SHOULD be included when using `e` and
`p` tags.
# 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.

Tags MAY contain NIP 32 labels to help categorize what is being reviewed.
# Review Kinds

Examples
--------
## Relays

A relay review with rating metadata.
Kind `1987` indicates a review of a relay:

```json
{
"kind": 1986,
"kind": 1987,
"content": "This relay is fast!",
"tags": [
["L", "review"],
["l", "review/relay", "review"],
["rating", "0.8"],
["rating", "0.2", "smell"],
["rating", "1", "service"],
["r", <relay_url>]
],
}
```

A review of a podcast episode.

```json
{
"kind": 1986,
"content": "This was a great episode.",
"tags": [
["rating", "1"],
["r", <podcast guid in a standard format>]
["rating", "0.2", "content"],
["rating", "1", "speed"],
["i", "wss://relay.example.com/"]
],
}
```
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"]
  ],
}