@jccdex/vc-vocabularies 0.1.1

package/README.md

@@ -0,0 +1,100 @@
+# @jccdex/vc-vocabularies
+
+VC 业务词汇表与签发 Profile，配合 [`@jccdex/did`](../did) 的 `issueVC()` 使用。
+
+## 安装
+
+```bash
+yarn add @jccdex/vc-vocabularies @jccdex/did
+```
+
+## 快速开始
+
+使用 Profile 组装签发描述符，再交给 DID SDK 签名：
+
+```typescript
+import { issueVC } from "@jccdex/did";
+import { buildNftOwnershipDescriptor } from "@jccdex/vc-vocabularies";
+
+const descriptor = buildNftOwnershipDescriptor(
+  "ccdao", // 品牌：ccdao | jdid
+  {
+    id: holderDid,
+    owner: holderDid,
+    chainId: 1,
+    tokenId: "123",
+    contractAddress: "0x...",
+    standard: "ERC-721",
+    status: "Active",
+  },
+  {
+    id: `${holderDid}#vc-1`,
+    expirationDate: "2099-01-01T00:00:00.000Z",
+  }
+);
+
+const vcJSON = await issueVC(descriptor, { sign, keyDoc });
+```
+
+`subject` 由调用方按业务填写；Profile 负责组装 `types` 与 `@context`，签名由 `@jccdex/did` 完成。
+
+## 主要 API
+
+| 导出 | 说明 |
+|------|------|
+| `buildNftOwnershipDescriptor` | NFT 所有权 VC |
+| `buildNftUsageAuthorizationDescriptor` | NFT 授权 VC |
+| `buildPhoneVerificationDescriptor` | 电话验证 VC |
+| `buildInlineContext` | 按字段生成最小内联 `@context` |
+| `VC_TYPES` | VC 业务类型常量 |
+| `getNftOwnershipContext` 等 | 按品牌获取内联 context 对象 |
+
+品牌 ID：`"ccdao"`（`ccda.ooo`）、`"jdid"`（`jdid.cn`）。
+
+## 自定义 Descriptor
+
+不经过 Profile 时，可自行组装后调用 `issueVC`：
+
+```typescript
+import {
+  buildInlineContext,
+  VC_TYPES,
+  W3C_VC_CONTEXT_URL,
+} from "@jccdex/vc-vocabularies";
+
+const descriptor = {
+  types: [VC_TYPES.NFT_OWNERSHIP],
+  contexts: [
+    W3C_VC_CONTEXT_URL,
+    buildInlineContext("jdid", {
+      types: ["NFTOwnership"],
+      fields: ["chainId", "tokenId", "tokenName", "nftIssuer", "owner", "standard", "status"],
+    }),
+  ],
+  subject: { id: holderDid, /* ... */ },
+  id: `${holderDid}#vc-1`,
+  expirationDate: "2099-01-01T00:00:00.000Z",
+};
+```
+
+## 词汇表 JSON（高级）
+
+验签缓存与品牌服务器部署使用 `contexts/*.json`，可通过子路径引用：
+
+```javascript
+import jdidDidV1 from "@jccdex/vc-vocabularies/contexts/jdid-did-v1.json";
+```
+
+一般由 `@jccdex/did` 内部引用，应用层通常无需直接 import。
+
+## 开发
+
+```bash
+yarn build
+yarn test
+```
+
+## 相关包
+
+- [`@jccdex/did`](../did) — DID 文档与 VC 签发/验签
+- [`did_DApp`](../did_DApp) — 参考集成示例

package/lib/brands/ccdao.d.ts

@@ -0,0 +1,3 @@
+/** CCDAO 品牌（EVM 链）的 DID / VC 词汇表根 URL，术语 URI 形如 {url}#tokenId */
+export declare const CCDAO_DID_VOCAB_URL = "https://ccda.ooo/did/v1";
+export declare const CCDAO_VC_VOCAB_URL = "https://ccda.ooo/vc/v1";

package/lib/brands/ccdao.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CCDAO_VC_VOCAB_URL = exports.CCDAO_DID_VOCAB_URL = void 0;
+/** CCDAO 品牌（EVM 链）的 DID / VC 词汇表根 URL，术语 URI 形如 {url}#tokenId */
+exports.CCDAO_DID_VOCAB_URL = "https://ccda.ooo/did/v1";
+exports.CCDAO_VC_VOCAB_URL = "https://ccda.ooo/vc/v1";

package/lib/brands/jdid.d.ts

@@ -0,0 +1,3 @@
+/** JDID 品牌（SWTC 链）的 DID / VC 词汇表根 URL */
+export declare const JDID_DID_VOCAB_URL = "https://jdid.cn/did/v1";
+export declare const JDID_VC_VOCAB_URL = "https://jdid.cn/vc/v1";

