@clonegod/ttd-base-send-tx 0.1.1

package/dist/channels/blockrazor.d.ts

@@ -0,0 +1,37 @@
+/**
+ * BlockRazor BASE Fast 通道
+ *
+ * - 文档：https://blockrazor.gitbook.io/blockrazor/tc/transaction-submission/fast/base
+ * - 协议：HTTP POST `eth_sendRawTransaction`（标准 JSON-RPC），与 direct_rpc 同形态
+ * - 认证：`Authorization: Bearer <token>` header
+ * - Endpoint：`http://base-fast.blockrazor.io`（默认）
+ * - 路由：私有 mempool + Speed Boost 转发给 sequencer
+ *
+ * ## 强制 tip 要求
+ *
+ * BlockRazor BASE Fast **强制**每笔 tx 给 tip：
+ *   方式 A：tx 内含 transfer ≥ 0.000003 ETH 到 `0x9D70AC39166ca154307a93fa6b595CF7962fe8e5`
+ *   方式 B：`maxPriorityFeePerGas` ≥ 估算成本的 5%
+ *
+ * **本通道只负责转发已签名 raw tx**。调用方（trade encode 侧）必须事先满足
+ * tip 要求，否则 BlockRazor 会 reject。
+ *
+ * ## TPS 限制
+ *
+ * - 默认 10 TPS（不分套餐）；联系 BlockRazor 升级。
+ */
+import { SendChannel, SendChannelResult } from './types';
+export declare class BlockRazorChannel implements SendChannel {
+    private url;
+    readonly name = "blockrazor";
+    private pool;
+    private origin;
+    private path;
+    private authHeader;
+    private pingTimer?;
+    constructor(url: string, authToken: string);
+    warmup(timeoutMs?: number): Promise<void>;
+    send(signedTx: string, timeoutMs: number): Promise<SendChannelResult>;
+    private rpcCall;
+    close(): Promise<void>;
+}

