four-flap-meme-sdk 2.2.19 → 2.2.20

package/dist/contracts/tm.d.ts

@@ -1,5 +1,7 @@
-import { BytesLike, JsonRpcProvider, Wallet } from 'ethers';
-export type Providerish = JsonRpcProvider;
+import { BytesLike, Wallet } from 'ethers';
+import type { ContractTransactionReceipt } from 'ethers';
+import { createBscProvider } from '../utils/provider-factory.js';
+export type Providerish = ReturnType<typeof createBscProvider>;
 export type Signerish = Wallet;
 export type CreateOnChainParams = {
     chain: 'BSC';
@@ -10,8 +12,8 @@ export type CreateOnChainParams = {
     valueWei?: bigint;
 };
 export declare function createTokenOnChain(params: CreateOnChainParams): Promise<{
-    receipt: any;
-    tokenAddress: string | undefined;
+    receipt: ContractTransactionReceipt | null;
+    tokenAddress?: string;
 }>;
 export type TryBuyResult = {
     tokenManager: string;
@@ -31,8 +33,8 @@ export type TrySellResult = {
     fee: bigint;
 };
 export declare function trySell(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, token: string, amount: bigint, proxyAddressOverride?: string): Promise<TrySellResult>;
-export declare function buyTokenWithFunds(chain: 'BSC', rpcUrl: string, signerPrivateKey: string, token: string, funds: bigint, minAmount: bigint, to?: string, origin?: bigint): Promise<any>;
-export declare function sellToken(chain: 'BSC', rpcUrl: string, signerPrivateKey: string, token: string, amount: bigint, minFunds: bigint, origin?: bigint): Promise<any>;
+export declare function buyTokenWithFunds(chain: 'BSC', rpcUrl: string, signerPrivateKey: string, token: string, funds: bigint, minAmount: bigint, to?: string, origin?: bigint): Promise<ContractTransactionReceipt | null>;
+export declare function sellToken(chain: 'BSC', rpcUrl: string, signerPrivateKey: string, token: string, amount: bigint, minFunds: bigint, origin?: bigint): Promise<ContractTransactionReceipt | null>;
 export declare function tradeBuy(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, token: string, params: {
     type: 'funds';
     funds: bigint;
@@ -45,7 +47,7 @@ export declare function tradeBuy(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl:
     maxFunds: bigint;
     to?: string;
     origin?: bigint;
-}): Promise<any>;
+}): Promise<ContractTransactionReceipt | null>;
 export declare function tradeSell(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, token: string, params: {
     type: 'direct';
     amount: bigint;
@@ -59,4 +61,4 @@ export declare function tradeSell(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl
     origin?: bigint;
     feeRate?: bigint;
     feeRecipient?: string;
-}): Promise<any>;
+}): Promise<ContractTransactionReceipt | null>;

package/dist/contracts/tm.js

@@ -1,17 +1,18 @@
-import { Contract, JsonRpcProvider, Wallet } from 'ethers';
-import TM2Abi from '../shared/abis/TokenManager2.json' with { type: 'json' };
-import Helper3Abi from '../shared/abis/TokenManagerHelper3.json' with { type: 'json' };
-import { Contract as EContract } from 'ethers';
-import { ADDRESSES } from '../utils/constants.js';
+import { Contract, Wallet } from 'ethers';
+import TM2Abi from '../abis/contracts/TokenManager2.json' with { type: 'json' };
+import Helper3Abi from '../abis/contracts/TokenManagerHelper3.json' with { type: 'json' };
+import { ADDRESSES, ZERO_ADDRESS } from '../shared/constants/index.js';
+import { createBscProvider } from '../utils/provider-factory.js';
 import { TM1 } from './tm1.js';
 import { TM2 } from './tm2.js';
