@diap/sdk 0.1.1 → 0.1.3

package/dist/ipfs-bidirectional-verification.js

@@ -0,0 +1,298 @@
+/**
+ * DIAP TypeScript SDK - IPFS 双向验证系统
+ * 实现基于真实 IPFS 的智能体双向身份验证闭环
+ */
+import { logger } from './utils/logger.js';
+/**
+ * 会话状态
+ */
+export var SessionStatus;
+(function (SessionStatus) {
+    /** 等待验证 */
+    SessionStatus["Pending"] = "pending";
+    /** 验证中 */
+    SessionStatus["Verifying"] = "verifying";
+    /** 已验证 */
+    SessionStatus["Verified"] = "verified";
+    /** 验证失败 */
+    SessionStatus["Failed"] = "failed";
+    /** 已过期 */
+    SessionStatus["Expired"] = "expired";
+})(SessionStatus || (SessionStatus = {}));
+/**
+ * 验证状态
+ */
+export var VerificationStatus;
+(function (VerificationStatus) {
+    /** 成功 */
+    VerificationStatus["Success"] = "success";
+    /** 失败 */
+    VerificationStatus["Failed"] = "failed";
+    /** 超时 */
+    VerificationStatus["Timeout"] = "timeout";
+    /** 网络错误 */
+    VerificationStatus["NetworkError"] = "network_error";
+    /** 数据错误 */
+    VerificationStatus["DataError"] = "data_error";
+})(VerificationStatus || (VerificationStatus = {}));
+/**
+ * IPFS 双向验证管理器（轻量级版本）
+ */
+export class IpfsBidirectionalVerificationManager {
+    ipfsClient = null;
+    activeSessions = new Map();
+    verificationCache = new Map();
+    sessionTimeout = 3600 * 1000; // 1小时
+    /**
+     * 创建新的双向验证管理器
+     */
+    constructor(ipfsClient) {
+        this.ipfsClient = ipfsClient || null;
+        logger.info('🚀 IPFS 双向验证管理器已创建（轻量级版本）');
+    }
+    /**
+     * 设置 IPFS 客户端
+     */
+    setIpfsClient(client) {
+        this.ipfsClient = client;
+    }
+    /**
+     * 获取 IPFS 客户端
+     */
+    getIpfsClient() {
+        return this.ipfsClient;
+    }
+    /**
+     * 注册智能体
+     */
+    registerAgent(agentId, agentInfo, did, didDocumentCid) {
+        const session = {
+            agentId,
+            agentInfo,
+            did,
+            didDocumentCid,
+            createdAt: Date.now(),
+            lastActivity: Date.now(),
+            status: SessionStatus.Pending,
+        };
+        this.activeSessions.set(agentId, session);
+        logger.info(`✅ 智能体已注册: ${agentId}`);
+    }
+    /**
+     * 发起双向验证
+     */
+    async initiateBidirectionalVerification(initiatorId, responderId, resourceCid) {
+        const startTime = Date.now();
+        logger.info(`🤝 发起双向验证: ${initiatorId} ↔ ${responderId}`);
+        // 检查智能体是否已注册
+        const initiatorSession = this.activeSessions.get(initiatorId);
+        const responderSession = this.activeSessions.get(responderId);
+        if (!initiatorSession) {
+            throw new Error(`发起方智能体未注册: ${initiatorId}`);
+        }
+        if (!responderSession) {
+            throw new Error(`响应方智能体未注册: ${responderId}`);
+        }
+        // 创建验证挑战
+        const challenge = {
+            challengeId: `${initiatorId}-${responderId}-${Date.now()}`,
+            initiatorId,
+            responderId,
+            challengeNonce: this.generateChallengeNonce(),
+            timestamp: Date.now(),
+            expirySeconds: 300,
+            resourceCid,
+        };
+        // 验证发起方
+        const initiatorResult = await this.verifyAgent(initiatorId, challenge);
+        // 验证响应方
+        const responderResult = await this.verifyAgent(responderId, challenge);
+        const totalTime = Date.now() - startTime;
+        const success = initiatorResult.status === VerificationStatus.Success &&
+            responderResult.status === VerificationStatus.Success;
+        const result = {
+            success,
+            initiatorId,
+            responderId,
+            initiatorResult,
+            responderResult,
+            verificationTimestamp: Date.now(),
+            totalVerificationTimeMs: totalTime,
+            errorMessage: success ? undefined : '双向验证失败',
+        };
+        // 更新会话状态
+        this.updateSessionStatus(initiatorId, success ? SessionStatus.Verified : SessionStatus.Failed);
+        this.updateSessionStatus(responderId, success ? SessionStatus.Verified : SessionStatus.Failed);
+        if (success) {
+            logger.info('✅ 双向验证成功完成');
+        }
+        else {
+            logger.warn('❌ 双向验证失败');
+        }
+        return result;
+    }
+    /**
+     * 验证单个智能体身份
+     */
+    async verifyAgent(agentId, challenge) {
+        const startTime = Date.now();
+        logger.info(`🔍 验证智能体身份: ${agentId}`);
+        const session = this.activeSessions.get(agentId);
+        if (!session) {
+            return {
+                agentId,
+                status: VerificationStatus.Failed,
+                timestamp: Date.now(),
+                processingTimeMs: Date.now() - startTime,
+                errorMessage: '智能体未注册',
+            };
+        }
+        // 更新会话状态
+        this.updateSessionStatus(agentId, SessionStatus.Verifying);
+        // 模拟验证过程（简化版本）
+        await this.delay(100);
+        // 生成证明数据
+        const proofData = {
+            proof: new Uint8Array([1, 2, 3, 4]),
+            publicInputs: new Uint8Array([5, 6, 7, 8]),
+            circuitOutput: '0x' + agentId,
+            didDocumentContent: '{}',
+            resourceCid: challenge.resourceCid,
+            challengeNonce: challenge.challengeNonce,
+        };
+        const processingTime = Date.now() - startTime;
+        return {
+            agentId,
+            status: VerificationStatus.Success,
+            proof: proofData,
+            timestamp: Date.now(),
+            processingTimeMs: processingTime,
+        };
+    }
+    /**
+     * 批量验证多个智能体对
+     */
+    async batchBidirectionalVerification(agentPairs, resourceCid) {
+        logger.info(`🔄 开始批量双向验证: ${agentPairs.length} 对智能体`);
+        const results = [];
+        for (const [initiatorId, responderId] of agentPairs) {
+            try {
+                const result = await this.initiateBidirectionalVerification(initiatorId, responderId, resourceCid);
+                results.push(result);
+            }
+            catch (error) {
+                logger.error(`❌ 批量验证失败 ${initiatorId} ↔ ${responderId}: ${error}`);
+                results.push(this.createFailedResult(initiatorId, responderId, error));
+            }
+        }
+        const successCount = results.filter((r) => r.success).length;
+        logger.info(`✅ 批量双向验证完成: ${successCount}/${results.length} 成功`);
+        return results;
+    }
+    /**
+     * 获取智能体会话信息
+     */
+    getAgentSession(agentId) {
+        return this.activeSessions.get(agentId);
+    }
+    /**
+     * 获取所有活跃会话
+     */
+    getActiveSessions() {
+        return Array.from(this.activeSessions.values()).filter((session) => session.status !== SessionStatus.Expired);
+    }
+    /**
+     * 清理过期会话
+     */
+    cleanupExpiredSessions() {
+        const currentTime = Date.now();
+        let expiredCount = 0;
+        for (const [agentId, session] of this.activeSessions) {
+            if (currentTime - session.lastActivity > this.sessionTimeout) {
+                session.status = SessionStatus.Expired;
+                expiredCount++;
+            }
+        }
+        if (expiredCount > 0) {
+            logger.info(`🧹 清理了 ${expiredCount} 个过期会话`);
+        }
+    }
+    /**
+     * 移除智能体会话
+     */
+    removeSession(agentId) {
+        const deleted = this.activeSessions.delete(agentId);
+        if (deleted) {
+            logger.info(`✅ 已移除会话: ${agentId}`);
+        }
+        return deleted;
+    }
+    // 私有辅助方法
+    /**
+     * 生成挑战 nonce
+     */
+    generateChallengeNonce() {
+        const array = crypto.getRandomValues(new Uint8Array(16));
+        return Array.from(array)
+            .map((b) => b.toString(16).padStart(2, '0'))
+            .join('');
+    }
+    /**
+     * 更新会话状态
+     */
+    updateSessionStatus(agentId, status) {
+        const session = this.activeSessions.get(agentId);
+        if (session) {
+            session.status = status;
+            session.lastActivity = Date.now();
+        }
+    }
+    /**
+     * 创建失败的验证结果
+     */
+    createFailedResult(initiatorId, responderId, error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            initiatorId,
+            responderId,
+            initiatorResult: {
+                agentId: initiatorId,
+                status: VerificationStatus.Failed,
+                timestamp: Date.now(),
+                processingTimeMs: 0,
+                errorMessage,
+            },
+            responderResult: {
+                agentId: responderId,
+                status: VerificationStatus.Failed,
+                timestamp: Date.now(),
+                processingTimeMs: 0,
+                errorMessage,
+            },
+            verificationTimestamp: Date.now(),
+            totalVerificationTimeMs: 0,
+            errorMessage,
+        };
+    }
+    /**
+     * 延迟函数
+     */
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+// ============================================================================
+// 便捷函数
+// ============================================================================
+/**
+ * 创建双向验证管理器
+ */
+export function createBidirectionalVerificationManager() {
+    return new IpfsBidirectionalVerificationManager();
+}
+// ============================================================================
+// 导出
+// ============================================================================
+// 注意: AgentSession, SessionStatus, VerificationStatus 等已在声明时导出
+//# sourceMappingURL=ipfs-bidirectional-verification.js.map

