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

Veřejný registr

Co každé hlasování zveřejňuje bez ohledu na to, čím se data přenášejí, a co si z toho kdokoli ověří, aniž by musel platformě důvěřovat.

Registr je ověřitelný záznam hlasování. V okamžiku hlasování je platforma důvěryhodnou třetí stranou; vše, co udělala, lze potom zkontrolovat jen ze zveřejněného registru. Tato stránka popisuje jeho obsah nezávisle na způsobu přenosu: blockchain je jen jedním ze způsobů, jak registr distribuovat; díky němu může integritu a neměnnost registru zkontrolovat kdokoli.

Protokol v1

Obsah

Na jedné straně kdo hlasoval, na druhé jak se hlasovalo.

Definice a kruhy (v rozhraní se jim říká „virtuální volební místnosti“), společné pro celé hlasování, a k nim dva záměrně oddělené záznamy. Prezenční listina říká, kdo se zúčastnil. Registr hlasovacích lístků říká, jak se hlasovalo, včetně kryptografického důkazu, ale bez stopy po tom, kdo a kdy. Výsledek se z nich odvodí.

  • Kontext

    Definice hlasování

    Název, organizátor, typ, mandáty, kandidáti, pravidla hlasovacího lístku a nastavení soukromí, uzamčené před prvním hlasovacím lístkem.

    Při otevření · blok configuration

  • Kontext

    Kruhy

    Úplný seznam veřejných klíčů oprávněných podepisovat, kruh po kruhu, s hashem každého kruhu.

    Při otevření, pak s každým záložním kruhem · bloky rings

  • Strana účasti

    Prezenční listina

    Jeden řádek na voliče pod náhodným identifikátorem: zda hlasoval, v jakém kruhu, kolik klíčů dostal, jakou má váhu. Standardně pseudonymní.

    Při ukončení, jako jediný snímek · blok closure

  • Strana hlasovacích lístků

    Podepsané hlasovací lístky

    Každý hlasovací lístek tak, jak byl podepsán, bajt po bajtu, s kruhovým podpisem a obrazem klíče (key image), bez identity a bez časového razítka.

    Během hlasování, v dávkách po nejméně 600 lístcích · bloky votes

  • Výpočet

    Zveřejněný výsledek

    Konečné pořadí se zaznamenanou metodou a verzemi výpočtu a k tomu hlasovací lístky ve formátu CEF. Výsledek nikdy není blokem: přepočítává se.

    Když ho organizátor zveřejní · stránka výsledků

  • Mimo registr

    Nikdy se nezveřejňuje

    Časová razítka, pořadí příchodu, přiřazení identifikátoru k identitě (kromě jmenné prezenční listiny), kosmetické prvky: logo, fotografie, zpráva s poděkováním.

    Ani na stránce, ani v bloku

Definice a kruhy

Co se uzamkne před prvním hlasovacím lístkem.

Definice se uzamkne při spuštění hlasování, každý kruh při svém vytvoření. Potom se už nemění: každý hlasovací lístek se ověřuje proti zveřejněné definici a zveřejněnému kruhu.

Definice hlasování

protocol_version celé číslo
Verze protokolu, dnes 1, navždy vázaná k hlasování.
election_id UUID v4
Identifikátor hlasování, který se opakuje v každém podepsaném hlasovacím lístku a při každém ověření podpisu.
title, description?, organizer_name řetězce
Informativní kontext zveřejněný v čitelné podobě, nikdy vstup pro sčítání.
election_type, seats preferential | fptp, celé číslo ≥ 1
Pořadí, nebo výběr jedné možnosti; počet mandátů, a tedy kandidátů zvolených z čela pořadí.
candidates[].label pole
Popisky kandidátů, jejich jediný identifikátor, seřazené podle popisku.
ballot_rules objekt
Parametry hlasovacího lístku (stejná místa, neúplné pořadí, prázdný hlasovací lístek, úplné pořadí), z nichž se podle zdokumentovaného pravidla odvodí omezení pro sčítání.
non_anonymous_voting, nominative_participation, weighted_voting logické hodnoty
Nastavení soukromí a vážení, standardně vypnutá. Neanonymní hlasování vyžaduje jmennou prezenční listinu.
max_ring_size, initial_electoral_roll_size celá čísla
Maximální velikost kruhu (dnes 600) a velikost seznamu voličů při otevření.

