upleb.uk

Public git repos — served from a NIP-34 GRASP relay at git.upleb.uk

summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSemisol <45574030+Semisol@users.noreply.github.com>2024-04-15 09:07:23 +0300
committerGitHub <noreply@github.com>2024-04-15 09:07:23 +0300
commit053d07e0ef372cb4bdeead61181ecae5bf7c96f9 (patch)
treed5f64e9a55b05d084bd63a8811c9d57e981ff288
parent46f8133cd44bec99cd4611b8f52e54c46ade3648 (diff)
NIP-91: remove `has_more`, add `auth_recommended`
-rw-r--r--91.md11
1 files changed, 6 insertions, 5 deletions
diff --git a/91.md b/91.md
index 76e8123..582a1d2 100644
--- a/91.md
+++ b/91.md
@@ -30,7 +30,8 @@ This MAY be higher or lower than the lowest `created_at`, and the clients SHOULD
30 30
31### `cursor` 31### `cursor`
32 32
33The value of this extension MUST be a string if present, and represents a cursor the client can use to paginate this query. 33The value of this extension MUST be a string or `null` if present, and represents a cursor the client can use to paginate this query.
34If the value is `null`, then it indicates that no more events are available for the given set of filters.
34To get more events, the client MUST send a `REQ` with the same filters (except limit, which can be changed), and the `cursor` string 35To get more events, the client MUST send a `REQ` with the same filters (except limit, which can be changed), and the `cursor` string
35in the 1st filter with the key `cursor`. Example: 36in the 1st filter with the key `cursor`. Example:
36```jsonc 37```jsonc
@@ -46,8 +47,8 @@ in the 1st filter with the key `cursor`. Example:
46This cursor MUST be valid for the duration of the connection, and MAY be valid in a new connection. A relay may indicate a cursor is no longer valid 47This cursor MUST be valid for the duration of the connection, and MAY be valid in a new connection. A relay may indicate a cursor is no longer valid
47by sending a CLOSED with the prefix `bad-cursor: `. 48by sending a CLOSED with the prefix `bad-cursor: `.
48 49
49### `has_more` 50### `auth_recommended`
50`recommended`
51 51
52The value of this extension MUST be a boolean if present, and should represent if the client should continue trying to get events. 52The value of this extension MUST be a boolean if present, and indicates if the client should `AUTH` to get more events that match this query.
53This MAY be false if the relay has completed the query due to not having more events available, or may not be able to complete this query due to a permanent failure (scan limit exceeded is one). 53This is a less disruptive alternative to `CLOSED` with `auth-required:` for filters that don't explicitly ask for access controlled events,
54but may match them.