four-flap-meme-sdk 1.5.31 → 1.5.33

package/dist/xlayer/bundle.js

@@ -9,9 +9,10 @@
  */
 import { Wallet, Interface, Contract } from 'ethers';
 import { FLAP_PORTAL, ENTRYPOINT_ABI, DEFAULT_CALL_GAS_LIMIT_SELL, DEFAULT_WITHDRAW_RESERVE, } from './constants.js';
-import { AAAccountManager, encodeExecute } from './aa-account.js';
+import { AAAccountManager, encodeExecute, encodeExecuteBatch } from './aa-account.js';
 import { encodeBuyCall, encodeSellCall, encodeApproveCall, encodeTransferCall, PortalQuery, parseOkb, formatOkb, } from './portal-ops.js';
 import { mapWithConcurrency } from '../utils/concurrency.js';
+import { PROFIT_CONFIG } from '../utils/constants.js';
 // ============================================================================
 // AA Nonce（EntryPoint nonce）本地分配器
 // ============================================================================
@@ -72,6 +73,21 @@ const DEFAULT_CALL_GAS_LIMIT_BUY = DEFAULT_CALL_GAS_LIMIT_SELL; // buy 与 sell
 const DEFAULT_CALL_GAS_LIMIT_APPROVE = 200000n;
 const DEFAULT_CALL_GAS_LIMIT_TRANSFER = 150000n;
 const DEFAULT_CALL_GAS_LIMIT_WITHDRAW = 120000n;
+function resolveProfitSettings(config) {
+    const extractProfit = config?.extractProfit !== false; // 默认 true
+    // ✅ 对齐 bundle/刷量模式默认费率（与 BSC bundle-buy-first 语义一致）
+    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;
+}
 /**
  * XLayer 捆绑交易执行器
  *
@@ -418,7 +434,14 @@ export class BundleExecutor {
             console.log(`\n[${params.ownerName ?? 'owner'}] 归集后可转出=0（余额不足以覆盖 prefund+reserve）`);
             return null;
         }
-        const callData = encodeExecute(params.ownerWallet.address, withdrawAmount, '0x');
+        // ✅ 利润提取：从“归集金额”里按 bps 刮取一部分转到 profitRecipient
+        const effConfig = { ...(this.config ?? {}), ...(params.configOverride ?? {}) };
+        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,
@@ -447,7 +470,12 @@ export class BundleExecutor {
                     nonce: params.nonce,
                     initCode: params.initCode,
                 });
-        console.log(`\n[${params.ownerName ?? 'owner'}] withdraw: ${formatOkb(withdrawAmount)} OKB`);
+        if (extractProfit && profitWei > 0n) {
+            console.log(`\n[${params.ownerName ?? 'owner'}] withdraw: ${formatOkb(toOwnerWei)} OKB (profit: ${formatOkb(profitWei)} OKB -> ${profitRecipient})`);
+        }
+        else {
+            console.log(`\n[${params.ownerName ?? 'owner'}] withdraw: ${formatOkb(withdrawAmount)} OKB`);
+        }
         const signed = await this.aaManager.signUserOp(userOp, params.ownerWallet);
         return { ...signed, prefundWei, ownerName: params.ownerName };
     }
@@ -596,7 +624,7 @@ export class BundleExecutor {
      * 多个地址同一笔 handleOps 卖出代币
      */
     async bundleSell(params) {
-        const { tokenAddress, privateKeys, sellPercent = 100, withdrawToOwner = true, withdrawReserve = DEFAULT_WITHDRAW_RESERVE, } = params;
+        const { tokenAddress, privateKeys, sellPercent = 100, withdrawToOwner = true, withdrawReserve = DEFAULT_WITHDRAW_RESERVE, config, } = params;
         const sharedProvider = this.aaManager.getProvider();
         const wallets = privateKeys.map((pk) => new Wallet(pk, sharedProvider));
         const bundlerSigner = wallets[0];
@@ -679,6 +707,9 @@ export class BundleExecutor {
         }
         // 3. 可选：归集 OKB
         let withdrawResult;
+        let totalProfitWei = 0n;
+        const effProfitCfg = { ...(this.config ?? {}), ...(config ?? {}) };
+        const profitSettings = resolveProfitSettings(effProfitCfg);
         if (withdrawToOwner) {
             const withdrawOps = [];
             // 批量获取 sender OKB 余额
@@ -702,7 +733,14 @@ export class BundleExecutor {
                     senderBalance: it.senderBalance,
                     reserveWei,
                     ownerName: `owner${it.i + 1}`,
+                    configOverride: config,
                 });
+                if (signed && profitSettings.extractProfit) {
+                    const withdrawAmount = it.senderBalance > signed.prefundWei + reserveWei
+                        ? it.senderBalance - signed.prefundWei - reserveWei
+                        : 0n;
+                    totalProfitWei += calculateProfitWei(withdrawAmount, profitSettings.profitBps);
+                }
                 if (signed?.userOp)
                     nonceMap.commit(it.sender, it.nonce);
                 return signed?.userOp ?? null;
@@ -715,7 +753,19 @@ export class BundleExecutor {
                 withdrawResult = await this.runHandleOps('withdrawBundle', withdrawOps, bundlerSigner, beneficiary) ?? undefined;
             }
         }
