# @agenticprimitives/contracts 中文文档

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

版本：1\.0\.0-alpha\.46
npm 元数据更新时间：2026-10-26T11:49:25.838Z
中文译文更新时间：2026-11-06T05:23:47.151Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.1 MB，157 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：viem ^2\.52\.2
- 首次发布：2026-05-31T17:13:15.948Z
- 最新版本发布：2026-10-26T11:49:12.057Z
- 近 30 天下载量：4812（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：45（近 12 个月 45 个）

## 中文简介

固态合同 + ABIs + 扁平源 + 代理主堆栈的每个网络部署地址.

## 安装

```sh
npm install @agenticprimitives/contracts
```

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

## README

# @ 代理原始/合同

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

**合同和SDK是一件艺术品.**

这是代理初始基底的链上执行层——42个固态源,全部在下并审计 `src/`没有一根根 ERC-4337 v0.7 (英语). 智能特工核心 ERC-7710式代表团经理 配有警告执行员 ERC-7579模块保管政策 三模式支付员, `.agent` TLD命名时带有分级子注册,本体学和剖面解析器,身份维度,以及ERC-6492-有意识的UniversalSignatureValidator. 该软件包发布ABI子路径,每个网络部署JSON,平地源,以及"团结"本身——所以一个TypeScript消费者拉取地址和ABI来自审计师读取的同一件文物.

"一件文物"是CI-强制的,不是渴望的: TypeScript typehashes被锁入了"固态常数"(C`pnpm check:eip712-typehash-equality`),ABI是同步的,存储布局是快取快取(英语:`pnpm check:storage-layouts`) (中文(简体) ). 你不能让客户从链子上漂走.

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

## 里面有什么东西 `src/`

-   `AgentAccount.sol` ——UUPS可升级 + ERC-7579 + ERC-1271 + WebAuthn-支持智能代理;一个薄模块核心,其中保管,阈值和会话机制是模块,不是内嵌特性
-   `AgentAccountFactory.sol` - CREATE2确定部署;来自认证方法的盐+范围(来自名称的NEVER)
-   `SmartAgentPaymaster.sol` ——验证-付费主 + 许可列表 + devMode(仅测试网) 模式
-   `agency/DelegationManager.sol` + 键 `enforcers/{AllowedMethods,AllowedTargets,Timestamp,Value,Quorum,CallDataHash}Enforcer.sol` - 扩大授权范围,执行链上警告
-   `custody/CustodyPolicy.sol` — 16- 动作 ERC- 7579模块, T4/T5/T6 法定人数 + 24h 默认 T5 时卡
-   `naming/{AgentNameRegistry,AgentNameUniversalResolver,AgentNameAttributeResolver,PermissionlessSubregistry}.sol`
-   `identity/AgentProfileResolver.sol` + 键 `ontology/{OntologyTermRegistry,ShapeRegistry,AttributeStorage}.sol`
-   `relationships/{AgentRelationship,RelationshipTypeRegistry}.sol` (⚠ 隐私分叉-实验表面;见AUDIT.md§3.9)
-   `governance/{AgenticGovernance,GovernanceManaged}.sol` ——系统暂停+治理基础
-   `libraries/{WebAuthnLib,P256Verifier,SignatureSlotRecovery,MultiSendCallOnly}.sol` ——安全关键原始人
-   `UniversalSignatureValidator.sol` ——单一签名入站(ERC-6492 + ERC-1271 + 原始ECDSA扇出相片214 SB-4)
-   `ApprovedHashRegistry.sol` ——v=1 预先批准的散列签名路径

背后: 774号 铸造测试,包括无常套房,外加Halmos符号证明,Echidna和Medusa模糊运动,以及PR-阻塞静态分析(Slither, Aderyn, CodeQL, Solhint).

