# @agenticprimitives/verifiable-credentials 中文文档

规范地址：https://npmcn.com/package/%40agenticprimitives/verifiable-credentials/

版本：0\.0\.0-alpha\.43
npm 元数据更新时间：2026-10-26T11:50:58.840Z
中文译文更新时间：2026-11-05T23:46:57.225Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：83.8 kB，32 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：viem ^2\.52\.2，@agenticprimitives/types ^1\.0\.0-alpha\.46，@agenticprimitives/ontology ^1\.0\.0-alpha\.46
- 首次发布：2026-06-07T23:27:09.858Z
- 最新版本发布：2026-10-26T11:50:37.026Z
- 近 30 天下载量：9031（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：42（近 12 个月 42 个）

## 中文简介

W3C 验证的证书信封 + Eip712 签名2026 证明 + DOLCE+ DnS 情况基础+本体学-形状分型计划注册. 12–15层证书类型的底物.

## 安装

```sh
npm install @agenticprimitives/verifiable-credentials
```

也可以使用：`pnpm add @agenticprimitives/verifiable-credentials`、`yarn add @agenticprimitives/verifiable-credentials`、`bun add @agenticprimitives/verifiable-credentials`

## README

# @ agenicprimitives/可验证的证书

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

**证明书的耐用性只有它指向的身份.** 大多数可核查的-信用堆栈将债权绑入一个密钥——当密钥旋转时,信任图会悄悄地破裂. 在这里,每个证书的签发人和对象都是一个智能代理地址:一个持久的ERC-4337账户,其密钥是可替换的方面. 旋转一个密码,从丢失的设备中取回,交换一个签名器——地址持续存在,每个由它或有关它发出的证书都保持可核查性.

这个包是用于该模型的 W3C VC 2.0 信封: a `Eip712Signature2026` 由智能账户签署并用ERC-1271对链进行回路验证的证明,加上RFC 8785 (JCS) Canonical hash,每个下游的登记册都作为链上锚储存. 它是底物层——特定的证书类型(协会,协议,证据,结果,收据)由消费者包组成.

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

## 今天的什么战舰

-   **W3C VC 2.0 信封** —— 说 `@context`, (中文(简体) ), `type`, (中文(简体) ), `issuer`, (中文(简体) ), `validFrom`, (中文(简体) ), `credentialSubject`, (中文(简体) ), `proof`, (中文(简体) ), `credentialStatus` (单位:千美元)`VerifiableCredential`, (中文(简体) ), `UnsignedCredential` 类型).
-   **`Eip712Signature2026` 证明** —— 说 `signCredential(unsigned, signer)` 出示证据; `eip712Digest(...)` 匹配固态验证字节换字节(交叉-stack打字平等,CI-gated per spec 242 §4.3).
-   **验证人** —— 说 `verifyCredential(vc, client)` 运行结构检查,重新计算摘要,并通过ERC-1271对发行人的"智能代理"验证发行人的签名. 一种机制,没有无声回落([ADR-0013 (英语)](https://npmcn.com/package/docs/architecture/decisions/0013-no-silent-fallbacks.md)) (中文(简体) ). `verifyCredentialStructural(vc)` 是离线子集.
-   **木质散列** —— 说 `credentialHash(vc)` 编号 : `canonicalHash(...)` 编号 : `jcsCanonicalize(...)`: RFC 8785 JCS散列作为下游各地的证书锚地(验收登记、金库索引、状况清单).
-   **DOLCE+DnS 情况模式** —— 说 `buildSituation(...)` 编辑 `Situation` 编号 : `DescriptionRef` 编号 : `RoleName` 形状,所有底部的证书主体都与之相对.
-   **斯克马URIs** —— 说 `buildShapeUri` 编号 : `parseShapeUri` 编号 : `shapeHash` 联 合 国 `did:shape:<name>:<version>` 与链上结合的公约 `ShapeRegistry`。 。 。 .

```ts
import { credentialHash, verifyCredential } from '@agenticprimitives/verifiable-credentials';

const anchor = credentialHash(vc);                 // RFC 8785 JCS hash — what registries store
const result = await verifyCredential(vc, client); // ERC-1271 round-trip against the issuer Smart Agent
```

## 怎么不一样

Veramo、Trinsic和更广泛的W3C VC通过DD方法和关键登记册使生态系统解析问题发布者工具化——因此,可信性与关键材料相结合。 这里的发行商是 CAIP-10 智能账户地址 **密钥旋转, 地址持续, 证书存续恢复** (单位:千美元)[ADR-0011 (英语)](https://npmcn.com/package/docs/architecture/decisions/0011-credential-recovery-and-re-association.md)) (中文(简体) ). 而由于EIP-712文摘被CI门锁入了它的固态对应物上,合同和SDK都是一件文物——客户端不能从链上漂出,这正是缝合的VC堆积衰变的地方.

包子是刻意取出一叶:它只进口 `types`, (中文(简体) ), `ontology`, (中文(简体) ), `viem`,以及 `@noble/hashes`,并且没有定义具体的证书类型—— `attestations`, (中文(简体) ), `agreements`, (中文(简体) ), `fulfillment`,以及 `payments` 拥有这些.

## 状态

**W1基础——已实施并具有安全负荷.** 信封、证明、罐头散列和核查船今天由下游货包行使;核查结论VC-1/VC-2关闭(见 [审计](https://npmcn.com/package/%40agenticprimitives/verifiable-credentials/AUDIT.md)替代证明类型(BBS+ / SD-JWT / AnonCreds)有一个预留的信封槽,并在以后的波浪中着陆 [W1执行波计划](https://npmcn.com/package/docs/architecture/w1-implementation-wave-plan.md)。 。 。 .

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

**权威规格 :** [`specs/242-trust-credentials-and-public-assertions.md`](https://npmcn.com/package/specs/242-trust-credentials-and-public-assertions.md) §4——见: `spec.md` 为同音节。 外壳: `CLAUDE.md` + 键 `capability.manifest.json`。 。 。 .

## 构建

```bash
pnpm --filter @agenticprimitives/verifiable-credentials typecheck
pnpm --filter @agenticprimitives/verifiable-credentials test
pnpm --filter @agenticprimitives/verifiable-credentials build
```

## 常见问题

### @agenticprimitives/verifiable-credentials 是什么？

W3C 验证的证书信封 \+ Eip712 签名2026 证明 \+ DOLCE\+ DnS 情况基础\+本体学-形状分型计划注册\. 12–15层证书类型的底物\.

### 如何安装 @agenticprimitives/verifiable-credentials？

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

### @agenticprimitives/verifiable-credentials 支持 TypeScript 吗？

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

### @agenticprimitives/verifiable-credentials 支持 ESM 还是 CommonJS？

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

### @agenticprimitives/verifiable-credentials 可以商用吗？

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

### @agenticprimitives/verifiable-credentials 的下载量有多少？

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

### @agenticprimitives/verifiable-credentials 还在维护吗？

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