four-flap-meme-sdk 1.9.49 → 2.0.0

package/dist/chains/xlayer/eoa/eoa-bundle-swap.js

@@ -1,233 +1,19 @@
 /**
- * XLayer EOA 模式批量换手
- *
- * 专门为 XLayer 链设计，不影响 BSC 链的逻辑
- * - 使用 PotatoSwap V3 Quoter
- * - 使用 WOKB 作为 Wrapped Native Token
- * - 支持多跳转账和利润刮取
+ * eoa-bundle-swap - 主函数
  */
 import { ethers, Contract, Wallet } from 'ethers';
 import { calculateSellAmount } from '../../../utils/swap-helpers.js';
-import { NonceManager, getDeadline, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../../utils/bundle-helpers.js';
-import { PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA } from '../../../utils/constants.js';
-import { GAS_LIMITS, CHAINS } from '../../../shared/constants/index.js';
-import { quoteV2, quoteV3 } from '../../../utils/quote-helpers.js';
-import { V2_ROUTER_ABI, V3_ROUTER02_ABI } from '../../../shared/abis/common.js';
-import { generateWallets } from '../../../utils/wallet.js';
-// ✅ 从 XLayer 常量导入正确的路由地址
-import { POTATOSWAP_V2_ROUTER, POTATOSWAP_SWAP_ROUTER02, WOKB as WOKB_CONST } from './constants.js';
-// ==================== XLayer 专用常量 ====================
-const XLAYER_CHAIN_ID = CHAINS.XLAYER.chainId;
-const XLAYER_CHAIN_NAME = CHAINS.XLAYER.name;
-const WOKB_ADDRESS = ethers.getAddress(WOKB_CONST);
-// ✅ 强制校验和，避免大小写错误导致的 bad address checksum
-const POTATO_V2_ROUTER = ethers.getAddress(POTATOSWAP_V2_ROUTER);
-const POTATO_V3_ROUTER = ethers.getAddress(POTATOSWAP_SWAP_ROUTER02); // ✅ SwapRouter02 用于 V3 交易
-const NATIVE_TRANSFER_GAS_LIMIT = GAS_LIMITS.NATIVE_TRANSFER;
-const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
-// ==================== 工具函数 ====================
-function createXLayerContext(config) {
-    const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
-        chainId: XLAYER_CHAIN_ID,
-        name: 'XLayer'
-    });
-    return { chainId: XLAYER_CHAIN_ID, provider };
-}
-function getGasLimit(config, defaultGas = 800000) {
-    if (config.gasLimit !== undefined) {
-        return typeof config.gasLimit === 'bigint' ? config.gasLimit : BigInt(config.gasLimit);
-    }
-    const multiplier = config.gasLimitMultiplier ?? 1.0;
-    return BigInt(Math.ceil(defaultGas * multiplier));
-}
-async function getGasPrice(provider, config) {
-    const feeData = await provider.getFeeData();
-    let gasPrice = feeData.gasPrice || ethers.parseUnits('0.1', 'gwei');
-    if (config.minGasPriceGwei) {
-        const minGas = ethers.parseUnits(config.minGasPriceGwei.toString(), 'gwei');
-        if (gasPrice < minGas)
-            gasPrice = minGas;
-    }
-    if (config.maxGasPriceGwei) {
-        const maxGas = ethers.parseUnits(config.maxGasPriceGwei.toString(), 'gwei');
-        if (gasPrice > maxGas)
-            gasPrice = maxGas;
-    }
-    return gasPrice;
-}
-function getProfitRateBps(userType) {
-    if (userType === 'v0')
-        return PROFIT_CONFIG.RATE_BPS_V0;
-    if (userType === 'v1')
-        return PROFIT_CONFIG.RATE_BPS_V1;
-    return PROFIT_CONFIG.RATE_BPS_V0;
-}
-function calculateProfitAmount(estimatedOutput, userType) {
-    if (estimatedOutput <= 0n)
-        return 0n;
-    const rateBps = getProfitRateBps(userType);
-    return (estimatedOutput * BigInt(rateBps)) / 10000n;
-}
-// ==================== 报价函数 ====================
-async function quoteSellOutput(provider, routeParams, sellAmountWei) {
-    if (routeParams.routeType === 'v2') {
-        const { v2Path } = routeParams;
-        const tokenIn = v2Path[0];
-        const tokenOut = v2Path[v2Path.length - 1];
-        const result = await quoteV2(provider, tokenIn, tokenOut, sellAmountWei, XLAYER_CHAIN_NAME);
-        if (result.amountOut > 0n) {
-            return result.amountOut;
-        }
-        throw new Error('V2 报价失败');
-    }
-    if (routeParams.routeType === 'v3-single') {
-        const params = routeParams;
-        const result = await quoteV3(provider, params.v3TokenIn, params.v3TokenOut, sellAmountWei, XLAYER_CHAIN_NAME, params.v3Fee);
-        if (result.amountOut > 0n) {
-            return result.amountOut;
-        }
-        // ❗️兜底：如果 V3 报价失败且提供了 v2Path，则尝试 V2 报价（避免因为无对应费率池导致失败）
-        if (params.v2Path && params.v2Path.length >= 2) {
-            const tokenIn = params.v2Path[0];
-            const tokenOut = params.v2Path[params.v2Path.length - 1];
-            const v2Result = await quoteV2(provider, tokenIn, tokenOut, sellAmountWei, XLAYER_CHAIN_NAME);
-            if (v2Result.amountOut > 0n) {
-                return v2Result.amountOut;
-            }
-        }
-        throw new Error(`V3 单跳报价失败: tokenIn=${params.v3TokenIn}, tokenOut=${params.v3TokenOut}, fee=${params.v3Fee}`);
-    }
-    if (routeParams.routeType === 'v3-multi') {
-        const params = routeParams;
-        const tokenIn = params.v3ExactTokenIn;
-        const result = await quoteV3(provider, tokenIn, WOKB_ADDRESS, sellAmountWei, XLAYER_CHAIN_NAME);
-        if (result.amountOut > 0n) {
-            return result.amountOut;
-        }
-        // ❗️兜底：如果 V3 多跳失败且提供 v2Path，则尝试 V2 报价
-        if (params.v2Path && params.v2Path.length >= 2) {
-            const tokenInV2 = params.v2Path[0];
-            const tokenOutV2 = params.v2Path[params.v2Path.length - 1];
-            const v2Result = await quoteV2(provider, tokenInV2, tokenOutV2, sellAmountWei, XLAYER_CHAIN_NAME);
-            if (v2Result.amountOut > 0n) {
-                return v2Result.amountOut;
-            }
-        }
-        throw new Error(`V3 多跳报价失败`);
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    throw new Error(`不支持的路由类型: ${routeParams.routeType}`);
-}
-async function getERC20ToOkbQuote(provider, tokenAddress, tokenAmount, version = 'v2', fee) {
-    if (tokenAmount <= 0n)
-        return 0n;
-    const tokenLower = tokenAddress.toLowerCase();
-    const wokbLower = WOKB_ADDRESS.toLowerCase();
-    if (tokenLower === wokbLower)
-        return tokenAmount;
-    if (version === 'v3') {
-        const result = await quoteV3(provider, tokenAddress, WOKB_ADDRESS, tokenAmount, XLAYER_CHAIN_NAME, fee);
-        if (result.amountOut > 0n) {
-            return result.amountOut;
-        }
-        return 0n;
-    }
-    const result = await quoteV2(provider, tokenAddress, WOKB_ADDRESS, tokenAmount, XLAYER_CHAIN_NAME);
-    if (result.amountOut > 0n) {
-        return result.amountOut;
-    }
-    return 0n;
-}
-function generateDisperseHopPaths(targetAddresses, hopCount, provider) {
-    if (hopCount <= 0) {
-        return targetAddresses.map(addr => ({
-            targetAddress: addr,
-            hopWallets: [],
-            hopWalletsInfo: []
-        }));
-    }
-    return targetAddresses.map(targetAddress => {
-        const hopWalletsInfo = generateWallets(hopCount);
-        const hopWallets = hopWalletsInfo.map(w => new Wallet(w.privateKey, provider));
-        return { targetAddress, hopWallets, hopWalletsInfo };
-    });
-}
-async function buildNativeHopChain(payer, path, finalAmount, gasPrice, txType, payerNonce) {
-    const signedTxs = [];
-    const hopCount = path.hopWallets.length;
-    if (hopCount === 0) {
-        const tx = {
-            to: path.targetAddress,
-            value: finalAmount,
-            nonce: payerNonce,
-            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-            chainId: XLAYER_CHAIN_ID,
-            type: txType
-        };
-        if (txType === 2) {
-            tx.maxFeePerGas = gasPrice;
-            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
-        }
-        else {
-            tx.gasPrice = gasPrice;
-        }
-        signedTxs.push(await payer.signTransaction(tx));
-        return signedTxs;
-    }
-    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
-    const amountsPerHop = [];
-    for (let i = 0; i < hopCount; i++) {
-        const remainingHops = hopCount - i;
-        amountsPerHop.push(finalAmount + hopGasCost * BigInt(remainingHops));
-    }
-    // payer → hop1
-    const firstTx = {
-        to: path.hopWallets[0].address,
-        value: amountsPerHop[0],
-        nonce: payerNonce,
-        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-        chainId: XLAYER_CHAIN_ID,
-        type: txType
-    };
-    if (txType === 2) {
-        firstTx.maxFeePerGas = gasPrice;
-        firstTx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
-    }
-    else {
-        firstTx.gasPrice = gasPrice;
-    }
-    signedTxs.push(await payer.signTransaction(firstTx));
-    // hop1 → hop2 → ... → target
-    for (let i = 0; i < hopCount; i++) {
-        const fromWallet = path.hopWallets[i];
-        const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
-        const amount = i === hopCount - 1 ? finalAmount : amountsPerHop[i + 1];
-        const tx = {
-            to: toAddress,
-            value: amount,
-            nonce: 0,
-            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-            chainId: XLAYER_CHAIN_ID,
-            type: txType
-        };
-        if (txType === 2) {
-            tx.maxFeePerGas = gasPrice;
-            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
-        }
-        else {
-            tx.gasPrice = gasPrice;
-        }
-        signedTxs.push(await fromWallet.signTransaction(tx));
-    }
-    return signedTxs;
-}
-// ==================== XLayer 快捷批量换手 ====================
+import { NonceManager, getDeadline, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../../utils/bundle-helpers.js';
+import { BLOCKRAZOR_BUILDER_EOA, getProfitRecipient } from '../../../shared/constants/index.js';
+import { GAS_LIMITS } from '../../../shared/constants/index.js';
+import { V2_ROUTER_ABI, V3_ROUTER02_ABI } from '../../../abis/common.js';
+import { NATIVE_TRANSFER_GAS_LIMIT, POTATO_V2_ROUTER, POTATO_V3_ROUTER, WOKB_ADDRESS, XLAYER_CHAIN_ID, ZERO_ADDRESS, buildNativeHopChain, calculateProfitAmount, createXLayerContext, generateDisperseHopPaths, getERC20ToOkbQuote, getGasLimit, getGasPrice, quoteSellOutput, } from './eoa-bundle-swap-helpers.js';
 export async function xlayerQuickBatchSwapMerkle(params) {
-    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, disperseHopCount = 0, startNonces } = params;
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, disperseHopCount = 0, startNonces, } = params;
     const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
     const context = createXLayerContext(config);
     const seller = new Wallet(sellerPrivateKey, context.provider);
-    const buyers = buyerPrivateKeys.map(pk => new Wallet(pk, context.provider));
+    const buyers = buyerPrivateKeys.map((pk) => new Wallet(pk, context.provider));
     // 校验卖出路径输出代币
     let sellOutputToken;
     if (routeParams.routeType === 'v2') {
@@ -256,7 +42,7 @@ export async function xlayerQuickBatchSwapMerkle(params) {
     const txType = config.txType ?? 0;
     const [gasPrice, sellAmountResult] = await Promise.all([
         getGasPrice(context.provider, config),
-        calculateSellAmount(context.provider, tokenAddress, seller.address, sellAmount, sellPercentage)
+        calculateSellAmount(context.provider, tokenAddress, seller.address, sellAmount, sellPercentage),
     ]);
     const { amount: sellAmountWei, decimals } = sellAmountResult;
     // 获取卖出报价
@@ -276,22 +62,18 @@ export async function xlayerQuickBatchSwapMerkle(params) {
     // 计算每个买方分到的金额
     let transferAmountsWei;
     if (buyerAmounts && buyerAmounts.length === buyers.length) {
-        transferAmountsWei = buyerAmounts.map(amt => useNativeToken ? ethers.parseEther(amt) : ethers.parseUnits(amt, quoteTokenDecimals));
+        transferAmountsWei = buyerAmounts.map((amt) => useNativeToken ? ethers.parseEther(amt) : ethers.parseUnits(amt, quoteTokenDecimals));
     }
     else if (buyerRatios && buyerRatios.length === buyers.length) {
-        transferAmountsWei = buyerRatios.map(ratio => (distributableAmount * BigInt(Math.round(ratio * 10000))) / 10000n);
+        transferAmountsWei = buyerRatios.map((ratio) => (distributableAmount * BigInt(Math.round(ratio * 10000))) / 10000n);
     }
     else {
         throw new Error('必须提供 buyerRatios 或 buyerAmounts');
     }
     // 获取贿赂金额
-    const bribeAmount = config.bribeAmount && config.bribeAmount > 0
-        ? ethers.parseEther(String(config.bribeAmount))
-        : 0n;
+    const bribeAmount = config.bribeAmount && config.bribeAmount > 0 ? ethers.parseEther(String(config.bribeAmount)) : 0n;
     // 规划 Nonce
-    let sellerNonce = startNonces && startNonces.length > 0
-        ? startNonces[0]
-        : await nonceManager.getNextNonce(seller);
+    let sellerNonce = startNonces && startNonces.length > 0 ? startNonces[0] : await nonceManager.getNextNonce(seller);
     const deadline = getDeadline();
     // 1. 贿赂交易
     let bribeTx = null;
@@ -303,7 +85,7 @@ export async function xlayerQuickBatchSwapMerkle(params) {
             gasPrice,
             gasLimit: GAS_LIMITS.BRIBE,
             chainId: XLAYER_CHAIN_ID,
-            type: txType
+            type: txType,
         });
     }
     // 2. 卖出交易
@@ -322,15 +104,17 @@ export async function xlayerQuickBatchSwapMerkle(params) {
     else if (routeParams.routeType === 'v3-single') {
         const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
         const v3RouterSeller = new Contract(POTATO_V3_ROUTER, V3_ROUTER02_ABI, seller);
-        const sellSwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
+        const sellSwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [
+            {
                 tokenIn: v3TokenIn,
                 tokenOut: v3TokenOut,
                 fee: v3Fee,
                 recipient: useNativeToken ? POTATO_V3_ROUTER : seller.address,
                 amountIn: sellAmountWei,
                 amountOutMinimum: 0n,
-                sqrtPriceLimitX96: 0n
-            }]);
+                sqrtPriceLimitX96: 0n,
+            },
+        ]);
         if (useNativeToken) {
             const sellUnwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [0n, seller.address]);
             sellUnsigned = await v3RouterSeller.multicall.populateTransaction(deadline, [sellSwapData, sellUnwrapData]);