package/dist/ipfs-bidirectional-verification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipfs-bidirectional-verification.js","sourceRoot":"","sources":["../src/ipfs-bidirectional-verification.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;GAEG;AACH,MAAM,CAAN,IAAY,aAWX;AAXD,WAAY,aAAa;IACvB,WAAW;IACX,oCAAmB,CAAA;IACnB,UAAU;IACV,wCAAuB,CAAA;IACvB,UAAU;IACV,sCAAqB,CAAA;IACrB,WAAW;IACX,kCAAiB,CAAA;IACjB,UAAU;IACV,oCAAmB,CAAA;AACrB,CAAC,EAXW,aAAa,KAAb,aAAa,QAWxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,kBAWX;AAXD,WAAY,kBAAkB;IAC5B,SAAS;IACT,yCAAmB,CAAA;IACnB,SAAS;IACT,uCAAiB,CAAA;IACjB,SAAS;IACT,yCAAmB,CAAA;IACnB,WAAW;IACX,oDAA8B,CAAA;IAC9B,WAAW;IACX,8CAAwB,CAAA;AAC1B,CAAC,EAXW,kBAAkB,KAAlB,kBAAkB,QAW7B;AAoGD;;GAEG;AACH,MAAM,OAAO,oCAAoC;IACvC,UAAU,GAAY,IAAI,CAAC;IAC3B,cAAc,GAA8B,IAAI,GAAG,EAAE,CAAC;IACtD,iBAAiB,GAAoC,IAAI,GAAG,EAAE,CAAC;IAC/D,cAAc,GAAW,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM;IAEpD;;OAEG;IACH,YAAY,UAAoB;QAC9B,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,IAAI,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,MAAe;QAClC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,aAAa;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,aAAa,CAClB,OAAe,EACf,SAAkC,EAClC,GAAW,EACX,cAAsB;QAEtB,MAAM,OAAO,GAAiB;YAC5B,OAAO;YACP,SAAS;YACT,GAAG;YACH,cAAc;YACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;YACxB,MAAM,EAAE,aAAa,CAAC,OAAO;SAC9B,CAAC;QAEF,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,iCAAiC,CAC5C,WAAmB,EACnB,WAAmB,EACnB,WAAmB;QAEnB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,cAAc,WAAW,MAAM,WAAW,EAAE,CAAC,CAAC;QAE1D,aAAa;QACb,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC9D,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAE9D,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,cAAc,WAAW,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,cAAc,WAAW,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,SAAS;QACT,MAAM,SAAS,GAA0B;YACvC,WAAW,EAAE,GAAG,WAAW,IAAI,WAAW,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;YAC1D,WAAW;YACX,WAAW;YACX,cAAc,EAAE,IAAI,CAAC,sBAAsB,EAAE;YAC7C,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,aAAa,EAAE,GAAG;YAClB,WAAW;SACZ,CAAC;QAEF,QAAQ;QACR,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAEvE,QAAQ;QACR,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAEvE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACzC,MAAM,OAAO,GACX,eAAe,CAAC,MAAM,KAAK,kBAAkB,CAAC,OAAO;YACrD,eAAe,CAAC,MAAM,KAAK,kBAAkB,CAAC,OAAO,CAAC;QAExD,MAAM,MAAM,GAAoC;YAC9C,OAAO;YACP,WAAW;YACX,WAAW;YACX,eAAe;YACf,eAAe;YACf,qBAAqB,EAAE,IAAI,CAAC,GAAG,EAAE;YACjC,uBAAuB,EAAE,SAAS;YAClC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;SAC7C,CAAC;QAEF,SAAS;QACT,IAAI,CAAC,mBAAmB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/F,IAAI,CAAC,mBAAmB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAE/F,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CACvB,OAAe,EACf,SAAgC;QAEhC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC;QAEtC,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO;gBACP,MAAM,EAAE,kBAAkB,CAAC,MAAM;gBACjC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,gBAAgB,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBACxC,YAAY,EAAE,QAAQ;aACvB,CAAC;QACJ,CAAC;QAED,SAAS;QACT,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;QAE3D,eAAe;QACf,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEtB,SAAS;QACT,MAAM,SAAS,GAAc;YAC3B,KAAK,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACnC,YAAY,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1C,aAAa,EAAE,IAAI,GAAG,OAAO;YAC7B,kBAAkB,EAAE,IAAI;YACxB,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,cAAc,EAAE,SAAS,CAAC,cAAc;SACzC,CAAC;QAEF,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAE9C,OAAO;YACL,OAAO;YACP,MAAM,EAAE,kBAAkB,CAAC,OAAO;YAClC,KAAK,EAAE,SAAS;YAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,gBAAgB,EAAE,cAAc;SACjC,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,8BAA8B,CACzC,UAA8B,EAC9B,WAAmB;QAEnB,MAAM,CAAC,IAAI,CAAC,gBAAgB,UAAU,CAAC,MAAM,OAAO,CAAC,CAAC;QAEtD,MAAM,OAAO,GAAsC,EAAE,CAAC;QAEtD,KAAK,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,UAAU,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iCAAiC,CACzD,WAAW,EACX,WAAW,EACX,WAAW,CACZ,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,YAAY,WAAW,MAAM,WAAW,KAAK,KAAK,EAAE,CAAC,CAAC;gBACnE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAC7D,MAAM,CAAC,IAAI,CAAC,eAAe,YAAY,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;QAEhE,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACI,eAAe,CAAC,OAAe;QACpC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACI,iBAAiB;QACtB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACpD,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,aAAa,CAAC,OAAO,CACtD,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,sBAAsB;QAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/B,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACrD,IAAI,WAAW,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC7D,OAAO,CAAC,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC;gBACvC,YAAY,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;QAED,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC,UAAU,YAAY,QAAQ,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,OAAe;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,SAAS;IAET;;OAEG;IACK,sBAAsB;QAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;aACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;aAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,OAAe,EAAE,MAAqB;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;YACxB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,kBAAkB,CACxB,WAAmB,EACnB,WAAmB,EACnB,KAAc;QAEd,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO;YACL,OAAO,EAAE,KAAK;YACd,WAAW;YACX,WAAW;YACX,eAAe,EAAE;gBACf,OAAO,EAAE,WAAW;gBACpB,MAAM,EAAE,kBAAkB,CAAC,MAAM;gBACjC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,gBAAgB,EAAE,CAAC;gBACnB,YAAY;aACb;YACD,eAAe,EAAE;gBACf,OAAO,EAAE,WAAW;gBACpB,MAAM,EAAE,kBAAkB,CAAC,MAAM;gBACjC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,gBAAgB,EAAE,CAAC;gBACnB,YAAY;aACb;YACD,qBAAqB,EAAE,IAAI,CAAC,GAAG,EAAE;YACjC,uBAAuB,EAAE,CAAC;YAC1B,YAAY;SACb,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;CACF;AAED,+EAA+E;AAC/E,OAAO;AACP,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,sCAAsC;IACpD,OAAO,IAAI,oCAAoC,EAAE,CAAC;AACpD,CAAC;AAED,+EAA+E;AAC/E,KAAK;AACL,+EAA+E;AAC/E,+DAA+D"}

