forgex-cli 1.0.0

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

@@ -0,0 +1,238 @@
+/**
+ * ForgeX CLI Codex API 数据源适配器
+ *
+ * 通过 Codex GraphQL API 获取代币信息、价格、K线等市场数据,
+ * 替代原有对 forgex.online/api 的依赖。
+ *
+ * Codex API 文档: https://docs.codex.io
+ * GraphQL 端点: https://graph.codex.io/graphql
+ *
+ * 设计参考: ARCH-DESIGN-v2.md Section 2.3
+ */
+/** Solana 在 Codex 中的 networkId */
+declare const SOLANA_NETWORK_ID = 1399811149;
+/** SOL 原生代币 Wrapped 地址 (Codex 不支持原生代币直接查询, 需使用 Wrapped SOL) */
+declare const WRAPPED_SOL_MINT = "So11111111111111111111111111111111111111112";
+/** Codex API 配置 */
+export interface CodexConfig {
+    /** Codex API Key */
+    apiKey: string;
+    /** GraphQL 端点 (默认 https://graph.codex.io/graphql) */
+    baseUrl?: string;
+    /** 最大重试次数 */
+    maxRetries?: number;
+}
+/** 代币信息 (与 ARCH-DESIGN-v2.md 中 TokenInfoFile 对齐) */
+export interface CodexTokenInfo {
+    /** 合约地址 */
+    address: string;
+    /** 代币符号 */
+    symbol: string;
+    /** 代币名称 */
+    name: string;
+    /** 小数位数 */
+    decimals: number;
+    /** 总供应量 */
+    totalSupply: string;
+    /** 图标 URL */
+    imageUrl: string | null;
+    /** 创建时间 (Unix timestamp 秒) */
+    createdAt: number | null;
+    /** 网络 ID */
+    networkId: number;
+}
+/** 代币价格 */
+export interface CodexTokenPrice {
+    /** 合约地址 */
+    address: string;
+    /** 网络 ID */
+    networkId: number;
+    /** USD 价格 */
+    priceUsd: number;
+    /** 时间戳 */
+    timestamp: number | null;
+}
+/** 代币详细市场数据 (来自 filterTokens) */
+export interface CodexTokenMarketData {
+    /** 合约地址 */
+    address: string;
+    /** 代币符号 */
+    symbol: string;
+    /** 代币名称 */
+    name: string;
+    /** 小数位数 */
+    decimals: number;
+    /** USD 价格 */
+    priceUsd: number;
+    /** 24h 交易量 (USD) */
+    volume24h: number;
+    /** 24h 价格变化百分比 */
+    priceChange24h: number;
+    /** 流动性 (USD) */
+    liquidity: number;
+    /** 完全稀释市值 */
+    marketCap: number;
+    /** 持有者数量 */
+    holders: number;
+    /** 24h 买入次数 */
+    buyCount24h: number;
+    /** 24h 卖出次数 */
+    sellCount24h: number;
+    /** 24h 总交易笔数 */
+    txnCount24h: number;
+    /** 顶部交易对地址 */
+    topPairAddress: string | null;
+    /** 创建时间 (Unix timestamp 秒) */
+    createdAt: number | null;
+}
+/** K线柱 (OHLCV) */
+export interface CodexBar {
+    /** 时间戳 (Unix 秒) */
+    t: number;
+    /** 开盘价 (USD) */
+    o: number;
+    /** 最高价 (USD) */
+    h: number;
+    /** 最低价 (USD) */
+    l: number;
+    /** 收盘价 (USD) */
+    c: number;
+    /** 成交量 */
+    v: number;
+}
+/** 交易对/池信息 */
+export interface CodexPairInfo {
+    /** 交易对地址 */
+    pairAddress: string;
+    /** 交易所/DEX 名称 */
+    exchangeName: string;
+    /** 流动性 (USD) */
+    liquidity: number;
+    /** token0 地址 */
+    token0Address: string;
+    /** token1 地址 */
+    token1Address: string;
+    /** 价格 (USD) */
+    priceUsd: number;
+    /** 24h 交易量 */
+    volume24h: number;
+    /** 24h 交易笔数 */
+    txnCount24h: number;
+    /** 创建时间 */
+    createdAt: number | null;
+}
+/** K线查询参数 */
+export interface GetBarsParams {
+    /** 代币合约地址 */
+    tokenAddress: string;
+    /** 交易对地址 (可选, 不传则使用顶部交易对) */
+    pairAddress?: string;
+    /** 时间粒度 */
+    resolution: '1' | '5' | '15' | '30' | '60' | '240' | '720' | '1D';
+    /** 开始时间 (Unix 秒) */
+    from: number;
+    /** 结束时间 (Unix 秒) */
+    to: number;
+    /** 向前回溯柱数 */
+    countback?: number;
+}
+export declare class CodexAdapter {
+    private client;
+    private maxRetries;
+    private priceCache;
+    private tokenInfoCache;
+    constructor(config?: Partial<CodexConfig>);
+    /**
+     * 带指数退避重试的 GraphQL 请求执行器
+     */
+    private executeQuery;
+    /** 判断错误是否可重试 */
+    private isRetryableError;
+    /** 获取缓存值 (未过期则返回数据, 否则返回 null) */
+    private getCached;
+    /** 设置缓存 */
+    private setCache;
+    /** 清除所有缓存 */
+    clearCache(): void;
+    /**
+     * 获取代币详细市场数据 (使用 filterTokens)
+     * 包含价格、流动性、市值、持有者、交易量等
+     */
+    getTokenMarketData(ca: string): Promise<CodexTokenMarketData>;
+    /**
+     * 获取代币基本信息 (精简版, 从 filterTokens 提取)
+     */
+    getTokenInfo(ca: string): Promise<CodexTokenInfo>;
+    /**
+     * 获取单个代币的实时价格 (USD)
+     */
+    getTokenPrice(ca: string): Promise<CodexTokenPrice>;
+    /**
+     * 批量获取代币价格
+     * Codex 限制每次最多 25 个输入
+     */
+    getTokenPrices(addresses: string[]): Promise<CodexTokenPrice[]>;
+    /**
+     * 获取 SOL 价格 (USD)
+     * 使用 Wrapped SOL 地址查询
+     */
+    getSolPrice(): Promise<number>;
+    /**
+     * 获取 K线 (OHLCV) 数据
+     *
+     * getBars 的 symbol 格式: tokenAddress:pairAddress (如无 pairAddress 则用默认交易对)
+     */
+    getBars(params: GetBarsParams): Promise<CodexBar[]>;
+    /**
+     * 查找代币的交易对列表 (按流动性降序排列)
+     */
+    getPairsForToken(ca: string, limit?: number): Promise<CodexPairInfo[]>;
+    /**
+     * 获取代币的顶部 (最高流动性) 交易对
+     */
+    getTopPair(ca: string): Promise<CodexPairInfo | null>;
+    /**
+     * 获取代币价格 (SOL 和 USD)
+     * 同时获取代币的 USD 价格和 SOL 价格
+     */
+    getTokenPriceInSolAndUsd(ca: string): Promise<{
+        priceSol: number;
+        priceUsd: number;
+    }>;
+    /**
+     * 获取池信息 (与 ARCH-DESIGN-v2.md PoolInfoFile 格式对齐)
+     * 综合 Codex 价格和交易对数据
+     */
+    getPoolInfo(ca: string): Promise<{
+        ca: string;
+        pairAddress: string;
+        dex: string;
+        liquidity: {
+            sol: number;
+            token: number;
+        };
+        priceSol: number;
+        priceUsd: number;
+        updatedAt: number;
+    }>;
+    /**
+     * 验证 Codex API Key 和连接是否可用
+     */
+    healthCheck(): Promise<{
+        healthy: boolean;
+        endpoint: string;
+        solPriceUsd?: number;
+        error?: string;
+    }>;
+}
+/**
+ * 获取 CodexAdapter 单例
+ * 首次调用时从 config 读取 Codex API Key 创建实例
+ */
+export declare function getCodexAdapter(): CodexAdapter;
+/**
+ * 重置单例 (配置变更后重新初始化)
+ */
+export declare function resetCodexAdapter(): void;
+export { SOLANA_NETWORK_ID, WRAPPED_SOL_MINT };
+//# sourceMappingURL=codex-adapter.d.ts.map

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

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