nostr/nips
1
0
Fork 0
mirror of https://github.com/nostr-protocol/nips.git synced 2025-01-04 13:45:50 -05:00
Code Issues Actions Packages Projects Releases Wiki Activity

require ots tags accompany closed_at tags

Browse Source
This commit is contained in:
toadlyBroodle 2023-03-07 11:48:29 +09:00
parent f435bc80da
commit b8d39fd6c5
1 changed files with 10 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
69.md
View File

@ -23,6 +23,7 @@ A poll event:
* MUST contain a `poll_options` tag, containing a serialized key-value array of vote options, formatted as below * MUST contain a `poll_options` tag, containing a serialized key-value array of vote options, formatted as below
* MUST include at least 2 voting options, each with its own unique description string * MUST include at least 2 voting options, each with its own unique description string
* SHOULD specify a `closed_at` time: * SHOULD specify a `closed_at` time:
* when specified, MUST include a valid [`ots` tag](03.md), proving original poll publishing time
* a `closed_at` value of less than or equal to the `created_at` field indicates a poll SHOULD NOT be closed. * a `closed_at` value of less than or equal to the `created_at` field indicates a poll SHOULD NOT be closed.
* MAY specify a `value_maximum` satoshi value for zapped votes to be included in the tally * MAY specify a `value_maximum` satoshi value for zapped votes to be included in the tally
* MAY specify a `value_minimum` satoshi value for zapped votes to be included in the tally * MAY specify a `value_minimum` satoshi value for zapped votes to be included in the tally
@ -45,6 +46,7 @@ A poll event:
["consensus_threshold", "required percentage to attain consensus <0..100>"], ["consensus_threshold", "required percentage to attain consensus <0..100>"],
["closed_at", "unix timestamp in seconds"], ["closed_at", "unix timestamp in seconds"],
], ],
"ots": <base64-encoded OTS file data>
"content": <primary poll description string>, "content": <primary poll description string>,
"sig": <64-bytes hex of the signature of the sha256 hash of the serialized event data, which is the same as the "id" field> "sig": <64-bytes hex of the signature of the sha256 hash of the serialized event data, which is the same as the "id" field>
} }
@ -61,14 +63,18 @@ The zap request event (kind `9734`):
* MUST include the same primary hosting relay URL in the `p` tag as is specified in the `e` tag * MUST include the same primary hosting relay URL in the `p` tag as is specified in the `e` tag
* MUST include exactly 1 `poll_option` tag * MUST include exactly 1 `poll_option` tag
* MUST reference the vote option by its corresponding integer `n`, chosen from the original poll event's key-value array of predefined `polling_options` * MUST reference the vote option by its corresponding integer `n`, chosen from the original poll event's key-value array of predefined `polling_options`
* MUST include a valid `ots` tag, if the original poll event specifies a `closed_at` time
```json ```json
...
"tags": [ "tags": [
["e", <32-bytes hex of the id of the original poll event>, <primary poll host relay URL>], ["e", <32-bytes hex of the id of the original poll event>, <primary poll host relay URL>],
["p", <32-bytes hex of the key>, <primary poll host relay URL>], ["p", <32-bytes hex of the key>, <primary poll host relay URL>],
["poll_option", "n"], ["poll_option", "n"],
... ...
] ],
"ots": <base64-encoded OTS file data>
...
``` ```
## Poll outcome ## Poll outcome
@ -84,8 +90,9 @@ A tallying client:
* MUST ONLY tally zaps sent to the poller's `p` key * MUST ONLY tally zaps sent to the poller's `p` key
* MUST ONLY include zap amounts less than or equal to `value_maximum`, if specified * MUST ONLY include zap amounts less than or equal to `value_maximum`, if specified
* MUST ONLY include zap amounts greater than or equal to `value_minimum`, if specified * MUST ONLY include zap amounts greater than or equal to `value_minimum`, if specified
* if a valid `closed_at` time is specified, clients: * if a `closed_at` time is specified, clients:
* MUST NOT tally late votes received after `closed_at` time * MUST ONLY tally zaps including a valid `ots` tag indicating a sent time greater than or equal to the original poll event's `ots` time
* MUST ONLY tally zaps including a valid `ots` tag indicating a sent time less than or equal to `closed_at` time
Additionally, a tallying client: Additionally, a tallying client:
* MUST display the distribution percentages, from the tally total, for each vote option tally * MUST display the distribution percentages, from the tally total, for each vote option tally