package/dist/channels/blockrazor.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * BlockRazor BASE Fast 通道
+ *
+ * - 文档：https://blockrazor.gitbook.io/blockrazor/tc/transaction-submission/fast/base
+ * - 协议：HTTP POST `eth_sendRawTransaction`（标准 JSON-RPC），与 direct_rpc 同形态
+ * - 认证：`Authorization: Bearer <token>` header
+ * - Endpoint：`http://base-fast.blockrazor.io`（默认）
+ * - 路由：私有 mempool + Speed Boost 转发给 sequencer
+ *
+ * ## 强制 tip 要求
+ *
+ * BlockRazor BASE Fast **强制**每笔 tx 给 tip：
+ *   方式 A：tx 内含 transfer ≥ 0.000003 ETH 到 `0x9D70AC39166ca154307a93fa6b595CF7962fe8e5`
+ *   方式 B：`maxPriorityFeePerGas` ≥ 估算成本的 5%
+ *
+ * **本通道只负责转发已签名 raw tx**。调用方（trade encode 侧）必须事先满足
+ * tip 要求，否则 BlockRazor 会 reject。
+ *
+ * ## TPS 限制
+ *
+ * - 默认 10 TPS（不分套餐）；联系 BlockRazor 升级。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockRazorChannel = void 0;
+const ttd_core_1 = require("@clonegod/ttd-core");
+const undici_1 = require("undici");
+const PING_INTERVAL_MS = 30000;
+class BlockRazorChannel {
+    constructor(url, authToken) {
+        this.url = url;
+        this.name = 'blockrazor';
+        if (!authToken) {
+            throw new Error('[BlockRazorChannel] authToken is required');
+        }
+        const u = new URL(url);
+        this.origin = `${u.protocol}//${u.host}`;
+        this.path = `${u.pathname}${u.search}` || '/';
+        this.authHeader = `Bearer ${authToken}`;
+        this.pool = new undici_1.Pool(this.origin, {
+            connections: 4,
+            pipelining: 1,
+            keepAliveTimeout: 10 * 60000,
+            keepAliveMaxTimeout: 10 * 60000,
+            headersTimeout: 5000,
+            bodyTimeout: 5000,
+        });
+    }
+    async warmup(timeoutMs = 5000) {
+        const t0 = Date.now();
+        try {
+            const json = await this.rpcCall('eth_chainId', [], timeoutMs);
+            if (json?.result) {
+                (0, ttd_core_1.log_info)(`[${this.name}] warmup OK ${this.url} chainId=${json.result} ${Date.now() - t0}ms`);
+            }
+            else {
+                (0, ttd_core_1.log_warn)(`[${this.name}] warmup soft-fail ${this.url} ${Date.now() - t0}ms err=${json?.error?.message || 'no result'}`);
+            }
+        }
+        catch (e) {
+            (0, ttd_core_1.log_warn)(`[${this.name}] warmup err ${this.url} ${Date.now() - t0}ms: ${e?.message || e}`);
+        }
+        if (!this.pingTimer) {
+            this.pingTimer = setInterval(() => {
+                this.rpcCall('eth_chainId', [], 3000).catch(() => { });
+            }, PING_INTERVAL_MS);
+            this.pingTimer.unref?.();
+        }
+    }
+    async send(signedTx, timeoutMs) {
+        const t0 = Date.now();
+        try {
+            const json = await this.rpcCall('eth_sendRawTransaction', [signedTx], timeoutMs);
+            if (json?.error) {
+                return { channel: this.name, elapsedMs: Date.now() - t0, error: `RPC: ${json.error.message}` };
+            }
+            return { channel: this.name, elapsedMs: Date.now() - t0, txHash: json?.result };
+        }
+        catch (e) {
+            const msg = e?.name === 'AbortError' || e?.message?.includes('aborted') ? `timeout(${timeoutMs}ms)` : (e?.message || String(e));
+            (0, ttd_core_1.log_warn)(`[${this.name}] send error: ${msg}`);
+            return { channel: this.name, elapsedMs: Date.now() - t0, error: msg };
+        }
+    }
+    async rpcCall(method, params, timeoutMs) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const { statusCode, body } = await this.pool.request({
+                method: 'POST',
+                path: this.path,
+                headers: {
+                    'content-type': 'application/json',
+                    'authorization': this.authHeader,
+                },
+                body: JSON.stringify({ jsonrpc: '2.0', id: 1, method, params }),
+                signal: controller.signal,
+            });
+            if (statusCode < 200 || statusCode >= 300) {
+                try {
+                    await body.text();
+                }
+                catch { /* ignore */ }
+                throw new Error(`HTTP ${statusCode}`);
+            }
+            const text = await body.text();
+            return JSON.parse(text);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async close() {
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = undefined;
+        }
+        await this.pool.close();
+    }
+}
+exports.BlockRazorChannel = BlockRazorChannel;

package/dist/channels/bloxroute.d.ts

