forgex-cli 1.0.58 → 1.0.61

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

@@ -1,50 +1,50 @@
 /**
- * ForgeX CLI RPC 数据获取层
+ * ForgeX CLI RPC Data Fetch Layer
  *
- * 提供余额、账户信息、交易确认等链上数据查询。
- * 复用 sol-sdk/rpc/ 基础设施，增加多端点容错和重试机制。
+ * Provides on-chain data queries: balance, account info, transaction confirmation, etc.
+ * Reuses sol-sdk/rpc/ infrastructure with multi-endpoint fault tolerance and retry mechanism.
  *
- * 设计参考: ARCH-DESIGN-v2.md Section 2.4
+ * Design reference: ARCH-DESIGN-v2.md Section 2.4
  */
 import { ParsedTransactionWithMeta, AccountInfo } from '@solana/web3.js';
-/** 单个 Token 账户信息 */
+/** Single Token account info */
 export interface TokenAccountInfo {
-    /** Token mint 地址 */
+    /** Token mint address */
     mint: string;
-    /** 所属钱包地址 */
+    /** Owner wallet address */
     owner: string;
-    /** UI 可读余额 (已除以 decimals) */
+    /** UI-readable balance (divided by decimals) */
     uiAmount: number;
-    /** 原始余额 (lamports/最小单位) */
+    /** Raw balance (lamports/minimum unit) */
     amount: string;
-    /** Token 小数位数 */
+    /** Token decimals */
     decimals: number;
 }
-/** 交易状态 */
+/** Transaction status */
 export type TransactionStatus = 'confirmed' | 'finalized' | 'failed' | 'not_found';
-/** 解析后的交易详情 */
+/** Parsed transaction detail */
 export interface ParsedTransactionDetail {
-    /** 交易签名 */
+    /** Transaction signature */
     txHash: string;
-    /** Slot 高度 */
+    /** Slot height */
     slot: number;
-    /** 区块时间 (Unix 秒) */
+    /** Block time (Unix seconds) */
     blockTime: number | null;
-    /** 交易手续费 (lamports) */
+    /** Transaction fee (lamports) */
     fee: number;
-    /** 交易是否失败 */
+    /** Whether transaction failed */
     err: any;
-    /** 交易前 SOL 余额数组 (lamports) */
+    /** Pre-transaction SOL balances array (lamports) */
     preBalances: number[];
-    /** 交易后 SOL 余额数组 (lamports) */
+    /** Post-transaction SOL balances array (lamports) */
     postBalances: number[];
-    /** 交易前 Token 余额数组 */
+    /** Pre-transaction Token balances array */
     preTokenBalances: any[];
-    /** 交易后 Token 余额数组 */
+    /** Post-transaction Token balances array */
     postTokenBalances: any[];
-    /** 账户地址列表 */
+    /** Account address list */
     accountKeys: string[];
-    /** 原始 ParsedTransactionWithMeta (供 TxDetailAdapter 使用) */
+    /** Raw ParsedTransactionWithMeta (for TxDetailAdapter use) */
     raw: ParsedTransactionWithMeta;
 }
 export declare class RpcAdapter {
@@ -56,78 +56,78 @@ export declare class RpcAdapter {
         endpoints?: string[];
         maxRetries?: number;
     });
-    /** 获取当前活跃端点的 Connection */
+    /** Get Connection for current active endpoint */
     private getConnection;
-    /** 切换到下一个端点 */
+    /** Switch to next endpoint */
     private switchEndpoint;
-    /** 获取当前端点 URL (供调试使用) */
+    /** Get current endpoint URL (for debugging) */
     getCurrentEndpoint(): string;
     /**
-     * 带指数退避重试 + 端点轮转的执行器
-     * 1. 在当前端点上重试 maxRetries 次 (指数退避)
-     * 2. 如果当前端点全部失败，切换到下一个端点继续
-     * 3. 所有端点都失败后抛出最后一个错误
+     * Executor with exponential backoff retry + endpoint rotation
+     * 1. Retry maxRetries times on current endpoint (exponential backoff)
+     * 2. If current endpoint fails all retries, switch to next endpoint
+     * 3. Throw last error after all endpoints fail
      */
     private executeWithRetry;
