four-flap-meme-sdk 1.5.32 → 1.5.34

package/dist/xlayer/dex-buy-first.d.ts

@@ -0,0 +1,24 @@
+/**
+ * XLayer AA Buy-First（外盘 / PotatoSwap V2）
+ *
+ * 对齐 BSC buy-first 思路：
+ * - 买方先买入（OKB -> token）
+ * - 卖方再卖出等值 token（token -> OKB，卖方需要预持仓）
+ * - ✅ 利润：在卖出后归集阶段刮取
+ */
+import type { XLayerConfig } from './types.js';
+import type { BuyFirstParams, BuyFirstResult } from './types.js';
+export declare class AADexBuyFirstExecutor {
+    private aaManager;
+    private portalQuery;
+    private dexQuery;
+    private config;
+    constructor(config?: XLayerConfig);
+    private getEffectiveRouter;
+    private runHandleOps;
+    private pickWallets;
+    private buildWithdrawUserOp;
+    private safeQuoteBuy;
+    execute(params: BuyFirstParams): Promise<BuyFirstResult>;
+}
+export declare function createAADexBuyFirstExecutor(config?: XLayerConfig): AADexBuyFirstExecutor;

package/dist/xlayer/dex-buy-first.js

@@ -0,0 +1,404 @@
+/**
+ * XLayer AA Buy-First（外盘 / PotatoSwap V2）
+ *
+ * 对齐 BSC buy-first 思路：
+ * - 买方先买入（OKB -> token）
+ * - 卖方再卖出等值 token（token -> OKB，卖方需要预持仓）
+ * - ✅ 利润：在卖出后归集阶段刮取
+ */
+import { Contract, Interface, Wallet, ethers } from 'ethers';
+import { AANonceMap } from './types.js';
+import { ENTRYPOINT_ABI, DEFAULT_WITHDRAW_RESERVE, POTATOSWAP_V2_ROUTER, WOKB, } from './constants.js';
+import { AAAccountManager, encodeExecute, encodeExecuteBatch } from './aa-account.js';
+import { DexQuery, encodeSwapExactETHForTokensSupportingFee, encodeSwapExactTokensForETHSupportingFee } from './dex.js';
+import { PortalQuery, encodeApproveCall, parseOkb } from './portal-ops.js';
+import { mapWithConcurrency } from '../utils/concurrency.js';
+import { PROFIT_CONFIG } from '../utils/constants.js';
+// 固定 gas（用于减少 RPC 与提高可控性）
+const DEFAULT_CALL_GAS_LIMIT_BUY = 450000n;
+const DEFAULT_CALL_GAS_LIMIT_SELL = 450000n;
+const DEFAULT_CALL_GAS_LIMIT_APPROVE = 200000n;
+const DEFAULT_CALL_GAS_LIMIT_WITHDRAW = 120000n;
+function getDexDeadline(minutes = 20) {
+    return Math.floor(Date.now() / 1000) + minutes * 60;
+}
+function resolveProfitSettings(config) {
+    const extractProfit = config?.extractProfit !== false; // 默认 true
+    const profitBpsRaw = config?.profitBps ?? PROFIT_CONFIG.RATE_BPS_SWAP;
+    const profitBps = Math.max(0, Math.min(10000, Number(profitBpsRaw)));
+    const profitRecipient = config?.profitRecipient ?? PROFIT_CONFIG.RECIPIENT;
+    return { extractProfit, profitBps, profitRecipient };
+}
+function calculateProfitWei(amountWei, profitBps) {
+    if (amountWei <= 0n)
+        return 0n;
+    if (!Number.isFinite(profitBps) || profitBps <= 0)
+        return 0n;
+    return (amountWei * BigInt(profitBps)) / 10000n;
+}
+function shuffle(arr) {
+    const a = arr.slice();
+    for (let i = a.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [a[i], a[j]] = [a[j], a[i]];
+    }
+    return a;
+}
+function splitAmount(totalAmount, count) {
+    if (count <= 0)
+        throw new Error('拆分份数必须大于 0');
+    if (count === 1)
+        return [totalAmount];
+    if (totalAmount <= 0n)
+        return new Array(count).fill(0n);
+    const weights = [];
+    for (let i = 0; i < count; i++) {
+        const w = BigInt(500000 + Math.floor(Math.random() * 1000000)); // [0.5,1.5)
+        weights.push(w);
+    }
+    const totalWeight = weights.reduce((a, b) => a + b, 0n);
+    const amounts = [];
+    let allocated = 0n;
+    for (let i = 0; i < count - 1; i++) {
+        const amt = (totalAmount * weights[i]) / totalWeight;
+        amounts.push(amt);
+        allocated += amt;
+    }
+    amounts.push(totalAmount - allocated);
+    return shuffle(amounts);
+}
+export class AADexBuyFirstExecutor {
+    constructor(config = {}) {
+        this.config = config;
+        this.aaManager = new AAAccountManager(config);
+        this.portalQuery = new PortalQuery({ rpcUrl: config.rpcUrl, chainId: config.chainId });
+        this.dexQuery = new DexQuery({ rpcUrl: config.rpcUrl, chainId: config.chainId });
+    }
+    getEffectiveRouter(params) {
+        if (params.routerAddress)
+            return params.routerAddress;
+        if (params.dexKey === 'DYORSWAP') {
+            return '0xfb001fbbace32f09cb6d3c449b935183de53ee96';
+        }
+        return POTATOSWAP_V2_ROUTER;
+    }
+    async runHandleOps(label, ops, bundlerSigner, beneficiary) {
+        const provider = this.aaManager.getProvider();
+        const entryPointAddress = this.aaManager.getEntryPointAddress();
+        const feeData = await provider.getFeeData();
+        console.log(`\n[${label}] 发送 handleOps，ops=${ops.length} ...`);
+        const entryPointWithSigner = new Contract(entryPointAddress, ENTRYPOINT_ABI, bundlerSigner);
+        const tx = await entryPointWithSigner.handleOps(ops, beneficiary, { gasPrice: feeData.gasPrice ?? 100000000n });
+        console.log(`[${label}] txHash:`, tx.hash);
+        const receipt = await tx.wait();
+        console.log(`[${label}] mined block=${receipt.blockNumber} status=${receipt.status}`);
+        const epIface = new Interface(ENTRYPOINT_ABI);
+        const userOpEvents = [];
+        for (const log of receipt.logs) {
+            try {
+                const parsed = epIface.parseLog(log);
+                if (parsed?.name === 'UserOperationEvent') {
+                    const e = parsed.args;
+                    userOpEvents.push({
+                        userOpHash: e.userOpHash,
+                        sender: e.sender,
+                        paymaster: e.paymaster,
+                        success: e.success,
+                        actualGasCost: e.actualGasCost,
+                        actualGasUsed: e.actualGasUsed,
+                    });
+                }
+            }
+            catch { }
+        }
+        return { txHash: tx.hash, blockNumber: receipt.blockNumber, status: receipt.status, userOpEvents };
+    }
+    pickWallets(privateKeys, n) {
+        const provider = this.aaManager.getProvider();
+        const wallets = privateKeys.map((pk) => new Wallet(pk, provider));
+        if (!n || n <= 0 || n >= wallets.length)
+            return wallets;
+        return wallets.slice(0, n);
+    }
+    async buildWithdrawUserOp(params) {
+        const senderBalance = params.senderBalance;
+        if (senderBalance <= params.reserveWei)
+            return null;
+        const effConfig = { ...(this.config ?? {}), ...(params.configOverride ?? {}) };
+        const gasPolicyRaw = effConfig.gasPolicy ?? 'bundlerEstimate';
+        const gasPolicy = gasPolicyRaw === 'bundlerEstimate' ? 'fixed' : gasPolicyRaw;
+        const tempCallData = encodeExecute(params.ownerWallet.address, 0n, '0x');
+        const { prefundWei } = gasPolicy === 'fixed'
+            ? await this.aaManager.buildUserOpWithFixedGas({
+                ownerWallet: params.ownerWallet,
+                sender: params.sender,
+                callData: tempCallData,
+                nonce: params.nonce,
+                initCode: params.initCode,
+                deployed: params.initCode === '0x',
+                fixedGas: {
+                    ...(effConfig.fixedGas ?? {}),
+                    callGasLimit: effConfig.fixedGas?.callGasLimit ?? DEFAULT_CALL_GAS_LIMIT_WITHDRAW,
+                },
+            })
+            : await this.aaManager.buildUserOpWithLocalEstimate({
+                ownerWallet: params.ownerWallet,
+                sender: params.sender,
+                callData: tempCallData,
+                nonce: params.nonce,
+                initCode: params.initCode,
+            });
+        const withdrawAmount = senderBalance > prefundWei + params.reserveWei
+            ? senderBalance - prefundWei - params.reserveWei
+            : 0n;
+        if (withdrawAmount <= 0n)
+            return null;
+        const { extractProfit, profitBps, profitRecipient } = resolveProfitSettings(effConfig);
+        const profitWei = extractProfit ? calculateProfitWei(withdrawAmount, profitBps) : 0n;
+        const toOwnerWei = withdrawAmount - profitWei;
+        const callData = extractProfit && profitWei > 0n
+            ? encodeExecuteBatch([profitRecipient, params.ownerWallet.address], [profitWei, toOwnerWei], ['0x', '0x'])
+            : encodeExecute(params.ownerWallet.address, withdrawAmount, '0x');
+        const { userOp } = gasPolicy === 'fixed'
+            ? await this.aaManager.buildUserOpWithFixedGas({
+                ownerWallet: params.ownerWallet,
+                sender: params.sender,
+                callData,
+                nonce: params.nonce,
+                initCode: params.initCode,
+                deployed: params.initCode === '0x',
+                fixedGas: {
+                    ...(effConfig.fixedGas ?? {}),
+                    callGasLimit: effConfig.fixedGas?.callGasLimit ?? DEFAULT_CALL_GAS_LIMIT_WITHDRAW,
+                },
+            })
+            : await this.aaManager.buildUserOpWithLocalEstimate({
+                ownerWallet: params.ownerWallet,
+                sender: params.sender,
+                callData,
+                nonce: params.nonce,
+                initCode: params.initCode,
+            });
+        return { userOp, prefundWei, profitWei };
+    }
+    async safeQuoteBuy(tokenAddress, okbAmount) {
+        if (okbAmount <= 0n)
+            return 0n;
+        try {
+            return await this.dexQuery.quoteOkbToToken(okbAmount, tokenAddress);
+        }
+        catch {
+            return 0n;
+        }
+    }
+    async execute(params) {
+        const { tradeType = 'V2', dexKey, routerAddress, deadlineMinutes = 20, tokenAddress, buyerPrivateKeys, sellerPrivateKeys, buyerFunds, buyCount, sellCount, slippageBps = 0, withdrawToOwner = true, withdrawReserve = DEFAULT_WITHDRAW_RESERVE, config, } = params;
+        if (tradeType !== 'V2') {
+            throw new Error('AADexBuyFirstExecutor 仅支持 tradeType=V2（外盘）');
+        }
+        const effectiveRouter = this.getEffectiveRouter({ dexKey, routerAddress });
+        const deadline = getDexDeadline(deadlineMinutes);
+        const buyers = this.pickWallets(buyerPrivateKeys, buyCount);
+        const sellers = this.pickWallets(sellerPrivateKeys, sellCount);
+        if (buyers.length === 0)
+            throw new Error('buyCount=0 或 buyerPrivateKeys 为空');
+        if (sellers.length === 0)
+            throw new Error('sellCount=0 或 sellerPrivateKeys 为空');
+        const effConfig = { ...(this.config ?? {}), ...(config ?? {}) };
+        const profitSettings = resolveProfitSettings(effConfig);
+        const totalBuyWei = parseOkb(String(buyerFunds));
+        if (totalBuyWei <= 0n)
+            throw new Error('buyerFunds 需要 > 0');
+        const buyAmountsWei = splitAmount(totalBuyWei, buyers.length);
+        const quotedPerBuy = await mapWithConcurrency(buyAmountsWei, 6, async (amt) => this.safeQuoteBuy(tokenAddress, amt));
+        const quotedTotalTokenOut = quotedPerBuy.reduce((a, b) => a + (b ?? 0n), 0n);
+        const estimatedTokenOutWei = (quotedTotalTokenOut * BigInt(10000 - Math.max(0, Math.min(10000, slippageBps)))) / 10000n;
+        if (estimatedTokenOutWei <= 0n) {
+            throw new Error('买入报价为 0，无法规划 sellAmount（可能无流动性）');
+        }
+        const sellAmountsWei = splitAmount(estimatedTokenOutWei, sellers.length);
+        // account infos
+        const buyerAis = await this.aaManager.getMultipleAccountInfo(buyers.map((w) => w.address));
+        const sellerAis = await this.aaManager.getMultipleAccountInfo(sellers.map((w) => w.address));
+        const nonceMap = new AANonceMap();
+        for (const ai of buyerAis)
+            nonceMap.init(ai.sender, ai.nonce);
+        for (const ai of sellerAis)
+            nonceMap.init(ai.sender, ai.nonce);
+        // initCode：确保同一 sender 只在第一笔 op 携带
+        const initCodeBySenderLower = new Map();
+        const initIfNeeded = (sender, deployed, ownerAddress) => {
+            const k = sender.toLowerCase();
+            if (initCodeBySenderLower.has(k))
+                return;
+            initCodeBySenderLower.set(k, deployed ? '0x' : this.aaManager.generateInitCode(ownerAddress));
+        };
+        const consumeInitCode = (sender) => {
+            const k = sender.toLowerCase();
+            const cur = initCodeBySenderLower.get(k);
+            if (cur === undefined)
+                throw new Error(`initCode not initialized for sender: ${sender}`);
+            if (cur !== '0x')
+                initCodeBySenderLower.set(k, '0x');
+            return cur;
+        };
+        for (let i = 0; i < buyers.length; i++)
+            initIfNeeded(buyerAis[i].sender, buyerAis[i].deployed, buyers[i].address);
+        for (let i = 0; i < sellers.length; i++)
+            initIfNeeded(sellerAis[i].sender, sellerAis[i].deployed, sellers[i].address);
+        // 卖方预持仓检查
+        const sellerSenders = sellerAis.map((ai) => ai.sender);
+        const sellerTokenBalances = await this.portalQuery.getMultipleTokenBalances(tokenAddress, sellerSenders);
+        for (let i = 0; i < sellers.length; i++) {
+            const sender = sellerSenders[i];
+            const needSell = sellAmountsWei[i] ?? 0n;
+            const bal = sellerTokenBalances.get(sender) ?? 0n;
+            if (needSell > bal) {
+                throw new Error(`卖方预持仓不足: sender=${sender} need=${needSell.toString()} bal=${bal.toString()}`);
+            }
+        }
+        // allowance（spender=router）
+        const sellerAllowances = await this.portalQuery.getMultipleAllowances(tokenAddress, sellerSenders, effectiveRouter);
+        const ops = [];
+        // buy ops
+        for (let i = 0; i < buyers.length; i++) {
+            const w = buyers[i];
+            const ai = buyerAis[i];
+            const sender = ai.sender;
+            const buyWei = buyAmountsWei[i] ?? 0n;
+            if (buyWei <= 0n)
+                continue;
+            const swapData = encodeSwapExactETHForTokensSupportingFee(0n, [WOKB, tokenAddress], sender, deadline);
+            const callData = encodeExecute(effectiveRouter, buyWei, swapData);
+            const { userOp, prefundWei } = await this.aaManager.buildUserOpWithFixedGas({
+                ownerWallet: w,
+                sender,
+                nonce: nonceMap.next(sender),
+                initCode: consumeInitCode(sender),
+                callData,
+                deployed: ai.deployed,
+                fixedGas: {
+                    ...(effConfig.fixedGas ?? {}),
+                    callGasLimit: effConfig.fixedGas?.callGasLimit ?? DEFAULT_CALL_GAS_LIMIT_BUY,
+                },
+            });
+            await this.aaManager.ensureSenderBalance(w, sender, buyWei + prefundWei + parseOkb('0.0001'), `buyFirstDex/buyer${i + 1}/fund`);
+            const signed = await this.aaManager.signUserOp(userOp, w);
+            ops.push(signed.userOp);
+        }
+        // seller approve + sell ops
+        for (let i = 0; i < sellers.length; i++) {
+            const w = sellers[i];
+            const ai = sellerAis[i];
+            const sender = ai.sender;
+            const sellWei = sellAmountsWei[i] ?? 0n;
+            if (sellWei <= 0n)
+                continue;
+            const allowance = sellerAllowances.get(sender) ?? 0n;
+            if (allowance < sellWei) {
+                const approveCallData = encodeExecute(tokenAddress, 0n, encodeApproveCall(effectiveRouter, ethers.MaxUint256));
+                const { userOp: approveOp, prefundWei } = await this.aaManager.buildUserOpWithFixedGas({
+                    ownerWallet: w,
+                    sender,
+                    nonce: nonceMap.next(sender),
+                    initCode: consumeInitCode(sender),
+                    callData: approveCallData,
+                    deployed: ai.deployed,
+                    fixedGas: {
+                        ...(effConfig.fixedGas ?? {}),
+                        callGasLimit: effConfig.fixedGas?.callGasLimit ?? DEFAULT_CALL_GAS_LIMIT_APPROVE,
+                    },
+                });
+                await this.aaManager.ensureSenderBalance(w, sender, prefundWei + parseOkb('0.0001'), `buyFirstDex/seller${i + 1}/approve-fund`);
+                const signedApprove = await this.aaManager.signUserOp(approveOp, w);
+                ops.push(signedApprove.userOp);
+            }
+            const sellSwapData = encodeSwapExactTokensForETHSupportingFee(sellWei, 0n, [tokenAddress, WOKB], sender, deadline);
+            const sellCallData = encodeExecute(effectiveRouter, 0n, sellSwapData);
+            const { userOp: sellOp, prefundWei: sellPrefund } = await this.aaManager.buildUserOpWithFixedGas({
+                ownerWallet: w,
+                sender,
+                nonce: nonceMap.next(sender),
+                initCode: consumeInitCode(sender),
+                callData: sellCallData,
+                deployed: ai.deployed,
+                fixedGas: {
+                    ...(effConfig.fixedGas ?? {}),
+                    callGasLimit: effConfig.fixedGas?.callGasLimit ?? DEFAULT_CALL_GAS_LIMIT_SELL,
+                },
+            });
+            await this.aaManager.ensureSenderBalance(w, sender, sellPrefund + parseOkb('0.0001'), `buyFirstDex/seller${i + 1}/sell-fund`);
+            const signedSell = await this.aaManager.signUserOp(sellOp, w);
+            ops.push(signedSell.userOp);
+        }
+        if (ops.length === 0)
+            throw new Error('本轮没有生成任何 UserOp');
+        const payerWallet = buyers[0];
+        const beneficiary = payerWallet.address;
+        const buySellResult = await this.runHandleOps('aa-buy-first/dex', ops, payerWallet, beneficiary);
+        let withdrawResult;
+        let finalSellerBalances;
+        let totalProfitWei = 0n;
+        if (withdrawToOwner) {
+            const reserveWei = parseOkb(withdrawReserve);
+            const sellerOkbBalances = await this.portalQuery.getMultipleOkbBalances(sellerSenders);
+            const withdrawOps = [];
+            const builtOps = await mapWithConcurrency(sellers, 3, async (w, i) => {
+                const sender = sellerAis[i].sender;
+                const senderBalance = sellerOkbBalances.get(sender) ?? 0n;
+                const usedNonce = nonceMap.peek(sender);
+                const built = await this.buildWithdrawUserOp({
+                    ownerWallet: w,
+                    sender,
+                    nonce: usedNonce,
+                    initCode: '0x',
+                    senderBalance,
+                    reserveWei,
+                    configOverride: config,
+                });
+                if (!built)
+                    return null;
+                nonceMap.commit(sender, usedNonce);
+                totalProfitWei += built.profitWei;
+                const signed = await this.aaManager.signUserOp(built.userOp, w);
+                return signed.userOp;
+            });
+            for (const op of builtOps)
+                if (op)
+                    withdrawOps.push(op);
+            if (withdrawOps.length > 0) {
+                withdrawResult = await this.runHandleOps('aa-buy-first/dex-withdraw', withdrawOps, payerWallet, beneficiary);
+            }
+            finalSellerBalances = await this.portalQuery.getMultipleOkbBalances(sellerSenders);
+        }
+        return {
+            buySellResult,
+            withdrawResult,
+            finalSellerBalances,
+            profit: withdrawToOwner
+                ? {
+                    extractProfit: profitSettings.extractProfit,
+                    profitBps: profitSettings.profitBps,
+                    profitRecipient: profitSettings.profitRecipient,
+                    totalProfitWei: totalProfitWei.toString(),
+                }
+                : undefined,
+            metadata: {
+                tradeType: 'V2',
+                tokenAddress,
+                buyerOwners: buyers.map((w) => w.address),
+                buyerSenders: buyerAis.map((ai) => ai.sender),
+                sellerOwners: sellers.map((w) => w.address),
+                sellerSenders,
+                buyAmountsWei: buyAmountsWei.map((x) => x.toString()),
+                sellAmountsWei: sellAmountsWei.map((x) => x.toString()),
+                totalBuyWei: totalBuyWei.toString(),
+                estimatedTokenOutWei: estimatedTokenOutWei.toString(),
+                slippageBps,
+            },
+        };
+    }
+}
+export function createAADexBuyFirstExecutor(config) {
+    return new AADexBuyFirstExecutor(config);
+}

