mirror of
https://github.com/nostr-protocol/nips.git
synced 2024-11-09 22:09:06 -05:00
Document multiple queries in a COUNT request
This commit is contained in:
parent
bc9d469c20
commit
535cfcc7e5
8
45.md
8
45.md
|
@ -14,13 +14,13 @@ Some queries a client may want to execute against connected relays are prohibiti
|
||||||
|
|
||||||
## Filters and return values
|
## Filters and return values
|
||||||
|
|
||||||
This NIP defines a verb called `COUNT`, which accepts a subscription id and filters as specified in [NIP 01](01.md).
|
This NIP defines the verb `COUNT`, which accepts a subscription id and filters as specified in [NIP 01](01.md).
|
||||||
|
|
||||||
```
|
```
|
||||||
["COUNT", <subscription_id>, <filters JSON>...]
|
["COUNT", <subscription_id>, <filters JSON>...]
|
||||||
```
|
```
|
||||||
|
|
||||||
Counts are returned using a `COUNT` response in the form `{count: <integer>}`. Relays may use probabilistic counts to reduce compute requirements.
|
Counts are returned using a `COUNT` response with positional "count" objects in the form `{"count": <integer>}`. Relays may use probabilistic counts to reduce compute requirements.
|
||||||
|
|
||||||
```
|
```
|
||||||
["COUNT", <subscription_id>, {"count": <integer>}]
|
["COUNT", <subscription_id>, {"count": <integer>}]
|
||||||
|
@ -36,4 +36,8 @@ Examples:
|
||||||
# Count posts and reactions
|
# Count posts and reactions
|
||||||
["COUNT", <subscription_id>, {"kinds": [1, 7], "authors": [<pubkey>]}]
|
["COUNT", <subscription_id>, {"kinds": [1, 7], "authors": [<pubkey>]}]
|
||||||
["COUNT", <subscription_id>, {"count": 5}]
|
["COUNT", <subscription_id>, {"count": 5}]
|
||||||
|
|
||||||
|
# Both of the above in one `COUNT`
|
||||||
|
["COUNT", <subscription_id>, {"kinds": [3], "#p": [<pubkey>]}, {"kinds": [1, 7], "authors": [<pubkey>]}]
|
||||||
|
["COUNT", <subscription_id>, {"count": 238}, {"count": 5}]
|
||||||
```
|
```
|
||||||
|
|
Loading…
Reference in New Issue
Block a user