four-flap-meme-sdk 1.6.97 → 1.6.99

package/dist/index.d.ts

@@ -40,8 +40,8 @@ export { privateSaleMerkle, batchPrivateSaleMerkle, type PrivateSaleSignConfig,
 export { inspectTokenLP, getFactoryFromRouter, registerDYORSwap, registerDex, getChainConfig, type LPInfo, type LPPlatform, type InspectOptions, type DexConfig, type ChainDexConfig, } from './utils/lp-inspect.js';
 export { disperseWithBundle, sweepWithBundle, type DisperseSignParams, type SweepSignParams, type SignedTransactionsResult, type DisperseParams, type SweepParams, type BundleSubmitResult } from './utils/airdrop-sweep.js';
 export { fourBundleSwapMerkle, fourBatchSwapMerkle, fourQuickBatchSwapMerkle, type FourSwapSignConfig, type FourSwapConfig, type FourBundleSwapSignParams, type FourBundleSwapParams, type FourSwapResult, type FourBatchSwapSignParams, type FourBatchSwapResult, type FourQuickBatchSwapSignParams, type FourQuickBatchSwapResult } from './contracts/tm-bundle-merkle/swap.js';
-export { flapBundleSwapMerkle, flapBatchSwapMerkle, flapQuickBatchSwapMerkle, type FlapSwapSignConfig, type FlapSwapConfig, type FlapBundleSwapSignParams, type FlapBundleSwapParams, type FlapSwapResult, type FlapBatchSwapSignParams, type FlapBatchSwapResult, type FlapQuickBatchSwapSignParams, type FlapQuickBatchSwapResult } from './flap/portal-bundle-merkle/swap.js';
-export { pancakeBundleSwapMerkle, pancakeBatchSwapMerkle, pancakeQuickBatchSwapMerkle, type PancakeSwapSignConfig, type PancakeBundleSwapSignParams, type PancakeSwapConfig, type PancakeBundleSwapParams, type PancakeSwapResult, type PancakeBatchSwapSignParams, type PancakeBatchSwapResult, type PancakeQuickBatchSwapParams, type PancakeQuickBatchSwapResult, type SwapRouteType, type V2RouteParams, type V3SingleRouteParams, type V3MultiRouteParams, type RouteParams } from './pancake/bundle-swap.js';
+export { flapBundleSwapMerkle, flapBatchSwapMerkle, flapQuickBatchSwapMerkle, flapCrossSwapMerkle, type FlapSwapSignConfig, type FlapSwapConfig, type FlapBundleSwapSignParams, type FlapBundleSwapParams, type FlapSwapResult, type FlapBatchSwapSignParams, type FlapBatchSwapResult, type FlapQuickBatchSwapSignParams, type FlapQuickBatchSwapResult, type FlapCrossSwapParams, type FlapCrossSwapResult } from './flap/portal-bundle-merkle/swap.js';
+export { pancakeBundleSwapMerkle, pancakeBatchSwapMerkle, pancakeQuickBatchSwapMerkle, pancakeCrossSwapMerkle, type PancakeSwapSignConfig, type PancakeBundleSwapSignParams, type PancakeSwapConfig, type PancakeBundleSwapParams, type PancakeSwapResult, type PancakeBatchSwapSignParams, type PancakeBatchSwapResult, type PancakeQuickBatchSwapParams, type PancakeQuickBatchSwapResult, type PancakeCrossSwapParams, type PancakeCrossSwapResult, type SwapRouteType, type V2RouteParams, type V3SingleRouteParams, type V3MultiRouteParams, type RouteParams } from './pancake/bundle-swap.js';
 export { fourBundleBuyFirstMerkle, type FourBuyFirstConfig, type FourBundleBuyFirstParams, type FourBuyFirstSignConfig, type FourBundleBuyFirstSignParams, type FourBuyFirstResult } from './contracts/tm-bundle-merkle/swap-buy-first.js';
 export { flapBundleBuyFirstMerkle, type FlapBuyFirstSignConfig, type FlapBuyFirstConfig, type FlapBundleBuyFirstSignParams, type FlapBundleBuyFirstParams, type FlapBuyFirstResult } from './flap/portal-bundle-merkle/swap-buy-first.js';
 export { pancakeBundleBuyFirstMerkle, type PancakeBuyFirstSignConfig, type PancakeBuyFirstConfig, type PancakeBundleBuyFirstSignParams, type PancakeBundleBuyFirstParams, type PancakeBuyFirstResult } from './pancake/bundle-buy-first.js';
@@ -54,4 +54,4 @@ submitDirectToRpcSequentialNoWait, // ✅ 顺序广播但不等待确认（用
 submitDirectToRpcParallel, type DirectSubmitConfig, type DirectSubmitResult, type DirectTxResult } from './contracts/tm-bundle-merkle/submit.js';
 export { directV2BatchBuy, directV2BatchSell, directV3BatchBuy, directV3BatchSell, getRouterAddress, DIRECT_ROUTERS, type DirectV2BuyParams, type DirectV2SellParams, type DirectV3BuyParams, type DirectV3SellParams, type DirectRouterResult, type DirectRouterSignConfig, type DexKey, type RouterVersion, } from './dex/index.js';
 export * as XLayer from './xlayer/index.js';