@@ -0,0 +1,53 @@
+/**
+ * bloXroute BASE 通道
+ *
+ * - 文档：https://docs.bloxroute.com/base/submit-transactions/submit-transactions
+ * - Speed Boost：https://docs.bloxroute.com/base/submit-transactions/speed-boost
+ * - 协议：HTTP POST `blxr_tx`（**非** eth_sendRawTransaction，是 bloXroute 私有方法）
+ * - 认证：`Authorization: <token>`（注意**无** Bearer 前缀）
+ * - Endpoint：`https://api.blxrbdn.com`
+ *
+ * ## 参数差异（vs 标准 JSON-RPC）
+ *
+ * - `transaction`: raw transactions bytes，**without `0x` prefix**
+ * - `blockchain_network`: 必须 `Base-Mainnet`
+ * - `backrunme_reward_address`: 可选——开启时自动注册 BackRunMe，回扣 MEV 利润到此地址
+ *
+ * ## 与 BlockRazor 的不同
+ *
+ * - **无强制 tip**：不需要 caller 在 tx 内含 transfer 或抬高 priorityFee
+ * - Speed Boost 需另购（通过 portal）；标准提交已经走私有路由
+ *
+ * ## 本通道做什么
+ *
+ * - 接收已签名 raw tx（带 0x 前缀），自动去前缀适配 bloXroute 协议
+ * - 注入 `blockchain_network = Base-Mainnet`
+ * - 可选注入 `backrunme_reward_address`
+ */
+import { SendChannel, SendChannelResult } from './types';
+export interface BloxrouteChannelOptions {
+    /** 完整 url，例如 https://api.blxrbdn.com */
+    url: string;
+    /** Authorization header 完整值（bloXroute 不带 Bearer 前缀） */
+    authToken: string;
+    /** 可选：BackRunMe 回扣收款地址（开启回扣服务时填） */
+    backrunmeRewardAddress?: string;
+}
+export declare class BloxrouteChannel implements SendChannel {
+    readonly name = "bloxroute";
+    private pool;
+    private origin;
+    private path;
+    private authHeader;
+    private backrunmeRewardAddress?;
+    private pingTimer?;
+    constructor(opts: BloxrouteChannelOptions);
+    /**
+     * bloXroute 没有 `eth_chainId` 这种标准 ping。
+     * 这里只建 TCP+TLS（请求一个肯定返回的 404/method-not-found，仍能让连接进入复用池）。
+     */
+    warmup(timeoutMs?: number): Promise<void>;
+    send(signedTx: string, timeoutMs: number): Promise<SendChannelResult>;
+    private postRaw;
+    close(): Promise<void>;
+}

