nostr-addressable-event-d-tag-requirement

Nostr Addressable Event d-tag Requirement

Problem

When publishing parameterized replaceable events (Kind 30000-39999, including NIP-71 video events Kind 34236), events appear as duplicates on the relay instead of replacing each other. The same content shows up multiple times for the same user.

Context / Trigger Conditions

• Publishing Kind 30000+ events (parameterized replaceable events)
• Same video/content appears multiple times in user's feed
• Events have identical pubkey, kind, and content but different event IDs
• Relay returns multiple events when you expect one
• Using NIP-71 (Kind 34236) for video events
• Using NIP-23 (Kind 30023) for long-form content
• Any addressable event type showing duplicates

Solution

Root Cause

Parameterized replaceable events (Kind 30000-39999) require a d tag to be addressable. The combination of pubkey + kind + d-tag value forms the unique address. Without a d tag, the relay treats each event as a separate non-replaceable event.

Fix

Always include a d tag with a unique identifier for the content:

// CORRECT - has d tag, will be replaceable
const event = {
  kind: 34236, // NIP-71 video
  pubkey: userPubkey,
  content: "Video description",
  tags: [
    ["d", videoId],  // REQUIRED for addressability
    ["title", "My Video"],
    ["url", "https://..."],
    // ... other tags
  ]
};

// WRONG - missing d tag, creates new event each time
const badEvent = {
  kind: 34236,
  pubkey: userPubkey,
  content: "Video description",
  tags: [
    ["title", "My Video"],  // No d tag!
    ["url", "https://..."],
  ]
};

For NIP-71 Video Events

Use the video's unique identifier (vine_id, video_id, etc.) as the d-tag value:

tags.push(["d", video.id]);

Cleaning Up Existing Duplicates

1. Fetch all events for the pubkey: { kinds: [34236], authors: [pubkey] }
2. Identify events without d-tags (these are the duplicates)
3. Publish NIP-09 deletion events (Kind 5) referencing the bad event IDs
4. Republish with proper d-tags