hashsigs-ts工程实践:tsup+Vitest构建并开源TypeScript密码学库的完整流程
hashsigs-ts工程实践tsupVitest构建并开源TypeScript密码学库的完整流程【免费下载链接】hashsigs-tsHash-based signatures in typescript, WOTS项目地址: https://gitcode.com/gh_mirrors/ha/hashsigs-tshashsigs-ts 是一个用 TypeScript 实现的基于哈希的签名Hash-based signatures密码学库核心是 WOTSWinternitz One-Time Signature Plus一次性签名算法。如果你想在浏览器或 Node.js 环境中落地后量子密码post-quantum签名这篇工程实践指南会带你走完整条链路从 src/wotsplus.ts 的算法实现到用 tsup 一次产出 CJS ESM 类型声明再用 Vitest 测试向量把覆盖率钉在 80% 以上。 项目全貌一个极简但标准的密码学库整个仓库非常轻量核心就三个源文件文件职责src/index.ts库的入口仅导出WOTSPlus类与HashFunction类型src/wotsplus.tsWOTS 签名/验签算法主体实现src/wotsplus.test.tsVitest 单元测试与测试向量验证辅助配置文件各司其职package.json — 包元信息、脚本命令与依赖声明tsup.config.ts — 构建配置vitest.config.ts — 测试与覆盖率配置tsconfig.json — TypeScript 严格模式编译选项test/test_vectors/wotsplus_keccak256.json — Keccak-256 下的官方风格测试向量WOTS 属于后量子安全的哈希签名家族抗量子攻击的前提是不依赖大数分解或离散对数只依赖哈希函数的碰撞安全性因此特别适合存算分离的 Web 场景。WOTS 算法怎么落地读懂核心源码WOTSPlus 类 的设计有几个值得学习的点1. 构造期完成全部参数推导。传入哈希函数如 keccak_256后构造函数会自动算出消息分块数、校验和分块数、签名长度、公钥长度等派生参数并立刻做合法性校验——chainLen必须是 2 的幂且仅限 4 或 16对齐 XMSS / RFC 8391 约束。2. 领域分离Domain Separation。prf 方法 用前缀字节0x03 种子 2 字节索引构造伪随机函数输入防止不同用途的哈希输出互相混淆这是密码学实现里极易踩坑的细节。3. 跨平台兼容层。库内置了 BufferUtil 工具在没有 Node.jsBuffer的浏览器环境下自动回退到Uint8Array一套代码通吃两端。对外只暴露四个核心 APIgenerateKeyPair— 由私钥种子 公钥种子派生密钥对sign— 对消息哈希做 WOTS 签名verify— 验证签名有效性verifyWithRandomizationElements— 携带随机化元素的验证性能优化路径 小提醒WOTS 是一次性签名同一密钥只能签一条消息多次使用会泄露私钥种子。实际项目中请配合 XMSS/LMS 之类的树形结构做多消息使用。一键构建tsup 产出 CJS ESM 类型声明现代 TypeScript 库发布的关键难题是双模块格式 类型声明而 tsup.config.ts 只用五行配置就解决了entry— 入口锁定为 src/index.ts库结构干净format: [cjs, esm]— 同时产出 CommonJS 与 ESM兼容老项目与 ESM-only 新项目dts: true— 自动生成.d.ts类型声明消费方 IDE 体验完整clean: true— 构建前清空dist避免脏文件混入发布包配合 package.json 中的main/module/types三件套指向以及files: [dist]只发布构建产物npm install得到的包体干净且体积可控。日常开发只需两条命令npm run build— 一次性构建npm run dev— watch 模式改动即重编Vitest 测试体系80% 覆盖率门槛 测试向量密码学库没有测试向量test vectors等于没有安全底线。本项目在 src/wotsplus.test.ts 中做了三层防线行为测试— 密钥生成、正常签名/验签往返、空签名必须验签失败等边界用例测试向量对拍— 直接导入 wotsplus_keccak256.json与参考实现的输出逐字节比对确保实现与规范一致覆盖率硬门槛— 项目要求函数、分支、语句覆盖率均不低于 80%vitest.config.ts 的覆盖率配置也很典型选用 V8 provider同时输出text控制台、json、html本地报告中可查看与lcov供 CI/CD 集成四种格式并用exclude精确排除了dist、node_modules等干扰项。常用命令npm test— 运行全部测试npm run test:watch— 开发时热更新测试npm run coverage— 测试 覆盖率报告另外注意 tsconfig.json 开启了strict严格模式且排除了*.test.ts不参与产物编译——测试代码不会泄漏到发布包里。开源发布清单从本地代码到 npm 包对照 package.json 与 README.md一个可开源的密码学库通常要齐这几件事清单项本项目做法对应文件明确的许可证AGPL-3.0-or-later全文随仓库发布COPYING包名与版本quip.network/hashsigs语义化版本package.json检索关键词pqcrypto/post-quantum/signaturespackage.json使用文档安装、构建、测试、覆盖率说明齐全README.md贡献流程Fork → 分支 → 提 PR且要求测试与覆盖率达标README.md上手实操三步跑通 hashsigs-ts如果你想亲手把这套流程走一遍按下面顺序操作即可获取源码执行git clone https://gitcode.com/gh_mirrors/ha/hashsigs-ts安装依赖并构建npm install后执行npm run build检查dist/下是否同时生成了.jsCJS、.mjsESM与.d.ts验证质量npm test跑通全部用例再执行npm run coverage确认覆盖率报告达标写在最后hashsigs-ts 的价值不仅在于 WOTS 算法本身更在于它示范了TypeScript 密码学库的标准工程姿势tsup 五行为构建兜底、Vitest 测试向量 80% 覆盖率门槛守住正确性、strict 模式与 AGPL 许可保障代码质量与合规。把这套模板套到你自己的加密库上就能以很小的维护成本产出一个可信赖的开源 npm 包。 【免费下载链接】hashsigs-tsHash-based signatures in typescript, WOTS项目地址: https://gitcode.com/gh_mirrors/ha/hashsigs-ts创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

