@orangecheck/vote-cli 0.7.4 → 0.7.6

package/README.md

@@ -18,6 +18,8 @@ npx -y @orangecheck/vote-cli tally <poll_id>
 
 Fetch the poll and all ballots from Nostr, verify every BIP-322 signature, look up UTXO state at the declared snapshot block from mempool.space, and run the pure tally function. In an anchored poll (deadline on or after 2026-11-15T00:00:00Z) it also reads every OC Stamp over each ballot and checks each anchor against block headers itself, and says whether the count is final or provisional. Output matches what any conforming implementation produces.
 
+It counts only from a complete ballot read: all but one of the relays asked (4 of the 5 defaults) must finish it, and none may cut its answer short. Otherwise a clock-dated poll's tally says it can't count and exits non-zero, and an anchored poll's count stays provisional and says why.
+
 ```
 $ oc-vote tally 3054390f047f2703186943a41178bc15931500b5139229517f26e56282026ee5
 
@@ -41,12 +43,26 @@ $ oc-vote tally 3054390f047f2703186943a41178bc15931500b5139229517f26e56282026ee5
 
 Flags:
 
-- `--relay wss://...` (repeatable) — custom relay set. Defaults to the canonical four.
+- `--relay wss://...` (repeatable) — custom relay set. Defaults to the five in `@orangecheck/nostr-core`'s `DEFAULT_RELAYS`.
 - `--mempool-base https://...` — UTXO source. Defaults to `https://mempool.space/api`.
 - `--snapshot <height>` — pin a specific snapshot block (overrides `poll.snapshot_block`).
 - `--no-verify` — skip BIP-322 checks (faster, less safe — use only for sanity probes).
 - `--json` — JSON output instead of the human-readable bar chart.
 
+### `oc-vote vote --poll <poll_id> --voter <address> --option <id>`
+
+Build the ballot, have it signed (`--sig`, or paste a BIP-322 signature of the printed ballot_id), publish it, then ask each relay alone for it back. The ballot is in only once at least 2 relays serve a copy whose ballot signature and Nostr signature both hold; an OK from a relay is not enough. Below that it says the ballot isn't in yet, prints the signed event, and exits 2. In an anchored poll its stamp is read back the same way, and `vote` exits 2 while the stamp is on fewer than 2 relays, even with the ballot in: a final count needs the stamp.
+
+- `--json` — `in`, `served_by`, `asked`, `quorum` and the signed `event`.
+
+### `oc-vote create` and `oc-vote reveal`
+
+The same read-back for a poll and a reveal: published only once at least 2 relays serve back a copy that verifies. Below that each says so, prints the signed event, and exits 2. `reveal` run again sends a reveal already signed and on a relay to the relays that lack it, with nothing new to sign.
+
+### `oc-vote republish <file>`
+
+Send a signed poll, ballot, reveal or ballot stamp again, as it is, from an `event:` line or `--json` output. Nothing new is signed, so a poll keeps its id. Same read-back, same exit status: 0 once it is in, 2 while it isn't.
+
 ### `oc-vote verify <poll_id>`
 
 Verify every BIP-322 signature on the poll and on each ballot. Prints a short summary; `--json` gives per-ballot details.