-export { bundleBuy as xlayerBundleBuy, bundleSell as xlayerBundleSell, bundleBuySell as xlayerBundleBuySell, bundleCreateBuySign as xlayerBundleCreateBuySign, bundleCreateToDexSign as xlayerBundleCreateToDexSign, bundleGraduateBuy as xlayerBundleGraduateBuy, bundleSwapSign as xlayerBundleSwapSign, bundleBatchSwapSign as xlayerBundleBatchSwapSign, createBundleExecutor as xlayerCreateBundleExecutor, BundleExecutor as XLayerBundleExecutor, makeVolume as xlayerMakeVolume, singleRoundVolume as xlayerSingleRoundVolume, createVolumeExecutor as xlayerCreateVolumeExecutor, VolumeExecutor as XLayerVolumeExecutor, makeBuyFirstVolume as xlayerMakeBuyFirstVolume, BuyFirstVolumeExecutor as XLayerBuyFirstVolumeExecutor, AAPortalBuyFirstExecutor as XLayerAAPortalBuyFirstExecutor, AADexBuyFirstExecutor as XLayerAADexBuyFirstExecutor, AAVolumeBuyFirstExecutor as XLayerAAVolumeBuyFirstExecutor, createAAVolumeBuyFirstExecutor as xlayerCreateAAVolumeBuyFirstExecutor, type VolumeBuyFirstParams as XLayerVolumeBuyFirstParams, type VolumeBuyFirstResult as XLayerVolumeBuyFirstResult, type VolumeContinuousParams as XLayerVolumeContinuousParams, type VolumeContinuousResult as XLayerVolumeContinuousResult, type VolumeProgress as XLayerVolumeProgress, createDexExecutor as xlayerCreateDexExecutor, createDexQuery as xlayerCreateDexQuery, quoteOkbToToken as xlayerQuoteOkbToToken, quoteTokenToOkb as xlayerQuoteTokenToOkb, DexExecutor as XLayerDexExecutor, DexQuery as XLayerDexQuery, buildWashOps, type WashOpsParams, type WashOpsResult, type WashPoolType, type WashUserType, buildBundleBuyOps, buildBundleSellOps, buildBundleProfitOp, filterOutProfitOps, type BundleBuyOpsParams, type BundleSellOpsParams, type BundleProfitOpParams, type BundleOpsResult, type BundlePoolType, type BundleUserType, buildDexBatchBuyOps, buildDexBatchBuyOpsV3, type DexBatchBuyParams, type DexBatchBuyV3Params, type DexBatchBuyResult, buildDexBatchSellOps, buildDexBatchSellOpsV3, type DexBatchSellParams, type DexBatchSellV3Params, type DexBatchSellResult, buildDisperseFromSingleOwnerOpsWithProfit, buildTransfersWithProfit, createAAAccountManager as xlayerCreateAAAccountManager, predictSender as xlayerPredictSender, createWallet as xlayerCreateWallet, AAAccountManager as XLayerAAAccountManager, generateAAWallets as xlayerGenerateAAWallets, generateAAWalletsFromMnemonic as xlayerGenerateAAWalletsFromMnemonic, predictSendersFromPrivateKeys as xlayerPredictSendersFromPrivateKeys, createBundlerClient as xlayerCreateBundlerClient, BundlerClient as XLayerBundlerClient, createPortalQuery as xlayerCreatePortalQuery, PortalQuery as XLayerPortalQuery, encodeBuyCall as xlayerEncodeBuyCall, encodeSellCall as xlayerEncodeSellCall, encodeApproveCall as xlayerEncodeApproveCall, parseOkb as xlayerParseOkb, formatOkb as xlayerFormatOkb, XLAYER_CHAIN_ID, FLAP_PORTAL as XLAYER_FLAP_PORTAL, ENTRYPOINT_V06 as XLAYER_ENTRYPOINT, SIMPLE_ACCOUNT_FACTORY as XLAYER_FACTORY, PARTICLE_BUNDLER_URL as XLAYER_BUNDLER_URL, WOKB as XLAYER_WOKB, POTATOSWAP_V2_ROUTER as XLAYER_POTATOSWAP_ROUTER, type XLayerConfig, type BundleBuyParams as XLayerBundleBuyParams, type BundleSellParams as XLayerBundleSellParams, type BundleBuySellParams as XLayerBundleBuySellParams, type BundleSwapParams as XLayerBundleSwapParams, type BundleSwapSignParams as XLayerBundleSwapSignParams, type BundleBatchSwapParams as XLayerBundleBatchSwapParams, type BundleBatchSwapSignParams as XLayerBundleBatchSwapSignParams, type VolumeParams as XLayerVolumeParams, type BundleBuyResult as XLayerBundleBuyResult, type BundleSellResult as XLayerBundleSellResult, type BundleBuySellResult as XLayerBundleBuySellResult, type BundleCreateBuySignParams as XLayerBundleCreateBuySignParams, type BundleCreateBuySignResult as XLayerBundleCreateBuySignResult, type BundleCreateToDexSignParams as XLayerBundleCreateToDexSignParams, type BundleCreateToDexSignResult as XLayerBundleCreateToDexSignResult, type BundleGraduateBuyParams as XLayerBundleGraduateBuyParams, type BundleGraduateBuyResult as XLayerBundleGraduateBuyResult, type BundleSwapResult as XLayerBundleSwapResult, type BundleSwapSignResult as XLayerBundleSwapSignResult, type BundleBatchSwapResult as XLayerBundleBatchSwapResult, type BundleBatchSwapSignResult as XLayerBundleBatchSwapSignResult, type VolumeResult as XLayerVolumeResult, type BuyFirstParams as XLayerBuyFirstParams, type BuyFirstResult as XLayerBuyFirstResult, type BuyFirstVolumeParams as XLayerBuyFirstVolumeParams, type BuyFirstVolumeResult as XLayerBuyFirstVolumeResult, type HandleOpsResult as XLayerHandleOpsResult, type AAAccount as XLayerAAAccount, type UserOperation as XLayerUserOperation, type GeneratedAAWallet as XLayerGeneratedAAWallet, type GenerateAAWalletsParams as XLayerGenerateAAWalletsParams, type GenerateAAWalletsResult as XLayerGenerateAAWalletsResult, } from './xlayer/index.js';
+export { bundleBuy as xlayerBundleBuy, bundleSell as xlayerBundleSell, bundleBuySell as xlayerBundleBuySell, bundleCreateBuySign as xlayerBundleCreateBuySign, bundleCreateToDexSign as xlayerBundleCreateToDexSign, bundleGraduateBuy as xlayerBundleGraduateBuy, bundleSwapSign as xlayerBundleSwapSign, bundleBatchSwapSign as xlayerBundleBatchSwapSign, createBundleExecutor as xlayerCreateBundleExecutor, BundleExecutor as XLayerBundleExecutor, makeVolume as xlayerMakeVolume, singleRoundVolume as xlayerSingleRoundVolume, createVolumeExecutor as xlayerCreateVolumeExecutor, VolumeExecutor as XLayerVolumeExecutor, makeBuyFirstVolume as xlayerMakeBuyFirstVolume, BuyFirstVolumeExecutor as XLayerBuyFirstVolumeExecutor, AAPortalBuyFirstExecutor as XLayerAAPortalBuyFirstExecutor, AADexBuyFirstExecutor as XLayerAADexBuyFirstExecutor, AAVolumeBuyFirstExecutor as XLayerAAVolumeBuyFirstExecutor, createAAVolumeBuyFirstExecutor as xlayerCreateAAVolumeBuyFirstExecutor, type VolumeBuyFirstParams as XLayerVolumeBuyFirstParams, type VolumeBuyFirstResult as XLayerVolumeBuyFirstResult, type VolumeContinuousParams as XLayerVolumeContinuousParams, type VolumeContinuousResult as XLayerVolumeContinuousResult, type VolumeProgress as XLayerVolumeProgress, createDexExecutor as xlayerCreateDexExecutor, createDexQuery as xlayerCreateDexQuery, quoteOkbToToken as xlayerQuoteOkbToToken, quoteTokenToOkb as xlayerQuoteTokenToOkb, DexExecutor as XLayerDexExecutor, DexQuery as XLayerDexQuery, buildWashOps, type WashOpsParams, type WashOpsResult, type WashPoolType, type WashUserType, buildBundleBuyOps, buildBundleSellOps, buildBundleProfitOp, filterOutProfitOps, type BundleBuyOpsParams, type BundleSellOpsParams, type BundleProfitOpParams, type BundleOpsResult, type BundlePoolType, type BundleUserType, buildDexBatchBuyOps, buildDexBatchBuyOpsV3, type DexBatchBuyParams, type DexBatchBuyV3Params, type DexBatchBuyResult, buildDexBatchSellOps, buildDexBatchSellOpsV3, type DexBatchSellParams, type DexBatchSellV3Params, type DexBatchSellResult, buildDisperseFromSingleOwnerOpsWithProfit, buildTransfersWithProfit, createAAAccountManager as xlayerCreateAAAccountManager, predictSender as xlayerPredictSender, createWallet as xlayerCreateWallet, AAAccountManager as XLayerAAAccountManager, generateAAWallets as xlayerGenerateAAWallets, generateAAWalletsFromMnemonic as xlayerGenerateAAWalletsFromMnemonic, predictSendersFromPrivateKeys as xlayerPredictSendersFromPrivateKeys, createBundlerClient as xlayerCreateBundlerClient, BundlerClient as XLayerBundlerClient, createPortalQuery as xlayerCreatePortalQuery, PortalQuery as XLayerPortalQuery, encodeBuyCall as xlayerEncodeBuyCall, encodeSellCall as xlayerEncodeSellCall, encodeApproveCall as xlayerEncodeApproveCall, parseOkb as xlayerParseOkb, formatOkb as xlayerFormatOkb, XLAYER_CHAIN_ID, FLAP_PORTAL as XLAYER_FLAP_PORTAL, ENTRYPOINT_V06 as XLAYER_ENTRYPOINT, SIMPLE_ACCOUNT_FACTORY as XLAYER_FACTORY, PARTICLE_BUNDLER_URL as XLAYER_BUNDLER_URL, WOKB as XLAYER_WOKB, POTATOSWAP_V2_ROUTER as XLAYER_POTATOSWAP_ROUTER, type XLayerConfig, type BundleBuyParams as XLayerBundleBuyParams, type BundleSellParams as XLayerBundleSellParams, type BundleBuySellParams as XLayerBundleBuySellParams, type BundleSwapParams as XLayerBundleSwapParams, type BundleSwapSignParams as XLayerBundleSwapSignParams, type BundleBatchSwapParams as XLayerBundleBatchSwapParams, type BundleBatchSwapSignParams as XLayerBundleBatchSwapSignParams, type VolumeParams as XLayerVolumeParams, type BundleBuyResult as XLayerBundleBuyResult, type BundleSellResult as XLayerBundleSellResult, type BundleBuySellResult as XLayerBundleBuySellResult, type BundleCreateBuySignParams as XLayerBundleCreateBuySignParams, type BundleCreateBuySignResult as XLayerBundleCreateBuySignResult, type BundleCreateToDexSignParams as XLayerBundleCreateToDexSignParams, type BundleCreateToDexSignResult as XLayerBundleCreateToDexSignResult, type BundleGraduateBuyParams as XLayerBundleGraduateBuyParams, type BundleGraduateBuyResult as XLayerBundleGraduateBuyResult, type BundleSwapResult as XLayerBundleSwapResult, type BundleSwapSignResult as XLayerBundleSwapSignResult, type BundleBatchSwapResult as XLayerBundleBatchSwapResult, type BundleBatchSwapSignResult as XLayerBundleBatchSwapSignResult, type VolumeResult as XLayerVolumeResult, xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, type XLayerEoaSwapConfig, type XLayerQuickBatchSwapParams, type XLayerQuickBatchSwapResult, type XLayerCrossSwapParams, type XLayerCrossSwapResult, type BuyFirstParams as XLayerBuyFirstParams, type BuyFirstResult as XLayerBuyFirstResult, type BuyFirstVolumeParams as XLayerBuyFirstVolumeParams, type BuyFirstVolumeResult as XLayerBuyFirstVolumeResult, type HandleOpsResult as XLayerHandleOpsResult, type AAAccount as XLayerAAAccount, type UserOperation as XLayerUserOperation, type GeneratedAAWallet as XLayerGeneratedAAWallet, type GenerateAAWalletsParams as XLayerGenerateAAWalletsParams, type GenerateAAWalletsResult as XLayerGenerateAAWalletsResult, } from './xlayer/index.js';