package/dist/channels/bloxroute.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * bloXroute BASE 通道
+ *
+ * - 文档：https://docs.bloxroute.com/base/submit-transactions/submit-transactions
+ * - Speed Boost：https://docs.bloxroute.com/base/submit-transactions/speed-boost
+ * - 协议：HTTP POST `blxr_tx`（**非** eth_sendRawTransaction，是 bloXroute 私有方法）
+ * - 认证：`Authorization: <token>`（注意**无** Bearer 前缀）
+ * - Endpoint：`https://api.blxrbdn.com`
+ *
+ * ## 参数差异（vs 标准 JSON-RPC）
+ *
+ * - `transaction`: raw transactions bytes，**without `0x` prefix**
+ * - `blockchain_network`: 必须 `Base-Mainnet`
+ * - `backrunme_reward_address`: 可选——开启时自动注册 BackRunMe，回扣 MEV 利润到此地址
+ *
+ * ## 与 BlockRazor 的不同
+ *
+ * - **无强制 tip**：不需要 caller 在 tx 内含 transfer 或抬高 priorityFee
+ * - Speed Boost 需另购（通过 portal）；标准提交已经走私有路由
+ *
+ * ## 本通道做什么
+ *
+ * - 接收已签名 raw tx（带 0x 前缀），自动去前缀适配 bloXroute 协议
+ * - 注入 `blockchain_network = Base-Mainnet`
+ * - 可选注入 `backrunme_reward_address`
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BloxrouteChannel = void 0;
+const ttd_core_1 = require("@clonegod/ttd-core");
+const undici_1 = require("undici");
+const PING_INTERVAL_MS = 30000;
+class BloxrouteChannel {
+    constructor(opts) {
+        this.name = 'bloxroute';
+        if (!opts.authToken) {
+            throw new Error('[BloxrouteChannel] authToken is required');
+        }
+        const u = new URL(opts.url);
+        this.origin = `${u.protocol}//${u.host}`;
+        this.path = `${u.pathname}${u.search}` || '/';
+        this.authHeader = opts.authToken;
+        this.backrunmeRewardAddress = opts.backrunmeRewardAddress || undefined;
+        this.pool = new undici_1.Pool(this.origin, {
+            connections: 4,
+            pipelining: 1,
+            keepAliveTimeout: 10 * 60000,
+            keepAliveMaxTimeout: 10 * 60000,
+            headersTimeout: 5000,
+            bodyTimeout: 5000,
+        });
+    }
+    /**
+     * bloXroute 没有 `eth_chainId` 这种标准 ping。
+     * 这里只建 TCP+TLS（请求一个肯定返回的 404/method-not-found，仍能让连接进入复用池）。
+     */
+    async warmup(timeoutMs = 5000) {
+        const t0 = Date.now();
+        try {
+            await this.postRaw('{"jsonrpc":"2.0","id":1,"method":"ping","params":[]}', timeoutMs);
+            (0, ttd_core_1.log_info)(`[${this.name}] warmup OK ${this.origin} ${Date.now() - t0}ms`);
+        }
+        catch (e) {
+            (0, ttd_core_1.log_warn)(`[${this.name}] warmup err ${this.origin} ${Date.now() - t0}ms: ${e?.message || e}`);
+        }
+        if (!this.pingTimer) {
+            this.pingTimer = setInterval(() => {
+                this.postRaw('{"jsonrpc":"2.0","id":1,"method":"ping","params":[]}', 3000)
+                    .catch(() => { });
+            }, PING_INTERVAL_MS);
+            this.pingTimer.unref?.();
+        }
+    }
+    async send(signedTx, timeoutMs) {
+        const t0 = Date.now();
+        // bloXroute 要求 raw tx **去掉 0x 前缀**
+        const rawTx = signedTx.startsWith('0x') ? signedTx.slice(2) : signedTx;
+        const params = {
+            transaction: rawTx,
+            blockchain_network: 'Base-Mainnet',
+        };
+        if (this.backrunmeRewardAddress) {
+            params.backrunme_reward_address = this.backrunmeRewardAddress;
+        }
+        try {
+            const body = JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'blxr_tx', params });
+            const text = await this.postRaw(body, timeoutMs);
+            const json = JSON.parse(text);
+            if (json.error) {
+                return { channel: this.name, elapsedMs: Date.now() - t0, error: `RPC: ${json.error.message}` };
+            }
+            const hash = json.result?.txHash;
+            const normalized = hash && !hash.startsWith('0x') ? `0x${hash}` : hash;
+            return { channel: this.name, elapsedMs: Date.now() - t0, txHash: normalized };
+        }
+        catch (e) {
+            const msg = e?.name === 'AbortError' || e?.message?.includes('aborted') ? `timeout(${timeoutMs}ms)` : (e?.message || String(e));
+            (0, ttd_core_1.log_warn)(`[${this.name}] send error: ${msg}`);
+            return { channel: this.name, elapsedMs: Date.now() - t0, error: msg };
+        }
+    }
+    async postRaw(body, timeoutMs) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const { statusCode, body: respBody } = await this.pool.request({
+                method: 'POST',
+                path: this.path,
+                headers: {
+                    'content-type': 'application/json',
+                    'authorization': this.authHeader,
+                },
+                body,
+                signal: controller.signal,
+            });
+            const text = await respBody.text();
+            if (statusCode < 200 || statusCode >= 300) {
+                throw new Error(`HTTP ${statusCode}: ${text.slice(0, 200)}`);
+            }
+            return text;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async close() {
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = undefined;
+        }
+        await this.pool.close();
+    }
+}
+exports.BloxrouteChannel = BloxrouteChannel;

