forgex-cli 1.0.0

package/dist/src/adapters/jito-adapter.d.ts

@@ -0,0 +1,194 @@
+/**
+ * ForgeX CLI Jito Bundle 直连适配器
+ *
+ * 替代现有通过 forgex.online/api 代理的 bundle 状态查询和发送。
+ * 直接调用 Jito Block Engine 的 JSON-RPC API。
+ *
+ * 设计参考: ARCH-DESIGN-v2.md Section 2.5
+ *
+ * 复用自 sol-sdk/jito/index.ts 的端点配置和 tip 账户列表。
+ */
+import { PublicKey } from '@solana/web3.js';
+/** Jito Block Engine API 端点列表 (多区域容错) */
+export declare const JITO_ENDPOINTS: string[];
+/** Jito Tip 账户列表 */
+export declare const JITO_TIP_ACCOUNTS: string[];
+/** Bundle 确认状态枚举 */
+export declare enum BundleStatusEnum {
+    /** 已发送，尚未处理 */
+    SENT = "sent",
+    /** 已处理 (包含在区块中) */
+    PROCESSED = "processed",
+    /** 已确认 (超级多数验证) */
+    CONFIRMED = "confirmed",
+    /** 已最终确认 (不可逆) */
+    FINALIZED = "finalized",
+    /** 执行失败 */
+    FAILED = "failed",
+    /** 查询超时 */
+    TIMEOUT = "timeout",
+    /** 在 landing 中 (inflight) */
+    INFLIGHT = "inflight",
+    /** 未知状态 */
+    UNKNOWN = "unknown"
+}
+/** Bundle 状态查询结果 (getBundleStatuses API) */
+export interface BundleStatusResult {
+    /** Bundle ID */
+    bundleId: string;
+    /** 确认状态 */
+    status: BundleStatusEnum;
+    /** Bundle 所在的 Slot */
+    slot?: number;
+    /** Bundle 中包含的交易签名列表 */
+    transactions?: string[];
+    /** 确认时间 (Unix ms) */
+    confirmationTime?: number;
+    /** 错误信息 (如果失败) */
+    err?: any;
+}
+/** Inflight Bundle 状态 */
+export interface InflightBundleStatus {
+    bundleId: string;
+    status: string;
+    landedSlot?: number;
+}
+/** Bundle 确认等待结果 */
+export interface BundleConfirmationResult {
+    /** Bundle ID */
+    bundleId: string;
+    /** 最终状态 */
+    status: BundleStatusEnum;
+    /** 是否成功 (processed/confirmed/finalized) */
+    success: boolean;
+    /** Bundle 所在的 Slot */
+    slot?: number;
+    /** Bundle 中的交易列表 */
+    transactions?: string[];
+    /** 错误信息 */
+    error?: string;
+}
+/** 等待确认选项 */
+export interface WaitOptions {
+    /** 超时时间 (ms), 默认 60000 */
+    timeoutMs?: number;
+    /** 轮询间隔 (ms), 默认 2000 */
+    intervalMs?: number;
+}
+export declare class JitoAdapter {
+    private endpoints;
+    private currentEndpointIndex;
+    private client;
+    private maxRetries;
+    constructor(options?: {
+        endpoints?: string[];
+        maxRetries?: number;
+    });
+    /**
+     * 发送 JSON-RPC 请求到 Jito Block Engine
+     * @param path API 路径 (如 /bundles)
+     * @param method JSON-RPC 方法名
+     * @param params JSON-RPC 参数
+     */
+    private sendRequest;
+    /**
+     * 带指数退避重试 + 端点轮转的执行器
+     * 1. 在当前端点上重试 maxRetries 次 (指数退避)
+     * 2. 如果当前端点全部失败，切换到下一个端点继续
+     * 3. 所有端点都失败后抛出最后一个错误
+     */
+    private executeWithRetry;
+    /** 判断错误是否可重试 */
+    private isRetryableError;
+    /** 切换到下一个端点 */
+    private switchEndpoint;
+    /** 获取当前端点 URL (供调试使用) */
+    getCurrentEndpoint(): string;
+    /**
+     * 查询 Bundle 状态
+     * 调用 Jito 的 getBundleStatuses JSON-RPC 方法
+     *
+     * @param bundleIds 要查询的 Bundle ID 列表
+     * @returns 每个 Bundle 的状态
+     */
+    getBundleStatuses(bundleIds: string[]): Promise<BundleStatusResult[]>;
+    /**
+     * 查询单个 Bundle 的状态 (便捷方法)
+     */
+    getBundleStatus(bundleId: string): Promise<BundleStatusResult>;
+    /**
+     * 查询 Inflight Bundle 状态
+     * 用于查询刚发送、尚未落地的 bundle
+     */
+    getInflightBundleStatuses(bundleIds: string[]): Promise<InflightBundleStatus[]>;
+    /**
+     * 等待 Bundle 确认
+     * 轮询 getBundleStatuses 直到达到终态或超时
+     *
+     * @param bundleId Bundle ID
+     * @param options 超时和轮询间隔配置
+     * @returns Bundle 确认结果
+     */
+    waitForBundleConfirmation(bundleId: string, options?: WaitOptions): Promise<BundleConfirmationResult>;
+    /**
+     * 发送 Bundle 到 Jito Block Engine
+     * 直连 Jito，不经过 forgex.online/api 代理
+     *
+     * @param base64Txs Base64 编码的交易列表
+     * @returns Bundle ID
+     */
+    sendBundle(base64Txs: string[]): Promise<{
+        bundleId: string;
+    }>;
+    /**
+     * 从 Jito API 获取最新的 Tip 账户列表
+     * 通常使用本地硬编码的 JITO_TIP_ACCOUNTS 即可，
+     * 此方法用于需要动态获取最新 tip 账户的场景
+     */
+    getTipAccounts(): Promise<string[]>;
+    /**
+     * 随机获取一个 Tip 账户地址
+     * 使用本地硬编码列表，无网络开销
+     */
+    getRandomTipAccount(): string;
+    /**
+     * 构建 Jito Tip 转账指令
+     * 复用 sol-sdk/jito 中的逻辑
+     *
+     * @param payer 付款者的 PublicKey
+     * @param tipAmountSol Tip 金额 (SOL 单位)
+     * @returns SystemProgram.transfer 指令
+     */
+    getTipInstruction(payer: PublicKey, tipAmountSol: number): import("@solana/web3.js").TransactionInstruction;
+    /**
+     * 判断 Bundle 状态是否为成功状态
+     * (processed / confirmed / finalized 均视为成功)
+     */
+    isSuccessStatus(status: BundleStatusEnum): boolean;
+    /**
+     * 判断 Bundle 状态是否为终态 (不会再变化)
+     */
+    isTerminalStatus(status: BundleStatusEnum): boolean;
+    /**
+     * 将 Jito API 返回的状态字符串映射到 BundleStatusEnum
+     */
+    private mapBundleStatus;
+    /**
+     * 健康检查: 验证当前 Jito 端点是否可用
+     */
+    healthCheck(): Promise<{
+        healthy: boolean;
+        endpoint: string;
+        error?: string;
+    }>;
+}
+/**
+ * 获取 JitoAdapter 单例
+ * 首次调用时创建实例
+ */
+export declare function getJitoAdapter(): JitoAdapter;
+/**
+ * 重置单例 (用于配置变更后重新初始化)
+ */
+export declare function resetJitoAdapter(): void;
+//# sourceMappingURL=jito-adapter.d.ts.map