package/dist/index.js

@@ -66,9 +66,9 @@ export { disperseWithBundle, sweepWithBundle } from './utils/airdrop-sweep.js';
 // Four内盘换手
 export { fourBundleSwapMerkle, fourBatchSwapMerkle, fourQuickBatchSwapMerkle } from './contracts/tm-bundle-merkle/swap.js';
 // Flap内盘换手
-export { flapBundleSwapMerkle, flapBatchSwapMerkle, flapQuickBatchSwapMerkle } from './flap/portal-bundle-merkle/swap.js';
+export { flapBundleSwapMerkle, flapBatchSwapMerkle, flapQuickBatchSwapMerkle, flapCrossSwapMerkle } from './flap/portal-bundle-merkle/swap.js';
 // PancakeSwap V2/V3通用换手
-export { pancakeBundleSwapMerkle, pancakeBatchSwapMerkle, pancakeQuickBatchSwapMerkle } from './pancake/bundle-swap.js';
+export { pancakeBundleSwapMerkle, pancakeBatchSwapMerkle, pancakeQuickBatchSwapMerkle, pancakeCrossSwapMerkle } from './pancake/bundle-swap.js';
 // 先买后卖（Buy-First）入口
 export { fourBundleBuyFirstMerkle } from './contracts/tm-bundle-merkle/swap-buy-first.js';
 export { flapBundleBuyFirstMerkle } from './flap/portal-bundle-merkle/swap-buy-first.js';
@@ -133,4 +133,6 @@ createPortalQuery as xlayerCreatePortalQuery, PortalQuery as XLayerPortalQuery,
 // 工具函数
 parseOkb as xlayerParseOkb, formatOkb as xlayerFormatOkb, 
 // 常量