package/lib/brands/jdid.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JDID_VC_VOCAB_URL = exports.JDID_DID_VOCAB_URL = void 0;
+/** JDID 品牌（SWTC 链）的 DID / VC 词汇表根 URL */
+exports.JDID_DID_VOCAB_URL = "https://jdid.cn/did/v1";
+exports.JDID_VC_VOCAB_URL = "https://jdid.cn/vc/v1";

package/lib/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @jccdex/vc-vocabularies 包入口。
+ *
+ * 职责：品牌词汇表 URL、内联 context 预设、VC 类型常量、签发 Profile。
+ * 协议能力（issueVC / verifyVC）在 @jccdex/did，本包只描述「签什么」不描述「怎么签」。
+ */
+export * from "./brands/ccdao.js";
+export * from "./brands/jdid.js";
+export * from "./inline-contexts.js";
+export * from "./types.js";
+export * from "./vc-types.js";
+export { buildNftOwnershipDescriptor } from "./profiles/nft-ownership.js";
+export { buildNftUsageAuthorizationDescriptor } from "./profiles/nft-usage-authorization.js";
+export { buildPhoneVerificationDescriptor } from "./profiles/phone-verification.js";
+import { buildNftOwnershipDescriptor } from "./profiles/nft-ownership.js";
+import { buildNftUsageAuthorizationDescriptor } from "./profiles/nft-usage-authorization.js";
+import { buildPhoneVerificationDescriptor } from "./profiles/phone-verification.js";
+/** 按业务场景索引的 Profile 注册表，便于 DApp 动态选择签发模板 */
+export declare const profiles: {
+    nftOwnership: {
+        buildDescriptor: typeof buildNftOwnershipDescriptor;
+    };
+    nftUsageAuthorization: {
+        buildDescriptor: typeof buildNftUsageAuthorizationDescriptor;
+    };
+    phoneVerification: {
+        buildDescriptor: typeof buildPhoneVerificationDescriptor;
+    };
+};

package/lib/index.js

@@ -0,0 +1,45 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.profiles = exports.buildPhoneVerificationDescriptor = exports.buildNftUsageAuthorizationDescriptor = exports.buildNftOwnershipDescriptor = void 0;
+/**
+ * @jccdex/vc-vocabularies 包入口。
+ *
+ * 职责：品牌词汇表 URL、内联 context 预设、VC 类型常量、签发 Profile。
+ * 协议能力（issueVC / verifyVC）在 @jccdex/did，本包只描述「签什么」不描述「怎么签」。
+ */
+__exportStar(require("./brands/ccdao.js"), exports);
+__exportStar(require("./brands/jdid.js"), exports);
+__exportStar(require("./inline-contexts.js"), exports);
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./vc-types.js"), exports);
+var nft_ownership_js_1 = require("./profiles/nft-ownership.js");
+Object.defineProperty(exports, "buildNftOwnershipDescriptor", { enumerable: true, get: function () { return nft_ownership_js_1.buildNftOwnershipDescriptor; } });
+var nft_usage_authorization_js_1 = require("./profiles/nft-usage-authorization.js");
+Object.defineProperty(exports, "buildNftUsageAuthorizationDescriptor", { enumerable: true, get: function () { return nft_usage_authorization_js_1.buildNftUsageAuthorizationDescriptor; } });
+var phone_verification_js_1 = require("./profiles/phone-verification.js");
+Object.defineProperty(exports, "buildPhoneVerificationDescriptor", { enumerable: true, get: function () { return phone_verification_js_1.buildPhoneVerificationDescriptor; } });
+const nft_ownership_js_2 = require("./profiles/nft-ownership.js");
+const nft_usage_authorization_js_2 = require("./profiles/nft-usage-authorization.js");
+const phone_verification_js_2 = require("./profiles/phone-verification.js");
+/** 按业务场景索引的 Profile 注册表，便于 DApp 动态选择签发模板 */
+exports.profiles = {
+    nftOwnership: { buildDescriptor: nft_ownership_js_2.buildNftOwnershipDescriptor },
+    nftUsageAuthorization: {
+        buildDescriptor: nft_usage_authorization_js_2.buildNftUsageAuthorizationDescriptor
+    },
+    phoneVerification: { buildDescriptor: phone_verification_js_2.buildPhoneVerificationDescriptor }
+};

package/lib/inline-contexts.d.ts