-        return { approveResult, sellResult, withdrawResult };
+        return {
+            approveResult,
+            sellResult,
+            withdrawResult,
+            profit: withdrawToOwner
+                ? {
+                    extractProfit: profitSettings.extractProfit,
+                    profitBps: profitSettings.profitBps,
+                    profitRecipient: profitSettings.profitRecipient,
+                    totalProfitWei: totalProfitWei.toString(),
+                }
+                : undefined,
+        };
     }
     /**
      * 捆绑买卖（先买后卖）
@@ -723,7 +773,7 @@ export class BundleExecutor {
      * 完整流程：买入 -> 授权 -> 卖出 -> 归集
      */
     async bundleBuySell(params) {
-        const { tokenAddress, privateKeys, buyAmounts, sellPercent = 100, withdrawToOwner = true, withdrawReserve = DEFAULT_WITHDRAW_RESERVE, } = params;
+        const { tokenAddress, privateKeys, buyAmounts, sellPercent = 100, withdrawToOwner = true, withdrawReserve = DEFAULT_WITHDRAW_RESERVE, config, } = params;
         if (privateKeys.length !== buyAmounts.length) {
             throw new Error('私钥数量和购买金额数量必须一致');
         }
@@ -810,6 +860,9 @@ export class BundleExecutor {
         }
         // 3. 可选：归集 OKB
         let withdrawResult;
+        let totalProfitWei = 0n;
+        const effProfitCfg = { ...(this.config ?? {}), ...(config ?? {}) };
+        const profitSettings = resolveProfitSettings(effProfitCfg);
         if (withdrawToOwner) {
             const withdrawOps = [];
             // 批量获取 OKB 余额（sell 后状态）
@@ -831,7 +884,14 @@ export class BundleExecutor {
                     senderBalance: it.senderBalance,
                     reserveWei,
                     ownerName: `owner${it.i + 1}`,
+                    configOverride: config,
                 });
+                if (signed && profitSettings.extractProfit) {
+                    const withdrawAmount = it.senderBalance > signed.prefundWei + reserveWei
+                        ? it.senderBalance - signed.prefundWei - reserveWei
+                        : 0n;
+                    totalProfitWei += calculateProfitWei(withdrawAmount, profitSettings.profitBps);
+                }
                 if (signed?.userOp)
                     nonceMap.commit(it.sender, it.nonce);
                 return signed?.userOp ?? null;
@@ -846,7 +906,20 @@ export class BundleExecutor {
         }
         // 最终余额
         const finalBalances = await this.portalQuery.getMultipleOkbBalances(senders);
-        return { buyResult, sellResult, withdrawResult, finalBalances };
+        return {
+            buyResult,
+            sellResult,
+            withdrawResult,
+            finalBalances,
+            profit: withdrawToOwner
+                ? {
+                    extractProfit: profitSettings.extractProfit,
+                    profitBps: profitSettings.profitBps,
+                    profitRecipient: profitSettings.profitRecipient,
+                    totalProfitWei: totalProfitWei.toString(),
+                }
+                : undefined,
+        };
     }
 }
 // ============================================================================

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

@@ -3,11 +3,48 @@
  */
 import { Wallet, ethers } from 'ethers';
 import { AANonceMap, } from './types.js';
