@clonegod/ttd-sol-common 2.0.67 → 2.0.68

package/dist/utils/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./trade_direction"), exports);

package/dist/utils/trade_direction.d.ts

@@ -0,0 +1,14 @@
+export interface TradeDirectionResult<T = any> {
+    isBuy: boolean;
+    inputToken: T;
+    outputToken: T;
+    baseToken: T;
+    quoteToken: T;
+}
+export declare function resolveTradeDirection<T = any>(poolInfo: {
+    tokenA: T;
+    tokenB: T;
+    quote_token: string;
+    [key: string]: any;
+}, isBuy: boolean): TradeDirectionResult<T>;
+export declare function calculateStandardPrice(inputAmount: number, outputAmount: number, isBuy: boolean): string;

package/dist/utils/trade_direction.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTradeDirection = resolveTradeDirection;
+exports.calculateStandardPrice = calculateStandardPrice;
+function resolveTradeDirection(poolInfo, isBuy) {
+    const { tokenA, tokenB, quote_token } = poolInfo;
+    const quoteToken = [tokenA, tokenB].find(t => t.symbol === quote_token);
+    const baseToken = [tokenA, tokenB].find(t => t.symbol !== quote_token);
+    if (!quoteToken || !baseToken) {
+        throw new Error(`Cannot resolve tokens: tokenA=${tokenA?.symbol}, tokenB=${tokenB?.symbol}, quote_token=${quote_token}`);
+    }
+    const inputToken = isBuy ? quoteToken : baseToken;
+    const outputToken = isBuy ? baseToken : quoteToken;
+    return { isBuy, inputToken, outputToken, baseToken, quoteToken };
+}
+function calculateStandardPrice(inputAmount, outputAmount, isBuy) {
+    if (isBuy) {
+        return (inputAmount / outputAmount).toFixed(18);
+    }
+    else {
+        return (outputAmount / inputAmount).toFixed(18);
+    }
+}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@clonegod/ttd-sol-common",
-  "version": "2.0.67",
+  "version": "2.0.68",
   "description": "",
   "main": "dist/index.js",
-  "types": "types/index.d.ts",
+  "types": "dist/index.d.ts",
   "keywords": [],
   "author": "",
   "license": "ISC",