@@ -0,0 +1,199 @@
+/**
+ * 品牌内联 context 定义。
+ *
+ * 品牌（ccdao / jdid）仅区分国内外词汇表 URL 命名空间，术语字段集相同。
+ * 链差异（EVM 用 contractAddress、SWTC 用 tokenName/nftIssuer）由应用层 subject 决定，
+ * 不在词汇层按品牌或链裁剪。
+ *
+ * 维护原则：只增不删、不改 URI（append-only）。
+ */
+import type { BrandId } from "./types.js";
+export declare const W3C_VC_CONTEXT_URL = "https://www.w3.org/2018/credentials/v1";
+/** 统一 NFTOwnership 术语集，品牌只替换 URL 前缀 */
+export declare function buildNftOwnershipContext(brand: BrandId): {
+    NFTOwnership: string;
+    version: "https://ccda.ooo/did/v1" | "https://jdid.cn/did/v1";
+    chainId: string;
+    contractAddress: string;
+    tokenName: string;
+    tokenId: string;
+    owner: string;
+    nftIssuer: string;
+    standard: string;
+    status: string;
+};
+/** 统一 NFTUsageAuthorization 术语集 */
+export declare function buildNftUsageAuthorizationContext(brand: BrandId): {
+    NFTUsageAuthorization: string;
+    version: "https://ccda.ooo/did/v1" | "https://jdid.cn/did/v1";
+    grantee: string;
+    usageRights: string;
+    restrictions: {
+        "@id": string;
+        "@context": {
+            commercial: string;
+            derivative: string;
+            sublicense: string;
+            territories: string;
+            platforms: string;
+        };
+    };
+    chainId: string;
+    contractAddress: string;
+    tokenName: string;
+    tokenId: string;
+    owner: string;
+    nftIssuer: string;
+    standard: string;
+    status: string;
+};
+/** DID 文档 version 内联 context */
+export declare function buildVersionContext(brand: BrandId): {
+    version: "https://ccda.ooo/did/v1" | "https://jdid.cn/did/v1";
+    credentials: string;
+};
+/** 电话验证 VC 术语集（两品牌结构相同，仅 URL 不同） */
+export declare function buildPhoneVerificationContext(brand: BrandId): {
+    PhoneVerificationCredential: string;
+    version: "https://ccda.ooo/did/v1" | "https://jdid.cn/did/v1";
+    standard: string;
+    status: string;
+    verificationMethod: string;
+    verificationProcess: {
+        "@id": string;
+        "@context": {
+            verifiedAt: string;
+            updateAt: string;
+            verifierId: string;
+        };
+    };
+};
+/** 便捷 getter，供 DApp / Profile 使用 */
+export declare const getNftOwnershipContext: typeof buildNftOwnershipContext;
+export declare const getNftUsageAuthorizationContext: typeof buildNftUsageAuthorizationContext;
+export declare const getVersionContext: typeof buildVersionContext;
+export declare const getPhoneVerificationContext: typeof buildPhoneVerificationContext;
+/** 向后兼容的具名导出（结构已统一，仅 URL 命名空间不同） */
+export declare const CCDAO_NFT_OWNERSHIP_CONTEXT: {
+    NFTOwnership: string;
+    version: "https://ccda.ooo/did/v1" | "https://jdid.cn/did/v1";
+    chainId: string;
+    contractAddress: string;
+    tokenName: string;
+    tokenId: string;
+    owner: string;
+    nftIssuer: string;
+    standard: string;
+    status: string;
+};
+export declare const JDID_NFT_OWNERSHIP_CONTEXT: {
+    NFTOwnership: string;
+    version: "https://ccda.ooo/did/v1" | "https://jdid.cn/did/v1";
+    chainId: string;
+    contractAddress: string;
+    tokenName: string;
+    tokenId: string;
+    owner: string;
+    nftIssuer: string;
+    standard: string;
+    status: string;
+};
+export declare const CCDAO_NFT_USAGE_AUTHORIZATION_CONTEXT: {
+    NFTUsageAuthorization: string;
+    version: "https://ccda.ooo/did/v1" | "https://jdid.cn/did/v1";
+    grantee: string;
+    usageRights: string;
+    restrictions: {
+        "@id": string;
+        "@context": {
+            commercial: string;
+            derivative: string;
+            sublicense: string;
+            territories: string;
+            platforms: string;
+        };
+    };
+    chainId: string;
+    contractAddress: string;
+    tokenName: string;
+    tokenId: string;
+    owner: string;
+    nftIssuer: string;
+    standard: string;
+    status: string;
+};
+export declare const JDID_NFT_USAGE_AUTHORIZATION_CONTEXT: {
+    NFTUsageAuthorization: string;
+    version: "https://ccda.ooo/did/v1" | "https://jdid.cn/did/v1";
+    grantee: string;
+    usageRights: string;
+    restrictions: {
+        "@id": string;
+        "@context": {
+            commercial: string;
+            derivative: string;
+            sublicense: string;
+            territories: string;
+            platforms: string;
+        };
+    };
+    chainId: string;
+    contractAddress: string;
+    tokenName: string;
+    tokenId: string;
+    owner: string;
+    nftIssuer: string;
+    standard: string;
+    status: string;
+};
+export declare const CCDAO_VERSION_CONTEXT: {
+    version: "https://ccda.ooo/did/v1" | "https://jdid.cn/did/v1";
+    credentials: string;
+};
+export declare const JDID_VERSION_CONTEXT: {
+    version: "https://ccda.ooo/did/v1" | "https://jdid.cn/did/v1";
+    credentials: string;
+};
+export declare const CCDAO_PHONE_VERIFICATION_CONTEXT: {
+    PhoneVerificationCredential: string;
+    version: "https://ccda.ooo/did/v1" | "https://jdid.cn/did/v1";
+    standard: string;
+    status: string;
+    verificationMethod: string;
+    verificationProcess: {
+        "@id": string;
+        "@context": {
+            verifiedAt: string;
+            updateAt: string;
+            verifierId: string;
+        };
+    };
+};
+export declare const JDID_PHONE_VERIFICATION_CONTEXT: {
+    PhoneVerificationCredential: string;
+    version: "https://ccda.ooo/did/v1" | "https://jdid.cn/did/v1";
+    standard: string;
+    status: string;
+    verificationMethod: string;
+    verificationProcess: {
+        "@id": string;
+        "@context": {
+            verifiedAt: string;
+            updateAt: string;
+            verifierId: string;
+        };
+    };
+};
+/**
+ * 按本次签发需要的字段，生成最小内联 @context 对象。
+ *
+ * @example
+ * // 仅解释 tokenId、owner，不会带上 contractAddress
+ * buildInlineContext("ccdao", { types: ["NFTOwnership"], fields: ["tokenId", "owner"] })
+ *
+ * 未传 fields 时返回该类型的完整预设（与 Profile 行为一致）。
+ */
+export declare function buildInlineContext(brand: BrandId, opts: {
+    types: string[];
+    fields?: string[];
+}): Record<string, unknown>;