-    /** 判断错误是否可重试 */
+    /** Check if error is retryable */
     private isRetryableError;
     /**
-     * 获取单个钱包的 SOL 余额
-     * @returns SOL 余额 (UI 单位, 如 1.5 SOL)
+     * Get single wallet SOL balance
+     * @returns SOL balance (UI units, e.g. 1.5 SOL)
      */
     getSolBalance(address: string): Promise<number>;
     /**
-     * 批量获取多个钱包的 SOL 余额
-     * 使用 getMultipleAccountsInfo 批量查询，减少 RPC 调用次数
-     * @returns Record<地址, SOL余额>
+     * Batch get SOL balances for multiple wallets
+     * Uses getMultipleAccountsInfo for batch queries, reducing RPC call count
+     * @returns Record<address, SOL balance>
      */
     getBatchSolBalances(addresses: string[]): Promise<Record<string, number>>;
     /**
-     * 获取单个钱包的单个 Token 余额
-     * @returns Token 余额 (UI 单位)
+     * Get single token balance for a wallet
+     * @returns Token balance (UI units)
      */
     getTokenBalance(walletAddress: string, tokenMint: string): Promise<number>;
     /**
-     * 获取单个钱包的所有 Token 账户
-     * 直接通过 RPC 查询，替代 forgex.online/api 的 getTokenListFromAddress
+     * Get all token accounts for a wallet
+     * Queries directly via RPC, replacing forgex.online/api getTokenListFromAddress
      */
     getTokenAccountsByOwner(walletAddress: string): Promise<TokenAccountInfo[]>;
     /**
-     * 批量获取多个钱包在指定代币上的余额
-     * @returns Record<钱包地址, Token余额>
+     * Batch get token balances for multiple wallets on a specific token
+     * @returns Record<wallet address, Token balance>
      */
     getBatchTokenBalances(walletAddresses: string[], tokenMint: string): Promise<Record<string, number>>;
     /**
-     * 查询单笔交易的确认状态
+     * Query confirmation status of a single transaction
      */
     getTransactionStatus(txHash: string): Promise<TransactionStatus>;
     /**
-     * 获取交易详情
-     * 返回解析后的交易数据，包含余额变化、Token 变化等
+     * Get transaction details
+     * Returns parsed transaction data including balance changes, token changes, etc.
      */
     getTransactionDetail(txHash: string): Promise<ParsedTransactionDetail | null>;
     /**
-     * 批量查询交易状态
+     * Batch query transaction statuses
      * @returns Record<txHash, TransactionStatus>
      */
     getBatchTransactionStatuses(txHashes: string[]): Promise<Record<string, TransactionStatus>>;
     /**
-     * 获取账户信息 (原始)
+     * Get account info (raw)
      */
     getAccountInfo(address: string): Promise<AccountInfo<Buffer> | null>;
     /**
-     * 获取最新区块哈希
+     * Get latest blockhash
      */
     getLatestBlockhash(): Promise<{
         blockhash: string;
         lastValidBlockHeight: number;
     }>;
     /**
-     * 获取当前 slot
+     * Get current slot
      */
     getSlot(): Promise<number>;
     /**
-     * 健康检查: 验证当前端点是否可用
+     * Health check: verify current endpoint availability
      */
     healthCheck(): Promise<{
         healthy: boolean;
@@ -137,12 +137,12 @@ export declare class RpcAdapter {
     }>;
 }
 /**
- * 获取 RpcAdapter 单例
- * 首次调用时从 config 读取 RPC 配置创建实例
+ * Get RpcAdapter singleton
+ * Creates instance from config RPC settings on first call
  */
 export declare function getRpcAdapter(): RpcAdapter;
 /**
- * 重置单例 (用于配置变更后重新初始化)
+ * Reset singleton (for re-initialization after config changes)
  */
 export declare function resetRpcAdapter(): void;
 //# sourceMappingURL=rpc-adapter.d.ts.map

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

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

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