已部署地址( 塞波利亚测试网) : [`deployments-base-sepolia.json`](https://npmcn.com/package/%40agenticprimitives/contracts/deployments-base-sepolia.json) 承诺、公开和通过生成物向TypeScript消费者展示 `@agenticprimitives/contracts/deployments/base-sepolia` 子路径.

## 怎么不一样

相较于Safe,ZeroDev,或Alchemy的合同堆栈,其差异在于范围与接合. 这些项目运送一个账户(并妥善运送);信托链的其余部分——该账户是谁、它可能授权什么、保管如何收回——留给与其他供应商合同合并处理。 在这里,账户、代表团管理者、警告执行者、保管模块、命名登记和签名验证人是作为一个系统设计和审计的,共享一个身份锚。 没有第三方的多相依赖关系:监护权法定人数是我们自己的ERC-7579模块,安全式的签名包装端口是一种模式,而不是作为运行时的依赖而继承. 而消耗模型是不同的——大多数合同套件都交给你地址和一个块探索者链接;这个套件将你版本的ABI,部署,以及平地源作为npm子路径,CI-clock到消耗它们的TypeScript SDK上.

## 设置

第一次只说:

```bash
bash setup.sh    # clones OpenZeppelin, forge-std, account-abstraction into lib/
forge build
```

`setup.sh` 是无能的。 它会克隆成 `lib/` (恶作剧)而不是使用 `git submodule add` 所以这个repo不需要子模块的依赖.

## 部署到安维尔

```bash
# Start Anvil in another terminal
anvil

# Then in this directory:
pnpm deploy:anvil
```

写入已部署的地址 `deployments-anvil.json`。演示应用`apps/demo-web`, (中文(简体) ), `apps/demo-a2a`, (中文(简体) ), `apps/demo-mcp`)启动时读取此文件.

## 部署到塞波利亚基地

```bash
export BASE_SEPOLIA_RPC=https://sepolia.base.org
export PRIVATE_KEY=0x...     # funded deployer
pnpm deploy:base-sepolia
```

写给 `deployments-base-sepolia.json`. . . . . . 德莫闲置成本:~0.

## 审计态势

信任基础设施应该是你所依赖的最透明的代码,所以审计线索默认是公开的:

-   [`AUDIT.md`](https://npmcn.com/package/%40agenticprimitives/contracts/AUDIT.md) ——每份合同的安全性和不固定档案 `src/`,包括制作密钥旋转跑册(第4.1节).
-   [`docs/audits/findings.yaml`](https://npmcn.com/package/docs/audits/findings.yaml) ——现场的,CI的发现分类账;"封闭"的发现必须被锁定到真实的源头,否则构建失败.
-   [`docs/audits/2026-05-packages-contracts-production-readiness.md`](https://npmcn.com/package/docs/audits/2026-05-packages-contracts-production-readiness.md) ——逐合同调查结果档案.
-   [`CLAUDE.md`](https://npmcn.com/package/%40agenticprimitives/contracts/CLAUDE.md) ——建筑原理和每个文件角色.

## 状态

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

**有意推迟生产部署:** 测试网故意使用公开披露的部署人员EOA(它使演示可复制)。 生产旋转运行簿是 [`AUDIT.md` 第4.1节](https://npmcn.com/package/%40agenticprimitives/contracts/AUDIT.md#41-the-production-gate-open-audit-item-n1)。 。 。 .

## 递增的肿瘤脚本

| 脚本 | 添加数 | 页:1 |
| --- | --- | --- |
| `script/AddAgentTypeRoots.s.sol` | 键入根 + `atl:AgentTypeEnum` (第346节) | 一个 `PermissionlessSubregistry` 每个根 |
| `script/AddVerticalRoots.s.sol` | 应用注册的垂直根+ `atl:agentSubtype` (第346节2.4节) | 词汇是应用程序的 |
| `script/AddDistributionPredicate.s.sol` | `atl:distribution` (字符串:JSON每 `AgentDistributionV1`页:1 | 一能克; 在信仰链上运行 2026-08-30 (34348) + Base Sepolia |
| `script/AddCardPredicates.s.sol` | `atl:cardDigest` (字节32)+ `atl:cardUri` (字符串)(第347页第8.3; `UPDATE_SHAPE=true` 刷新点 `atl:AgentName` 以形状 v2 (14道具) | 一能克; 在信仰链上运行 2026-08-30 (34348) + Base Sepolia |

## 常见问题

### @agenticprimitives/contracts 是什么？

固态合同 \+ ABIs \+ 扁平源 \+ 代理主堆栈的每个网络部署地址\.

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

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

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

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

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

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

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

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

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

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

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

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