package/dist/channels/direct_rpc.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 直发 sequencer RPC 通道（BASE 主路径）
+ *
+ * - HTTP POST eth_sendRawTransaction 到 BASE sequencer
+ * - 默认 https://mainnet.base.org（Coinbase 官方）
+ * - 生产建议换 Alchemy / QuickNode 的 private endpoint：跟 sequencer 有专线，延迟更低
+ *
+ * ## BASE 上为什么不需要"MEV 保护通道"
+ *
+ * BASE 是单 sequencer rollup（Coinbase 运维），具备 ETH 主网用 Flashbots Protect 想达到的特性：
+ *   1. **无公开 mempool**：sequencer 接收到的 tx 不广播给公网
+ *   2. **无 builder 竞价**：没有第三方 builder 看你的 tx，没有 PBS 拍卖
+ *   3. **Flashblocks 排序锁定**：tx 一旦进入 Flashblock 就不能被高 fee tx 越过
+ *
+ * Flashbots Protect 当前**不支持 BASE**（只支持 ETH 主网 + Sepolia），且事实上也不需要。
+ * 直发 sequencer 已经是 BASE 上的"最优策略"——速度即护身符。
+ *
+ * ## 延迟优化（vs Node 全局 fetch）
+ *
+ * 用持久化 undici Pool 替代全局 fetch，单独控制：
+ *   1. **keepAliveTimeout=10min**：服务端单方面断连前一直保活，arb 低谷期不掉
+ *   2. **keepAliveMaxTimeout=10min**：极限保活上限
+ *   3. **pipelining=1**：避免请求重排序导致的 nonce 抢跑
+ *   4. **connections=4**：单 host 4 个并发连接（足够 arb 突发）
+ *   5. **periodic ping**：每 30s 发 eth_chainId，强制走"已建立"连接防服务端 idle 断
+ *
+ * 累计收益：消除 ~100-300ms 冷启动 + arb 低谷期回弹的一致性问题。
+ *
+ * ## 注意事项
+ *
+ * - **无 revert protection**：失败的 tx 会上链扣 gas → 业务必须先做链下模拟
+ */
+import { SendChannel, SendChannelResult } from './types';
+export declare class DirectRpcChannel implements SendChannel {
+    private url;
+    readonly name = "direct_rpc";
+    private pool;
+    private origin;
+    private path;
+    private pingTimer?;
+    constructor(url: string);
+    /**
+     * 启动期预热 + 启动后台 ping。
+     * 预热建立 TCP+TLS，让第一笔真实交易免握手；
+     * 后台 ping 每 30s 走一次连接防服务端 idle 断。
+     */
+    warmup(timeoutMs?: number): Promise<void>;
+    send(signedTx: string, timeoutMs: number): Promise<SendChannelResult>;
+    private rpcCall;
+    /** 测试/优雅停机用：销毁连接池 + 停 ping */
+    close(): Promise<void>;
+}