-XLAYER_CHAIN_ID, FLAP_PORTAL as XLAYER_FLAP_PORTAL, ENTRYPOINT_V06 as XLAYER_ENTRYPOINT, SIMPLE_ACCOUNT_FACTORY as XLAYER_FACTORY, PARTICLE_BUNDLER_URL as XLAYER_BUNDLER_URL, WOKB as XLAYER_WOKB, POTATOSWAP_V2_ROUTER as XLAYER_POTATOSWAP_ROUTER, } from './xlayer/index.js';
+XLAYER_CHAIN_ID, FLAP_PORTAL as XLAYER_FLAP_PORTAL, ENTRYPOINT_V06 as XLAYER_ENTRYPOINT, SIMPLE_ACCOUNT_FACTORY as XLAYER_FACTORY, PARTICLE_BUNDLER_URL as XLAYER_BUNDLER_URL, WOKB as XLAYER_WOKB, POTATOSWAP_V2_ROUTER as XLAYER_POTATOSWAP_ROUTER, 
+// ✅ XLayer EOA 模式换手（不影响 BSC 链）
+xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, } from './xlayer/index.js';

package/dist/pancake/bundle-swap.d.ts

@@ -170,3 +170,43 @@ export interface PancakeQuickBatchSwapResult {
  * 限制：根据多跳数动态计算最大买方数量
  */
 export declare function pancakeQuickBatchSwapMerkle(params: PancakeQuickBatchSwapParams): Promise<PancakeQuickBatchSwapResult>;
+/** 交叉换手参数（PancakeSwap V2/V3） */
+export interface PancakeCrossSwapParams {
+    /** 卖方私钥列表（按顺序轮流卖出） */
+    sellerPrivateKeys: string[];
+    /** 每个卖方的卖出数量（与 sellerPrivateKeys 长度一致） */
+    sellAmounts: string[];
+    /** 买方私钥列表（按顺序轮流分配，每笔平分） */
+    buyerPrivateKeys: string[];
+    tokenAddress: string;
+    routeParams: RouteParams;
+    config: PancakeSwapSignConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    /** 每次卖出分配给多少个买方（默认使用全部买方平分） */
+    buyersPerSell?: number;
+    /** 转账多跳数（可选） */
+    disperseHopCount?: number;
+}
+/** 交叉换手结果（PancakeSwap V2/V3） */
+export interface PancakeCrossSwapResult {
+    signedTransactions: string[];
+    /** 每轮的元数据列表 */
+    rounds: Array<{
+        sellerAddress: string;
+        buyerAddresses: string[];
+        sellAmount: string;
+        bundleHash?: string;
+    }>;
+    /** 汇总的中间钱包信息（转账/利润） */
+    disperseHopWallets?: GeneratedWallet[];
+    profitHopWallets?: GeneratedWallet[];
+}
+/**
+ * PancakeSwap 交叉换手（多卖多买，循环执行）
+ * - 每个卖方单独卖出，买入金额由卖出所得等分分配给当轮买方
+ * - 利润刮取、转账多跳逻辑继承 pancakeQuickBatchSwapMerkle
+ * - 结果按顺序拼接 signedTransactions（可交由前端/后端顺序广播）
+ * - ✅ 正确处理 nonce：同一钱包在多轮中使用时 nonce 自动递增
+ */
+export declare function pancakeCrossSwapMerkle(params: PancakeCrossSwapParams): Promise<PancakeCrossSwapResult>;

package/dist/pancake/bundle-swap.js

@@ -1477,3 +1477,141 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         }
     };
 }
