@diap/sdk 0.1.1 → 0.1.2

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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"}