package/dist/channels/direct_rpc.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * 直发 sequencer RPC 通道（BASE 主路径）
+ *
+ * - HTTP POST eth_sendRawTransaction 到 BASE sequencer
+ * - 默认 https://mainnet.base.org（Coinbase 官方）
+ * - 生产建议换 Alchemy / QuickNode 的 private endpoint：跟 sequencer 有专线，延迟更低
+ *
+ * ## BASE 上为什么不需要"MEV 保护通道"
+ *
+ * BASE 是单 sequencer rollup（Coinbase 运维），具备 ETH 主网用 Flashbots Protect 想达到的特性：
+ *   1. **无公开 mempool**：sequencer 接收到的 tx 不广播给公网
+ *   2. **无 builder 竞价**：没有第三方 builder 看你的 tx，没有 PBS 拍卖
+ *   3. **Flashblocks 排序锁定**：tx 一旦进入 Flashblock 就不能被高 fee tx 越过
+ *
+ * Flashbots Protect 当前**不支持 BASE**（只支持 ETH 主网 + Sepolia），且事实上也不需要。
+ * 直发 sequencer 已经是 BASE 上的"最优策略"——速度即护身符。
+ *
+ * ## 延迟优化（vs Node 全局 fetch）
+ *
+ * 用持久化 undici Pool 替代全局 fetch，单独控制：
+ *   1. **keepAliveTimeout=10min**：服务端单方面断连前一直保活，arb 低谷期不掉
+ *   2. **keepAliveMaxTimeout=10min**：极限保活上限
+ *   3. **pipelining=1**：避免请求重排序导致的 nonce 抢跑
+ *   4. **connections=4**：单 host 4 个并发连接（足够 arb 突发）
+ *   5. **periodic ping**：每 30s 发 eth_chainId，强制走"已建立"连接防服务端 idle 断
+ *
+ * 累计收益：消除 ~100-300ms 冷启动 + arb 低谷期回弹的一致性问题。
+ *
+ * ## 注意事项
+ *
+ * - **无 revert protection**：失败的 tx 会上链扣 gas → 业务必须先做链下模拟
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DirectRpcChannel = void 0;
+const ttd_core_1 = require("@clonegod/ttd-core");
+const undici_1 = require("undici");
+const PING_INTERVAL_MS = 30000;
+class DirectRpcChannel {
+    constructor(url) {
+        this.url = url;
+        this.name = 'direct_rpc';
+        const u = new URL(url);
+        this.origin = `${u.protocol}//${u.host}`;
+        this.path = `${u.pathname}${u.search}` || '/';
+        // 持久化 undici Pool：keep-alive 极长，确保 idle 期间不断
+        this.pool = new undici_1.Pool(this.origin, {
+            connections: 4,
+            pipelining: 1,
+            keepAliveTimeout: 10 * 60000, // 10 分钟
+            keepAliveMaxTimeout: 10 * 60000,
+            headersTimeout: 5000,
+            bodyTimeout: 5000,
+        });
+    }
+    /**
+     * 启动期预热 + 启动后台 ping。
+     * 预热建立 TCP+TLS，让第一笔真实交易免握手；
+     * 后台 ping 每 30s 走一次连接防服务端 idle 断。
+     */
+    async warmup(timeoutMs = 5000) {
+        const t0 = Date.now();
+        try {
+            const json = await this.rpcCall('eth_chainId', [], timeoutMs);
+            if (json?.result) {
+                (0, ttd_core_1.log_info)(`[${this.name}] warmup OK ${this.url} chainId=${json.result} ${Date.now() - t0}ms`);
+            }
+            else {
+                (0, ttd_core_1.log_warn)(`[${this.name}] warmup soft-fail ${this.url} ${Date.now() - t0}ms err=${json?.error?.message || 'no result'}`);
+            }
+        }
+        catch (e) {
+            (0, ttd_core_1.log_warn)(`[${this.name}] warmup err ${this.url} ${Date.now() - t0}ms: ${e?.message || e}`);
+        }
+        // 启动后台 ping（fire-and-forget，进程退出时随之回收）
+        if (!this.pingTimer) {
+            this.pingTimer = setInterval(() => {
+                this.rpcCall('eth_chainId', [], 3000).catch(() => { });
+            }, PING_INTERVAL_MS);
+            this.pingTimer.unref?.();
+        }
+    }
+    async send(signedTx, timeoutMs) {
+        const t0 = Date.now();
+        try {
+            const json = await this.rpcCall('eth_sendRawTransaction', [signedTx], timeoutMs);
+            if (json?.error) {
+                return { channel: this.name, elapsedMs: Date.now() - t0, error: `RPC: ${json.error.message}` };
+            }
+            return { channel: this.name, elapsedMs: Date.now() - t0, txHash: json?.result };
+        }
+        catch (e) {
+            const msg = e?.name === 'AbortError' || e?.message?.includes('aborted') ? `timeout(${timeoutMs}ms)` : (e?.message || String(e));
+            (0, ttd_core_1.log_warn)(`[${this.name}] send error: ${msg}`);
+            return { channel: this.name, elapsedMs: Date.now() - t0, error: msg };
+        }
+    }
+    async rpcCall(method, params, timeoutMs) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const { statusCode, body } = await this.pool.request({
+                method: 'POST',
+                path: this.path,
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify({ jsonrpc: '2.0', id: 1, method, params }),
+                signal: controller.signal,
+            });
+            if (statusCode < 200 || statusCode >= 300) {
+                // 消费 body 防内存泄露
+                try {
+                    await body.text();
+                }
+                catch { /* ignore */ }
+                throw new Error(`HTTP ${statusCode}`);
+            }
+            const text = await body.text();
+            return JSON.parse(text);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /** 测试/优雅停机用：销毁连接池 + 停 ping */
+    async close() {
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = undefined;
+        }
+        await this.pool.close();
+    }
+}
+exports.DirectRpcChannel = DirectRpcChannel;

