@agenticprimitives/identity-directory-adapters

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

@ agenticprimitives/identity-directory的端口执行:取名Port(wraps agent-naming),OnChainReadPort(viim readContact),IndexerPort(in-memory;SPARQL/GraphDB后期). 允许导入代理命名的单一成分层(Spec 100 §4/AD)

中文使用文档
文档目录7 节
  1. 这是什么
  2. 使用量
  3. 怎么不一样
  4. 边界
  5. 验证
  6. 状态
  7. 许可证

@ agenticprimitives/dentity-directory-adapters (原始内容存档于2018-09-22) (英语)

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

保持目录诚实的绑定层 . identity-directory 可以承诺"indexer propose, on-chain system system",仅仅因为其核心从未触及到真正的数据源——它宣布了端口,而这个软件包执行它们. 分离是强制的,不是渴望的:这是 一个允许导入的软件包 agent-naming (第100页第4节/ ADR-0015 (英语)),所以在身份堆栈中读取的每一个命名都通过一个可审核的接合来流出. 适应者将来源转换为港口,不增加自己的政策.

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

这是什么

makeNamingPort({ client, chainId })   wrap agent-naming + eip155 Address↔CanonicalAgentId lift
makeOnChainReadPort(readers)          assemble OnChainReadPort from { exists, confirmsCredential }
viemExists(client)                    a contract-agnostic exists (bytecode-at-address)
createInMemoryIndexer(entries)        an in-memory IndexerPort (demo + tests)
toCanonicalAgentId / addressOf        eip155 CAIP-10 glue

使用量

import { createDirectory } from '@agenticprimitives/identity-directory';
import {
  makeNamingPort, makeOnChainReadPort, viemExists, createInMemoryIndexer,
} from '@agenticprimitives/identity-directory-adapters';

const dir = createDirectory({
  naming: makeNamingPort({ client: namingClient, chainId: 8453 }),
  onChain: makeOnChainReadPort({
    exists: viemExists(publicClient),
    // app-wired to the real membership getter (isCustodian/isTrustee):
    confirmsCredential: async (id, p) => publicClient.readContract({ /* … */ }),
  }),
  indexer: createInMemoryIndexer(seedEntries),
});

怎么不一样

竞争模式是 单体索引器/解析器 SDK ——一个客户端,与每个源交谈,将解析政策放入数据访问. 成本后来出现:你不能互换一个源,不能审计哪个机制回答了一个查询,索引默默地成为权威. 港口和适应者在此分开表示:

  • 源可互换. 命名,上链读取,索引器是独立的工厂;一个已存在的端口的新来源是一所新工厂,而不是重写.
  • 权威安置在类型中可见. confirmsCredential 是一个实时的链上成员检查,索引员是一个提议者——界面使得无法混淆两者.
  • 没有适配器会升级. 每个端口是一个机制;没有 try naming, catch → on-chain 任何地点的后退(ADR-0013 (英语),并读作 readContract编号 :getCode 只有——从未 eth_getLogs (单位:千美元)ADR-0012 (英语)) (中文(简体) ).

边界

  • confirmsCredential 实值 应用线 ——连锁会员获得者是合同和证书类(EOA地址对密码) credentialIdDigest),所以这个包并不会猜到. 它必须反映 当前 设置为已撤销的证书返回 false (目录取出. 永远不要将其连接到缓存或事件衍生的列表中,以恢复被撤销的证书.
  • 记忆索引器是 非授权 它提出候选人;目录在链上确认候选人。 出产指数器为SPARQL/GraphDB适配器(Spec 225 §7),后起降.
  • CAIP-10在这里 eip155-只用胶水;条形多名空间构建器是 @agenticprimitives/agent-profile (单位:千美元)/caip10),故意不加入这个适配器的依赖性设定.

验证

pnpm --filter @agenticprimitives/identity-directory build   # core dist (vitest resolution)
pnpm --filter @agenticprimitives/identity-directory-adapters typecheck
pnpm --filter @agenticprimitives/identity-directory-adapters test
pnpm check:forbidden-terms

状态

测试网/飞行员准备 生产启动在根部的公开核对表上进行 README.md ——包括第三方合同审计和治理关键轮换. 追踪所有安全发现 docs/audits/findings.yaml。所发送的索引器是内存参考(demo + 测试);生产 SPARQL/GraphDB 适配器是路线图.

许可证

UNLICENSED(内部单列,未出版).

版本与发布记录

@agenticprimitives/identity-directory-adapters 共发布 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/identity-directory-adapters 的常见问题

@agenticprimitives/identity-directory-adapters 是什么?

@ agenticprimitives/identity-directory的端口执行:取名Port(wraps agent-naming),OnChainReadPort(viim readContact),IndexerPort(in-memory;SPARQL/GraphDB后期). 允许导入代理命名的单一成分层(Spec 100 §4/AD)

如何安装 @agenticprimitives/identity-directory-adapters?

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

@agenticprimitives/identity-directory-adapters 支持 TypeScript 吗?

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

@agenticprimitives/identity-directory-adapters 支持 ESM 还是 CommonJS?

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

@agenticprimitives/identity-directory-adapters 可以商用吗?

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

@agenticprimitives/identity-directory-adapters 的下载量有多少?

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

@agenticprimitives/identity-directory-adapters 还在维护吗?

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