package/lib/inline-contexts.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JDID_PHONE_VERIFICATION_CONTEXT = exports.CCDAO_PHONE_VERIFICATION_CONTEXT = exports.JDID_VERSION_CONTEXT = exports.CCDAO_VERSION_CONTEXT = exports.JDID_NFT_USAGE_AUTHORIZATION_CONTEXT = exports.CCDAO_NFT_USAGE_AUTHORIZATION_CONTEXT = exports.JDID_NFT_OWNERSHIP_CONTEXT = exports.CCDAO_NFT_OWNERSHIP_CONTEXT = exports.getPhoneVerificationContext = exports.getVersionContext = exports.getNftUsageAuthorizationContext = exports.getNftOwnershipContext = exports.W3C_VC_CONTEXT_URL = void 0;
+exports.buildNftOwnershipContext = buildNftOwnershipContext;
+exports.buildNftUsageAuthorizationContext = buildNftUsageAuthorizationContext;
+exports.buildVersionContext = buildVersionContext;
+exports.buildPhoneVerificationContext = buildPhoneVerificationContext;
+exports.buildInlineContext = buildInlineContext;
+const ccdao_js_1 = require("./brands/ccdao.js");
+const jdid_js_1 = require("./brands/jdid.js");
+exports.W3C_VC_CONTEXT_URL = "https://www.w3.org/2018/credentials/v1";
+const BRAND_URLS = {
+    ccdao: { did: ccdao_js_1.CCDAO_DID_VOCAB_URL, vc: ccdao_js_1.CCDAO_VC_VOCAB_URL },
+    jdid: { did: jdid_js_1.JDID_DID_VOCAB_URL, vc: jdid_js_1.JDID_VC_VOCAB_URL }
+};
+function vocab(brand) {
+    return BRAND_URLS[brand];
+}
+/** 统一 NFTOwnership 术语集，品牌只替换 URL 前缀 */
+function buildNftOwnershipContext(brand) {
+    const { did, vc } = vocab(brand);
+    return {
+        NFTOwnership: `${vc}#NFTOwnership`,
+        version: did,
+        chainId: `${did}#chainId`,
+        contractAddress: `${did}#contractAddress`,
+        tokenName: `${did}#tokenName`,
+        tokenId: `${did}#tokenId`,
+        owner: `${did}#owner`,
+        nftIssuer: `${did}#nftIssuer`,
+        standard: `${did}#standard`,
+        status: `${did}#status`
+    };
+}
+/** 统一 NFTUsageAuthorization 术语集 */
+function buildNftUsageAuthorizationContext(brand) {
+    const { did, vc } = vocab(brand);
+    return {
+        NFTUsageAuthorization: `${vc}#NFTUsageAuthorization`,
+        version: did,
+        grantee: `${vc}#grantee`,
+        usageRights: `${vc}#usageRights`,
+        restrictions: {
+            "@id": `${vc}#restrictions`,
+            "@context": {
+                commercial: `${vc}#commercial`,
+                derivative: `${vc}#derivative`,
+                sublicense: `${vc}#sublicense`,
+                territories: `${vc}#territories`,
+                platforms: `${vc}#platforms`
+            }
+        },
+        chainId: `${did}#chainId`,
+        contractAddress: `${did}#contractAddress`,
+        tokenName: `${did}#tokenName`,
+        tokenId: `${did}#tokenId`,
+        owner: `${did}#owner`,
+        nftIssuer: `${did}#nftIssuer`,
+        standard: `${did}#standard`,
+        status: `${did}#status`
+    };
+}
+/** DID 文档 version 内联 context */
+function buildVersionContext(brand) {
+    const { did } = vocab(brand);
+    return {
+        version: did,
+        credentials: `${did}#credentials`
+    };
+}
+/** 电话验证 VC 术语集（两品牌结构相同，仅 URL 不同） */
+function buildPhoneVerificationContext(brand) {
+    const { did, vc } = vocab(brand);
+    return {
+        PhoneVerificationCredential: `${vc}#PhoneVerificationCredential`,
+        version: did,
+        standard: `${did}#standard`,
+        status: `${did}#status`,
+        verificationMethod: `${did}#verificationMethod`,
+        verificationProcess: {
+            "@id": `${did}#verificationProcess`,
+            "@context": {
+                verifiedAt: `${did}#verifiedAt`,
+                updateAt: `${did}#updateAt`,
+                verifierId: `${did}#verifierId`
+            }
+        }
+    };
+}
+/** 便捷 getter，供 DApp / Profile 使用 */
+exports.getNftOwnershipContext = buildNftOwnershipContext;
+exports.getNftUsageAuthorizationContext = buildNftUsageAuthorizationContext;
+exports.getVersionContext = buildVersionContext;
+exports.getPhoneVerificationContext = buildPhoneVerificationContext;
+/** 向后兼容的具名导出（结构已统一，仅 URL 命名空间不同） */
+exports.CCDAO_NFT_OWNERSHIP_CONTEXT = buildNftOwnershipContext("ccdao");
+exports.JDID_NFT_OWNERSHIP_CONTEXT = buildNftOwnershipContext("jdid");
+exports.CCDAO_NFT_USAGE_AUTHORIZATION_CONTEXT = buildNftUsageAuthorizationContext("ccdao");
+exports.JDID_NFT_USAGE_AUTHORIZATION_CONTEXT = buildNftUsageAuthorizationContext("jdid");
+exports.CCDAO_VERSION_CONTEXT = buildVersionContext("ccdao");
+exports.JDID_VERSION_CONTEXT = buildVersionContext("jdid");
+exports.CCDAO_PHONE_VERIFICATION_CONTEXT = buildPhoneVerificationContext("ccdao");
+exports.JDID_PHONE_VERIFICATION_CONTEXT = buildPhoneVerificationContext("jdid");
+const VC_TYPE_BUILDERS = {
+    NFTOwnership: buildNftOwnershipContext,
+    NFTUsageAuthorization: buildNftUsageAuthorizationContext,
+    PhoneVerificationCredential: buildPhoneVerificationContext
+};
+/** 从完整词汇表中仅取出 fields 列出的键，用于「最小内联 context」 */
+function pickFields(source, fields) {
+    const result = {};
+    for (const field of fields) {
+        if (field in source) {
+            result[field] = source[field];
+        }
+    }
+    return result;
+}
+/**
+ * 按本次签发需要的字段，生成最小内联 @context 对象。
+ *
+ * @example
+ * // 仅解释 tokenId、owner，不会带上 contractAddress
+ * buildInlineContext("ccdao", { types: ["NFTOwnership"], fields: ["tokenId", "owner"] })
+ *
+ * 未传 fields 时返回该类型的完整预设（与 Profile 行为一致）。
+ */
+function buildInlineContext(brand, opts) {
+    const merged = {};
+    for (const type of opts.types) {
+        const builder = VC_TYPE_BUILDERS[type];
+        if (!builder) {
+            continue;
+        }
+        const preset = builder(brand);
+        const subset = opts.fields?.length
+            ? pickFields(preset, [
+                ...opts.types,
+                "version",
+                ...opts.fields
+            ])
+            : preset;
+        Object.assign(merged, subset);
+    }
+    return merged;
+}

