# @agenticprimitives/attestations 中文文档

规范地址：https://npmcn.com/package/%40agenticprimitives/attestations/

版本：0\.0\.0-alpha\.42
npm 元数据更新时间：2026-10-26T11:48:12.243Z
中文译文更新时间：2026-11-06T02:07:09.129Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agenticprimitives/attestations
原文对照：https://npmcn.com/package/%40agenticprimitives/attestations/?lang=original
项目主页：https://agenticprimitives.dev/
源码仓库：https://github.com/agentictrustlabs/agenticprimitives

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：54.8 kB，12 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：4 个
- peer 依赖：viem ^2\.52\.2
- 首次发布：2026-06-11T04:59:57.233Z
- 最新版本发布：2026-10-26T11:48:06.300Z
- 近 30 天下载量：6739（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：40（近 12 个月 40 个）

## 中文简介

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

## 安装

```sh
npm install @agenticprimitives/attestations
```

也可以使用：`pnpm add @agenticprimitives/attestations`、`yarn add @agenticprimitives/attestations`、`bun add @agenticprimitives/attestations`

## README

# @ agenicprimitive/ 证书

> 部分 **[代理先导](https://agenticprimitives.dev/)** ——代理应用程序的开源信任底板:可以签名的身份,行为时间检查权限,所有者携带的证据. [开发者工具包](https://github.com/agentictrustlabs/agentic-primitives) • 妇女 [所有软件包](https://agenticprimitives.dev/developers)

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

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

> 部分 [代理原始产品](https://npmcn.com/package/README.md) ——代理经济的信托基底:一个有监护,授权,命名,证书,审计证据的犬类智能代理身份,设计成一个系统.

## 今天的什么战舰

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

-   **`CREDENTIAL_TYPE`** 歧视者 `Association`, (中文(简体) ), `Evidence`, (中文(简体) ), `Outcome`, (中文(简体) ), `Validation`, (中文(简体) ), `TrustUpdate`, (中文(简体) ), `JointAgreement`, (中文(简体) ), `PaymentReceipt` (一个登记处,许多类型—— [ADR-0024 (英语)](https://npmcn.com/package/docs/architecture/decisions/0024-intent-coordination-substrate.md) 决定2.
-   **`computeAttestationUid(...)`** ——重算每架链式UID `AttestationRegistry._computeUid`。 。 。 .
-   **`JOINT_CONSENT_TYPEHASH` + 键 `jointConsentDigest(...)`** ——文摘双方签署同意联合协议. `assertJointAgreement` 在链条上重新计算并验证两个签名(ERC-1271 / ECDSA);存储的同意书不是同意书(RW1-1, [ADR-0027 (英语)](https://npmcn.com/package/docs/architecture/decisions/0027-canonical-authority-binding.md)) (中文(简体) ). `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执行波计划](https://npmcn.com/package/docs/architecture/w1-implementation-wave-plan.md): 主张建立者(`buildAssociationAssertion`, (中文(简体) ), `buildJointAgreementAssertion`页:1 `AttestationClient` 读取客户端,并撤销编码器(每个类型只有持有者/任何一方/验证者).

## 怎么不一样

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

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

证书机构本身是来自 [`verifiable-credentials`](https://npmcn.com/package/%40agenticprimitives/verifiable-credentials) (类型上只依赖);只有它们的犬类散列会触碰链. 除非明确选择公开主张(D-46).

## 状态

**基础(W1)——代码运出;不是生产执法.** 上面的文摘数学、类型和有效载荷形状是真实的,并经过门口检查;每波4中完整的建筑者/客户地表着陆 [波浪计划](https://npmcn.com/package/docs/architecture/w1-implementation-wave-plan.md)。见 [审计](https://npmcn.com/package/%40agenticprimitives/attestations/AUDIT.md)。 。 。 .

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

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

## 构建

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

## 常见问题

### @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 和提交记录判断。