缩略语
注:该图书馆未经审计,因此其安全性未经独立核实.
sigsum-ts 是一个小型的 TypeScript 库,用于在浏览器中校验 Sigsum 证明 。 它旨在与Sigsum政策格式合作,并根据法定人数规则核实包含证明、签名树头和签名。 执行严格是为了核查目的,任何密码或格式出错都会造成例外,确保故障总是明确的,必须被呼叫者抓住. 它唯一的运行时间依赖是 密码浏览器,使用 网络加密 API; 应用程序针对没有Ed25519呼叫的引擎 installEd25519Fallback() 从 @freedomofpress/crypto-browser/noble 一次开始。 库从"Sigsum"寄存器中映射出原"Go"执行的逻辑,旨在行为和结构上尽可能相近.
sigsum-ts 有完整的测试覆盖。 其主要用途是: 韦贝克,用于网络应用程序的透明度和完整性层,其中客户端需要验证加密证明.
关于Sigsum的更多信息,请访问 sigsum.org (英语) 或 数据库。 。 。 .
名义密码类型
为防止意外地滥用密码材料, sigsum-ts 定义每个加密类型的明确面值包装类。 虽然他们中许多人在内部包裹 Uint8Array 或一个 string,它们不能互换,而 TypeScript 会拒绝通过一个 Hash 其中a Signature 预期.
使用量
要校验 Sigsum 证明, 请用信件、 原始提交者公钥、 策略和证明文本调用 yessage () 函数 .
import { verifyMessage } from "sigsum-ts";
const isValid = await verify(
messageBytes, // Uint8Array
submitterRawPublicKey, // Uint8Array as RawPublicKey (32 bytes, Ed25519)
policyText, // string (Sigsum policy format)
proofText, // string (Sigsum proof format)
);
有时,特别是在远程获取更新时,验证尚未获得的文件散列的证据可能是有用的. verifyHash 采用同样的论点: verifyMessage,但第一个应该是 已经散去.
import { verifyMessage } from "sigsum-ts";
const isValid = await verifyMessage(
messageHash, // Uint8Array
submitterRawPublicKey, // Uint8Array as RawPublicKey (32 bytes, Ed25519)
policyText, // string (Sigsum policy format)
proofText, // string (Sigsum proof format)
);
实验政策汇编和评价
这个项目包括一个政策汇编器和一个基于字节编码的评价员,根据《公约》第19条加以修改 锡格苏姆 C 参考执行。 目标是使政策验证紧凑而高效,适合内存和二进制尺寸要求有限的受制约环境(如嵌入式设备).
汇编的格式和评价逻辑都具有实验性和不稳定性,因为随着西格苏姆生态系统的发展,它们可能在不事先通知的情况下发生变化.
参考文献: