@diap/sdk 0.1.1 → 0.1.3

package/dist/did-cache.d.ts

@@ -0,0 +1,133 @@
+/**
+ * DIAP TypeScript SDK - DID 文档缓存
+ * 减少 IPFS 请求，提高验证性能
+ * 使用 LRU 驱逐策略和后台清理任务
+ */
+import type { DIDDocument } from './types/did.js';
+/**
+ * 缓存条目
+ */
+export interface CacheEntry {
+    /** DID 文档 */
+    document: DIDDocument;
+    /** CID */
+    cid: string;
+    /** 缓存时间 */
+    cachedAt: number;
+    /** 过期时间 */
+    expiresAt: number;
+    /** 访问次数 */
+    hitCount: number;
+}
+/**
+ * 缓存统计信息
+ */
+export interface CacheStats {
+    /** 总条目数 */
+    totalEntries: number;
+    /** 过期条目数 */
+    expiredEntries: number;
+    /** 总命中次数 */
+    totalHits: number;
+    /** 最大条目数 */
+    maxEntries: number;
+    /** TTL（秒） */
+    ttl: number;
+}
+/**
+ * DID 文档缓存管理器
+ */
+export declare class DIDCache {
+    /** CID -> CacheEntry 缓存 */
+    private cache;
+    /** 缓存有效期（秒） */
+    private ttl;
+    /** 最大缓存条目数 */
+    private maxEntries;
+    /** 后台清理定时器 */
+    private cleanupTimer?;
+    /**
+     * 创建新的 DID 缓存
+     *
+     * @param ttl - 缓存有效期（秒），默认 3600 秒（1小时）
+     * @param maxEntries - 最大缓存条目数，默认 1000
+     */
+    constructor(ttl?: number, maxEntries?: number);
+    /**
+     * 获取 DID 文档
+     */
+    get(cid: string): DIDDocument | null;
+    /**
+     * 存储 DID 文档
+     */
+    put(cid: string, document: DIDDocument): void;
+    /**
+     * 检查缓存是否存在
+     */
+    has(cid: string): boolean;
+    /**
+     * 移除缓存条目
+     */
+    remove(cid: string): DIDDocument | null;
+    /**
+     * 清空缓存
+     */
+    clear(): void;
+    /**
+     * 获取缓存统计
+     */
+    stats(): CacheStats;
+    /**
+     * 清理过期条目
+     */
+    cleanupExpired(): number;
+    /**
+     * 驱逐最少使用的条目（LRU）
+     */
+    private evictLru;
+    /**
+     * 获取当前时间戳（秒）
+     */
+    private getCurrentTimestamp;
+    /**
+     * 启动后台清理任务
+     */
+    private startCleanupTask;
+    /**
+     * 停止后台清理任务
+     */
+    stopCleanupTask(): void;
+    /**
+     * 获取缓存条目数
+     */
+    size(): number;
+    /**
+     * 检查缓存是否为空
+     */
+    isEmpty(): boolean;
+    /**
+     * 获取所有缓存的 CID
+     */
+    getAllCids(): string[];
+    /**
+     * 销毁缓存实例
+     */
+    destroy(): void;
+}
+/**
+ * 创建新的 DID 缓存（便捷函数）
+ */
+export declare function createDIDCache(ttl?: number, maxEntries?: number): DIDCache;
+/**
+ * 创建默认配置的 DID 缓存
+ */
+export declare function createDefaultDIDCache(): DIDCache;
+/**
+ * 获取全局 DID 缓存实例
+ */
+export declare function getGlobalDIDCache(): DIDCache;
+/**
+ * 重置全局 DID 缓存
+ */
+export declare function resetGlobalDIDCache(): void;
+//# sourceMappingURL=did-cache.d.ts.map

