forgex-cli 1.0.58 → 1.0.61

package/dist/src/tx-tracker/index.d.ts

@@ -1,20 +1,20 @@
 /**
- * ForgeX CLI TxTracker -- 交易追踪系统
+ * ForgeX CLI TxTracker -- Transaction tracking system
  *
- * 在每次交易发起后:
- * 1. 通过 RPC 或 Jito API 轮询检查交易状态
- * 2. 确认后获取完整交易详情
- * 3. 通过 TxDetailAdapter 将链上原始数据映射为 CLI 数据结构
- * 4. 自动写入 DataStore (交易记录、持仓、余额)
+ * After each transaction is initiated:
+ * 1. Poll RPC or Jito API to check transaction status
+ * 2. After confirmation, fetch full transaction details
+ * 3. Map raw on-chain data to CLI data structures via TxDetailAdapter
+ * 4. Auto-write to DataStore (transaction records, positions, balance)
  *
- * 支持:
- * - 普通交易追踪 (trackTransaction)
- * - Jito Bundle 追踪 (trackBundle)
- * - 批量交易追踪 (trackBatch)
- * - 进度回调 (onProgress)
- * - 可配置的轮询间隔和超时
+ * Supports:
+ * - Single transaction tracking (trackTransaction)
+ * - Jito Bundle tracking (trackBundle)
+ * - Batch transaction tracking (trackBatch)
+ * - Progress callback (onProgress)
+ * - Configurable poll interval and timeout
  *
- * 设计参考: ARCH-DESIGN-v2.md Section 3.2 ~ 3.6
+ * Design reference: ARCH-DESIGN-v2.md Section 3.2 ~ 3.6
  */
 import { RpcAdapter } from '../adapters/rpc-adapter.js';
 import { JitoAdapter } from '../adapters/jito-adapter.js';
@@ -23,26 +23,26 @@ import type { TrackingContext } from './detail-adapter.js';
 import type { TransactionRecord } from '../data-store/types.js';
 export { TxDetailAdapter } from './detail-adapter.js';
 export type { TrackingContext } from './detail-adapter.js';
-/** 追踪选项 */
+/** Tracking options */
 export interface TrackingOptions {
-    /** 轮询间隔 (ms), 默认 2000 */
+    /** Poll interval (ms), default 2000 */
     pollIntervalMs?: number;
-    /** 超时时间 (ms), 默认 60000 */
+    /** Timeout (ms), default 60000 */
     timeoutMs?: number;
-    /** 最大重试次数 (RPC 请求失败时), 默认 3 */
+    /** Max retries (when RPC request fails), default 3 */
     maxRetries?: number;
-    /** 进度回调 */
+    /** Progress callback */
     onProgress?: (status: string, txHash: string) => void;
 }
