refine overview section, alter atomic poll tally rules

This commit is contained in:
toadlyBroodle 2023-04-02 12:51:53 +09:00
parent 313ae7c128
commit 0de2196e67

4
69.md
View File

@ -2,7 +2,7 @@
`draft` `optional` `author:toadlyBroodle` `draft` `optional` `author:toadlyBroodle`
A poll note is a [nostr event](01.md) (kind `6969`) for conducting paid polls. A poll presents two or more voting options, which participants my vote on by sending regular [zap events](57.md) which include an additional `poll_option` vote tag. Polls may include multiple recipients which participants may choose from when zapping their votes. Poll results should be blinded, until after users have voted. Polls should specify a `closed_at` time, after which results be unblinded, closed to new votes, and the tally considered final. Polls may specify either `value_maximum` or `value_minimum` satoshi valuations for determining which zaps are included in the tally. Polls may also specify a `consensus_threshold` for assessing the state of consensus. A poll note is a [nostr event](01.md) (kind `6969`) for conducting paid polls. A poll presents two or more voting options, which participants my vote on by sending regular [zap events](57.md) which include an additional `poll_option` vote tag. Polls may include multiple recipients which participants may choose from when zapping their votes. Polls may specify `value_maximum` and `value_minimum` satoshi valuations for determining which zaps are included in the tally. Polls may specify a `consensus_threshold` for assessing the state of consensus. Polls should specify a `closed_at` time, after which results be unblinded, closed to new votes, and the tally considered final.
## Purpose ## Purpose
@ -103,7 +103,7 @@ A tallying client:
* 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 both `value_maximum` and `value_minimum` are specified AND are equal: * if both `value_maximum` and `value_minimum` are specified AND are equal:
* MUST ONLY count 1 zap (the most recent) per participant (to allow for changes to vote choice, while enforcing 1 vote per participant) * MUST ONLY count 1 zap per option, per participant
* if a `closed_at` time is specified, clients: * if a `closed_at` time is specified, clients:
* 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 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 * MUST ONLY tally zaps including a valid `ots` tag indicating a sent time less than or equal to `closed_at` time