four-flap-meme-sdk 1.4.36 → 1.4.37

package/dist/contracts/tm-bundle-merkle/internal.d.ts

@@ -12,6 +12,24 @@ export declare function normalizeAmounts(recipients: string[], amount?: AmountLi
  * ✅ 优化：原生代币也使用 Multicall3 批量获取，减少 RPC 调用
  */
 export declare function batchGetBalances(provider: JsonRpcProvider, addresses: string[], tokenAddress?: string): Promise<bigint[]>;
+/**
+ * 通过模拟交易获取 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 declare function estimateErc20TransferGas(provider: JsonRpcProvider, tokenAddress: string, from: string, to: string, amount: bigint, bufferPercent?: number): Promise<bigint>;
+/**
+ * 批量预估多个 ERC20 转账的 Gas Limit
+ * ✅ 选取最大值作为统一的 gas limit（确保所有转账都能成功）
+ */
+export declare function estimateMaxErc20TransferGas(provider: JsonRpcProvider, tokenAddress: string, from: string, recipients: string[], amounts: bigint[], bufferPercent?: number): Promise<bigint>;
 /**
  * 计算 Gas Limit
  * - 原生代币转账：21000 gas（固定）

package/dist/contracts/tm-bundle-merkle/internal.js

@@ -122,6 +122,70 @@ export async function batchGetBalances(provider, addresses, tokenAddress) {
         }
     }
 }
+/**
+ * 通过模拟交易获取 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;
+        console.log(`[estimateErc20TransferGas] 预估 gas: ${estimatedGas}, 最终 gas limit: ${finalGas} (+${bufferPercent}%)`);
+        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);
+        console.log(`[estimateMaxErc20TransferGas] 样本数: ${uniqueIndices.length}, 最大 gas limit: ${maxGas}`);
+        return maxGas;
+    }
+    catch (error) {
+        console.warn(`[estimateMaxErc20TransferGas] 批量预估失败，使用默认值:`, error);
+        return 52000n;
+    }
+}
 /**
  * 计算 Gas Limit
  * - 原生代币转账：21000 gas（固定）

package/dist/contracts/tm-bundle-merkle/types.d.ts

@@ -11,6 +11,7 @@ export type FourSignConfig = {
     chainId?: number;
     prefer21000ForNative?: boolean;
     checkBnbForErc20NoHop?: boolean;
+    estimateGas?: boolean;
     customSubmitFn?: (signedTxs: string[]) => Promise<string>;
     spPrivateKey?: string;
     spMode?: 'none' | 'timestampPersonalSign' | 'concatTxHash' | 'rawTimestamp';

package/dist/contracts/tm-bundle-merkle/utils.js

@@ -2,7 +2,7 @@ import { ethers, Wallet } from 'ethers';
 import { getOptimizedGasPrice, NonceManager } from '../../utils/bundle-helpers.js';
 import { PROFIT_CONFIG, ZERO_ADDRESS } from '../../utils/constants.js';
 import { getTxType, getGasPriceConfig, shouldExtractProfit, getProfitRecipient } from './config.js';
-import { getErc20DecimalsMerkle as _getErc20DecimalsMerkle, generateHopWallets as _generateHopWallets, normalizeAmounts as _normalizeAmounts, batchGetBalances as _batchGetBalances, calculateGasLimit as _calculateGasLimit, isNativeTokenAddress as _isNativeTokenAddress } from './internal.js';
+import { getErc20DecimalsMerkle as _getErc20DecimalsMerkle, generateHopWallets as _generateHopWallets, normalizeAmounts as _normalizeAmounts, batchGetBalances as _batchGetBalances, calculateGasLimit as _calculateGasLimit, isNativeTokenAddress as _isNativeTokenAddress, estimateErc20TransferGas as _estimateErc20TransferGas } from './internal.js';
 // ==================== 本地利润计算（万分之三）====================
 /**
  * 计算利润金额（万分之三）
@@ -357,9 +357,23 @@ export async function disperseWithBundleMerkle(params) {
         const iface = isNative ? null : new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
         // ✅ Gas limit 设置
         // - 原生代币转账：21000（固定）
-        // - ERC20 转账：finalGasLimit（约 52800）
+        // - ERC20 转账：通过模拟交易获取最小 gas limit（减少中转钱包 BNB 残留）
         const nativeTransferGasLimit = 21000n;
-        const erc20TransferGasLimit = finalGasLimit;
+        // ✅ ERC20 多跳：模拟交易获取精确的 gas limit
+        let erc20TransferGasLimit = finalGasLimit;
+        if (!isNative && config.estimateGas !== false) {
+            try {
+                // 使用第一个接收者模拟一笔转账，获取精确的 gas limit
+                const sampleAmount = ethers.parseUnits(normalizedAmounts[0], decimals);
+                const estimatedGas = await _estimateErc20TransferGas(provider, tokenAddress, mainWallet.address, recipients[0], sampleAmount, 0 // ✅ 不加缓冲，最大化减少多跳钱包残留
+                );
+                erc20TransferGasLimit = estimatedGas;
+                console.log(`[disperseWithBundleMerkle] 使用模拟估算的 ERC20 gas limit: ${erc20TransferGasLimit}`);
+            }
+            catch (error) {
+                console.warn(`[disperseWithBundleMerkle] 模拟估算失败，使用默认值:`, error);
+            }
+        }
         // ✅ 原生代币多跳的 gas 费（每跳只需要 21000）
         const nativeHopGasFee = nativeTransferGasLimit * gasPrice;
         // ✅ ERC20 多跳时，中转钱包需要执行 2 笔交易（转 gas + 转 ERC20）
@@ -989,7 +1003,24 @@ export async function sweepWithBundleMerkle(params) {
         const iface = isNative ? null : new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
         // ✅ Gas limit 设置（与分散函数保持一致）
         const nativeTransferGasLimit = 21000n;
-        const erc20TransferGasLimit = finalGasLimit;
+        // ✅ ERC20 多跳：模拟交易获取精确的 gas limit
+        let erc20TransferGasLimit = finalGasLimit;
+        if (!isNative && config.estimateGas !== false) {
+            try {
+                // 找到第一个有余额的钱包来模拟转账
+                const firstWithBalance = balances.findIndex(b => b > 0n);
+                if (firstWithBalance >= 0) {
+                    const sampleAmount = balances[firstWithBalance] > 0n ? balances[firstWithBalance] / 2n : 1n;
+                    const estimatedGas = await _estimateErc20TransferGas(provider, tokenAddress, sourceAddresses[firstWithBalance], target, sampleAmount, 0 // ✅ 不加缓冲，最大化减少多跳钱包残留
+                    );
+                    erc20TransferGasLimit = estimatedGas;
+                    console.log(`[sweepWithBundleMerkle] 使用模拟估算的 ERC20 gas limit: ${erc20TransferGasLimit}`);
+                }
+            }
+            catch (error) {
+                console.warn(`[sweepWithBundleMerkle] 模拟估算失败，使用默认值:`, error);
+            }
+        }
         // ✅ 原生代币多跳的 gas 费（每跳只需要 21000）
         const nativeHopGasFee = nativeTransferGasLimit * gasPrice;
         // ✅ ERC20 多跳时，中转钱包需要执行 2 笔交易（转 gas + 转 ERC20）

package/package.json

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