+const TM2_ABI = TM2Abi;
+const HELPER3_ABI = Helper3Abi;
 export async function createTokenOnChain(params) {
-    const { chain, rpcUrl, signerPrivateKey, args, signature, valueWei } = params;
-    const provider = new JsonRpcProvider(rpcUrl);
+    const { rpcUrl, signerPrivateKey, args, signature, valueWei } = params;
+    const provider = createBscProvider(rpcUrl);
     const signer = new Wallet(signerPrivateKey, provider);
     // 使用 Four.meme 平台原始合约地址（API 签名是给原始合约的）
-    const FOUR_ORIGINAL_TM2 = '0x5c952063c7fc8610FFDB798152D69F0B9550762b';
-    const tm2 = new Contract(FOUR_ORIGINAL_TM2, TM2Abi, signer);
+    const tm2 = new Contract(ADDRESSES.BSC.TokenManagerOriginal, TM2_ABI, signer);
     const tx = await tm2.createToken(args, signature, { value: valueWei ?? 0n });
     const receipt = await tx.wait();
     // 解析 TokenCreate 事件获取代币地址
@@ -25,7 +26,7 @@ export async function createTokenOnChain(params) {
                     break;
                 }
             }
-            catch (e) {
+            catch (_e) {
                 // 忽略无法解析的日志
             }
         }
@@ -38,17 +39,15 @@ export async function tryBuy(chain, rpcUrl, token, amount, funds, proxyAddressOv
         BASE: ADDRESSES.BASE.TokenManagerHelper3,
         ARBITRUM_ONE: ADDRESSES.ARBITRUM_ONE.TokenManagerHelper3,
     };