package/dist/channels/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './direct_rpc';
+export * from './blockrazor';
+export * from './bloxroute';

package/dist/channels/index.js

@@ -0,0 +1,20 @@
+"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("./types"), exports);
+__exportStar(require("./direct_rpc"), exports);
+__exportStar(require("./blockrazor"), exports);
+__exportStar(require("./bloxroute"), exports);

package/dist/channels/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 发送通道抽象 — 所有 BASE 发送通道（Flashbots Protect / 直发 sequencer / 未来的私有 RPC）
+ * 都通过一个统一接口暴露给 TransactionSender。
+ *
+ * 设计目标：
+ *   - 通道是纯函数：拿到 signedTx + timeout，返回结果或抛错；不关心策略/优先级
+ *   - TransactionSender 负责并发 / 顺序 / 重试编排
+ *   - 通道之间相互独立，可热插拔
+ */
+export interface SendChannelResult {
+    /** 通道名（用于日志/分析）*/
+    channel: string;
+    /** sequencer / relay 返回的 tx hash（成功）；undefined = 失败但无 hash */
+    txHash?: string;
+    /** 总耗时（ms）*/
+    elapsedMs: number;
+    /** 错误信息（失败时）*/
+    error?: string;
+}
+export interface SendChannel {
+    readonly name: string;
+    /**
+     * @param signedTx hex-encoded raw transaction（必须以 0x 开头）
+     * @param timeoutMs 单次发送超时（ms）；超时即视为失败
+     */
+    send(signedTx: string, timeoutMs: number): Promise<SendChannelResult>;
+    /**
+     * 可选：启动期连接预热（建立 TCP+TLS，复用给后续 send）。
+     * 实现方应 fire-and-forget：失败不抛错，仅 log。
+     */
+    warmup?(timeoutMs?: number): Promise<void>;
+}

package/dist/channels/types.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * 发送通道抽象 — 所有 BASE 发送通道（Flashbots Protect / 直发 sequencer / 未来的私有 RPC）
+ * 都通过一个统一接口暴露给 TransactionSender。
+ *
+ * 设计目标：
+ *   - 通道是纯函数：拿到 signedTx + timeout，返回结果或抛错；不关心策略/优先级
+ *   - TransactionSender 负责并发 / 顺序 / 重试编排
+ *   - 通道之间相互独立，可热插拔
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { TransactionSender } from './transaction_sender';
+export { BASE_EOA_ADDRESS } from '@clonegod/ttd-base-common';

package/dist/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASE_EOA_ADDRESS = exports.TransactionSender = void 0;
+var transaction_sender_1 = require("./transaction_sender");
+Object.defineProperty(exports, "TransactionSender", { enumerable: true, get: function () { return transaction_sender_1.TransactionSender; } });
+var ttd_base_common_1 = require("@clonegod/ttd-base-common");
+Object.defineProperty(exports, "BASE_EOA_ADDRESS", { enumerable: true, get: function () { return ttd_base_common_1.BASE_EOA_ADDRESS; } });

package/dist/transaction_sender.d.ts

@@ -0,0 +1,47 @@
+import { ITransactionSender } from '@clonegod/ttd-base-common';
+import { AppConfig } from '@clonegod/ttd-core';
+/** 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 declare class TransactionSender implements ITransactionSender {
+    private channels;
+    private timeoutMs;
+    constructor(appConfig: AppConfig);
+    /**
+     * @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
+     */
+    sendTransaction(signedMainTx: string, channelTipTxMap: Map<string, string>, order_trace_id: string, pair?: string, _only_bundle?: boolean, trace?: TraceWriter): Promise<string[]>;
+}
+export {};