package/dist/did-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-cache.d.ts","sourceRoot":"","sources":["../src/did-cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAMlD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,aAAa;IACb,QAAQ,EAAE,WAAW,CAAC;IACtB,UAAU;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAMD;;GAEG;AACH,qBAAa,QAAQ;IACnB,2BAA2B;IAC3B,OAAO,CAAC,KAAK,CAA0B;IACvC,eAAe;IACf,OAAO,CAAC,GAAG,CAAS;IACpB,cAAc;IACd,OAAO,CAAC,UAAU,CAAS;IAC3B,cAAc;IACd,OAAO,CAAC,YAAY,CAAC,CAAiB;IAEtC;;;;;OAKG;gBACS,GAAG,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAgB7C;;OAEG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAwB3C;;OAEG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI;IAmBpD;;OAEG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAahC;;OAEG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAU9C;;OAEG;IACI,KAAK,IAAI,IAAI;IAMpB;;OAEG;IACI,KAAK,IAAI,UAAU;IAqB1B;;OAEG;IACI,cAAc,IAAI,MAAM;IAkB/B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAiBhB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;OAEG;IACI,eAAe,IAAI,IAAI;IAQ9B;;OAEG;IACI,IAAI,IAAI,MAAM;IAIrB;;OAEG;IACI,OAAO,IAAI,OAAO;IAIzB;;OAEG;IACI,UAAU,IAAI,MAAM,EAAE;IAI7B;;OAEG;IACI,OAAO,IAAI,IAAI;CAKvB;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAE1E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,CAEhD;AAQD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,QAAQ,CAK5C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C"}

package/dist/did-cache.js