-    const provider = new JsonRpcProvider(rpcUrl);
+    const provider = createBscProvider(rpcUrl);
     // 优先用代理预览（若提供）
     if (proxyAddressOverride) {
-        const proxyAbi = [
-            'function previewBuy(address token, uint256 funds) view returns (uint256)',
-        ];
-        const proxy = new EContract(proxyAddressOverride, proxyAbi, provider);
+        const proxyAbi = ['function previewBuy(address token, uint256 funds) view returns (uint256)'];
+        const proxy = new Contract(proxyAddressOverride, proxyAbi, provider);
         const estimatedAmount = await proxy.previewBuy(token, funds);
         return {
             tokenManager: 'proxy',
-            quote: '0x0000000000000000000000000000000000000000',
+            quote: ZERO_ADDRESS,
             estimatedAmount,
             estimatedCost: funds,
             estimatedFee: 0n,
@@ -57,7 +56,7 @@ export async function tryBuy(chain, rpcUrl, token, amount, funds, proxyAddressOv
             amountFunds: funds,
         };
     }
-    const helper = new Contract(helper3Addresses[chain], Helper3Abi, provider);
+    const helper = new Contract(helper3Addresses[chain], HELPER3_ABI, provider);
     const r = await helper.tryBuy(token, amount, funds);
     return {
         tokenManager: r.tokenManager,
@@ -76,22 +75,20 @@ export async function trySell(chain, rpcUrl, token, amount, proxyAddressOverride
         BASE: ADDRESSES.BASE.TokenManagerHelper3,
         ARBITRUM_ONE: ADDRESSES.ARBITRUM_ONE.TokenManagerHelper3,
     };
-    const provider = new JsonRpcProvider(rpcUrl);
+    const provider = createBscProvider(rpcUrl);
     // 优先用代理预览（若提供）
     if (proxyAddressOverride) {
-        const proxyAbi = [
-            'function previewSell(address token, uint256 amount) view returns (uint256)',
-        ];
-        const proxy = new EContract(proxyAddressOverride, proxyAbi, provider);
+        const proxyAbi = ['function previewSell(address token, uint256 amount) view returns (uint256)'];
+        const proxy = new Contract(proxyAddressOverride, proxyAbi, provider);
         const funds = await proxy.previewSell(token, amount);
         return {
             tokenManager: 'proxy',
-            quote: '0x0000000000000000000000000000000000000000',
+            quote: ZERO_ADDRESS,
             funds,
             fee: 0n,
         };
     }
-    const helper = new Contract(helper3Addresses[chain], Helper3Abi, provider);
+    const helper = new Contract(helper3Addresses[chain], HELPER3_ABI, provider);
     const r = await helper.trySell(token, amount);
     return {
         tokenManager: r.tokenManager,
@@ -101,9 +98,9 @@ export async function trySell(chain, rpcUrl, token, amount, proxyAddressOverride
     };
 }
 export async function buyTokenWithFunds(chain, rpcUrl, signerPrivateKey, token, funds, minAmount, to, origin = 0n) {
-    const provider = new JsonRpcProvider(rpcUrl);
+    const provider = createBscProvider(rpcUrl);
     const signer = new Wallet(signerPrivateKey, provider);
-    const tm2 = new Contract(ADDRESSES[chain].TokenManagerV2, TM2Abi, signer);
+    const tm2 = new Contract(ADDRESSES[chain].TokenManagerV2, TM2_ABI, signer);
     if (to) {
         const tx = await tm2.buyTokenAMAP(origin, token, to, funds, minAmount, { value: funds });
         return await tx.wait();
@@ -114,9 +111,9 @@ export async function buyTokenWithFunds(chain, rpcUrl, signerPrivateKey, token,
     }
 }
 export async function sellToken(chain, rpcUrl, signerPrivateKey, token, amount, minFunds, origin = 0n) {
-    const provider = new JsonRpcProvider(rpcUrl);
+    const provider = createBscProvider(rpcUrl);
     const signer = new Wallet(signerPrivateKey, provider);
-    const tm2 = new Contract(ADDRESSES[chain].TokenManagerV2, TM2Abi, signer);
+    const tm2 = new Contract(ADDRESSES[chain].TokenManagerV2, TM2_ABI, signer);
     // 使用明确的函数签名避免歧义
     const tx = await tm2['sellToken(uint256,address,uint256,uint256)'](origin, token, amount, minFunds);
     return await tx.wait();
@@ -128,8 +125,8 @@ export async function tradeBuy(chain, rpcUrl, token, params) {
         BASE: ADDRESSES.BASE.TokenManagerHelper3,
         ARBITRUM_ONE: ADDRESSES.ARBITRUM_ONE.TokenManagerHelper3,
     };
-    const provider = new JsonRpcProvider(rpcUrl);
-    const helper = new Contract(helper3Addresses[chain], Helper3Abi, provider);
+    const provider = createBscProvider(rpcUrl);
+    const helper = new Contract(helper3Addresses[chain], HELPER3_ABI, provider);
     const info = await helper.getTokenInfo(token);
     const version = info.version;
     if (version === 1n) {
@@ -143,9 +140,16 @@ export async function tradeBuy(chain, rpcUrl, token, params) {
     if (chain !== 'BSC')
         throw new Error('TokenManager V2 only supported on BSC');
     const tm2 = TM2.connectByChain('BSC', rpcUrl);
-    if (params.type === 'funds')
-        return await tm2.buyTokenAMAP(params.origin ?? 0n, token, params.to ?? undefined, params.funds, params.minAmount);
-    return await tm2.buyToken(params.origin ?? 0n, token, params.to ?? undefined, params.amount, params.maxFunds);
+    if (params.type === 'funds') {
+        const o = params.origin ?? 0n;
+        return params.to !== undefined
+            ? await tm2.buyTokenAMAP(o, token, params.to, params.funds, params.minAmount)
+            : await tm2.buyTokenAMAP(o, token, params.funds, params.minAmount);
+    }
+    const o = params.origin ?? 0n;
+    return params.to !== undefined
+        ? await tm2.buyToken(o, token, params.to, params.amount, params.maxFunds)
+        : await tm2.buyToken(o, token, params.amount, params.maxFunds);
 }
 export async function tradeSell(chain, rpcUrl, token, params) {
     const helper3Addresses = {
@@ -153,8 +157,8 @@ export async function tradeSell(chain, rpcUrl, token, params) {
         BASE: ADDRESSES.BASE.TokenManagerHelper3,
         ARBITRUM_ONE: ADDRESSES.ARBITRUM_ONE.TokenManagerHelper3,
     };
-    const provider = new JsonRpcProvider(rpcUrl);
-    const helper = new Contract(helper3Addresses[chain], Helper3Abi, provider);
+    const provider = createBscProvider(rpcUrl);
+    const helper = new Contract(helper3Addresses[chain], HELPER3_ABI, provider);
     const info = await helper.getTokenInfo(token);
     const version = info.version;
     if (version === 1n) {

package/dist/contracts/tm1.js

@@ -1,7 +1,10 @@
 import { Contract, JsonRpcProvider } from 'ethers';
-import TM1Abi from '../shared/abis/TokenManager.json' with { type: 'json' };
-import { ADDRESSES } from '../utils/constants.js';
+import TM1Abi from '../abis/contracts/TokenManager.json' with { type: 'json' };
+import { ADDRESSES } from '../shared/constants/index.js';
+const TM1_ABI = TM1Abi;
 export class TM1 {
+    address;
+    provider;
     constructor(address, provider) {
         this.address = address;
         this.provider = provider;
@@ -14,9 +17,11 @@ export class TM1 {
         return new TM1(address, new JsonRpcProvider(rpcUrl));
     }
     get c() {
-        return new Contract(this.address, TM1Abi, this.provider);
+        return new Contract(this.address, TM1_ABI, this.provider);
+    }
+    async lastPrice(token) {
+        return await this.c.lastPrice(token);
     }
-    async lastPrice(token) { return await this.c.lastPrice(token); }
     async purchaseToken(token, amount, maxFunds, origin, to) {
         if (origin !== undefined && to)
             return await this.c.purchaseToken(origin, token, to, amount, maxFunds, { value: maxFunds });

package/dist/contracts/tm2.js

@@ -1,7 +1,10 @@
 import { Contract, JsonRpcProvider, Wallet } from 'ethers';
-import TM2Abi from '../shared/abis/TokenManager2.json' with { type: 'json' };
-import { ADDRESSES } from '../utils/constants.js';
+import TM2Abi from '../abis/contracts/TokenManager2.json' with { type: 'json' };
+import { ADDRESSES, ZERO_ADDRESS } from '../shared/constants/index.js';
+const TM2_ABI = TM2Abi;
 export class TM2 {
+    address;
+    provider;
     constructor(address, provider) {
         this.address = address;
         this.provider = provider;
@@ -20,9 +23,11 @@ export class TM2 {
         const address = ADDRESSES[chain].TokenManagerV2;
         const provider = new JsonRpcProvider(rpcUrl);
         const signer = new Wallet(privateKey, provider);
-        return new Contract(address, TM2Abi, signer);
+        return new Contract(address, TM2_ABI, signer);
+    }
+    get c() {
+        return new Contract(this.address, TM2_ABI, this.provider);
     }
-    get c() { return new Contract(this.address, TM2Abi, this.provider); }
     async buyToken(originOrToken, tokenOrTo, toOrAmount, amountOrMaxFunds, maxFunds) {
         if (typeof originOrToken === 'bigint') {
             const origin = originOrToken;
@@ -104,6 +109,6 @@ export class TM2 {
             return await this.c['sellToken(uint256,address,address,uint256,uint256,uint256,address)'](origin, token, from, amount, minFunds, feeRate, feeRecipient);
         }
         // 7参数版本，feeRate=0，feeRecipient=0地址
-        return await this.c['sellToken(uint256,address,address,uint256,uint256,uint256,address)'](origin, token, from, amount, minFunds, 0, '0x0000000000000000000000000000000000000000');
+        return await this.c['sellToken(uint256,address,address,uint256,uint256,uint256,address)'](origin, token, from, amount, minFunds, 0, ZERO_ADDRESS);
     }
 }

package/dist/dex/direct-router-helpers.d.ts

@@ -0,0 +1,269 @@
+import { ethers, Wallet, JsonRpcProvider } from 'ethers';
+import type { DirectRouterSignConfig } from './types.js';
+import type { GeneratedWallet } from '../utils/wallet.js';
+/**
+ * 直接 Router 交易（不走代理合约）
+ *
+ * 支持：
+ * - BSC: PancakeSwap V2/V3
+ * - Monad: PancakeSwap V2, Uniswap V2/V3
+ *
+ * 收费方式：交易末尾附加利润提取交易（和内盘一致）
+ */
+export declare const providerCache: Map<string, ethers.JsonRpcProvider>;
+export declare const PROVIDER_CACHE_TTL = 60000;
+export declare const providerCacheTimestamps: Map<string, number>;
+/**
+ * 获取缓存的 Provider 实例
+ * - 根据 rpcUrl + chainId 作为缓存 key
+ * - 60秒后自动失效，避免长连接问题
+ */
+export declare function getCachedProvider(rpcUrl: string, chainId: number, chainName: string): JsonRpcProvider;
+export declare const DEFAULT_GAS_LIMIT = 300000;
+export declare const DEADLINE_MINUTES = 20;
+/**
+ * 截断小数位数，避免超过代币精度导致 parseUnits 报错
+ * 例如：truncateDecimals("21906.025000000000000000", 1) => "21906.0"
+ */
+export declare function truncateDecimals(value: string, decimals: number): string;
+/** Router 地址配置 - ✅ 使用公共模块中的地址 */
+export declare const DIRECT_ROUTERS: {
+    readonly BSC: {
+        readonly PANCAKESWAP_V2: "0x10ED43C718714eb63d5aA57B78B54704E256024E";
+        readonly PANCAKESWAP_V3: "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
+        readonly IROSWAP_V2: "0xe90fb729E458092592a79EdaFefB3404ecb3C463";
+        readonly WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
+    };
+    readonly MONAD: {
+        readonly PANCAKESWAP_V2: "0xb1bc24c34e88f7d43d5923034e3a14b24daacff9";
+        readonly PANCAKESWAP_V3: "0x1b81d678ffb9c0263b24a97847620c99d213eb14";
+        readonly UNISWAP_V2: "0x4b2ab38dbf28d31d467aa8993f6c2585981d6804";
+        readonly UNISWAP_V3: "0xd6145b2d3f379919e8cdeda7b97e37c4b2ca9c40";
+        readonly WMON: "0x3bd359c1119da7da1d913d1c4d2b7c461115433a";
+    };
+    readonly XLAYER: {
+        readonly POTATOSWAP_V2: "0x881fb2f98c13d521009464e7d1cbf16e1b394e8e";
+        readonly POTATOSWAP_V3: "0xB45D0149249488333E3F3f9F359807F4b810C1FC";
+        readonly DYORSWAP_ROUTER: "0xfb001fbbace32f09cb6d3c449b935183de53ee96";
+        readonly DYORSWAP_FACTORY: "0x2CcaDb1e437AA9cDc741574bDa154686B1F04C09";
+        readonly V3_ROUTER: "0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41";
+        readonly V3_FACTORY: "0xa1415fAe79c4B196d087F02b8aD5a622B8A827E5";
+        readonly WOKB: "0xe538905cf8410324e03a5a23c1c177a474d59b2b";
+    };
+    readonly ENI: {
+        readonly DSWAP_V2: "0x97ed8be49d9a8b86247090aa41e908e76b8fcf22";
+        readonly DSWAP_V3: "0xcdE487F5B460a516f31FaC520D4e18BA1C8cda49";
+        readonly IROSWAP_V2: "0x93b1199fA96f6b9b1f993AA0226eB6076968a9BF";
+        readonly WEGAS: "0x6d1e851446f4d004ae2a72f9afed85e8829a205e";
+    };
+};
+/** 链 ID 映射 */
+export declare const CHAIN_IDS: {
+    readonly BSC: 56;
+    readonly MONAD: 143;
+    readonly XLAYER: 196;
+    readonly ENI: 173;
+};
+/** 获取原生包装代币地址 */
+export declare function getWrappedNative(chain: string): string;
+/** V2 Router ABI */
+export declare const V2_ROUTER_ABI: string[];
+/** SwapRouter02 的 V2 方法 ABI - ✅ 从公共模块导入 */
+export declare const SWAP_ROUTER02_V2_ABI: string[];
+/**
+ * DYORSwap SwapRouter02 的 V2 方法
+ *
+ * ⚠️ 重要：DYORSwap 使用自定义的函数签名，无法通过标准 ABI 编码
+ * 必须手动构造 calldata
+ *
+ * swapExactTokensForTokens selector: 0x3234fe0d
+ * unwrapWETH9 selector: 0x7342292e
+ * refundETH selector: 0x6d29fcf4
+ */
+export declare const DYORSWAP_SELECTORS: {
+    swapExactTokensForTokens: string;
+    unwrapWETH9: string;
+    refundETH: string;
+    multicall: string;
+};
+/**
+ * 手动编码 DYORSwap 的 swapExactTokensForTokens calldata
+ *
+ * 参数格式 (根据成功交易分析):
+ * - amountIn: uint256
+ * - amountOutMin: uint256
+ * - path: address[] (动态) - offset from start
+ * - pools: address[] (动态) - offset from start
+ * - to: uint256 (address(2) = 2)
+ * - flag: uint256 (1)
+ * - factory: address
+ *
+ * 成功交易的布局:
+ * [0] amountIn
+ * [1] amountOutMin
+ * [2] offset to path = 0xa0 = 160 = 5 * 32 (从参数区域开始)
+ * [3] offset to pools = 0xe0 = 224 = 7 * 32
+ * [4] to = 2
+ * [5] flag = 1
+ * [6] factory
+ * [7] path.length
+ * [8+] path elements
+ * [N] pools.length
+ * [N+1+] pools elements
+ */
+export declare function encodeDYORSwapExactTokensForTokens(amountIn: bigint, amountOutMin: bigint, path: string[], pools: string[], to: string | bigint, // 可以是地址 (string) 或 address(2) 这样的特殊值 (bigint)
+flag: bigint, factory: string): string;
+/**
+ * 手动编码 DYORSwap 的 unwrapWETH9 calldata
+ *
+ * 参数格式 (根据成功交易分析):
+ * - amountMinimum: uint256
+ * - recipient: address
+ * - pools: bytes (动态) - 包含特殊的 pool 数据
+ *
+ * 成功交易的布局:
+ * [0] amountMinimum
+ * [1] recipient
+ * [2] offset to pools = 0x60 = 96 = 3 * 32
+ * [3] pools 数据 (bytes)
+ */
+export declare function encodeDYORUnwrapWETH9(amountMinimum: bigint, recipient: string, poolsData?: string): string;
+/**
+ * DYORSwap 的 ETHBack_Dividend 合约地址
+ * 这是 refundETH 中使用的固定地址，不是 LP 池地址
+ */
+export declare const DYORSWAP_ETHBACK_DIVIDEND: "0x2e61b0b4410f6fb941d47205191cbb8963d44bcc";
+/**
+ * 手动编码 DYORSwap 的 refundETH calldata
+ *
+ * 根据成功交易分析，refundETH 的格式是:
+ * refundETH(bytes pools)
+ *
+ * 成功交易的 refundETH (0x6d29fcf4):
+ * [0] offset to pools = 0x20 = 32
+ * [1] pools 数组长度 = 1
+ * [2] fee = 30 (0x1e)
+ * [3] ETHBack_Dividend 合约地址
+ */
+export declare function encodeDYORRefundETH(fee?: number): string;
+/**
+ * 手动编码 DYORSwap 的 multicall calldata
+ *
+ * multicall(uint256 deadline, bytes[] data)
+ * 这个函数使用标准 ABI 编码
+ */
+export declare function encodeDYORMulticall(deadline: bigint, data: string[]): string;
+/** V3 SwapRouter02 ABI (PancakeSwap V3, 新版 Uniswap) */
+export declare const V3_ROUTER02_ABI: (string | {
+    inputs: {
+        components: {
+            name: string;
+            type: string;
+        }[];
+        name: string;
+        type: string;
+    }[];
+    name: string;
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+    type: string;
+})[];
+/** V3 SwapRouter（旧版）ABI (Monad Uniswap V3) */
+export declare const V3_ROUTER_LEGACY_ABI: (string | {
+    inputs: {
+        components: {
+            name: string;
+            type: string;
+        }[];
+        name: string;
+        type: string;
+    }[];
+    name: string;
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+    type: string;
+})[];
+/**
+ * 判断是否使用旧版 SwapRouter
+ *
+ * 旧版特征：
+ * - exactInputSingle 包含 deadline 字段
+ * - multicall 只有 bytes[] 参数
+ *
+ * Monad 上的 V3 DEX 都使用旧版：
+ * - Uniswap V3: 0xd6145b2d3f379919e8cdeda7b97e37c4b2ca9c40
+ * - PancakeSwap V3: 0x1b81D678ffb9C0263b24A97847620C99d213eB14
+ *
+ * XLayer:
+ * - V3 Router (0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41) - 旧版（exactInputSingle 包含 deadline）
+ * - SwapRouter02 (0xB45D0149249488333E3F3f9F359807F4b810C1FC) - 新版（V2+V3 混合）
+ *
+ * BSC PancakeSwap V3 使用新版 SwapRouter02
+ */
+export declare function isLegacySwapRouter(chain: string, routerAddress: string): boolean;
+/** ERC20 ABI - ✅ 从公共模块导入 */
+export declare function getDeadline(minutes?: number): number;
+export declare function getGasLimit(config: DirectRouterSignConfig, defaultGas?: number): bigint;
+export declare function getGasPrice(provider: JsonRpcProvider, config: DirectRouterSignConfig): Promise<bigint>;
+export declare function isNativeToken(quoteToken?: string): boolean;
+export declare const XLAYER_V3_FACTORY_ABI: readonly ["function getPool(address tokenA, address tokenB, uint24 fee) view returns (address pool)"];
+export declare const XLAYER_V3_POOL_ABI: readonly ["function slot0() view returns (uint160 sqrtPriceX96,int24 tick,uint16 observationIndex,uint16 observationCardinality,uint16 observationCardinalityNext,uint8 feeProtocol,bool unlocked)", "function token0() view returns (address)", "function token1() view returns (address)"];
+export declare const V3_FEE_DENOMINATOR = 1000000n;
+export declare function quoteXLayerV3TokenToNativeBySlot0(params: {
+    provider: JsonRpcProvider;
+    tokenIn: string;
+    amountIn: bigint;
+    fee: number;
+}): Promise<bigint>;
+/**
+ * ✅ 找到金额最大的钱包索引（和 core.ts 逻辑一致）
+ */
+export declare function findMaxFlowIndex(amounts: bigint[]): number;
+/** 计算利润金额 */
+export declare function calculateProfitAmount(totalFlowWei: bigint): bigint;
+/**
+ * 构建利润多跳转账交易（强制 2 跳中转）
+ */
+export declare function buildProfitTransactionWithHops(provider: JsonRpcProvider, wallet: Wallet, profitAmountWei: bigint, nonce: number, gasPrice: bigint, chainId: number, txType?: 0 | 2, profitRecipient?: string): Promise<{
+    signedTransactions: string[];
+    hopWallets?: GeneratedWallet[];
+}>;
+/**
+ * 获取贿赂金额（wei）
+ * ✅ 仅 BSC 链支持贿赂
+ */
+export declare function getBribeAmount(config: DirectRouterSignConfig, chain: string): bigint;
+/** 构建贿赂交易（向 BlockRazor Builder EOA 转账 BNB） */
+export declare function buildBribeTransaction(wallet: Wallet, bribeAmountWei: bigint, nonce: number, gasPrice: bigint, chainId: number, txType?: 0 | 2): Promise<string>;
+/**
+ * 判断是否是 SwapRouter02 (XLayer PotatoSwap V3)
+ *
+ * SwapRouter02 风格的 Router 使用 multicall 包装 V2 方法：
+ * - multicall(uint256 deadline, bytes[] data)
+ * - data 内包含 swapExactTokensForTokens 等 V2 方法
+ *
+ * SwapRouter02 的 V2 方法签名不同：
+ * - swapExactTokensForTokens(amountIn, amountOutMin, path[], to) - 没有 deadline
+ * - 需要通过 multicall 的 deadline 参数传递 deadline
+ *
+ * ⚠️ 注意：DYORSwap 虽然也用 multicall，但它的 ABI 完全不同，需要单独处理
+ */
+export declare function isSwapRouter02(chain: string, routerAddress: string): boolean;
+/**
+ * 判断是否是 DYORSwap Router
+ *
+ * DYORSwap 使用 multicall，但它的 swapExactTokensForTokens 有特殊的 ABI：
+ * - swapExactTokensForTokens(amountIn, amountOutMin, path[], payer, flags, factory, pools)
+ * - unwrapWETH9(amountMinimum, recipient, pools)
+ */
+export declare function isDYORSwap(chain: string, routerAddress: string): boolean;
+export declare function filterEniNativeBuyIndices(balances: bigint[], flowAmounts: bigint[], gasLimit: number | bigint, gasPrice: bigint, profitWei: bigint): number[] | null;
+/**
+ * V2 批量买入（直接调用 Router）
+ */