Saltar para o conteúdo
Condorcet.vote Alpha
← Documentação técnica

Selagem temporal OpenTimestamps

Cada bloco é ancorado na blockchain do Bitcoin através do OpenTimestamps: uma prova, independente da plataforma, de que os seus bytes exatos já existiam, o mais tardar, numa dada data.

A blockchain é o sobreprotocolo com o qual qualquer pessoa pode verificar a integridade e a imutabilidade do registo público; a ancoragem OpenTimestamps é a parte que prova quando existia cada bloco. Não exige nenhuma confiança na plataforma nem nas suas chaves: o ficheiro .ots verifica-se com o bloco, usando as ferramentas OpenTimestamps padrão.

Protocolo v1

Porquê uma ancoragem externa

Uma data que a plataforma não pode antedatar.

A assinatura da plataforma prova que um bloco vem dela, mas não prova que o histórico não foi reescrito. Uma ancoragem externa, fora do alcance das suas chaves, preenche parte dessa lacuna.

  • Uma assinatura não é imutabilidade. A plataforma detém a sua chave de assinatura: poderia voltar a assinar uma cadeia reescrita, e cada bloco continuaria a passar na verificação.
  • A data de uma assinatura é uma declaração. O signed_at é a data de criação que o próprio signatário escreve na assinatura: com uma chave comprometida, é possível antedatar uma assinatura dentro do respetivo período de validade.
  • Um bloco do Bitcoin não se antedata. Uma atestação Bitcoin não é uma declaração da plataforma: prova que os bytes exatos do bloco já existiam, o mais tardar, no bloco do Bitcoin atestado, independentemente das chaves da plataforma. Limita assim a margem de antedatação de uma chave comprometida.
  • Um reforço das cópias independentes. Na prática, a imutabilidade assenta nas cópias dos blocos publicados que qualquer pessoa pode guardar. A ancoragem junta-lhes uma prova de existência dada por terceiros: um histórico reescrito não consegue obter atestações antedatadas.
O que recebe o selo temporal

O SHA-256 do ficheiro, tal como é publicado.

Cada bloco, seja qual for o tipo (configuration, rings, votes, closure), recebe a sua própria prova. É submetido aos calendários OpenTimestamps no momento em que é selado, logo depois de a sua linha de ancoragem ser gravada na base de dados. O compromisso incide sobre o próprio ficheiro publicado: a prova verifica-se com o bloco descarregado e com mais nada.

sha256({n}.json) SHA-256 · compromisso
O SHA-256 simples dos bytes do ficheiro do bloco: os bytes exatos que são armazenados, servidos, usados no cálculo do hash e assinados.
nonce ausente
Submetido de propósito sem o nonce de confidencialidade habitual do OpenTimestamps, porque os bytes são públicos por conceção: o compromisso junto dos calendários é igual a sha256({n}.json), e qualquer ferramenta OpenTimestamps padrão verifica a prova sem confiar na plataforma.
SHA3-512 hash de encadeamento
Não confundir: o hash de um bloco na cadeia (content_hash, previous_hash do bloco seguinte) continua a ser o SHA3-512 do ficheiro. O SHA-256 é apenas o compromisso OpenTimestamps.
Ciclo de vida

De pending a completed.

Uma prova OpenTimestamps completa-se em dois tempos: os calendários registam o compromisso de imediato e o Bitcoin confirma depois, normalmente em poucas horas. O estado da prova é o único dado de um bloco que pode mudar, e só muda uma vez, num único sentido.

  1. 1

    Submissão no momento da selagem.

    A plataforma submete o compromisso aos servidores de calendário OpenTimestamps públicos e guarda a prova recebida junto do bloco. A submissão é feita sem garantia: uma falha dos calendários não atrasa nem impede a publicação do bloco, cujo ficheiro .ots fica em falta até à reconciliação seguinte.

  2. 2

    pending: os calendários registaram o compromisso.

    A prova contém os compromissos dos calendários, mas ainda nenhuma atestação Bitcoin. Já se pode descarregar, mas ainda não prova nenhuma data no Bitcoin.

  3. 3

    Uma reconciliação de hora a hora.

    De hora a hora, todos os blocos ainda em pending são retomados. Uma prova em falta é submetida de novo a partir dos bytes armazenados, e a ancoragem parte então dessa nova submissão. Para um bloco publicado há mais de 4 horas, o tempo habitual de uma confirmação Bitcoin, os calendários são consultados. Este ritmo horário faz as vezes de política de novas tentativas.

  4. 4

    completed: o Bitcoin confirmou.

    Assim que os calendários fornecem a atestação Bitcoin, a prova enriquecida substitui o ficheiro .ots armazenado e o estado do bloco passa a completed. Nunca volta a pending.

O ficheiro .ots

Um terceiro ficheiro, ao lado do bloco e da sua assinatura.

Seja qual for o seu estado, a prova é servida com o bloco {n}.json e a sua assinatura {n}.json.sig, e esse estado consta do manifesto da eleição. Estes ficheiros existem enquanto a eleição tiver registo público, da abertura ao arquivo; uma eleição cancelada retira-os.