Podrobný popis pole po poli, včetně voter_access_mode a enrolment_mandatory, najdete ve specifikaci blockchainu. Součástí definice je i závazná metoda sčítání (pole method): stanoví se před hlasováním a výsledek se přepočítává právě s ní.

Kruhy

ring_id UUID
Kruh, vůči kterému je hlasovací lístek podepsán; každý hlasovací lístek ho uvádí.
public_keys[] pk_<64 hex>_<8 hex>
Všechny veřejné klíče kruhu, jedinečné, vzestupně seřazené, nejvýše max_ring_size.
ring_digest ring_<64 hex>_<8 hex>
Kanonický hash množiny členů nezávislý na pořadí, který lze z klíčů přepočítat.

Anonymitu hlasovacího lístku tvoří přesně kruh, pod kterým je podepsán: platforma, která by voliči přidělila kruh lišící se o jediného člena, by mohla jeho hlasovací lístek poznat. Stránka pro hlasování spočítá hash z obdrženého kruhu (od platformy ho nikdy nedostává), zobrazí ho před podpisem a zapíše ho do ověřovacího dokladu; volič ho porovná s hodnotou, která je zde zveřejněna pro všechny. Záměnu kruhu to odhalí, nezabrání jí.

Záložní kruh, vytvořený během hlasování, když se seznam voličů rozroste, se zveřejní hned při vytvoření. Každý kruh lze stáhnout ve formátu JSON ze stránky registru, s hashem a s klíči ve stejném pořadí jako v jeho bloku.

Prezenční listina

Kdo se zúčastnil, zveřejněno jen jednou.

Prezenční listina se zveřejní jako jediný snímek v uzavíracím bloku, až je seznam voličů konečný. Během hlasování z ní stránka registru nic neukazuje: žádný řádek účasti nesdílí časové okno zveřejnění s hlasovacím lístkem.

Jeden řádek na voliče

voter_id náhodné UUID v4
Jediný identifikátor řádku; řádky jsou seřazené podle voter_id. Ve všech hlasováních jedné skupiny je stejný.
key_provisioning_mode server_generated | organizer_imported | voter_enrolled
Původ klíče: vygenerován platformou, importován organizátorem, nebo vložen voličem.
has_voted logická hodnota
Zda volič hlasoval.
ring_id UUID nebo null
Kruh, ve kterém volič hlasoval, nebo null, pokud nehlasoval: vazba volič → kruh, o kterou se opírá kontrola po kruzích.
distribution_count celé číslo ≥ 0
Počet rozdaných hlasovacích klíčů: standardně nejvýše 3, více jen tehdy, když je organizátor povolí, což zůstane viditelné. Jednotlivé distribuce se nerozepisují.
weight celé číslo ≥ 1
Váha (např. spoluvlastnické podíly), vždy přítomná, bez váženého hlasování 1: hodnota, proti které se ověřuje váha podepsaná v hlasovacím lístku.

Konečný seznam zahrnuje i voliče přidané během hlasování: jeho velikost minus initial_electoral_roll_size udává jejich počet, nikdy ne to, o koho jde. Uzavírací blok nese také součty: bloky, hlasovací lístky, kruhy, voliči, vyjádřená váha.

Jmenná prezenční listina: volitelné nastavení

Standardně je vypnutá. Organizátor ji může zapnout při spuštění hlasování a voliči jsou na to upozorněni; neanonymní hlasování ji vyžaduje. Dvě pole navíc pak dostanou jen řádky voličů, kteří hlasovali.