package/dist/xlayer/dex-volume.d.ts

@@ -0,0 +1,30 @@
+/**
+ * XLayer 外盘刷量/做市 SDK（AA / ERC-4337）
+ *
+ * - 与 `src/xlayer/volume.ts`（内盘）分离
+ * - 底层使用 `DexBundleExecutor.bundleBuySell`（买入 -> 卖出 -> 归集 -> 刮利润）
+ */
+import type { XLayerConfig, VolumeResult } from './types.js';
+export interface DexVolumeParams {
+    tokenAddress: string;
+    privateKeys: string[];
+    buyAmountPerRound: string;
+    rounds: number;
+    intervalMs?: number;
+    sellImmediately?: boolean;
+    sellPercent?: number;
+    withdrawToOwner?: boolean;
+    withdrawReserve?: string;
+    dexKey?: string;
+    routerAddress?: string;
+    deadlineMinutes?: number;
+    config?: Partial<XLayerConfig>;
+}
+export declare class DexVolumeExecutor {
+    private dexBundleExecutor;
+    private config;
+    constructor(config?: XLayerConfig);
+    execute(params: DexVolumeParams): Promise<VolumeResult>;
+}
+export declare function createDexVolumeExecutor(config?: XLayerConfig): DexVolumeExecutor;
+export declare function makeDexVolume(params: DexVolumeParams): Promise<VolumeResult>;

