Nostrbook

Appearance

Kind 2004: Torrent Comment ​

Overview ​

Kind 2004 events represent comments on torrents in the Nostr ecosystem. These events allow users to provide feedback, information, or discussions about specific torrents that have been shared as Kind 2003 events. Torrent comments function similarly to regular short text notes (Kind 1) but are specifically linked to torrent events, enabling threaded discussions about shared content.

Specification ​

PropertyValue
Kind Number2004
Event RangeEphemeral
Defined inNIP-35

Content Format ​

The content field contains the comment text. This can include feedback about the torrent, additional information, or discussion points.

Schema ​

json
"content": "This is a high quality release with great video and audio. Seeds are plentiful and download speed is excellent."

Tags ​

Tag NameDescriptionFormatRequired
eReferenced torrent event["e", "<event-id>", "<relay-url>", "<marker>"]Yes
pAuthor of the referenced event["p", "<pubkey>"]No

Client Behavior ​

Clients should:

  1. Follow NIP-10 threading guidelines for displaying comments in relation to torrents
  2. Display torrent comments alongside or beneath the associated torrent information
  3. Support threaded replies to torrent comments
  4. Allow users to easily add comments to torrents they're viewing
  5. Make it clear that the comment is related to a torrent event

Relay Behavior ​

Relays should:

  1. Store and serve torrent comment events like other ephemeral events
  2. Handle them according to standard event processing rules

Use Cases ​

  • Providing feedback on torrent quality
  • Sharing additional information about the content
  • Warning about potential issues (corrupt files, missing content, etc.)
  • Discussing the content with other users
  • Requesting similar content
  • Confirming authenticity of the content

Example ​

json
{
  "id": "fe8b1c9a37218cf5ce604a8dce596c9c3ae0c650df2336f3c60c78e61a7b2031",
  "pubkey": "f7234bd4c1394dda46d09f35bd384dd30cc552ad5541990f98844fb06676e9ca",
  "created_at": 1671217500,
  "kind": 2004,
  "tags": [
    ["e", "4376c65d2f232afbe9b882a35baa4f6fe8667c4e684749af565f981833ed6a65", "wss://relay.example.com", "root"],
    ["p", "79dff8f82963424e0bb02708a22e44b4980893e3a4be0fa3cb60a43b946764e3"]
  ],
  "content": "This is an excellent 4K release with HDR that really shines on OLED displays. The audio is Dolby TrueHD Atmos and sounds fantastic. Download speed averaged 25MB/s with about 150 seeds. Highly recommended!",
  "sig": "a76f39224cebd44cf04eeebe01d5ab2e8f7a3e5e56c83cadd252e7bc5e2e34fd7ad7148cf7a2c7620d9490ccf2e1bac521995725f2e1f543159b8eb98bfdd405"
}

Reply to a torrent comment:

json
{
  "id": "a6c49604e8b105829f27804c56ba1eef8c487ceabc1a2eaffab3d9c9a312dfca",
  "pubkey": "252f10c83610ebca1a059c0bae8255eba2f95be4d1d7bcfa89d7248a82d9f111",
  "created_at": 1671218000,
  "kind": 2004,
  "tags": [
    ["e", "4376c65d2f232afbe9b882a35baa4f6fe8667c4e684749af565f981833ed6a65", "wss://relay.example.com", "root"],
    ["e", "fe8b1c9a37218cf5ce604a8dce596c9c3ae0c650df2336f3c60c78e61a7b2031", "wss://relay.example.com", "reply"],
    ["p", "f7234bd4c1394dda46d09f35bd384dd30cc552ad5541990f98844fb06676e9ca"]
  ],
  "content": "I agree, the HDR is fantastic. Which audio setup are you using for the Atmos track?",
  "sig": "5f8ac6d9c2dab830ebbdb231ad6123ef0121c4710218f339d9d3b5b22fd74c0a7b1be0de52ffce6022e87dfa5b7ae3f2749a126b09c82c3ea31eb4c69d25091c"
}

References ​

Notes ​

  • Torrent comments follow the same threading rules as defined in NIP-10
  • Comments can reference the torrent directly (root) or reply to other comments (reply)
  • Threaded discussions help users find valuable information about torrents
  • User feedback on torrents helps the community assess content quality before downloading
  • Comments can be used to suggest improvements or alternatives to existing torrents