跳至主要内容
Condorcet.vote Alpha
← 技术文档

投票人文件

投票人可以保存的两个文件:投票回执和投票私钥文件。逐字段说明其内容、可以用来核查什么,以及哪些内容必须保密。

这两个文件都在您的浏览器中生成,只有在您下载时才存在:平台不会接收、存储或发送它们。两个文件都包含您的私钥。

协议 v1

通用格式

两个文件遵循同样的规则

回执和私钥文件遵循同样的约定,由投票网站的 voter-artifacts 库负责读写。各个值在密码学上是否有效(校验和、是否在曲线上)由 CryptoVote 判断,而不由信封读取器判断。

  • 一个 UTF-8 JSON 对象。 每个文件都是单个 JSON 对象,写在一行内,不含空白。本页的示例为便于阅读做了缩进。
  • 开头标明版本。 version 字段注明信封名称及其版本。读取器必须检查这个字段,遇到其他任何值都要拒绝。
  • 值都带前缀,绝不使用裸十六进制。 每个密码学值都是 CryptoVote 生成的规范字符串 <tag>_<hex>_<checksum>,原样照录。不带前缀的十六进制值会被拒绝。
  • 用校验和防止输错。 4 字节 BLAKE3(8 个十六进制字符),计算时包含标签:抄错的值,或在应填 ki_ 的地方粘贴了 pk_,都能立即发现。校验和不是安全保障:真实性只来自环签名。
  • 忽略未知字段。 读取器必须忽略不认识的字段,以便兼容格式今后的修订;也不会把这些字段写回。

标签

pk_ 32 字节 · 64 个十六进制字符
公钥:列在环中的那个密钥。
sk_ 32 字节 · 64 个十六进制字符
私钥:用于签名的密钥。绝不能泄露。
ki_ 32 字节 · 64 个十六进制字符
密钥镜像:选票的公开标识,每场选举各不相同。
ring_ 32 字节 · 64 个十六进制字符
环摘要:环中全部密钥集合的规范摘要,与密钥顺序无关。
blsag_ 32 × (1 + 环大小) 字节
bLSAG 环签名:600 个密钥的环对应 38,464 个十六进制字符。
投票回执 · .condorcet_receipt

选票受理后发放的回执

这是您自己的副本,包含您投出的选票、签名时所在的环(界面中称为“虚拟投票站”)以及签名所用的密钥:足以让您亲自在公开登记簿中找到并验证自己的选票。

何时生成,由谁掌握

  • 仅在选票受理后。 只有服务器接受您的选票后,回执才会出现在投票页面上。回执仅显示一次;是否下载由您决定。
  • 在您的浏览器中生成。 页面根据签名后仍留在内存中的私钥组装回执。回执从不通过电子邮件发送(确认邮件只证明您参与了投票),平台也从不存储。
  • 无法补发。 平台已不再持有您的私钥,因此无法重建回执。页面上的敏感值隐藏在“显示”和“复制”按钮后面;点击“永久隐藏详情”会把它们从屏幕上彻底清除,私钥也会在固定时间后自动清除。请事先复制或下载回执。

回执的用途

  • 找到您的选票。 在本场选举公开登记簿的查询框中输入 ballot.key_image(选票尚未分批公布时也可以),然后将公布的选票与 signed_payload 逐字节比对。
  • 核查您的环。 将 ring_digest 与登记簿为 ring 所指的环公布的摘要比对。如果不一致,说明您签名时所在的环并非公布的那个环。
  • 核查您在签到簿中的那一行。 voter_id 指向您在投票签到簿中的那一行:密钥分发次数、“已投票”标记。
  • 离线重新验证签名。 有了 signed_payload、signature、选举标识符和环中的公钥,无需平台即可重新验证签名。
  • 生成投票证明。 “投票证明”工具会读取回执,从中取出私钥、选举和密钥镜像。
