four-flap-meme-sdk 1.9.49 → 2.0.0

package/dist/chains/bsc/four/internal.js

@@ -1,239 +1,4 @@
-import { ethers, Wallet } from 'ethers';
-import { ADDRESSES } from '../../../utils/constants.js';
-import { MULTICALL3_ABI, ERC20_BALANCE_ABI } from '../../../shared/abis/common.js';
-import { CHAINS, GAS_LIMITS } from '../../../shared/constants/index.js';
-// 内部缓存：ERC20 小数位
-const decimalsCache = new Map();
 /**
- * 获取 ERC20 代币精度（带缓存）
- * ✅ 优化：避免每次调用都获取 network，直接使用传入的 chainId
+ * @deprecated 实现已迁移至 bundle-core/internal.ts，此处仅 re-export 保持 import 路径不变。
  */
-export async function getErc20DecimalsMerkle(provider, token, chainId) {
-    // ✅ 修复：不访问 provider._network（ethers v6 可能未准备好导致 NETWORK_ERROR）
-    // 直接使用传入的 chainId，如果没传则默认 56 (BSC)
-    const resolvedChainId = chainId ?? 56;
-    const key = `${resolvedChainId}_${token.toLowerCase()}`;
-    if (decimalsCache.has(key))
-        return decimalsCache.get(key);
-    try {
-        const erc20 = new ethers.Contract(token, ['function decimals() view returns (uint8)'], provider);
-        const d = await erc20.decimals();
-        if (!Number.isFinite(d) || d < 0 || d > 36)
-            return 18;
-        decimalsCache.set(key, d);
-        return d;
-    }
-    catch {
-        return 18;
-    }
-}
-/**
- * ✅ 生成多跳中间钱包（返回完整钱包信息：地址 + 私钥）
- */
-export function generateHopWallets(recipientCount, hopCount) {
-    const hopCounts = Array.isArray(hopCount) ? hopCount : new Array(recipientCount).fill(hopCount);
-    if (hopCounts.every(h => h <= 0))
-        return null;
-    const result = [];
-    for (let i = 0; i < recipientCount; i++) {
-        const chain = [];
-        for (let j = 0; j < hopCounts[i]; j++) {
-            const wallet = Wallet.createRandom();
-            chain.push({
-                address: wallet.address,
-                privateKey: wallet.privateKey
-            });
-        }
-        result.push(chain);
-    }
-    return result;
-}
-export function normalizeAmounts(recipients, amount, amounts) {
-    if (amounts && amounts.length > 0) {
-        if (amounts.length !== recipients.length) {
-            throw new Error(`amounts length (${amounts.length}) must match recipients length (${recipients.length})`);
-        }
-        return amounts.map(a => (typeof a === 'bigint' ? a.toString() : String(a)));
-    }
-    if (amount !== undefined && String(amount).trim().length > 0) {
-        return new Array(recipients.length).fill(typeof amount === 'bigint' ? amount.toString() : String(amount));
-    }
-    throw new Error('Either amount or amounts must be provided');
-}
-/**
- * 批量获取余额（原生代币或 ERC20）
- * ✅ 优化：原生代币也使用 Multicall3 批量获取，减少 RPC 调用
- */
-export async function batchGetBalances(provider, addresses, tokenAddress) {
-    if (addresses.length === 0)
-        return [];
-    // ✅ 使用公共模块
-    const MULTICALL3_ADDRESS = ADDRESSES.BSC.Multicall3;
-    const multicall = new ethers.Contract(MULTICALL3_ADDRESS, MULTICALL3_ABI, provider);
-    if (!tokenAddress) {
-        // ✅ 优化：原生代币使用 Multicall3.getEthBalance 批量获取（单次 RPC 调用）
-        const multicallIface = new ethers.Interface(MULTICALL3_ABI);
-        const calls = addresses.map(addr => ({
-            target: MULTICALL3_ADDRESS,
-            allowFailure: true,
-            callData: multicallIface.encodeFunctionData('getEthBalance', [addr])
-        }));
-        try {
-            const results = await multicall.aggregate3(calls);
-            return results.map((result) => {
-                if (result.success && result.returnData && result.returnData !== '0x') {
-                    try {
-                        const decoded = multicallIface.decodeFunctionResult('getEthBalance', result.returnData);
-                        return decoded[0];
-                    }
-                    catch {
-                        return 0n;
-                    }
-                }
-                return 0n;
-            });
-        }
-        catch {
-            // ✅ 回退：并行调用（如果 Multicall3 失败）
-            return Promise.all(addresses.map(addr => provider.getBalance(addr).catch(() => 0n)));
-        }
-    }
-    else {
-        // ✅ ERC20 余额：使用 Multicall3 批量获取
-        const iface = new ethers.Interface(ERC20_BALANCE_ABI);
-        const calls = addresses.map(addr => ({
-            target: tokenAddress,
-            allowFailure: true,
-            callData: iface.encodeFunctionData('balanceOf', [addr])
-        }));
-        try {
-            const results = await multicall.aggregate3(calls);
-            return results.map((result) => {
-                if (result.success && result.returnData && result.returnData !== '0x') {
-                    try {
-                        return iface.decodeFunctionResult('balanceOf', result.returnData)[0];
-                    }
-                    catch {
-                        return 0n;
-                    }
-                }
-                return 0n;
-            });
-        }
-        catch {
-            // ✅ 回退：并行调用（如果 Multicall3 失败）
-            const fallbackCalls = addresses.map(addr => provider
-                .call({ to: tokenAddress, data: iface.encodeFunctionData('balanceOf', [addr]) })
-                .then(raw => iface.decodeFunctionResult('balanceOf', raw)[0])
-                .catch(() => 0n));
-            return Promise.all(fallbackCalls);
-        }
-    }
-}
-/**
- * 通过模拟交易获取 ERC20 转账的最小 Gas Limit
- * ✅ 使用 eth_estimateGas 预估实际需要的 gas，然后加一个小的缓冲量
- *
- * @param provider - Provider 实例
- * @param tokenAddress - ERC20 代币地址
- * @param from - 发送方地址
- * @param to - 接收方地址
- * @param amount - 转账金额（wei）
- * @param bufferPercent - 缓冲百分比（默认 5%）
- * @returns 预估的 gas limit
- */
-export async function estimateErc20TransferGas(provider, tokenAddress, from, to, amount, bufferPercent = 5) {
-    try {
-        const iface = new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
-        const data = iface.encodeFunctionData('transfer', [to, amount]);
-        const estimatedGas = await provider.estimateGas({
-            from,
-            to: tokenAddress,
-            data,
-            value: 0n
-        });
-        // 添加缓冲量（默认 5%）
-        const buffer = (estimatedGas * BigInt(bufferPercent)) / 100n;
-        const finalGas = estimatedGas + buffer;
-        return finalGas;
-    }
-    catch (error) {
-        console.warn(`[estimateErc20TransferGas] 预估失败，使用默认值:`, error);
-        // 回退到默认值
-        return 52000n;
-    }
-}
-/**
- * 批量预估多个 ERC20 转账的 Gas Limit
- * ✅ 选取最大值作为统一的 gas limit（确保所有转账都能成功）
- */
-export async function estimateMaxErc20TransferGas(provider, tokenAddress, from, recipients, amounts, bufferPercent = 5) {
-    if (recipients.length === 0)
-        return 52000n;
-    // 为了减少 RPC 调用，最多预估前 3 个和最后 1 个
-    const sampleIndices = [];
-    sampleIndices.push(0); // 第一个
-    if (recipients.length > 1)
-        sampleIndices.push(Math.min(1, recipients.length - 1));
-    if (recipients.length > 2)
-        sampleIndices.push(Math.min(2, recipients.length - 1));
-    if (recipients.length > 3)
-        sampleIndices.push(recipients.length - 1); // 最后一个
-    // 去重
-    const uniqueIndices = [...new Set(sampleIndices)];
-    try {
-        const estimates = await Promise.all(uniqueIndices.map(i => estimateErc20TransferGas(provider, tokenAddress, from, recipients[i], amounts[i], bufferPercent)));
-        // 取最大值
-        const maxGas = estimates.reduce((max, gas) => gas > max ? gas : max, 0n);
-        return maxGas;
-    }
-    catch (error) {
-        console.warn(`[estimateMaxErc20TransferGas] 批量预估失败，使用默认值:`, error);
-        return 52000n;
-    }
-}
-/**
- * 计算 Gas Limit
- * - 原生代币转账：
- *   - BSC: 21000 gas（固定）
- *   - XLayer: 50000 gas（EIP-7702 授权地址需要更多 gas）
- * - ERC20 标准 transfer：约 45000-55000 gas，使用 55000 作为安全值
- *
- * ✅ 优化：降低 ERC20 gas limit，减少中转钱包 BNB 残留
- * ✅ XLayer 特殊处理：EIP-7702 授权的地址接收 OKB 时会触发 delegate 代码，需要更多 gas
- */
-export function calculateGasLimit(config, isNative, hasHops, hopCount = 0) {
-    if (config.gasLimit !== undefined) {
-        return BigInt(config.gasLimit);
-    }
-    // ✅ XLayer 链原生代币需要更多 gas（EIP-7702 delegate 执行）
-    const isXLayer = config.chainId === CHAINS.XLAYER.chainId;
-    // ✅ 原生代币: BSC 21000, XLayer 50000（EIP-7702 安全）
-    // ✅ ERC20 标准 transfer: 48000（USDT 最低约 46815）
-    const baseGas = isNative
-        ? (isXLayer ? Number(GAS_LIMITS.XLAYER_NATIVE_TRANSFER) : Number(GAS_LIMITS.NATIVE_TRANSFER))
-        : 46815;
-    // ✅ 多跳时只需要累加单次转账的 gas，不需要额外乘数
-    // 每个中转钱包只执行一笔 transfer
-    if (hasHops && hopCount > 0) {
-        // 多跳场景：返回单次转账的 gas limit（中转钱包只执行一笔交易）
-        // 这里不累加，因为每个中转钱包独立执行
-        const multiplier = config.gasLimitMultiplier ?? 1.1; // ✅ 降低安全系数
-        return BigInt(Math.ceil(baseGas * multiplier));
-    }
-    // 无多跳或单次调用：使用较小的安全系数
-    const multiplier = config.gasLimitMultiplier ?? 1.1;
-    return BigInt(Math.ceil(baseGas * multiplier));
-}
-export function isNativeTokenAddress(tokenAddress) {
-    if (!tokenAddress)
-        return true;
-    const v = tokenAddress.trim().toLowerCase();
-    if (!v)
-        return true;
-    if (v === 'native')
-        return true;
-    if (v === '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee')
-        return true;
-    return false;
-}
+export { getErc20Decimals, getErc20DecimalsMerkle, generateHopWallets, normalizeAmounts, batchGetBalances, estimateErc20TransferGas, estimateMaxErc20TransferGas, calculateGasLimit, isNativeTokenAddress, } from '../../../bundle-core/internal.js';