voter_name řetězec
Jméno v čitelné podobě, jak ho organizátor zadal při importu.
email_digest 64 hexadecimálních znaků
SHA3-256(election_id ‖ normalizovaná e-mailová adresa), hex malými písmeny: hash, který je pro každé hlasování jiný.
  • Jména nehlasujících se nikdy neuvádějí. Jejich řádky zůstávají pseudonymní: nastavení prozradí, kdo hlasoval, nikdy ne to, kdo se zdržel.
  • Zveřejnění účasti, ne hlasovacího lístku. Samo o sobě spojuje jméno s tím, že člověk hlasoval, nikdy s hlasovacím lístkem. U neanonymního hlasování, které zapisuje ID voliče do podepsaného hlasovacího lístku, vznikne vazba hlasovací lístek → ID → jméno.
  • Slabý hash, vědomě přijatý. Sůl (election_id) je veřejná a e-mailovou adresu lze uhodnout: kdo adresu zná, může ověřit účast jejího majitele a propojit ji napříč hlasováními. Je to nástroj ke kontrole seznamu voličů, ne ochrana; stále jde o osobní údaj.
Hlasovací lístky

Jak se hlasovalo, bez toho, kdo a kdy.

Jeden záznam na hlasovací lístek, seřazený podle obrazu klíče: deterministické pořadí odvozené z obsahu, které nesouvisí s pořadím příchodu.

Jeden záznam na hlasovací lístek

ring_id UUID
Kruh, jehož klíče ověřují podpis.
payload řetězec JSON
Podepsaná data (payload) v nezměněné podobě, bajt po bajtu: verze, hlasování, výběr na hlasovacím lístku, váha a u neanonymního hlasování ID voliče.
signature blsag_…
Kruhový podpis (bLSAG) podepsaných dat.
key_image ki_…
Obraz klíče: stejný klíč dává v jednom hlasování vždy stejný obraz, aniž by prozradil, který z klíčů kruhu podepsal.
Specifikace podepsaného hlasovacího lístku
  • Zveřejňování po dávkách. Hlasovací lístky se zveřejňují v dávkách po nejméně 600 kusech, v náhodně určeném časovém okně; příliš malá dávka počká na další. Při ukončení hlasování se zveřejní vše a poslední dávka může mít méně než 600 lístků: hlasování s méně než 600 voliči proto zveřejní své hlasovací lístky až při ukončení.
  • Jedno pravidlo pro stránku i řetězec. Stránka registru i blockchain čtou stejný příznak, is_chain_published: vždy ukazují přesně stejnou množinu hlasovacích lístků. Během hlasování stránka ukazuje počet přijatých hlasovacích lístků, které čekají na zveřejnění, bez jejich obsahu.
  • Dohledání vlastního lístku před zveřejněním. Vyhledávání podle obrazu klíče (požadavek POST s omezenou frekvencí) najde i hlasovací lístek, který byl přijat, ale ještě nebyl zveřejněn. Obraz klíče nelze uhodnout: zadat ho může jen držitel ověřovacího dokladu. Veřejný seznam ukazuje jen zveřejněné hlasovací lístky.
  • Stránka pro každý zveřejněný lístek. Podepsaná data, podpis, obraz klíče a hash jeho kruhu. ID hlasovacího lístku, které stránka zobrazuje, je náhodné UUID v4; v blocích se neobjevuje.
Harmonogram

Kdy se která část objeví.

Před zahájením hlasování není veřejné nic. Potom registr už jen roste, až do ukončení hlasování, které ho uzavře.

Podle stavu hlasování

Draft, Enrolment, Opening Příprava
Nic veřejného. Ve stavu Opening se definice a kruhy vytvořené při spuštění uzamknou a zapečetí.
Open Hlasování otevřeno
Stránka registru je online: definice, kruhy, hlasovací lístky zveřejňované po dávkách, počet lístků čekajících na zveřejnění, vyhledávání podle obrazu klíče. Záložní kruh se objeví hned při vytvoření. Prezenční listina zatím ne.
Closed Hlasování ukončeno
Poslední dávka hlasovacích lístků, pak uzavírací blok: úplná prezenční listina a součty. Žádný další blok už po něm následovat nemůže.
Published Výsledek zveřejněn
Organizátor zveřejní výsledek: stránka výsledků a soubor CEF ke stažení.
Archived Archivováno
Registr zůstává dostupný jen ke čtení; výsledek se už veřejně nezobrazuje.
Cancelled Zrušeno
Všechna veřejná zobrazení se stáhnou a stránka registru to oznámí. Uzavírací blok se nevydá: už zveřejněné bloky zůstávají platné a řetězec tím končí.

