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

Prueba de voto

Demostrar que una papeleta publicada es propia sin revelar la clave secreta, pero sí el voto: la operación D de cryptoVote y el sobre cvproof/1 que la transporta.

Esta página especifica la prueba de voto de las herramientas públicas: lo que establece, quién puede generarla, el desarrollo con nonce, el sobre que se intercambia, campo por campo, y su verificación. Es deliberadamente explícita sobre sus consecuencias: entregar una prueba es divulgar el voto, de forma verificable por cualquiera y sin vuelta atrás.

Protocolo v1

Lo que establece

Esta imagen de clave es mía.

Una papeleta publicada lleva una imagen de clave (key image) propia de la elección, nunca una identidad. La prueba vincula esa imagen de clave a una clave pública y, por tanto, a quien tiene la clave secreta correspondiente.

  • Una prueba de Chaum–Pedersen. Prueba no interactiva de igualdad de logaritmos discretos: el probador conoce un mismo escalar x tal que la clave pública es P = x·G y la imagen de clave es I = x·B, donde B es la base propia de la elección. No se revela nada más sobre x.
  • La clave secreta sigue siendo secreta. La prueba no contiene la clave secreta ni sirve para reconstruirla; entregarla no supone ceder la clave.
  • Vinculada a una elección y a un nonce. El UUID de la elección fija la base B y el nonce se integra en el desafío: una prueba solo vale para esa elección y ese nonce.
  • Revela el voto. Cotejada con el registro, la prueba significa: el titular de esta clave emitió esta papeleta publicada, cuya clasificación está en claro. Demostrar la posesión de una imagen de clave es divulgar, de forma demostrable, cómo se ha votado.
Enunciado demostrado · operación D
∃ x :  P = x·G  y  I = x·B
B = H_p(domain ‖ len(election_id) ‖ election_id ‖ P)

Ristretto255, Blake2b-512. B es la base de la que la papeleta obtiene su imagen de clave: la misma clave secreta da una imagen de clave distinta en cada elección.

La imagen de clave en la papeleta firmada
Quién la genera

El titular de la clave, y nadie más.

Para generar una prueba hace falta la clave secreta del votante. Por tanto, nadie puede demostrar la papeleta de un votante en su lugar ni contra su voluntad.

  • Por iniciativa propia. La prueba es un acto voluntario del votante, posterior a la votación. Ninguna etapa de la elección la desencadena ni la exige.
  • Fuera del control del organizador. Es una propiedad de la criptografía, no un ajuste de la plataforma: ningún interruptor la activa ni la prohíbe, y el organizador no puede impedirla ni generarla.
  • La clave procede del recibo. La clave secreta sk_… y la imagen de clave ki_… de la papeleta figuran en el recibo de voto .condorcet_receipt, que la herramienta lee directamente. Ese recibo solo se entrega una vez y nunca se vuelve a emitir.
  • Nada pasa por la plataforma. La plataforma nunca lee, escribe ni almacena el sobre: circula entre el votante y el solicitante, por el canal que ellos elijan.
Caso de uso

El voto por delegación.

La necesidad que motiva la operación D: un votante, o un mandatario que ha votado en nombre de un tercero, demuestra a posteriori qué se votó en una papeleta.

El recibo de voto, campo por campo
Desarrollo

Quién hace qué, y en qué orden.

Tres roles, tres llamadas a cryptoVote. El nonce lo genera quien solicita la prueba, nunca el votante.

  1. 1 Solicitante Genera un nonce aleatorio nuevo (generate_nonce_wasm, que devuelve nonce_…) y se lo transmite al votante, fuera de la plataforma. Un nonce nuevo para cada solicitud.
  2. 2 Votante Introduce su clave secreta sk_…, el UUID de la elección, la imagen de clave ki_… de su papeleta (o carga su recibo) y el nonce recibido. La herramienta calcula prove_ownership_wasm(secret, election, nonce), que devuelve own_…, deriva la clave pública pk_… y compone el sobre cvproof/1.
  3. 3 Votante Lee la advertencia (la prueba revela su voto a quien la recibe, y este puede a su vez convencer a otros) y después entrega el sobre, voluntariamente. Su clave secreta no ha salido de su navegador.
  4. 4 Solicitante o cualquiera Verifica la prueba (verify_ownership_wasm) y después busca la imagen de clave en el registro publicado de la elección para leer la papeleta correspondiente.

Frescura, no intransferibilidad.

El nonce se integra en el desafío de la prueba: no se puede precalcular ni reutilizar con otro nonce, lo que garantiza al solicitante que se ha generado para su solicitud. Pero sigue siendo verificable públicamente: quien tenga el par (nonce, prueba) puede convencer a cualquier otra persona. No es una prueba de verificador designado, y nada restringe su alcance al solicitante.

Sobre

cvproof/1, seis campos.

Un solo objeto JSON en UTF-8, único formato de intercambio que producen o aceptan las herramientas. Solo concierne al votante y al solicitante: ningún analizador en el servidor, ningún almacenamiento.