package/lib/profiles/nft-ownership.d.ts

@@ -0,0 +1,8 @@
+import type { BrandId, DescriptorMeta, VCIssuanceDescriptor } from "../types.js";
+/**
+ * NFTOwnership 签发 Profile。
+ * 词汇表与链无关；subject 中填 contractAddress 或 tokenName/nftIssuer 由 DApp 策略决定。
+ */
+export declare function buildNftOwnershipDescriptor(brand: BrandId, subject: Record<string, unknown> & {
+    id: string;
+}, meta: DescriptorMeta): VCIssuanceDescriptor;

package/lib/profiles/nft-ownership.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildNftOwnershipDescriptor = buildNftOwnershipDescriptor;
+const inline_contexts_js_1 = require("../inline-contexts.js");
+const vc_types_js_1 = require("../vc-types.js");
+/**
+ * NFTOwnership 签发 Profile。
+ * 词汇表与链无关；subject 中填 contractAddress 或 tokenName/nftIssuer 由 DApp 策略决定。
+ */
+function buildNftOwnershipDescriptor(brand, subject, meta) {
+    return {
+        types: [vc_types_js_1.VC_TYPES.NFT_OWNERSHIP],
+        contexts: [inline_contexts_js_1.W3C_VC_CONTEXT_URL, (0, inline_contexts_js_1.getNftOwnershipContext)(brand)],
+        subject,
+        id: meta.id,
+        expirationDate: meta.expirationDate,
+        issuanceDate: meta.issuanceDate,
+        issuer: meta.issuer
+    };
+}

