four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/domains/dex/dyo-encode.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 手动编码 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 的 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;

package/dist/domains/dex/dyo-encode.js

@@ -0,0 +1,124 @@
+import { ethers } from 'ethers';
+import { DYORSWAP_ETHBACK_DIVIDEND, DYORSWAP_SELECTORS } from './direct-router-types.js';
+/**
+ * 手动编码 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 function encodeDYORSwapExactTokensForTokens(amountIn, amountOutMin, path, pools, to, // 可以是地址 (string) 或 address(2) 这样的特殊值 (bigint)
+flag, factory) {
+    const pathOffset = 5n * 32n; // 160
+    // poolsOffset = pathOffset + (1 + path.length) * 32 = 160 + 96 = 256?
+    // 不对，成功交易是 224 = 160 + 64 = pathOffset + path.length * 32
+    const poolsOffset = pathOffset + BigInt(path.length) * 32n; // 160 + 2*32 = 224
+    // 手动构建数据
+    const pad32 = (hex) => hex.replace('0x', '').padStart(64, '0');
+    const toHex = (n) => n.toString(16).padStart(64, '0');
+    // 处理 to 参数：可以是地址 (string) 或特殊值 (bigint)
+    const toValue = typeof to === 'string' ? pad32(to) : toHex(to);
+    let data = DYORSWAP_SELECTORS.swapExactTokensForTokens;
+    data += toHex(amountIn);
+    data += toHex(amountOutMin);
+    data += toHex(pathOffset);
+    data += toHex(poolsOffset);
+    data += toValue;
+    data += toHex(flag);
+    data += pad32(factory);
+    // path 数据
+    data += toHex(BigInt(path.length));
+    for (const addr of path) {
+        data += pad32(addr);
+    }
+    // ⚠️ 不包含 pools 数据！成功交易中 pools 是空的
+    // poolsOffset 指向的位置没有数据
+    return '0x' + data.replace('0x', '');
+}
+/**
+ * 手动编码 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 function encodeDYORUnwrapWETH9(amountMinimum, recipient, poolsData = '') {
+    const pad32 = (hex) => hex.slice(2).padStart(64, '0');
+    const toHex = (n) => n.toString(16).padStart(64, '0');
+    const poolsOffset = 3n * 32n; // 96
+    const poolsBytes = poolsData.startsWith('0x') ? poolsData.slice(2) : poolsData;
+    const poolsLength = poolsBytes.length / 2;
+    let data = DYORSWAP_SELECTORS.unwrapWETH9;
+    data += toHex(amountMinimum);
+    data += pad32(recipient);
+    data += toHex(poolsOffset);
+    data += toHex(BigInt(poolsLength));
+    // pools 数据需要 padding 到 32 字节的倍数
+    if (poolsBytes.length > 0) {
+        const paddedLength = Math.ceil(poolsBytes.length / 64) * 64;
+        data += poolsBytes.padEnd(paddedLength, '0');
+    }
+    return '0x' + data.replace('0x', '');
+}
+/**
+ * 手动编码 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 function encodeDYORRefundETH(fee = 30) {
+    const toHex = (n) => n.toString(16).padStart(64, '0');
+    const pad32 = (hex) => hex.replace('0x', '').padStart(64, '0');
+    // 使用固定的 ETHBack_Dividend 合约地址
+    let data = DYORSWAP_SELECTORS.refundETH;
+    data += toHex(32n); // offset = 0x20
+    data += toHex(1n); // 数组长度 = 1
+    data += toHex(BigInt(fee)); // fee = 30
+    data += pad32(DYORSWAP_ETHBACK_DIVIDEND); // ETHBack_Dividend 地址
+    return '0x' + data.replace('0x', '');
+}
+/**
+ * 手动编码 DYORSwap 的 multicall calldata
+ *
+ * multicall(uint256 deadline, bytes[] data)
+ * 这个函数使用标准 ABI 编码
+ */
+export function encodeDYORMulticall(deadline, data) {
+    const abiCoder = ethers.AbiCoder.defaultAbiCoder();
+    // multicall(uint256 deadline, bytes[] data)
+    // 确保每个 data 元素都是正确的 hex 格式
+    const formattedData = data.map((d) => (d.startsWith('0x') ? d : '0x' + d));
+    const encoded = abiCoder.encode(['uint256', 'bytes[]'], [deadline, formattedData]).slice(2);
+    return '0x' + DYORSWAP_SELECTORS.multicall.slice(2) + encoded;
+}