Zveřejněný výsledek

  • Nikdy blok. Výsledek se přepočítává z definice a ze zveřejněných hlasovacích lístků; nepatří mezi data řetězce.
  • Metoda a verze se zaznamenávají. Výsledek zaznamenává použitou metodu, verzi knihovny CondorcetPHP a verzi kontraktu sčítání, aby přepočítání zopakovalo přesně stejnou sémantiku. Stránka výsledků zobrazuje metodu a verzi knihovny.
  • Hlasovací lístky ve formátu CEF. Ke stažení na stránce výsledků: pomůcka, kterou lze sestavit jen z registru a kterou si ověřovatel může pro porovnání vygenerovat znovu.
  • Zvolení kandidáti. Místa 1 až seats přepočítaného pořadí, nic víc.
Specifikace sčítání a přepočítání
Stránka a blockchain

Stejná data, dvě podoby.

Stránka registru je hlavní zobrazení zveřejněných dat, stránkované a prohledávatelné; neměnná není. Blockchain je jeden ze způsobů, jak tatáž data distribuovat: soubory JSON zřetězené pomocí hashů a podepsané platformou, které si může kdokoli stáhnout a uchovat. Stránka ho obsahuje jako podsekci.

Veřejné adresy každého hlasování

/elections/{election}/register
Stránka registru: stav hlasování, počítadla, prezenční listina, kruhy, vyhledávání, hlasovací lístky, blockchain.
POST /elections/{election}/register/lookup
Vyhledání hlasovacího lístku podle obrazu klíče, s omezenou frekvencí; obraz klíče se nikdy neobjeví v URL.
/elections/{election}/register/ballots/{ballot}
Detail zveřejněného hlasovacího lístku.
/elections/{election}/register/rings/{ring}/keys
Kruh ve formátu JSON: election_id, ring_id, ring_number, ring_digest, public_keys.
/elections/{election}/results
Výsledek, jen ve stavu Published.
/elections/{election}/results/ballots.cef
Hlasovací lístky ve formátu CEF, za stejné podmínky.
/elections/{election}/chain
Manifest blockchainu, který odkazuje na každý blok a jeho doprovodné soubory.

Tyto adresy nemají jazykový prefix a vyhledávače je neindexují. Existují, dokud má hlasování veřejný registr, tedy od stavu Open do stavu Archived.

Co blockchain přidává

  • Stejná data. Čtyři typy bloků (configuration, rings, votes, closure), které nesou přesně obsah popsaný na této stránce.
  • Integrita. Každý blok nese hash SHA3-512 předchozího bloku a oddělený podpis platformy: zpětná úprava přeruší řetězec pro každého pozdějšího pozorovatele.
  • Neměnnost, kterou je třeba ověřit. Podpis dokazuje původ, ne neměnnost: klíč drží platforma. Přepsání odhalí až kopie uchovávané třetími stranami a ukotvení v Bitcoinu přes OpenTimestamps, které datuje bajty každého bloku.
  • Bez API. Statické soubory, které lze ukládat do mezipaměti a archivovat a které si kdokoli může zrcadlit.
Specifikace blockchainu
Kontroly

Co může kdokoli zkontrolovat jen z registru.

Bez důvěry v platformu, jen ze zveřejněných dat.

  1. 1 Každý hlasovací lístek podepsal člen jeho kruhu. U každého hlasovacího lístku zopakovat ověření kruhového podpisu nad n-ticí (podepsaná data, identifikátor hlasování, podpis, obraz klíče, kruh).
  2. 2 Jeden klíč, jeden lístek. Všechny obrazy klíčů v hlasování jsou různé: žádný klíč nebyl použit dvakrát. Volič mohl dostat několik klíčů, takže jeden hlasovací lístek na voliče z toho plyne teprve spolu s kontrolami 3 a 4.
  3. 3 Do žádného kruhu nebyl přidán hlasovací lístek. U každého kruhu se počet hlasovacích lístků rovná počtu řádků prezenční listiny, které jako kruh hlasování uvádějí právě tento kruh.
  4. 4 Hlasovacích lístků není víc než voličů. Celkový počet hlasovacích lístků nepřekročí počet řádků s has_voted: právě tato mez chrání proti vhazování falešných hlasovacích lístků. U váženého hlasování tvoří podepsané váhy a váhy voličů v prezenční listině stejnou multimnožinu se součtem voted_weight.
  5. 5 Přepočítání. Serializovat podepsaná data do formátu CEF a sečíst je knihovnou CondorcetPHP nebo jinou implementací CEF, s omezeními odvozenými ze zveřejněných pravidel hlasovacího lístku: vyjde stejné pořadí i stejné počty vyjádřených, prázdných a neplatných hlasovacích lístků.
  6. 6 Zvolení kandidáti. Přečíst místa 1 až seats přepočítaného pořadí.

