@clonegod/ttd-base-send-tx 0.1.1

package/src/transaction_sender.ts

@@ -0,0 +1,127 @@
+import { ITransactionSender, BaseEnvArgs } from '@clonegod/ttd-base-common'
+import { AppConfig, log_info, log_warn } from '@clonegod/ttd-core'
+import { BlockRazorChannel, BloxrouteChannel, DirectRpcChannel, SendChannel } from './channels'
+
+/** TradeTrace duck-type 接口（避免对 ttd-base-common 的 TradeTrace 实现强依赖） */
+interface TraceWriter {
+    mark(name: string): void
+}
+
+/**
+ * BASE 链 trader 端 TransactionSender
+ *
+ * ## 与 BSC 的差异
+ *
+ * BSC：3 builder bundle 并发（BlockRazor / 48Club / BLXR），主 tx + 3 tip tx 并行签名，bundle 投递
+ * BASE：无原生 bundle 通道；私有路由商（BlockRazor / bloXroute）走单笔 `eth_sendRawTransaction`
+ *
+ * ## 发送策略（fan-out 多端并发）
+ *
+ * 同一笔签名好的 raw tx 并发提交到所有启用的通道，先到的成功，
+ * 后到的同 nonce/同 signature 在 sequencer / mempool 端自然去重。
+ *
+ *   - `direct_rpc`：直发 BASE sequencer（endpoint = 通用 `RPC_ENDPOINT`，mainnet.base.org / 自家 endpoint，可启用 MEV Protection）
+ *   - `backup_rpc`：可选第二个 direct_rpc（`BACKUP_RPC_ENDPOINT`，不同 provider 做 RPC 故障冗余）
+ *   - `blockrazor`：BlockRazor BASE Fast（强制 tip，调用方需在 tx 中含 tip transfer 或抬高 priorityFee）
+ *   - `bloxroute`：bloXroute `blxr_tx`（可选 BackRunMe 回扣）
+ *
+ * ## ⚠️ BASE 上不存在 revert protection
+ *
+ * 失败的 tx **会**上链并扣 gas（跟 ETH 主网 Flashbots Protect 不同）。
+ * → 调用方必须先做链下模拟（eth_call / estimateGas），保证 tx 必成功才发
+ */
+export class TransactionSender implements ITransactionSender {
+    private channels: SendChannel[] = []
+    private timeoutMs: number
+
+    constructor(appConfig: AppConfig) {
+        const env = appConfig.env_args as BaseEnvArgs
+
+        if (env.send_tx_direct_rpc) {
+            this.channels.push(new DirectRpcChannel(env.rpc_endpoint || 'https://mainnet.base.org'))
+        }
+        if (env.send_tx_backup_rpc && env.backup_rpc_endpoint) {
+            this.channels.push(new DirectRpcChannel(env.backup_rpc_endpoint))
+        }
+        if (env.send_tx_blockrazor) {
+            if (!env.blockrazor_auth_token) {
+                log_warn('[TransactionSender] SEND_TX_BLOCKRAZOR=true 但 BLOCKRAZOR_AUTH_TOKEN 未配置，跳过 BlockRazor 通道')
+            } else {
+                this.channels.push(new BlockRazorChannel(env.blockrazor_endpoint, env.blockrazor_auth_token))
+            }
+        }
+        if (env.send_tx_bloxroute) {
+            if (!env.bloxroute_auth_token) {
+                log_warn('[TransactionSender] SEND_TX_BLOXROUTE=true 但 BLOXROUTE_AUTH_TOKEN 未配置，跳过 bloXroute 通道')
+            } else {
+                this.channels.push(new BloxrouteChannel({
+                    url: env.bloxroute_endpoint,
+                    authToken: env.bloxroute_auth_token,
+                    backrunmeRewardAddress: env.bloxroute_backrunme_address || undefined,
+                }))
+            }
+        }
+
+        this.timeoutMs = env.send_tx_timeout_ms || 3000
+
+        if (this.channels.length === 0) {
+            // 兜底：起码开主通道，避免空 sender 静默吞 tx
+            log_warn('[TransactionSender] 没有启用任何发送通道，回退到默认 direct_rpc')
+            this.channels.push(new DirectRpcChannel(env.rpc_endpoint || 'https://mainnet.base.org'))
+        }
+
+        log_info(`[TransactionSender] BASE 启动，通道=${this.channels.map(c => c.name).join(',')}, timeout=${this.timeoutMs}ms`)
+
+        // 预热所有通道（fire-and-forget，不阻塞构造）。建立 TCP+TLS 连接复用给后续 sendTransaction，
+        // 第一笔真实交易免握手。
+        for (const ch of this.channels) {
+            ch.warmup?.().catch(() => { /* warmup 失败已在通道内 log，此处吞掉 */ })
+        }
+    }
+
+    /**
+     * @param signedMainTx hex-encoded 主交易（无 tip 版本，发给非 tip 通道）
+     * @param channelTipTxMap channel name → 已签名 tx（同 nonce 的"含 tip"版本）
+     *                         举例：{ 'blockrazor' => withTipSignedTx }
+     *                         不在 map 中的 channel 收到 signedMainTx；在 map 中的 channel 收到对应 tx。
+     *                         Ethereum nonce 唯一性保证链上只有一笔执行，多通道并发安全。
+     * @param order_trace_id 订单追踪 id（日志用）
+     * @param pair 交易对名（日志用）
+     * @param _only_bundle BASE 忽略（无 bundle 概念）
+     * @param trace 可选 TradeTrace
+     */
+    async sendTransaction(
+        signedMainTx: string,
+        channelTipTxMap: Map<string, string>,
+        order_trace_id: string,
+        pair: string = '',
+        _only_bundle: boolean = false,
+        trace?: TraceWriter,
+    ): Promise<string[]> {
+        trace?.mark('send_start')
+
+        const sends = this.channels.map(ch => {
+            const tx = channelTipTxMap?.get(ch.name) ?? signedMainTx
+            return ch.send(tx, this.timeoutMs)
+        })
+        const results = await Promise.all(sends)
+
+        trace?.mark('send_done')
+
+        const ok = results.filter(r => !!r.txHash)
+        const fail = results.filter(r => !!r.error)
+
+        for (const r of ok) {
+            log_info(`[send] ✅ channel=${r.channel} trace=${order_trace_id} pair=${pair} ${r.elapsedMs}ms tx=${r.txHash}`)
+        }
+        for (const r of fail) {
+            log_warn(`[send] ❌ channel=${r.channel} trace=${order_trace_id} pair=${pair} ${r.elapsedMs}ms err=${r.error}`)
+        }
+
+        if (ok.length === 0) {
+            throw new Error(`所有 send 通道失败: ${fail.map(f => `${f.channel}=${f.error}`).join(' | ')}`)
+        }
+
+        return results.map(r => r.txHash ? `${r.channel}: ${r.txHash}` : `${r.channel}: ERR ${r.error}`)
+    }
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "es2020",
+    "module": "commonjs",
+    "lib": ["es2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": false,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "sourceMap": false
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}