@gainratio/avow

中文文档
0.5.3发布于 2026/10/03MITTypeScriptES Module构建来源已验证近 30 天下载 4033

Avow在JSON记录上签入收据,文件任何人都可以下线确认记录没有变化,谁签了名.

中文使用文档

类型脚本的 Avow

TL; DR 数据

Avow创建了签名,篡改的不言自明的记录. 给它任何JSON证据;它 返回另一机器可以离线验证的收据.

这是 0.5.3 释放 @gainratio/avow它核实由 @edgeproc/avow 0.4.x 更年长的 0.5.0– 说吧 –0.5.2 错误的拒绝. 0.5.2 这是第一个在 @gainratio 范围; @edgeproc/avow 0.5.1 和老年居留 可安装但已贬值. 0.5.0 是第一个从这个仓库里建造的.

使用量

import {
  generateSeedHex,
  publicKeyHex,
  signPayload,
  verifySignature,
} from "@gainratio/avow";

const signingSeed = generateSeedHex();
const pinnedPublicKey = await publicKeyHex(signingSeed);
const receipt = await signPayload({ artifact: "sha256:abc" }, signingSeed);
await verifySignature(receipt, pinnedPublicKey);

举例来说,是在收据存在之前获得公用钥匙的。 在一个真正的核查者, 获取 pinnedPublicKey 通过信任的配置或分发而独立 频道 - 从未从 receipt.public_key。每一份发出的收据都有计划 avow.receipt/v1. 由 @edgeproc/avow 0.4.x 年长者没有 schema 键并仍在验证;a schema 在场的一定是 avow.receipt/v1。 。 。 .

核查证明有效载荷没有变化,由停靠者签字 键。 它不证明正确,新鲜, 时钟时间,或诚实 签名者.

不重复播放辩护:有效收件每次提交均以相同方式核实. 需要回放保护的呼叫者会签下他们自己的非曲直、观众和过期索偿 输入有效载荷,然后检查它们 verifySignature; 存储器的 docs/OPERATIONS.md ("回放保护为呼叫者所有") 有食谱.

签名种子是由呼叫者持有的未加密的十六进制. 此软件包从未读取密钥 文件,所以种子存储是集成应用程序的责任;没有 KMS/HSM接缝. Python 软件包的文件模式检查( P)avow.key_permissions_insecure, (中文(简体) ), 由下列人士提出: load_signing_key 对于组合键文件或其他可访问键文件)没有 TypeScript对应,因为没有TypeScript API从磁盘上装入密钥.

版本与发布记录

@gainratio/avow 共发布 4 个版本,首次发布于 2026/10/02;过去 12 个月发布了 4 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.5.3latest2026/10/031 个月前
0.5.22026/10/031 个月前
0.0.0-bootstrap.0bootstrap2026/10/021 个月前
0.0.0-stage2026/10/021 个月前

关于 @gainratio/avow 的常见问题

@gainratio/avow 是什么?

Avow在JSON记录上签入收据,文件任何人都可以下线确认记录没有变化,谁签了名.

如何安装 @gainratio/avow?

在项目目录运行 npm install @gainratio/avow,或使用 pnpm add / yarn add / bun add。

@gainratio/avow 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gainratio/avow 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@gainratio/avow 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.13。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@gainratio/avow 可以商用吗?

@gainratio/avow 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gainratio/avow 的下载量有多少?

根据 npm 官方下载统计,@gainratio/avow 在 2026/10/16 – 2026/11/14 这 30 天内被下载 4,033 次,日均约 134 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gainratio/avow 还在维护吗?

最新版本 0.5.3 发布于 2026/10/03(1 个月前);至今共发布 4 个版本,其中过去 12 个月发布了 4 个;首次发布于 2026/10/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。