package/dist/domains/dex/profit.d.ts

@@ -0,0 +1,24 @@
+import type { Wallet, JsonRpcProvider } from 'ethers';
+import type { GeneratedWallet } from '../../utils/wallet.js';
+import type { DirectRouterSignConfig } from './types.js';
+/**
+ * ✅ 找到金额最大的钱包索引（和 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>;
+export declare function filterEniNativeBuyIndices(balances: bigint[], flowAmounts: bigint[], gasLimit: number | bigint, gasPrice: bigint, profitWei: bigint): number[] | null;

package/dist/domains/dex/profit.js

@@ -0,0 +1,86 @@
+import { ethers } from 'ethers';
+import { BLOCKRAZOR_BUILDER_EOA, GAS_LIMITS, getProfitRateBps, getProfitRecipient } from '../../core/constants/index.js';
+import { buildGasFields, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../utils/bundle-helpers.js';
+/**
+ * ✅ 找到金额最大的钱包索引（和 core.ts 逻辑一致）
+ */
+export function findMaxFlowIndex(amounts) {
+    if (amounts.length === 0)
+        return 0;
+    let maxIndex = 0;
+    let maxValue = amounts[0];
+    for (let i = 1; i < amounts.length; i++) {
+        if (amounts[i] > maxValue) {
+            maxValue = amounts[i];
+            maxIndex = i;
+        }
+    }
+    return maxIndex;
+}
+/** 计算利润金额 */
+export function calculateProfitAmount(totalFlowWei) {
+    return (totalFlowWei * BigInt(getProfitRateBps('normal'))) / 10000n;
+}
+/**
+ * 构建利润多跳转账交易（强制 2 跳中转）
+ */
+export async function buildProfitTransactionWithHops(provider, wallet, profitAmountWei, nonce, gasPrice, chainId, txType = 0, profitRecipient) {
+    if (profitAmountWei <= 0n)
+        return { signedTransactions: [], hopWallets: undefined };
+    const profitHopResult = await buildProfitHopTransactions({
+        provider,
+        payerWallet: wallet,
+        profitAmount: profitAmountWei,
+        profitRecipient: profitRecipient || getProfitRecipient(),
+        hopCount: PROFIT_HOP_COUNT,
+        gasPrice,
+        chainId,
+        txType,
+        startNonce: nonce,
+    });
+    return { signedTransactions: profitHopResult.signedTransactions, hopWallets: profitHopResult.hopWallets };
+}
+/**
+ * 获取贿赂金额（wei）
+ * ✅ 仅 BSC 链支持贿赂
+ */
+export function getBribeAmount(config, chain) {
+    // 只有 BSC 链支持贿赂
+    if (chain.toUpperCase() !== 'BSC')
+        return 0n;
+    const bribeAmount = config.bribeAmount;
+    if (typeof bribeAmount !== 'number' || bribeAmount <= 0)
+        return 0n;
+    // 转换为 wei
+    return ethers.parseEther(String(bribeAmount));
+}
+/** 构建贿赂交易（向 BlockRazor Builder EOA 转账 BNB） */
+export async function buildBribeTransaction(wallet, bribeAmountWei, nonce, gasPrice, chainId, txType = 0) {
+    const tx = {
+        to: BLOCKRAZOR_BUILDER_EOA,
+        value: bribeAmountWei,
+        nonce,
+        gasLimit: GAS_LIMITS.BRIBE,
+        ...buildGasFields(txType, gasPrice),
+        chainId,
+    };
+    return wallet.signTransaction(tx);
+}
+export function filterEniNativeBuyIndices(balances, flowAmounts, gasLimit, gasPrice, profitWei) {
+    const maxFlowIdx = findMaxFlowIndex(flowAmounts);
+    const profitGasCost = GAS_LIMITS.NATIVE_TRANSFER * gasPrice;
+    const validIdx = [];
+    for (let i = 0; i < balances.length; i++) {
+        let required = flowAmounts[i] + BigInt(gasLimit) * gasPrice;
+        if (i === maxFlowIdx && profitWei > 0n) {
+            required += profitWei + profitGasCost;
+        }
+        if (balances[i] < required)
+            continue;
+        validIdx.push(i);
+    }
+    if (validIdx.length === 0) {
+        throw new Error('[V2 BatchBuy ENI] 所有钱包余额不足（含 swap + gas + 利润费），无法执行');
+    }
+    return validIdx.length < balances.length ? validIdx : null;
+}