package/lib/profiles/nft-usage-authorization.d.ts

@@ -0,0 +1,5 @@
+import type { BrandId, DescriptorMeta, VCIssuanceDescriptor } from "../types.js";
+/** NFT 授权类 VC 签发 Profile */
+export declare function buildNftUsageAuthorizationDescriptor(brand: BrandId, subject: Record<string, unknown> & {
+    id: string;
+}, meta: DescriptorMeta): VCIssuanceDescriptor;

package/lib/profiles/nft-usage-authorization.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildNftUsageAuthorizationDescriptor = buildNftUsageAuthorizationDescriptor;
+const inline_contexts_js_1 = require("../inline-contexts.js");
+const vc_types_js_1 = require("../vc-types.js");
+/** NFT 授权类 VC 签发 Profile */
+function buildNftUsageAuthorizationDescriptor(brand, subject, meta) {
+    return {
+        types: [vc_types_js_1.VC_TYPES.NFT_USAGE_AUTHORIZATION],
+        contexts: [inline_contexts_js_1.W3C_VC_CONTEXT_URL, (0, inline_contexts_js_1.getNftUsageAuthorizationContext)(brand)],
+        subject,
+        id: meta.id,
+        expirationDate: meta.expirationDate,
+        issuanceDate: meta.issuanceDate,
+        issuer: meta.issuer
+    };
+}

package/lib/profiles/phone-verification.d.ts

@@ -0,0 +1,5 @@
+import type { BrandId, DescriptorMeta, VCIssuanceDescriptor } from "../types.js";
+/** 电话验证 VC 签发 Profile；两品牌词汇结构相同，仅 URL 命名空间不同 */
+export declare function buildPhoneVerificationDescriptor(brand: BrandId, subject: Record<string, unknown> & {
+    id: string;
+}, meta: DescriptorMeta): VCIssuanceDescriptor;

package/lib/profiles/phone-verification.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPhoneVerificationDescriptor = buildPhoneVerificationDescriptor;
+const inline_contexts_js_1 = require("../inline-contexts.js");
+const vc_types_js_1 = require("../vc-types.js");
+/** 电话验证 VC 签发 Profile；两品牌词汇结构相同，仅 URL 命名空间不同 */
+function buildPhoneVerificationDescriptor(brand, subject, meta) {
+    return {
+        types: [vc_types_js_1.VC_TYPES.PHONE_VERIFICATION],
+        contexts: [inline_contexts_js_1.W3C_VC_CONTEXT_URL, (0, inline_contexts_js_1.getPhoneVerificationContext)(brand)],
+        subject,
+        id: meta.id,
+        expirationDate: meta.expirationDate,
+        issuanceDate: meta.issuanceDate,
+        issuer: meta.issuer
+    };
+}

package/lib/types.d.ts

