Key-Value Mappings

NIP-XX: Shortener

draft optional

Abstract

This NIP defines a standard for mapping a short string to any string value.

Structure

{
  "kind": 31994,
  "tags": [
    ["d", "<key>"],
    ["type", "<type>"]
  ],
  "content": "<value>"
}

• d: the short key
• type: how the value should be interpreted (url, text, json)
• content: the value

URL Format

/{key}/{author}

Author Formats

{author} can be:

• Hex pubkey prefix (recommended): first characters of the pubkey in hex (e.g. a7b9c2df, a7b9c2dfb9)
• NIP-05 identifier: name@domain (must be URL-encoded, e.g. alice%40nostr.com)

Examples

https://r.so/promo                    → key only
https://r.so/promo/a7b9c2df           → with hex prefix
https://r.so/promo/a7b9c2dfb9         → with longer hex prefix
https://r.so/promo/alice%40nostr.com  → with NIP-05