four-flap-meme-sdk 1.4.12 → 1.4.13

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

@@ -129,6 +129,8 @@ export interface PancakeQuickBatchSwapParams {
     tokenAddress: string;
     routeParams: RouteParams;
     config: PancakeSwapSignConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
 }
 /**
  * 快捷批量换手结果
@@ -139,9 +141,10 @@ export interface PancakeQuickBatchSwapResult {
         sellerAddress: string;
         buyerAddresses: string[];
         sellAmount: string;
-        estimatedBNBOut: string;
+        estimatedOutput: string;
         transferAmounts: string[];
         profitAmount?: string;
+        useNativeToken: boolean;
     };
 }
 /**
@@ -150,9 +153,10 @@ export interface PancakeQuickBatchSwapResult {
  * 流程：[贿赂] → [卖出] → [转账1, 转账2, ...] → [买入1, 买入2, ...] → [利润]
  *
  * 特点：
- * - 子钱包不需要预先有 BNB 余额
+ * - 子钱包不需要预先有余额
  * - 资金来自主钱包卖出代币所得
  * - 提升资金利用率
+ * - 支持 BNB 和 ERC20（如 USDT）两种模式
  *
  * 限制：最多 23 个买方（转账 + 买入 = 46 笔，加上贿赂/卖出/利润 = 50 笔限制）
  */

package/dist/pancake/bundle-swap.js