version cadena literal
Exactamente cvproof/1; cualquier otro valor se rechaza.
election UUID
El UUID de la elección, el mismo valor que se pasa a las llamadas WASM. Se acepta con mayúsculas y minúsculas mezcladas y se pasa a minúsculas, su forma canónica.
public_key pk_<64 hex>_<8 hex>
La clave pública P, derivada de la clave secreta por la herramienta del votante.
key_image ki_<64 hex>_<8 hex>
La imagen de clave I propia de la elección: la de la papeleta publicada cuya posesión se demuestra.
nonce nonce_<64 hex>_<8 hex>
El nonce emitido por el solicitante, copiado tal cual.
proof own_<128 hex>_<8 hex>
La salida de prove_ownership_wasm (64 bytes), copiada tal cual.
Ejemplo · cvproof/1
{
    "version": "cvproof/1",
    "election": "1f0c9b6e-4d2a-4c8e-9b7a-3e5f6a7b8c9d",
    "public_key": "pk_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef_a1b2c3d4",
    "key_image": "ki_fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210_0badc0de",
    "nonce": "nonce_00112233445566778899aabbccddeeff00112233445566778899aabbccddeeff_5eed5eed",
    "proof": "own_0f1e2d3c4b5a69780f1e2d3c4b5a69780f1e2d3c4b5a69780f1e2d3c4b5a69780f1e2d3c4b5a69780f1e2d3c4b5a69780f1e2d3c4b5a69780f1e2d3c4b5a6978_c0ffee00"
}

Valores ilustrativos: formas y longitudes exactas, pero patrones y sumas de verificación ficticios. Este sobre no supera la verificación.

  • Cadenas canónicas con prefijo. public_key, key_image, nonce y proof son las cadenas <etiqueta>_<hex>_<suma de verificación> que emite cryptoVote: hexadecimal en minúsculas de bytes enteros y una suma de verificación de 4 bytes (8 hex). Se transportan tal cual y se pasan sin transformar a verify_ownership_wasm; el hexadecimal sin prefijo se rechaza.
  • El orden de los campos no importa. Es un objeto JSON: el lector lee por clave. La herramienta escribe los campos en el orden de la tabla anterior.
  • Claves desconocidas, ignoradas. Un lector DEBE ignorar las claves que no conoce, para seguir siendo compatible con versiones futuras; la herramienta las descarta al leer.
  • El formato antes que la criptografía. version y los prefijos se validan antes de cualquier llamada criptográfica. La suma de verificación protege de las erratas, nunca de la falsificación: la autenticidad solo depende de la prueba.
Verificación

Válida, y después vinculada al registro.

El procedimiento para quien recibe un sobre. Una prueba válida, por sí sola, dice: esta clave pública posee esta imagen de clave. Solo el cotejo con el registro la convierte en: este votante emitió esta papeleta publicada.

  1. 1 Leer la entrada como un objeto JSON; rechazar un JSON no válido o cualquier otro tipo (array, valor simple, null).
  2. 2 Exigir que version sea igual a cvproof/1.
  3. 3 Exigir un UUID en election y pasarlo a minúsculas.
  4. 4 Exigir public_key con pk_, key_image con ki_, nonce con nonce_ y proof con own_, cada uno en su forma canónica y con su longitud exacta; ignorar las claves desconocidas.
  5. 5 Comparar nonce con el que usted emitió: la frescura solo está garantizada si es el suyo.
  6. 6 Llamar a verify_ownership_wasm(public_key, key_image, election, nonce, proof) y continuar solo si devuelve true.
  7. 7 Buscar key_image entre las papeletas de la elección y leer la papeleta encontrada: su clasificación es el voto demostrado.

Resultado de la búsqueda en el registro

published
La papeleta está publicada en la cadena de la elección; la herramienta muestra su contenido.
pending
Se ha recibido una papeleta correspondiente, pero está pendiente de publicación en un lote: su contenido aún no se puede leer, así que hay que repetir la verificación después del cierre.
not_found
Ninguna papeleta de esta elección lleva esta imagen de clave: la prueba, aunque sea válida, no corresponde a ningún voto, y la herramienta lo indica.
Límites

Lo que no aporta.

La prueba estandariza un recibo que ya era demostrable. No es una función de privacidad, y sus efectos son definitivos.

  • Ninguna resistencia a la coacción. El votante ya tiene su clave secreta y su imagen de clave: antes de la operación D ya existía un recibo demostrable, y esta se limita a estandarizarlo. No añade ni quita resistencia a la coacción, en coherencia con la decisión asumida de ofrecer recibos verificables en lugar de no emitir ninguno (receipt-freeness).
  • Ningún destinatario exclusivo. La prueba es transferible: el solicitante puede mostrarla a terceros, que la verificarán igual que él. No puede ser «solo para él».
  • Sin vuelta atrás. Un sobre entregado no se puede recuperar: quien lo tenga puede verificarlo y mostrarlo, sin límite de tiempo.
  • Ninguna identidad civil. La prueba establece la posesión de una clave secreta, no la identidad de una persona: el sobre no contiene ID de votante ni nombre. El vínculo entre la clave y una persona depende del contexto del intercambio.
Herramienta pública

Todo ocurre en el navegador.

Las herramientas públicas de prueba de voto implementan esta especificación: generar un nonce, demostrar el propio voto y verificar una prueba. Sin cuenta ni configuración, están siempre disponibles; en la práctica, la verificación supone una elección cerrada con el registro publicado, aunque la criptografía no depende del ciclo de vida de la elección.

  • Cálculo local. El nonce, la prueba y la verificación se calculan en el navegador con @condorcet.vote/crypto-vote, sin ida y vuelta con un servidor.
  • La clave secreta no sale del navegador. Se introduce y se usa localmente, nunca se envía a un servidor. No se conserva nada más allá de la página: ni clave, ni nonce, ni prueba.
  • Una sola petición, con valores públicos. El cotejo con el registro consulta un punto de acceso de búsqueda del mismo host con el UUID de la elección y la imagen de clave, dos valores públicos. No se le envía la prueba, ni el nonce, ni ningún secreto.
  • La postura de la página de votación. Página autónoma, sin Livewire, con la política CSP más estricta (solo recursos del propio dominio); el módulo WASM se comprueba con su hash de integridad al cargarse.
Abrir las herramientas de prueba de voto

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.