Ir al contenido
Condorcet.vote Alpha
← Documentación técnica

Registro público

Lo que cada elección hace público, sea cual sea el medio que lo transporte, y lo que cualquiera puede verificar a partir de ello sin confiar en la plataforma.

El registro es la constancia verificable de la elección. La plataforma actúa como tercero de confianza durante la votación; después, todo lo que ha hecho puede comprobarse solo con el registro publicado. Esta página describe su contenido con independencia de cómo se transporte. La blockchain es solo una de las formas de distribuirlo: la que hace que cualquiera pueda comprobar su integridad y su inmutabilidad.

Protocolo v1

Contenido

Por un lado, quién ha votado; por otro, qué se ha votado.

Una definición y unos anillos (llamados «mesas electorales virtuales» en la interfaz), comunes a toda la elección, y luego dos registros separados a propósito: el registro de participación dice quién ha participado; el registro de papeletas dice qué se ha votado, con su prueba criptográfica y sin rastro de quién ni de cuándo. El resultado se deduce de ellos.

  • Contexto

    Definición de la elección

    Título, organizador, tipo, escaños, candidatos, reglas de la papeleta y opciones de privacidad, bloqueados antes de la primera papeleta.

    En la apertura · bloque configuration

  • Contexto

    Anillos

    La lista completa de las claves públicas autorizadas a firmar, anillo por anillo, con la huella de cada anillo.

    En la apertura y después por cada anillo de emergencia · bloques rings

  • Participación

    Registro de participación

    Una línea por votante, con un identificador aleatorio: si ha votado o no, en qué anillo, cuántas claves ha recibido y con qué peso. Seudonimizado por defecto.

    Al cierre, en una sola instantánea · bloque closure

  • Papeletas

    Papeletas firmadas

    Cada papeleta tal como se firmó, byte a byte, con su firma de anillo y su imagen de clave (key image), sin identidad ni sello de tiempo.

    Durante la votación, por lotes de al menos 600 · bloques votes

  • Cálculo

    Resultado publicado

    La clasificación oficial, con el método y las versiones de cálculo registrados, y las papeletas en formato CEF. Nunca es un bloque: se recalcula.

    Cuando el organizador lo publica · página de resultados

  • Fuera del registro

    Nunca se publica

    Las fechas y horas, el orden de llegada, la correspondencia entre identificador e identidad (salvo con el registro de participación nominativo) y la presentación estética: logotipo, fotos, mensaje de agradecimiento.

    Ni en la página ni en ningún bloque

Definición y anillos

Lo que queda bloqueado antes de la primera papeleta.

La definición se bloquea al lanzar la elección, y cada anillo, al crearse. Ni una ni otros cambian después: cada papeleta se verifica con la definición y el anillo publicados.

Definición de la elección

protocol_version entero
La versión del protocolo, hoy 1, vinculada a la elección para siempre.
election_id UUID v4
El identificador de la elección, que se repite en cada papeleta firmada y en cada verificación de firma.
title, description?, organizer_name cadenas
Contexto informativo publicado en claro, nunca un dato de entrada del escrutinio.
election_type, seats preferential | fptp, entero ≥ 1
Clasificación u opción única; número de escaños, es decir, de candidatos elegidos en las primeras posiciones de la clasificación.
candidates[].label array
Las etiquetas de los candidatos, su único identificador, ordenadas por etiqueta.
ballot_rules objeto
Los parámetros de la papeleta (empates, clasificación parcial, voto en blanco, clasificación completa), de los que una regla documentada deduce las restricciones del escrutinio.
non_anonymous_voting, nominative_participation, weighted_voting booleanos
Las opciones de privacidad y de ponderación, desactivadas por defecto. El voto no anónimo impone el registro de participación nominativo.
max_ring_size, initial_electoral_roll_size enteros
El tamaño máximo de anillo (hoy, 600) y el tamaño del censo electoral en la apertura.

El detalle campo por campo, con voter_access_mode y enrolment_mandatory, figura en la especificación de la blockchain. El método oficial forma parte de ella (campo method): queda fijado antes de la votación, y el resultado se recalcula con él.

Anillos

ring_id UUID
El anillo con el que se firma una papeleta; cada papeleta lo indica.
public_keys[] pk_<64 hex>_<8 hex>
Todas las claves públicas del anillo, sin repeticiones, en orden ascendente, como máximo max_ring_size.
ring_digest ring_<64 hex>_<8 hex>
La huella canónica del conjunto de miembros, independiente del orden, que puede recalcularse a partir de las claves.

