# @agenticprimitives/privacy-credentials 中文文档

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

版本：0\.0\.0-alpha\.21
npm 元数据更新时间：2026-10-26T11:06:56.820Z
中文译文更新时间：2026-11-06T18:23:28.803Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：124 kB，35 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@agenticprimitives/types ^1\.0\.0-alpha\.45
- 首次发布：2026-07-14T15:51:55.286Z
- 最新版本发布：2026-10-26T11:06:56.586Z
- 近 30 天下载量：2496（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

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

## 安装

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

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

## README

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

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

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

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

## 它会做什么

```ts
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 是什么？

隐私演示层\(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 和提交记录判断。