@@ -0,0 +1,41 @@
+/** 产品品牌：决定使用哪套词汇表域名（ccda.ooo / jdid.cn） */
+export type BrandId = "ccdao" | "jdid";
+/**
+ * VC @context 数组中的单项：
+ * - string：远程词汇表 URL（如 W3C credentials/v1）
+ * - object：内联术语映射（签发时写入 VC，验签不依赖 SDK 版本）
+ */
+export type VCContextValue = string | Record<string, unknown>;
+/**
+ * 签发描述符：交给 @jccdex/did 的 issueVC()，与具体业务范式（NFT/电话等）无关。
+ * Profile 函数（如 buildNftOwnershipDescriptor）负责组装此结构。
+ */
+export interface VCIssuanceDescriptor {
+    /** 业务类型字符串，如 NFTOwnership；不含 VerifiableCredential（issueVC 会自动补上） */
+    types: string[];
+    /** W3C 标准 URL + 品牌内联 context */
+    contexts: VCContextValue[];
+    /**
+     * credentialSubject。协议层仅要求含 id（一般为 holder DID）；
+     * 其余字段（tokenId、verificationProcess 等）由业务 Profile 填入。
+     */
+    subject: Record<string, unknown> & {
+        id: string;
+    };
+    /** VC 凭证 id，如 did:ethr:0x...#vc-1 */
+    id?: string;
+    issuer?: string | Record<string, unknown>;
+    issuanceDate?: string;
+    expirationDate?: string;
+    credentialStatus?: Record<string, unknown>;
+}
+/**
+ * Profile 元数据：与 subject 业务字段分离。
+ * id / expirationDate 通常由 DApp 策略生成（如 generateVCId、默认有效期）。
+ */
+export interface DescriptorMeta {
+    id: string;
+    expirationDate: string;
+    issuanceDate?: string;
+    issuer?: string | Record<string, unknown>;
+}

package/lib/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/vc-types.d.ts

@@ -0,0 +1,7 @@
+/** 已知 VC 业务类型常量；新增类型在此追加即可，无需改 @jccdex/did */
+export declare const VC_TYPES: {
+    readonly NFT_OWNERSHIP: "NFTOwnership";
+    readonly NFT_USAGE_AUTHORIZATION: "NFTUsageAuthorization";
+    readonly PHONE_VERIFICATION: "PhoneVerificationCredential";
+};
+export type VCType = (typeof VC_TYPES)[keyof typeof VC_TYPES];

package/lib/vc-types.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VC_TYPES = void 0;
+/** 已知 VC 业务类型常量；新增类型在此追加即可，无需改 @jccdex/did */
+exports.VC_TYPES = {
+    NFT_OWNERSHIP: "NFTOwnership",
+    NFT_USAGE_AUTHORIZATION: "NFTUsageAuthorization",
+    PHONE_VERIFICATION: "PhoneVerificationCredential"
+};

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@jccdex/vc-vocabularies",
+  "version": "0.1.1",
+  "description": "VC vocabulary and issuance profiles for JCCDEx DID ecosystem",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js",
+      "require": "./lib/index.js"
+    },
+    "./contexts/ccda-did-v1.json": {
+      "import": "./src/contexts/ccda-did-v1.json",
+      "require": "./src/contexts/ccda-did-v1.json",
+      "default": "./src/contexts/ccda-did-v1.json"
+    },
+    "./contexts/ccda-vc-v1.json": {
+      "import": "./src/contexts/ccda-vc-v1.json",
+      "require": "./src/contexts/ccda-vc-v1.json",
+      "default": "./src/contexts/ccda-vc-v1.json"
+    },
+    "./contexts/jdid-did-v1.json": {
+      "import": "./src/contexts/jdid-did-v1.json",
+      "require": "./src/contexts/jdid-did-v1.json",
+      "default": "./src/contexts/jdid-did-v1.json"
+    },
+    "./contexts/jdid-vc-v1.json": {
+      "import": "./src/contexts/jdid-vc-v1.json",
+      "require": "./src/contexts/jdid-vc-v1.json",
+      "default": "./src/contexts/jdid-vc-v1.json"
+    }
+  },
+  "files": [
+    "lib",
+    "src/contexts"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "clean": "rm -rf lib",
+    "build": "yarn clean && tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest --watch"
+  },
+  "author": "JCCDex",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.9.2",
+    "vitest": "^4.1.0"
+  }
+}

package/src/contexts/ccda-did-v1.json