@@ -1,26 +1,26 @@
 /**
- * ForgeX CLI RPC 数据获取层
+ * ForgeX CLI RPC Data Fetch Layer
  *
- * 提供余额、账户信息、交易确认等链上数据查询。
- * 复用 sol-sdk/rpc/ 基础设施，增加多端点容错和重试机制。
+ * Provides on-chain data queries: balance, account info, transaction confirmation, etc.
+ * Reuses sol-sdk/rpc/ infrastructure with multi-endpoint fault tolerance and retry mechanism.
  *
- * 设计参考: ARCH-DESIGN-v2.md Section 2.4
+ * Design reference: ARCH-DESIGN-v2.md Section 2.4
  */
 import { Connection, PublicKey, LAMPORTS_PER_SOL, } from '@solana/web3.js';
 import { TOKEN_PROGRAM_ID } from '@solana/spl-token';
 import BigNumber from 'bignumber.js';
 import { loadConfig } from '../config.js';
 // ============================================================
-// 常量
+// Constants
 // ============================================================
-/** 默认重试次数 */
+/** Default retry count */
 const DEFAULT_MAX_RETRIES = 3;
-/** 初始重试延迟 (ms) */
+/** Initial retry delay (ms) */
 const INITIAL_RETRY_DELAY_MS = 500;
-/** 批量查询分片大小 (getMultipleAccountsInfo 上限 100) */
+/** Batch query chunk size (getMultipleAccountsInfo limit 100) */
 const BATCH_CHUNK_SIZE = 100;
 // ============================================================