El anonimato de una papeleta es exactamente el anillo con el que se firma: si la plataforma entregara a un votante un anillo con un solo miembro distinto, podría reconocer su papeleta. La página de voto calcula la huella a partir del anillo recibido (nunca la recibe de la plataforma), la muestra antes de la firma y la anota en el recibo; el votante la compara con el valor publicado aquí para todos. Es una forma de detección, no de prevención.

Un anillo de emergencia, creado durante la votación si el censo crece, se publica en el momento de su creación. Cada anillo se puede descargar en JSON desde la página del registro, con su huella y sus claves en el mismo orden que en su bloque.

Registro de participación

Quién ha participado, publicado una sola vez.

El registro de participación se publica en una única instantánea, en el bloque de cierre, cuando el censo es definitivo. Durante la votación, la página del registro no muestra nada de él: ninguna línea de participación comparte una ventana de publicación con una papeleta.

Una línea por votante

voter_id UUID v4 aleatorio
El único identificador de la línea; líneas ordenadas por voter_id. Es el mismo en todas las elecciones de un grupo.
key_provisioning_mode server_generated | organizer_imported | voter_enrolled
El origen de la clave: generada por la plataforma, importada por el organizador o depositada por el propio votante.
has_voted booleano
Si ha votado o no.
ring_id UUID o null
El anillo en el que ha votado el votante, o null si no ha votado: el vínculo votante → anillo en el que se basa la comprobación por anillo.
distribution_count entero ≥ 0
El número de claves de voto distribuidas: 3 como máximo por defecto, más solo si el organizador lo concede, y eso queda a la vista. Las distribuciones no se detallan.
weight entero ≥ 1
El peso (milésimas), siempre presente, 1 sin voto ponderado: el valor con el que se comprueba el peso firmado en la papeleta.

El censo de cierre incluye a los votantes añadidos durante la votación: su tamaño menos initial_electoral_roll_size da cuántos son, nunca cuáles. El bloque de cierre lleva también los totales: bloques, papeletas, anillos, votantes y peso emitido.

Registro de participación nominativo: una opción

Está desactivado por defecto; el organizador puede activarlo en el lanzamiento, y los votantes reciben el aviso. El voto no anónimo lo impone. En ese caso, solo las líneas de los votantes que han votado reciben dos campos más.

voter_name cadena
El nombre en claro, tal como lo facilitó el organizador al importar el censo.
email_digest 64 caracteres hex
SHA3-256(election_id ‖ dirección de correo normalizada), en hex minúsculo: una huella propia de la elección.
  • Nunca se nombra a quien se abstiene. Su línea sigue seudonimizada: la opción revela quién ha votado, nunca quién se ha abstenido.
  • Se revela la participación, no la papeleta. Por sí sola, relaciona un nombre con el hecho de haber votado, nunca con una papeleta. Con el voto no anónimo, que incluye el ID de votante en la papeleta firmada, el vínculo pasa a ser papeleta → ID de votante → nombre.
  • Una huella débil, a sabiendas. La sal (election_id) es pública y una dirección de correo se puede adivinar: quien conozca una dirección puede confirmar que su titular ha participado y seguir esa participación de una elección a otra. Es una herramienta para controlar el censo, no una protección, y sigue siendo un dato personal.
Papeletas

Qué se ha votado, sin quién ni cuándo.

Un registro por papeleta, ordenado por imagen de clave: un orden determinista, derivado del contenido y sin relación con el orden de llegada.

Un registro por papeleta

ring_id UUID
El anillo cuyas claves verifican la firma.
payload cadena JSON
El payload firmado, tal cual, byte a byte: versión, elección, contenido del voto, peso y, en el voto no anónimo, el ID de votante.
signature blsag_…
La firma de anillo (bLSAG) del payload.
key_image ki_…
La imagen de clave: una misma clave produce siempre la misma imagen en una elección, sin revelar cuál de las claves del anillo ha firmado.
Especificación de la papeleta firmada
  • Publicación por lotes. Las papeletas se publican por lotes de al menos 600, en una ventana de tiempo aleatoria; un lote demasiado pequeño espera al siguiente. Al cierre se publica todo, y el último lote puede tener menos de 600 papeletas: por eso una elección con menos de 600 votantes publica sus papeletas al cierre.
  • Una sola regla para la página y la cadena. La página del registro y la blockchain leen el mismo indicador, is_chain_published, así que siempre muestran exactamente el mismo conjunto de papeletas. Durante la votación, la página muestra el número de papeletas recibidas pendientes de publicación, sin su contenido.
  • Encontrar la propia papeleta antes de su publicación. La búsqueda por imagen de clave (envío POST, con límite de frecuencia) encuentra también una papeleta recibida pero aún no publicada. Una imagen de clave no se puede adivinar: solo quien tiene el recibo puede enviarla. La lista pública, en cambio, solo muestra las papeletas publicadas.
  • Una página por papeleta publicada. Payload, firma, imagen de clave y huella de su anillo. El identificador de papeleta que muestra la página es un UUID v4 aleatorio y no figura en los bloques.