package/dist/ipfs-client.d.ts

@@ -0,0 +1,151 @@
+/**
+ * IPFS 客户端模块
+ * 基于 Rust SDK 的 HTTP API 实现
+ * 使用直接 HTTP 请求与 IPFS 节点交互
+ */
+/**
+ * IPFS 上传结果
+ */
+export interface IpfsUploadResult {
+    /** IPFS CID */
+    cid: string;
+    /** 文件大小（字节） */
+    size: number;
+    /** 上传时间 */
+    uploadedAt: string;
+    /** 使用的提供者 */
+    provider: string;
+}
+/**
+ * IPNS 发布结果
+ */
+export interface IpnsPublishResult {
+    /** IPNS 名称（PeerID） */
+    name: string;
+    /** IPNS 值（/ipfs/<CID> 路径） */
+    value: string;
+    /** 发布时间 */
+    publishedAt: string;
+}
+/**
+ * 远程 IPFS 配置
+ */
+export interface RemoteIpfsConfig {
+    /** IPFS API URL */
+    apiUrl: string;
+    /** IPFS Gateway URL */
+    gatewayUrl: string;
+}
+/**
+ * Pinata 配置
+ */
+export interface PinataConfig {
+    /** Pinata API Key */
+    apiKey: string;
+    /** Pinata API Secret */
+    apiSecret: string;
+}
+/**
+ * IPFS 客户端
+ * 基于 HTTP API 的轻量级实现
+ */
+export declare class IpfsClient {
+    private apiUrl;
+    private gatewayUrl;
+    private pinataConfig;
+    private timeout;
+    private publicGateways;
+    /**
+     * 创建新的 IPFS 客户端
+     */
+    constructor(apiUrl?: string | null, gatewayUrl?: string | null, pinataApiKey?: string | null, pinataApiSecret?: string | null, timeoutSeconds?: number);
+    /**
+     * 创建仅使用公共网关的客户端
+     */
+    static newPublicOnly(timeoutSeconds?: number): Promise<IpfsClient>;
+    /**
+     * 创建使用远程 IPFS 节点的客户端
+     */
+    static newWithRemoteNode(apiUrl: string, gatewayUrl: string, timeoutSeconds?: number): Promise<IpfsClient>;
+    /**
+     * 创建使用 Pinata 的客户端
+     */
+    static newWithPinata(apiKey: string, apiSecret: string, timeoutSeconds?: number): Promise<IpfsClient>;
+    /**
+     * 上传内容到 IPFS
+     */
+    upload(content: string, name?: string): Promise<IpfsUploadResult>;
+    /**
+     * 上传到远程 IPFS API
+     */
+    private uploadToRemoteApi;
+    /**
+     * 上传到 Pinata
+     */
+    private uploadToPinata;
+    /**
+     * 从 IPFS 获取内容
+     */
+    get(cid: string): Promise<string>;
+    /**
+     * 从指定网关获取内容
+     */
+    private getFromGateway;
+    /**
+     * Pin 内容到远程 IPFS 节点
+     */
+    pin(cid: string): Promise<void>;
+    /**
+     * 确保 IPNS 密钥存在
+     */
+    ensureKeyExists(keyName: string): Promise<string>;
+    /**
+     * 发布 IPNS 记录
+     */
+    publishIpns(cid: string, keyName: string, lifetime?: string, ttl?: string): Promise<IpnsPublishResult>;
+    /**
+     * 便捷：上传后发布到 IPNS
+     */
+    publishAfterUpload(cid: string, keyName: string, lifetime?: string, ttl?: string): Promise<IpnsPublishResult>;
+    /**
+     * 发布 IPNS 并同时 Pin 到多节点（确保内容可用性）
+     */
+    publishAndPin(cid: string, keyName: string, lifetime?: string, ttl?: string, pinNodes?: string[]): Promise<IpnsPublishResult>;
+    /**
+     * 上传后直接发布到 IPNS DHT（allow-offline=false）
+     */
+    publishAfterUploadDirect(cid: string, keyName: string, lifetime?: string, ttl?: string): Promise<IpnsPublishResult>;
+    /**
+     * 并行发布到多个 IPFS 节点（加速传播）
+     */
+    publishToMultipleNodes(cid: string, keyName: string, nodes: string[], lifetime?: string, ttl?: string): Promise<IpnsPublishResult[]>;
+    /**
+     * 批量发布到多个 IPNS key（适用于多身份场景）
+     */
+    batchPublishIpns(cid: string, keys: string[], lifetime?: string): Promise<IpnsPublishResult[]>;
+    /**
+     * 广播 IPNS 记录到 DHT（加速传播）
+     */
+    broadcastToDht(ipnsName: string): Promise<void>;
+    /**
+     * 预传播 CID 到多个节点（加速首次访问）
+     */
+    prepropagateCid(cid: string, bootstrapNodes?: string[]): Promise<void>;
+    /**
+     * 解析 IPNS 名称为 CID
+     */
+    resolveIpns(ipnsName: string): Promise<string>;
+    /**
+     * 获取 API URL
+     */
+    getApiUrl(): string | null;
+    /**
+     * 获取网关 URL
+     */
+    getGatewayUrl(): string | null;
+    /**
+     * 停止客户端
+     */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=ipfs-client.d.ts.map

package/dist/ipfs-client.d.ts.map

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