From 280eb498e0ac56b8f9356c1b7a88cc8b31579801 Mon Sep 17 00:00:00 2001 From: Oscar Merry Date: Fri, 19 Apr 2024 14:30:45 +0100 Subject: Draft External Content IDs --- 24.md | 1 + 1 file changed, 1 insertion(+) (limited to '24.md') diff --git a/24.md b/24.md index 449101a..a17b334 100644 --- a/24.md +++ b/24.md @@ -40,4 +40,5 @@ tags These tags may be present in multiple event kinds. Whenever a different meaning is not specified by some more specific NIP, they have the following meanings: - `r`: a web URL the event is referring to in some way + - `i`: an external id the event is referring to in some way - see [NIP-XX](XX.md) - `title`: title of the event -- cgit v1.2.3 From 326ad34690c707b983a28524d85d8da3441ca7b3 Mon Sep 17 00:00:00 2001 From: Asai Toshiya Date: Thu, 13 Jun 2024 21:02:35 +0900 Subject: NIP-24: fix missing rename --- 24.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to '24.md') diff --git a/24.md b/24.md index b21f48e..3adec24 100644 --- a/24.md +++ b/24.md @@ -28,7 +28,7 @@ These are fields that should be ignored or removed when found in the wild: kind 3 ====== -These are extra fields not specified in NIP-02 that may be present in the stringified JSON of contacts events: +These are extra fields not specified in NIP-02 that may be present in the stringified JSON of follow events: ### Deprecated fields -- cgit v1.2.3 From 4d9eb32dc9062868d0d61c15456935dad39364de Mon Sep 17 00:00:00 2001 From: Oscar Merry Date: Mon, 5 Aug 2024 23:51:04 +0100 Subject: Use NIP-73 --- 24.md | 2 +- 73.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 3 ++- XX.md | 48 ------------------------------------------------ 4 files changed, 51 insertions(+), 50 deletions(-) create mode 100644 73.md delete mode 100644 XX.md (limited to '24.md') diff --git a/24.md b/24.md index 8710af6..ef4196b 100644 --- a/24.md +++ b/24.md @@ -40,5 +40,5 @@ tags These tags may be present in multiple event kinds. Whenever a different meaning is not specified by some more specific NIP, they have the following meanings: - `r`: a web URL the event is referring to in some way - - `i`: an external id the event is referring to in some way - see [NIP-XX](XX.md) + - `i`: an external id the event is referring to in some way - see [NIP-73](73.md) - `title`: name of [NIP-51](51.md) sets, [NIP-52](52.md) calendar event, [NIP-53](53.md) live event or [NIP-99](99.md) listing diff --git a/73.md b/73.md new file mode 100644 index 0000000..12228d3 --- /dev/null +++ b/73.md @@ -0,0 +1,48 @@ +NIP-73 +====== + +External Content IDs +------------------------- + +`draft` `optional` + +There are certain established global content identifiers that would be useful to reference in nostr events so that clients can query all events assosiated with these ids. + +- Book [ISBNs](https://en.wikipedia.org/wiki/ISBN) +- Podcast [GUIDs](https://podcastnamespace.org/tag/guid) +- Movie [ISANs](https://en.wikipedia.org/wiki/International_Standard_Audiovisual_Number) + +Since the `i` tag is already used for similar references in kind-0 metadata events it makes sense to use it for these content ids as well. + + +## Supported IDs + +### Books: + +- Book ISBN: `["i", "isbn:9780765382030"]` - https://isbnsearch.org/isbn/9780765382030 + +Book ISBNs MUST be referenced _**without hyphens**_ as many book search APIs return the ISBNs without hyphens. Removing hypens from ISBNs is trivial, whereas adding the hyphens back in is non-trivial requiring a library. + +### Podcasts: + +- Podcast RSS Feed GUID: `["i", "podcast:guid:c90e609a-df1e-596a-bd5e-57bcc8aad6cc"]` - https://podcastindex.org/podcast/c90e609a-df1e-596a-bd5e-57bcc8aad6cc +- Podcast RSS Item GUID: `["i", "podcast:item:guid:d98d189b-dc7b-45b1-8720-d4b98690f31f"]` +- Podcast RSS Publisher GUID: `["i", "podcast:publisher:guid:18bcbf10-6701-4ffb-b255-bc057390d738"]` + +### Movies: + +- Movie ISAN: `["i", "isan:0000-0000-401A-0000-7"]` - https://web.isan.org/public/en/isan/0000-0000-401A-0000-7 + +Movie ISANs SHOULD be referenced _**without the version part**_ as the versions / edits of movies are not relevant. More info on ISAN parts here - https://support.isan.org/hc/en-us/articles/360002783131-Records-relations-and-hierarchies-in-the-ISAN-Registry + +--- + +### Optional URL Hints + +Each `i` tag MAY have a url hint as the second argument to redirect people to a website if the client isn't opinionated about how to interpret the id: + +`["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]` + + diff --git a/README.md b/README.md index 550888a..6c83ba8 100644 --- a/README.md +++ b/README.md @@ -77,6 +77,7 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos - [NIP-70: Protected Events](70.md) - [NIP-71: Video Events](71.md) - [NIP-72: Moderated Communities](72.md) +- [NIP-73: External Content IDs](73.md) - [NIP-75: Zap Goals](75.md) - [NIP-78: Application-specific data](78.md) - [NIP-84: Highlights](84.md) @@ -238,7 +239,7 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos | `-` | -- | -- | [70](70.md) | | `g` | geohash | -- | [52](52.md) | | `h` | group id | -- | [29](29.md) | -| `i` | identity | proof | [39](39.md) | +| `i` | external identity | proof, url hint | [39](39.md), [73](73.md) | | `k` | kind number (string) | -- | [18](18.md), [25](25.md), [72](72.md) | | `l` | label, label namespace | -- | [32](32.md) | | `L` | label namespace | -- | [32](32.md) | diff --git a/XX.md b/XX.md deleted file mode 100644 index e7ee5f5..0000000 --- a/XX.md +++ /dev/null @@ -1,48 +0,0 @@ -NIP-XX -====== - -External Content IDs -------------------------- - -`draft` `optional` - -There are certain established global content identifiers that would be useful to reference in nostr events so that clients can query all events assosiated with these ids. - -- Book [ISBNs](https://en.wikipedia.org/wiki/ISBN) -- Podcast [GUIDs](https://podcastnamespace.org/tag/guid) -- Movie [ISANs](https://en.wikipedia.org/wiki/International_Standard_Audiovisual_Number) - -Since the `i` tag is already used for similar references in kind-0 metadata events it makes sense to use it for these content ids as well. - - -## Supported IDs - -### Books: - -- Book ISBN: `["i", "isbn:9780765382030"]` - https://isbnsearch.org/isbn/9780765382030 - -Book ISBNs MUST be referenced _**without hyphens**_ as many book search APIs return the ISBNs without hyphens. Removing hypens from ISBNs is trivial, whereas adding the hyphens back in is non-trivial requiring a library. - -### Podcasts: - -- Podcast RSS Feed GUID: `["i", "podcast:guid:c90e609a-df1e-596a-bd5e-57bcc8aad6cc"]` - https://podcastindex.org/podcast/c90e609a-df1e-596a-bd5e-57bcc8aad6cc -- Podcast RSS Item GUID: `["i", "podcast:item:guid:d98d189b-dc7b-45b1-8720-d4b98690f31f"]` -- Podcast RSS Publisher GUID: `["i", "podcast:publisher:guid:18bcbf10-6701-4ffb-b255-bc057390d738"]` - -### Movies: - -- Movie ISAN: `["i", "isan:0000-0000-401A-0000-7"]` - https://web.isan.org/public/en/isan/0000-0000-401A-0000-7 - -Movie ISANs SHOULD be referenced _**without the version part**_ as the versions / edits of movies are not relevant. More info on ISAN parts here - https://support.isan.org/hc/en-us/articles/360002783131-Records-relations-and-hierarchies-in-the-ISAN-Registry - ---- - -### Optional URL Hints - -Each `i` tag MAY have a url hint as the second argument to redirect people to a website if the client isn't opinionated about how to interpret the id: - -`["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]` - - -- cgit v1.2.3 From 1d3744784c0faf3e3c43b7a16e657499476e19c5 Mon Sep 17 00:00:00 2001 From: Alex Gleason Date: Thu, 15 Aug 2024 20:28:53 -0500 Subject: Define the `t` tag in NIP-24 --- 24.md | 7 ++++--- README.md | 2 +- 2 files changed, 5 insertions(+), 4 deletions(-) (limited to '24.md') diff --git a/24.md b/24.md index ef4196b..e44a039 100644 --- a/24.md +++ b/24.md @@ -39,6 +39,7 @@ tags These tags may be present in multiple event kinds. Whenever a different meaning is not specified by some more specific NIP, they have the following meanings: - - `r`: a web URL the event is referring to in some way - - `i`: an external id the event is referring to in some way - see [NIP-73](73.md) - - `title`: name of [NIP-51](51.md) sets, [NIP-52](52.md) calendar event, [NIP-53](53.md) live event or [NIP-99](99.md) listing + - `r`: a web URL the event is referring to in some way. + - `i`: an external id the event is referring to in some way - see [NIP-73](73.md). + - `title`: name of [NIP-51](51.md) sets, [NIP-52](52.md) calendar event, [NIP-53](53.md) live event or [NIP-99](99.md) listing. + - `t`: a hashtag. The value MUST be a lowercase string. For kind 1 and other text notes, the event's content SHOULD contain the value prefixed by a `#` within the text in any case. \ No newline at end of file diff --git a/README.md b/README.md index 8bf036b..80b8dcf 100644 --- a/README.md +++ b/README.md @@ -250,7 +250,7 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos | `q` | event id (hex) | relay URL | [18](18.md) | | `r` | a reference (URL, etc) | -- | [24](24.md), [25](25.md) | | `r` | relay url | marker | [65](65.md) | -| `t` | hashtag | -- | | +| `t` | hashtag | -- | [24](24.md) | | `alt` | summary | -- | [31](31.md) | | `amount` | millisatoshis, stringified | -- | [57](57.md) | | `bolt11` | `bolt11` invoice | -- | [57](57.md) | -- cgit v1.2.3 From e30eb40eefbcef319a74a5531473f412987fca6a Mon Sep 17 00:00:00 2001 From: Alex Gleason Date: Tue, 20 Aug 2024 09:42:59 -0500 Subject: NIP-24: t-tag only has to be a lowercase string --- 24.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to '24.md') diff --git a/24.md b/24.md index e44a039..1afa7c7 100644 --- a/24.md +++ b/24.md @@ -42,4 +42,4 @@ These tags may be present in multiple event kinds. Whenever a different meaning - `r`: a web URL the event is referring to in some way. - `i`: an external id the event is referring to in some way - see [NIP-73](73.md). - `title`: name of [NIP-51](51.md) sets, [NIP-52](52.md) calendar event, [NIP-53](53.md) live event or [NIP-99](99.md) listing. - - `t`: a hashtag. The value MUST be a lowercase string. For kind 1 and other text notes, the event's content SHOULD contain the value prefixed by a `#` within the text in any case. \ No newline at end of file + - `t`: a hashtag. The value MUST be a lowercase string. -- cgit v1.2.3 From bbcea0c86175fd344132964345944d3479c3d4d0 Mon Sep 17 00:00:00 2001 From: Vitor Pamplona Date: Tue, 19 Nov 2024 21:20:20 -0500 Subject: adds pronouns --- 24.md | 1 + 1 file changed, 1 insertion(+) (limited to '24.md') diff --git a/24.md b/24.md index 1afa7c7..d65d9ce 100644 --- a/24.md +++ b/24.md @@ -17,6 +17,7 @@ These are extra fields not specified in NIP-01 that may be present in the string - `website`: a web URL related in any way to the event author. - `banner`: an URL to a wide (~1024x768) picture to be optionally displayed in the background of a profile screen. - `bot`: a boolean to clarify that the content is entirely or partially the result of automation, such as with chatbots or newsfeeds. + - `pronouns`: a string representing the preferred way to refer to this person. ### Deprecated fields -- cgit v1.2.3 From 03c64a6e959ae91b727bcaea8198d08ee4860359 Mon Sep 17 00:00:00 2001 From: fiatjaf Date: Thu, 21 Nov 2024 12:11:13 -0300 Subject: nip24: revert improperly merged joke. this reverts https://github.com/nostr-protocol/nips/pull/1590 --- 24.md | 1 - 1 file changed, 1 deletion(-) (limited to '24.md') diff --git a/24.md b/24.md index d65d9ce..1afa7c7 100644 --- a/24.md +++ b/24.md @@ -17,7 +17,6 @@ These are extra fields not specified in NIP-01 that may be present in the string - `website`: a web URL related in any way to the event author. - `banner`: an URL to a wide (~1024x768) picture to be optionally displayed in the background of a profile screen. - `bot`: a boolean to clarify that the content is entirely or partially the result of automation, such as with chatbots or newsfeeds. - - `pronouns`: a string representing the preferred way to refer to this person. ### Deprecated fields -- cgit v1.2.3 From ef1746dd2cea9ec5d62d00f16f0fd5695d895d0b Mon Sep 17 00:00:00 2001 From: fiatjaf Date: Thu, 21 Nov 2024 12:11:32 -0300 Subject: nip24: clarify nip purpose. --- 24.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to '24.md') diff --git a/24.md b/24.md index 1afa7c7..df3a932 100644 --- a/24.md +++ b/24.md @@ -6,7 +6,7 @@ Extra metadata fields and tags `draft` `optional` -This NIP defines extra optional fields added to events. +This NIP keeps track of extra optional fields that can added to events which are not defined anywhere else but have become _de facto_ standards and other minor implementation possibilities that do not deserve their own NIP and do not have a place in other NIPs. kind 0 ====== -- cgit v1.2.3