Skip to content

New spec in NIP 73 for referencing arbitrary NIP specifications #2102

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
manimejia wants to merge 6 commits into
base: master
Choose a base branch
from
Open

New spec in NIP 73 for referencing arbitrary NIP specifications #2102

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
905b7ca
Add NIP referencing to External Content IDs
manimejia Oct 31, 2025
1caec26
add kind numbers to NIP references in 73.md
manimejia Oct 31, 2025
6876490
update `i` tag format for referencing NIPs in 73.md
manimejia Oct 31, 2025
6493ea6
Updated NIP referencing format for external repositories
manimejia Dec 2, 2025
d5b8ed3
Update syntax for referencing external NIP repositories
manimejia Dec 2, 2025
0fd3073
Added `rel` string as (optional) third argument
manimejia Dec 6, 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
94 changes: 81 additions & 13 deletions 73.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,19 +13,20 @@ There are certain established global content identifiers such as [Book ISBNs](ht

## Supported IDs

| Type | `i` tag | `k` tag |
| --- | --- | --- |
| URLs | "`<URL, normalized, no fragment>`" | "web" |
| Books | "isbn:`<id, without hyphens>`" | "isbn" |
| Geohashes | "geo:`<geohash, lowercase>`" | "geo" |
| Movies | "isan:`<id, without version part>`" | "isan" |
| Papers | "doi:`<id, lowercase>`" | "doi" |
| Hashtags | "#`<topic, lowercase>`" | "#" |
| Podcast Feeds | "podcast:guid:`<guid>`" | "podcast:guid" |
| Podcast Episodes | "podcast:item:guid:`<guid>`" | "podcast:item:guid" |
| Podcast Publishers | "podcast:publisher:guid:`<guid>`" | "podcast:publisher:guid" |
| Blockchain Transaction | "`<blockchain>`:[`<chainId>`:]tx:`<txid, hex, lowercase>`" | "`<blockchain>`:tx" |
| Blockchain Address | "`<blockchain>`:[`<chainId>`:]address:`<address>`" | "`<blockchain>`:address" |
| Type | `i` tag | `k` tag |
| --- | --- | --- |
| URLs | "`<URL, normalized, no fragment>`" | "web" |
| Nostr NIPs | "`<format matches 'a' tag>`" | "nip" |
| Books | "isbn:`<id, without hyphens>`" | "isbn" |
| Geohashes | "geo:`<geohash, lowercase>`" | "geo" |
| Movies | "isan:`<id, without version part>`" | "isan" |
| Papers | "doi:`<id, lowercase>`" | "doi" |
| Hashtags | "#`<topic, lowercase>`" | "#" |
| Podcast Feeds | "podcast:guid:`<guid>`" | "podcast:guid" |
| Podcast Episodes | "podcast:item:guid:`<guid>`" | "podcast:item:guid" |
| Podcast Publishers | "podcast:publisher:guid:`<guid>`" | "podcast:publisher:guid" |
| Blockchain Transaction | "`<blockchain>`:[`<chainId>`:]tx:`<txid, hex, lowercase>`" | "`<blockchain>`:tx" |
| Blockchain Address | "`<blockchain>`:[`<chainId>`:]address:`<address>`" | "`<blockchain>`:address" |

---

Expand All @@ -43,6 +44,64 @@ For the webpage "https://myblog.example.com/post/2012-03-27/hello-world" the "i"
]
```

### Nostr NIPS

Allow 'all of nostr' to reference, comment, and react on any published NIP spec in a standardized manner, regardless of which repo or nostr event kind they are posted to. The first argument of the `i` tag SHOULD be in a standard format matching `a` tags, as specified in NIP-01. Other arguments are optional.

#### First argument

- If referencing a published Nostr event that contains a NIP proposal, the format SHOULD be`<kind integer>:<32-bytes lowercase hex of a pubkey>:<d tag value>`.
- If referencing a NIP proposal file in an online repository, the format SHOULD be `<repo-domain>:<repo-owner>/<repo-name>:<NIP-identifier>`, using the following standards :
- [URI hostname](https://en.wikipedia.org/wiki/Hostname#Syntax) syntax for `<repo-domain>`
- [URI encoded](https://en.wikipedia.org/wiki/Percent-encoding#Percent-encoding_in_a_URI) syntax for `<repo-owner>` and `<repo-name>`
- [URL slug](https://en.wikipedia.org/wiki/Clean_URL#Slug) syntax for `<NIP-identifier>`
- The value MAY be a single finalized NIP number, but this use is deprecated.

#### Other arguments

- A URL hint MAY be added as the second argumant of the `i` tag, to suggest a web page without hard linking the reference to a specific repo or nostr client.
- A `rel` string MAY be added as the third argument of the `i` tag, to designate this referenced NIP as being `upstream`, `preferred`, `alternate`, `deprecated`, `suggested`, `related`, or having some other relationship to the current event. (usefull when forking or commenting about NIP events)


A reference to a NIP published in the GitHub "primary" NIPs repo SHOULD look like this:

```jsonc
// preferred format matches `a` tag
// <repo-domain>:<repo-owner>/<repo-name>:<NIP-identifier>
[
["i", "github.com:nostr-protocol/nips:73", "https://github.com/nostr-protocol/nips/blob/master/73.md", "upstream"],
["k", "nip"]
]
// deprecated format matches arbitrary NIP number
[
["i", "73", "https://github.com/nostr-protocol/nips/blob/master/73.md"],
["k", "nip"]
]
```

A reference to a NIP published as kind `30817` to NostrHub SHOULD look like this:

```jsonc
// format matches `a` tag
// <kind integer>:<32-bytes lowercase hex of a pubkey>:<d tag value>
[
["i", "30817:0461fcbecc4c3374439932d6b8f11269ccdb7cc973ad7a50ae362db135a474dd:nips-on-nostr", "https://nostrhub.io/naddr1qvzqqqrcvypzqprpljlvcnpnw3pejvkkhrc3y6wvmd7vjuad0fg2ud3dky66gaxaqqxku6tswvkk7m3ddehhxarjqk4nmy", "related"],
["k", "nip"]
]
```

A reference to a NIP published as kind `30818` to WikiStr SHOULD look like this:

```jsonc
// format matches `a` tag
// <kind integer>:<32-bytes lowercase hex of a pubkey>:<d tag value>
[
["i", "30818:fd208ee8c8f283780a9552896e4823cc9dc6bfd442063889577106940fd927c1:nkbip-01", "https://wikistr.com/nkbip-01*fd208ee8c8f283780a9552896e4823cc9dc6bfd442063889577106940fd927c1"],
["k", "nip"]
]
```


### Books:

- Book ISBN: `["i", "isbn:9780765382030"]` - https://isbnsearch.org/isbn/9780765382030
Expand Down Expand Up @@ -126,3 +185,12 @@ Each `i` tag MAY have a url hint as the second argument to redirect people to a
`["i", "podcast:item:guid:d98d189b-dc7b-45b1-8720-d4b98690f31f", https://fountain.fm/episode/z1y9TMQRuqXl2awyrQxg]`

`["i", "isan:0000-0000-401A-0000-7", https://www.imdb.com/title/tt0120737]`



---

### Optional `rel` string

Each `i` tag MAY have a `rel` string added as the third argument (or second argument for Webpage tags) to suggest a [relationship](https://www.w3schools.com/TAGS/att_a_rel.asp) between the current event and the external content. This may be any string in [URL slug](https://en.wikipedia.org/wiki/Clean_URL#Slug) syntax.