@@ -349,13 +133,13 @@ export async function xlayerQuickBatchSwapMerkle(params) {
         gasLimit: finalGasLimit,
         gasPrice,
         chainId: XLAYER_CHAIN_ID,
-        type: txType
+        type: txType,
     });
     // 3. 转账交易
     const buyerGasCost = gasPrice * finalGasLimit;
-    const hopPaths = generateDisperseHopPaths(buyers.map(b => b.address), disperseHopCount, context.provider);
+    const hopPaths = generateDisperseHopPaths(buyers.map((b) => b.address), disperseHopCount, context.provider);
     const allHopWallets = [];
-    hopPaths.forEach(path => allHopWallets.push(...path.hopWalletsInfo));
+    hopPaths.forEach((path) => allHopWallets.push(...path.hopWalletsInfo));
     let transferTxs;
     if (disperseHopCount === 0) {
         const transferNonces = buyers.map((_, i) => sellerNonce + i);
@@ -369,7 +153,7 @@ export async function xlayerQuickBatchSwapMerkle(params) {
                 gasPrice,
                 gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
                 chainId: XLAYER_CHAIN_ID,
-                type: txType
+                type: txType,
             });
         }));
     }
@@ -385,7 +169,7 @@ export async function xlayerQuickBatchSwapMerkle(params) {
     // 4. 买入交易
     const buyerNonces = startNonces && startNonces.length > 1
         ? startNonces.slice(1)
-        : await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
+        : await Promise.all(buyers.map((buyer) => nonceManager.getNextNonce(buyer)));
     const signedBuys = await Promise.all(buyers.map(async (buyer, i) => {
         const buyAmount = transferAmountsWei[i];
         const buyValue = useNativeToken ? buyAmount : 0n;
@@ -404,15 +188,17 @@ export async function xlayerQuickBatchSwapMerkle(params) {
         else if (routeParams.routeType === 'v3-single') {
             const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
             const v3RouterBuyer = new Contract(POTATO_V3_ROUTER, V3_ROUTER02_ABI, buyer);
-            const buySwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
+            const buySwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [
+                {
                     tokenIn: v3TokenOut,
                     tokenOut: v3TokenIn,
                     fee: v3Fee,
                     recipient: buyer.address,
                     amountIn: buyAmount,
                     amountOutMinimum: 0n,
-                    sqrtPriceLimitX96: 0n
-                }]);
+                    sqrtPriceLimitX96: 0n,
+                },
+            ]);
             buyUnsigned = await v3RouterBuyer.multicall.populateTransaction(deadline, [buySwapData], { value: buyValue });
         }
         else {
@@ -425,7 +211,7 @@ export async function xlayerQuickBatchSwapMerkle(params) {
             gasLimit: finalGasLimit,
             gasPrice,
             chainId: XLAYER_CHAIN_ID,
-            type: txType
+            type: txType,
         });
     }));
     nonceManager.clearTemp();