package/dist/chains/bsc/four/pairwise.d.ts

@@ -0,0 +1,7 @@
+import { PairwiseTransferSignParams, PairwiseTransferMerkleResult } from './types.js';
+/**
+ * 分发（仅签名版本 - 不依赖 Merkle）
+ * ✅ 精简版：只负责签名交易，不提交到 Merkle
+ * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
+ */
+export declare function pairwiseTransferWithBundleMerkle(params: PairwiseTransferSignParams): Promise<PairwiseTransferMerkleResult>;

package/dist/chains/bsc/four/pairwise.js

@@ -0,0 +1,308 @@
+import { ethers, Wallet } from 'ethers';
+import { getOptimizedGasPrice, NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT, buildGasFields } from '../../../utils/bundle-helpers.js';
+import { BLOCKRAZOR_BUILDER_EOA, calculateTransferFee } from '../../../utils/constants.js';
+import { GAS_LIMITS, CHAINS } from '../../../shared/constants/index.js';
+import { getTxType, getGasPriceConfig, shouldExtractProfit, getProfitRecipient, getBribeAmount } from './config.js';
+// ==================== Gas 常量（使用统一常量） ====================
+const NATIVE_TRANSFER_GAS_LIMIT = GAS_LIMITS.NATIVE_TRANSFER;
+const BRIBE_GAS_LIMIT = GAS_LIMITS.BRIBE;
+import { getErc20DecimalsMerkle as _getErc20DecimalsMerkle, generateHopWallets as _generateHopWallets, calculateGasLimit as _calculateGasLimit, isNativeTokenAddress as _isNativeTokenAddress } from './internal.js';
+// ==================== 钱包转账按地址收费 ====================
+/**
+ * 分发（仅签名版本 - 不依赖 Merkle）
+ * ✅ 精简版：只负责签名交易，不提交到 Merkle
+ * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
+ */
+export async function pairwiseTransferWithBundleMerkle(params) {
+    const { senderPrivateKeys, receiverAddresses, amount, amounts, tokenAddress, tokenDecimals, hopCount = 0, hopPrivateKeys, config, startNonce, } = params;
+    if (!senderPrivateKeys || senderPrivateKeys.length === 0) {
+        return { signedTransactions: [], hopWallets: undefined };
+    }
+    if (!receiverAddresses || receiverAddresses.length === 0) {
+        return { signedTransactions: [], hopWallets: undefined };
+    }
+    if (senderPrivateKeys.length !== receiverAddresses.length) {
+        throw new Error(`senderPrivateKeys length (${senderPrivateKeys.length}) must match receiverAddresses length (${receiverAddresses.length})`);
+    }
+    const pairCount = senderPrivateKeys.length;
+    const normalizedAmounts = (() => {
+        if (amounts && amounts.length > 0) {
+            if (amounts.length !== pairCount) {
+                throw new Error(`amounts length (${amounts.length}) must match pair count (${pairCount})`);
+            }
+            return amounts.map(a => (typeof a === 'bigint' ? a.toString() : String(a)));
+        }
+        if (amount !== undefined && String(amount).trim().length > 0) {
+            const v = typeof amount === 'bigint' ? amount.toString() : String(amount);
+            return new Array(pairCount).fill(v);
+        }
+        throw new Error('Either amount or amounts must be provided');
+    })();
+    const chainIdNum = config.chainId ?? CHAINS.BSC.chainId;
+    const chainName = chainIdNum === CHAINS.MONAD.chainId ? 'Monad' : chainIdNum === CHAINS.BSC.chainId ? 'BSC' : `Chain-${chainIdNum}`;
+    const provider = new ethers.JsonRpcProvider(config.rpcUrl, { chainId: chainIdNum, name: chainName });
+    const txType = getTxType(config);
+    const isNative = _isNativeTokenAddress(tokenAddress);
+    const nonceManager = new NonceManager(provider);
+    // hop 私钥链优先使用传入
+    const providedHops = (() => {
+        if (hopPrivateKeys && hopPrivateKeys.length > 0) {
+            if (hopPrivateKeys.length !== pairCount) {
+                throw new Error(`hopPrivateKeys length (${hopPrivateKeys.length}) must match pair count (${pairCount})`);
+            }
+            return hopPrivateKeys.every(h => h.length === 0) ? null : hopPrivateKeys;
+        }
+        return null;
+    })();
+    const preparedHops = providedHops ?? _generateHopWallets(pairCount, hopCount);
+    const hasHops = preparedHops !== null;
+    const maxHopCount = hasHops ? Math.max(...preparedHops.map(h => h.length)) : 0;
+    const finalGasLimit = _calculateGasLimit(config, isNative, hasHops, maxHopCount);
+    const nativeGasLimit = (config.prefer21000ForNative ?? false) ? BRIBE_GAS_LIMIT : finalGasLimit;
+    // 与 disperse/swap.ts 保持一致：多跳场景固定 gas limit
+    const nativeTransferGasLimit = NATIVE_TRANSFER_GAS_LIMIT;
+    const erc20TransferGasLimit = GAS_LIMITS.ERC20_TRANSFER;
+    const [gasPrice, decimals] = await Promise.all([
+        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+        isNative ? Promise.resolve(18) : Promise.resolve(tokenDecimals ?? await _getErc20DecimalsMerkle(provider, tokenAddress, chainIdNum))
+    ]);
+    const gasFields = buildGasFields(txType, gasPrice);
+    const iface = isNative ? null : new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
+    // ✅ 费用：按地址数量收取固定费用（原生代币），由第一个 sender 支付
+    const extractProfit = shouldExtractProfit(config);
+    const profitAddr = getProfitRecipient();
+    let totalAmountBeforeProfit = 0n;
+    let totalProfitNative = 0n;
+    const parsedAmountsWei = normalizedAmounts.map(v => {
+        const amt = isNative ? ethers.parseEther(v) : ethers.parseUnits(v, decimals);
+        totalAmountBeforeProfit += amt;
+        return amt;
+    });
+    // ✅ 按地址数量收取固定费用
+    if (extractProfit && pairCount > 0) {
+        totalProfitNative = calculateTransferFee(chainIdNum, pairCount);
+    }
+    // ✅ BSC 链贿赂支持（由第一个 sender 支付）
+    const bribeAmount = chainIdNum === CHAINS.BSC.chainId ? getBribeAmount(config) : 0n;
+    const needBribeTx = bribeAmount > 0n;
+    const bribeSignedTx = [];
+    // 计算每个 sender 需要的 nonce 数量（聚合到地址）
+    const senderWallets = senderPrivateKeys.map(pk => new Wallet(pk, provider));
+    const senderAddrLowerList = senderWallets.map(w => w.address.toLowerCase());
+    const firstSenderAddrLower = senderAddrLowerList[0];
+    const nonceNeedBySender = new Map();
+    for (let i = 0; i < pairCount; i++) {
+        const addrLower = senderAddrLowerList[i];
+        const hopLen = preparedHops ? preparedHops[i].length : 0;
+        const perPairTxCount = (() => {
+            if (isNative)
+                return 1;
+            return hopLen > 0 ? 2 : 1;
+        })();
+        const cur = nonceNeedBySender.get(addrLower);
+        if (cur)
+            cur.count += perPairTxCount;
+        else
+            nonceNeedBySender.set(addrLower, { wallet: senderWallets[i], count: perPairTxCount });
+    }
+    // ✅ 贿赂交易需要 1 个额外的 nonce
+    if (needBribeTx) {
+        const cur = nonceNeedBySender.get(firstSenderAddrLower);
+        if (cur)
+            cur.count += 1;
+    }
+    if (extractProfit && totalProfitNative > 0n) {
+        const cur = nonceNeedBySender.get(firstSenderAddrLower);
+        if (cur)
+            cur.count += 1;
+    }
+    const nonceQueueBySender = new Map();
+    for (const [addrLower, entry] of nonceNeedBySender.entries()) {
+        const count = entry.count;
+        const nonces = (addrLower === firstSenderAddrLower && startNonce !== undefined)
+            ? Array.from({ length: count }, (_, i) => startNonce + i)
+            : await nonceManager.getNextNonceBatch(entry.wallet, count);
+        nonceQueueBySender.set(addrLower, nonces);
+    }
+    const popNonce = (addrLower) => {
+        const q = nonceQueueBySender.get(addrLower);
+        if (!q || q.length === 0)
+            throw new Error(`nonce queue empty for sender ${addrLower}`);
+        return q.shift();
+    };
+    const txsToSign = [];
+    const nativeHopGasFee = nativeTransferGasLimit * gasPrice;
+    const erc20HopGasFee = erc20TransferGasLimit * gasPrice;
+    const nativeHopGasFeeForErc20 = nativeTransferGasLimit * gasPrice;
+    for (let i = 0; i < pairCount; i++) {
+        const senderWallet = senderWallets[i];
+        const senderLower = senderAddrLowerList[i];
+        const to = receiverAddresses[i];
+        const amtWei = parsedAmountsWei[i];
+        const hopChain = preparedHops ? preparedHops[i] : [];
+        if (!hopChain || hopChain.length === 0) {
+            const nonce = popNonce(senderLower);
+            if (isNative) {
+                txsToSign.push({
+                    wallet: senderWallet,
+                    tx: { to, value: amtWei, nonce, gasLimit: nativeGasLimit, chainId: chainIdNum, ...gasFields }
+                });
+            }
+            else {
+                const data = iface.encodeFunctionData('transfer', [to, amtWei]);
+                txsToSign.push({
+                    wallet: senderWallet,
+                    tx: { to: tokenAddress, data, value: 0n, nonce, gasLimit: finalGasLimit, chainId: chainIdNum, ...gasFields }
+                });
+            }
+            continue;
+        }
+        const fullChain = [senderWallet, ...hopChain.map(w => new Wallet(typeof w === 'string' ? w : w.privateKey, provider))];
+        const addresses = [...fullChain.map(w => w.address), to];
+        if (isNative) {
+            for (let j = 0; j < addresses.length - 1; j++) {
+                const fromWallet = fullChain[j];
+                const toAddress = addresses[j + 1];
+                const nonce = j === 0 ? popNonce(senderLower) : 0;
+                const remainingHops = addresses.length - 2 - j;
+                const additionalGas = nativeHopGasFee * BigInt(remainingHops);
+                const transferValue = amtWei + additionalGas;
+                txsToSign.push({
+                    wallet: fromWallet,
+                    tx: { to: toAddress, value: transferValue, nonce, gasLimit: nativeTransferGasLimit, chainId: chainIdNum, ...gasFields }
+                });
+            }
+        }
+        else {
+            const hopGasNeeds = [];
+            for (let j = hopChain.length - 1; j >= 0; j--) {
+                if (j === hopChain.length - 1)
+                    hopGasNeeds.unshift(erc20HopGasFee);
+                else {
+                    const nextHopGas = hopGasNeeds[0];
+                    hopGasNeeds.unshift(nativeHopGasFeeForErc20 + erc20HopGasFee + nextHopGas);
+                }
+            }
+            txsToSign.push({
+                wallet: senderWallet,
+                tx: {
+                    to: fullChain[1].address,
+                    value: hopGasNeeds[0],
+                    nonce: popNonce(senderLower),
+                    gasLimit: nativeTransferGasLimit,
+                    chainId: chainIdNum,
+                    ...gasFields
+                }
+            });
+            const mainToFirstHopData = iface.encodeFunctionData('transfer', [fullChain[1].address, amtWei]);
+            txsToSign.push({
+                wallet: senderWallet,
+                tx: {
+                    to: tokenAddress,
+                    data: mainToFirstHopData,
+                    value: 0n,
+                    nonce: popNonce(senderLower),
+                    gasLimit: erc20TransferGasLimit,
+                    chainId: chainIdNum,
+                    ...gasFields
+                }
+            });
+            // hop wallets：逐层传递
+            for (let j = 1; j < fullChain.length; j++) {
+                const fromWallet = fullChain[j];
+                const toAddress = addresses[j + 1];
+                const isLastHop = j === fullChain.length - 1;
+                if (!isLastHop) {
+                    const gasToTransfer = hopGasNeeds[j];
+                    txsToSign.push({
+                        wallet: fromWallet,
+                        tx: {
+                            to: toAddress,
+                            value: gasToTransfer,
+                            nonce: 0,
+                            gasLimit: nativeTransferGasLimit,
+                            chainId: chainIdNum,
+                            ...gasFields
+                        }
+                    });
+                    const erc20Data = iface.encodeFunctionData('transfer', [toAddress, amtWei]);
+                    txsToSign.push({
+                        wallet: fromWallet,
+                        tx: {
+                            to: tokenAddress,
+                            data: erc20Data,
+                            value: 0n,
+                            nonce: 1,
+                            gasLimit: erc20TransferGasLimit,
+                            chainId: chainIdNum,
+                            ...gasFields
+                        }
+                    });
+                }
+                else {
+                    const erc20Data = iface.encodeFunctionData('transfer', [toAddress, amtWei]);
+                    txsToSign.push({
+                        wallet: fromWallet,
+                        tx: {
+                            to: tokenAddress,
+                            data: erc20Data,
+                            value: 0n,
+                            nonce: 0,
+                            gasLimit: erc20TransferGasLimit,
+                            chainId: chainIdNum,
+                            ...gasFields
+                        }
+                    });
+                }
+            }
+        }
+    }
+    if (needBribeTx) {
+        const firstSenderWallet = senderWallets[0];
+        const bribeNonce = popNonce(firstSenderAddrLower);
+        const bribeTx = await firstSenderWallet.signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: bribeNonce,
+            gasLimit: BRIBE_GAS_LIMIT,
+            chainId: chainIdNum,
+            ...gasFields
+        });
+        bribeSignedTx.push(bribeTx);
+    }
+    const signedTxs = await Promise.all(txsToSign.map(({ wallet, tx }) => wallet.signTransaction(tx)));
+    // 利润多跳（固定 2 hop）
+    let profitHopWallets;
+    if (extractProfit && totalProfitNative > 0n) {
+        const firstSenderWallet = senderWallets[0];
+        const profitNonce = popNonce(firstSenderAddrLower);
+        const profitHopResult = await buildProfitHopTransactions({
+            provider,
+            payerWallet: firstSenderWallet,
+            profitAmount: totalProfitNative,
+            profitRecipient: profitAddr,
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId: chainIdNum,
+            txType,
+            startNonce: profitNonce
+        });
+        signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets;
+    }
+    return {
+        signedTransactions: [...bribeSignedTx, ...signedTxs], // ✅ 贿赂交易放在最前面
+        hopWallets: preparedHops || undefined,
+        profitHopWallets,
+        metadata: extractProfit ? {
+            pairCount,
+            isNative,
+            tokenAddress: isNative ? undefined : tokenAddress,
+            totalAmount: isNative ? ethers.formatEther(totalAmountBeforeProfit) : ethers.formatUnits(totalAmountBeforeProfit, decimals),
+            profitAmount: ethers.formatEther(totalProfitNative),
+            profitRecipient: profitAddr,
+            hasBribeTx: bribeSignedTx.length > 0, // ✅ 标记是否有贿赂交易
+            bribeAmount: bribeSignedTx.length > 0 ? ethers.formatEther(bribeAmount) : undefined
+        } : undefined
+    };
+}