Calendario

Cuándo aparece cada elemento.

Nada es público antes de la apertura de la votación. A partir de ahí, el registro solo crece hasta el cierre, que lo da por terminado.

Según el estado de la elección

Draft, Enrolment, Opening Preparación
Nada público. En Opening, la definición y los anillos del lanzamiento quedan bloqueados y sellados.
Open Votación abierta
La página del registro está en línea: definición, anillos, papeletas publicadas por lotes, número de papeletas pendientes y búsqueda por imagen de clave. Un anillo de emergencia aparece al crearse. Sin registro de participación.
Closed Votación cerrada
El último lote de papeletas y, después, el bloque de cierre: registro de participación completo y totales. Ningún bloque puede venir después.
Published Resultado publicado
El organizador publica el resultado: página de resultados y descarga CEF.
Archived Archivada
El registro sigue disponible en modo de solo lectura; el resultado ya no se muestra públicamente.
Cancelled Anulada
Se retiran todas las vistas públicas, y la página del registro lo indica. No se emite ningún bloque de cierre: los bloques ya publicados siguen siendo válidos y la cadena se detiene.

El resultado publicado

  • Nunca es un bloque. El resultado se recalcula a partir de la definición y de las papeletas publicadas; no es un dato de la cadena.
  • Método y versiones registrados. El resultado registra el método utilizado, la versión de la biblioteca CondorcetPHP y la versión del contrato de escrutinio, para que un recuento reproduzca exactamente la misma semántica. La página de resultados muestra el método y la versión de la biblioteca.
  • Las papeletas en formato CEF. Se descargan desde la página de resultados. Es una comodidad: el archivo se puede reconstruir solo con el registro, y un verificador puede volver a generarlo para compararlo.
  • Los elegidos. Las primeras posiciones de la clasificación recalculada, tantas como indica seats, y nada más.
Especificación del escrutinio y el recuento
Página y blockchain

Los mismos datos, dos lecturas.

La página del registro es la vista principal de los datos publicados, paginada y con búsqueda; no es inmutable. La blockchain es una forma de distribuir esos mismos datos: archivos JSON encadenados por hash y firmados por la plataforma, que cualquiera puede descargar y conservar. La página la integra como una subsección.

Direcciones públicas de cada elección

/elections/{election}/register
La página del registro: estado de la elección, contadores, registro de participación, anillos, búsqueda, papeletas y blockchain.
POST /elections/{election}/register/lookup
La búsqueda de una papeleta por imagen de clave, con límite de frecuencia; la imagen de clave nunca aparece en una URL.
/elections/{election}/register/ballots/{ballot}
El detalle de una papeleta publicada.
/elections/{election}/register/rings/{ring}/keys
Un anillo en JSON: election_id, ring_id, ring_number, ring_digest, public_keys.
/elections/{election}/results
El resultado, solo en el estado Published.
/elections/{election}/results/ballots.cef
Las papeletas en formato CEF, con la misma condición.
/elections/{election}/chain
El manifiesto de la blockchain, que lleva a cada bloque y a sus archivos sidecar.

Estas direcciones no llevan prefijo de idioma y los motores de búsqueda no las indexan. Existen mientras la elección tiene un registro público, de Open a Archived.

Lo que añade la blockchain

  • Los mismos datos. Cuatro tipos de bloque (configuration, rings, votes, closure) que contienen exactamente lo que describe esta página.
  • La integridad. Cada bloque lleva el hash SHA3-512 del anterior y una firma separada de la plataforma: una modificación retroactiva rompe la cadena para cualquier observador posterior.
  • La inmutabilidad, por verificar. La firma demuestra el origen, no la inmutabilidad: la plataforma tiene su propia clave. Una reescritura se puede detectar gracias a las copias que conservan terceros y al anclaje en Bitcoin mediante OpenTimestamps, que fecha los bytes de cada bloque.
  • Sin API. Archivos estáticos, que se pueden almacenar en caché y archivar, y que cualquiera puede replicar.
Especificación de la blockchain
Comprobaciones

Lo que cualquiera puede comprobar solo con el registro.