-import { POTATOSWAP_V2_ROUTER, WOKB, } from './constants.js';
+import { POTATOSWAP_V2_ROUTER, WOKB, MULTICALL3, } from './constants.js';
 import { AAAccountManager, encodeExecute } from './aa-account.js';
 import { encodeApproveCall, } from './portal-ops.js';
 import { DexQuery, encodeSwapExactETHForTokensSupportingFee, encodeSwapExactTokensForETHSupportingFee, } from './dex.js';
 import { BundleExecutor } from './bundle.js';
+import { PROFIT_CONFIG } from '../utils/constants.js';
+const multicallIface = new ethers.Interface([
+    'function aggregate3Value((address target,bool allowFailure,uint256 value,bytes callData)[] calls) payable returns ((bool success,bytes returnData)[] returnData)',
+]);
+function chunkArray(arr, size) {
+    const out = [];
+    const n = Math.max(1, Math.floor(size));
+    for (let i = 0; i < arr.length; i += n)
+        out.push(arr.slice(i, i + n));
+    return out;
+}
+function encodeNativeDisperseViaMulticall3(params) {
+    const calls = params.to.map((target, idx) => ({
+        target,
+        allowFailure: false,
+        value: params.values[idx] ?? 0n,
+        callData: '0x',
+    }));
+    const totalValue = params.values.reduce((a, b) => a + (b ?? 0n), 0n);
+    const data = multicallIface.encodeFunctionData('aggregate3Value', [calls]);
+    return { totalValue, data };
+}
+function resolveProfitSettings(config) {
+    const extractProfit = config?.extractProfit !== false; // 默认 true（对齐 BSC）
+    // ✅ 对齐 BSC “捆绑换手模式”默认费率
+    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 getDexDeadline(minutes = 20) {
     return Math.floor(Date.now() / 1000) + minutes * 60;
 }
@@ -39,7 +76,9 @@ export class AADexSwapExecutor {
      * AA 外盘单钱包换手签名
      */
     async bundleSwapSign(params) {
-        const { dexKey, routerAddress: routerAddressIn, tokenAddress, sellerPrivateKey, buyerPrivateKey, sellAmount, sellPercent = 100, buyAmountOkb, slippageBps = 100, payerPrivateKey, beneficiary: beneficiaryIn, payerStartNonce, routeAddress, skipApprovalCheck = false, } = params;
+        const { dexKey, routerAddress: routerAddressIn, tokenAddress, sellerPrivateKey, buyerPrivateKey, sellAmount, sellPercent = 100, buyAmountOkb, slippageBps = 100, disperseHopCount: disperseHopCountIn, payerPrivateKey, beneficiary: beneficiaryIn, payerStartNonce, routeAddress, skipApprovalCheck = false, } = params;
+        const effectiveConfig = { ...(this.config ?? {}), ...(params.config ?? {}) };
+        const { extractProfit, profitBps, profitRecipient } = resolveProfitSettings(effectiveConfig);
         const effectiveRouter = this.getEffectiveRouter({ dexKey, routerAddress: routerAddressIn });
         const provider = this.aaManager.getProvider();
         const sellerOwner = new Wallet(sellerPrivateKey, provider);
@@ -84,15 +123,27 @@ export class AADexSwapExecutor {
             const allowance = await this.aaManager.getErc20Allowance(tokenAddress, sellerSender, effectiveRouter);
             needApprove = allowance < sellAmountWei;
         }
-        // 报价
-        let finalBuyAmountWei;
-        if (buyAmountOkb) {
-            finalBuyAmountWei = ethers.parseEther(String(buyAmountOkb));
-        }
-        else {
-            const quoted = await this.dexQuery.quoteTokenToOkb(sellAmountWei, tokenAddress);
-            finalBuyAmountWei = (quoted * BigInt(10000 - slippageBps)) / 10000n;
+        // 估算卖出输出（用于利润提取与 buy 预算）
+        const quotedSellOutWei = await (async () => {
+            try {
+                return await this.dexQuery.quoteTokenToOkb(sellAmountWei, tokenAddress);
+            }
+            catch {
+                return 0n;
+            }
+        })();
+        // buyAmount：若未传则按 quotedSellOut 计算；利润从 quotedSellOut 中刮取，但要保证买入资金充足
+        const requestedBuyWei = buyAmountOkb
+            ? ethers.parseEther(String(buyAmountOkb))
+            : (quotedSellOutWei * BigInt(10000 - slippageBps)) / 10000n;
+        if (quotedSellOutWei > 0n && requestedBuyWei > quotedSellOutWei) {
+            throw new Error('AA 捆绑换手：buyAmountOkb 超过预估卖出输出（quotedSellOut）');
         }
+        const profitWeiRaw = extractProfit ? calculateProfitWei(quotedSellOutWei, profitBps) : 0n;
+        const profitCap = quotedSellOutWei > requestedBuyWei ? (quotedSellOutWei - requestedBuyWei) : 0n;
+        const profitWei = profitWeiRaw > profitCap ? profitCap : profitWeiRaw;
+        const finalBuyAmountWei = requestedBuyWei;
+        const hopCount = Math.max(0, Math.floor(Number(disperseHopCountIn ?? 0)));
         const outOps = [];
         if (needApprove) {
             const { userOp } = await this.aaManager.buildUserOpWithFixedGas({
@@ -118,6 +169,32 @@ export class AADexSwapExecutor {
             signOnly: true,
         });
         outOps.push(signedSell.userOp);
+        // Profit op（紧跟 sell 之后）
+        if (extractProfit && profitWei > 0n) {
+            const profitCallData = encodeExecute(profitRecipient, profitWei, '0x');
+            const signedProfit = await this.aaManager.buildUserOpWithState({
+                ownerWallet: sellerOwner,
+                sender: sellerSender,
+                nonce: nonceMap.next(sellerSender),
+                initCode: consumeInitCode(sellerSender),
+                callData: profitCallData,
+                signOnly: true,
+            });
+            outOps.push(signedProfit.userOp);
+        }
+        // ✅ 卖出所得 OKB 转给买方 AA(Sender)
+        if (sellerSender.toLowerCase() !== buyerSender.toLowerCase() && finalBuyAmountWei > 0n) {
+            const transferCallData = encodeExecute(buyerSender, finalBuyAmountWei, '0x');
+            const signedTransfer = await this.aaManager.buildUserOpWithState({
+                ownerWallet: sellerOwner,
+                sender: sellerSender,
+                nonce: nonceMap.next(sellerSender),
+                initCode: consumeInitCode(sellerSender),
+                callData: transferCallData,
+                signOnly: true,
+            });
+            outOps.push(signedTransfer.userOp);
+        }
         // Buy op
         const buySwapData = encodeSwapExactETHForTokensSupportingFee(0n, [WOKB, tokenAddress], buyerSender, getDexDeadline());
         const buyCallData = encodeExecute(effectiveRouter, finalBuyAmountWei, buySwapData);
@@ -163,6 +240,12 @@ export class AADexSwapExecutor {
                 buyAmountWei: finalBuyAmountWei.toString(),
                 hasApprove: needApprove,
                 routeAddress,
+                extractProfit,
+                profitBps,
+                profitRecipient,
+                profitWei: profitWei.toString(),
+                quotedSellOutWei: quotedSellOutWei.toString(),
+                disperseHopCount: String(hopCount),
             },
         };
     }
@@ -170,7 +253,9 @@ export class AADexSwapExecutor {
      * AA 外盘批量换手签名
      */
     async bundleBatchSwapSign(params) {
-        const { dexKey, routerAddress: routerAddressIn, tokenAddress, sellerPrivateKey, buyerPrivateKeys, buyAmountsOkb, sellAmount, sellPercent = 100, payerPrivateKey, beneficiary: beneficiaryIn, payerStartNonce, routeAddress, skipApprovalCheck = false, } = params;
+        const { dexKey, routerAddress: routerAddressIn, tokenAddress, sellerPrivateKey, buyerPrivateKeys, buyAmountsOkb, sellAmount, sellPercent = 100, disperseHopCount: disperseHopCountIn, payerPrivateKey, beneficiary: beneficiaryIn, payerStartNonce, routeAddress, skipApprovalCheck = false, } = params;
+        const effectiveConfig = { ...(this.config ?? {}), ...(params.config ?? {}) };
+        const { extractProfit, profitBps, profitRecipient } = resolveProfitSettings(effectiveConfig);
         const effectiveRouter = this.getEffectiveRouter({ dexKey, routerAddress: routerAddressIn });
         const provider = this.aaManager.getProvider();
         const sellerOwner = new Wallet(sellerPrivateKey, provider);
@@ -239,8 +324,122 @@ export class AADexSwapExecutor {
             signOnly: true,
         });
         outOps.push(signedSell.userOp);
-        // Batch Buy ops
+        // 先计算 buyAmountsWei（用于后续分发与校验）
         const buyAmountsWei = buyAmountsOkb.map(a => ethers.parseEther(a));
+        const totalBuyWei = buyAmountsWei.reduce((a, b) => a + (b ?? 0n), 0n);
+        // Profit op：估算卖出输出，按比例刮取（但必须保证分发/买入资金充足）
+        const quotedSellOutWei = await (async () => {
+            try {
+                return await this.dexQuery.quoteTokenToOkb(sellAmountWei, tokenAddress);
+            }
+            catch {
+                return 0n;
+            }
+        })();
+        if (quotedSellOutWei > 0n && totalBuyWei > quotedSellOutWei) {
+            throw new Error('AA 批量换手：buyAmountsOkb 总和超过预估卖出输出（quotedSellOut）');
+        }
+        const profitWeiRaw = extractProfit ? calculateProfitWei(quotedSellOutWei, profitBps) : 0n;
+        const profitCap = quotedSellOutWei > totalBuyWei ? (quotedSellOutWei - totalBuyWei) : 0n;
+        const profitWei = profitWeiRaw > profitCap ? profitCap : profitWeiRaw;
+        if (extractProfit && profitWei > 0n) {
+            const profitCallData = encodeExecute(profitRecipient, profitWei, '0x');
+            const signedProfit = await this.aaManager.buildUserOpWithState({
+                ownerWallet: sellerOwner,
+                sender: sellerAi.sender,
+                nonce: nonceMap.next(sellerAi.sender),
+                initCode: consumeInitCode(sellerAi.sender),
+                callData: profitCallData,
+                signOnly: true,
+            });
+            outOps.push(signedProfit.userOp);
+        }
+        // ✅ 卖出所得 OKB 分发给多个买方 AA(Sender)（支持多跳）
+        const buyerSenders = buyerAis.map(ai => ai.sender);
+        const hopCountRaw = Math.max(0, Math.floor(Number(disperseHopCountIn ?? 0)));
+        const hopCount = Math.min(hopCountRaw, buyerSenders.length);
+        const maxPerOp = Math.max(1, Math.floor(Number(effectiveConfig.maxTransfersPerUserOpNative ?? 30)));
+        if (buyerSenders.length > 0 && totalBuyWei > 0n) {
+            if (hopCount <= 0) {
+                const items = buyerSenders.map((to, i) => ({ to, value: buyAmountsWei[i] ?? 0n })).filter(x => x.value > 0n);
+                const chunks = chunkArray(items, maxPerOp);
+                for (const ch of chunks) {
+                    const { totalValue, data } = encodeNativeDisperseViaMulticall3({
+                        to: ch.map(x => x.to),
+                        values: ch.map(x => x.value),
+                    });
+                    const callData = encodeExecute(MULTICALL3, totalValue, data);
+                    const signedDisperse = await this.aaManager.buildUserOpWithState({
+                        ownerWallet: sellerOwner,
+                        sender: sellerAi.sender,
+                        nonce: nonceMap.next(sellerAi.sender),
+                        initCode: consumeInitCode(sellerAi.sender),
+                        callData,
+                        signOnly: true,
+                    });
+                    outOps.push(signedDisperse.userOp);
+                }
+            }
+            else {
+                const hopSenders = buyerSenders.slice(0, hopCount);
+                const hopOwners = buyerOwners.slice(0, hopCount);
+                const hop0 = hopSenders[0];
+                const callData0 = encodeExecute(hop0, totalBuyWei, '0x');
+                const signedToHop0 = await this.aaManager.buildUserOpWithState({
+                    ownerWallet: sellerOwner,
+                    sender: sellerAi.sender,
+                    nonce: nonceMap.next(sellerAi.sender),
+                    initCode: consumeInitCode(sellerAi.sender),
+                    callData: callData0,
+                    signOnly: true,
+                });
+                outOps.push(signedToHop0.userOp);
+                let prefixKept = 0n;
+                for (let j = 0; j < hopSenders.length - 1; j++) {
+                    const sender = hopSenders[j];
+                    const next = hopSenders[j + 1];
+                    const keep = buyAmountsWei[j] ?? 0n;
+                    prefixKept += keep;
+                    const remaining = totalBuyWei - prefixKept;
+                    if (remaining <= 0n)
+                        break;
+                    const callData = encodeExecute(next, remaining, '0x');
+                    const signedHop = await this.aaManager.buildUserOpWithState({
+                        ownerWallet: hopOwners[j],
+                        sender,
+                        nonce: nonceMap.next(sender),
+                        initCode: consumeInitCode(sender),
+                        callData,
+                        signOnly: true,
+                    });
+                    outOps.push(signedHop.userOp);
+                }
+                const lastHopIdx = hopSenders.length - 1;
+                const lastHopSender = hopSenders[lastHopIdx];
+                const lastHopOwner = hopOwners[lastHopIdx];
+                const rest = buyerSenders.slice(hopSenders.length);
+                const restAmounts = buyAmountsWei.slice(hopSenders.length);
+                const restItems = rest.map((to, i) => ({ to, value: restAmounts[i] ?? 0n })).filter(x => x.value > 0n);
+                const restChunks = chunkArray(restItems, maxPerOp);
+                for (const ch of restChunks) {
+                    const { totalValue, data } = encodeNativeDisperseViaMulticall3({
+                        to: ch.map(x => x.to),
+                        values: ch.map(x => x.value),
+                    });
+                    const callData = encodeExecute(MULTICALL3, totalValue, data);
+                    const signedDisperse = await this.aaManager.buildUserOpWithState({
+                        ownerWallet: lastHopOwner,
+                        sender: lastHopSender,
+                        nonce: nonceMap.next(lastHopSender),
+                        initCode: consumeInitCode(lastHopSender),
+                        callData,
+                        signOnly: true,
+                    });
+                    outOps.push(signedDisperse.userOp);
+                }
+            }
+        }
+        // Batch Buy ops（分发后再执行）
         for (let i = 0; i < buyerOwners.length; i++) {
             const ai = buyerAis[i];
             const buyWei = buyAmountsWei[i];
@@ -289,6 +488,12 @@ export class AADexSwapExecutor {
                 buyAmountsWei: buyAmountsWei.map(w => w.toString()),
                 hasApprove: needApprove,
                 routeAddress,
+                extractProfit,
+                profitBps,
+                profitRecipient,
+                profitWei: profitWei.toString(),
+                quotedSellOutWei: quotedSellOutWei.toString(),
+                disperseHopCount: String(hopCount),
             },
         };
     }

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

@@ -0,0 +1,42 @@
+/**
+ * XLayer 外盘（PotatoSwap/DEX）捆绑交易 SDK（AA / ERC-4337）
+ *
+ * 目标：对齐内盘 `bundle.ts` 的能力，但 Router/报价/授权逻辑走 DEX。
+ * - 捆绑买卖（买入 ->（可选授权）-> 卖出 ->（可选归集））
+ * - 自动归集 OKB 到 owner
+ * - ✅ 支持“刮取利润”：在归集时从可转出金额中按 bps 拆分转到 PROFIT_CONFIG.RECIPIENT
+ */
+import type { XLayerConfig, BundleBuySellResult, BundleBuySellParams } from './types.js';
+export interface DexBundleConfig extends XLayerConfig {
+    dexKey?: string;
+    routerAddress?: string;
+    deadlineMinutes?: number;
+}
+export interface DexBundleBuySellParams extends BundleBuySellParams {
+    dexKey?: string;
+    routerAddress?: string;
+    deadlineMinutes?: number;
+}
+/**
+ * 外盘捆绑交易执行器
+ */
+export declare class DexBundleExecutor {
+    private aaManager;
+    private portalQuery;
+    private dexQuery;
+    private config;
+    constructor(config?: DexBundleConfig);
+    private getEffectiveRouter;
+    private getDeadlineMinutes;
+    /**
+     * 执行 handleOps 并解析结果
+     */
+    private runHandleOps;
+    private buildWithdrawUserOpWithState;
+    /**
+     * 外盘捆绑买卖（先买后卖）
+     */
+    bundleBuySell(params: DexBundleBuySellParams): Promise<BundleBuySellResult>;
+}
+export declare function createDexBundleExecutor(config?: DexBundleConfig): DexBundleExecutor;
+export declare function dexBundleBuySell(params: DexBundleBuySellParams): Promise<BundleBuySellResult>;