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

Archivos del votante

Los dos archivos que un votante puede conservar: el recibo de voto y el archivo de clave privada. Su contenido campo por campo, qué se puede verificar con ellos y qué debe mantenerse en secreto.

Ambos se generan en su navegador y solo existen si los descarga: la plataforma no los recibe, no los almacena y nunca los envía. Los dos contienen su clave secreta.

Protocolo v1

Formato común

Las mismas reglas para los dos archivos.

El recibo y el archivo de clave privada siguen las mismas convenciones; los lee y los escribe la biblioteca voter-artifacts del sitio de votación. La validez criptográfica de los valores (suma de verificación, pertenencia a la curva) corresponde a CryptoVote, no al lector del sobre.

  • Un objeto JSON en UTF-8. Cada archivo es un único objeto JSON, escrito en una sola línea y sin espacios. Los ejemplos de esta página están sangrados para facilitar la lectura.
  • La versión, primero. El campo version nombra el sobre y su versión. Un lector debe comprobarla y rechazar cualquier otro valor.
  • Valores con prefijo, nunca hexadecimal suelto. Cada valor criptográfico es la cadena canónica <etiqueta>_<hex>_<suma de verificación> que emite CryptoVote, copiada tal cual. Un valor hexadecimal sin prefijo se rechaza.
  • Una suma de verificación contra las erratas. Son 4 bytes de BLAKE3 (8 caracteres hex), con la etiqueta incluida en el cálculo: un valor mal copiado, o un pk_ pegado en lugar de un ki_, se detecta al instante. No es una garantía de seguridad: la autenticidad procede únicamente de la firma de anillo.
  • Campos desconocidos, ignorados. Un lector debe ignorar los campos que no conoce, para seguir siendo compatible con una evolución del formato; no los vuelve a escribir.

Las etiquetas

pk_ 32 bytes · 64 caracteres hex
Clave pública: la que figura en el anillo.
sk_ 32 bytes · 64 caracteres hex
Clave secreta: la que firma. Nunca debe divulgarse.
ki_ 32 bytes · 64 caracteres hex
Imagen de clave (key image): el identificador público de una papeleta, propio de una elección.
ring_ 32 bytes · 64 caracteres hex
Huella del anillo: la huella canónica del conjunto de claves de un anillo, independiente de su orden.
blsag_ 32 × (1 + tamaño del anillo) bytes
Firma de anillo bLSAG: 38 464 caracteres hex para un anillo de 600 claves.
Recibo de voto · .condorcet_receipt

El recibo, entregado una vez aceptada la papeleta.

Su copia personal de la papeleta que ha emitido, del anillo (llamado «mesa electoral virtual» en la interfaz) con el que la firmó y de la clave que la firmó: lo necesario para encontrar y verificar usted mismo su papeleta en el registro público.

Cuándo y en manos de quién

  • Solo tras la aceptación. El recibo solo aparece en la página de votación cuando el servidor ha aceptado su papeleta. Se muestra una sola vez; descargarlo es opcional.
  • Generado en su navegador. La página lo compone a partir de la clave secreta que sigue en memoria desde la firma. Nunca se envía por correo electrónico (el correo de confirmación solo acredita su participación) y la plataforma nunca lo almacena.
  • Imposible de volver a emitir. La plataforma ya no tiene su clave secreta, así que no puede reconstruir el recibo. En la página, los valores sensibles están ocultos tras los botones «Mostrar» y «Copiar»; «Ocultar los detalles definitivamente» los borra de la pantalla, y la clave secreta se borra sola tras un plazo fijo. Copie o descargue el recibo antes.

Para qué sirve

  • Encontrar su papeleta. Introduzca ballot.key_image en la búsqueda del registro público de la elección, incluso antes de su publicación por lotes, y compare la papeleta publicada con signed_payload, byte a byte.
  • Verificar su anillo. Compare ring_digest con la huella que el registro publica para el anillo indicado en ring. Si no coinciden, firmó con un anillo distinto del publicado.
  • Verificar su línea de participación. voter_id designa su línea en el registro de participación: número de distribuciones de clave e indicación «ha votado».
  • Volver a verificar la firma sin conexión. Bastan signed_payload, signature, el identificador de la elección y las claves públicas del anillo para volver a verificar la firma, sin la plataforma.
  • Generar una prueba de voto. La herramienta «Prueba de voto» lee el recibo y toma de él la clave secreta, la elección y la imagen de clave.
version cadena
Siempre condorcet-receipt/1.
election UUID
El identificador de la elección, parámetro de la firma. Se acepta en mayúsculas al leerlo y siempre se reescribe en minúsculas.
ring cadena no vacía
El identificador (UUID) del anillo con el que se firmó la papeleta, tal como se publica en el registro.
ring_digest ring_…
La huella de ese anillo, calculada por su navegador a partir de las claves que recibió. El servidor nunca la proporciona: un valor enviado junto con el anillo podría ajustarse a él.
voter_id UUID
Su ID de votante, el único identificador publicado que le concierne.
public_key pk_…
Su clave pública, miembro del anillo ring.
secret_key sk_…
Su clave secreta, la que firmó la papeleta.
ballot.signed_payload cadena (JSON)
El payload firmado, byte a byte: la misma cadena que se firmó y se envió al servidor. Debe tratarse como una cadena opaca; analizarla y volver a codificarla rompería la comparación con el registro.
ballot.signature blsag_…
La firma de anillo de la papeleta.
ballot.key_image ki_…
La imagen de clave de la papeleta, propia de esta elección: el identificador público de su papeleta en el registro.
public/docs/voter-files.example_label · recu-vote-0c2e7e2a.condorcet_receipt
{
    "version": "condorcet-receipt/1",
    "election": "0c2e7e2a-5df3-4c0e-9d2b-3f6a8f0c9e21",
    "ring": "7b1d4f90-2c3a-4e8b-a6d5-91f0e2c47a38",
    "ring_digest": "ring_ffeeddccbbaa99887766554433221100ffeeddccbbaa99887766554433221100_8b7a6f5e",
    "voter_id": "3e9a5c71-8d24-4b6f-b0e3-5a7c19d2f846",
    "public_key": "pk_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef_a1b2c3d4",
    "secret_key": "sk_fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210_d4c3b2a1",
    "ballot": {
        "signed_payload": "{\"v\":1,\"election\":\"0c2e7e2a-5df3-4c0e-9d2b-3f6a8f0c9e21\",\"ballot\":\"Alice > Bob = Chloé\",\"weight\":1}",
        "signature": "blsag_0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b0a1b2c3d4e5f6a7b_e5f6a7b8",
        "key_image": "ki_00112233445566778899aabbccddeeff00112233445566778899aabbccddeeff_5e6f7a8b"
    }
}