+/**
+ * PancakeSwap 交叉换手（多卖多买，循环执行）
+ * - 每个卖方单独卖出，买入金额由卖出所得等分分配给当轮买方
+ * - 利润刮取、转账多跳逻辑继承 pancakeQuickBatchSwapMerkle
+ * - 结果按顺序拼接 signedTransactions（可交由前端/后端顺序广播）
+ * - ✅ 正确处理 nonce：同一钱包在多轮中使用时 nonce 自动递增
+ */
+export async function pancakeCrossSwapMerkle(params) {
+    const { sellerPrivateKeys, sellAmounts, buyerPrivateKeys, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, buyersPerSell, disperseHopCount = 0 } = params;
+    if (sellerPrivateKeys.length === 0) {
+        throw new Error('至少需要一个卖方');
+    }
+    if (sellerPrivateKeys.length !== sellAmounts.length) {
+        throw new Error(`sellAmounts 长度 (${sellAmounts.length}) 必须与卖方数量 (${sellerPrivateKeys.length}) 一致`);
+    }
+    if (buyerPrivateKeys.length === 0) {
+        throw new Error('至少需要一个买方');
+    }
+    // ✅ 创建 Provider 和 NonceManager
+    const context = createPancakeContext(config);
+    const nonceManager = new NonceManager(context.provider);
+    // ✅ 预先获取所有钱包的初始 nonce
+    const allSellerWallets = sellerPrivateKeys.map(pk => new Wallet(pk, context.provider));
+    const allBuyerWallets = buyerPrivateKeys.map(pk => new Wallet(pk, context.provider));
+    // 使用 Map 去重（同一私钥可能出现多次）
+    const addressToNonce = new Map();
+    // 获取所有卖方 nonce
+    for (const wallet of allSellerWallets) {
+        if (!addressToNonce.has(wallet.address)) {
+            const nonce = await nonceManager.getNextNonce(wallet);
+            addressToNonce.set(wallet.address, nonce);
+        }
+    }
+    // 获取所有买方 nonce
+    for (const wallet of allBuyerWallets) {
+        if (!addressToNonce.has(wallet.address)) {
+            const nonce = await nonceManager.getNextNonce(wallet);
+            addressToNonce.set(wallet.address, nonce);
+        }
+    }
+    console.log(`[pancakeCrossSwapMerkle] 初始化完成: ${sellerPrivateKeys.length} 卖方, ${buyerPrivateKeys.length} 买方`);
+    const allSigned = [];
+    const allDisperse = [];
+    const allProfit = [];
+    const rounds = [];
+    // 轮流分配买方：每轮取 buyersPerSell 个（默认所有买方），不足则从头继续
+    let buyerCursor = 0;
+    const buyerBatchSize = Math.max(1, buyersPerSell ?? buyerPrivateKeys.length);
+    // 判断是否使用原生代币
+    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+    // 获取贿赂金额
+    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];
+        const sellAmount = sellAmounts[i];
+        const sellerWallet = allSellerWallets[i];
+        // 选取本轮买方私钥和钱包
+        const roundBuyerPks = [];
+        const roundBuyerWallets = [];
+        for (let k = 0; k < buyerBatchSize; k++) {
+            const idx = buyerCursor % buyerPrivateKeys.length;
+            roundBuyerPks.push(buyerPrivateKeys[idx]);
+            roundBuyerWallets.push(allBuyerWallets[idx]);
+            buyerCursor++;
+        }
+        // ✅ 获取卖方当前 nonce
+        const sellerNonce = addressToNonce.get(sellerWallet.address);
+        // ✅ 获取并更新买方 nonces（每个买方本轮需要 1 个 nonce）
+        const roundBuyerNonces = roundBuyerWallets.map(w => {
+            const nonce = addressToNonce.get(w.address);
+            addressToNonce.set(w.address, nonce + 1); // 每个买方用 1 个 nonce
+            return nonce;
+        });
+        // 平分买入金额（使用比例模式，避免固定金额超出可分配金额）
+        const ratio = 1 / roundBuyerPks.length;
+        const buyerRatios = roundBuyerPks.map(() => ratio);
+        // ✅ 构建 startNonces: [sellerNonce, buyer1Nonce, buyer2Nonce, ...]
+        const startNonces = [sellerNonce, ...roundBuyerNonces];
+        // ✅ 预先计算卖方 nonce 消耗（精确计算）
+        // 卖方 nonce 消耗 = 贿赂(0/1) + 卖出(1) + 转账(N 或 N*2) + 利润(1)
+        const hasProfit = true; // 默认有利润刮取
+        let sellerNonceConsumed = 0;
+        if (hasBribe)
+            sellerNonceConsumed += 1; // 贿赂
+        sellerNonceConsumed += 1; // 卖出
+        if (disperseHopCount === 0) {
+            sellerNonceConsumed += roundBuyerPks.length; // 直接转账
+        }
+        else if (useNativeToken) {
+            sellerNonceConsumed += roundBuyerPks.length; // 原生多跳：seller→hop1
+        }
+        else {
+            sellerNonceConsumed += roundBuyerPks.length * 2; // ERC20 多跳：BNB + ERC20 两批
+        }
+        if (hasProfit)
+            sellerNonceConsumed += 1; // 利润
+        // 调用单卖多买的签名函数
+        const res = await pancakeQuickBatchSwapMerkle({
+            sellerPrivateKey: sellerPk,
+            sellAmount,
+            buyerPrivateKeys: roundBuyerPks,
+            buyerRatios,
+            tokenAddress,
+            routeParams,
+            config,
+            quoteToken,
+            quoteTokenDecimals,
+            disperseHopCount,
+            startNonces // ✅ 传入预计算的 nonces
+        });
+        // ✅ 更新卖方 nonce（使用精确计算的值）
+        addressToNonce.set(sellerWallet.address, sellerNonce + sellerNonceConsumed);
+        console.log(`[pancakeCrossSwapMerkle] 轮次 ${i + 1}: 卖方=${sellerWallet.address.slice(0, 10)}..., 买方=${roundBuyerPks.length}, 交易=${res.signedTransactions.length}`);
+        // 累积签名与中间钱包
+        allSigned.push(...res.signedTransactions);
+        if (res.disperseHopWallets)
+            allDisperse.push(...res.disperseHopWallets);
+        if (res.profitHopWallets)
+            allProfit.push(...res.profitHopWallets);
+        rounds.push({
+            sellerAddress: res.metadata?.sellerAddress || '',
+            buyerAddresses: res.metadata?.buyerAddresses || roundBuyerPks.map(() => ''),
+            sellAmount,
+            bundleHash: undefined
+        });
+    }
+    nonceManager.clearTemp();
+    console.log(`[pancakeCrossSwapMerkle] 完成: ${rounds.length} 轮, ${allSigned.length} 笔交易`);
+    return {
+        signedTransactions: allSigned,
+        rounds,
+        disperseHopWallets: allDisperse.length > 0 ? allDisperse : undefined,
+        profitHopWallets: allProfit.length > 0 ? allProfit : undefined
+    };
+}

package/dist/xlayer/eoa-bundle-swap.d.ts

@@ -0,0 +1,95 @@
+/**
+ * XLayer EOA 模式批量换手
+ *
+ * 专门为 XLayer 链设计，不影响 BSC 链的逻辑
+ * - 使用 PotatoSwap V3 Quoter
+ * - 使用 WOKB 作为 Wrapped Native Token
+ * - 支持多跳转账和利润刮取
+ */
+import { type GeneratedWallet } from '../utils/wallet.js';
+export type UserType = 'v0' | 'v1';
+export type SwapRouteType = 'v2' | 'v3-single' | 'v3-multi';
+export interface V2RouteParams {
+    routeType: 'v2';
+    v2Path: string[];
+}
+export interface V3SingleRouteParams {
+    routeType: 'v3-single';
+    v3TokenIn: string;
+    v3TokenOut: string;
+    v3Fee: number;
+    v2Path?: string[];
+}
+export interface V3MultiRouteParams {
+    routeType: 'v3-multi';
+    v3LpAddresses: string[];
+    v3ExactTokenIn: string;
+    v2Path?: string[];
+}
+export type RouteParams = V2RouteParams | V3SingleRouteParams | V3MultiRouteParams;
+export interface XLayerEoaSwapConfig {
+    rpcUrl: string;
+    gasLimit?: number | bigint;
+    gasLimitMultiplier?: number;
+    minGasPriceGwei?: number;
+    maxGasPriceGwei?: number;
+    txType?: 0 | 2;
+    reserveGasBNB?: number;
+    userType?: UserType;
+    bribeAmount?: number;
+}
+export interface XLayerQuickBatchSwapParams {
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKeys: string[];
+    buyerRatios?: number[];
+    buyerAmounts?: string[];
+    tokenAddress: string;
+    routeParams: RouteParams;
+    config: XLayerEoaSwapConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    disperseHopCount?: number;
+    startNonces?: number[];
+}
+export interface XLayerQuickBatchSwapResult {
+    signedTransactions: string[];
+    disperseHopWallets?: GeneratedWallet[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        sellerAddress: string;
+        buyerAddresses: string[];
+        sellAmount: string;
+        estimatedOutput: string;
+        transferAmounts: string[];
+        profitAmount?: string;
+        useNativeToken: boolean;
+        disperseHopCount?: number;
+    };
+}
+export interface XLayerCrossSwapParams {
+    sellerPrivateKeys: string[];
+    sellAmounts: string[];
+    buyerPrivateKeys: string[];
+    tokenAddress: string;
+    routeParams: RouteParams;
+    config: XLayerEoaSwapConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    buyersPerSell?: number;
+    disperseHopCount?: number;
+}
+export interface XLayerCrossSwapResult {
+    signedTransactions: string[];
+    rounds: Array<{
+        sellerAddress: string;
+        buyerAddresses: string[];
+        sellAmount: string;
+        bundleHash?: string;
+    }>;
+    disperseHopWallets?: GeneratedWallet[];
+    profitHopWallets?: GeneratedWallet[];
+}
+export declare function xlayerQuickBatchSwapMerkle(params: XLayerQuickBatchSwapParams): Promise<XLayerQuickBatchSwapResult>;
+export declare function xlayerCrossSwapMerkle(params: XLayerCrossSwapParams): Promise<XLayerCrossSwapResult>;

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

