Přejít na obsah

Vyberte, co smí Condorcet.Vote na svých veřejných stránkách měřit. Nastavení se uloží v tomto zařízení a kdykoli ho můžete změnit.

Nezbytné Vždy zapnuto

Jazyk, motiv a zapamatování tohoto nastavení.

Condorcet.vote Alpha
Technická dokumentace

Blockchain

Vše, co nezávislý ověřovatel potřebuje, aby řetězec hlasování přečetl, zkontroloval a znovu sečetl, aniž by se nás musel na cokoli ptát.

Každé hlasování zveřejňuje svůj registr jako řadu souborů JSON, zřetězených pomocí hashů a podepsaných platformou. Tato stránka formát přesně popisuje: společnou obálku, čtyři typy bloků pole po poli, pravidla na úrovni bajtů a schémata JSON, podle kterých platforma každý blok před zapečetěním ověří. Schémata si můžete stáhnout níže.

Verze je k hlasování natrvalo přiřazena a opakuje se v každém bloku. Změna formátu by znamenala novou verzi s vlastní sadou schémat.

Protokol v1

Ke stažení

Schémata JSON, podle kterých se pečetí.

JSON Schema draft 2020-12, jeden soubor pro každý typ bloku a k tomu obálka podepsaného hlasovacího lístku. Jsou to přesně ty soubory, které platforma používá: žádnou další vlastnost nikdy nepřipustí a každý z nich je dostupný na kanonické URL uvedené v jeho $id.

Obálka

Pět polí v každém bloku.

Bez ohledu na typ začíná každý blok stejnou obálkou, v tomto pořadí. Hash a podpis bloku nikdy nejsou součástí JSON (dokument nemůže obsahovat vlastní hash): přenášejí se vedle něj.

protocol_version celé číslo
Pro tuto verzi vždy 1; ve všech blocích řetězce stejná hodnota.
type řetězec
Jedna z hodnot configuration, rings, votes, closure.
election_id UUID v4, malá písmena
Identifikátor hlasování, ve všech blocích stejný. Je to také parametr election_id každého kruhového podpisu.
block_number celé číslo ≥ 0
Čísluje se průběžně pro každé hlasování, od 0 pro konfigurační blok.
previous_hash null nebo 128 hexadecimálních znaků
SHA3-512 uložených bajtů předchozího bloku, hex malými písmeny; null pouze v bloku 0.
Obálka · block.*.json
{
  "protocol_version": 1,
  "type": "configuration | rings | votes | closure",
  "election_id": "0c2e7e2a-5df3-4c0e-9d2b-3f6a8f0c9e21",
  "block_number": 0,
  "previous_hash": null,
  ...
}
Typy bloků

Pevný průběh od konfigurace po uzavření.

Na začátku konfigurační blok, potom blok kruhů s kruhy vytvořenými při spuštění, jeden blok kruhů pro každý záložní kruh vytvořený během hlasování, bloky s hlasovacími lístky po dávkách a jediný uzavírací blok, kterým řetězec končí. Výsledek nikdy není blokem: vždy se znovu vypočítá ze zveřejněných hlasovacích lístků.

Blok 0 · genesis

configuration · uzamčená definice

Vše, co se po otevření hlasování už nezmění. Vzhled stránky (logo, fotografie, zpráva s poděkováním) je záměrně mimo blok a nehashuje se.

title, description?, organizer_name řetězce
Informativní údaje: podepisují se spolu s blokem, do sčítání ale nikdy nevstupují.
election_type preferential | fptp
Pořadové hlasování (Condorcetovy metody), nebo výběr jedné možnosti.
method Schulze Winning | Schulze Margin | Ranked Pairs Winning | Ranked Pairs Margin | Copeland | Dodgson Quick | FPTP
Závazná metoda: její pořadí tvoří výsledek. Uzavřený seznam, každá hodnota je přesný název metody v knihovně julien-boudry/condorcet. FPTP právě tehdy, když election_type má hodnotu fptp. Řetězec žádný výsledek neobsahuje, ten se touto metodou vždy znovu vypočítá.
seats celé číslo ≥ 1
Počet obsazovaných mandátů.
voter_access_mode řetězec
Ve verzi 1 closed_nominative_list.
enrolment_mandatory logická hodnota
Při true jen klíče vložené samotnými voliči (BYO-only), při false jsou povoleny i klíče vygenerované serverem.
non_anonymous_voting, nominative_participation, weighted_voting logické hodnoty
Tři nastavení soukromí a vážení. Při non_anonymous_voting = true musí být nominative_participation = true (vynucuje to schéma).
adoption_threshold objekt, nepovinný
Jen u hlasování s výběrem jedné možnosti; bez prahu pole chybí. form (percent nebo fraction, podle nastavení organizátora), numerator / denominator (celá čísla, nikdy nekrácená; u procent přesně 100), comparison (at_least nebo more_than), base (expressed nebo electoral_roll). Kandidát je zvolen, jen pokud score × denominator ≥ numerator × base (> u more_than). Výpočet je přesný, v celých číslech a bez zaokrouhlování.
max_ring_size celé číslo ≥ 1
Maximální velikost kruhu v tomto hlasování: žádný kruh ji nepřekročí a každý záložní kruh má přesně tuto velikost.
initial_electoral_roll_size celé číslo ≥ 0
Velikost seznamu voličů při otevření. Během hlasování lze voliče přidávat; seznam v uzavíracím bloku uvádí konečnou velikost. Počet přidaných voličů je tedy veřejný, ale nikdy ne to, o koho jde.
ballot_rules objekt
ties_allowed, partial_ranking_allowed, blank_allowed, full_ranking_required: parametry hlasovacího lístku, z nichž se deterministicky odvozují omezení pro sčítání.
candidates[].label pole 2 až 30 objektů
Jedinečné popisky o délce 1 až 64 znaků, seřazené podle popisku (pořadí bajtů). Popisek je jediným identifikátorem kandidáta.
Blok 1 · pak jeden pro každý záložní kruh