@@ -443,12 +229,12 @@ export async function xlayerQuickBatchSwapMerkle(params) {
             provider: context.provider,
             payerWallet: seller,
             profitAmount,
-            profitRecipient: PROFIT_CONFIG.RECIPIENT,
+            profitRecipient: getProfitRecipient(),
             hopCount: PROFIT_HOP_COUNT,
             gasPrice,
             chainId: XLAYER_CHAIN_ID,
             txType,
-            startNonce: sellerNonce++
+            startNonce: sellerNonce++,
         });
         signedTransactions.push(...profitHopResult.signedTransactions);
         profitHopWallets = profitHopResult.hopWallets;
@@ -459,19 +245,19 @@ export async function xlayerQuickBatchSwapMerkle(params) {
         profitHopWallets,
         metadata: {
             sellerAddress: seller.address,
-            buyerAddresses: buyers.map(b => b.address),
+            buyerAddresses: buyers.map((b) => b.address),
             sellAmount: ethers.formatUnits(sellAmountWei, decimals),
             estimatedOutput: ethers.formatEther(estimatedOutput),
-            transferAmounts: transferAmountsWei.map(amt => ethers.formatEther(amt)),
+            transferAmounts: transferAmountsWei.map((amt) => ethers.formatEther(amt)),
             profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
             useNativeToken,
-            disperseHopCount: disperseHopCount > 0 ? disperseHopCount : undefined
-        }
+            disperseHopCount: disperseHopCount > 0 ? disperseHopCount : undefined,
+        },
     };
 }
 // ==================== XLayer 交叉换手 ====================
 export async function xlayerCrossSwapMerkle(params) {
-    const { sellerPrivateKeys, sellAmounts, buyerPrivateKeys, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, buyersPerSell, disperseHopCount = 0, startNonces: inputNonces } = params;
+    const { sellerPrivateKeys, sellAmounts, buyerPrivateKeys, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, buyersPerSell, disperseHopCount = 0, startNonces: inputNonces, } = params;
     if (sellerPrivateKeys.length === 0)
         throw new Error('至少需要一个卖方');
     if (sellerPrivateKeys.length !== sellAmounts.length)
@@ -480,8 +266,8 @@ export async function xlayerCrossSwapMerkle(params) {
         throw new Error('至少需要一个买方');
     const context = createXLayerContext(config);
     const nonceManager = new NonceManager(context.provider);
-    const allSellerWallets = sellerPrivateKeys.map(pk => new Wallet(pk, context.provider));
-    const allBuyerWallets = buyerPrivateKeys.map(pk => new Wallet(pk, context.provider));
+    const allSellerWallets = sellerPrivateKeys.map((pk) => new Wallet(pk, context.provider));
+    const allBuyerWallets = buyerPrivateKeys.map((pk) => new Wallet(pk, context.provider));
     // ✅ 优先使用前端传入的 nonce，避免 nonce 不同步
     const addressToNonce = new Map();
     for (const wallet of allSellerWallets) {
@@ -512,9 +298,7 @@ export async function xlayerCrossSwapMerkle(params) {
     const rounds = [];
     let buyerCursor = 0;
     const buyerBatchSize = Math.max(1, buyersPerSell ?? buyerPrivateKeys.length);
-    const bribeAmount = config.bribeAmount && config.bribeAmount > 0
-        ? ethers.parseEther(String(config.bribeAmount))
-        : 0n;
+    const bribeAmount = config.bribeAmount && config.bribeAmount > 0 ? ethers.parseEther(String(config.bribeAmount)) : 0n;
     const hasBribe = bribeAmount > 0n;
     for (let i = 0; i < sellerPrivateKeys.length; i++) {
         const sellerPk = sellerPrivateKeys[i];
@@ -529,7 +313,7 @@ export async function xlayerCrossSwapMerkle(params) {
             buyerCursor++;
         }
         const sellerNonce = addressToNonce.get(sellerWallet.address);
-        const roundBuyerNonces = roundBuyerWallets.map(w => {
+        const roundBuyerNonces = roundBuyerWallets.map((w) => {
             const nonce = addressToNonce.get(w.address);
             addressToNonce.set(w.address, nonce + 1);
             return nonce;
@@ -555,7 +339,7 @@ export async function xlayerCrossSwapMerkle(params) {
             quoteToken,
             quoteTokenDecimals,
             disperseHopCount,
-            startNonces
+            startNonces,
         });
         addressToNonce.set(sellerWallet.address, sellerNonce + sellerNonceConsumed);
         allSigned.push(...res.signedTransactions);
@@ -567,7 +351,7 @@ export async function xlayerCrossSwapMerkle(params) {
             sellerAddress: res.metadata?.sellerAddress || '',
             buyerAddresses: res.metadata?.buyerAddresses || [],
             sellAmount,
-            bundleHash: undefined
+            bundleHash: undefined,
         });
     }
     nonceManager.clearTemp();
@@ -575,7 +359,7 @@ export async function xlayerCrossSwapMerkle(params) {
         signedTransactions: allSigned,
         rounds,
         disperseHopWallets: allDisperse.length > 0 ? allDisperse : undefined,
-        profitHopWallets: allProfit.length > 0 ? allProfit : undefined
+        profitHopWallets: allProfit.length > 0 ? allProfit : undefined,
     };
 }
 /**
@@ -589,7 +373,7 @@ export async function xlayerCrossSwapMerkle(params) {
  * 交易顺序：卖1 → 买1 → 卖2 → 买2 → ... (交替执行)
  */
 export async function xlayerPureCrossSwapMerkle(params) {
-    const { sellerPrivateKeys, sellAmounts, buyerPrivateKeys, buyAmounts, tokenAddress, routeParams, config, quoteToken, startNonces: inputNonces } = params;
+    const { sellerPrivateKeys, sellAmounts, buyerPrivateKeys, buyAmounts, tokenAddress, routeParams, config, quoteToken, startNonces: inputNonces, } = params;
     if (sellerPrivateKeys.length === 0)
         throw new Error('至少需要一个卖方');
     if (sellerPrivateKeys.length !== sellAmounts.length)
@@ -601,8 +385,8 @@ export async function xlayerPureCrossSwapMerkle(params) {
     const context = createXLayerContext(config);
     const nonceManager = new NonceManager(context.provider);
     const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
-    const sellers = sellerPrivateKeys.map(pk => new Wallet(pk, context.provider));
-    const buyers = buyerPrivateKeys.map(pk => new Wallet(pk, context.provider));
+    const sellers = sellerPrivateKeys.map((pk) => new Wallet(pk, context.provider));
+    const buyers = buyerPrivateKeys.map((pk) => new Wallet(pk, context.provider));
     // 获取 nonce
     const addressToNonce = new Map();
     for (const wallet of [...sellers, ...buyers]) {
@@ -618,7 +402,7 @@ export async function xlayerPureCrossSwapMerkle(params) {
     }
     const [gasPrice, finalGasLimit] = await Promise.all([
         getGasPrice(context.provider, config),
-        Promise.resolve(getGasLimit(config))
+        Promise.resolve(getGasLimit(config)),
     ]);
     const txType = config.txType ?? 0;
     const deadline = getDeadline();
@@ -646,15 +430,17 @@ export async function xlayerPureCrossSwapMerkle(params) {
         else if (routeParams.routeType === 'v3-single') {
             const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
             const v3Router = new Contract(POTATO_V3_ROUTER, V3_ROUTER02_ABI, seller);
-            const sellSwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
+            const sellSwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [
+                {
                     tokenIn: v3TokenIn,
                     tokenOut: v3TokenOut,
                     fee: v3Fee,
                     recipient: useNativeToken ? POTATO_V3_ROUTER : seller.address,
                     amountIn: sellAmountWei,
                     amountOutMinimum: 0n,
-                    sqrtPriceLimitX96: 0n
-                }]);
+                    sqrtPriceLimitX96: 0n,
+                },
+            ]);
             if (useNativeToken) {
                 const sellUnwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [0n, seller.address]);
                 sellUnsigned = await v3Router.multicall.populateTransaction(deadline, [sellSwapData, sellUnwrapData]);
@@ -673,7 +459,7 @@ export async function xlayerPureCrossSwapMerkle(params) {
             gasLimit: finalGasLimit,
             gasPrice,
             chainId: XLAYER_CHAIN_ID,
-            type: txType
+            type: txType,
         });
         signedTransactions.push(signedSell);
     }
@@ -700,15 +486,17 @@ export async function xlayerPureCrossSwapMerkle(params) {
         else if (routeParams.routeType === 'v3-single') {
             const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
             const v3Router = new Contract(POTATO_V3_ROUTER, V3_ROUTER02_ABI, buyer);
-            const buySwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
+            const buySwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [
+                {
                     tokenIn: v3TokenOut, // 买入时反过来
                     tokenOut: v3TokenIn,
                     fee: v3Fee,
                     recipient: buyer.address,
                     amountIn: buyAmountWei,
                     amountOutMinimum: 0n,
-                    sqrtPriceLimitX96: 0n
-                }]);
+                    sqrtPriceLimitX96: 0n,
+                },
+            ]);
             buyUnsigned = await v3Router.multicall.populateTransaction(deadline, [buySwapData], { value: buyValue });
         }
         else {
@@ -721,17 +509,17 @@ export async function xlayerPureCrossSwapMerkle(params) {
             gasLimit: finalGasLimit,
             gasPrice,
             chainId: XLAYER_CHAIN_ID,
-            type: txType
+            type: txType,
         });
         signedTransactions.push(signedBuy);
     }
     return {
         signedTransactions,
         metadata: {
-            sellerAddresses: sellers.map(s => s.address),
-            buyerAddresses: buyers.map(b => b.address),
+            sellerAddresses: sellers.map((s) => s.address),
+            buyerAddresses: buyers.map((b) => b.address),
             sellAmounts,
-            buyAmounts
-        }
+            buyAmounts,
+        },
     };
 }