package/dist/xlayer/dex-volume.js

@@ -0,0 +1,80 @@
+/**
+ * XLayer 外盘刷量/做市 SDK（AA / ERC-4337）
+ *
+ * - 与 `src/xlayer/volume.ts`（内盘）分离
+ * - 底层使用 `DexBundleExecutor.bundleBuySell`（买入 -> 卖出 -> 归集 -> 刮利润）
+ */
+import { parseOkb, formatOkb } from './portal-ops.js';
+import { DexBundleExecutor } from './dex-bundle.js';
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export class DexVolumeExecutor {
+    constructor(config = {}) {
+        this.config = config;
+        this.dexBundleExecutor = new DexBundleExecutor(config);
+    }
+    async execute(params) {
+        const { tokenAddress, privateKeys, buyAmountPerRound, rounds, intervalMs = 3000, sellImmediately = true, sellPercent, withdrawToOwner = true, withdrawReserve, dexKey, routerAddress, deadlineMinutes, config, } = params;
+        console.log('=== XLayer DEX Volume Maker ===');
+        console.log('token:', tokenAddress);
+        console.log('owners:', privateKeys.length);
+        console.log('rounds:', rounds);
+        console.log('buyAmountPerRound:', buyAmountPerRound, 'OKB');
+        console.log('intervalMs:', intervalMs);
+        console.log('sellImmediately:', sellImmediately);
+        const roundResults = [];
+        let successRounds = 0;
+        let failedRounds = 0;
+        let totalVolume = 0n;
+        const buyWei = parseOkb(buyAmountPerRound);
+        for (let round = 0; round < rounds; round++) {
+            console.log(`\n========== DEX Round ${round + 1}/${rounds} ==========`);
+            try {
+                const buyAmounts = privateKeys.map(() => buyAmountPerRound);
+                const effSellPercent = typeof sellPercent === 'number' ? sellPercent : (sellImmediately ? 100 : 0);
+                const result = await this.dexBundleExecutor.bundleBuySell({
+                    tokenAddress,
+                    privateKeys,
+                    buyAmounts,
+                    sellPercent: effSellPercent,
+                    withdrawToOwner,
+                    withdrawReserve,
+                    dexKey,
+                    routerAddress,
+                    deadlineMinutes,
+                    config: { ...(this.config ?? {}), ...(config ?? {}) },
+                });
+                roundResults.push(result);
+                successRounds++;
+                totalVolume += buyWei * BigInt(privateKeys.length);
+                console.log(`DEX Round ${round + 1} 完成`);
+            }
+            catch (error) {
+                console.error(`DEX Round ${round + 1} 失败:`, error);
+                failedRounds++;
+            }
+            if (round < rounds - 1 && intervalMs > 0) {
+                console.log(`等待 ${intervalMs}ms...`);
+                await sleep(intervalMs);
+            }
+        }
+        console.log('\n=== DEX Volume Summary ===');
+        console.log('成功轮数:', successRounds);
+        console.log('失败轮数:', failedRounds);
+        console.log('总交易量:', formatOkb(totalVolume), 'OKB');
+        return {
+            successRounds,
+            failedRounds,
+            roundResults,
+            totalVolume,
+        };
+    }
+}
+export function createDexVolumeExecutor(config) {
+    return new DexVolumeExecutor(config);
+}
+export async function makeDexVolume(params) {
+    const executor = createDexVolumeExecutor(params.config);
+    return executor.execute(params);
+}