rings · klíče oprávněné podepisovat

Úplný seznam veřejných klíčů každého kruhu. Blok 1 obsahuje kruhy vytvořené při spuštění; každý pozdější blok kruhů obsahuje jeden záložní kruh, což plyne z jeho pozice. Jakmile je množina členů kruhu zveřejněna, je natrvalo uzamčena.

rings[].ring_id UUID
Identifikátor kruhu, na který odkazuje každý hlasovací lístek podepsaný v tomto kruhu; kruhy jsou seřazeny podle ring_id.
rings[].ring_digest ring_<64 hex>_<8 hex>
Kanonický hash cryptoVote množiny členů kruhu, nezávislý na pořadí. Dá se odvodit z public_keys a ověřovatel ho přepočítá. Zveřejňuje se proto, aby ho volič mohl porovnat s hashem, který jeho prohlížeč vypočítal z obdrženého kruhu.
rings[].public_keys[] pk_<64 hex>_<8 hex>
Veřejné klíče s prefixem a kontrolním součtem, seřazené vzestupně, jedinečné; v jednom kruhu nejvýše max_ring_size.

Kruhy vytvořené při spuštění mají v daném hlasování všechny stejnou velikost (mezi spodní hranicí 100 klíčů a maximem); záložní kruhy mají přesně maximální velikost. Kruhy hlasování v režimu BYO-only obsahují voliče, kteří klíč vložili, rovnoměrně rozdělené.

Další bloky · po dávkách

votes · podepsané hlasovací lístky

Hlasovací lístky se zveřejňují v dávkách po nejméně 600 kusech (zbytek při ukončení hlasování), nikdy jednotlivě. V každém bloku jsou seřazeny podle obrazu klíče, bez časového razítka a bez pořadí doručení.

ballots[].ring_id UUID
Kruh, podle jehož veřejných klíčů se podpis ověřuje.
ballots[].key_image ki_<64 hex>_<8 hex>
Obraz klíče vázaný na hlasování, v daném hlasování jedinečný. Druhý hlasovací lístek se stejným obrazem klíče znamená dvojí hlasování, které je veřejně patrné. Podle obrazu klíče se blok řadí.
ballots[].signature blsag_…
Propojitelný kruhový podpis (varianta bLSAG nad Ristretto255) nad přesnými bajty podepsaných dat.
ballots[].payload řetězec (neprůhledný JSON)
Podepsaný dokument v nezměněné podobě: {"v":1,"election":"…","ballot":"A>B=C","weight":1[,"voter":"…"]}. Nikdy se znovu neserializuje (viz schéma podepsaných dat).

Pole ballot je prostý řetězec v syntaxi pořadí CEF (nebo speciální hodnota /EMPTY_RANKING/). Jeho obsah se záměrně neověřuje: chybně zapsaný hlasovací lístek se při sčítání podle zveřejněného a reprodukovatelného pravidla započítá jako neplatný.

Poslední blok · zakončení

closure · součty a prezenční listina

Právě jeden, poslední, nic za ním. Kdo má podepsaný uzavírací blok, má důkaz, že řetězec je úplný. Prezenční listina se tu objeví jen jednou a nikdy během hlasování.