package/dist/src/adapters/jito-adapter.d.ts.map

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

package/dist/src/adapters/jito-adapter.js

@@ -0,0 +1,474 @@
+/**
+ * ForgeX CLI Jito Bundle 直连适配器
+ *
+ * 替代现有通过 forgex.online/api 代理的 bundle 状态查询和发送。
+ * 直接调用 Jito Block Engine 的 JSON-RPC API。
+ *
+ * 设计参考: ARCH-DESIGN-v2.md Section 2.5
+ *
+ * 复用自 sol-sdk/jito/index.ts 的端点配置和 tip 账户列表。
+ */
+import axios from 'axios';
+import { PublicKey, SystemProgram, LAMPORTS_PER_SOL } from '@solana/web3.js';
+import { loadConfig } from '../config.js';
+// ============================================================
+// 常量 (复用 sol-sdk/jito 配置)
+// ============================================================
+/** Jito Block Engine API 端点列表 (多区域容错) */
+export const JITO_ENDPOINTS = [
+    'https://mainnet.block-engine.jito.wtf/api/v1',
+    'https://amsterdam.mainnet.block-engine.jito.wtf/api/v1',
+    'https://frankfurt.mainnet.block-engine.jito.wtf/api/v1',
+    'https://ny.mainnet.block-engine.jito.wtf/api/v1',
+    'https://tokyo.mainnet.block-engine.jito.wtf/api/v1',
+];
+/** Jito Tip 账户列表 */
+export const JITO_TIP_ACCOUNTS = [
+    '96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5',
+    'HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe',
+    'Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY',
+    'ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49',
+    'DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh',
+    'ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt',
+    'DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL',
+    '3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT',
+];
+/** Bundle 确认状态枚举 */
+export var BundleStatusEnum;
+(function (BundleStatusEnum) {
+    /** 已发送，尚未处理 */
+    BundleStatusEnum["SENT"] = "sent";
+    /** 已处理 (包含在区块中) */
+    BundleStatusEnum["PROCESSED"] = "processed";
+    /** 已确认 (超级多数验证) */
+    BundleStatusEnum["CONFIRMED"] = "confirmed";
+    /** 已最终确认 (不可逆) */
+    BundleStatusEnum["FINALIZED"] = "finalized";
+    /** 执行失败 */
+    BundleStatusEnum["FAILED"] = "failed";
+    /** 查询超时 */
+    BundleStatusEnum["TIMEOUT"] = "timeout";
+    /** 在 landing 中 (inflight) */
+    BundleStatusEnum["INFLIGHT"] = "inflight";
+    /** 未知状态 */
+    BundleStatusEnum["UNKNOWN"] = "unknown";
+})(BundleStatusEnum || (BundleStatusEnum = {}));
+// ============================================================
+// 默认值
+// ============================================================
+const DEFAULT_MAX_RETRIES = 3;
+const INITIAL_RETRY_DELAY_MS = 500;
+const DEFAULT_TIMEOUT_MS = 60000;
+const DEFAULT_POLL_INTERVAL_MS = 2000;
+// ============================================================
+// JitoAdapter 实现
+// ============================================================
+export class JitoAdapter {
+    endpoints;
+    currentEndpointIndex;
+    client;
+    maxRetries;
+    constructor(options) {
+        // 端点列表: 用户配置 > 默认 Jito 端点
+        if (options?.endpoints && options.endpoints.length > 0) {
+            this.endpoints = [...options.endpoints];
+        }
+        else {
+            // 尝试从 config 读取自定义 Jito 端点
+            try {
+                const config = loadConfig();
+                const configEndpoints = config.jitoEndpoints;
+                if (Array.isArray(configEndpoints) && configEndpoints.length > 0) {
+                    this.endpoints = configEndpoints;
+                }
+                else {
+                    this.endpoints = [...JITO_ENDPOINTS];
+                }
+            }
+            catch {
+                this.endpoints = [...JITO_ENDPOINTS];
+            }
+        }
+        this.currentEndpointIndex = 0;
+        this.maxRetries = options?.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this.client = axios.create({
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            timeout: 15000,
+        });
+    }
+    // ============================================================
+    // 底层 JSON-RPC 通信
+    // ============================================================
+    /**
+     * 发送 JSON-RPC 请求到 Jito Block Engine
+     * @param path API 路径 (如 /bundles)
+     * @param method JSON-RPC 方法名
+     * @param params JSON-RPC 参数
+     */
+    async sendRequest(path, method, params) {
+        const baseUrl = this.endpoints[this.currentEndpointIndex];
+        const url = `${baseUrl}${path}`;
+        const payload = {
+            jsonrpc: '2.0',
+            id: 1,
+            method,
+            params: params || [],
+        };
+        const response = await this.client.post(url, payload);
+        return response.data;
+    }
+    // ============================================================
+    // 重试和容错 (与 RpcAdapter 一致的模式)
+    // ============================================================
+    /**
+     * 带指数退避重试 + 端点轮转的执行器
+     * 1. 在当前端点上重试 maxRetries 次 (指数退避)
+     * 2. 如果当前端点全部失败，切换到下一个端点继续
+     * 3. 所有端点都失败后抛出最后一个错误
+     */
+    async executeWithRetry(operation, operationName) {
+        const triedEndpoints = new Set();
+        let lastError = null;
+        while (triedEndpoints.size < this.endpoints.length) {
+            triedEndpoints.add(this.currentEndpointIndex);
+            for (let attempt = 0; attempt < this.maxRetries; attempt++) {
+                try {
+                    return await operation();
+                }
+                catch (err) {
+                    lastError = err;
+                    if (!this.isRetryableError(err)) {
+                        throw err;
+                    }
+                    // 指数退避等待
+                    if (attempt < this.maxRetries - 1) {
+                        const delay = INITIAL_RETRY_DELAY_MS * Math.pow(2, attempt);
+                        await sleep(delay);
+                    }
+                }
+            }
+            // 当前端点全部重试失败，尝试切换
+            const switched = this.switchEndpoint();
+            if (!switched)
+                break;
+        }
+        throw lastError || new Error(`${operationName}: 所有 Jito 端点均不可用`);
+    }
+    /** 判断错误是否可重试 */
+    isRetryableError(err) {
+        const message = (err?.message || '').toLowerCase();
+        const status = err?.response?.status;
+        // HTTP 状态码判断
+        if (status === 429 || status === 502 || status === 503 || status === 500) {
+            return true;
+        }
+        // 网络错误
+        if (message.includes('fetch failed') ||
+            message.includes('econnrefused') ||
+            message.includes('econnreset') ||
+            message.includes('enotfound') ||
+            message.includes('network error')) {
+            return true;
+        }
+        // 超时
+        if (message.includes('timeout') || message.includes('timed out') || err?.code === 'ECONNABORTED') {
+            return true;
+        }
+        // 速率限制
+        if (message.includes('rate limit') || message.includes('too many requests')) {
+            return true;
+        }
+        return false;
+    }
+    /** 切换到下一个端点 */
+    switchEndpoint() {
+        if (this.endpoints.length <= 1)
+            return false;
+        const oldIndex = this.currentEndpointIndex;
+        this.currentEndpointIndex = (this.currentEndpointIndex + 1) % this.endpoints.length;
+        return this.currentEndpointIndex !== oldIndex;
+    }
+    /** 获取当前端点 URL (供调试使用) */
+    getCurrentEndpoint() {
+        return this.endpoints[this.currentEndpointIndex];
+    }
+    // ============================================================
+    // Bundle 状态查询
+    // ============================================================
+    /**
+     * 查询 Bundle 状态
+     * 调用 Jito 的 getBundleStatuses JSON-RPC 方法
+     *
+     * @param bundleIds 要查询的 Bundle ID 列表
+     * @returns 每个 Bundle 的状态
+     */
+    async getBundleStatuses(bundleIds) {
+        if (bundleIds.length === 0)
+            return [];
+        return this.executeWithRetry(async () => {
+            const response = await this.sendRequest('/bundles', 'getBundleStatuses', [bundleIds]);
+            if (response.error) {
+                throw new Error(`Jito getBundleStatuses 错误: ${response.error.message}`);
+            }
+            const value = response.result?.value;
+            if (!Array.isArray(value)) {
+                // 没有找到任何 bundle 状态
+                return bundleIds.map((id) => ({
+                    bundleId: id,
+                    status: BundleStatusEnum.UNKNOWN,
+                }));
+            }
+            return bundleIds.map((id, index) => {
+                const entry = value[index];
+                if (!entry) {
+                    return { bundleId: id, status: BundleStatusEnum.UNKNOWN };
+                }
+                return {
+                    bundleId: entry.bundle_id || id,
+                    status: this.mapBundleStatus(entry.confirmation_status),
+                    slot: entry.slot ?? undefined,
+                    transactions: entry.transactions ?? undefined,
+                    err: entry.err ?? undefined,
+                };
+            });
+        }, 'getBundleStatuses');
+    }
+    /**
+     * 查询单个 Bundle 的状态 (便捷方法)
+     */
+    async getBundleStatus(bundleId) {
+        const results = await this.getBundleStatuses([bundleId]);
+        return results[0];
+    }
+    /**
+     * 查询 Inflight Bundle 状态
+     * 用于查询刚发送、尚未落地的 bundle
+     */
+    async getInflightBundleStatuses(bundleIds) {
+        if (bundleIds.length === 0)
+            return [];
+        return this.executeWithRetry(async () => {
+            const response = await this.sendRequest('/bundles', 'getInflightBundleStatuses', [bundleIds]);
+            if (response.error) {
+                throw new Error(`Jito getInflightBundleStatuses 错误: ${response.error.message}`);
+            }
+            const value = response.result?.value;
+            if (!Array.isArray(value)) {
+                return bundleIds.map((id) => ({
+                    bundleId: id,
+                    status: 'unknown',
+                }));
+            }
+            return value.map((entry, index) => ({
+                bundleId: entry?.bundle_id || bundleIds[index],
+                status: entry?.status || 'unknown',
+                landedSlot: entry?.landed_slot ?? undefined,
+            }));
+        }, 'getInflightBundleStatuses');
+    }
+    // ============================================================
+    // Bundle 确认等待 (轮询)
+    // ============================================================
+    /**
+     * 等待 Bundle 确认
+     * 轮询 getBundleStatuses 直到达到终态或超时
+     *
+     * @param bundleId Bundle ID
+     * @param options 超时和轮询间隔配置
+     * @returns Bundle 确认结果
+     */
+    async waitForBundleConfirmation(bundleId, options) {
+        const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        const intervalMs = options?.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            try {
+                const status = await this.getBundleStatus(bundleId);
+                // 终态判断
+                if (this.isTerminalStatus(status.status)) {
+                    const success = this.isSuccessStatus(status.status);
+                    return {
+                        bundleId,
+                        status: status.status,
+                        success,
+                        slot: status.slot,
+                        transactions: status.transactions,
+                        error: success ? undefined : `Bundle 状态: ${status.status}`,
+                    };
+                }
+                // 非终态 (SENT/INFLIGHT/UNKNOWN) -- 继续轮询
+            }
+            catch {
+                // 查询失败不立即退出，继续重试
+                // executeWithRetry 内部已经做了重试，这里只处理最终失败
+            }
+            await sleep(intervalMs);
+        }
+        // 超时
+        return {
+            bundleId,
+            status: BundleStatusEnum.TIMEOUT,
+            success: false,
+            error: `等待 Bundle 确认超时 (${timeoutMs}ms)`,
+        };
+    }
+    // ============================================================
+    // Bundle 发送
+    // ============================================================
+    /**
+     * 发送 Bundle 到 Jito Block Engine
+     * 直连 Jito，不经过 forgex.online/api 代理
+     *
+     * @param base64Txs Base64 编码的交易列表
+     * @returns Bundle ID
+     */
+    async sendBundle(base64Txs) {
+        if (base64Txs.length === 0) {
+            throw new Error('sendBundle: 交易列表不能为空');
+        }
+        return this.executeWithRetry(async () => {
+            const response = await this.sendRequest('/bundles', 'sendBundle', [base64Txs]);
+            if (response.error) {
+                throw new Error(`Jito sendBundle 错误: ${response.error.message}`);
+            }
+            const bundleId = response.result;
+            if (!bundleId || typeof bundleId !== 'string') {
+                throw new Error('Jito sendBundle: 未返回有效的 Bundle ID');
+            }
+            return { bundleId };
+        }, 'sendBundle');
+    }
+    // ============================================================
+    // Tip 相关查询
+    // ============================================================
+    /**
+     * 从 Jito API 获取最新的 Tip 账户列表
+     * 通常使用本地硬编码的 JITO_TIP_ACCOUNTS 即可，
+     * 此方法用于需要动态获取最新 tip 账户的场景
+     */
+    async getTipAccounts() {
+        return this.executeWithRetry(async () => {
+            const response = await this.sendRequest('/bundles', 'getTipAccounts');
+            if (response.error) {
+                throw new Error(`Jito getTipAccounts 错误: ${response.error.message}`);
+            }
+            const accounts = response.result;
+            if (Array.isArray(accounts) && accounts.length > 0) {
+                return accounts;
+            }
+            // fallback 到本地硬编码列表
+            return [...JITO_TIP_ACCOUNTS];
+        }, 'getTipAccounts');
+    }
+    /**
+     * 随机获取一个 Tip 账户地址
+     * 使用本地硬编码列表，无网络开销
+     */
+    getRandomTipAccount() {
+        const index = Math.floor(Math.random() * JITO_TIP_ACCOUNTS.length);
+        return JITO_TIP_ACCOUNTS[index];
+    }
+    /**
+     * 构建 Jito Tip 转账指令
+     * 复用 sol-sdk/jito 中的逻辑
+     *
+     * @param payer 付款者的 PublicKey
+     * @param tipAmountSol Tip 金额 (SOL 单位)
+     * @returns SystemProgram.transfer 指令
+     */
+    getTipInstruction(payer, tipAmountSol) {
+        const tipAccount = new PublicKey(this.getRandomTipAccount());
+        const lamports = Math.floor(tipAmountSol * LAMPORTS_PER_SOL);
+        return SystemProgram.transfer({
+            fromPubkey: payer,
+            toPubkey: tipAccount,
+            lamports,
+        });
+    }
+    // ============================================================
+    // 辅助方法
+    // ============================================================
+    /**
+     * 判断 Bundle 状态是否为成功状态
+     * (processed / confirmed / finalized 均视为成功)
+     */
+    isSuccessStatus(status) {
+        return (status === BundleStatusEnum.PROCESSED ||
+            status === BundleStatusEnum.CONFIRMED ||
+            status === BundleStatusEnum.FINALIZED);
+    }
+    /**
+     * 判断 Bundle 状态是否为终态 (不会再变化)
+     */
+    isTerminalStatus(status) {
+        return (status === BundleStatusEnum.PROCESSED ||
+            status === BundleStatusEnum.CONFIRMED ||
+            status === BundleStatusEnum.FINALIZED ||
+            status === BundleStatusEnum.FAILED);
+    }
+    /**
+     * 将 Jito API 返回的状态字符串映射到 BundleStatusEnum
+     */
+    mapBundleStatus(rawStatus) {
+        if (!rawStatus)
+            return BundleStatusEnum.UNKNOWN;
+        const normalized = rawStatus.toLowerCase();
+        switch (normalized) {
+            case 'sent':
+                return BundleStatusEnum.SENT;
+            case 'processed':
+                return BundleStatusEnum.PROCESSED;
+            case 'confirmed':
+                return BundleStatusEnum.CONFIRMED;
+            case 'finalized':
+                return BundleStatusEnum.FINALIZED;
+            case 'failed':
+                return BundleStatusEnum.FAILED;
+            default:
+                return BundleStatusEnum.UNKNOWN;
+        }
+    }
+    /**
+     * 健康检查: 验证当前 Jito 端点是否可用
+     */
+    async healthCheck() {
+        const endpoint = this.getCurrentEndpoint();
+        try {
+            // getTipAccounts 是最轻量的 Jito API 调用，适合做健康检查
+            await this.getTipAccounts();
+            return { healthy: true, endpoint };
+        }
+        catch (err) {
+            return { healthy: false, endpoint, error: err.message };
+        }
+    }
+}
+// ============================================================
+// 单例管理 (与 RpcAdapter 一致的模式)
+// ============================================================
+let _instance = null;
+/**
+ * 获取 JitoAdapter 单例
+ * 首次调用时创建实例
+ */
+export function getJitoAdapter() {
+    if (!_instance) {
+        _instance = new JitoAdapter();
+    }
+    return _instance;
+}
+/**
+ * 重置单例 (用于配置变更后重新初始化)
+ */
+export function resetJitoAdapter() {
+    _instance = null;
+}
+// ============================================================
+// 工具函数
+// ============================================================
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=jito-adapter.js.map