Sin confiar en la plataforma, únicamente con los datos publicados.

  1. 1 Cada papeleta está firmada por un miembro de su anillo. Repetir la verificación de la firma de anillo sobre (payload, identificador de la elección, firma, imagen de clave, anillo) para cada papeleta.
  2. 2 Una clave, una papeleta. Todas las imágenes de clave de la elección son distintas: ninguna clave se ha usado dos veces. Como un votante puede haber recibido varias claves, hacen falta las comprobaciones 3 y 4 para llegar a una papeleta por votante.
  3. 3 Ninguna papeleta añadida a un anillo. En cada anillo, el número de papeletas es igual al número de líneas del registro de participación cuyo anillo de voto es ese.
  4. 4 No hay más papeletas que votantes. El total de papeletas no supera el número de líneas has_voted: ese es el límite que importa frente al relleno de urnas. En el voto ponderado, los pesos firmados y los pesos del registro de participación forman el mismo multiconjunto, cuya suma es voted_weight.
  5. 5 El recuento. Serializar los payloads en CEF y escrutarlos con CondorcetPHP o con cualquier implementación de CEF, aplicando las restricciones deducidas de las reglas de la papeleta publicadas: se obtienen la misma clasificación y los mismos recuentos de votos expresados, en blanco y nulos.
  6. 6 Los elegidos. Leer las primeras posiciones de la clasificación recalculada, tantas como indica seats.

Lo que cada votante puede comprobar además

  • Su línea de participación. Con su ID de votante: si ha votado o no y cuántas claves ha recibido. Cualquier actividad inventada a su nombre salta a la vista.
  • Su anillo. La huella del anillo que figura en su recibo, calculada por su navegador, debe ser igual a la que publica el registro.
  • Su papeleta. Con la imagen de clave de su recibo, encuentra su papeleta y verifica su contenido byte a byte, incluso antes de que se publique.

La garantía central es la lista bloqueada de papeletas firmadas: las comprobaciones 1 a 4, más la integridad de la cadena. El recuento es una comprobación cruzada; una diferencia de resultado entre implementaciones sería un fallo de un programa de cálculo, no un fallo de verificabilidad.

Procedimiento de verificación
Límites

Lo que el registro no dice.

Lo que calla por diseño, y lo que no puede demostrar o deja entrever.

Lo que no revela

  • Ninguna fecha ni hora. Ningún registro publicado lleva fecha; las fechas técnicas se quedan en la base de datos.
  • Ningún orden de llegada. Las papeletas se ordenan por imagen de clave, y el registro de participación, por ID de votante: dos claves de ordenación distintas, sin relación con la cronología.
  • Ningún vínculo entre votante y papeleta. El registro de participación solo se publica al cierre, nunca por ventanas: sus líneas no pueden alinearse en el tiempo con las papeletas. Solo el voto no anónimo establece ese vínculo, si así lo decide el organizador.
  • Ninguna identidad, por defecto. Sin registro de participación nominativo ni voto no anónimo, el registro no contiene ningún dato nominativo; la correspondencia entre identificador e identidad solo la conocen la plataforma y el organizador.
  • Ninguna presentación estética. Logotipo, fotos de los candidatos, mensaje de agradecimiento: ni se publican ni entran en ningún hash.

Lo que no puede demostrar o deja ver

  • El momento del voto. Que el servidor no haya observado a un votante mientras votaba: en ese momento, la plataforma es un tercero de confianza.
  • Una participación inventada. Que una línea «ha votado» no se haya fabricado para alguien que no votó: solo ese votante puede comprobarlo.
  • Quién firmó en el anillo. Por construcción.
  • Un orden aproximado. Los bloques votes se suceden: toda papeleta de un bloque se emitió antes de que se sellara el siguiente, con una granularidad de al menos 600 papeletas. Del mismo modo, un anillo de emergencia publicado más tarde indica que sus papeletas son posteriores.
  • Los anillos pequeños y los pesos poco frecuentes. En un anillo en el que solo ha votado un votante, su ID de votante queda vinculado a su papeleta, y su nombre también si el registro de participación es nominativo. El organizador, que conoce el nombre que corresponde a cada ID de votante, puede establecer esa relación sea cual sea el modo de claves. En el voto ponderado anónimo, un peso casi único señala a su votante.
  • Los inscritos sin clave. En una elección en la que cada votante debe depositar su propia clave, un inscrito que no lo ha hecho no puede votar y, por ahora, no aparece en el registro de participación publicado.
  • La inmutabilidad de la página. La página del registro puede cambiar; la inmutabilidad se verifica en la blockchain, en la medida en que terceros hayan conservado copias de ella.

Elija qué mide Condorcet.Vote en sus páginas públicas. Su elección se guarda en este dispositivo y puede cambiarla en cualquier momento.

Imprescindibles Siempre activos

Idioma, tema y conservación de estas opciones.