package/dist/xlayer/index.d.ts

@@ -63,8 +63,12 @@ export { BundlerClient, createBundlerClient, type BundlerConfig, type BundlerRec
 export { AAAccountManager, createAAAccountManager, predictSender, createWallet, encodeExecute, encodeExecuteBatch, generateAAWallets, generateAAWalletsFromMnemonic, predictSendersFromPrivateKeys, type GeneratedAAWallet, type GenerateAAWalletsParams, type GenerateAAWalletsResult, } from './aa-account.js';
 export { encodeBuyCall, encodeSellCall, encodeApproveCall, encodeTransferCall, PortalQuery, createPortalQuery, applySlippage, formatOkb, parseOkb, formatTokenAmount, parseTokenAmount, type PortalQueryConfig, } from './portal-ops.js';
 export { BundleExecutor, createBundleExecutor, bundleBuy, bundleSell, bundleBuySell, } from './bundle.js';
+export { DexBundleExecutor, createDexBundleExecutor, dexBundleBuySell, type DexBundleConfig, type DexBundleBuySellParams, } from './dex-bundle.js';
 export { AAPortalSwapExecutor, } from './portal-bundle-swap.js';
 export { AADexSwapExecutor, } from './dex-bundle-swap.js';
+export { AAPortalBuyFirstExecutor, createAAPortalBuyFirstExecutor, } from './portal-buy-first.js';
+export { AADexBuyFirstExecutor, createAADexBuyFirstExecutor, } from './dex-buy-first.js';
+export { BuyFirstVolumeExecutor, createBuyFirstVolumeExecutor, makeBuyFirstVolume, } from './buy-first-volume.js';
 /**
  * XLayer AA 换手签名 (卖 -> 买)
  */
@@ -78,6 +82,7 @@ export declare function bundleBatchSwapSign(params: BundleBatchSwapSignParams &
     skipApprovalCheck?: boolean;
 }): Promise<BundleBatchSwapSignResult>;
 export { VolumeExecutor, createVolumeExecutor, makeVolume, singleRoundVolume, } from './volume.js';