@@ -0,0 +1,30 @@
+{
+  "@context": {
+    "@version": 1.1,
+    "@protected": true,
+    "id": "@id",
+    "type": "@type",
+    "NFTOwnership": "https://ccda.ooo/vc/v1#NFTOwnership",
+    "NFTUsageAuthorization": "https://ccda.ooo/vc/v1#NFTUsageAuthorization",
+    "PhoneVerificationCredential": "https://ccda.ooo/vc/v1#PhoneVerificationCredential",
+    "version": "https://ccda.ooo/did/v1#version",
+    "chainId": "https://ccda.ooo/did/v1#chainId",
+    "contractAddress": "https://ccda.ooo/did/v1#contractAddress",
+    "tokenName": "https://ccda.ooo/did/v1#tokenName",
+    "tokenId": "https://ccda.ooo/did/v1#tokenId",
+    "owner": "https://ccda.ooo/did/v1#owner",
+    "nftIssuer": "https://ccda.ooo/did/v1#nftIssuer",
+    "standard": "https://ccda.ooo/did/v1#standard",
+    "status": "https://ccda.ooo/did/v1#status",
+    "credentials": "https://ccda.ooo/did/v1#credentials",
+    "verificationMethod": "https://ccda.ooo/did/v1#verificationMethod",
+    "verificationProcess": {
+      "@id": "https://ccda.ooo/did/v1#verificationProcess",
+      "@context": {
+        "verifiedAt": "https://ccda.ooo/did/v1#verifiedAt",
+        "updateAt": "https://ccda.ooo/did/v1#updateAt",
+        "verifierId": "https://ccda.ooo/did/v1#verifierId"
+      }
+    }
+  }
+}

package/src/contexts/ccda-vc-v1.json

@@ -0,0 +1,20 @@
+{
+  "@context": {
+    "@version": 1.1,
+    "@protected": true,
+    "id": "@id",
+    "type": "@type",
+    "grantee": "https://ccda.ooo/vc/v1#grantee",
+    "usageRights": "https://ccda.ooo/vc/v1#usageRights",
+    "restrictions": {
+      "@id": "https://ccda.ooo/vc/v1#restrictions",
+      "@context": {
+        "commercial": "https://ccda.ooo/vc/v1#commercial",
+        "derivative": "https://ccda.ooo/vc/v1#derivative",
+        "sublicense": "https://ccda.ooo/vc/v1#sublicense",
+        "territories": "https://ccda.ooo/vc/v1#territories",
+        "platforms": "https://ccda.ooo/vc/v1#platforms"
+      }
+    }
+  }
+}

package/src/contexts/jdid-did-v1.json

@@ -0,0 +1,30 @@
+{
+  "@context": {
+    "@version": 1.1,
+    "@protected": true,
+    "id": "@id",
+    "type": "@type",
+    "NFTOwnership": "https://jdid.cn/vc/v1#NFTOwnership",
+    "NFTUsageAuthorization": "https://jdid.cn/vc/v1#NFTUsageAuthorization",
+    "PhoneVerificationCredential": "https://jdid.cn/vc/v1#PhoneVerificationCredential",
+    "version": "https://jdid.cn/did/v1#version",
+    "chainId": "https://jdid.cn/did/v1#chainId",
+    "contractAddress": "https://jdid.cn/did/v1#contractAddress",
+    "tokenName": "https://jdid.cn/did/v1#tokenName",
+    "tokenId": "https://jdid.cn/did/v1#tokenId",
+    "owner": "https://jdid.cn/did/v1#owner",
+    "nftIssuer": "https://jdid.cn/did/v1#nftIssuer",
+    "standard": "https://jdid.cn/did/v1#standard",
+    "status": "https://jdid.cn/did/v1#status",
+    "credentials": "https://jdid.cn/did/v1#credentials",
+    "verificationMethod": "https://jdid.cn/did/v1#verificationMethod",
+    "verificationProcess": {
+      "@id": "https://jdid.cn/did/v1#verificationProcess",
+      "@context": {
+        "verifiedAt": "https://jdid.cn/did/v1#verifiedAt",
+        "updateAt": "https://jdid.cn/did/v1#updateAt",
+        "verifierId": "https://jdid.cn/did/v1#verifierId"
+      }
+    }
+  }
+}

package/src/contexts/jdid-vc-v1.json

@@ -0,0 +1,20 @@
+{
+  "@context": {
+    "@version": 1.1,
+    "@protected": true,
+    "id": "@id",
+    "type": "@type",
+    "grantee": "https://jdid.cn/vc/v1#grantee",
+    "usageRights": "https://jdid.cn/vc/v1#usageRights",
+    "restrictions": {
+      "@id": "https://jdid.cn/vc/v1#restrictions",
+      "@context": {
+        "commercial": "https://jdid.cn/vc/v1#commercial",
+        "derivative": "https://jdid.cn/vc/v1#derivative",
+        "sublicense": "https://jdid.cn/vc/v1#sublicense",
+        "territories": "https://jdid.cn/vc/v1#territories",
+        "platforms": "https://jdid.cn/vc/v1#platforms"
+      }
+    }
+  }
+}