four-flap-meme-sdk 1.4.55 → 1.4.57

package/dist/flap/portal-bundle-merkle/swap.js

@@ -8,8 +8,176 @@ import { calculateSellAmount } from '../../utils/swap-helpers.js';
 import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../utils/bundle-helpers.js';
 import { FLAP_PORTAL_ADDRESSES } from '../constants.js';
 import { PROFIT_CONFIG, ADDRESSES, ZERO_ADDRESS } from '../../utils/constants.js';
-import { ERC20_ALLOWANCE_ABI, V2_ROUTER_QUOTE_ABI, ERC20_BALANCE_ABI } from '../../abis/common.js';
+import { ERC20_ALLOWANCE_ABI, V2_ROUTER_QUOTE_ABI, ERC20_BALANCE_ABI, ERC20_ABI } from '../../abis/common.js';
 import { getGasPriceConfig, getTxType, getProfitRecipient, getBribeAmount, BLOCKRAZOR_BUILDER_EOA, PORTAL_ABI } from './config.js';
+import { generateWallets } from '../../utils/wallet.js';
+// ==================== 多跳转账常量 ====================
+const NATIVE_TRANSFER_GAS_LIMIT = 21055n;
+const ERC20_TRANSFER_GAS_LIMIT_HOP = 65000n;
+/**
+ * 生成分发多跳路径
+ */
+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, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    if (hopCount === 0) {
+        signedTxs.push(await payer.signTransaction({
+            to: path.targetAddress,
+            value: finalAmount,
+            nonce: payerNonce,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            gasPrice,
+            chainId,
+            type: txType
+        }));
+        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
+    signedTxs.push(await payer.signTransaction({
+        to: path.hopWallets[0].address,
+        value: amountsPerHop[0],
+        nonce: payerNonce,
+        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+        gasPrice,
+        chainId,
+        type: txType
+    }));
+    // 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];
+        signedTxs.push(await fromWallet.signTransaction({
+            to: toAddress,
+            value: amount,
+            nonce: 0,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            gasPrice,
+            chainId,
+            type: txType
+        }));
+    }
+    return signedTxs;
+}
+/**
+ * 构建 ERC20 多跳转账链
+ */
+async function buildERC20HopChain(payer, path, erc20Address, erc20Amount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    const erc20Interface = new ethers.Interface(ERC20_ABI);
+    if (hopCount === 0) {
+        const data = erc20Interface.encodeFunctionData('transfer', [path.targetAddress, erc20Amount]);
+        signedTxs.push(await payer.signTransaction({
+            to: erc20Address,
+            data,
+            value: 0n,
+            nonce: payerNonce,
+            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+            gasPrice,
+            chainId,
+            type: txType
+        }));
+        return signedTxs;
+    }
+    // payer → hop1
+    const firstData = erc20Interface.encodeFunctionData('transfer', [path.hopWallets[0].address, erc20Amount]);
+    signedTxs.push(await payer.signTransaction({
+        to: erc20Address,
+        data: firstData,
+        value: 0n,
+        nonce: payerNonce,
+        gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+        gasPrice,
+        chainId,
+        type: txType
+    }));
+    // hop1 → hop2 → ... → target (nonce=1，nonce=0 用于 BNB 转发)
+    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 data = erc20Interface.encodeFunctionData('transfer', [toAddress, erc20Amount]);
+        signedTxs.push(await fromWallet.signTransaction({
+            to: erc20Address,
+            data,
+            value: 0n,
+            nonce: 1, // nonce=0 已用于 BNB 转发
+            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+            gasPrice,
+            chainId,
+            type: txType
+        }));
+    }
+    return signedTxs;
+}
+/**
+ * 构建 BNB 多跳转账链（为 ERC20 中间钱包预留 gas）
+ */
+async function buildBNBHopChainForERC20(payer, path, finalGasAmount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    if (hopCount === 0) {
+        return signedTxs;
+    }
+    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
+    const erc20GasCost = ERC20_TRANSFER_GAS_LIMIT_HOP * gasPrice;
+    const gasPerHop = hopGasCost + erc20GasCost * 2n;
+    const amountsPerHop = [];
+    for (let i = 0; i < hopCount; i++) {
+        const remainingHops = hopCount - i;
+        amountsPerHop.push(finalGasAmount + gasPerHop * BigInt(remainingHops));
+    }
+    // payer → hop1
+    signedTxs.push(await payer.signTransaction({
+        to: path.hopWallets[0].address,
+        value: amountsPerHop[0],
+        nonce: payerNonce,
+        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+        gasPrice,
+        chainId,
+        type: txType
+    }));
+    // hop1 → hop2 → ... → target (nonce=0)
+    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 ? finalGasAmount : amountsPerHop[i + 1];
+        signedTxs.push(await fromWallet.signTransaction({
+            to: toAddress,
+            value: amount,
+            nonce: 0,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            gasPrice,
+            chainId,
+            type: txType
+        }));
+    }
+    return signedTxs;
+}
 /**
  * 获取 Gas Limit
  */