package/dist/chains/xlayer/eoa/eoa-wash-volume.d.ts

@@ -11,7 +11,7 @@
  * 支持池子类型：V2, V3
  */
 import { Wallet } from 'ethers';
-import type { DirectRouterSignConfig } from '../../../dex/direct-router.js';
+import type { DirectRouterSignConfig } from '../../../dex/types.js';
 export type EoaWashPoolType = 'V2' | 'V3';
 export interface EoaWashVolumeParams {
     /** 代币地址 */

package/dist/chains/xlayer/eoa/eoa-wash-volume.js

@@ -11,7 +11,8 @@
  * 支持池子类型：V2, V3
  */
 import { ethers, Wallet, Contract } from 'ethers';
-import { directV2BatchBuy, directV2BatchSell, directV3BatchBuy, directV3BatchSell } from '../../../dex/direct-router.js';
+import { createXLayerProvider } from '../../../utils/provider-factory.js';
+import { directV2BatchBuy, directV2BatchSell, directV3BatchBuy, directV3BatchSell, } from '../../../dex/direct-router.js';
 import { getProfitRecipient } from '../../../shared/constants/index.js';
 // ============================================================================
 // 辅助函数
@@ -54,8 +55,8 @@ export async function signEoaWashBuyTransactions(params) {
         throw new Error('[signEoaWashBuyTransactions] 私钥数量与买入金额数量不一致');
     }
     // 创建钱包
-    const provider = new ethers.JsonRpcProvider(config.rpcUrl);
-    const wallets = privateKeys.map(pk => new Wallet(pk, provider));
+    const provider = createXLayerProvider(config.rpcUrl);
+    const wallets = privateKeys.map((pk) => new Wallet(pk, provider));
     let result;
     if (poolType === 'V2') {
         result = await directV2BatchBuy({
@@ -69,7 +70,7 @@ export async function signEoaWashBuyTransactions(params) {
             config: {
                 ...config,
                 skipProfit: true, // 买入时不刮取利润（卖出时刮取）
-            }
+            },
         });
     }
     else {
@@ -86,7 +87,7 @@ export async function signEoaWashBuyTransactions(params) {
             config: {
                 ...config,
                 skipProfit: true, // 买入时不刮取利润（卖出时刮取）
-            }
+            },
         });
     }
     return {
@@ -106,13 +107,13 @@ export async function signEoaWashBuyTransactions(params) {
  */
 export async function signEoaWashSellTransactions(params, wallets, tokenDecimals) {
     const { tokenAddress, poolType, routerAddress, quoteToken, config } = params;
-    const provider = new ethers.JsonRpcProvider(config.rpcUrl);
+    const provider = createXLayerProvider(config.rpcUrl);
     // 获取代币精度
-    const decimals = tokenDecimals ?? await getTokenDecimals(provider, tokenAddress);
+    const decimals = tokenDecimals ?? (await getTokenDecimals(provider, tokenAddress));
     // 查询所有钱包的代币余额
-    const balancesWei = await Promise.all(wallets.map(w => getTokenBalance(provider, tokenAddress, w.address)));
+    const balancesWei = await Promise.all(wallets.map((w) => getTokenBalance(provider, tokenAddress, w.address)));
     // 转换为格式化金额
-    const sellAmounts = balancesWei.map(balance => {
+    const sellAmounts = balancesWei.map((balance) => {
         if (balance <= 0n)
             return '0';
         return ethers.formatUnits(balance, decimals);
@@ -123,7 +124,6 @@ export async function signEoaWashSellTransactions(params, wallets, tokenDecimals
         .filter(({ amt }) => parseFloat(amt) > 0)
         .map(({ i }) => i);
     if (validIndices.length === 0) {
-        console.warn('[signEoaWashSellTransactions] 所有钱包余额为 0，无法卖出');
         return {
             signedTransactions: [],
             profitHopWallets: [],
@@ -131,8 +131,8 @@ export async function signEoaWashSellTransactions(params, wallets, tokenDecimals
             profitRecipient: getProfitRecipient(),
         };
     }
-    const validPrivateKeys = validIndices.map(i => wallets[i].privateKey);
-    const validSellAmounts = validIndices.map(i => sellAmounts[i]);
+    const validPrivateKeys = validIndices.map((i) => wallets[i].privateKey);
+    const validSellAmounts = validIndices.map((i) => sellAmounts[i]);
     let result;
     if (poolType === 'V2') {
         result = await directV2BatchSell({
@@ -145,7 +145,7 @@ export async function signEoaWashSellTransactions(params, wallets, tokenDecimals
             config: {
                 ...config,
                 // ✅ 卖出时正常刮取利润（XLayer 不使用多跳，直接转账）
-            }
+            },
         });
     }
     else {
@@ -161,7 +161,7 @@ export async function signEoaWashSellTransactions(params, wallets, tokenDecimals
             config: {
                 ...config,
                 // ✅ 卖出时正常刮取利润（XLayer 不使用多跳，直接转账）
-            }
+            },
         });
     }
     return {