@@ -0,0 +1,273 @@
+/**
+ * DIAP TypeScript SDK - DID 文档缓存
+ * 减少 IPFS 请求，提高验证性能
+ * 使用 LRU 驱逐策略和后台清理任务
+ */
+import { logger } from './utils/logger.js';
+// ============================================================================
+// DIDCache 类
+// ============================================================================
+/**
+ * DID 文档缓存管理器
+ */
+export class DIDCache {
+    /** CID -> CacheEntry 缓存 */
+    cache;
+    /** 缓存有效期（秒） */
+    ttl;
+    /** 最大缓存条目数 */
+    maxEntries;
+    /** 后台清理定时器 */
+    cleanupTimer;
+    /**
+     * 创建新的 DID 缓存
+     *
+     * @param ttl - 缓存有效期（秒），默认 3600 秒（1小时）
+     * @param maxEntries - 最大缓存条目数，默认 1000
+     */
+    constructor(ttl, maxEntries) {
+        const ttlSeconds = ttl || 3600;
+        const max = maxEntries || 1000;
+        this.cache = new Map();
+        this.ttl = ttlSeconds;
+        this.maxEntries = max;
+        // 启动后台清理任务
+        this.startCleanupTask();
+        logger.info(`💾 DID 文档缓存已创建`);
+        logger.info(`  TTL: ${ttlSeconds} 秒`);
+        logger.info(`  最大条目: ${max}`);
+    }
+    /**
+     * 获取 DID 文档
+     */
+    get(cid) {
+        const entry = this.cache.get(cid);
+        if (!entry) {
+            logger.debug(`缓存未命中: ${cid}`);
+            return null;
+        }
+        const now = this.getCurrentTimestamp();
+        // 检查是否过期
+        if (entry.expiresAt < now) {
+            this.cache.delete(cid);
+            logger.debug(`缓存已过期: ${cid}`);
+            return null;
+        }
+        // 增加命中次数
+        entry.hitCount += 1;
+        logger.debug(`✓ 缓存命中: ${cid} (命中次数: ${entry.hitCount})`);
+        return entry.document;
+    }
+    /**
+     * 存储 DID 文档
+     */
+    put(cid, document) {
+        // 检查缓存大小
+        if (this.cache.size >= this.maxEntries) {
+            this.evictLru();
+        }
+        const now = this.getCurrentTimestamp();
+        const entry = {
+            document,
+            cid,
+            cachedAt: now,
+            expiresAt: now + this.ttl,
+            hitCount: 0,
+        };
+        this.cache.set(cid, entry);
+        logger.debug(`✓ 已缓存 DID 文档: ${cid}`);
+    }
+    /**
+     * 检查缓存是否存在
+     */
+    has(cid) {
+        const entry = this.cache.get(cid);
+        if (!entry)
+            return false;
+        const now = this.getCurrentTimestamp();
+        if (entry.expiresAt < now) {
+            this.cache.delete(cid);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * 移除缓存条目
+     */
+    remove(cid) {
+        const entry = this.cache.get(cid);
+        if (entry) {
+            this.cache.delete(cid);
+            logger.debug(`移除缓存: ${cid}`);
+            return entry.document;
+        }
+        return null;
+    }
+    /**
+     * 清空缓存
+     */
+    clear() {
+        const count = this.cache.size;
+        this.cache.clear();
+        logger.info(`🧹 清空缓存: ${count} 个条目`);
+    }
+    /**
+     * 获取缓存统计
+     */
+    stats() {
+        let totalHits = 0;
+        let expired = 0;
+        const now = this.getCurrentTimestamp();
+        for (const entry of this.cache.values()) {
+            totalHits += entry.hitCount;
+            if (entry.expiresAt < now) {
+                expired += 1;
+            }
+        }
+        return {
+            totalEntries: this.cache.size,
+            expiredEntries: expired,
+            totalHits,
+            maxEntries: this.maxEntries,
+            ttl: this.ttl,
+        };
+    }
+    /**
+     * 清理过期条目
+     */
+    cleanupExpired() {
+        const now = this.getCurrentTimestamp();
+        let removed = 0;
+        for (const [cid, entry] of this.cache.entries()) {
+            if (entry.expiresAt < now) {
+                this.cache.delete(cid);
+                removed += 1;
+            }
+        }
+        if (removed > 0) {
+            logger.debug(`🧹 清理了 ${removed} 个过期缓存`);
+        }
+        return removed;
+    }
+    /**
+     * 驱逐最少使用的条目（LRU）
+     */
+    evictLru() {
+        let minHits = Number.MAX_SAFE_INTEGER;
+        let evictCid = null;
+        for (const [cid, entry] of this.cache.entries()) {
+            if (entry.hitCount < minHits) {
+                minHits = entry.hitCount;
+                evictCid = cid;
+            }
+        }
+        if (evictCid !== null) {
+            this.cache.delete(evictCid);
+            logger.debug(`驱逐 LRU 缓存: ${evictCid} (命中次数: ${minHits})`);
+        }
+    }
+    /**
+     * 获取当前时间戳（秒）
+     */
+    getCurrentTimestamp() {
+        return Math.floor(Date.now() / 1000);
+    }
+    /**
+     * 启动后台清理任务
+     */
+    startCleanupTask() {
+        // 每隔 TTL/4 清理一次
+        const intervalMs = (this.ttl / 4) * 1000;
+        this.cleanupTimer = setInterval(() => {
+            const now = this.getCurrentTimestamp();
+            let removed = 0;
+            for (const [cid, entry] of this.cache.entries()) {
+                if (entry.expiresAt < now) {
+                    this.cache.delete(cid);
+                    removed += 1;
+                }
+            }
+            if (removed > 0) {
+                logger.debug(`🧹 后台清理了 ${removed} 个过期 DID 缓存`);
+            }
+        }, intervalMs);
+        // 确保定时器不会阻止进程退出
+        if (this.cleanupTimer.unref) {
+            this.cleanupTimer.unref();
+        }
+    }
+    /**
+     * 停止后台清理任务
+     */
+    stopCleanupTask() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+            logger.debug('后台清理任务已停止');
+        }
+    }
+    /**
+     * 获取缓存条目数
+     */
+    size() {
+        return this.cache.size;
+    }
+    /**
+     * 检查缓存是否为空
+     */
+    isEmpty() {
+        return this.cache.size === 0;
+    }
+    /**
+     * 获取所有缓存的 CID
+     */
+    getAllCids() {
+        return Array.from(this.cache.keys());
+    }
+    /**
+     * 销毁缓存实例
+     */
+    destroy() {
+        this.stopCleanupTask();
+        this.clear();
+        logger.debug('🧹 DID 缓存实例已销毁');
+    }
+}
+// ============================================================================
+// 便捷函数
+// ============================================================================
+/**
+ * 创建新的 DID 缓存（便捷函数）
+ */
+export function createDIDCache(ttl, maxEntries) {
+    return new DIDCache(ttl, maxEntries);
+}
+/**
+ * 创建默认配置的 DID 缓存
+ */
+export function createDefaultDIDCache() {
+    return new DIDCache(3600, 1000);
+}
+// ============================================================================
+// 全局单例缓存
+// ============================================================================
+let globalCache = null;
+/**
+ * 获取全局 DID 缓存实例
+ */
+export function getGlobalDIDCache() {
+    if (!globalCache) {
+        globalCache = new DIDCache();
+    }
+    return globalCache;
+}
+/**
+ * 重置全局 DID 缓存
+ */
+export function resetGlobalDIDCache() {
+    if (globalCache) {
+        globalCache.destroy();
+        globalCache = null;
+    }
+}
+//# sourceMappingURL=did-cache.js.map

