# @agenticprimitives/agreements 中文文档

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

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

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

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

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

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

## 中文简介

只承诺协议 Registry SDK. 拥有协议认证形状(PD-22)+承诺数学+双边状态过渡+联合加载网关.

## 安装

```sh
npm install @agenticprimitives/agreements
```

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

## README

# @ agenticprimitives/ agreements

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

**两位探员达成协议 连锁店应该能够证明交易的存在和如何结束,而永远不知道是什么.** 大多数的链上协议记录都是通过设计泄露的:当事人,条款,时间表,都永远可以读取. 这个包是SDK的 `AgreementRegistry.sol`,一个只承诺的登记册——链式存储在缔约方设定、签发者、条款和时间表上的keccak承诺,加上一个状态机(`ACTIVE → COMPLETED / DISPUTED / REVOKED`) (中文(简体) ). 人能读取的协议是各方在链外持有的W3C可核查的证书;链子仅能支撑和裁定.

地位过渡与登记一样严格:合同从承诺、目标地位和连锁取消中重新计算过渡摘要,要求当事方在重算价值上签字——决不是呼叫者提供的散列,也绝不是仅发行者撤销.

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

## 今天的什么战舰

W1基础切片——承诺数学,类型机和有效载荷塑造合同依赖于:

-   **承诺数学** —— 说 `computeAgreementCommitment(...)` (第241节), `partySetCommitment(party1, party2)`, (中文(简体) ), `issuerCommitment(issuer)`, (中文(简体) ), `bytesCommitment(value)` 术语/时间表散列.
-   **`STATUS`** 歧视者匹配 `AgreementRegistry.STATUS_*` (单位:千美元)`NONE` 编号 : `ACTIVE` 编号 : `COMPLETED` 编号 : `DISPUTED` 编号 : `REVOKED`) (中文(简体) ).
-   **`TRANSITION_TYPEHASH` + 键 `transitionDigest(...)`** ——文摘各方签署地位过渡. `updateStatus` 在链上重算(RW1-3), [ADR-0027 (英语)](https://npmcn.com/package/docs/architecture/decisions/0027-canonical-authority-binding.md)(三); `chainId` 并且登记地址受交叉链回放(AGR-1)的约束.
-   **`AGREEMENT_ISSUER_TYPEHASH` + 键 `issuerAttestationDigest(...)`** ——发行人注册证明书,连锁(SC-1)重制并核实.
-   **`nullifierFor(...)`** ——每过渡一发一发即成的衍生出.
-   **有效载荷形状** —— 说 `AgreementIssuancePayload`, (中文(简体) ), `StatusUpdatePayload` (包括RW1-2披露方字段,合同用于重算承诺并检查每个签字人都是一方).

每个字节均匀 `AgreementRegistry.sol` 常数 – 由跨层执行 `check:eip712-typehash-equality` CI门.

计划以后每波 [W1执行波计划](https://npmcn.com/package/docs/architecture/w1-implementation-wave-plan.md)页:1 `AgreementCredential` 形状(PD-22), `AgreementRegistryClient` 读取客户端,并使用联合连接网关帮助 [`attestations`](https://npmcn.com/package/%40agenticprimitives/attestations) 核查协议的背对面者,然后加以确认.

## 怎么不一样

与埃及会计准则式的认证登记和电子签名平台相对应:

1.  **只有连锁承诺.** 没有政党地址,没有条款,没有时间表 `register(...)` calldata——静态分析回归测试执行(AR-12). 即使是时间戳也是划时代的(241 第3.4节). 核证登记册公布债权;该登记册只公布其影子.
2.  **链条重算; 它从来不信任.** 过渡文摘和签发人证明从披露组件的链条上重新计算——泄露的签名不能在不同的协议、地位、链条或登记册部署上重放.
3.  **没有只发行者退出.** 完成、争议和撤销遵循241 第5.4.1节的双边/任何一方矩阵。 公证协议的发行人不能单方面杀死协议(D-18).
4.  **合同和SDK是一件艺术品.** Typehash等值是CI-gated的,因此客户端不能从链条上漂移——即悄悄地断开接接接签名堆的故障模式.

## 状态

**基础(W1)——代码运出;不是生产执法.** 上面的承诺数学、类型和有效载荷形状是真实的,并经过大门检查;认证形状、阅读客户端和网关在每波4中着陆 [波浪计划](https://npmcn.com/package/docs/architecture/w1-implementation-wave-plan.md)。见 [审计](https://npmcn.com/package/%40agenticprimitives/agreements/AUDIT.md)。 。 。 .

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

**拥有脊柱层 :** 第8层. **权威规格 :** [`specs/241-agreement-commitment-registry.md`](https://npmcn.com/package/specs/241-agreement-commitment-registry.md) 看到了吗 `spec.md` 为同音节。 外壳: `CLAUDE.md` + 键 `capability.manifest.json`。 。 。 .

## 构建

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

## 常见问题

### @agenticprimitives/agreements 是什么？

只承诺协议 Registry SDK\. 拥有协议认证形状\(PD-22\)\+承诺数学\+双边状态过渡\+联合加载网关\.

### 如何安装 @agenticprimitives/agreements？

在项目目录运行 npm install @agenticprimitives/agreements，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：viem（^2\.52\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @agenticprimitives/agreements 支持 TypeScript 吗？

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

### @agenticprimitives/agreements 支持 ESM 还是 CommonJS？

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

### @agenticprimitives/agreements 可以商用吗？

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

### @agenticprimitives/agreements 的下载量有多少？

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

### @agenticprimitives/agreements 还在维护吗？

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