package/dist/domains/dex/provider.d.ts

@@ -0,0 +1,10 @@
+import { JsonRpcProvider } from 'ethers';
+export declare const providerCache: Map<string, 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;

package/dist/domains/dex/provider.js

@@ -0,0 +1,27 @@
+import { createProvider } from '../../utils/provider-factory.js';
+// ============================================================================
+// ✅ 方案 C：Provider 缓存（避免重复创建）
+// ============================================================================
+export const providerCache = new Map();
+export const PROVIDER_CACHE_TTL = 60000; // 60秒后过期
+export const providerCacheTimestamps = new Map();
+/**
+ * 获取缓存的 Provider 实例
+ * - 根据 rpcUrl + chainId 作为缓存 key
+ * - 60秒后自动失效，避免长连接问题
+ */
+export function getCachedProvider(rpcUrl, chainId, chainName) {
+    const cacheKey = `${rpcUrl}_${chainId}`;
+    const now = Date.now();
+    // 检查缓存是否存在且未过期
+    const cachedProvider = providerCache.get(cacheKey);
+    const timestamp = providerCacheTimestamps.get(cacheKey) || 0;
+    if (cachedProvider && now - timestamp < PROVIDER_CACHE_TTL) {
+        return cachedProvider;
+    }
+    // ✅ 禁用 ENS: 避免 "network does not support ENS" 错误
+    const provider = createProvider(rpcUrl, chainId, chainName);
+    providerCache.set(cacheKey, provider);
+    providerCacheTimestamps.set(cacheKey, now);
+    return provider;
+}

package/dist/domains/dex/quote.d.ts

@@ -0,0 +1,7 @@
+import { JsonRpcProvider } from 'ethers';
+export declare function quoteXLayerV3TokenToNativeBySlot0(params: {
+    provider: JsonRpcProvider;
+    tokenIn: string;
+    amountIn: bigint;
+    fee: number;
+}): Promise<bigint>;

package/dist/domains/dex/quote.js