@@ -696,28 +864,44 @@ export async function flapBatchSwapMerkle(params) {
 /**
  * Flap 内盘快捷批量换手（资金利用率模式）
  *
- * 流程：[贿赂] → [卖出] → [转账1, 转账2, ...] → [买入1, 买入2, ...] → [利润]
+ * 流程：[贿赂] → [卖出] → [转账多跳...] → [买入1, 买入2, ...] → [利润]
  *
  * 特点：
  * - 子钱包不需要预先有余额
  * - 资金来自主钱包卖出代币所得
  * - 提升资金利用率
  * - 支持原生代币（BNB/OKB/ETH）和 ERC20（如 USDT）两种模式
+ * - ✅ 支持转账多跳，隐藏资金流向
  *
- * 限制：最多 23 个买方（2N + 3 ≤ 50）
+ * 限制：根据多跳数动态计算最大买方数量
  */
 export async function flapQuickBatchSwapMerkle(params) {
-    const { chain, sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, config, quoteToken, quoteTokenDecimals = 18, startNonces // ✅ 可选：前端预获取的 nonces
+    const { chain, sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, config, quoteToken, quoteTokenDecimals = 18, disperseHopCount = 0, // ✅ 转账多跳数（默认0=直接转账）
+    startNonces // ✅ 可选：前端预获取的 nonces
      } = params;
-    // ✅ 校验买方数量
-    // BNB 模式：贿赂(1) + 卖出(1) + 转账(N) + 买入(N) + 利润(1) ≤ 50 → 2N + 3 ≤ 50 → N ≤ 23
-    // ERC20 模式：贿赂(1) + 卖出(1) + ERC20转账(N) + 买入(N) + 利润(1) ≤ 50 → 2N + 3 ≤ 50 → N ≤ 23
-    const MAX_BUYERS = 23;
+    // ✅ 判断是否使用原生代币
+    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+    // ✅ 动态计算最大买方数量（根据多跳数）
+    // 固定开销: 贿赂(1) + 卖出(1) + 利润多跳(PROFIT_HOP_COUNT + 1)
+    const fixedOverhead = 1 + 1 + PROFIT_HOP_COUNT + 1;
+    const maxTxs = 50 - fixedOverhead;
+    let MAX_BUYERS;
+    if (useNativeToken) {
+        // 原生代币模式: N*(H+2) <= maxTxs
+        MAX_BUYERS = Math.floor(maxTxs / (disperseHopCount + 2));
+    }
+    else {
+        // ERC20 模式: N*(2H+3) <= maxTxs
+        MAX_BUYERS = Math.floor(maxTxs / (2 * disperseHopCount + 3));
+    }
+    MAX_BUYERS = Math.max(1, MAX_BUYERS);
+    console.log(`[flapQuickBatchSwapMerkle] 多跳数: ${disperseHopCount}, 最大买方数: ${MAX_BUYERS}`);
     if (buyerPrivateKeys.length === 0) {
         throw new Error('至少需要一个买方钱包');
     }
     if (buyerPrivateKeys.length > MAX_BUYERS) {
-        throw new Error(`资金利用率模式买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
+        const mode = useNativeToken ? '原生代币' : 'ERC20';
+        throw new Error(`资金利用率模式(${mode}, ${disperseHopCount}跳)买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
     }
     // ✅ 校验分配模式
     if (!buyerRatios && !buyerAmounts) {
@@ -729,8 +913,6 @@ export async function flapQuickBatchSwapMerkle(params) {
     if (buyerAmounts && buyerAmounts.length !== buyerPrivateKeys.length) {
         throw new Error(`buyerAmounts 长度 (${buyerAmounts.length}) 与 buyerPrivateKeys 长度 (${buyerPrivateKeys.length}) 不匹配`);
     }
-    // ✅ 判断是否使用原生代币
-    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
     const outputToken = useNativeToken ? ZERO_ADDRESS : quoteToken;
     const ERC20_TRANSFER_GAS = 65000n;
     const chainContext = createChainContext(chain, config);
@@ -856,51 +1038,88 @@ export async function flapQuickBatchSwapMerkle(params) {
     });
     const signedSell = await seller.signTransaction(sellTx);
     console.log(`[flapQuickBatchSwapMerkle] 卖出交易已签名`);
-    // ==================== 3. 转账交易（并行签名）====================
+    // ==================== 3. 转账交易（支持多跳）====================
     const reserveGas = ethers.parseEther((config.reserveGasETH || 0.0005).toString());
     const buyerGasCost = gasPrice * finalGasLimit;
-    // ✅ 预分配 nonce，然后并行签名
-    const transferNonces = buyers.map((_, i) => sellerNonce + i);
-    sellerNonce += buyers.length; // 更新 sellerNonce
-    let transferTxs;
-    if (useNativeToken) {
-        // 原生代币模式：直接转账（并行签名）
-        transferTxs = await Promise.all(buyers.map((buyer, i) => {
-            const transferValue = transferAmountsWei[i] + reserveGas + buyerGasCost;
-            return seller.signTransaction({
-                to: buyer.address,
-                value: transferValue,
-                nonce: transferNonces[i],
-                gasPrice,
-                gasLimit: 21000n,
-                chainId: chainContext.chainId,
-                type: txType
-            });
-        }));
+    // ✅ 生成多跳路径
+    const hopPaths = generateDisperseHopPaths(buyers.map(b => b.address), disperseHopCount, chainContext.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;
+        if (useNativeToken) {
+            transferTxs = await Promise.all(buyers.map((buyer, i) => {
+                const transferValue = transferAmountsWei[i] + reserveGas + buyerGasCost;
+                return seller.signTransaction({
+                    to: buyer.address,
+                    value: transferValue,
+                    nonce: transferNonces[i],
+                    gasPrice,
+                    gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+                    chainId: chainContext.chainId,
+                    type: txType
+                });
+            }));
+        }
+        else {
+            const erc20Interface = new ethers.Interface(ERC20_ABI);
+            transferTxs = await Promise.all(buyers.map((buyer, i) => {
+                const transferData = erc20Interface.encodeFunctionData('transfer', [
+                    buyer.address,
+                    transferAmountsWei[i]
+                ]);
+                return seller.signTransaction({
+                    to: quoteToken,
+                    data: transferData,
+                    value: 0n,
+                    nonce: transferNonces[i],
+                    gasPrice,
+                    gasLimit: ERC20_TRANSFER_GAS,
+                    chainId: chainContext.chainId,
+                    type: txType
+                });
+            }));
+        }
     }
     else {
-        // ERC20 模式：ERC20 transfer（并行签名）
-        const erc20Interface = new ethers.Interface([
-            'function transfer(address to, uint256 amount) returns (bool)'
-        ]);
-        transferTxs = await Promise.all(buyers.map((buyer, i) => {
-            const transferData = erc20Interface.encodeFunctionData('transfer', [
-                buyer.address,
-                transferAmountsWei[i]
-            ]);
-            return seller.signTransaction({
-                to: quoteToken,
-                data: transferData,
-                value: 0n,
-                nonce: transferNonces[i],
-                gasPrice,
-                gasLimit: ERC20_TRANSFER_GAS,
-                chainId: chainContext.chainId,
-                type: txType
-            });
-        }));
+        // ✅ 有多跳：构建多跳转账链
+        if (useNativeToken) {
+            // 原生代币多跳转账
+            const hopChains = await Promise.all(hopPaths.map((path, i) => {
+                const finalAmount = transferAmountsWei[i] + reserveGas + buyerGasCost;
+                const payerNonce = sellerNonce + i * (disperseHopCount + 1);
+                return buildNativeHopChain(seller, path, finalAmount, gasPrice, chainContext.chainId, txType, payerNonce);
+            }));
+            transferTxs = hopChains.flat();
+            sellerNonce += buyers.length * (disperseHopCount + 1);
+        }
+        else {
+            // ERC20 多跳转账：先转 BNB（给中间钱包 gas），再转 ERC20
+            // 1. 构建 BNB 多跳链
+            const bnbHopChains = await Promise.all(hopPaths.map((path, i) => {
+                const finalGasAmount = buyerGasCost;
+                const payerNonce = sellerNonce + i * (disperseHopCount + 1);
+                return buildBNBHopChainForERC20(seller, path, finalGasAmount, gasPrice, chainContext.chainId, txType, payerNonce);
+            }));
+            const bnbTxs = bnbHopChains.flat();
+            sellerNonce += buyers.length * (disperseHopCount + 1);
+            // 2. 构建 ERC20 多跳链
+            const erc20HopChains = await Promise.all(hopPaths.map((path, i) => {
+                const payerNonce = sellerNonce + i * (disperseHopCount + 1);
+                return buildERC20HopChain(seller, path, quoteToken, transferAmountsWei[i], gasPrice, chainContext.chainId, txType, payerNonce);
+            }));
+            const erc20Txs = erc20HopChains.flat();
+            sellerNonce += buyers.length * (disperseHopCount + 1);
+            transferTxs = [...bnbTxs, ...erc20Txs];
+        }
     }
-    console.log(`[flapQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名`);
+    console.log(`[flapQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名 (多跳数=${disperseHopCount})`);
     // ==================== 4. 买入交易 ====================
     // ✅ 如果前端传入了 startNonces，使用 buyer 部分（从索引 1 开始）
     const buyerNonces = startNonces && startNonces.length > 1
@@ -960,6 +1179,7 @@ export async function flapQuickBatchSwapMerkle(params) {
     console.log(`  - 利润多跳: ${nativeProfitAmount > 0n ? PROFIT_HOP_COUNT + 1 : 0}`);
     return {
         signedTransactions,
+        disperseHopWallets: allHopWallets.length > 0 ? allHopWallets : undefined, // ✅ 返回中间钱包信息
         metadata: {
             sellerAddress: seller.address,
             buyerAddresses: buyers.map(b => b.address),
@@ -971,7 +1191,8 @@ export async function flapQuickBatchSwapMerkle(params) {
                 ? ethers.formatEther(amt)
                 : ethers.formatUnits(amt, quoteTokenDecimals)),
             profitAmount: nativeProfitAmount > 0n ? ethers.formatEther(nativeProfitAmount) : undefined,
-            useNativeToken
+            useNativeToken,
+            disperseHopCount: disperseHopCount > 0 ? disperseHopCount : undefined // ✅ 返回多跳数
         }
     };
 }

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

@@ -1,4 +1,5 @@
 import { CommonBundleConfig } from '../utils/bundle-helpers.js';
+import { type GeneratedWallet } from '../utils/wallet.js';
 export interface PancakeSwapSignConfig {
     rpcUrl: string;
     gasLimit?: number | bigint;
@@ -129,6 +130,7 @@ export interface PancakeQuickBatchSwapParams {
     config: PancakeSwapSignConfig;
     quoteToken?: string;
     quoteTokenDecimals?: number;
+    disperseHopCount?: number;
     startNonces?: number[];
 }
 /**
@@ -136,6 +138,7 @@ export interface PancakeQuickBatchSwapParams {
  */
 export interface PancakeQuickBatchSwapResult {
     signedTransactions: string[];
+    disperseHopWallets?: GeneratedWallet[];
     metadata?: {
         sellerAddress: string;
         buyerAddresses: string[];
@@ -144,19 +147,21 @@ export interface PancakeQuickBatchSwapResult {
         transferAmounts: string[];
         profitAmount?: string;
         useNativeToken: boolean;
+        disperseHopCount?: number;
     };
 }
 /**
  * PancakeSwap 快捷批量换手（资金自动流转）
  *
- * 流程：[贿赂] → [卖出] → [转账1, 转账2, ...] → [买入1, 买入2, ...] → [利润]
+ * 流程：[贿赂] → [卖出] → [转账多跳...] → [买入1, 买入2, ...] → [利润]
  *
  * 特点：
  * - 子钱包不需要预先有余额
  * - 资金来自主钱包卖出代币所得
  * - 提升资金利用率
  * - 支持 BNB 和 ERC20（如 USDT）两种模式
+ * - ✅ 支持转账多跳，隐藏资金流向
  *
- * 限制：最多 23 个买方（转账 + 买入 = 46 笔，加上贿赂/卖出/利润 = 50 笔限制）
+ * 限制：根据多跳数动态计算最大买方数量
  */
 export declare function pancakeQuickBatchSwapMerkle(params: PancakeQuickBatchSwapParams): Promise<PancakeQuickBatchSwapResult>;