From 72bb8a128b2d7d3c2c654644cd68d0d0fe58a3b1 Mon Sep 17 00:00:00 2001 From: fiatjaf_ Date: Sun, 13 Aug 2023 13:47:45 -0300 Subject: merge nips 12, 16, 20 and 33 into nip 01 (#703) Co-authored-by: Viktor Vsk --- 33.md | 50 ++------------------------------------------------ 1 file changed, 2 insertions(+), 48 deletions(-) (limited to '33.md') diff --git a/33.md b/33.md index 5128bec..1e7a9fc 100644 --- a/33.md +++ b/33.md @@ -4,52 +4,6 @@ NIP-33 Parameterized Replaceable Events -------------------------------- -`draft` `optional` `author:Semisol` `author:Kukks` `author:Cameri` `author:Giszmo` +`final` `mandatory` `author:Semisol` `author:Kukks` `author:Cameri` `author:Giszmo` -This NIP adds a new event range that allows for replacement of events that have the same `d` tag and kind unlike NIP-16 which only replaced by kind. - -Implementation --------------- -The value of a tag can be any string and is defined as the first parameter of a tag after the tag name. - -A *parameterized replaceable event* is defined as an event with a kind `30000 <= n < 40000`. -Upon a parameterized replaceable event with a newer timestamp than the currently known latest -replaceable event with the same kind, author and first `d` tag value being received, the old event -SHOULD be discarded, effectively replacing what gets returned when querying for -`author:kind:d-tag` tuples. - -If two events have the same timestamp, the event with the lowest id (first in lexical order) SHOULD be retained, and the other discarded. - -A missing or a `d` tag with no value should be interpreted equivalent to a `d` tag with the -value as an empty string. Events from the same author with any of the following `tags` -replace each other: - -* `"tags":[["d",""]]` -* `"tags":[]`: implicit `d` tag with empty value -* `"tags":[["d"]]`: implicit empty value `""` -* `"tags":[["d",""],["d","not empty"]]`: only first `d` tag is considered -* `"tags":[["d"],["d","some value"]]`: only first `d` tag is considered -* `"tags":[["e"]]`: same as no tags -* `"tags":[["d","","1"]]`: only the first value is considered (`""`) - -Clients SHOULD NOT use `d` tags with multiple values and SHOULD include the `d` tag even if it has no value to allow querying using the `#d` filter. - -Referencing and tagging ------------------------ - -Normally (as per NIP-01, NIP-12) the `"p"` tag is used for referencing public keys and the -`"e"` tag for referencing event ids and the `note`, `npub`, `nprofile` or `nevent` are their -equivalents for event tags (i.e. an `nprofile` is generally translated into a tag -`["p", "", ""]`). - -To support linking to parameterized replaceable events, the `naddr` code is introduced on -NIP-19. It includes the public key of the event author and the `d` tag (and relays) such that -the referenced combination of public key and `d` tag can be found. - -The equivalent in `tags` to the `naddr` code is the tag `"a"`, comprised of `["a", "::", ""]`. - -Client Behavior ---------------- - -Clients SHOULD use the `supported_nips` field to learn if a relay supports this NIP. -Clients MAY send parameterized replaceable events to relays that may not support this NIP, and clients querying SHOULD be prepared for the relay to send multiple events and should use the latest one and are recommended to send a `#d` tag filter. Clients should account for the fact that missing `d` tags or ones with no value are not returned in tag filters, and are recommended to always include a `d` tag with a value. +Moved to [NIP-01](01.md). -- cgit v1.2.3