@agenticprimitives/privacy-credentials

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

隐私演示层(spec 305 / G-6):有选择地公开了SD-JWT VC演示,对等关系假名,spec-304发卡-键面验证. 每个请求一个套房,从不退后阶梯.

中文使用文档
文档目录3 节
  1. 它会做什么
  2. 设计规则
  3. 状态

@ agenticprimitives/ privoy- creditifics (原始内容存档于2018-09-31) (英语)

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

隐私显示层 将金库持有的证书有选择地公开, 双向- 假名演示文稿 核查员可以检查,而不学习更多 交易需要.

谱: specs/305-privacy-credentials.md · 发行人密钥: specs/304-issuer-key-facets.md 理论:ADR-0010 修正(“智能代理地址”是问责根,而不是默认的演示文稿 标识符”和 校正审计 §6.2(eIDAS 2.0 第5a条作出选择性披露+欧盟市场准入要求不相通).

它会做什么

import {
  issueSdJwt, presentSdJwt, verifyPresentation,
  generateHolderSecret, pairwiseHandle,
  createIssuerKeyResolver,
} from '@agenticprimitives/privacy-credentials';

// ISSUER (an org SA with a spec-304 facet key; sign = injected KMS ES256):
const credential = await issueSdJwt({
  issuer: orgCaip10, keyId: 'issuer-key:sd-jwt:2026-07', vct: 'ap:procurement-delegate',
  sdClaims: { authorizedRole: 'procurement.delegate', counterpartyClass: 'approved.vendor' },
  holderPublicKeyJwk, sign: kmsEs256Signer,
});
// → into the holder's vault.

// HOLDER (presents to ONE verifier, revealing ONE claim):
const handle = await pairwiseHandle(holderSecret, 'vendor.example'); // stable HERE, unlinkable elsewhere
const payload = await presentSdJwt({
  sdJwt: credential, discloseClaims: ['authorizedRole'],
  audience: request.audience, nonce: request.nonce, holderSign,
});

// VERIFIER (no AP runtime needed — chain checks injected):
const resolveIssuerKey = createIssuerKeyResolver(lookupSignedFacet, {
  verifySaSignature,   // UniversalSignatureValidator read
  checkAttestation,    // AttestationRegistry liveness read
});
const res = await verifyPresentation(
  { type: 'PrivatePresentationV1', suite: 'sd-jwt', relationshipHandle: handle, payload },
  request,
  { resolveIssuerKey },
);
// res.claims === { authorizedRole: 'procurement.delegate' } — and nothing else.

核查人得知:它要求的声称,即由监护管理的智能特工签发的(通过 键绑定 (原始内容存档于2018-09-29). this attention + nonce. 没错 没有 了解持有者的SA, 其他权利要求,或任何东西 将本演示文稿与同一持有人在其他地方的发言相链接.

设计规则

  • 每个证明请求一个套房 (ADR-0013): (英语) sd-jwt (在双向情况下选择性披露索赔价值) 假名)和 openac-sd-jwt-p256 (零知识前提于相同的证书——无价值、无证书、无证书、无证书) 签发人签名,没有设备密钥到达核查人; bbs-bls12381-g2, (中文(简体) ), anoncreds-v1 财务报告和审定财务报表 zk-predicate 为: 预留的enum 槽拒绝, 绝不是后退阶梯.
  • 在 sd-jwt 上表示拒绝 那个套房不能证明 amount <= limit;拒绝无声地透露 字段。 带有上游名称的请求 openac-sd-jwt-p256,其验证后端被注入 (单位:千美元)ProvingBackendPort· ; @agenticprimitives/privacy-credentials-openac 绑起openac-sdk.
  • 每个观众一次: 演示文稿可能带有作废者(deriveNullifier),确定每个设备的密钥 和观众, 核查员的商店消耗。 它的等级是 asserted ——OpenAC在回路中不发出失效器 收据是这么说的.
  • 发行方第一: 被撤销或无法解决的 spec-304 面值失败整个演示文稿.
  • 无依赖(只有WebCrypto——节点20和工人d);链读和KMS签名是 注入端口.

状态

活(zkID Z1–Z6, 第444段): sd-jwt 带有对称假名的套件 openac-sd-jwt-p256 上游套间 超过一个注入的验证端口; spec-304 发行方侧面通过链条解决并重新验证; 无效; 状态 针对发行人现场证照行的演示文稿(@agenticprimitives/estate-projection) (中文(简体) ). 联邦之门 在"18岁以上和你的组织成员"上收录无名访问者,并持有该组织自己的证书 已发行代理和密钥服务所持有的设备密钥 。 储备:BBS、AnonCreds和一个电路绝缘器.

版本与发布记录

@agenticprimitives/privacy-credentials 共发布 21 个版本,首次发布于 2026/07/14;过去 12 个月发布了 21 个版本。

版本发布日期距今
0.0.0-alpha.21latest2026/10/2612 天前
0.0.0-alpha.202026/10/1722 天前
0.0.0-alpha.192026/10/1622 天前
0.0.0-alpha.182026/10/1622 天前
0.0.0-alpha.172026/10/1622 天前
0.0.0-alpha.162026/10/1622 天前

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

@agenticprimitives/privacy-credentials 是什么?

隐私演示层(spec 305 / G-6):有选择地公开了SD-JWT VC演示,对等关系假名,spec-304发卡-键面验证. 每个请求一个套房,从不退后阶梯.

如何安装 @agenticprimitives/privacy-credentials?

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

@agenticprimitives/privacy-credentials 支持 TypeScript 吗?

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

@agenticprimitives/privacy-credentials 支持 ESM 还是 CommonJS?

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

@agenticprimitives/privacy-credentials 可以商用吗?

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

@agenticprimitives/privacy-credentials 的下载量有多少?

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

@agenticprimitives/privacy-credentials 还在维护吗?

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