@agenticprimitives/verifiable-credentials

中文文档
0.0.0-alpha.43发布于 2026/10/26MITTypeScriptES Module近 30 天下载 9031

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

中文使用文档
文档目录4 节
  1. 今天的什么战舰
  2. 怎么不一样
  3. 状态
  4. 构建

@ agenicprimitives/可验证的证书

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

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

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

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

今天的什么战舰

  • 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 (英语)) (中文(简体) ). verifyCredentialStructural(vc) 是离线子集.
  • 木质散列 —— 说 credentialHash(vc) 编号 : canonicalHash(...) 编号 : jcsCanonicalize(...): RFC 8785 JCS散列作为下游各地的证书锚地(验收登记、金库索引、状况清单).
  • DOLCE+DnS 情况模式 —— 说 buildSituation(...) 编辑 Situation 编号 : DescriptionRef 编号 : RoleName 形状,所有底部的证书主体都与之相对.
  • 斯克马URIs —— 说 buildShapeUri 编号 : parseShapeUri 编号 : shapeHash 联 合 国 did:shape:<name>:<version> 与链上结合的公约 ShapeRegistry。 。 。 .
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 (英语)) (中文(简体) ). 而由于EIP-712文摘被CI门锁入了它的固态对应物上,合同和SDK都是一件文物——客户端不能从链上漂出,这正是缝合的VC堆积衰变的地方.

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

状态

W1基础——已实施并具有安全负荷. 信封、证明、罐头散列和核查船今天由下游货包行使;核查结论VC-1/VC-2关闭(见 审计替代证明类型(BBS+ / SD-JWT / AnonCreds)有一个预留的信封槽,并在以后的波浪中着陆 W1执行波计划。 。 。 .

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

权威规格 : specs/242-trust-credentials-and-public-assertions.md §4——见: spec.md 为同音节。 外壳: CLAUDE.md + 键 capability.manifest.json。 。 。 .

构建

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

版本与发布记录

@agenticprimitives/verifiable-credentials 共发布 42 个版本,首次发布于 2026/06/08;过去 12 个月发布了 42 个版本。

版本发布日期距今
0.0.0-alpha.43latest2026/10/2610 天前
0.0.0-alpha.422026/10/2610 天前
0.0.0-alpha.412026/10/1720 天前
0.0.0-alpha.402026/10/1720 天前
0.0.0-alpha.392026/10/1620 天前
0.0.0-alpha.382026/10/1620 天前

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

关于 @agenticprimitives/verifiable-credentials 的常见问题

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