@@ -0,0 +1,52 @@
+import { Contract } from 'ethers';
+import { ZERO_ADDRESS } from '../../core/constants/index.js';
+import { DIRECT_ROUTERS, V3_FEE_DENOMINATOR, XLAYER_V3_FACTORY_ABI, XLAYER_V3_POOL_ABI, } from './direct-router-types.js';
+// ============================================================================
+// XLAYER V3 报价（slot0 现货价，纯 V3，不串 V2）
+// - 只用于“利润换算”为原生币，避免 XLAYER 没有 v3Quoter 导致 profit=0
+// - 不改 BSC 的任何配置/逻辑
+// ============================================================================
+export async function quoteXLayerV3TokenToNativeBySlot0(params) {
+    try {
+        const { provider, tokenIn, amountIn, fee } = params;
+        if (!tokenIn || amountIn <= 0n)
+            return 0n;
+        const chainFactory = DIRECT_ROUTERS.XLAYER.V3_FACTORY;
+        const wrappedNative = DIRECT_ROUTERS.XLAYER.WOKB;
+        if (!chainFactory || !wrappedNative)
+            return 0n;
+        const tokenInLower = tokenIn.toLowerCase();
+        const wrappedLower = wrappedNative.toLowerCase();
+        if (tokenInLower === wrappedLower)
+            return amountIn;
+        const factory = new Contract(chainFactory, XLAYER_V3_FACTORY_ABI, provider);
+        const poolAddr = await factory.getPool?.(tokenIn, wrappedNative, fee);
+        if (!poolAddr || poolAddr.toLowerCase() === ZERO_ADDRESS.toLowerCase())
+            return 0n;
+        const pool = new Contract(poolAddr, XLAYER_V3_POOL_ABI, provider);
+        const [t0, t1, slot0] = await Promise.all([pool.token0?.(), pool.token1?.(), pool.slot0?.()]);
+        if (!t0 || !t1 || !slot0)
+            return 0n;
+        const sqrtPriceX96 = BigInt(slot0[0]);
+        if (sqrtPriceX96 <= 0n)
+            return 0n;
+        const amountInLessFee = (amountIn * (V3_FEE_DENOMINATOR - BigInt(fee))) / V3_FEE_DENOMINATOR;
+        if (amountInLessFee <= 0n)
+            return 0n;
+        const Q192 = 2n ** 192n;
+        const num = sqrtPriceX96 * sqrtPriceX96;
+        const t0Lower = String(t0).toLowerCase();
+        const t1Lower = String(t1).toLowerCase();
+        // sqrtPriceX96 表示 token1/token0 的现货价（raw）
+        if (tokenInLower === t0Lower && wrappedLower === t1Lower) {
+            return (amountInLessFee * num) / Q192;
+        }
+        if (tokenInLower === t1Lower && wrappedLower === t0Lower) {
+            return (amountInLessFee * Q192) / num;
+        }
+        return 0n;
+    }
+    catch {
+        return 0n;
+    }
+}

package/dist/domains/dex/router.d.ts

