# @agenticprimitives/identity-directory-adapters 中文文档

规范地址：https://npmcn.com/package/%40agenticprimitives/identity-directory-adapters/

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

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

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

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

- 包体积（解压后）：24.5 kB，24 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 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
- 首次发布：2026-05-31T17:13:12.308Z
- 最新版本发布：2026-10-26T11:49:57.375Z
- 近 30 天下载量：4038（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：45（近 12 个月 45 个）

## 中文简介

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

## 安装

```sh
npm install @agenticprimitives/identity-directory-adapters
```

也可以使用：`pnpm add @agenticprimitives/identity-directory-adapters`、`yarn add @agenticprimitives/identity-directory-adapters`、`bun add @agenticprimitives/identity-directory-adapters`

## README

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

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

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

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

## 这是什么

```
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
```

## 使用量

```ts
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 (英语)](https://npmcn.com/package/docs/architecture/decisions/0013-no-silent-fallbacks.md),并读作 `readContract`编号 :`getCode` 只有——从未 `eth_getLogs` (单位:千美元)[ADR-0012 (英语)](https://npmcn.com/package/docs/architecture/decisions/0012-no-eth-getlogs-in-product-read-paths.md)) (中文(简体) ).

## 边界

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

## 验证

```bash
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`](https://npmcn.com/package/README.md#status--honest-version) ——包括第三方合同审计和治理关键轮换. 追踪所有安全发现 [`docs/audits/findings.yaml`](https://npmcn.com/package/docs/audits/findings.yaml)。所发送的索引器是内存参考(demo + 测试);生产 SPARQL/GraphDB 适配器是路线图.

## 许可证

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

## 常见问题

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