Co navíc může zkontrolovat každý volič

  • Svůj řádek prezenční listiny. Podle svého ID voliče: zda hlasoval, kolik klíčů dostal. Vymyšlená aktivita na jeho jméno se ukáže.
  • Svůj kruh. Hash kruhu v jeho ověřovacím dokladu, spočítaný jeho vlastním prohlížečem, se musí rovnat hashi, který zveřejňuje registr.
  • Svůj hlasovací lístek. Podle obrazu klíče z ověřovacího dokladu najde svůj hlasovací lístek a zkontroluje jeho obsah bajt po bajtu, a to i před zveřejněním.

Hlavní zárukou je uzamčený seznam podepsaných hlasovacích lístků: kontroly 1 až 4 a k tomu integrita řetězce. Přepočítání je křížová kontrola; kdyby se výsledky různých implementací lišily, byla by to chyba výpočetního softwaru, ne selhání ověřitelnosti.

Postup ověření
Omezení

Co registr neříká.

Co záměrně zamlčuje, co nemůže prokázat a co z něj lze přesto vyčíst.

Co neprozrazuje

  • Žádná časová razítka. Žádný zveřejněný záznam nenese datum; provozní časové údaje zůstávají v databázi.
  • Žádné pořadí příchodu. Hlasovací lístky jsou seřazené podle obrazu klíče, prezenční listina podle ID voliče: dva různé klíče řazení, které s chronologií nesouvisí.
  • Žádná vazba mezi voličem a hlasovacím lístkem. Prezenční listina se zveřejní až při ukončení hlasování, nikdy po časových oknech: její řádky nelze časově přiřadit k hlasovacím lístkům. Tuto vazbu vytváří jen neanonymní hlasování, a to z rozhodnutí organizátora.
  • Standardně žádná identita. Bez jmenné prezenční listiny a bez neanonymního hlasování neobsahuje registr žádné jmenné údaje; přiřazení identifikátorů k identitám znají jen platforma a organizátor.
  • Žádné kosmetické prvky. Logo, fotografie kandidátů, zpráva s poděkováním: nezveřejňují se ani nehashují.

Co nemůže prokázat a co z něj lze vyčíst

  • Okamžik hlasování. Že server nesledoval voliče během hlasování: v tu chvíli je platforma důvěryhodnou třetí stranou.
  • Vymyšlená účast. Že řádek „Hlas odevzdán“ nebyl vyroben pro nepřítomného voliče: to může zjistit jen ten volič sám.
  • Kdo v kruhu podepsal. Z principu.
  • Hrubé pořadí. Bloky votes jdou za sebou: každý hlasovací lístek v bloku byl odevzdán před zapečetěním dalšího bloku, s přesností nejméně 600 hlasovacích lístků. Záložní kruh zveřejněný později podobně naznačuje, že jeho hlasovací lístky přišly později.
  • Malé kruhy a vzácné váhy. V kruhu, kde hlasoval jediný volič, je jeho identifikátor spojen s jeho hlasovacím lístkem a při jmenné prezenční listině i jeho jméno. Organizátor, který zná jméno za každým identifikátorem, může tyto údaje propojit bez ohledu na způsob přidělení klíčů. U anonymního váženého hlasování prozradí téměř jedinečná váha svého voliče.
  • Voliči v seznamu bez klíče. V hlasování, kde musí voliči vložit vlastní klíč, nemůže volič v seznamu, který žádný klíč nevložil, hlasovat a ve zveřejněné prezenční listině se dnes neobjeví.
  • Neměnnost stránky. Stránka registru se může měnit; neměnnost se ověřuje na blockchainu, a to do té míry, do jaké si jeho kopie uchovaly třetí strany.