version 字符串
始终为 condorcet-receipt/1。
election UUID
选举标识符,签名参数之一。读取时接受大写,写回时一律使用小写。
ring 非空字符串
为选票签名时所在环的标识(UUID),与登记簿中公布的一致。
ring_digest ring_…
该环的摘要,由您的浏览器根据收到的密钥计算。服务器从不提供这个值:若随环一起发送,它可能会与环一并被篡改。
voter_id UUID
您的选民编号,也是与您有关的唯一公开标识。
public_key pk_…
您的公钥,ring 所指的环中的成员。
secret_key sk_…
您的私钥,即为选票签名的密钥。
ballot.signed_payload 字符串(JSON)
签名载荷,逐字节保留:正是被签名并发送给服务器的那个字符串。应将它当作不透明的字符串处理;重新解析再重新编码,就无法与登记簿比对。
ballot.signature blsag_…
选票的环签名。
ballot.key_image ki_…
选票的密钥镜像,限定于本场选举:也就是您的选票在登记簿中的公开标识。
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"
    }
}

虚构的值:校验和无效,签名截短到最小长度。供下载的文件名为 recu-vote- 加上选举标识符的前 8 个字符。

私钥文件 · .condorcet_private_key

私钥文件,在提交密钥时下载

您自行提交密钥时,密钥对会在您的浏览器中生成。这个文件就是它的备份:您将凭它投票。

何时生成,由谁掌握

  • 提交生成的密钥时。 在一场选举或一个选举组的密钥提交期内,如果您选择生成密钥,CryptoVote 会在您的浏览器中生成密钥对。
  • 只发送公钥。 public_key 会发送给平台,由平台放入某个环。私钥只显示一次,可以复制,文件在您的浏览器中生成。
  • 不绑定选举或选举组。 文件只包含密钥对:同一个密钥可以用于多场相互独立的选举,因为密钥镜像在签名时才针对每场选举生成。文件以密钥本身命名:condorcet-vote- 加上 public_key 的校验和。

私钥文件的用途

  • 投票。 在投票页面上粘贴 sk_… 私钥或加载文件:页面会推导出公钥,并检查它是否在分配给您的环中。
  • 在别处提交同一个密钥。 再次提交密钥时,加载这个文件即可:公钥在浏览器中提取,私钥不会离开您的设备。
  • 找到选票,证明投票。 有了私钥和选举标识符,“投票证明”工具即使没有回执,也能重新算出您的密钥镜像。
version 字符串
始终为 condorcet-private-key/1。
public_key pk_…
公钥,即提交密钥时发送给平台的那个。
secret_key sk_…
私钥,在您的浏览器中生成,从不发送。
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"
}

虚构的值,校验和无效。没有 election 字段,也没有选举组字段:带有 election 说明字段的旧文件仍可读取,该字段会被忽略。

机密

哪些内容必须保密,为什么

两个文件都含有您的私钥。请像保管密码一样保管它们:不让他人接触,也不要弄丢。

风险,如实说明

  • 私钥会暴露您的投票。 凭私钥可以算出您在任何选举中的密钥镜像,从而追溯找到它用过的每场选举中您已公布的选票,还能以您的名义生成投票证明。
  • 私钥可以签名。 在任何包含您公钥的环中,私钥都能生成有效签名。平台只接受通过您的投票链接投出的选票,且每名投票人只接受一张。
  • 回执会向读到它的人暴露您的投票。 回执把您的选民编号和您的选票放在一起。它在设计上就是可证明的:协议优先保证个人可验证性,因此不提供抗胁迫性。只把它给您决定向其公开投票的人看。
  • 丢了密钥,就投不了票。 已提交的密钥在服务器端没有任何备用:选举开启投票后,丢失密钥就等于无法投票。在密钥提交期内,对于环尚未建立的选举,您可以提交一个新密钥来替换。
  • 回执丢失后不会补发。 您的选票仍然计入。如果您保留了私钥,凭它就能重新算出密钥镜像并找到您的选票。

平台从不会看到的内容

  • 您的文件。 回执和私钥文件都在您的浏览器中写入和下载,从不经过我们的服务器。
  • 您自己生成的私钥。 私钥在您的浏览器中生成,从不发送。提交密钥时加载密钥文件,只会发送其中的公钥。
  • 您投票后,平台分发的密钥。 在默认模式下,平台生成密钥并加密保存;把密钥交给您时,将其从数据库中删除,投票时再从临时缓存中删除。因此平台无法再重建您的回执。
  • 您的密钥与选票之间的关联。 您的公钥出现在公布的环中,您的选票出现在公开登记簿中;只有私钥能把两者联系起来。
投票证明会公开什么

选择允许 Condorcet.Vote 在公开页面上统计哪些数据。您的选择保存在本设备上,随时可以修改。

必要功能 始终启用

语言、主题,以及记住这些选择。