@@ -0,0 +1,56 @@
+import { JsonRpcProvider } from 'ethers';
+import type { DirectRouterSignConfig, DexKey, RouterVersion } from './types.js';
+/**
+ * 截断小数位数，避免超过代币精度导致 parseUnits 报错
+ * 例如：truncateDecimals("21906.025000000000000000", 1) => "21906.0"
+ */
+export declare function truncateDecimals(value: string, decimals: number): string;
+/** 获取原生包装代币地址 */
+export declare function getWrappedNative(chain: string): 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;
+export declare function getDeadline(minutes?: number): number;
+export declare function getGasPrice(provider: JsonRpcProvider, config: DirectRouterSignConfig): Promise<bigint>;
+export declare function isNativeToken(quoteToken?: string): boolean;
+/**
+ * 判断是否是 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;
+/**
+ * 根据链和 DEX 获取 Router 地址
+ */
+export declare function getRouterAddress(chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI', dexKey: DexKey, version: RouterVersion): string;

package/dist/domains/dex/router.js

@@ -0,0 +1,193 @@
+import { ethers } from 'ethers';
+import { ZERO_ADDRESS } from '../../core/constants/index.js';
+import { getDeadline as bundleGetDeadline, getOptimizedGasPrice } from '../../utils/bundle-helpers.js';
+import { DEADLINE_MINUTES, DIRECT_ROUTERS } from './direct-router-types.js';
+/**
+ * 截断小数位数，避免超过代币精度导致 parseUnits 报错
+ * 例如：truncateDecimals("21906.025000000000000000", 1) => "21906.0"
+ */
+export function truncateDecimals(value, decimals) {
+    if (!value || decimals < 0)
+        return value;
+    const parts = value.split('.');
+    if (parts.length === 1)
+        return value; // 没有小数点
+    const integerPart = parts[0];
+    const decimalPart = parts[1];
+    if (decimals === 0)
+        return integerPart;
+    // 截断到指定小数位数
+    const truncatedDecimal = decimalPart.slice(0, decimals);
+    // 如果截断后没有小数部分，只返回整数部分
+    if (!truncatedDecimal || truncatedDecimal === '')
+        return integerPart;
+    return `${integerPart}.${truncatedDecimal}`;
+}
+/** 获取原生包装代币地址 */
+export function getWrappedNative(chain) {
+    const chainUpper = chain.toUpperCase();
+    if (chainUpper === 'BSC')
+        return DIRECT_ROUTERS.BSC.WBNB;
+    if (chainUpper === 'MONAD')
+        return DIRECT_ROUTERS.MONAD.WMON;
+    if (chainUpper === 'XLAYER')
+        return DIRECT_ROUTERS.XLAYER.WOKB;
+    if (chainUpper === 'ENI')
+        return DIRECT_ROUTERS.ENI.WEGAS;
+    throw new Error(`Unsupported chain: ${chain}`);
+}
+/**
+ * 判断是否使用旧版 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 function isLegacySwapRouter(chain, routerAddress) {
+    const chainUpper = chain.toUpperCase();
+    const routerLower = routerAddress.toLowerCase();
+    // ✅ Monad 上的所有 V3 Router 都是旧版
+    if (chainUpper === 'MONAD') {
+        if (routerLower === DIRECT_ROUTERS.MONAD.UNISWAP_V3.toLowerCase()) {
+            return true;
+        }
+        if (routerLower === DIRECT_ROUTERS.MONAD.PANCAKESWAP_V3.toLowerCase()) {
+            return true;
+        }
+    }
+    // ✅ XLayer V3 专用 Router 是旧版（exactInputSingle 包含 deadline）
+    if (chainUpper === 'XLAYER') {
+        if (routerLower === DIRECT_ROUTERS.XLAYER.V3_ROUTER.toLowerCase()) {
+            return true; // V3 Router 是旧版
+        }
+        // SwapRouter02 是新版
+        return false;
+    }
+    // ✅ BSC PancakeSwap V3 使用新版 SwapRouter02
+    return false;
+}
+// ✅ 使用公共模块的 getDeadline
+export function getDeadline(minutes = DEADLINE_MINUTES) {
+    return bundleGetDeadline(minutes);
+}
+export async function getGasPrice(provider, config) {
+    if (config.gasPrice)
+        return config.gasPrice;
+    // 转换 Gwei 配置为 Wei
+    const gasPriceConfig = {};
+    if (config.minGasPriceGwei !== undefined) {
+        gasPriceConfig.minGasPrice = ethers.parseUnits(String(config.minGasPriceGwei), 'gwei');
+    }
+    if (config.maxGasPriceGwei !== undefined) {
+        gasPriceConfig.maxGasPrice = ethers.parseUnits(String(config.maxGasPriceGwei), 'gwei');
+    }
+    return getOptimizedGasPrice(provider, gasPriceConfig);
+}
+export function isNativeToken(quoteToken) {
+    return !quoteToken || quoteToken === ZERO_ADDRESS;
+}
+/**
+ * 判断是否是 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 function isSwapRouter02(chain, routerAddress) {
+    const chainUpper = chain.toUpperCase();
+    const addrLower = routerAddress.toLowerCase();
+    if (chainUpper === 'XLAYER') {
+        // ✅ XLayer PotatoSwap SwapRouter02 (V3 风格)
+        if (addrLower === DIRECT_ROUTERS.XLAYER.POTATOSWAP_V3.toLowerCase()) {
+            return true;
+        }
+    }
+    // ❌ XLayer POTATOSWAP_V2 (0x881fb...) 是标准 V2 Router，不走 SwapRouter02 逻辑
+    // ❌ XLayer DYORSWAP_ROUTER 有自己独特的 ABI，不走 SwapRouter02 逻辑
+    // ❌ BSC V2 交易使用传统 PancakeSwap V2 Router，不走 SwapRouter02 逻辑
+    // ❌ Monad V2 交易使用传统 V2 Router，不走 SwapRouter02 逻辑
+    return false;
+}
+/**
+ * 判断是否是 DYORSwap Router
+ *
+ * DYORSwap 使用 multicall，但它的 swapExactTokensForTokens 有特殊的 ABI：
+ * - swapExactTokensForTokens(amountIn, amountOutMin, path[], payer, flags, factory, pools)
+ * - unwrapWETH9(amountMinimum, recipient, pools)
+ */
+export function isDYORSwap(chain, routerAddress) {
+    const chainUpper = chain.toUpperCase();
+    const addrLower = routerAddress.toLowerCase();
+    if (chainUpper === 'XLAYER') {
+        if (addrLower === DIRECT_ROUTERS.XLAYER.DYORSWAP_ROUTER.toLowerCase()) {
+            return true;
+        }
+    }
+    return false;
+}
+// ============================================================================
+// 辅助函数：获取 Router 地址
+// ============================================================================
+/**
+ * 根据链和 DEX 获取 Router 地址
+ */
+export function getRouterAddress(chain, dexKey, version) {
+    const chainUpper = chain.toUpperCase();
+    if (chainUpper === 'BSC') {
+        if (dexKey === 'IROSWAP') {
+            return DIRECT_ROUTERS.BSC.IROSWAP_V2;
+        }
+        if (version === 'v2')
+            return DIRECT_ROUTERS.BSC.PANCAKESWAP_V2;
+        return DIRECT_ROUTERS.BSC.PANCAKESWAP_V3;
+    }
+    if (chainUpper === 'MONAD') {
+        if (dexKey === 'UNISWAP') {
+            if (version === 'v2')
+                return DIRECT_ROUTERS.MONAD.UNISWAP_V2;
+            return DIRECT_ROUTERS.MONAD.UNISWAP_V3;
+        }
+        // PancakeSwap on Monad - 支持 V2 和 V3
+        if (version === 'v2')
+            return DIRECT_ROUTERS.MONAD.PANCAKESWAP_V2;
+        return DIRECT_ROUTERS.MONAD.PANCAKESWAP_V3;
+    }
+    // ✅ XLayer: PotatoSwap 和 DYORSwap 支持
+    if (chainUpper === 'XLAYER') {
+        if (dexKey === 'DYORSWAP') {
+            // DYORSwap 使用 SwapRouter02 风格（multicall）
+            return DIRECT_ROUTERS.XLAYER.DYORSWAP_ROUTER;
+        }
+        // ✅ 修复：根据 version 返回正确的 PotatoSwap Router
+        if (version === 'v3') {
+            return DIRECT_ROUTERS.XLAYER.POTATOSWAP_V3;
+        }
+        return DIRECT_ROUTERS.XLAYER.POTATOSWAP_V2;
+    }
+    if (chainUpper === 'ENI') {
+        if (dexKey === 'IROSWAP') {
+            return DIRECT_ROUTERS.ENI.IROSWAP_V2;
+        }
+        if (version === 'v3') {
+            return DIRECT_ROUTERS.ENI.DSWAP_V3;
+        }
+        return DIRECT_ROUTERS.ENI.DSWAP_V2;
+    }
+    throw new Error(`Unsupported chain/dex combination: ${chain}/${dexKey}`);
+}

package/dist/domains/flap/portal-bundle/batch.d.ts

@@ -0,0 +1,9 @@
+import type { FlapBatchBuyParams, FlapBatchBuyResult, FlapBatchSellParams, FlapBatchSellResult } from './types.js';
+/**
+ * Flap Protocol: 批量购买
+ */
+export declare function batchBuyWithBundle(params: FlapBatchBuyParams): Promise<FlapBatchBuyResult>;
+/**
+ * Flap Protocol: 批量卖出
+ */
+export declare function batchSellWithBundle(params: FlapBatchSellParams): Promise<FlapBatchSellResult>;