@agenticprimitives/delegated-signer

中文文档
0.0.0-alpha.32发布于 2026/10/26MITTypeScriptES Module零依赖近 30 天下载 1978

Generic named delegated-signer resolution — compose agent-naming + agent-account + delegation + key-custody into a signer for a named identity, authorized by a delegation chain. Vertical-agnostic; naming/account are injected.

原始使用文档

@agenticprimitives/delegated-signer

Part of Agentic Primitives — the open-source trust substrate for agentic applications: identity that can sign, authority checked at act time, evidence the owner carries. Developer kit · All packages

Generic named delegated-signer resolution (spec 276). Compose the trust primitives into one answer: "give me a signer for the named identity X, authorized by delegation chain Y."

import { resolveDelegatedSigner } from '@agenticprimitives/delegated-signer';

const resolved = await resolveDelegatedSigner({
  name: 'acme',                       // opaque label — resolved by your injected client
  signer: kmsBackend,                 // a KmsAccountBackend from @agenticprimitives/key-custody
  delegationChain: [root, leaf],      // Delegation[] from @agenticprimitives/delegation
  resolveName: async (n) => nameClient.resolve(n),     // agent-naming (injected)
  verifyAccount: async (sa) => accountClient.isValid(sa), // agent-account (injected)
  chainId: 8453,
  delegationManager: '0x…',
});

const sig = await resolved.sign(digest); // 0x-hex (r,s,v) signature by resolved.signerAddress

It verifies the name resolves, the account is valid, and the delegation chain is rooted at the named Smart Agent, link-by-link authority-bound, and terminates at the signer key — fail-closed throughout (ADR-0013). Naming and account access are injected so the package stays vertical-agnostic and a pure leaf in the dependency graph (ADR-0021). On-chain ERC-1271 signature verification of each link is delegation.verifyAuthorization's job; inject it upstream if you need it.

版本与发布记录

@agenticprimitives/delegated-signer 共发布 27 个版本,首次发布于 2026/06/17;过去 12 个月发布了 27 个版本。

版本发布日期距今
0.0.0-alpha.32latest2026/10/2612 天前
0.0.0-alpha.312026/10/1722 天前
0.0.0-alpha.302026/10/1622 天前
0.0.0-alpha.292026/10/1622 天前
0.0.0-alpha.282026/10/1622 天前
0.0.0-alpha.272026/10/1622 天前

其他发布通道:alpha → 0.0.0-alpha.1。

关于 @agenticprimitives/delegated-signer 的常见问题

@agenticprimitives/delegated-signer 是什么?

Generic named delegated-signer resolution — compose agent-naming + agent-account + delegation + key-custody into a signer for a named identity, authorized by a delegation chain. Vertical-agnostic; naming/account are injected.

如何安装 @agenticprimitives/delegated-signer?

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

@agenticprimitives/delegated-signer 支持 TypeScript 吗?

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

@agenticprimitives/delegated-signer 支持 ESM 还是 CommonJS?

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

@agenticprimitives/delegated-signer 可以商用吗?

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

@agenticprimitives/delegated-signer 的下载量有多少?

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

@agenticprimitives/delegated-signer 还在维护吗?

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