@@ -743,22 +743,30 @@ export async function pancakeBatchSwapMerkle(params) {
  * 流程：[贿赂] → [卖出] → [转账1, 转账2, ...] → [买入1, 买入2, ...] → [利润]
  *
  * 特点：
- * - 子钱包不需要预先有 BNB 余额
+ * - 子钱包不需要预先有余额
  * - 资金来自主钱包卖出代币所得
  * - 提升资金利用率
+ * - 支持 BNB 和 ERC20（如 USDT）两种模式
  *
  * 限制：最多 23 个买方（转账 + 买入 = 46 笔，加上贿赂/卖出/利润 = 50 笔限制）
  */
 export async function pancakeQuickBatchSwapMerkle(params) {
-    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, routeParams, config } = params;
-    // ✅ 校验买方数量（最多 23 个：贿赂(1) + 卖出(1) + 转账(N) + 买入(N) + 利润(1) ≤ 50）
-    // 即 2N + 3 ≤ 50 → N ≤ 23
-    const MAX_BUYERS = 23;
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18 } = params;
+    // ✅ 判断是否使用原生代币
+    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+    const WBNB = '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c'.toLowerCase();
+    // ✅ 校验买方数量
+    // BNB 模式：贿赂(1) + 卖出(1) + 转账(N) + 买入(N) + 利润(1) ≤ 50 → 2N + 3 ≤ 50 → N ≤ 23
+    // ERC20 模式：贿赂(1) + 卖出(1) + ERC20转账(N) + BNB Gas转账(N) + 买入(N) + 利润(1) ≤ 50 → 3N + 3 ≤ 50 → N ≤ 15
+    const MAX_BUYERS_NATIVE = 23;
+    const MAX_BUYERS_ERC20 = 15;
+    const MAX_BUYERS = useNativeToken ? MAX_BUYERS_NATIVE : MAX_BUYERS_ERC20;
     if (buyerPrivateKeys.length === 0) {
         throw new Error('至少需要一个买方钱包');
     }
     if (buyerPrivateKeys.length > MAX_BUYERS) {
-        throw new Error(`资金利用率模式买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
+        const mode = useNativeToken ? 'BNB' : 'ERC20';
+        throw new Error(`资金利用率模式(${mode})买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
     }
     // ✅ 校验分配模式
     if (!buyerRatios && !buyerAmounts) {
@@ -772,20 +780,51 @@ export async function pancakeQuickBatchSwapMerkle(params) {
     }
     const context = createPancakeContext(config);
     const seller = new Wallet(sellerPrivateKey, context.provider);
-    // ✅ 买方需要私钥（因为买方自己执行买入交易）
     const buyers = buyerPrivateKeys.map(pk => new Wallet(pk, context.provider));
+    // ✅ 校验卖出路径输出代币是否匹配
+    let sellOutputToken;
+    if (routeParams.routeType === 'v2') {
+        const { v2Path } = routeParams;
+        sellOutputToken = v2Path[v2Path.length - 1];
+    }
+    else if (routeParams.routeType === 'v3-single') {
+        const { v3TokenOut } = routeParams;
+        sellOutputToken = v3TokenOut;
+    }
+    else if (routeParams.routeType === 'v3-multi') {
+        const { v2Path } = routeParams;
+        if (v2Path && v2Path.length > 0) {
+            sellOutputToken = v2Path[v2Path.length - 1];
+        }
+    }
+    // 校验输出代币
+    if (useNativeToken) {
+        // 原生代币模式：输出必须是 WBNB
+        if (!sellOutputToken || sellOutputToken.toLowerCase() !== WBNB) {
+            throw new Error(`原生代币模式要求卖出路径以 WBNB 结尾（当前输出: ${sellOutputToken || '未知'}）。` +
+                `请切换交易对或使用 ERC20 模式。`);
+        }
+    }
+    else {
+        // ERC20 模式：输出必须是指定的 quoteToken
+        if (!sellOutputToken || sellOutputToken.toLowerCase() !== quoteToken.toLowerCase()) {
+            throw new Error(`ERC20 模式要求卖出路径以 ${quoteToken} 结尾（当前输出: ${sellOutputToken || '未知'}）。`);
+        }
+    }
     // ✅ 创建共享资源
     const nonceManager = new NonceManager(context.provider);
     const finalGasLimit = getGasLimit(config);
     const txType = config.txType ?? 0;
+    const ERC20_TRANSFER_GAS = 65000n; // ERC20 transfer 的 gas 限制
     // ✅ 并行获取 gasPrice 和卖出数量
     const [gasPrice, sellAmountResult] = await Promise.all([
         getGasPrice(context.provider, config),
         calculateSellAmount(context.provider, tokenAddress, seller.address, sellAmount, sellPercentage)
     ]);
     const { amount: sellAmountWei, decimals } = sellAmountResult;
-    // ✅ 调试日志：打印卖出数量
-    console.log(`[pancakeQuickBatchSwapMerkle] 卖出数量: ${ethers.formatUnits(sellAmountWei, decimals)} (${sellAmountWei} wei, decimals=${decimals})`);
+    // ✅ 调试日志
+    console.log(`[pancakeQuickBatchSwapMerkle] 模式: ${useNativeToken ? 'BNB' : 'ERC20'}`);
+    console.log(`[pancakeQuickBatchSwapMerkle] 卖出数量: ${ethers.formatUnits(sellAmountWei, decimals)}`);
     console.log(`[pancakeQuickBatchSwapMerkle] routeParams:`, JSON.stringify({
         routeType: routeParams.routeType,
         v2Path: routeParams.v2Path,
@@ -799,31 +838,44 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         sellAmountWei,
         provider: context.provider
     });
-    const estimatedBNBOut = quoteResult.estimatedBNBOut;
-    console.log(`[pancakeQuickBatchSwapMerkle] 预估卖出所得: ${ethers.formatEther(estimatedBNBOut)} BNB (${estimatedBNBOut} wei)`);
-    // ✅ 安全检查：如果报价超过 10 BNB，警告可能有问题
-    if (estimatedBNBOut > ethers.parseEther('10')) {
-        console.warn(`[pancakeQuickBatchSwapMerkle] ⚠️ 报价异常高: ${ethers.formatEther(estimatedBNBOut)} BNB，请检查路径和数量！`);
-    }
-    // ✅ 计算利润（从卖出所得中预扣）
-    const profitAmount = calculateProfitAmount(estimatedBNBOut);
-    const distributableBNB = estimatedBNBOut - profitAmount; // 可分配金额
-    // ✅ 计算每个买方分到的 BNB（用于转账和买入）
+    const estimatedOutput = quoteResult.estimatedBNBOut;
+    const outputFormatted = useNativeToken
+        ? ethers.formatEther(estimatedOutput)
+        : ethers.formatUnits(estimatedOutput, quoteTokenDecimals);
+    console.log(`[pancakeQuickBatchSwapMerkle] 预估卖出所得: ${outputFormatted} ${useNativeToken ? 'BNB' : 'ERC20'}`);
+    // ✅ 计算利润（基于 BNB 价值）
+    let profitAmount;
+    if (useNativeToken) {
+        profitAmount = calculateProfitAmount(estimatedOutput);
+    }
+    else {
+        // ERC20 模式：需要将 ERC20 价值转换为 BNB
+        const version = routeParams.routeType === 'v2' ? 'v2' : 'v3';
+        const fee = routeParams.routeType === 'v3-single' ? routeParams.v3Fee : undefined;
+        const estimatedBNBValue = await getERC20ToNativeQuote(context.provider, quoteToken, estimatedOutput, version, fee);
+        profitAmount = calculateProfitAmount(estimatedBNBValue);
+        console.log(`[pancakeQuickBatchSwapMerkle] ERC20→BNB 报价: ${outputFormatted} → ${ethers.formatEther(estimatedBNBValue)} BNB`);
+    }
+    const distributableAmount = estimatedOutput - (useNativeToken ? profitAmount : 0n);
+    // ✅ 计算每个买方分到的金额
     let transferAmountsWei;
     if (buyerAmounts && buyerAmounts.length === buyers.length) {
-        // 数量模式：使用指定的金额
-        transferAmountsWei = buyerAmounts.map(amt => ethers.parseEther(amt));
-        // 校验总金额不超过可分配金额
+        // 数量模式
+        transferAmountsWei = buyerAmounts.map(amt => useNativeToken
+            ? ethers.parseEther(amt)
+            : ethers.parseUnits(amt, quoteTokenDecimals));
         const totalTransfer = transferAmountsWei.reduce((a, b) => a + b, 0n);
-        if (totalTransfer > distributableBNB) {
-            throw new Error(`指定的买入总金额 (${ethers.formatEther(totalTransfer)} BNB) 超过可分配金额 (${ethers.formatEther(distributableBNB)} BNB)`);
+        if (totalTransfer > distributableAmount) {
+            const formatted = useNativeToken
+                ? ethers.formatEther(distributableAmount)
+                : ethers.formatUnits(distributableAmount, quoteTokenDecimals);
+            throw new Error(`指定的买入总金额超过可分配金额 (${formatted})`);
         }
     }
     else if (buyerRatios && buyerRatios.length === buyers.length) {
-        // 比例模式：按比例分配可分配金额
+        // 比例模式
         transferAmountsWei = buyerRatios.map(ratio => {
-            const amount = (distributableBNB * BigInt(Math.round(ratio * 10000))) / 10000n;
-            return amount;
+            return (distributableAmount * BigInt(Math.round(ratio * 10000))) / 10000n;
         });
     }
     else {
@@ -833,16 +885,27 @@ export async function pancakeQuickBatchSwapMerkle(params) {
     const bribeAmount = config.bribeAmount && config.bribeAmount > 0
         ? ethers.parseEther(String(config.bribeAmount))
         : 0n;
-    // ✅ 验证主钱包余额（需要支付 Gas 费用 + 贿赂）
+    // ✅ 验证主钱包余额
     const sellerBalance = await seller.provider.getBalance(seller.address);
-    // 卖方需要的 Gas：贿赂(21000) + 卖出(gasLimit) + N个转账(21000 each) + 利润(21000)
-    const sellerGasCost = gasPrice * (21000n + finalGasLimit + 21000n * BigInt(buyers.length) + 21000n);
-    const sellerRequired = bribeAmount + sellerGasCost;
+    let sellerGasCost;
+    let sellerRequired;
+    if (useNativeToken) {
+        // BNB 模式：贿赂(21000) + 卖出(gasLimit) + N个原生转账(21000 each) + 利润(21000)
+        sellerGasCost = gasPrice * (21000n + finalGasLimit + 21000n * BigInt(buyers.length) + 21000n);
+        sellerRequired = bribeAmount + sellerGasCost;
+    }
+    else {
+        // ERC20 模式：
+        // - 贿赂(21000) + 卖出(gasLimit) + N个ERC20转账(65000 each) + N个BNB Gas转账(21000 each) + 利润(21000)
+        // - 还需要给买家转 BNB 用于支付 FLAT_FEE 和买入 Gas
+        sellerGasCost = gasPrice * (21000n + finalGasLimit + (ERC20_TRANSFER_GAS + 21000n) * BigInt(buyers.length) + 21000n);
+        const buyerGasNeeded = (gasPrice * finalGasLimit + FLAT_FEE) * BigInt(buyers.length);
+        sellerRequired = bribeAmount + sellerGasCost + buyerGasNeeded;
+    }
     if (sellerBalance < sellerRequired) {
         throw new Error(`主钱包 BNB 余额不足: 需要约 ${ethers.formatEther(sellerRequired)} BNB (贿赂: ${ethers.formatEther(bribeAmount)}, Gas: ${ethers.formatEther(sellerGasCost)}), 实际 ${ethers.formatEther(sellerBalance)} BNB`);
     }
     // ==================== 规划 Nonce ====================
-    // 流程: [贿赂] → [卖出] → [转账1, 转账2, ...] → [买入1, 买入2, ...] → [利润]
     let sellerNonce = await nonceManager.getNextNonce(seller);
     const deadline = Math.floor(Date.now() / 1000) + 600;
     // ==================== 1. 贿赂交易 ====================
@@ -884,32 +947,71 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         type: txType
     });
     console.log(`[pancakeQuickBatchSwapMerkle] 卖出交易已签名`);
-    // ==================== 3. 转账交易（卖方 → 各买方）====================
+    // ==================== 3. 转账交易 ====================
     const transferTxs = [];
-    for (let i = 0; i < buyers.length; i++) {
-        // 转账金额 = 买入金额 + FLAT_FEE + 买方 Gas 费用
-        const buyerGasCost = gasPrice * finalGasLimit;
-        const transferValue = transferAmountsWei[i] + FLAT_FEE + buyerGasCost;
-        const transferTx = await seller.signTransaction({
-            to: buyers[i].address,
-            value: transferValue,
-            nonce: sellerNonce++,
-            gasPrice,
-            gasLimit: 21000n,
-            chainId: context.chainId,
-            type: txType
-        });
-        transferTxs.push(transferTx);
+    if (useNativeToken) {
+        // ✅ 原生代币模式：直接 BNB 转账
+        for (let i = 0; i < buyers.length; i++) {
+            const buyerGasCost = gasPrice * finalGasLimit;
+            const transferValue = transferAmountsWei[i] + FLAT_FEE + buyerGasCost;
+            const transferTx = await seller.signTransaction({
+                to: buyers[i].address,
+                value: transferValue,
+                nonce: sellerNonce++,
+                gasPrice,
+                gasLimit: 21000n,
+                chainId: context.chainId,
+                type: txType
+            });
+            transferTxs.push(transferTx);
+        }
+    }
+    else {
+        // ✅ ERC20 模式：ERC20 transfer 调用
+        const erc20Interface = new ethers.Interface([
+            'function transfer(address to, uint256 amount) returns (bool)'
+        ]);
+        for (let i = 0; i < buyers.length; i++) {
+            const transferData = erc20Interface.encodeFunctionData('transfer', [
+                buyers[i].address,
+                transferAmountsWei[i]
+            ]);
+            const transferTx = await seller.signTransaction({
+                to: quoteToken,
+                data: transferData,
+                value: 0n,
+                nonce: sellerNonce++,
+                gasPrice,
+                gasLimit: ERC20_TRANSFER_GAS,
+                chainId: context.chainId,
+                type: txType
+            });
+            transferTxs.push(transferTx);
+        }
+        // ERC20 模式：额外转账 Gas 费用给买家（用于支付 FLAT_FEE 和买入 Gas）
+        for (let i = 0; i < buyers.length; i++) {
+            const buyerGasCost = gasPrice * finalGasLimit + FLAT_FEE;
+            const gasTx = await seller.signTransaction({
+                to: buyers[i].address,
+                value: buyerGasCost,
+                nonce: sellerNonce++,
+                gasPrice,
+                gasLimit: 21000n,
+                chainId: context.chainId,
+                type: txType
+            });
+            transferTxs.push(gasTx);
+        }
     }
     console.log(`[pancakeQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名`);
-    // ==================== 4. 买入交易（各买方执行）====================
-    // 并行获取所有买方的 nonce
+    // ==================== 4. 买入交易 ====================
     const buyerNonces = await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
-    // 并行签名所有买入交易
     const signedBuys = await Promise.all(buyers.map(async (buyer, i) => {
         const buyAmount = transferAmountsWei[i];
         const proxyBuyer = new Contract(PANCAKE_PROXY_ADDRESS, PANCAKE_PROXY_ABI, buyer);
-        const buyValue = buyAmount + FLAT_FEE;
+        // BNB 模式：value = buyAmount + FLAT_FEE
+        // ERC20 模式：value = FLAT_FEE（买入金额是 ERC20，通过授权支付）
+        const buyValue = useNativeToken ? buyAmount + FLAT_FEE : FLAT_FEE;
         let buyUnsigned;
         if (routeParams.routeType === 'v2') {
             const { v2Path } = routeParams;
@@ -951,7 +1053,6 @@ export async function pancakeQuickBatchSwapMerkle(params) {
     }
     nonceManager.clearTemp();
     // ==================== 组装交易数组 ====================
-    // 顺序：贿赂 → 卖出 → 转账1, 转账2, ... → 买入1, 买入2, ... → 利润
     const signedTransactions = [];
     if (bribeTx)
         signedTransactions.push(bribeTx);
@@ -966,15 +1067,21 @@ export async function pancakeQuickBatchSwapMerkle(params) {
     console.log(`  - 转账: ${transferTxs.length}`);
     console.log(`  - 买入: ${signedBuys.length}`);
     console.log(`  - 利润: ${profitTx ? 1 : 0}`);
+    const outputUnit = useNativeToken ? 'BNB' : 'ERC20';
     return {
         signedTransactions,
         metadata: {
             sellerAddress: seller.address,
             buyerAddresses: buyers.map(b => b.address),
             sellAmount: ethers.formatUnits(sellAmountWei, decimals),
-            estimatedBNBOut: ethers.formatEther(estimatedBNBOut),
-            transferAmounts: transferAmountsWei.map(amt => ethers.formatEther(amt)),
-            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined
+            estimatedOutput: useNativeToken
+                ? ethers.formatEther(estimatedOutput)
+                : ethers.formatUnits(estimatedOutput, quoteTokenDecimals),
+            transferAmounts: transferAmountsWei.map(amt => useNativeToken
+                ? ethers.formatEther(amt)
+                : ethers.formatUnits(amt, quoteTokenDecimals)),
+            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
+            useNativeToken
         }
     };
 }

package/package.json

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