package/dist/chains/bsc/four/pancake-proxy.d.ts

@@ -1,28 +1 @@
-/**
- * PancakeSwap 官方 Router 交易模块
- *
- * ✅ 使用官方 PancakeSwap V2/V3 Router（非代理合约）
- * - V2 Router: 0x10ED43C718714eb63d5aA57B78B54704E256024E
- * - V3 Router: 0x13f4EA83D0bd40E75C8222255bc855a974568Dd4
- * - V3 Quoter: 0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997
- */
-import { FourPancakeProxyBatchBuySignParams, FourPancakeProxyBatchBuyResult, FourPancakeProxyBatchSellSignParams, FourPancakeProxyBatchSellResult, FourPancakeProxyApprovalParams, FourPancakeProxyApprovalBatchParams, FourPancakeProxyApprovalBatchResult } from './types.js';
-/**
- * ✅ 授权代币给 PancakeSwap Router（根据 routeType 选择 V2/V3）
- */
-export declare function approveFourPancakeProxy(params: FourPancakeProxyApprovalParams): Promise<{
-    txHash: string;
-    approved: boolean;
-}>;
-/**
- * ✅ 批量授权代币给 PancakeSwap Router
- */
-export declare function approveFourPancakeProxyBatch(params: FourPancakeProxyApprovalBatchParams): Promise<FourPancakeProxyApprovalBatchResult>;
-/**
- * ✅ 使用 PancakeSwap 官方 Router 批量购买代币
- */
-export declare function fourPancakeProxyBatchBuyMerkle(params: FourPancakeProxyBatchBuySignParams): Promise<FourPancakeProxyBatchBuyResult>;
-/**
- * ✅ 使用 PancakeSwap 官方 Router 批量卖出代币
- */
-export declare function fourPancakeProxyBatchSellMerkle(params: FourPancakeProxyBatchSellSignParams): Promise<FourPancakeProxyBatchSellResult>;
+export { fourPancakeProxyBatchBuyMerkle, fourPancakeProxyBatchSellMerkle, approveFourPancakeProxy, approveFourPancakeProxyBatch, } from '../../../bundle-core/four-meme/pancake-proxy.js';