Registo público
O que cada eleição torna público, seja qual for o meio que o transporta, e o que qualquer pessoa pode verificar a partir daí sem confiar na plataforma.
O registo é o rasto verificável da eleição. No momento do voto, a plataforma é um terceiro de confiança; depois, tudo o que fez pode ser verificado apenas com o registo publicado. Esta página descreve o seu conteúdo, independentemente do meio de transporte: a blockchain é só uma das formas de o distribuir, aquela com que qualquer pessoa pode verificar a sua integridade e imutabilidade.
Protocolo v1
De um lado, quem votou; do outro, o que foi votado.
Uma definição e anéis (chamados «mesas de voto virtuais» na interface), comuns a toda a eleição, e depois dois registos deliberadamente separados: o registo de participação diz quem participou, o registo dos boletins diz o que foi votado, com a respetiva prova criptográfica e sem rasto de quem votou nem de quando. O resultado deduz-se deles.
-
Contexto
Definição da eleição
Título, organizador, tipo, lugares, candidatos, regras do boletim e opções de privacidade, fixados antes do primeiro boletim.
Na abertura · bloco configuration
-
Contexto
Anéis
A lista completa das chaves públicas autorizadas a assinar, anel a anel, com o resumo de cada anel.
Na abertura e depois a cada anel de emergência · blocos rings
-
Lado da participação
Registo de participação
Uma linha por eleitor, sob um identificador aleatório: se votou ou não, em que anel, quantas chaves recebeu, que peso tem. Pseudonimizado por predefinição.
No encerramento, num único instantâneo · bloco closure
-
Lado dos boletins
Boletins assinados
Cada boletim tal como foi assinado, byte a byte, com a assinatura em anel e a imagem de chave, sem identidade nem data e hora.
Durante a votação, por lotes de pelo menos 600 · blocos votes
-
Cálculo
Resultado publicado
A classificação oficial, com o método e as versões de cálculo registados, e os boletins em formato CEF. Nunca é um bloco: recalcula-se.
Quando o organizador o publica · página de resultados
-
Fora do registo
Nunca publicado
As datas e horas, a ordem de chegada, a correspondência entre identificador e identidade (salvo com registo de participação nominal), a apresentação visual: logótipo, fotografias, mensagem de agradecimento.
Nem na página, nem num bloco
O que fica fixado antes do primeiro boletim.
A definição é fixada no lançamento da eleição; cada anel, no momento em que é criado. Nem uma nem os outros mudam depois: cada boletim verifica-se com a definição e o anel publicados.
Definição da eleição
-
protocol_versioninteiro - A versão do protocolo (atualmente 1), ligada à eleição para sempre.
-
election_idUUID v4 - O identificador da eleição, repetido em cada boletim assinado e em cada verificação de assinatura.
-
title, description?, organizer_namestrings - Contexto informativo publicado em claro, nunca um dado de entrada do apuramento.
-
election_type, seatspreferential | fptp, inteiro ≥ 1 - Classificação ou escolha única; número de lugares, ou seja, de candidatos eleitos a partir do topo da classificação.
-
candidates[].labelarray - As etiquetas dos candidatos, único identificador, ordenadas por etiqueta.
-
ballot_rulesobjeto - Os parâmetros do boletim (empates, classificação parcial, voto em branco, classificação completa), dos quais se deduzem as restrições do apuramento por uma regra documentada.
-
non_anonymous_voting, nominative_participation, weighted_votingbooleanos - As opções de privacidade e de ponderação, desativadas por predefinição. A votação não anónima obriga ao registo de participação nominal.
-
max_ring_size, initial_electoral_roll_sizeinteiros - O tamanho máximo de um anel (atualmente 600) e o tamanho do caderno eleitoral na abertura.
O detalhe campo a campo, incluindo voter_access_mode e enrolment_mandatory, consta da especificação da blockchain. O método oficial faz parte da definição (campo method): fica fixado antes da votação, e o resultado recalcula-se com ele.
Anéis
-
ring_idUUID - O anel com o qual um boletim é assinado; cada boletim indica-o.
-
public_keys[]pk_<64 hex>_<8 hex> - Todas as chaves públicas do anel, únicas, por ordem crescente, no máximo max_ring_size.
-
ring_digestring_<64 hex>_<8 hex> - O resumo canónico do conjunto dos membros, independente da ordem, que se pode recalcular a partir das chaves.
O anonimato de um boletim é exatamente o anel com o qual foi assinado: uma plataforma que entregasse a um eleitor um anel com um único membro diferente poderia reconhecer o boletim desse eleitor. A página de voto calcula o resumo a partir do anel recebido (nunca o recebe da plataforma), mostra-o antes da assinatura e escreve-o no recibo; o eleitor compara-o com o valor aqui publicado para todos. Trata-se de deteção, não de prevenção.
Um anel de emergência, criado durante a votação se o caderno eleitoral crescer, é publicado logo que é criado. Cada anel pode ser descarregado em JSON a partir da página do registo, com o resumo e as chaves pela mesma ordem que no respetivo bloco.
Quem participou, publicado uma única vez.
O registo de participação é publicado num único instantâneo, no bloco de encerramento, quando o caderno eleitoral é definitivo. Durante a votação, a página do registo não mostra nada dele: nenhuma linha de participação partilha um intervalo de publicação com um boletim.
Uma linha por eleitor
-
voter_idUUID v4 aleatório - O único identificador da linha; as linhas são ordenadas por voter_id. É o mesmo em todas as eleições de um mesmo grupo.
-
key_provisioning_modeserver_generated | organizer_imported | voter_enrolled - A origem da chave: gerada pela plataforma, importada pelo organizador ou depositada pelo eleitor.
-
has_votedbooleano - Votou ou não.
-
ring_idUUID ou null - O anel em que o eleitor votou, null se não votou: a ligação eleitor → anel em que assenta a verificação por anel.
-
distribution_countinteiro ≥ 0 - O número de chaves de voto distribuídas: no máximo 3 por predefinição, mais apenas se o organizador as conceder, o que fica visível. As distribuições não são detalhadas.
-
weightinteiro ≥ 1 - O peso (permilagem), sempre presente, 1 sem votação ponderada: o valor com o qual se verifica o peso assinado no boletim.
O caderno eleitoral no encerramento inclui os eleitores adicionados durante a votação: o seu tamanho menos initial_electoral_roll_size dá quantos foram, nunca quais. O bloco de encerramento contém também os totais: blocos, boletins, anéis, eleitores, peso expresso.
Registo de participação nominal: uma opção
Está desativado por predefinição; o organizador pode ativá-lo no lançamento, e os eleitores são avisados. A votação não anónima torna-o obrigatório. Nesse caso, só as linhas dos eleitores que votaram recebem dois campos adicionais.
-
voter_namestring - O nome em claro, tal como o organizador o forneceu na importação.
-
email_digest64 caracteres hex - SHA3-256(election_id ‖ endereço de e-mail normalizado), hex em minúsculas: um resumo próprio da eleição.
- Os abstencionistas nunca são nomeados. A sua linha continua pseudonimizada: a opção revela quem votou, nunca quem se absteve.
- Revela a participação, não o boletim. Por si só, liga um nome ao facto de ter votado, nunca a um boletim. Com a votação não anónima, que inscreve o ID de eleitor no boletim assinado, a ligação passa a ser boletim → identificador → nome.
- Um resumo fraco, assumido. O sal (election_id) é público e um endereço de e-mail adivinha-se: quem tiver um endereço pode confirmar a participação do seu titular e associá-la de uma eleição para outra. É uma ferramenta de controlo do caderno eleitoral, não uma proteção; continua a ser um dado pessoal.
O que foi votado, sem quem nem quando.
Uma entrada por boletim, ordenada por imagem de chave: uma ordem determinística, derivada do conteúdo, sem relação com a ordem de chegada.
Uma entrada por boletim
-
ring_idUUID - O anel cujas chaves verificam a assinatura.
-
payloadstring JSON - O payload assinado, tal e qual, byte a byte: versão, eleição, expressão do boletim, peso e, em votação não anónima, o ID de eleitor.
-
signatureblsag_… - A assinatura em anel (bLSAG) do payload.
-
key_imageki_… - A imagem de chave: uma mesma chave dá sempre a mesma imagem numa eleição, sem revelar qual das chaves do anel assinou.
- Publicação por lotes. Os boletins são publicados por lotes de pelo menos 600, num intervalo de tempo aleatório; um lote demasiado pequeno espera pelo seguinte. Tudo é publicado no encerramento, e o último lote pode ter menos de 600 boletins: uma eleição com menos de 600 eleitores publica, portanto, os seus boletins no encerramento.
- Uma só regra para a página e para a cadeia. A página do registo e a blockchain leem o mesmo indicador, is_chain_published: mostram sempre exatamente o mesmo conjunto de boletins. Durante a votação, a página indica o número de boletins recebidos que aguardam publicação, sem o seu conteúdo.
- Encontrar o seu boletim antes da publicação. A pesquisa por imagem de chave (pedido POST, com limite de frequência) também encontra um boletim recebido mas ainda não publicado. Uma imagem de chave não se adivinha: só quem tem o recibo a pode submeter. Já a lista pública só mostra os boletins publicados.
- Uma página por boletim publicado. Payload, assinatura, imagem de chave e resumo do respetivo anel. O identificador de boletim que a página mostra é um UUID v4 aleatório; não consta dos blocos.
Quando aparece cada elemento.
Nada é público antes da abertura da votação. A partir daí, o registo só cresce, até ao encerramento, que o termina.
Consoante o estado da eleição
-
Draft, Enrolment, OpeningPreparação - Nada é público. Em Opening, a definição e os anéis do lançamento são fixados e selados.
-
OpenVotação aberta - A página do registo está online: definição, anéis, boletins publicados por lotes, número de boletins pendentes, pesquisa por imagem de chave. Um anel de emergência aparece logo que é criado. Sem registo de participação.
-
ClosedVotação encerrada - O último lote de boletins e, depois, o bloco de encerramento: registo de participação completo e totais. Nenhum bloco lhe pode suceder.
-
PublishedResultado publicado - O organizador publica o resultado: página de resultados e ficheiro CEF para descarregar.
-
ArchivedArquivada - O registo continua consultável, só em leitura; o resultado deixa de ser mostrado publicamente.
-
CancelledCancelada - Todas as vistas públicas são retiradas, e a página do registo indica-o. Não é emitido nenhum bloco de encerramento: os blocos já publicados continuam válidos e a cadeia termina aí.
O resultado publicado
- Nunca é um bloco. O resultado recalcula-se a partir da definição e dos boletins publicados; não é um dado da cadeia.
- Método e versões registados. O resultado regista o método utilizado, a versão da biblioteca CondorcetPHP e a versão do contrato de apuramento, para que uma recontagem reproduza exatamente a mesma semântica. A página de resultados mostra o método e a versão da biblioteca.
- Os boletins em formato CEF. Podem ser descarregados a partir da página de resultados: uma comodidade, que se reconstrói só com o registo e que um verificador pode gerar de novo para comparar.
- Os eleitos. As primeiras posições da classificação recalculada, tantas quantas indicar seats, e nada mais.
Os mesmos dados, duas leituras.
A página do registo é a vista principal, paginada e pesquisável, dos dados publicados; não é imutável. A blockchain é uma forma de distribuir esses mesmos dados: ficheiros JSON encadeados por hash e assinados pela plataforma, que qualquer pessoa pode descarregar e guardar. A página integra-a como uma subsecção.
Endereços públicos de cada eleição
- /elections/{election}/register
- A página do registo: estado da eleição, contadores, registo de participação, anéis, pesquisa, boletins, blockchain.
- POST /elections/{election}/register/lookup
- A pesquisa de um boletim por imagem de chave, com limite de frequência; a imagem de chave nunca aparece num URL.
- /elections/{election}/register/ballots/{ballot}
- O detalhe de um boletim publicado.
- /elections/{election}/register/rings/{ring}/keys
- Um anel em JSON: election_id, ring_id, ring_number, ring_digest, public_keys.
- /elections/{election}/results
- O resultado, apenas no estado Published.
- /elections/{election}/results/ballots.cef
- Os boletins em formato CEF, na mesma condição.
- /elections/{election}/chain
- O manifesto da blockchain, que dá acesso a cada bloco e aos respetivos ficheiros complementares.
Estes endereços não têm prefixo de idioma e não são indexados pelos motores de pesquisa. Existem enquanto a eleição tiver um registo público, de Open a Archived.
O que a blockchain acrescenta
- Os mesmos dados. Quatro tipos de blocos (configuration, rings, votes, closure) com exatamente o conteúdo descrito nesta página.
- A integridade. Cada bloco contém o hash SHA3-512 do anterior e uma assinatura destacada da plataforma: uma alteração retroativa quebra a cadeia para qualquer observador posterior.
- A imutabilidade, por verificar. A assinatura prova a origem, não a imutabilidade: a plataforma detém a sua chave. Uma reescrita torna-se detetável graças às cópias guardadas por terceiros e à ancoragem no Bitcoin através do OpenTimestamps, que data os bytes de cada bloco.
- Sem API. Ficheiros estáticos, que qualquer pessoa pode guardar em cache, arquivar e replicar em espelho.
O que qualquer pessoa pode verificar, só com o registo.
Sem confiar na plataforma, apenas com os dados publicados.
- 1 Cada boletim é assinado por um membro do seu anel. Repetir a verificação da assinatura em anel sobre (payload, identificador da eleição, assinatura, imagem de chave, anel) para cada boletim.
- 2 Uma chave, um boletim. Todas as imagens de chave da eleição são distintas: nenhuma chave foi usada duas vezes. Como um eleitor pode ter recebido várias chaves, é em conjunto com as verificações 3 e 4 que isto garante um boletim por eleitor.
- 3 Nenhum boletim acrescentado a um anel. Para cada anel, o número de boletins é igual ao número de linhas do registo de participação cujo anel de voto é esse.
- 4 Não há mais boletins do que votantes. O total de boletins não excede o número de linhas has_voted: é este o limite que conta contra o enchimento das urnas. Em votação ponderada, os pesos assinados e os pesos dos eleitores no registo de participação formam o mesmo multiconjunto, cuja soma é voted_weight.
- 5 A recontagem. Serializar os payloads em CEF e apurá-los com o CondorcetPHP ou com qualquer implementação CEF, com as restrições deduzidas das regras do boletim publicadas: obtêm-se a mesma classificação e as mesmas contagens de expressos, brancos e nulos.
- 6 Os eleitos. Ler as primeiras posições da classificação recalculada, tantas quantas indicar seats.
O que cada eleitor pode verificar, além disso
- A sua linha de participação. Pelo seu ID de eleitor: se votou ou não, número de chaves recebidas. Qualquer atividade inventada em seu nome fica à vista.
- O seu anel. O resumo do anel que consta do seu recibo, calculado pelo seu próprio navegador, tem de ser igual ao publicado pelo registo.
- O seu boletim. Com a imagem de chave do seu recibo, encontra o seu boletim e verifica o conteúdo byte a byte, mesmo antes da publicação.
A garantia central é a lista fixada dos boletins assinados: verificações 1 a 4, mais a integridade da cadeia. A recontagem é uma verificação cruzada; uma divergência de resultado entre implementações seria um erro de um programa de cálculo, não uma falha de verificabilidade.
Procedimento de verificaçãoO que o registo não diz.
O que omite por conceção, e o que não pode provar ou deixa transparecer.
O que não revela
- Nenhuma data ou hora. Nenhuma entrada publicada tem data; as datas técnicas ficam na base de dados.
- Nenhuma ordem de chegada. Os boletins são ordenados por imagem de chave, o registo de participação por ID de eleitor: duas chaves de ordenação diferentes, sem relação com a cronologia.
- Nenhuma ligação entre eleitor e boletim. O registo de participação só é publicado no encerramento, nunca por intervalos: as suas linhas não podem ser alinhadas no tempo com os boletins. Só a votação não anónima estabelece essa ligação, por escolha do organizador.
- Nenhuma identidade, por predefinição. Sem registo de participação nominal nem votação não anónima, o registo não contém nenhum dado identificativo; a correspondência entre identificador e identidade só é conhecida da plataforma e do organizador.
- Nenhuma apresentação visual. Logótipo, fotografias dos candidatos, mensagem de agradecimento: nem publicados, nem sujeitos a hash.
O que não pode provar, ou deixa transparecer
- O momento do voto. Que o servidor não observou um eleitor enquanto votava: nesse momento, a plataforma é um terceiro de confiança.
- Uma participação inventada. Que uma linha «votou» não foi fabricada para um ausente: só esse eleitor o pode constatar.
- Quem assinou dentro do anel. Por construção.
- Uma ordem aproximada. Os blocos votes sucedem-se: qualquer boletim de um bloco foi emitido antes da selagem do seguinte, com uma granularidade de pelo menos 600 boletins. Do mesmo modo, um anel de emergência, publicado mais tarde, indica que os seus boletins são posteriores.
- Anéis pequenos e pesos raros. Num anel em que só um eleitor votou, o seu identificador fica ligado ao seu boletim, e o seu nome também, com o registo de participação nominal. O organizador, que conhece o nome por trás de cada identificador, pode fazer essa ligação seja qual for o modo das chaves. Em votação ponderada anónima, um peso quase único identifica o respetivo eleitor.
- Inscritos sem chave. Numa eleição em que os eleitores têm de depositar a sua chave, um inscrito que não tenha depositado nenhuma não pode votar e atualmente não aparece no registo de participação publicado.
- A imutabilidade da página. A página do registo pode mudar; a imutabilidade verifica-se na blockchain, na medida em que terceiros tenham guardado cópias dela.
Ver também
- Boletim assinado O boletim tal como o eleitor o assina: payload, assinatura em anel, imagem de chave, resumo do anel.
- Blockchain (protocolo) O sobreprotocolo que sela o registo: envelope, quatro tipos de blocos, serialização, encadeamento, assinatura, selagem temporal.
- Procedimento de verificação Verificar uma eleição do princípio ao fim: só a partir do registo, ou com a blockchain.