-/** 单笔交易追踪结果 */
+/** Single transaction tracking result */
 export interface TrackingResult {
-    /** 交易签名 */
+    /** Transaction signature */
     txHash: string;
-    /** 最终状态 */
+    /** Final status */
     status: 'confirmed' | 'failed' | 'timeout';
-    /** 成功时的交易记录 */
+    /** Transaction record when successful */
     record?: TransactionRecord;
-    /** 失败原因 */
+    /** Failure reason */
     error?: string;
 }
 export declare class TxTracker {
@@ -52,91 +52,91 @@ export declare class TxTracker {
     private adapter;
     constructor(rpc?: RpcAdapter, jito?: JitoAdapter, store?: DataStore);
     /**
-     * 追踪单笔普通交易。
+     * Track a single regular transaction.
      *
-     * 流程:
-     * 1. 轮询 RPC 直到交易确认 / 失败 / 超时
-     * 2. 确认后获取交易详情
-     * 3. 通过 TxDetailAdapter 适配为 TransactionRecord
-     * 4. 写入 DataStore (交易记录 + 持仓 + 余额)
+     * Flow:
+     * 1. Poll RPC until transaction confirmed / failed / timeout
+     * 2. After confirmation, fetch transaction details
+     * 3. Adapt to TransactionRecord via TxDetailAdapter
+     * 4. Write to DataStore (transaction record + position + balance)
      *
-     * @param txHash 交易签名
-     * @param context 追踪上下文
-     * @param options 追踪选项 (可选)
-     * @returns 追踪结果
+     * @param txHash Transaction signature
+     * @param context Tracking context
+     * @param options Tracking options (optional)
+     * @returns Tracking result
      */
     trackTransaction(txHash: string, context: TrackingContext, options?: TrackingOptions): Promise<TrackingResult>;
     /**
-     * 追踪 Jito Bundle。
+     * Track a Jito Bundle.
      *
-     * 流程:
-     * 1. 通过 JitoAdapter 等待 Bundle 确认
-     * 2. Bundle 确认后，逐个获取内部交易详情
-     * 3. 适配并写入 DataStore
+     * Flow:
+     * 1. Wait for Bundle confirmation via JitoAdapter
+     * 2. After Bundle confirmation, fetch internal transaction details one by one
+     * 3. Adapt and write to DataStore
      *
      * @param bundleId Jito Bundle ID
-     * @param txHashes Bundle 中包含的交易签名列表
-     * @param context 追踪上下文
-     * @param options 追踪选项 (可选)
-     * @returns 每笔交易的追踪结果
+     * @param txHashes Transaction signature list in the Bundle
+     * @param context Tracking context
+     * @param options Tracking options (optional)
+     * @returns Tracking result for each transaction
      */
     trackBundle(bundleId: string, txHashes: string[], context: TrackingContext, options?: TrackingOptions): Promise<TrackingResult[]>;
     /**
-     * 批量追踪多笔独立交易。
-     * 并发追踪所有交易，每笔交易独立处理。
+     * Batch track multiple independent transactions.
+     * Concurrently track all transactions, each processed independently.
      *
-     * @param entries 交易列表 (txHash + context)
-     * @param options 追踪选项 (可选)
-     * @returns 每笔交易的追踪结果
+     * @param entries Transaction list (txHash + context)
+     * @param options Tracking options (optional)
+     * @returns Tracking result for each transaction
      */
     trackBatch(entries: Array<{
         txHash: string;
         context: TrackingContext;
     }>, options?: TrackingOptions): Promise<TrackingResult[]>;
     /**
-     * 轮询 RPC 直到交易确认、失败或超时。
+     * Poll RPC until transaction is confirmed, failed, or timed out.
      *
-     * 策略:
-     * - 每隔 pollIntervalMs 查询一次交易状态
-     * - confirmed / finalized -> 返回 'confirmed'
-     * - failed -> 返回 'failed'
-     * - not_found -> 继续等待
-     * - RPC 请求错误 -> 计入重试次数，超限后抛出
-     * - 超时 -> 返回 'timeout'
+     * Strategy:
+     * - Query transaction status every pollIntervalMs
+     * - confirmed / finalized -> return 'confirmed'
+     * - failed -> return 'failed'
+     * - not_found -> keep waiting
+     * - RPC request error -> count retries, throw after limit
+     * - timeout -> return 'timeout'
      */
     private pollUntilConfirmed;
     /**
-     * 带重试的交易详情获取。
-     * 交易刚确认时，详情可能还没有被索引，需要多次尝试。
+     * Fetch transaction details with retry.
+     * Details may not be indexed immediately after confirmation, requiring multiple attempts.
      */
     private fetchDetailWithRetry;
     /**
-     * 处理已确认的单笔交易: 获取详情 -> 适配 -> 持久化
+     * Process a confirmed transaction: fetch details -> adapt -> persist
      */
     private processConfirmedTransaction;
     /**
-     * 将交易记录写入 DataStore
+     * Write transaction record to DataStore
      */
     private persistTransaction;
     /**
-     * 根据交易记录更新持仓数据
+     * Update holding data based on transaction record
      */
     private updateHoldingFromRecord;
     /**
-     * 根据交易记录更新余额快照
+     * Update balance snapshot based on transaction record
      */
     private updateBalanceFromRecord;
-    /** 创建 pending (超时) 状态的交易记录 */
+    /** Create a pending (timeout) transaction record */
     private createPendingRecord;
-    /** 创建 failed 状态的交易记录 */
+    /** Create a failed transaction record */
     private createFailedRecord;
-    /** 创建已确认但无详情的交易记录 */
+    /** Create a confirmed transaction record without details */
     private createConfirmedPartialRecord;
-    /** 合并用户选项和默认选项 */
+    /** Merge user options with defaults */
     private resolveOptions;
 }
-/** 获取 TxTracker 全局单例 */
+/** Get the global TxTracker singleton */
 export declare function getTxTracker(): TxTracker;
-/** 重置单例 (用于测试或配置变更) */
+/** Reset the singleton (for testing or config changes) */
 export declare function resetTxTracker(): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/tx-tracker/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tx-tracker/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,UAAU,EAAiB,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,WAAW,EAAoC,MAAM,6BAA6B,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAgB,MAAM,wBAAwB,CAAC;AAEjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,wBAAwB,CAAC;AAG/E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM3D,WAAW;AACX,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAED,eAAe;AACf,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,eAAe;IACf,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAwBD,qBAAa,SAAS;IACpB,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,OAAO,CAAkB;gBAErB,GAAG,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,SAAS;IAWnE;;;;;;;;;;;;;OAaG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,CAAC;IAwE1B;;;;;;;;;;;;;OAaG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,EAAE,CAAC;IAiE5B;;;;;;;OAOG;IACG,UAAU,CACd,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,eAAe,CAAA;KAAE,CAAC,EAC5D,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,EAAE,CAAC;IAqB5B;;;;;;;;;;OAUG;YACW,kBAAkB;IAuChC;;;OAGG;YACW,oBAAoB;IAwBlC;;OAEG;YACW,2BAA2B;IAwCzC;;OAEG;YACW,kBAAkB;IAQhC;;OAEG;YACW,uBAAuB;IAqBrC;;OAEG;YACW,uBAAuB;IA0BrC,8BAA8B;IAC9B,OAAO,CAAC,mBAAmB;IAiB3B,wBAAwB;IACxB,OAAO,CAAC,kBAAkB;IAiB1B,qBAAqB;IACrB,OAAO,CAAC,4BAA4B;IAqBpC,kBAAkB;IAClB,OAAO,CAAC,cAAc;CAQvB;AAQD,wBAAwB;AACxB,wBAAgB,YAAY,IAAI,SAAS,CAKxC;AAED,uBAAuB;AACvB,wBAAgB,cAAc,IAAI,IAAI,CAErC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tx-tracker/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,UAAU,EAAiB,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,WAAW,EAAoC,MAAM,6BAA6B,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAgB,MAAM,wBAAwB,CAAC;AAEjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,wBAAwB,CAAC;AAG/E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM3D,uBAAuB;AACvB,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,yCAAyC;IACzC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAwBD,qBAAa,SAAS;IACpB,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,OAAO,CAAkB;gBAErB,GAAG,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,SAAS;IAWnE;;;;;;;;;;;;;OAaG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,CAAC;IAwE1B;;;;;;;;;;;;;OAaG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,EAAE,CAAC;IAiE5B;;;;;;;OAOG;IACG,UAAU,CACd,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,eAAe,CAAA;KAAE,CAAC,EAC5D,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,EAAE,CAAC;IAqB5B;;;;;;;;;;OAUG;YACW,kBAAkB;IAuChC;;;OAGG;YACW,oBAAoB;IAwBlC;;OAEG;YACW,2BAA2B;IAwCzC;;OAEG;YACW,kBAAkB;IAQhC;;OAEG;YACW,uBAAuB;IAqBrC;;OAEG;YACW,uBAAuB;IA0BrC,oDAAoD;IACpD,OAAO,CAAC,mBAAmB;IAiB3B,yCAAyC;IACzC,OAAO,CAAC,kBAAkB;IAiB1B,4DAA4D;IAC5D,OAAO,CAAC,4BAA4B;IAqBpC,uCAAuC;IACvC,OAAO,CAAC,cAAc;CAQvB;AAQD,yCAAyC;AACzC,wBAAgB,YAAY,IAAI,SAAS,CAKxC;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,IAAI,IAAI,CAErC"}