@@ -0,0 +1,559 @@
+/**
+ * XLayer EOA 模式批量换手
+ *
+ * 专门为 XLayer 链设计，不影响 BSC 链的逻辑
+ * - 使用 PotatoSwap V3 Quoter
+ * - 使用 WOKB 作为 Wrapped Native Token
+ * - 支持多跳转账和利润刮取
+ */
+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 { ADDRESSES, PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA } from '../utils/constants.js';
+import { quoteV2, quoteV3 } from '../utils/quote-helpers.js';
+import { V2_ROUTER_ABI, V3_ROUTER02_ABI } from '../abis/common.js';
+import { generateWallets } from '../utils/wallet.js';
+// ==================== XLayer 专用常量 ====================
+const XLAYER_CHAIN_ID = 196;
+const XLAYER_CHAIN_NAME = 'XLAYER';
+const WOKB_ADDRESS = ADDRESSES.XLAYER.WOKB;
+const POTATO_V2_ROUTER = '0x881fb2f98c13d521009464e7d1cbf16e1b394e8e';
+const POTATO_V3_ROUTER = '0x4e57fe71624fBCD5F1175C6B1a1e5d5fE2e4Da45';
+const NATIVE_TRANSFER_GAS_LIMIT = 21055n;
+const ERC20_TRANSFER_GAS_LIMIT = 65000n;
+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) {
+    console.log(`[XLayer quoteSellOutput] 开始报价, routeType=${routeParams.routeType}`);
+    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) {
+            console.log(`[XLayer quoteSellOutput] V2 报价成功: ${ethers.formatEther(result.amountOut)} OKB`);
+            return result.amountOut;
+        }
+        throw new Error('V2 报价失败');
+    }
+    if (routeParams.routeType === 'v3-single') {
+        const params = routeParams;
+        console.log(`[XLayer quoteSellOutput] V3 单跳: ${params.v3TokenIn} → ${params.v3TokenOut}, fee=${params.v3Fee}`);
+        const result = await quoteV3(provider, params.v3TokenIn, params.v3TokenOut, sellAmountWei, XLAYER_CHAIN_NAME, params.v3Fee);
+        if (result.amountOut > 0n) {
+            console.log(`[XLayer quoteSellOutput] V3 报价成功: ${ethers.formatEther(result.amountOut)} OKB`);
+            return result.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) {
+            console.log(`[XLayer quoteSellOutput] V3 多跳报价成功: ${ethers.formatEther(result.amountOut)} OKB`);
+            return result.amountOut;
+        }
+        throw new Error(`V3 多跳报价失败`);
+    }
+    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) {
+            console.log(`[XLayer getERC20ToOkbQuote] V3 报价成功: ${ethers.formatEther(result.amountOut)} OKB`);
+            return result.amountOut;
+        }
+        return 0n;
+    }
+    const result = await quoteV2(provider, tokenAddress, WOKB_ADDRESS, tokenAmount, XLAYER_CHAIN_NAME);
+    if (result.amountOut > 0n) {
+        console.log(`[XLayer getERC20ToOkbQuote] V2 报价成功: ${ethers.formatEther(result.amountOut)} OKB`);
+        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 快捷批量换手 ====================
+export async function xlayerQuickBatchSwapMerkle(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));
+    // 校验卖出路径输出代币
+    let sellOutputToken;
+    if (routeParams.routeType === 'v2') {
+        sellOutputToken = routeParams.v2Path[routeParams.v2Path.length - 1];
+    }
+    else if (routeParams.routeType === 'v3-single') {
+        sellOutputToken = routeParams.v3TokenOut;
+    }
+    if (useNativeToken) {
+        if (!sellOutputToken || sellOutputToken.toLowerCase() !== WOKB_ADDRESS.toLowerCase()) {
+            throw new Error(`原生代币模式要求卖出路径以 WOKB 结尾（当前输出: ${sellOutputToken || '未知'}）`);
+        }
+    }
+    // 动态计算最大买方数量
+    const fixedOverhead = 1 + 1 + PROFIT_HOP_COUNT + 1;
+    const maxTxs = 50 - fixedOverhead;
+    const MAX_BUYERS = Math.max(1, Math.floor(maxTxs / (disperseHopCount + 2)));
+    if (buyerPrivateKeys.length === 0) {
+        throw new Error('至少需要一个买方钱包');
+    }
+    if (buyerPrivateKeys.length > MAX_BUYERS) {
+        throw new Error(`买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
+    }
+    const nonceManager = new NonceManager(context.provider);
+    const finalGasLimit = getGasLimit(config);
+    const txType = config.txType ?? 0;
+    const [gasPrice, sellAmountResult] = await Promise.all([
+        getGasPrice(context.provider, config),
+        calculateSellAmount(context.provider, tokenAddress, seller.address, sellAmount, sellPercentage)
+    ]);
+    const { amount: sellAmountWei, decimals } = sellAmountResult;
+    console.log(`[xlayerQuickBatchSwapMerkle] 模式: ${useNativeToken ? 'OKB' : 'ERC20'}, 卖出: ${ethers.formatUnits(sellAmountWei, decimals)}`);
+    // 获取卖出报价
+    const estimatedOutput = await quoteSellOutput(context.provider, routeParams, sellAmountWei);
+    // 计算利润
+    let profitAmount;
+    if (useNativeToken) {
+        profitAmount = calculateProfitAmount(estimatedOutput, config.userType);
+    }
+    else {
+        const version = routeParams.routeType === 'v2' ? 'v2' : 'v3';
+        const fee = routeParams.routeType === 'v3-single' ? routeParams.v3Fee : undefined;
+        const estimatedOkbValue = await getERC20ToOkbQuote(context.provider, quoteToken, estimatedOutput, version, fee);
+        profitAmount = calculateProfitAmount(estimatedOkbValue, config.userType);
+    }
+    const distributableAmount = estimatedOutput - (useNativeToken ? profitAmount : 0n);
+    // 计算每个买方分到的金额
+    let transferAmountsWei;
+    if (buyerAmounts && buyerAmounts.length === buyers.length) {
+        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);
+    }
+    else {
+        throw new Error('必须提供 buyerRatios 或 buyerAmounts');
+    }
+    // 获取贿赂金额
+    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);
+    const deadline = getDeadline();
+    // 1. 贿赂交易
+    let bribeTx = null;
+    if (bribeAmount > 0n) {
+        bribeTx = await seller.signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: sellerNonce++,
+            gasPrice,
+            gasLimit: 21000n,
+            chainId: XLAYER_CHAIN_ID,
+            type: txType
+        });
+    }
+    // 2. 卖出交易
+    const v3RouterIface = new ethers.Interface(V3_ROUTER02_ABI);
+    let sellUnsigned;
+    if (routeParams.routeType === 'v2') {
+        const { v2Path } = routeParams;
+        const v2RouterSeller = new Contract(POTATO_V2_ROUTER, V2_ROUTER_ABI, seller);
+        if (useNativeToken) {
+            sellUnsigned = await v2RouterSeller.swapExactTokensForETHSupportingFeeOnTransferTokens.populateTransaction(sellAmountWei, 0n, v2Path, seller.address, deadline);
+        }
+        else {
+            sellUnsigned = await v2RouterSeller.swapExactTokensForTokensSupportingFeeOnTransferTokens.populateTransaction(sellAmountWei, 0n, v2Path, seller.address, deadline);
+        }
+    }
+    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', [{
+                tokenIn: v3TokenIn,
+                tokenOut: v3TokenOut,
+                fee: v3Fee,
+                recipient: useNativeToken ? POTATO_V3_ROUTER : seller.address,
+                amountIn: sellAmountWei,
+                amountOutMinimum: 0n,
+                sqrtPriceLimitX96: 0n
+            }]);
+        if (useNativeToken) {
+            const sellUnwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [0n, seller.address]);
+            sellUnsigned = await v3RouterSeller.multicall.populateTransaction(deadline, [sellSwapData, sellUnwrapData]);
+        }
+        else {
+            sellUnsigned = await v3RouterSeller.multicall.populateTransaction(deadline, [sellSwapData]);
+        }
+    }
+    else {
+        throw new Error('V3 多跳路由暂不支持');
+    }
+    const signedSell = await seller.signTransaction({
+        ...sellUnsigned,
+        from: seller.address,
+        nonce: sellerNonce++,
+        gasLimit: finalGasLimit,
+        gasPrice,
+        chainId: XLAYER_CHAIN_ID,
+        type: txType
+    });
+    // 3. 转账交易
+    const buyerGasCost = gasPrice * finalGasLimit;
+    const hopPaths = generateDisperseHopPaths(buyers.map(b => b.address), disperseHopCount, context.provider);
+    const allHopWallets = [];
+    hopPaths.forEach(path => allHopWallets.push(...path.hopWalletsInfo));
+    let transferTxs = [];
+    if (disperseHopCount === 0) {
+        const transferNonces = buyers.map((_, i) => sellerNonce + i);
+        sellerNonce += buyers.length;
+        transferTxs = await Promise.all(buyers.map((buyer, i) => {
+            const transferValue = transferAmountsWei[i] + buyerGasCost;
+            return seller.signTransaction({
+                to: buyer.address,
+                value: transferValue,
+                nonce: transferNonces[i],
+                gasPrice,
+                gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+                chainId: XLAYER_CHAIN_ID,
+                type: txType
+            });
+        }));
+    }
+    else {
+        const hopChains = await Promise.all(hopPaths.map((path, i) => {
+            const finalAmount = transferAmountsWei[i] + buyerGasCost;
+            const payerNonce = sellerNonce + i;
+            return buildNativeHopChain(seller, path, finalAmount, gasPrice, txType, payerNonce);
+        }));
+        transferTxs = hopChains.flat();
+        sellerNonce += buyers.length;
+    }
+    // 4. 买入交易
+    const buyerNonces = startNonces && startNonces.length > 1
+        ? startNonces.slice(1)
+        : 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;
+        let buyUnsigned;
+        if (routeParams.routeType === 'v2') {
+            const { v2Path } = routeParams;
+            const reversePath = [...v2Path].reverse();
+            const v2RouterBuyer = new Contract(POTATO_V2_ROUTER, V2_ROUTER_ABI, buyer);
+            if (useNativeToken) {
+                buyUnsigned = await v2RouterBuyer.swapExactETHForTokensSupportingFeeOnTransferTokens.populateTransaction(0n, reversePath, buyer.address, deadline, { value: buyValue });
+            }
+            else {
+                buyUnsigned = await v2RouterBuyer.swapExactTokensForTokensSupportingFeeOnTransferTokens.populateTransaction(buyAmount, 0n, reversePath, buyer.address, deadline);
+            }
+        }
+        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', [{
+                    tokenIn: v3TokenOut,
+                    tokenOut: v3TokenIn,
+                    fee: v3Fee,
+                    recipient: buyer.address,
+                    amountIn: buyAmount,
+                    amountOutMinimum: 0n,
+                    sqrtPriceLimitX96: 0n
+                }]);
+            buyUnsigned = await v3RouterBuyer.multicall.populateTransaction(deadline, [buySwapData], { value: buyValue });
+        }
+        else {
+            throw new Error('V3 多跳路由暂不支持');
+        }
+        return buyer.signTransaction({
+            ...buyUnsigned,
+            from: buyer.address,
+            nonce: buyerNonces[i],
+            gasLimit: finalGasLimit,
+            gasPrice,
+            chainId: XLAYER_CHAIN_ID,
+            type: txType
+        });
+    }));
+    nonceManager.clearTemp();
+    // 组装交易数组
+    const signedTransactions = [];
+    if (bribeTx)
+        signedTransactions.push(bribeTx);
+    signedTransactions.push(signedSell);
+    signedTransactions.push(...transferTxs);
+    signedTransactions.push(...signedBuys);
+    // 5. 利润多跳转账
+    let profitHopWallets;
+    if (profitAmount > 0n) {
+        const profitHopResult = await buildProfitHopTransactions({
+            provider: context.provider,
+            payerWallet: seller,
+            profitAmount,
+            profitRecipient: PROFIT_CONFIG.RECIPIENT,
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId: XLAYER_CHAIN_ID,
+            txType,
+            startNonce: sellerNonce++
+        });
+        signedTransactions.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets;
+    }
+    console.log(`[xlayerQuickBatchSwapMerkle] 完成: ${signedTransactions.length} 笔交易`);
+    return {
+        signedTransactions,
+        disperseHopWallets: allHopWallets.length > 0 ? allHopWallets : undefined,
+        profitHopWallets,
+        metadata: {
+            sellerAddress: seller.address,
+            buyerAddresses: buyers.map(b => b.address),
+            sellAmount: ethers.formatUnits(sellAmountWei, decimals),
+            estimatedOutput: ethers.formatEther(estimatedOutput),
+            transferAmounts: transferAmountsWei.map(amt => ethers.formatEther(amt)),
+            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
+            useNativeToken,
+            disperseHopCount: disperseHopCount > 0 ? disperseHopCount : undefined
+        }
+    };
+}
+// ==================== XLayer 交叉换手 ====================
+export async function xlayerCrossSwapMerkle(params) {
+    const { sellerPrivateKeys, sellAmounts, buyerPrivateKeys, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, buyersPerSell, disperseHopCount = 0 } = params;
+    if (sellerPrivateKeys.length === 0)
+        throw new Error('至少需要一个卖方');
+    if (sellerPrivateKeys.length !== sellAmounts.length)
+        throw new Error('sellAmounts 长度必须与卖方数量一致');
+    if (buyerPrivateKeys.length === 0)
+        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));
+    // 预先获取所有钱包的初始 nonce
+    const addressToNonce = new Map();
+    for (const wallet of allSellerWallets) {
+        if (!addressToNonce.has(wallet.address)) {
+            addressToNonce.set(wallet.address, await nonceManager.getNextNonce(wallet));
+        }
+    }
+    for (const wallet of allBuyerWallets) {
+        if (!addressToNonce.has(wallet.address)) {
+            addressToNonce.set(wallet.address, await nonceManager.getNextNonce(wallet));
+        }
+    }
+    console.log(`[xlayerCrossSwapMerkle] 初始化: ${sellerPrivateKeys.length} 卖方, ${buyerPrivateKeys.length} 买方`);
+    const allSigned = [];
+    const allDisperse = [];
+    const allProfit = [];
+    const rounds = [];
+    let buyerCursor = 0;
+    const buyerBatchSize = Math.max(1, buyersPerSell ?? buyerPrivateKeys.length);
+    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+    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];
+        const sellAmount = sellAmounts[i];
+        const sellerWallet = allSellerWallets[i];
+        const roundBuyerPks = [];
+        const roundBuyerWallets = [];
+        for (let k = 0; k < buyerBatchSize; k++) {
+            const idx = buyerCursor % buyerPrivateKeys.length;
+            roundBuyerPks.push(buyerPrivateKeys[idx]);
+            roundBuyerWallets.push(allBuyerWallets[idx]);
+            buyerCursor++;
+        }
+        const sellerNonce = addressToNonce.get(sellerWallet.address);
+        const roundBuyerNonces = roundBuyerWallets.map(w => {
+            const nonce = addressToNonce.get(w.address);
+            addressToNonce.set(w.address, nonce + 1);
+            return nonce;
+        });
+        const ratio = 1 / roundBuyerPks.length;
+        const buyerRatios = roundBuyerPks.map(() => ratio);
+        const startNonces = [sellerNonce, ...roundBuyerNonces];
+        // 预先计算卖方 nonce 消耗
+        let sellerNonceConsumed = 0;
+        if (hasBribe)
+            sellerNonceConsumed += 1;
+        sellerNonceConsumed += 1; // 卖出
+        sellerNonceConsumed += roundBuyerPks.length; // 转账
+        sellerNonceConsumed += 1; // 利润
+        const res = await xlayerQuickBatchSwapMerkle({
+            sellerPrivateKey: sellerPk,
+            sellAmount,
+            buyerPrivateKeys: roundBuyerPks,
+            buyerRatios,
+            tokenAddress,
+            routeParams,
+            config,
+            quoteToken,
+            quoteTokenDecimals,
+            disperseHopCount,
+            startNonces
+        });
+        addressToNonce.set(sellerWallet.address, sellerNonce + sellerNonceConsumed);
+        console.log(`[xlayerCrossSwapMerkle] 轮次 ${i + 1}: 卖方=${sellerWallet.address.slice(0, 10)}..., 买方=${roundBuyerPks.length}, 交易=${res.signedTransactions.length}`);
+        allSigned.push(...res.signedTransactions);
+        if (res.disperseHopWallets)
+            allDisperse.push(...res.disperseHopWallets);
+        if (res.profitHopWallets)
+            allProfit.push(...res.profitHopWallets);
+        rounds.push({
+            sellerAddress: res.metadata?.sellerAddress || '',
+            buyerAddresses: res.metadata?.buyerAddresses || [],
+            sellAmount,
+            bundleHash: undefined
+        });
+    }
+    nonceManager.clearTemp();
+    console.log(`[xlayerCrossSwapMerkle] 完成: ${rounds.length} 轮, ${allSigned.length} 笔交易`);
+    return {
+        signedTransactions: allSigned,
+        rounds,
+        disperseHopWallets: allDisperse.length > 0 ? allDisperse : undefined,
+        profitHopWallets: allProfit.length > 0 ? allProfit : undefined
+    };
+}

package/dist/xlayer/index.d.ts

@@ -92,6 +92,7 @@ export { buildDexBatchSellOps, buildDexBatchSellOpsV3, type DexBatchSellParams,
 export { buildDisperseFromSingleOwnerOpsWithProfit, buildTransfersWithProfit, } from './aa-transfer-profit.js';
 export { buildWashOps, type WashOpsParams, type WashOpsResult, type WashPoolType, type WashUserType, } from './wash-ops.js';
 export { buildBundleBuyOps, buildBundleSellOps, buildBundleProfitOp, filterOutProfitOps, type BundleBuyOpsParams, type BundleSellOpsParams, type BundleProfitOpParams, type BundleOpsResult, type BundlePoolType, type BundleUserType, } from './bundle-buy-first.js';
+export { xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, type XLayerEoaSwapConfig, type XLayerQuickBatchSwapParams, type XLayerQuickBatchSwapResult, type XLayerCrossSwapParams, type XLayerCrossSwapResult, type UserType as XLayerUserType, type RouteParams as XLayerRouteParams, type V2RouteParams as XLayerV2RouteParams, type V3SingleRouteParams as XLayerV3SingleRouteParams, } from './eoa-bundle-swap.js';
 export declare const xlayer: {
     bundleBuy: (params: import("./types.js").BundleBuyParams) => Promise<import("./types.js").BundleBuyResult>;
     bundleSell: (params: import("./types.js").BundleSellParams) => Promise<import("./types.js").BundleSellResult>;

package/dist/xlayer/index.js

@@ -172,6 +172,10 @@ export { buildWashOps, } from './wash-ops.js';
 // ============================================================================
 export { buildBundleBuyOps, buildBundleSellOps, buildBundleProfitOp, filterOutProfitOps, } from './bundle-buy-first.js';
 // ============================================================================
+// ✅ XLayer EOA 模式换手（不影响 BSC 链）
+// ============================================================================
+export { xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, } from './eoa-bundle-swap.js';
+// ============================================================================
 // 便捷重导出
 // ============================================================================
 // 将最常用的函数放在默认导出对象中

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "four-flap-meme-sdk",
-  "version": "1.6.97",
+  "version": "1.6.99",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",