@agenticprimitives/contracts

中文文档
1.0.0-alpha.46发布于 2026/10/26MITTypeScriptES Module零依赖近 30 天下载 4812

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

中文使用文档
文档目录8 节
  1. 里面有什么东西 src/
  2. 怎么不一样
  3. 设置
  4. 部署到安维尔
  5. 部署到塞波利亚基地
  6. 审计态势
  7. 状态
  8. 递增的肿瘤脚本

@ 代理原始/合同

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

合同和SDK是一件艺术品.

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

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

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

里面有什么东西 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 承诺、公开和通过生成物向TypeScript消费者展示 @agenticprimitives/contracts/deployments/base-sepolia 子路径.

怎么不一样

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

设置

第一次只说:

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

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

部署到安维尔

# 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)启动时读取此文件.

部署到塞波利亚基地

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

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

审计态势

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

状态

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

有意推迟生产部署: 测试网故意使用公开披露的部署人员EOA(它使演示可复制)。 生产旋转运行簿是 AUDIT.md 第4.1节。 。 。 .

递增的肿瘤脚本

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

版本与发布记录

@agenticprimitives/contracts 共发布 45 个版本,首次发布于 2026/06/01;过去 12 个月发布了 45 个版本。

版本发布日期距今
1.0.0-alpha.46latest2026/10/2612 天前
1.0.0-alpha.452026/10/2612 天前
1.0.0-alpha.442026/10/1721 天前
1.0.0-alpha.432026/10/1722 天前
1.0.0-alpha.422026/10/1622 天前
1.0.0-alpha.412026/10/1622 天前

其他发布通道:alpha → 0.1.0-alpha.2。

关于 @agenticprimitives/contracts 的常见问题

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