/elections/{election}/chain/{n}.json.ots Rota pública
Redireciona para o ficheiro armazenado e serve a prova pendente ou completa: uma prova pending já contém os compromissos dos calendários.
{election}/{election}_{n}.json.ots Ficheiro armazenado
Guardado ao lado do bloco, com o identificador da eleição no nome: uma cópia separada do seu URL continua identificável.
ots_url · ots_status Manifesto
Para cada bloco, o manifesto (/elections/{election}/chain) indica o URL direto da prova e o seu estado, pending ou completed. A página do registo mostra o mesmo estado em cada descarregamento .ots: «a aguardar ancoragem no Bitcoin» ou «ancorado no Bitcoin».
pending → completed Substituído uma vez
O ficheiro .ots não é fixo: a prova enriquecida substitui a prova pendente, para que os descarregamentos e os espelhos obtenham sempre a mais completa. O bloco, esse, nunca muda; na base de dados, o estado é a única coluna que a tabela dos blocos, append-only, deixa alterar, e só nesse sentido.
{n}.json.ots Acesso
As provas .ots, tal como o manifesto e os blocos JSON, podem ser descarregadas em todas as eleições, seja qual for a oferta. Só o descarregamento das assinaturas .sig está reservado às eleições Oficiais, e apenas na interface.
Verificação

ots verify, com o ficheiro descarregado.

A plataforma indica o estado da prova, mas não faz ela própria nenhuma verificação na blockchain do Bitcoin: essa tarefa cabe ao verificador, com as ferramentas OpenTimestamps padrão. No procedimento de verificação completo, este controlo é opcional.

  1. 1

    Obter o bloco e a sua prova.

    O ficheiro {n}.json e a sua prova {n}.json.ots, a partir do registo público da eleição ou dos URL do manifesto. O estado indicado no manifesto é uma declaração da plataforma; só a verificação faz fé.

  2. 2

    Verificar a prova com o ficheiro.

    ots verify -f {n}.json {n}.json.ots. Como o compromisso é o SHA-256 simples do ficheiro, nenhum dado da plataforma intervém: basta alterar um único byte para o ficheiro deixar de corresponder à prova.

  3. 3

    Voltar a uma prova pendente.

    Uma prova pending ainda não aponta para nenhum bloco do Bitcoin. Como o ficheiro armazenado é substituído pela prova completa, basta descarregá-lo de novo quando o estado passar a completed, normalmente algumas horas depois da publicação do bloco.

O que isto prova: Uma prova completa que passa na verificação estabelece que o bloco já existia, byte a byte, o mais tardar no bloco do Bitcoin atestado, independentemente das chaves da plataforma.

O procedimento de verificação completo
Selagem temporal · shell
# o estado de cada prova (ots_status), no manifesto
curl -s https://condorcet.vote/elections/{election}/chain

# o bloco n e a sua prova (as rotas redirecionam para os ficheiros armazenados)
curl -sL -o {n}.json https://condorcet.vote/elections/{election}/chain/{n}.json
curl -sL -o {n}.json.ots https://condorcet.vote/elections/{election}/chain/{n}.json.ots

# o compromisso: o SHA-256 simples do ficheiro
openssl dgst -sha256 {n}.json

# verificar a prova com o ficheiro
ots verify -f {n}.json {n}.json.ots
ElephStamp, a nossa biblioteca OpenTimestamps O Condorcet.Vote desenvolveu a sua própria biblioteca OpenTimestamps, a ElephStamp: a mais completa e moderna que existe, de código aberto (licença MIT), utilizável como biblioteca PHP ou na linha de comandos. As suas provas .ots são 100% interoperáveis, byte a byte, com o cliente oficial em Python: as nossas provas verificam-se com qualquer um dos dois. ElephStamp no GitHub
Limites

O que a ancoragem não prova.

A ancoragem prova quando certos bytes existiam. Junta-se aos outros controlos, não os substitui.

  • Um limite, não uma data exata. Uma prova completa estabelece que o bloco já existia, o mais tardar, no bloco do Bitcoin atestado. Uma prova ainda em pending não prova nenhuma data no Bitcoin.
  • Nem a exatidão do conteúdo. A ancoragem incide sobre bytes, sejam eles quais forem: a validade dos boletins, os limites da participação e o resultado confirmam-se com o procedimento de verificação.
  • Nem a autenticidade. A prova é independente das chaves da plataforma e, por isso, nada diz sobre o autor do bloco. Esse papel cabe à assinatura OpenPGP, que se verifica com as chaves de verificação publicadas.
  • Nem a unicidade do histórico. Um histórico reescrito não consegue obter atestações antedatadas, mas a ancoragem, por si só, não prova que um dado histórico é o único publicado: as cópias independentes continuam a ser a defesa contra a reescrita.
  • Não é um selo temporal qualificado. Um selo temporal RFC 3161 emitido por uma autoridade de selagem temporal, com valor probatório eIDAS, continua a ser um complemento possível; não é proposto atualmente.

Escolha o que o Condorcet.Vote mede nas páginas públicas. A sua escolha fica guardada neste dispositivo e pode ser alterada a qualquer momento.

Essenciais Sempre ativos

Idioma, tema e memorização destas opções.