SPWM逆变器Simulink仿真:25个仿真文件资源的学习路径与实践技巧

SPWM逆变器Simulink仿真:25个仿真文件资源的学习路径与实践技巧

简介:本资源是一套面向电力电子初学者与进阶学习者的Simulink仿真实践合集,聚焦SPWM逆变器核心原理与典型拓扑建模,解决理论抽象、动手缺平台、控制策略难验证等学习痛点,适用于高校课程设计、毕业设计、新能源系统开发及电机驱动…

2026/11/22 19:36:54 阅读更多 →
OpenAI工程师看不懂AI代码,2人+AI两周造芯片,硅基文明要来了?

OpenAI工程师看不懂AI代码,2人+AI两周造芯片,硅基文明要来了?

【导语:近日,OpenAI工程师承认看不懂AI生成的代码,同时硅谷团队仅用两名工程师和AI在两周内就生成了能跑大模型的芯片,打破了传统芯片设计的周期和成本限制,引发对未来硅基文明的思考。】OpenAI:AI代码成人…

2026/11/16 4:04:30 阅读更多 →
如何做微信聊天记录导出?留痕项目完整指南

如何做微信聊天记录导出?留痕项目完整指南

如何做微信聊天记录导出?留痕项目完整指南 【免费下载链接】WeChatMsg 提取微信聊天记录,将其导出成HTML、Word、CSV文档永久保存,对聊天记录进行分析生成年度聊天报告 项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg 换…

2026/11/16 4:04:36 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/21 23:27:35 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/21 23:27:35 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/21 23:27:35 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/21 23:27:35 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/21 23:27:36 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/21 23:27:37 阅读更多 →

日新闻

周新闻

月新闻