Blockchain

Ce qui ne changera plus une fois le vote ouvert. La présentation cosmétique (logo, photos, message de remerciement) est délibérément hors du bloc, non hachée.

title, description?, organizer_name chaînes

Contexte informatif, signé avec le bloc mais jamais une entrée du dépouillement.

election_type preferential | fptp

Classement (méthodes de Condorcet) ou choix unique. La méthode de Condorcet elle-même est publiée avec le résultat, pas ici.

seats entier ≥ 1

Sièges à pourvoir.

voter_access_mode chaîne

closed_nominative_list en version 1.

enrolment_mandatory booléen

Clés apportées par les votants uniquement (BYO-only) si vrai ; clés générées par le serveur autorisées si faux.

non_anonymous_voting, nominative_participation, weighted_voting booléens

Les trois options de vie privée et de pondération. non_anonymous_voting = true impose nominative_participation = true (imposé par le schéma).

adoption_threshold objet, facultatif

Scrutins à choix unique uniquement, absent s'il n'y en a pas. form (percent ou fraction, tel que réglé par l'organisateur), numerator / denominator (entiers, jamais réduits ; exactement 100 pour un pourcentage), comparison (at_least ou more_than), base (expressed ou electoral_roll). Un candidat n'est élu que si score × denominator ≥ numerator × base (> pour more_than) : un calcul exact en entiers, sans arrondi.

max_ring_size entier ≥ 1

Le plafond de taille d'anneau de cette élection : aucun anneau ne le dépasse, chaque anneau d'urgence fait exactement cette taille.

initial_electoral_roll_size entier ≥ 0

La taille de la liste électorale à l'ouverture. Des votants peuvent être ajoutés pendant le vote ; la liste de clôture donne la taille finale, le nombre d'ajouts est donc public, jamais qui.

ballot_rules objet

ties_allowed, partial_ranking_allowed, blank_allowed, full_ranking_required : les paramètres de bulletin dont les contraintes de dépouillement sont dérivées de façon déterministe.

candidates[].label tableau de 2 à 30 objets

Étiquettes uniques, 1 à 64 caractères, triées par étiquette (ordre des octets). L'étiquette est le seul identifiant de candidat.

La liste complète des clés publiques de chaque anneau. Le bloc 1 porte les anneaux de lancement ; tout bloc d'anneaux ultérieur porte un anneau d'urgence, ce qui se déduit de sa position. L'ensemble des membres d'un anneau est gelé pour toujours une fois publié.

rings[].ring_id UUID

L'identifiant d'anneau référencé par chaque bulletin signé contre lui ; anneaux triés par ring_id.

rings[].ring_digest ring_<64 hexa>_<8 hexa>

L'empreinte cryptoVote canonique de l'ensemble des membres de l'anneau, indépendante de l'ordre. Dérivable de public_keys, un vérificateur la recalcule ; elle est publiée pour qu'un votant puisse la comparer à celle que son navigateur a calculée à partir de l'anneau reçu.

rings[].public_keys[] pk_<64 hexa>_<8 hexa>

Clés publiques préfixées avec somme de contrôle, triées par ordre croissant, uniques ; au plus max_ring_size par anneau.

Les anneaux de lancement partagent une taille unique par élection (entre le plancher de 100 clés et le plafond) ; les anneaux d'urgence font exactement le plafond ; les anneaux d'une élection BYO-only contiennent ses inscrits, répartis équitablement.

Les bulletins sont publiés par lots d'au moins 600 (le reliquat à la clôture), jamais un par un, et triés par image de clé au sein de chaque bloc, sans horodatage ni ordre d'arrivée.

ballots[].ring_id UUID

L'anneau dont les clés publiques permettent de vérifier la signature.

ballots[].key_image ki_<64 hexa>_<8 hexa>

L'image de clé à portée d'élection : unique par élection. Un second bulletin avec la même image est un double vote, publiquement manifeste. Clé de tri du bloc.

ballots[].signature blsag_…

La signature en anneau chaînable (variante bLSAG sur Ristretto255) sur les octets exacts de la charge utile.

ballots[].payload chaîne (JSON opaque)

Le document signé, tel quel : {"v":1,"election":"…","ballot":"A>B=C","weight":1[,"voter":"…"]}. Jamais re-sérialisé (voir le schéma de la charge utile).

Le champ ballot est une chaîne plate en syntaxe de classement CEF (ou la sentinelle /EMPTY_RANKING/). Son contenu n'est délibérément pas validé : une expression malformée est classée bulletin nul au dépouillement selon une règle publiée et reproductible.

Exactement un, le dernier, rien après lui. Détenir le bloc de clôture signé est la preuve qu'une chaîne est complète. Le registre d'émargement y apparaît une seule fois, jamais pendant le vote.

totals objet d'entiers

block_count, ballot_count, ring_count, voted_count, voted_weight, recoupables avec la chaîne elle-même.

electoral_roll[].voter_id UUID v4

L'identifiant de vote publié (un pseudonyme aléatoire) ; la liste à la clôture, triée par voter_id, une ligne par votant, aucune marquée comme ajoutée.

electoral_roll[].key_provisioning_mode chaîne

server_generated, organizer_imported ou voter_enrolled. Savoir si la plateforme a un jour détenu la clé de ce votant est un fait public.

electoral_roll[].ring_id UUID ou null

L'anneau dans lequel le votant a voté ; null s'il n'a pas voté. Le lien vérifiable votant → anneau.

electoral_roll[].distribution_count entier ≥ 0

Le nombre de clés distribuées au votant (3 au plus par défaut ; les rallonges accordées par l'organisateur restent visibles).

electoral_roll[].has_voted, weight booléen, entier ≥ 1

Drapeau de participation et poids de bulletin faisant autorité (1 sauf weighted_voting).

electoral_roll[].voter_name, email_digest chaînes, optionnelles

Divulgation nominative seulement, sur les votants ayant voté : nom en clair et SHA3-256(election_id ‖ e-mail normalisé).