+export { DexVolumeExecutor, createDexVolumeExecutor, makeDexVolume, type DexVolumeParams, } from './dex-volume.js';
 export { DexQuery, DexExecutor, createDexQuery, createDexExecutor, quoteOkbToToken, quoteTokenToOkb, encodeSwapExactETHForTokens, encodeSwapExactTokensForETH, encodeSwapExactTokensForTokens, encodeSwapExactETHForTokensSupportingFee, encodeSwapExactTokensForETHSupportingFee, encodeSwapExactTokensForTokensSupportingFee, type DexConfig, } from './dex.js';
 export declare const xlayer: {
     bundleBuy: (params: import("./types.js").BundleBuyParams) => Promise<import("./types.js").BundleBuyResult>;

package/dist/xlayer/index.js

@@ -83,10 +83,20 @@ export { encodeBuyCall, encodeSellCall, encodeApproveCall, encodeTransferCall, P
 // ============================================================================
 export { BundleExecutor, createBundleExecutor, bundleBuy, bundleSell, bundleBuySell, } from './bundle.js';
 // ============================================================================
+// 外盘捆绑交易（DEX Bundle）
+// ============================================================================
+export { DexBundleExecutor, createDexBundleExecutor, dexBundleBuySell, } from './dex-bundle.js';
+// ============================================================================
 // 捆绑换手 (AASwap)
 // ============================================================================
 export { AAPortalSwapExecutor, } from './portal-bundle-swap.js';
 export { AADexSwapExecutor, } from './dex-bundle-swap.js';
+// ============================================================================
+// AA Buy-First（刷量专用）
+// ============================================================================
+export { AAPortalBuyFirstExecutor, createAAPortalBuyFirstExecutor, } from './portal-buy-first.js';
+export { AADexBuyFirstExecutor, createAADexBuyFirstExecutor, } from './dex-buy-first.js';
+export { BuyFirstVolumeExecutor, createBuyFirstVolumeExecutor, makeBuyFirstVolume, } from './buy-first-volume.js';
 /**
  * XLayer AA 换手签名 (卖 -> 买)
  */
@@ -116,6 +126,10 @@ export async function bundleBatchSwapSign(params) {
 // ============================================================================
 export { VolumeExecutor, createVolumeExecutor, makeVolume, singleRoundVolume, } from './volume.js';
 // ============================================================================
+// 外盘刷量/做市（DEX Volume）
+// ============================================================================
+export { DexVolumeExecutor, createDexVolumeExecutor, makeDexVolume, } from './dex-volume.js';
+// ============================================================================
 // 外盘交易 (DEX)
 // ============================================================================
 export { DexQuery, DexExecutor, createDexQuery, createDexExecutor, quoteOkbToToken, quoteTokenToOkb,