@@ -13,13 +13,13 @@
     "push": "npm run build && npm publish"
   },
   "dependencies": {
-    "@clonegod/ttd-core": "2.1.33",
+    "@clonegod/ttd-core": "3.1.84",
     "@solana/web3.js": "1.91.6",
     "rpc-websockets": "7.10.0",
     "axios": "^1.2.3",
     "bn.js": "^4.12.1",
     "bs58": "^6.0.0",
-    "helius-laserstream": "^0.2.7"
+    "helius-laserstream": "^0.4.0"
   },
   "devDependencies": {
     "@types/node": "^22.7.9",

package/src/appconfig/SolanaQuoteAppConfig.ts

@@ -0,0 +1,55 @@
+/**
+ * Solana 链通用 Quote 配置基类（对标 BSC 的 BscQuoteAppConfig）。
+ *
+ * 统一所有 DEX Quote 进程的配置初始化逻辑：
+ *  - ensureCoreEnv（即便入口忘记 import './appconfig' 也兜底）
+ *  - 初始化 arb_cache（super.init）+ arb_event_subscriber
+ *  - 建立 Solana Connection（所有 DEX 共用，commitment 可由 env 覆盖）
+ *  - env_args 收窄为 SolanaDexEnvArgs
+ *
+ * 池子加载 / 过滤不在这里做 —— 与 BSC 一致，放到各 DEX 的 entry(quote/index.ts)，
+ * 直接 arb_cache.get_pair_dex_pool_list([pair],[dex_id]) + filterPools。
+ */
+
+import { AppConfig, getArbEventSubscriber, getCoreEnv, log_info } from '@clonegod/ttd-core'
+import { Commitment, Connection } from '@solana/web3.js'
+import { COMMITMENT_LEVEL } from '../common/constants'
+import { SolanaDexEnvArgs } from './sol_dex_env_args'
+import { ensureCoreEnv } from './ensure_core_env'
+
+export class SolanaQuoteAppConfig extends AppConfig {
+    public env_args: SolanaDexEnvArgs
+    public connection: Connection
+
+    constructor() {
+        // super 前 ensure coreEnv（AppConfig.constructor 内部读 getCoreEnv()）
+        ensureCoreEnv()
+        super()
+        // AppConfig.constructor 已 this.env_args = getCoreEnv()；这里只做类型收窄
+        this.env_args = getCoreEnv() as SolanaDexEnvArgs
+    }
+
+    async init() {
+        // super.init() 初始化 arb_cache
+        await super.init()
+
+        // 确保 arb_event_subscriber 已就绪（池事件订阅依赖）
+        if (!this.arb_event_subscriber) {
+            this.arb_event_subscriber = getArbEventSubscriber(this.arb_cache)
+        }
+
+        // Solana 连接（所有 DEX quote 共用；commitment 默认 PROCESSED，可由 env 覆盖）
+        const commitment =
+            (process.env.CONNECTION_COMMITMENT_LEVEL as Commitment) || COMMITMENT_LEVEL.PROCESSED
+        this.connection = new Connection(this.env_args.rpc_endpoint, { commitment })
+
+        log_info('SolanaQuoteAppConfig initialized', {
+            chain_id: this.env_args.chain_id,
+            dex_id: this.env_args.dex_id,
+            pair: this.env_args.pair,
+            rpc_endpoint: this.env_args.rpc_endpoint,
+        })
+    }
+
+    // subscribe_config_change 不覆盖 —— 继承 AppConfig 基类版本
+}

package/src/appconfig/SolanaTradeAppConfig.ts

@@ -0,0 +1,117 @@
+/**
+ * Solana 链通用 Trade 配置基类（对标 BSC 的 BscTradeAppConfig，与 SolanaQuoteAppConfig 对称）。
+ *
+ * 统一所有 DEX Trade 进程：
+ *  - ensureCoreEnv + env_args 收窄为 SolanaDexEnvArgs
+ *  - 建立 Solana Connection（commitment 可由 env 覆盖）
+ *  - init_trade_runtime：create_trade_runtime + 从 wallet.private_key 还原 keypair（原本每个 DEX 各抄一份，现上提）
+ *  - subscribe_wallet_raw_txn_event：订阅 stream-trade 推送的链上 tx 结果
+ *
+ * 各 DEX 的 *TradeAppConfig 直接 `extends SolanaTradeAppConfig` 即可，通常无需再覆盖任何方法。
+ */
+
+import {
+    AbstractTradeAppConfig,
+    getCoreEnv,
+    LOCAL_EVENT_NAME,
+    log_error,
+    log_info,
+    sleep,
+    WebSocketClient,
+} from '@clonegod/ttd-core/dist'
+import { Commitment, Connection, Keypair } from '@solana/web3.js'
+import bs58 from 'bs58'
+import { COMMITMENT_LEVEL } from '../common/constants'
+import { SolanaDexEnvArgs } from './sol_dex_env_args'
+import { ensureCoreEnv } from './ensure_core_env'
+
+export class SolanaTradeAppConfig extends AbstractTradeAppConfig {
+    public env_args: SolanaDexEnvArgs
+    public connection: Connection
+    public keypair: Keypair
+
+    // WebSocket 客户端实例，用于订阅交易结果
+    private ws_client: WebSocketClient | null = null
+
+    constructor() {
+        ensureCoreEnv()
+        super()
+        this.env_args = getCoreEnv() as SolanaDexEnvArgs
+    }
+
+    async init() {
+        await super.init()
+
+        // Solana 连接（所有 DEX trade 共用；commitment 默认 PROCESSED）
+        const commitment =
+            (process.env.CONNECTION_COMMITMENT_LEVEL as Commitment) || COMMITMENT_LEVEL.PROCESSED
+        this.connection = new Connection(this.env_args.rpc_endpoint, { commitment })
+
+        this.subscribe_wallet_raw_txn_event()
+        log_info('SolanaTradeAppConfig init ...')
+    }
+
+    /**
+     * 初始化交易上下文 + 从 wallet.private_key 还原 keypair。
+     * （原本 byreal / meteora / orca / pumpswap / raydium / jupiter 各抄一份，现统一上提）
+     */
+    async init_trade_runtime() {
+        try {
+            const { chain_id, dex_id, group_id, pair } = this.env_args
+
+            this.trade_runtime = await this.arb_cache.create_trade_runtime(
+                chain_id,
+                group_id,
+                dex_id,
+                pair,
+            )
+            this.trade_runtime.wallet_token_accounts = new Map()
+
+            // 从 trade_runtime.wallet.private_key 还原 Solana keypair
+            const secret_key = new Uint8Array(bs58.decode(this.trade_runtime.wallet.private_key))
+            this.keypair = Keypair.fromSecretKey(secret_key)
+        } catch (err) {
+            log_error(`SolanaTradeAppConfig create_trade_runtime error!`, err)
+            await sleep(1000)
+            process.exit(0)
+        }
+    }
+
+    // 订阅 Wallet 在链上发生的 tx data（stream-trade 经 WS 推送）
+    subscribe_wallet_raw_txn_event(): void {
+        // 检查是否已经订阅
+        if (this.is_already_subscribe_wallet_raw_txn) {
+            if (this.ws_client && this.ws_client.isConnected()) {
+                return
+            } else {
+                // 连接已断开，需要重新连接
+                log_info('subscribe_wallet_raw_txn_event was subscribed but connection lost, reconnecting...')
+                if (this.ws_client) {
+                    this.ws_client.disconnect()
+                    this.ws_client = null
+                }
+            }
+        }
+        this.is_already_subscribe_wallet_raw_txn = true
+
+        const transactionHandler = async (messageStr: any) => {
+            let messageObj = messageStr
+            if (typeof messageStr === 'string') {
+                messageObj = JSON.parse(messageStr)
+            }
+
+            const tx_id = messageObj.transaction.signature
+            log_info(`Received transaction result via WebSocket: ${tx_id}`)
+
+            this.emit(LOCAL_EVENT_NAME.EVENT_WALLET_TRANSACTION + '#' + tx_id, messageObj)
+        }
+
+        const ws_port = process.env.STREAM_WS_TRADE_PORT || 10002
+        const ws_url = `ws://127.0.0.1:${ws_port}`
+        this.ws_client = new WebSocketClient(ws_url)
+        this.ws_client.onMessage(transactionHandler)
+        this.ws_client.connect()
+
+        log_info(`subscribe_wallet_raw_txn_event, WebSocket connecting to ${ws_url}`)
+    }
+}

package/src/appconfig/ensure_core_env.ts

@@ -0,0 +1,28 @@
+/**
+ * 通用 ensureCoreEnv：Solana AppConfig 子类构造器在 super() 之前调用，
+ * 确保 ttd-core 的 coreEnv 已被 setCoreEnv —— 即便入口忘记 import './appconfig'。
+ *
+ * 设计理由（同 BSC ensure_core_env）：
+ *   - AppConfig.constructor() 内部读 getCoreEnv()，没设置就抛错
+ *   - 入口必须 import './appconfig' 触发 setCoreEnv 是隐式约定，容易漏
+ *   - 此 helper 在 super 前补一刀；即便已设置（入口正常 import）也无副作用（短路返回）
+ *
+ * 限制：super() 之前不能访问 this，本 helper 只做无 this 的纯函数调用。
+ */
+
+import { getCoreEnv, setCoreEnv } from '@clonegod/ttd-core'
+import { SolanaDexEnvArgs } from './sol_dex_env_args'
+
+let _ensured = false
+
+export function ensureCoreEnv(): void {
+    if (_ensured) return
+    try {
+        getCoreEnv()  // 已设置则直接通过
+        _ensured = true
+    } catch {
+        // 未设置：兜底创建一个 Solana DEX 子类的 EnvArgs
+        setCoreEnv(new SolanaDexEnvArgs())
+        _ensured = true
+    }
+}

package/src/appconfig/index.ts

@@ -0,0 +1,5 @@
+export * from './sol_env_args'
+export * from './sol_dex_env_args'
+export * from './SolanaQuoteAppConfig'
+export * from './SolanaTradeAppConfig'
+export * from './ensure_core_env'

package/src/appconfig/sol_dex_env_args.ts

@@ -0,0 +1,52 @@
+import { DEX_ID, printEnvConfig } from '@clonegod/ttd-core/dist'
+import { SolanaEnvArgs } from './sol_env_args'
+
+/**
+ * Solana DEX 业务包共享的环境变量 cherry-pick 子类（对标 BSC 的 BscDexEnvArgs）。
+ * 供 byreal-clmm / meteora-* / orca-clmm / pumpswap-amm / raydium-* / jupiter-aggr 的
+ * quote + trade 进程使用。
+ *
+ * 每个 DEX 进程都是 Solana 链上 quote 或 trade 的执行者，需要的字段高度一致，
+ * 统一在这里 cherry-pick，避免每个包各写一份。
+ *
+ * 字段全部已在 ttd-core 的 CoreEnvArgs registry 注册（pair / group_id / dex_id /
+ * rpc_endpoint / quote_pool_* / wallet_dir 等），此处只做赋值（SSOT 在 registry）。
+ *
+ * 用法：模块 appconfig/index.ts 里 `export const envArgs = new SolanaDexEnvArgs(); envArgs.print('<dex>')`
+ */
+export class SolanaDexEnvArgs extends SolanaEnvArgs {
+    constructor() {
+        super()
+        const cfg = this._cfg
+
+        // ─── 进程身份（chain_id / app_name / redis_* 等基础设施已在 SolanaEnvArgs 父类 cherry-pick）───
+        this.dex_id = (cfg.dex_id || '').toString().toUpperCase() as DEX_ID  // DEX_ID
+
+        // ─── RPC / gRPC 接入 ───
+        this.rpc_endpoint  = cfg.rpc_endpoint                               // RPC_ENDPOINT
+        this.ws_endpoint   = cfg.ws_endpoint                                // WS_ENDPOINT
+        this.grpc_endpoint = cfg.grpc_endpoint                              // GRPC_ENDPOINT
+        this.grpc_token    = cfg.grpc_token                                 // GRPC_TOKEN
+
+        // ─── 进程绑定（quote / trade 共用）───
+        this.pair     = cfg.pair ?? ''                                     // PAIR
+        this.group_id = cfg.group_id ?? ''                                 // GROUP_ID（trade 必填，quote 可空）
+
+        // ─── Quote 过滤 ───
+        this.quote_pool_address  = cfg.quote_pool_address                  // QUOTE_POOL_ADDRESS
+        this.quote_pool_name     = cfg.quote_pool_name                     // QUOTE_POOL_NAME
+        this.quote_pool_fee_rate = cfg.quote_pool_fee_rate                 // QUOTE_POOL_FEE_RATE
+        this.quote_amount_usd    = cfg.quote_amount_usd                    // QUOTE_AMOUNT_USD
+
+        // ─── load_wallet / decrypt 依赖（trade 用）───
+        this.wallet_dir     = cfg.wallet_dir                               // WALLET_DIR
+        this.encryption_key = cfg.encryption_key ?? ''                     // ENCRYPTION_KEY
+
+        this.namespace = cfg.namespace ?? ''                              // NAMESPACE
+    }
+
+    /** 便捷：模块入口调用一次即完成打印（替代 constructor 里 printEnvConfig） */
+    print(moduleName?: string) {
+        printEnvConfig(moduleName || this.app_name || 'sol-dex', this)
+    }
+}

package/src/appconfig/sol_env_args.ts

@@ -0,0 +1,79 @@
+import { CHAIN_ID, EnvArgs, registerEnvVars } from '@clonegod/ttd-core'
+
+/**
+ * Solana 链专有环境变量注册中心 + 类型目录（对标 BSC 的 bsc_env_args.ts）。
+ *
+ * 约定（同 BSC）：
+ *   1. `registerEnvVars({...})` 是 SSOT —— env 名 / 类型 / 默认值 / 描述都在这里注册到 ttd-core 的 env_registry。
+ *   2. `SolanaEnvArgs extends EnvArgs` 只是**类型目录**（字段 TS 声明）+ 空构造器；
+ *      具体 `<Module>EnvArgs` 子类在自己的构造器里从 `this._cfg` cherry-pick 赋值。
+ *   3. 基础设施字段（app_name / chain_id / redis_* / config_center_host / rpc_endpoint /
+ *      token_price_refresh_interval_seconds / trade_analyze_host 等）已在 core 的 CoreEnvArgs 注册，**此处不重复**。
+ *
+ * ⚠️ 本阶段只注册 **market-data** 用到的字段。quote / trade / stream 各自的 env
+ *    在对应 phase 接入时补到这里（按使用方分组），不要提前堆。
+ */
+
+// Solana 原生币 = SOL；链上"wrapped SOL" mint（也是 quote/trade 的 native 锚）
+const WSOL_MINT = 'So11111111111111111111111111111111111111112'
+
+registerEnvVars({
+    // ══════════════════════════════════════════════════════
+    // market-data
+    // ══════════════════════════════════════════════════════
+    gecko_network:          { env: 'GECKO_NETWORK',          type: 'string',  default: 'solana', desc: 'GeckoTerminal 网络标识' },
+    chain_id_num:           { env: 'CHAIN_ID_NUM',           type: 'number',  default: 101, desc: 'Solana mainnet 链 ID 数字（SPL token list chainId）' },
+    native_token_symbol:    { env: 'NATIVE_TOKEN_SYMBOL',    type: 'string',  default: 'SOL', desc: '原生代币符号' },
+    native_token_address:   { env: 'NATIVE_TOKEN_ADDRESS',   type: 'string',  default: WSOL_MINT, desc: '原生代币地址（wrapped SOL mint）' },
+    wrapped_native_address: { env: 'WRAPPED_NATIVE_ADDRESS', type: 'string',  default: WSOL_MINT, desc: 'Wrapped SOL mint' },
+    sync_pool_interval_ms:  { env: 'SYNC_POOL_INTERVAL_MS',  type: 'number',  default: 900000, desc: '定时池子全量同步间隔（毫秒，默认 15 分钟）' },
+    fetch_api_wait_ms:      { env: 'FETCH_API_WAIT_MS',      type: 'number',  default: 1000, desc: '各 DEX/Gecko API 调用间隔（毫秒）' },
+    fetch_min_tvl:          { env: 'FETCH_MIN_TVL',          type: 'number',  default: 50000, desc: '最小 TVL(USD)' },
+    fetch_min_vol:          { env: 'FETCH_MIN_VOL',          type: 'number',  default: 50000, desc: '最小 24h 成交量(USD)' },
+    pool_default_tvl:       { env: 'POOL_DEFAULT_TVL',       type: 'number',  default: 100000, desc: '默认 TVL（无 API 数据来源的池子兜底，如 pumpswap）' },
+    fetch_max_page_no:      { env: 'FETCH_MAX_PAGE_NO',      type: 'number',  default: 10, desc: '最大翻页数' },
+    token_batch_size:       { env: 'TOKEN_BATCH_SIZE',       type: 'number',  default: 10, desc: 'token 批量查询大小' },
+    fetch_on_startup:       { env: 'FETCH_ON_STARTUP',       type: 'boolean', default: true, desc: '启动时立即执行一次全量同步' },
+})
+
+/**
+ * Solana 链级 EnvArgs 类型目录。
+ *
+ * 字段声明 = env_registry 注册项的镜像（供 TS 类型 + IDE 提示）。
+ * 空构造器：所有字段由各 <Module>EnvArgs 子类按需 cherry-pick 赋值（SSOT 在 registry）。
+ * trade_analyze_host / config_center_host / token_price_refresh_interval_seconds 等基础设施字段在 CoreEnvArgs 声明，此处不重复。
+ */
+export class SolanaEnvArgs extends EnvArgs {
+    // ─── market-data ───
+    gecko_network: string
+    chain_id_num: number
+    native_token_symbol: string
+    native_token_address: string
+    wrapped_native_address: string
+    sync_pool_interval_ms: number
+    fetch_api_wait_ms: number
+    fetch_min_tvl: number
+    fetch_min_vol: number
+    pool_default_tvl: number
+    fetch_max_page_no: number
+    token_batch_size: number
+    fetch_on_startup: boolean
+
+    constructor() {
+        super()
+        const cfg = this._cfg
+
+        // ─── 基础设施 cherry-pick（所有 sol 服务共享；对标 SuiEnvArgs）───
+        // 子类(<Module>EnvArgs)继承即得基础设施，无需重复 cherry-pick；模块专有字段(market-data 段)由各子类自行 pick。
+        this.app_name   = (cfg.app_name as string || '').toLowerCase()    // APP_NAME
+        this.chain_id   = (cfg.chain_id || CHAIN_ID.SOLANA).toString().toUpperCase() as CHAIN_ID // CHAIN_ID
+        this.server_id  = cfg.server_id ?? ''                             // SERVER_ID
+        this.redis_host = cfg.redis_host                                  // REDIS_HOST
+        this.redis_port = String(cfg.redis_port)                          // REDIS_PORT
+        this.server_ip_list    = cfg.server_ip_list ?? ''                 // SERVER_IP_LIST
+        this.ip_exclude_prefix = cfg.ip_exclude_prefix ?? ''              // IP_EXCLUDE_PREFIX
+        this.config_center_host = cfg.config_center_host                  // CONFIG_CENTER_HOST
+        this.token_price_refresh_interval_seconds = cfg.token_price_refresh_interval_seconds // TOKEN_PRICE_REFRESH_INTERVAL_SECONDS
+        this.trade_analyze_host = cfg.trade_analyze_host ?? ''            // TRADE_ANALYZE_HOST
+    }
+}

package/src/common/get_wallet_token_account.ts

@@ -17,7 +17,7 @@ export const get_token_program_id = (token: StandardTokenInfoType) => {
 const wallet_token_accounts_cache = new Map<string, string>()
 
 function getWalletTokenAccountCacheKey(wallet_pubkey: string, token_address: string): string {
-    return `${wallet_pubkey}_${token_address}}`
+    return `${wallet_pubkey}_${token_address}`
 }
 
 function getCachedAtaAddress(
@@ -68,61 +68,55 @@ export function get_wallet_token_account(wallet_pubkey:string, pool_list:Standar
  * 创建Token Account
  */
 export const create_token_account_if_not_exist = async (connection:Connection, owner:Keypair, token_list: StandardTokenInfoType[]) => {
-    token_list.forEach(async token => {
+    // 用 Promise.all + await：trader 启动时必须等账户全部就绪（且错误能浮现）再开始交易，
+    // 旧 forEach(async) 是 fire-and-forget，会在账户没建好时就放行下单。
+    await Promise.all(token_list.map(async token => {
         if(['SOL','WSOL','USDC','USDT'].includes(token.symbol?.toUpperCase())) {
             return
         }
-        
+
         try {
             const mint = new PublicKey(token.address)
-            // calculate ATA
-            let ata = await getAssociatedTokenAddress(new PublicKey(mint), owner.publicKey)
+            // 按 token program 派生 ATA（Token-2022 与 SPL 的 ATA 地址不同！）。
+            // 旧代码存在性检查用的 getAssociatedTokenAddress 没传 program → 对 Token-2022 算的是 SPL ATA，
+            // 与实际创建/存币的 Token-2022 ATA 不是同一地址 → 检查永远 miss。这里统一用 token program 派生。
+            const programId = get_token_program_id(token)
+            let ata = await getAssociatedTokenAddress(mint, owner.publicKey, false, programId)
             const account_data = await connection.getAccountInfo(ata)
             if(account_data) {
                 log_info(`token account already exist, skip!`, {
                     owner: owner.publicKey.toBase58(),
                     token,
-                    ata: ata.toBase58()
+                    ata: ata.toBase58(),
+                    program: programId.toBase58(),
                 });
             } else {
                 log_info(`token account not exist, create new one!`, {
                     owner: owner.publicKey.toBase58(),
                     token,
+                    program: programId.toBase58(),
                 });
-                if(token.is_token2022) {
-                    ata = await createAssociatedTokenAccountIdempotent(
-                        connection,
-                        owner,
-                        mint,
-                        owner.publicKey,
-                        {
-                            commitment: COMMITMENT_LEVEL.CONFIRMED,
-                        },
-                        TOKEN_2022_PROGRAM_ID,
-                        ASSOCIATED_TOKEN_PROGRAM_ID
-                    )
-                } else {
-                    ata = await createAssociatedTokenAccountIdempotent(
-                        connection,
-                        owner,
-                        mint,
-                        owner.publicKey,
-                        {
-                            commitment: COMMITMENT_LEVEL.CONFIRMED,
-                        },
-                        TOKEN_PROGRAM_ID,
-                        ASSOCIATED_TOKEN_PROGRAM_ID
-                    )
-                }
+                ata = await createAssociatedTokenAccountIdempotent(
+                    connection,
+                    owner,
+                    mint,
+                    owner.publicKey,
+                    {
+                        commitment: COMMITMENT_LEVEL.CONFIRMED,
+                    },
+                    programId,
+                    ASSOCIATED_TOKEN_PROGRAM_ID
+                )
                 log_info(`Create New Token Account`, {
                     owner: owner.publicKey.toBase58(),
                     token,
-                    ata: ata.toBase58()
+                    ata: ata.toBase58(),
+                    program: programId.toBase58(),
                 });
             }
         } catch (err) {
             log_error(`create_token_account_if_not_exist error!`, err)
         }
-    })
+    }))
 }
 

package/src/grpc/grpc_provider_registry.ts

@@ -0,0 +1,103 @@
+import { log_info, log_warn } from '@clonegod/ttd-core/dist'
+
+/**
+ * gRPC Provider 注册表（消费侧）—— 从 Redis `${chain}:rpc:providers` 解析 type='grpc' 的端点。
+ * 镜像 SUI ttd-sui-common/grpc/grpc_provider_registry.ts，跨链一致。
+ *
+ * 生产端：config-center RPC Provider CRUD（trade-analyze Config/RPC 页）。
+ *   record JSON：{ id, grpc_endpoint, auth_token?, enabled, type, default_for_quote?, ... }
+ *   Solana 约定：grpc_endpoint 存 Helius **laserstream URL**（如 https://laserstream-mainnet-tyo.helius-rpc.com），
+ *   auth_token 存 Helius **API key**。（SUI 那边 grpc_endpoint 是 host:port，链相关差异）
+ *
+ * 选取规则：enabled && type==='grpc'，default_for_quote 优先，其余按 id 字典序取第一个。
+ * 无可用 provider 直接 throw（fail-loud）—— laserstream 端点是唯一数据源，不允许静默缺配。
+ *
+ * 热切换：watchGrpcProviderChange 订阅 `${chain}:rpc:config:change`，解析结果与当前生效值不同时回调
+ * （stream 服务策略：log + process.exit 交 pm2 带新配置拉起）。
+ */
+
+export interface GrpcProviderConfig {
+    id: string
+    endpoint: string
+    token: string
+}
+
+export function getRpcProvidersKey(chainId: string): string {
+    return `${chainId.toLowerCase()}:rpc:providers`
+}
+
+export function getRpcConfigChangeChannel(chainId: string): string {
+    return `${chainId.toLowerCase()}:rpc:config:change`
+}
+
+/** 只依赖用到的 redis 能力，避免耦合具体 client 类型 */
+interface RedisLike {
+    hgetall(key: string): Promise<Record<string, string> | null>
+    subscribe(channel: string, listener: (message: string) => void): Promise<void> | void
+}
+
+export async function resolveGrpcProvider(redis: RedisLike, chainId: string, preferId?: string): Promise<GrpcProviderConfig> {
+    const key = getRpcProvidersKey(chainId)
+    const map = (await redis.hgetall(key)) || {}
+    const candidates: Array<{ id: string; grpc_endpoint: string; auth_token?: string; default_for_quote?: boolean }> = []
+    for (const [id, json] of Object.entries(map)) {
+        try {
+            const p = JSON.parse(json)
+            if (p.enabled === true && p.type === 'grpc' && p.grpc_endpoint) candidates.push({ ...p, id })
+        } catch {
+            log_warn(`[grpc-registry] ${key} 字段 ${id} JSON 非法，跳过`)
+        }
+    }
+    if (candidates.length === 0) {
+        throw new Error(
+            `[grpc-registry] ${key} 无 enabled 的 grpc provider —— 请在 trade-analyze Config/RPC 页新增 type=grpc 的 Provider（Solana: grpc_endpoint 填 Helius laserstream URL，auth_token 填 API key）`,
+        )
+    }
+    if (preferId) {
+        const preferred = candidates.find(c => c.id === preferId)
+        if (!preferred) {
+            throw new Error(`[grpc-registry] 指定的 grpc provider '${preferId}' 不存在或未 enabled（${key} 可用: ${candidates.map(c => c.id).join(',')}）`)
+        }
+        if (!preferred.auth_token) log_warn(`[grpc-registry] provider ${preferred.id} auth_token 为空，按无鉴权端点连接`)
+        log_info(`[grpc-registry] 使用指定 provider: ${preferred.id}`)
+        return { id: preferred.id, endpoint: preferred.grpc_endpoint, token: preferred.auth_token || '' }
+    }
+    candidates.sort((a, b) =>
+        (b.default_for_quote === true ? 1 : 0) - (a.default_for_quote === true ? 1 : 0)
+        || a.id.localeCompare(b.id))
+    const picked = candidates[0]
+    if (candidates.length > 1) {
+        log_warn(`[grpc-registry] ${candidates.length} 个 grpc provider 可用，选用 ${picked.id}（default_for_quote 优先）`)
+    }
+    if (!picked.auth_token) {
+        log_warn(`[grpc-registry] provider ${picked.id} auth_token 为空，按无鉴权端点连接`)
+    }
+    return { id: picked.id, endpoint: picked.grpc_endpoint, token: picked.auth_token || '' }
+}
+
+/**
+ * 订阅 provider 变更，端点配置实际变化时回调。解析失败（如最后一个 grpc provider 被禁用）回调收 null。
+ */
+export function watchGrpcProviderChange(
+    redis: RedisLike,
+    chainId: string,
+    active: GrpcProviderConfig,
+    onChange: (next: GrpcProviderConfig | null) => void,
+    preferId?: string,
+): void {
+    const channel = getRpcConfigChangeChannel(chainId)
+    redis.subscribe(channel, (message: string) => {
+        void (async () => {
+            let next: GrpcProviderConfig | null
+            try {
+                next = await resolveGrpcProvider(redis, chainId, preferId)
+            } catch {
+                next = null
+            }
+            const same = next && next.id === active.id && next.endpoint === active.endpoint && next.token === active.token
+            if (same) return
+            log_info(`[grpc-registry] provider 配置变化: ${message} → ${next ? `${next.id} ${next.endpoint}` : '<无可用>'}`)
+            onChange(next)
+        })()
+    })
+}

package/src/grpc/index.ts

@@ -0,0 +1 @@
+export * from './grpc_provider_registry'

package/src/index.ts

@@ -1,5 +1,8 @@
+export * from './appconfig'
+export * from './grpc'
 export * from './types'
 export * from './common'
 export * from './quote'
 export * from './trade'
+export * from './utils'