totals objekt celých čísel
block_count, ballot_count, ring_count, voted_count, voted_weight; lze je porovnat se samotným řetězcem.
electoral_roll[].voter_id UUID v4
Zveřejněné ID voliče (náhodný pseudonym). Seznam voličů při ukončení hlasování, seřazený podle voter_id, jeden řádek na voliče, žádný není označen jako přidaný.
electoral_roll[].key_provisioning_mode řetězec
server_generated, organizer_imported nebo voter_enrolled. Zda platforma někdy měla klíč tohoto voliče, je tak veřejně známo.
electoral_roll[].ring_id UUID nebo null
Kruh, ve kterém volič hlasoval; null, pokud nehlasoval. Ověřitelné propojení volič → kruh.
electoral_roll[].distribution_count celé číslo ≥ 0
Počet klíčů vydaných voliči (ve výchozím nastavení nejvýše 3; další klíče povolené organizátorem zůstávají viditelné).
electoral_roll[].has_voted, weight logická hodnota, celé číslo ≥ 1
Příznak účasti a závazná váha hlasovacího lístku (1, pokud není zapnuto weighted_voting).
electoral_roll[].voter_name, email_digest řetězce, nepovinné
Jen u jmenné prezenční listiny a jen u voličů, kteří hlasovali: jméno v čitelné podobě a SHA3-256(election_id ‖ normalizovaný e-mail).
Serializace

Závazné jsou bajty.

  • Uloženo = doručeno = podepsáno. Soubor bloku se zapíše jednou a nikdy se znovu neserializuje. Žádný krok kanonizace JSON neexistuje: hashuje a podepisuje se soubor přesně tak, jak se doručuje.
  • JSON v UTF-8, jedna položka na řádek. Vnější objekt je odsazený; každá položka velkých kolekcí (candidates, rings, ballots, electoral_roll) je kompaktní objekt na vlastním řádku. Lomítka a znaky Unicode se neescapují.
  • Deterministické řazení podle bajtů. candidates podle label, public_keys vzestupně, ballots podle key_image, electoral_roll podle voter_id, rings podle ring_id. Prosté porovnání bajtů, nikdy jazykové řazení.
  • Jen celá čísla, žádná časová razítka. protocol_version, block_number, seats, velikosti a součty jsou nezáporná celá čísla; všechny ostatní hodnoty jsou řetězce. Žádný blok nenese datum a žádný hlasovací lístek pořadí doručení.
  • Žádné další vlastnosti, žádné duplicitní klíče. Každé schéma zakazuje neznámá pole. Ověřovatel musí odmítnout blok, jehož JSON obsahuje některý klíč dvakrát, protože parsery se liší v tom, kterou hodnotu použijí.
Integrita

Hash, podpis, časové razítko.

  • Zřetězení SHA3-512. Hash bloku je SHA3-512 jeho uložených bajtů, 128 hexadecimálních znaků malými písmeny; je to previous_hash následujícího bloku. Přepočítáte ho příkazem openssl dgst -sha3-512.
  • Oddělený podpis OpenPGP v6. Přesné bajty každého bloku podepisuje klíč Ed25519 platformy (RFC 9580); oddělený podpis ASCII-armored je v souboru .sig. Čas vytvoření podpisu je signed_at bloku; notace domain@condorcet.vote = chain-block/v1 brání jeho opětovnému použití pro jiný druh artefaktu.
  • Obměna klíčů zůstává ověřitelná. Vyřazené certifikáty zůstávají zveřejněné i s datem vypršení platnosti. Standardní pravidla platnosti OpenPGP přijmou bloky podepsané v době platnosti klíče a ostatní odmítnou.
  • Ukotvení přes OpenTimestamps. Prostý hash SHA-256 každého bloku se ukotví v blockchainu Bitcoinu. Soubor .ots se doručuje ve stavu pending nebo completed a ověří se offline běžnými nástroji.
  • Soubory, které se samy identifikují. Názvy uložených artefaktů obsahují identifikátor hlasování ({election}_{n}.json a doprovodné soubory), takže zrcadlený soubor lze přiřadit i bez jeho URL.
Časová razítka OpenTimestamps podrobně
Endpointy

Prosté soubory, žádné API.

Vše se doručuje jako soubory, které lze ukládat do mezipaměti i zrcadlit, a to na hlavní doméně od otevření hlasování až do jeho archivace. Při zrušení hlasování se jeho registr stáhne.

/elections/{election}/chain
Manifest: seřazený seznam bloků s typem, hashem, signed_at, URL artefaktů a stavem časového razítka.
/elections/{election}/chain/{n}.json
Blok n, přesně uložené bajty.
/elections/{election}/chain/{n}.json.sig
Oddělený podpis OpenPGP (armored) bloku n.
/elections/{election}/chain/{n}.json.ots
Důkaz OpenTimestamps pro blok n, ve stavu pending nebo completed.
/.well-known/blockchain-signing-key
Podpisové certifikáty platformy, aktivní i vyřazené, spojené za sebou (application/pgp-keys).
/schemas/blockchain/block.{type}.schema.json
Schémata JSON popsaná výše, na svých kanonických URL ($id).
Úplný postup ověření, jedna kontrola po druhé