Valores ficticios: sumas de verificación no válidas y firma reducida a su longitud mínima. El archivo que se descarga se llama recu-vote- seguido de los 8 primeros caracteres del identificador de la elección.

Clave privada · .condorcet_private_key

El archivo de clave privada, descargado al depositar la clave.

Cuando deposita usted mismo su clave, el par de claves se genera en su navegador. Este archivo es su copia de seguridad: con él podrá votar.

Cuándo y en manos de quién

  • Al depositar una clave generada. Durante el periodo de depósito de claves de una elección, o de un grupo de elecciones, si decide generar una clave. CryptoVote produce el par en su navegador.
  • Solo sale la clave pública. public_key se envía a la plataforma, que la colocará en un anillo. La clave secreta se muestra una sola vez, con opción de copiarla, y el archivo se genera en su navegador.
  • Sin elección ni grupo. El archivo solo contiene el par de claves: una misma clave puede servir para varias elecciones independientes, porque la imagen de clave se vuelve propia de cada elección en el momento de la firma. Su nombre procede de la propia clave: condorcet-vote- seguido de la suma de verificación de public_key.

Para qué sirve

  • Votar. En la página de votación, pegue la clave sk_… o cargue el archivo: la página deriva de ella la clave pública y comprueba que figura en el anillo que se le ha asignado.
  • Depositar la misma clave en otro lugar. En otro depósito, cargue el archivo: la clave pública se extrae en el navegador y la clave secreta no sale de su dispositivo.
  • Encontrar su papeleta, demostrar su voto. Con la clave secreta y el identificador de una elección, la herramienta «Prueba de voto» recalcula su imagen de clave, incluso sin recibo.
version cadena
Siempre condorcet-private-key/1.
public_key pk_…
La clave pública, la que se transmitió a la plataforma al depositarla.
secret_key sk_…
La clave secreta, generada en su navegador y nunca transmitida.
public/docs/voter-files.example_label · condorcet-vote-a1b2c3d4.condorcet_private_key
{
    "version": "condorcet-private-key/1",
    "public_key": "pk_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef_a1b2c3d4",
    "secret_key": "sk_fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210_d4c3b2a1"
}

Valores ficticios, sumas de verificación no válidas. Ningún campo election ni de grupo: un archivo antiguo con un campo election informativo sigue siendo legible, porque ese campo se ignora.

Secretos

Lo que debe mantenerse en secreto, y por qué.

Los dos archivos contienen su clave secreta. Guárdelos como una contraseña: fuera del alcance de los demás, pero sin perderlos.

Los riesgos, sin rodeos

  • La clave secreta revela su voto. Con ella se puede recalcular su imagen de clave para cualquier elección y, por tanto, encontrar sus papeletas publicadas, de forma retroactiva, en todas las elecciones en las que se haya usado, así como generar en su nombre una prueba de voto.
  • La clave secreta firma. Produce una firma válida en cualquier anillo que contenga su clave pública. La plataforma solo acepta una papeleta a través de su enlace de voto, y solo una por votante.
  • El recibo revela su voto a quien lo lea. Pone su ID de votante junto a su papeleta. Sirve como prueba, por diseño: el protocolo da prioridad a la verificabilidad individual y, por eso, no ofrece resistencia a la coacción. Enséñelo solo a las personas a las que quiera revelar su voto.
  • Una clave perdida es un voto perdido. Una clave depositada no tiene ninguna clave de reserva en el servidor: una vez abierta la elección, perderla equivale a no votar. Mientras el periodo de depósito de claves siga abierto, puede depositar una nueva clave en su lugar para las elecciones cuyos anillos aún no estén constituidos.
  • Un recibo perdido no se vuelve a emitir. Su papeleta sigue contando. Si ha conservado su clave secreta, le basta para recalcular su imagen de clave y encontrar su papeleta.

Lo que la plataforma nunca ve

  • Sus archivos. El recibo y el archivo de clave privada se escriben y se descargan en su navegador; nunca pasan por nuestros servidores.
  • Una clave secreta que usted ha generado. Se genera en su navegador y nunca se transmite. Al cargar un archivo de clave en un depósito, solo se envía su clave pública.
  • Una clave distribuida, después de su voto. En el modo por defecto, la plataforma genera la clave y la conserva cifrada; la borra de su base de datos en el momento de entregársela y, después, de su caché temporal en el momento del voto. Por eso ya no puede reconstruir su recibo.
  • El vínculo entre su clave y su papeleta. Su clave pública figura en el anillo publicado y su papeleta, en el registro público; solo con la clave secreta se pueden relacionar.
Lo que revela una 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.