@agenticprimitives/attestations

中文文档
0.0.0-alpha.42发布于 2026/10/26MITTypeScriptES Module近 30 天下载 6739

SDK登记——EAS与双边同意挂钩。 拥有协会+联合协议+证据+结果+验证+信任更新证明类型,按照ADR-0023被主张为单一链上登记册.

中文使用文档
文档目录4 节
  1. 今天的什么战舰
  2. 怎么不一样
  3. 状态
  4. 构建

@ agenicprimitive/ 证书

部分 代理先导 ——代理应用程序的开源信任底板:可以签名的身份,行为时间检查权限,所有者携带的证据. 开发者工具包 • 妇女 所有软件包

代理人的名声需要公开的,可撤销的主张被固守在持续的身份上——而不是被旋转掉的钥匙上. 当代理的追踪记录存在连锁状态时,有三件事必须是真实的:主题是一个在证书恢复后幸存下来的地址,通过重放签名,不能将权利要求固定在不同的主体身上,而"联合"权利要求真正背负着双方的同意. 这个包是SDK的 AttestationRegistry.sol,执行这些保证的单一链上登记处——双边同意从双方签名的链上核查,而不是从存储的参考资料中推定.

它与EAS相对应,有助于对接(UID模型、schema IDs、RefUID连锁),在EAS松散的情况下则刻意更加严格:一个登记册、作为歧视者的证书类型而不是每个类型的合同,以及完全没有发行方-单方面撤销的切入点.

部分 代理原始产品 ——代理经济的信托基底:一个有监护,授权,命名,证书,审计证据的犬类智能代理身份,设计成一个系统.

今天的什么战舰

W1基片——合同和下游包已经依靠的密码脊椎:

  • CREDENTIAL_TYPE 歧视者 Association, (中文(简体) ), Evidence, (中文(简体) ), Outcome, (中文(简体) ), Validation, (中文(简体) ), TrustUpdate, (中文(简体) ), JointAgreement, (中文(简体) ), PaymentReceipt (一个登记处,许多类型—— ADR-0024 (英语) 决定2.
  • computeAttestationUid(...) ——重算每架链式UID AttestationRegistry._computeUid。 。 。 .
  • JOINT_CONSENT_TYPEHASH + 键 jointConsentDigest(...) ——文摘双方签署同意联合协议. assertJointAgreement 在链条上重新计算并验证两个签名(ERC-1271 / ECDSA);存储的同意书不是同意书(RW1-1, ADR-0027 (英语)) (中文(简体) ). chainId 并且登记地址受约束,因此不能重播同意的跨链(ATT-3).
  • JOINT_ISSUER_TYPEHASH + 键 jointIssuerDigest(...) ——发行人签署各方,计划,证书类型/花样,协议承诺,链条,和登记——绝不是一丝不挂(ATT-1).
  • ASSOCIATION_ATTESTATION_TYPEHASH + 键 associationAttestationDigest(...) ——约束主体,因此已知的认证散列不能与他人(SC-2)对接.
  • 请求有效载荷形状 —— 说 AssociationAttestationRequest, (中文(简体) ), JointAgreementAttestationRequest,匹配合同ABI.

最大字节上的每一字节均匀 AttestationRegistry.sol 常数 – 由跨层执行 check:eip712-typehash-equality CI门.

计划以后每波 W1执行波计划: 主张建立者(buildAssociationAssertion, (中文(简体) ), buildJointAgreementAssertion页:1 AttestationClient 读取客户端,并撤销编码器(每个类型只有持有者/任何一方/验证者).

怎么不一样

与EAS和Verax对抗,三个混凝土三角洲:

  1. 合同和SDK是一件艺术品. 本包中的EIP-712型机车被CI-clock到固态常数. 在 EAS 风格的堆栈中,客户端SDK和链是单独的可漂移的代码基;这里漂移会失败构建.
  2. 双边同意是经核实的,而不是断言的. 联合证明需要双方在合同摘要上签字才能重新计算。 不存在可定制同意语义的解析器/模块钩(ADR-0023 (英语)页:1.
  3. 没有 issuerRevoke。 。 。 . 持有者取消自己的协会;任何一方取消联合协议;通过StatusList2021(D-18)取消发行者。 发行人不能单方面抹去对象的记录.

证书机构本身是来自 verifiable-credentials (类型上只依赖);只有它们的犬类散列会触碰链. 除非明确选择公开主张(D-46).

状态

基础(W1)——代码运出;不是生产执法. 上面的文摘数学、类型和有效载荷形状是真实的,并经过门口检查;每波4中完整的建筑者/客户地表着陆 波浪计划。见 审计。 。 。 .

测试网/飞行员准备 生产启动在基础README的公开核对表上进行——包括第三方合同审计和治理关键轮换。 追踪所有安全发现 docs/audits/findings.yaml。 。 。 .

拥有脊柱层 : 12–15 (英语). 权威规格 : specs/242-trust-credentials-and-public-assertions.md 看到了吗 spec.md 为同音节。 外壳: CLAUDE.md + 键 capability.manifest.json。 。 。 .

构建

pnpm --filter @agenticprimitives/attestations typecheck
pnpm --filter @agenticprimitives/attestations test
pnpm --filter @agenticprimitives/attestations build

版本与发布记录

@agenticprimitives/attestations 共发布 40 个版本,首次发布于 2026/06/11;过去 12 个月发布了 40 个版本。

版本发布日期距今
0.0.0-alpha.42latest2026/10/2610 天前
0.0.0-alpha.412026/10/2610 天前
0.0.0-alpha.402026/10/1720 天前
0.0.0-alpha.392026/10/1720 天前
0.0.0-alpha.382026/10/1620 天前
0.0.0-alpha.372026/10/1620 天前

其他发布通道:alpha → 0.0.0-alpha.3。

关于 @agenticprimitives/attestations 的常见问题

@agenticprimitives/attestations 是什么?

SDK登记——EAS与双边同意挂钩。 拥有协会+联合协议+证据+结果+验证+信任更新证明类型,按照ADR-0023被主张为单一链上登记册.

如何安装 @agenticprimitives/attestations?

在项目目录运行 npm install @agenticprimitives/attestations,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:viem(^2.52.2)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@agenticprimitives/attestations 支持 TypeScript 吗?

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

@agenticprimitives/attestations 支持 ESM 还是 CommonJS?

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

@agenticprimitives/attestations 可以商用吗?

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

@agenticprimitives/attestations 的下载量有多少?

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

@agenticprimitives/attestations 还在维护吗?

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