package/dist/did-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-cache.js","sourceRoot":"","sources":["../src/did-cache.ts"],"names":[],"mappings":"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"}

package/dist/identity-manager.d.ts

@@ -0,0 +1,87 @@
+/**
+ * 身份管理器
+ * 统一管理智能体身份的注册和验证
+ * 基于 Rust SDK 的实现逻辑
+ */
+import type { DIDDocument, EncryptedPeerID } from './types/did.js';
+import type { KeyPair } from './types/key.js';
+import type { IpfsClient } from './ipfs-client.js';
+import { UniversalNoirManager } from './zkp/universal-manager.js';
+/**
+ * 智能体信息
+ */
+export interface AgentInfo {
+    name: string;
+    services: ServiceInfo[];
+    description?: string;
+    tags?: string[];
+}
+/**
+ * 服务信息
+ */
+export interface ServiceInfo {
+    serviceType: string;
+    endpoint: any;
+}
+/**
+ * 身份注册结果
+ */
+export interface IdentityRegistration {
+    did: string;
+    cid: string;
+    didDocument: DIDDocument;
+    encryptedPeerIdHex: string;
+    registeredAt: string;
+}
+/**
+ * 身份验证结果
+ */
+export interface IdentityVerification {
+    did: string;
+    cid: string;
+    zkpVerified: boolean;
+    verificationDetails: string[];
+    verifiedAt: string;
+}
+/**
+ * 身份管理器
+ */
+export declare class IdentityManager {
+    private ipfsClient;
+    private didBuilder;
+    private zkpManager?;
+    constructor(ipfsClient: IpfsClient, zkpManager?: UniversalNoirManager);
+    /**
+     * 获取 IPFS 客户端
+     */
+    getIpfsClient(): IpfsClient;
+    /**
+     * 添加服务
+     */
+    addService(serviceType: string, endpoint: any): this;
+    /**
+     * 注册智能体身份
+     */
+    registerIdentity(agentInfo: AgentInfo, keypair: KeyPair, peerId: string): Promise<IdentityRegistration>;
+    /**
+     * 生成 DID-CID 绑定证明（简化版本）
+     */
+    generateBindingProof(keypair: KeyPair, didDocument: DIDDocument, _cid: string, nonce: Uint8Array): Uint8Array;
+    /**
+     * 使用 ZKP 验证身份
+     */
+    verifyIdentityWithZKP(cid: string, _zkpProof: Uint8Array, _nonce: Uint8Array): Promise<IdentityVerification>;
+    /**
+     * 验证 PeerID 签名
+     */
+    verifyPeerId(didDocument: DIDDocument, encrypted: EncryptedPeerID, claimedPeerId: string): boolean;
+    /**
+     * 从 DID 文档提取公钥
+     */
+    extractPublicKey(didDocument: DIDDocument): Uint8Array | null;
+    /**
+     * 从 DID 文档提取加密的 PeerID
+     */
+    extractEncryptedPeerId(didDocument: DIDDocument): EncryptedPeerID | null;
+}
+//# sourceMappingURL=identity-manager.d.ts.map

package/dist/identity-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-manager.d.ts","sourceRoot":"","sources":["../src/identity-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AASlE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,GAAG,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,WAAW,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,eAAe;IAKxB,OAAO,CAAC,UAAU;IAJpB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAC,CAAuB;gBAGhC,UAAU,EAAE,UAAU,EAC9B,UAAU,CAAC,EAAE,oBAAoB;IAMnC;;OAEG;IACH,aAAa,IAAI,UAAU;IAI3B;;OAEG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,IAAI;IAKpD;;OAEG;IACG,gBAAgB,CACpB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC;IAyBhC;;OAEG;IACH,oBAAoB,CAClB,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,GAChB,UAAU;IAmBb;;OAEG;IACG,qBAAqB,CACzB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,UAAU,EACrB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,oBAAoB,CAAC;IAsChC;;OAEG;IACH,YAAY,CACV,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,eAAe,EAC1B,aAAa,EAAE,MAAM,GACpB,OAAO;IAsBV;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,GAAG,IAAI;IAoC7D;;OAEG;IACH,sBAAsB,CAAC,WAAW,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI;CAkCzE"}