diff options
| author | Semisol <45574030+Semisol@users.noreply.github.com> | 2024-04-15 09:07:23 +0300 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2024-04-15 09:07:23 +0300 |
| commit | 053d07e0ef372cb4bdeead61181ecae5bf7c96f9 (patch) | |
| tree | d5f64e9a55b05d084bd63a8811c9d57e981ff288 | |
| parent | 46f8133cd44bec99cd4611b8f52e54c46ade3648 (diff) | |
NIP-91: remove `has_more`, add `auth_recommended`
| -rw-r--r-- | 91.md | 11 |
1 files changed, 6 insertions, 5 deletions
| @@ -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 | ||
| 33 | The value of this extension MUST be a string if present, and represents a cursor the client can use to paginate this query. | 33 | The value of this extension MUST be a string or `null` if present, and represents a cursor the client can use to paginate this query. |
| 34 | If the value is `null`, then it indicates that no more events are available for the given set of filters. | ||
| 34 | To get more events, the client MUST send a `REQ` with the same filters (except limit, which can be changed), and the `cursor` string | 35 | To get more events, the client MUST send a `REQ` with the same filters (except limit, which can be changed), and the `cursor` string |
| 35 | in the 1st filter with the key `cursor`. Example: | 36 | in 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: | |||
| 46 | This 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 | 47 | This 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 |
| 47 | by sending a CLOSED with the prefix `bad-cursor: `. | 48 | by sending a CLOSED with the prefix `bad-cursor: `. |
| 48 | 49 | ||
| 49 | ### `has_more` | 50 | ### `auth_recommended` |
| 50 | `recommended` | ||
| 51 | 51 | ||
| 52 | The value of this extension MUST be a boolean if present, and should represent if the client should continue trying to get events. | 52 | The 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. |
| 53 | This 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). | 53 | This is a less disruptive alternative to `CLOSED` with `auth-required:` for filters that don't explicitly ask for access controlled events, |
| 54 | but may match them. | ||