-// RpcAdapter 实现
+// RpcAdapter Implementation
 // ============================================================
 export class RpcAdapter {
     endpoints;
@@ -29,19 +29,19 @@ export class RpcAdapter {
     maxRetries;
     constructor(options) {
         const config = loadConfig();
-        // 构建端点列表: 主端点 + 可选备用端点
+        // Build endpoint list: primary endpoint + optional fallback endpoints
         this.endpoints = [];
         if (options?.endpoints && options.endpoints.length > 0) {
             this.endpoints = [...options.endpoints];
         }
         else {
-            // 从配置读取主端点
+            // Read primary endpoint from config
             if (config.rpcUrl) {
                 this.endpoints.push(config.rpcUrl);
             }
         }
         if (this.endpoints.length === 0) {
-            // 兜底: Solana 公共端点
+            // Fallback: Solana public endpoint
             this.endpoints.push('https://api.mainnet-beta.solana.com');
         }
         this.currentEndpointIndex = 0;
@@ -49,9 +49,9 @@ export class RpcAdapter {
         this.maxRetries = options?.maxRetries ?? DEFAULT_MAX_RETRIES;
     }
     // ============================================================
-    // 连接管理
+    // Connection Management
     // ============================================================
-    /** 获取当前活跃端点的 Connection */
+    /** Get Connection for current active endpoint */
     getConnection(commitment = 'processed') {
         const url = this.endpoints[this.currentEndpointIndex];
         const key = `${url}_${commitment}`;
@@ -60,27 +60,27 @@ export class RpcAdapter {
         }
         return this.connections.get(key);
     }
-    /** 切换到下一个端点 */
+    /** Switch to next endpoint */
     switchEndpoint() {
         if (this.endpoints.length <= 1)
             return false;
         const oldIndex = this.currentEndpointIndex;
         this.currentEndpointIndex = (this.currentEndpointIndex + 1) % this.endpoints.length;
-        // 如果已经轮了一圈回到起点，说明所有端点都尝试过了
+        // If cycled back to start, all endpoints have been tried
         return this.currentEndpointIndex !== oldIndex;
     }
-    /** 获取当前端点 URL (供调试使用) */
+    /** Get current endpoint URL (for debugging) */
     getCurrentEndpoint() {
         return this.endpoints[this.currentEndpointIndex];
     }
     // ============================================================
-    // 重试和容错
+    // Retry and Fault Tolerance
     // ============================================================
     /**
-     * 带指数退避重试 + 端点轮转的执行器
-     * 1. 在当前端点上重试 maxRetries 次 (指数退避)
-     * 2. 如果当前端点全部失败，切换到下一个端点继续
-     * 3. 所有端点都失败后抛出最后一个错误
+     * Executor with exponential backoff retry + endpoint rotation
+     * 1. Retry maxRetries times on current endpoint (exponential backoff)
+     * 2. If current endpoint fails all retries, switch to next endpoint
+     * 3. Throw last error after all endpoints fail
      */
     async executeWithRetry(operation, operationName) {
         const triedEndpoints = new Set();
@@ -94,56 +94,56 @@ export class RpcAdapter {
                 }
                 catch (err) {
                     lastError = err;
-                    // 判断是否为可重试的错误
+                    // Check if error is retryable
                     const isRetryable = this.isRetryableError(err);
                     if (!isRetryable) {
-                        throw err; // 不可重试的错误直接抛出 (如参数错误)
+                        throw err; // Non-retryable errors throw immediately (e.g. invalid params)
                     }
-                    // 指数退避等待
+                    // Exponential backoff wait
                     if (attempt < this.maxRetries - 1) {
                         const delay = INITIAL_RETRY_DELAY_MS * Math.pow(2, attempt);
                         await sleep(delay);
                     }
                 }
             }
-            // 当前端点全部重试失败，尝试切换
+            // All retries failed on current endpoint, try switching
             const switched = this.switchEndpoint();
             if (!switched)
                 break;
         }
-        throw lastError || new Error(`${operationName}: 所有 RPC 端点均不可用`);
+        throw lastError || new Error(`${operationName}: All RPC endpoints unavailable`);
     }
-    /** 判断错误是否可重试 */
+    /** Check if error is retryable */
     isRetryableError(err) {
         const message = (err?.message || '').toLowerCase();
-        // 网络错误
+        // Network error
         if (message.includes('fetch failed') || message.includes('econnrefused') || message.includes('econnreset')) {
             return true;
         }
-        // 速率限制
+        // Rate limit
         if (message.includes('429') || message.includes('rate limit') || message.includes('too many requests')) {
             return true;
         }
-        // 服务端错误
+        // Server error
         if (message.includes('503') || message.includes('502') || message.includes('500')) {
             return true;
         }
-        // RPC 超时
+        // RPC timeout
         if (message.includes('timeout') || message.includes('timed out')) {
             return true;
         }
-        // Solana RPC 特定的暂时性错误
+        // Solana RPC specific transient errors
         if (message.includes('blockhash not found') || message.includes('slot skipped')) {
             return true;
         }
         return false;
     }
     // ============================================================
-    // SOL 余额查询
+    // SOL Balance Queries
     // ============================================================
     /**
-     * 获取单个钱包的 SOL 余额
-     * @returns SOL 余额 (UI 单位, 如 1.5 SOL)
+     * Get single wallet SOL balance
+     * @returns SOL balance (UI units, e.g. 1.5 SOL)
      */
     async getSolBalance(address) {
         return this.executeWithRetry(async (connection) => {
@@ -153,15 +153,15 @@ export class RpcAdapter {
         }, 'getSolBalance');
     }
     /**
-     * 批量获取多个钱包的 SOL 余额
-     * 使用 getMultipleAccountsInfo 批量查询，减少 RPC 调用次数
-     * @returns Record<地址, SOL余额>
+     * Batch get SOL balances for multiple wallets
+     * Uses getMultipleAccountsInfo for batch queries, reducing RPC call count
+     * @returns Record<address, SOL balance>
      */
     async getBatchSolBalances(addresses) {
         if (addresses.length === 0)
             return {};
         const result = {};
-        // 分批查询 (getMultipleAccountsInfo 上限 100 个账户)
+        // Batch query (getMultipleAccountsInfo limit 100 accounts)
         for (let i = 0; i < addresses.length; i += BATCH_CHUNK_SIZE) {
             const chunk = addresses.slice(i, i + BATCH_CHUNK_SIZE);
             const pubkeys = chunk.map(addr => new PublicKey(addr));
@@ -178,11 +178,11 @@ export class RpcAdapter {
         return result;
     }
     // ============================================================
-    // SPL Token 查询
+    // SPL Token Queries
     // ============================================================
     /**
-     * 获取单个钱包的单个 Token 余额
-     * @returns Token 余额 (UI 单位)
+     * Get single token balance for a wallet
+     * @returns Token balance (UI units)
      */
     async getTokenBalance(walletAddress, tokenMint) {
         return this.executeWithRetry(async (connection) => {
@@ -190,7 +190,7 @@ export class RpcAdapter {
                 const { getAssociatedTokenAddress, TOKEN_2022_PROGRAM_ID } = await import('@solana/spl-token');
                 const mintPubkey = new PublicKey(tokenMint);
                 const ownerPubkey = new PublicKey(walletAddress);
-                // 先尝试标准 TOKEN_PROGRAM_ID
+                // First try standard TOKEN_PROGRAM_ID
                 try {
                     const ataAddress = await getAssociatedTokenAddress(mintPubkey, ownerPubkey);
                     const balanceResp = await connection.getTokenAccountBalance(ataAddress);
@@ -199,9 +199,9 @@ export class RpcAdapter {
                         return balance;
                 }
                 catch {
-                    // 标准 ATA 不存在，继续尝试 Token-2022
+                    // Standard ATA does not exist, try Token-2022
                 }
-                // 再尝试 TOKEN_2022_PROGRAM_ID（Pump.fun 等使用）
+                // Try TOKEN_2022_PROGRAM_ID (used by Pump.fun etc.)
                 try {
                     const ata2022 = await getAssociatedTokenAddress(mintPubkey, ownerPubkey, false, TOKEN_2022_PROGRAM_ID);
                     const balanceResp = await connection.getTokenAccountBalance(ata2022);
@@ -212,14 +212,14 @@ export class RpcAdapter {
                 }
             }
             catch {
-                // ATA 不存在 = 余额为 0
+                // ATA does not exist = balance is 0
                 return 0;
             }
         }, 'getTokenBalance');
     }
     /**
-     * 获取单个钱包的所有 Token 账户
-     * 直接通过 RPC 查询，替代 forgex.online/api 的 getTokenListFromAddress
+     * Get all token accounts for a wallet
+     * Queries directly via RPC, replacing forgex.online/api getTokenListFromAddress
      */
     async getTokenAccountsByOwner(walletAddress) {
         return this.executeWithRetry(async (connection) => {
@@ -245,14 +245,14 @@ export class RpcAdapter {
         }, 'getTokenAccountsByOwner');
     }
     /**
-     * 批量获取多个钱包在指定代币上的余额
-     * @returns Record<钱包地址, Token余额>
+     * Batch get token balances for multiple wallets on a specific token
+     * @returns Record<wallet address, Token balance>
      */
     async getBatchTokenBalances(walletAddresses, tokenMint) {
         if (walletAddresses.length === 0)
             return {};
         const result = {};
-        // 并发查询，但做流控 (每批最多 10 个并发)
+        // Concurrent queries with rate limiting (max 10 concurrent per batch)
         const CONCURRENCY = 10;
         for (let i = 0; i < walletAddresses.length; i += CONCURRENCY) {
             const batch = walletAddresses.slice(i, i + CONCURRENCY);
@@ -272,10 +272,10 @@ export class RpcAdapter {
         return result;
     }
     // ============================================================
-    // 交易状态查询
+    // Transaction Status Queries
     // ============================================================
     /**
-     * 查询单笔交易的确认状态
+     * Query confirmation status of a single transaction
      */
     async getTransactionStatus(txHash) {
         return this.executeWithRetry(async (connection) => {
@@ -297,8 +297,8 @@ export class RpcAdapter {
         }, 'getTransactionStatus');
     }
     /**
-     * 获取交易详情
-     * 返回解析后的交易数据，包含余额变化、Token 变化等
+     * Get transaction details
+     * Returns parsed transaction data including balance changes, token changes, etc.
      */
     async getTransactionDetail(txHash) {
         return this.executeWithRetry(async (connection) => {
@@ -309,7 +309,7 @@ export class RpcAdapter {
             if (!tx || !tx.meta) {
                 return null;
             }
-            // 提取 accountKeys
+            // Extract accountKeys
             const accountKeys = tx.transaction.message.accountKeys.map((key) => typeof key === 'string' ? key : key.pubkey.toBase58());
             return {
                 txHash,
@@ -327,14 +327,14 @@ export class RpcAdapter {
         }, 'getTransactionDetail');
     }
     /**
-     * 批量查询交易状态
+     * Batch query transaction statuses
      * @returns Record<txHash, TransactionStatus>
      */
     async getBatchTransactionStatuses(txHashes) {
         if (txHashes.length === 0)
             return {};
         const result = {};
-        // getSignatureStatuses 一次最多 256 个签名
+        // getSignatureStatuses supports max 256 signatures per call
         const SIGNATURE_BATCH_SIZE = 256;
         for (let i = 0; i < txHashes.length; i += SIGNATURE_BATCH_SIZE) {
             const batch = txHashes.slice(i, i + SIGNATURE_BATCH_SIZE);
@@ -360,10 +360,10 @@ export class RpcAdapter {
         return result;
     }
     // ============================================================
-    // 通用 RPC 查询
+    // General RPC Queries
     // ============================================================
     /**
-     * 获取账户信息 (原始)
+     * Get account info (raw)
      */
     async getAccountInfo(address) {
         return this.executeWithRetry(async (connection) => {
@@ -371,7 +371,7 @@ export class RpcAdapter {
         }, 'getAccountInfo');
     }
     /**
-     * 获取最新区块哈希
+     * Get latest blockhash
      */
     async getLatestBlockhash() {
         return this.executeWithRetry(async (connection) => {
@@ -379,7 +379,7 @@ export class RpcAdapter {
         }, 'getLatestBlockhash');
     }
     /**
-     * 获取当前 slot
+     * Get current slot
      */
     async getSlot() {
         return this.executeWithRetry(async (connection) => {
@@ -387,7 +387,7 @@ export class RpcAdapter {
         }, 'getSlot');
     }
     /**
-     * 健康检查: 验证当前端点是否可用
+     * Health check: verify current endpoint availability
      */
     async healthCheck() {
         const endpoint = this.getCurrentEndpoint();
@@ -401,12 +401,12 @@ export class RpcAdapter {
     }
 }
 // ============================================================
-// 单例管理
+// Singleton Management
 // ============================================================
 let _instance = null;
 /**
- * 获取 RpcAdapter 单例
- * 首次调用时从 config 读取 RPC 配置创建实例
+ * Get RpcAdapter singleton
+ * Creates instance from config RPC settings on first call
  */
 export function getRpcAdapter() {
     if (!_instance) {
@@ -415,13 +415,13 @@ export function getRpcAdapter() {
     return _instance;
 }
 /**
- * 重置单例 (用于配置变更后重新初始化)
+ * Reset singleton (for re-initialization after config changes)
  */
 export function resetRpcAdapter() {
     _instance = null;
 }
 // ============================================================
-// 工具函数
+// Utility Functions
 // ============================================================
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));