@diap/sdk 0.1.1 → 0.1.3

package/dist/ipns-manager.js

@@ -0,0 +1,268 @@
+/**
+ * DIAP TypeScript SDK - IPNS 管理器
+ * 负责 IPNS 记录的发布、解析和 Key 管理
+ */
+import { logger } from './utils/logger.js';
+/**
+ * IPNS 记录状态
+ */
+export var IpnsRecordStatus;
+(function (IpnsRecordStatus) {
+    /** 待发布 */
+    IpnsRecordStatus["Pending"] = "pending";
+    /** 已发布 */
+    IpnsRecordStatus["Published"] = "published";
+    /** 已过期 */
+    IpnsRecordStatus["Expired"] = "expired";
+    /** 失败 */
+    IpnsRecordStatus["Failed"] = "failed";
+})(IpnsRecordStatus || (IpnsRecordStatus = {}));
+/**
+ * IPNS 管理器
+ */
+export class IpnsManager {
+    /** 配置 */
+    config;
+    /** Key 列表 */
+    keys;
+    /** 记录缓存 */
+    recordCache;
+    /** 使用 w3name */
+    useW3name;
+    /**
+     * 创建 IPNS 管理器
+     */
+    static async create(config) {
+        logger.info('🚀 创建 IPNS 管理器');
+        const manager = new IpnsManager(config);
+        await manager.initialize();
+        return manager;
+    }
+    /**
+     * 构造函数
+     */
+    constructor(config) {
+        this.config = {
+            useW3name: config?.useW3name ?? true,
+            useIpfsNode: config?.useIpfsNode ?? true,
+            validityDays: config?.validityDays ?? 365,
+            defaultTtl: config?.defaultTtl ?? 3600,
+        };
+        this.keys = new Map();
+        this.recordCache = new Map();
+        this.useW3name = this.config.useW3name;
+    }
+    /**
+     * 初始化管理器
+     */
+    async initialize() {
+        logger.info('💾 IPNS 管理器已初始化');
+        logger.info(`  使用 w3name: ${this.config.useW3name}`);
+        logger.info(`  使用 IPFS 节点: ${this.config.useIpfsNode}`);
+        logger.info(`  有效期: ${this.config.validityDays} 天`);
+    }
+    /**
+     * 发布 IPNS 记录
+     */
+    async publish(cid, keyName = 'self', lifetime = 86400, ttl) {
+        logger.info(`📤 发布 IPNS 记录: ${cid}`);
+        const keyInfo = this.keys.get(keyName);
+        if (!keyInfo) {
+            throw new Error(`Key not found: ${keyName}`);
+        }
+        const name = `/ipns/${keyInfo.id}`;
+        const sequence = this.getNextSequence(name);
+        const validity = Date.now() + this.config.validityDays * 24 * 60 * 60 * 1000;
+        // 创建 IPNS 记录
+        const record = {
+            name,
+            value: cid,
+            sequence,
+            validity,
+            signature: new Uint8Array(64), // 模拟签名
+            ttl: ttl || this.config.defaultTtl,
+        };
+        // 发布到 IPNS
+        if (this.useW3name) {
+            await this.publishToW3name(record);
+        }
+        else {
+            await this.publishToIpfs(record);
+        }
+        // 缓存记录
+        this.recordCache.set(name, record);
+        const result = {
+            name,
+            value: cid,
+            sequence,
+            validity,
+            signature: Buffer.from(record.signature).toString('base64'),
+            publishedAt: new Date().toISOString(),
+        };
+        logger.info(`✅ IPNS 记录已发布: ${name}`);
+        return result;
+    }
+    /**
+     * 发布到 w3name
+     */
+    async publishToW3name(record) {
+        logger.debug('发布到 w3name...');
+        // 模拟 w3name 发布
+        return new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    /**
+     * 发布到 IPFS 节点
+     */
+    async publishToIpfs(record) {
+        logger.debug('发布到 IPFS 节点...');
+        // 模拟 IPFS 发布
+        return new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    /**
+     * 解析 IPNS 名称
+     */
+    async resolve(ipnsName) {
+        logger.info(`🔍 解析 IPNS: ${ipnsName}`);
+        // 检查缓存
+        const cached = this.recordCache.get(ipnsName);
+        if (cached && cached.validity > Date.now()) {
+            logger.debug('使用缓存的 IPNS 记录');
+            return {
+                name: ipnsName,
+                value: cached.value,
+                sequence: cached.sequence,
+                ttl: cached.ttl,
+                cachedAt: new Date().toISOString(),
+            };
+        }
+        // 从网络解析
+        if (this.useW3name) {
+            return await this.resolveFromW3name(ipnsName);
+        }
+        else {
+            return await this.resolveFromIpfs(ipnsName);
+        }
+    }
+    /**
+     * 从 w3name 解析
+     */
+    async resolveFromW3name(ipnsName) {
+        logger.debug('从 w3name 解析...');
+        // 模拟 w3name 解析
+        return {
+            name: ipnsName,
+            value: 'QmDefaultResolvedCid',
+            sequence: 1,
+            ttl: this.config.defaultTtl,
+        };
+    }
+    /**
+     * 从 IPFS 节点解析
+     */
+    async resolveFromIpfs(ipnsName) {
+        logger.debug('从 IPFS 节点解析...');
+        // 模拟 IPFS 解析
+        return {
+            name: ipnsName,
+            value: 'QmDefaultResolvedCid',
+            sequence: 1,
+            ttl: this.config.defaultTtl,
+        };
+    }
+    /**
+     * 确保 Key 存在
+     */
+    async ensureKeyExists(keyName) {
+        let keyInfo = this.keys.get(keyName);
+        if (!keyInfo) {
+            keyInfo = await this.createKey(keyName);
+        }
+        return keyInfo;
+    }
+    /**
+     * 创建新的 IPNS Key
+     */
+    async createKey(keyName) {
+        logger.info(`🔑 创建 IPNS Key: ${keyName}`);
+        // 生成 Key ID
+        const id = this.generateKeyId();
+        const keyInfo = {
+            name: keyName,
+            id,
+        };
+        this.keys.set(keyName, keyInfo);
+        logger.info(`✅ Key 创建成功: ${id}`);
+        return keyInfo;
+    }
+    /**
+     * 列出所有 Key
+     */
+    listKeys() {
+        return Array.from(this.keys.values());
+    }
+    /**
+     * 删除 Key
+     */
+    async removeKey(keyName) {
+        if (this.keys.has(keyName)) {
+            this.keys.delete(keyName);
+            logger.info(`🗑️ Key 已删除: ${keyName}`);
+        }
+    }
+    /**
+     * 获取下一个序列号
+     */
+    getNextSequence(name) {
+        const record = this.recordCache.get(name);
+        return record ? record.sequence + 1 : 1;
+    }
+    /**
+     * 生成 Key ID
+     */
+    generateKeyId() {
+        const chars = '0123456789abcdef';
+        let result = 'k51';
+        for (let i = 0; i < 50; i++) {
+            result += chars[Math.floor(Math.random() * chars.length)];
+        }
+        return result;
+    }
+    /**
+     * 获取配置
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * 清空缓存
+     */
+    clearCache() {
+        this.recordCache.clear();
+        logger.info('🧹 IPNS 缓存已清空');
+    }
+    /**
+     * 获取缓存的记录数
+     */
+    getCacheSize() {
+        return this.recordCache.size;
+    }
+    /**
+     * 获取 Key 数量
+     */
+    getKeyCount() {
+        return this.keys.size;
+    }
+}
+// ============================================================================
+// 便捷函数
+// ============================================================================
+/**
+ * 创建 IPNS 管理器（便捷函数）
+ */
+export async function createIpnsManager(config) {
+    return IpnsManager.create(config);
+}
+// ============================================================================
+// 导出
+// ============================================================================
+//# sourceMappingURL=ipns-manager.js.map

package/dist/ipns-manager.js.map

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

package/dist/key-manager.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 密钥管理模块
+ * 负责密钥的生成、存储、加载和管理
+ */
+import type { KeyPair, KeyBackup } from './types/key.js';
+/**
+ * 密钥管理器
+ */
+export declare class KeyManager {
+    /**
+     * 生成新的 Ed25519 密钥对
+     */
+    static generate(): KeyPair;
+    /**
+     * 从私钥加载密钥对
+     */
+    static fromPrivateKey(privateKey: Uint8Array): KeyPair;
+    /**
+     * 从文件加载密钥对
+     */
+    static fromFile(path: string): Promise<KeyPair>;
+    /**
+     * 保存密钥对到文件
+     */
+    static saveToFile(keypair: KeyPair, path: string): Promise<void>;
+    /**
+     * 导出密钥备份（加密）
+     */
+    static exportBackup(keypair: KeyPair, password?: string): KeyBackup;
+    /**
+     * 从备份导入密钥
+     */
+    static importFromBackup(backup: KeyBackup, password?: string): KeyPair;
+    /**
+     * 使用 Ed25519 签名数据
+     */
+    static sign(keypair: KeyPair, data: Uint8Array): Promise<Uint8Array>;
+    /**
+     * 验证 Ed25519 签名
+     */
+    static verify(keypair: KeyPair, data: Uint8Array, signature: Uint8Array): Promise<boolean>;
+    /**
+     * 派生 did:key 格式的 DID
+     * 参考: https://w3c-ccg.github.io/did-method-key/#ed25519-x25519
+     */
+    private static deriveDIDKey;
+}
+//# sourceMappingURL=key-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"key-manager.d.ts","sourceRoot":"","sources":["../src/key-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAW,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAOlE;;GAEG;AACH,qBAAa,UAAU;IACrB;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,OAAO;IAuB1B;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;IAsBtD;;OAEG;WACU,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBrD;;OAEG;WACU,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BtE;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS;IAmDnE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAsCtE;;OAEG;WACU,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAS1E;;OAEG;WACU,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAUhG;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;CAiB5B"}

package/dist/key-manager.js

@@ -0,0 +1,231 @@
+/**
+ * 密钥管理模块
+ * 负责密钥的生成、存储、加载和管理
+ */
+import * as ed25519 from '@noble/ed25519';
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { KeyManagementError } from './types/errors.js';
+import { encodeHex, decodeHex } from './utils/encoding.js';
+import { encryptAES256GCM, decryptAES256GCM, deriveKey, generateRandomBytes } from './utils/crypto.js';
+import { encodeBase58 } from './utils/encoding.js';
+import { logger } from './utils/logger.js';
+/**
+ * 密钥管理器
+ */
+export class KeyManager {
+    /**
+     * 生成新的 Ed25519 密钥对
+     */
+    static generate() {
+        try {
+            // 生成32字节随机私钥
+            const privateKey = ed25519.utils.randomPrivateKey();
+            // 从私钥派生公钥
+            const publicKey = ed25519.getPublicKey(privateKey);
+            // 派生 did:key 格式的 DID
+            const did = KeyManager.deriveDIDKey(publicKey);
+            logger.debug('Generated new Ed25519 keypair', { did });
+            return {
+                privateKey,
+                publicKey,
+                did,
+            };
+        }
+        catch (error) {
+            throw new KeyManagementError('Failed to generate keypair', { originalError: error });
+        }
+    }
+    /**
+     * 从私钥加载密钥对
+     */
+    static fromPrivateKey(privateKey) {
+        if (privateKey.length !== 32) {
+            throw new KeyManagementError('Private key must be 32 bytes');
+        }
+        try {
+            // 从私钥派生公钥
+            const publicKey = ed25519.getPublicKey(privateKey);
+            // 派生 did:key 格式的 DID
+            const did = KeyManager.deriveDIDKey(publicKey);
+            return {
+                privateKey,
+                publicKey,
+                did,
+            };
+        }
+        catch (error) {
+            throw new KeyManagementError('Failed to load keypair from private key', { originalError: error });
+        }
+    }
+    /**
+     * 从文件加载密钥对
+     */
+    static async fromFile(path) {
+        try {
+            const content = await fs.readFile(path, 'utf-8');
+            const keyFile = JSON.parse(content);
+            // 解码私钥
+            const privateKeyBytes = decodeHex(keyFile.privateKey);
+            if (privateKeyBytes.length !== 32) {
+                throw new KeyManagementError('Invalid private key length in file');
+            }
+            return KeyManager.fromPrivateKey(privateKeyBytes);
+        }
+        catch (error) {
+            if (error instanceof KeyManagementError) {
+                throw error;
+            }
+            throw new KeyManagementError(`Failed to load keypair from file: ${path}`, { originalError: error });
+        }
+    }
+    /**
+     * 保存密钥对到文件
+     */
+    static async saveToFile(keypair, path) {
+        try {
+            const keyFile = {
+                keyType: 'Ed25519',
+                privateKey: encodeHex(keypair.privateKey),
+                publicKey: encodeHex(keypair.publicKey),
+                did: keypair.did,
+                createdAt: new Date().toISOString(),
+                version: '2.0',
+            };
+            const content = JSON.stringify(keyFile, null, 2);
+            // 确保目录存在
+            const dir = join(path, '..');
+            await fs.mkdir(dir, { recursive: true });
+            // 写入文件
+            await fs.writeFile(path, content, { mode: 0o600 }); // 设置权限为 600
+            logger.debug('Saved keypair to file', { path });
+        }
+        catch (error) {
+            throw new KeyManagementError(`Failed to save keypair to file: ${path}`, { originalError: error });
+        }
+    }
+    /**
+     * 导出密钥备份（加密）
+     */
+    static exportBackup(keypair, password) {
+        try {
+            const keyFile = {
+                keyType: 'Ed25519',
+                privateKey: encodeHex(keypair.privateKey),
+                publicKey: encodeHex(keypair.publicKey),
+                did: keypair.did,
+                createdAt: new Date().toISOString(),
+                version: '2.0',
+            };
+            const jsonData = JSON.stringify(keyFile);
+            let encryptedData;
+            if (password) {
+                // 使用密码加密
+                const salt = generateRandomBytes(16);
+                const key = deriveKey(password, salt);
+                const { ciphertext, nonce, tag } = encryptAES256GCM(new TextEncoder().encode(jsonData), key, generateRandomBytes(12));
+                // 组合: salt + nonce + tag + ciphertext
+                const combined = new Uint8Array(salt.length + nonce.length + tag.length + ciphertext.length);
+                let offset = 0;
+                combined.set(salt, offset);
+                offset += salt.length;
+                combined.set(nonce, offset);
+                offset += nonce.length;
+                combined.set(tag, offset);
+                offset += tag.length;
+                combined.set(ciphertext, offset);
+                encryptedData = Buffer.from(combined).toString('base64');
+            }
+            else {
+                // 无密码时使用 base64 编码
+                encryptedData = Buffer.from(jsonData).toString('base64');
+            }
+            return {
+                encryptedData,
+                exportedAt: new Date().toISOString(),
+            };
+        }
+        catch (error) {
+            throw new KeyManagementError('Failed to export key backup', { originalError: error });
+        }
+    }
+    /**
+     * 从备份导入密钥
+     */
+    static importFromBackup(backup, password) {
+        try {
+            const encryptedBuffer = Buffer.from(backup.encryptedData, 'base64');
+            let jsonData;
+            if (password) {
+                // 解密数据
+                const salt = new Uint8Array(encryptedBuffer.slice(0, 16));
+                const nonce = new Uint8Array(encryptedBuffer.slice(16, 28));
+                const tag = new Uint8Array(encryptedBuffer.slice(28, 44));
+                const ciphertext = new Uint8Array(encryptedBuffer.slice(44));
+                const key = deriveKey(password, salt);
+                const decrypted = decryptAES256GCM(ciphertext, key, nonce, tag);
+                jsonData = new TextDecoder().decode(decrypted);
+            }
+            else {
+                // 直接解码 base64
+                jsonData = encryptedBuffer.toString('utf-8');
+            }
+            const keyFile = JSON.parse(jsonData);
+            const privateKeyBytes = decodeHex(keyFile.privateKey);
+            if (privateKeyBytes.length !== 32) {
+                throw new KeyManagementError('Invalid private key length in backup');
+            }
+            return KeyManager.fromPrivateKey(privateKeyBytes);
+        }
+        catch (error) {
+            if (error instanceof KeyManagementError) {
+                throw error;
+            }
+            throw new KeyManagementError('Failed to import key from backup', { originalError: error });
+        }
+    }
+    /**
+     * 使用 Ed25519 签名数据
+     */
+    static async sign(keypair, data) {
+        try {
+            const signature = await ed25519.sign(data, keypair.privateKey);
+            return signature;
+        }
+        catch (error) {
+            throw new KeyManagementError('Failed to sign data', { originalError: error });
+        }
+    }
+    /**
+     * 验证 Ed25519 签名
+     */
+    static async verify(keypair, data, signature) {
+        try {
+            const isValid = await ed25519.verify(signature, data, keypair.publicKey);
+            return isValid;
+        }
+        catch (error) {
+            logger.warn('Signature verification failed', { error });
+            return false;
+        }
+    }
+    /**
+     * 派生 did:key 格式的 DID
+     * 参考: https://w3c-ccg.github.io/did-method-key/#ed25519-x25519
+     */
+    static deriveDIDKey(publicKey) {
+        if (publicKey.length !== 32) {
+            throw new KeyManagementError('Public key must be 32 bytes for Ed25519');
+        }
+        // 构造 multicodec 前缀: 0xed01 (Ed25519 public key)
+        // multibase base58btc编码: z
+        const prefix = new Uint8Array([0xed, 0x01]);
+        const combined = new Uint8Array(prefix.length + publicKey.length);
+        combined.set(prefix, 0);
+        combined.set(publicKey, prefix.length);
+        // Base58 编码
+        const encoded = encodeBase58(combined);
+        return `did:key:z${encoded}`;
+    }
+}
+//# sourceMappingURL=key-manager.js.map

package/dist/key-manager.js.map

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

package/dist/kubo-installer.d.ts

@@ -0,0 +1,115 @@
+/**
+ * DIAP TypeScript SDK - Kubo 安装器
+ * 自动下载和安装 Kubo（Go-IPFS）二进制文件
+ */
+/**
+ * Kubo 安装状态
+ */
+export declare enum InstallationStatus {
+    /** 未知 */
+    Unknown = "unknown",
+    /** 检查中 */
+    Checking = "checking",
+    /** 已安装 */
+    Installed = "installed",
+    /** 下载中 */
+    Downloading = "downloading",
+    /** 安装中 */
+    Installing = "installing",
+    /** 安装失败 */
+    Failed = "failed"
+}
+/**
+ * Kubo 安装结果
+ */
+export interface InstallationResult {
+    /** 是否成功 */
+    success: boolean;
+    /** Kubo 路径 */
+    path?: string;
+    /** 版本 */
+    version?: string;
+    /** 错误信息 */
+    error?: string;
+}
+/**
+ * Kubo 版本信息
+ */
+export interface KuboVersion {
+    /** 版本号 */
+    version: string;
+    /** 发布日期 */
+    releaseDate: string;
+    /** 下载链接 */
+    downloadUrl: string;
+}
+/**
+ * Kubo 安装器配置
+ */
+export interface KuboInstallerConfig {
+    /** 安装目录 */
+    installDir?: string;
+    /** 是否强制重新安装 */
+    forceReinstall?: boolean;
+    /** 下载超时（毫秒） */
+    downloadTimeout?: number;
+    /** 代理 URL */
+    proxyUrl?: string;
+}
+/**
+ * Kubo 安装器
+ */
+export declare class KuboInstaller {
+    private config;
+    private platform;
+    private arch;
+    /**
+     * 创建 Kubo 安装器
+     */
+    constructor(config?: KuboInstallerConfig);
+    /**
+     * 检查 Kubo 是否已安装
+     */
+    checkInstalled(): Promise<boolean>;
+    /**
+     * 获取 Kubo 版本
+     */
+    getVersion(): Promise<string | null>;
+    /**
+     * 安装 Kubo
+     */
+    install(): Promise<InstallationResult>;
+    /**
+     * 卸载 Kubo
+     */
+    uninstall(): Promise<boolean>;
+    /**
+     * 获取下载链接
+     */
+    getDownloadUrl(): string;
+    /**
+     * 获取默认安装目录
+     */
+    private getDefaultInstallDir;
+    /**
+     * 检测平台
+     */
+    private detectPlatform;
+    /**
+     * 检测架构
+     */
+    private detectArch;
+}
+/**
+ * 创建 Kubo 安装器
+ */
+export declare function createKuboInstaller(config?: KuboInstallerConfig): KuboInstaller;
+/**
+ * 检查 Kubo 是否已安装
+ */
+export declare function isKuboInstalled(): Promise<boolean>;
+/**
+ * 安装 Kubo
+ */
+export declare function installKubo(config?: KuboInstallerConfig): Promise<InstallationResult>;
+//# sourceMappingURL=kubo-installer.d.ts.map