four-flap-meme-sdk 1.2.51 → 1.2.53

package/dist/flap/portal-bundle-merkle/pancake-proxy.js

@@ -369,7 +369,10 @@ export async function pancakeProxyBatchSellMerkle(params) {
         routeType,
         amountsWei
     });
-    await ensureFeeBalances(provider, sellers);
+    const finalGasLimit = getGasLimit(config);
+    const extractProfit = shouldExtractProfit(config);
+    // 检查 BNB 余额是否足够支付 gas 费（包括可能的利润转账 gas）
+    await ensureFeeBalances(provider, sellers, gasPrice, finalGasLimit, extractProfit);
     const proxies = createPancakeProxies(sellers, ADDRESSES.BSC.PancakeProxy);
     const unsignedSells = await buildSellTransactions({
         routeType,
@@ -386,7 +389,7 @@ export async function pancakeProxyBatchSellMerkle(params) {
         unsignedTxs: unsignedSells,
         wallets: sellers,
         nonces,
-        gasLimit: getGasLimit(config),
+        gasLimit: finalGasLimit,
         gasPrice,
         chainId,
         config
@@ -567,12 +570,25 @@ async function resolveSellOutputs({ params, provider, tokenAddress, routeType, a
         minOuts: quotedOutputs.map(q => q * 95n / 100n)
     };
 }
-async function ensureFeeBalances(provider, wallets) {
+async function ensureFeeBalances(provider, wallets, gasPrice, gasLimit, needProfitGas = false) {
     const balances = await Promise.all(wallets.map(w => provider.getBalance(w.address)));
-    const minRequiredBNB = ethers.parseEther('0.001');
-    const insufficient = balances.filter(b => b < minRequiredBNB).length;
-    if (insufficient > 0) {
-        throw new Error(`${insufficient} 个钱包 BNB 余额不足 0.001 BNB`);
+    // 计算单笔卖出交易的 gas 费用
+    const sellGasCost = gasLimit * gasPrice;
+    // 利润转账的 gas 费用（如果需要）
+    const profitGasCost = needProfitGas ? 21000n * gasPrice : 0n;
+    // 总共需要的最小余额
+    const minRequiredBNB = sellGasCost + profitGasCost;
+    const insufficientWallets = [];
+    for (let i = 0; i < wallets.length; i++) {
+        // 对于可能需要支付利润的钱包（收入最高的），需要额外的 gas
+        // 这里保守估计，要求所有钱包都有足够的余额
+        const required = minRequiredBNB;
+        if (balances[i] < required) {
+            insufficientWallets.push(`钱包 ${i} (${wallets[i].address}): 需要 ${ethers.formatEther(required)} BNB，实际 ${ethers.formatEther(balances[i])} BNB`);
+        }
+    }
+    if (insufficientWallets.length > 0) {
+        throw new Error(`${insufficientWallets.length} 个钱包 BNB 余额不足:\n${insufficientWallets.join('\n')}`);
     }
 }
 async function buildSellTransactions({ routeType, params, proxies, wallets, tokenAddress, amountsWei, minOuts }) {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export * as Abis from './abis/index.js';
 export { ADDRESSES, CHAIN } from './utils/constants.js';
 export { isExclusiveOnChain, isExclusiveOffChain } from './utils/mpcExclusive.js';
-export { ensureSellApprovalV1, checkSellApprovalV1, ensureSellApprovalV2, checkSellApprovalV2, ensureSellApproval, checkSellApproval, ensureFlapSellApproval, checkFlapSellApproval, ensureFlapSellApprovalBatch, checkFlapSellApprovalBatch, type EnsureAllowanceBatchItemResult } from './utils/erc20.js';
+export { ensureSellApprovalV1, checkSellApprovalV1, ensureSellApprovalV2, checkSellApprovalV2, ensureSellApproval, checkSellApproval, ensureFlapSellApproval, checkFlapSellApproval, ensureFlapSellApprovalBatch, checkFlapSellApprovalBatch, checkAllowance, approveToken, checkAllowanceBatch, approveTokenBatch, type EnsureAllowanceBatchItemResult, type ApproveTokenBatchParams, type ApproveTokenBatchResult } from './utils/erc20.js';
 export { parseFourError, type FourErrorCode } from './utils/errors.js';
 export { getTokenManagerV1, getTokenManagerV2, getTokenManagerHelper3, getTokenManagerV1Writer, getTokenManagerV2Writer, getTokenManagerHelper3Writer, getTokenManagerAddress, type ChainName } from './utils/contract-factory.js';
 export { FourClient, buildLoginMessage, type FourConfig, type GenerateNonceReq, type LoginReq, type CreateTokenReq, type CreateTokenResp } from './clients/four.js';

package/dist/index.js

@@ -9,7 +9,9 @@ ensureSellApprovalV2, checkSellApprovalV2,
 // Four.meme 通用授权（默认 V2）
 ensureSellApproval, checkSellApproval, 
 // Flap Protocol 授权
-ensureFlapSellApproval, checkFlapSellApproval, ensureFlapSellApprovalBatch, checkFlapSellApprovalBatch } from './utils/erc20.js';
+ensureFlapSellApproval, checkFlapSellApproval, ensureFlapSellApprovalBatch, checkFlapSellApprovalBatch, 
+// ✅ 通用授权方法（适用于 Flap、Four、V2、V3 等所有场景）
+checkAllowance, approveToken, checkAllowanceBatch, approveTokenBatch } from './utils/erc20.js';
 export { parseFourError } from './utils/errors.js';
 export { getTokenManagerV1, getTokenManagerV2, getTokenManagerHelper3, getTokenManagerV1Writer, getTokenManagerV2Writer, getTokenManagerHelper3Writer, getTokenManagerAddress } from './utils/contract-factory.js';
 export { FourClient, buildLoginMessage } from './clients/four.js';

package/dist/utils/erc20.d.ts

@@ -91,3 +91,64 @@ export declare function checkFlapSellApprovalBatch(chain: 'BSC' | 'BASE' | 'XLAY
  * @returns 每个地址的授权额度数组
  */
 export declare function batchCheckAllowances(provider: JsonRpcProvider, tokenAddress: string, owners: string[], spender: string): Promise<bigint[]>;
+/**
+ * ✅ 通用方法：检查 ERC20 代币授权额度（只读，不发送交易）
+ * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
+ *
+ * @param rpcUrl - RPC 节点地址
+ * @param tokenAddress - 代币合约地址
+ * @param ownerAddress - 代币持有者地址
+ * @param spenderAddress - 被授权的合约地址（如 Router、Portal、TokenManager 等）
+ * @returns 当前授权额度（bigint）
+ */
+export declare function checkAllowance(rpcUrl: string, tokenAddress: string, ownerAddress: string, spenderAddress: string): Promise<bigint>;
+/**
+ * ✅ 通用方法：授权 ERC20 代币给指定合约（自动检查，只在不足时才发送交易）
+ * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
+ *
+ * @param rpcUrl - RPC 节点地址
+ * @param privateKey - 私钥
+ * @param tokenAddress - 代币合约地址
+ * @param spenderAddress - 被授权的合约地址（如 Router、Portal、TokenManager 等）
+ * @param amount - 授权数量（bigint），传 'max' 或 ethers.MaxUint256 表示最大授权
+ * @returns 授权结果
+ */
+export declare function approveToken(rpcUrl: string, privateKey: string, tokenAddress: string, spenderAddress: string, amount: bigint | 'max'): Promise<EnsureAllowanceResult>;
+/**
+ * ✅ 通用方法：批量检查多个钱包的授权额度（只读，不发送交易）
+ * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
+ *
+ * @param rpcUrl - RPC 节点地址
+ * @param tokenAddress - 代币合约地址
+ * @param ownerAddresses - 代币持有者地址数组
+ * @param spenderAddress - 被授权的合约地址
+ * @returns 每个地址的授权额度数组
+ */
+export declare function checkAllowanceBatch(rpcUrl: string, tokenAddress: string, ownerAddresses: string[], spenderAddress: string): Promise<bigint[]>;
+export type ApproveTokenBatchParams = {
+    rpcUrl: string;
+    privateKeys: string[];
+    tokenAddress: string;
+    spenderAddress: string;
+    amounts: (bigint | 'max')[];
+};
+export type ApproveTokenBatchResult = {
+    success: boolean;
+    approvedCount: number;
+    results: Array<{
+        owner: string;
+        alreadyApproved: boolean;
+        currentAllowance: bigint;
+        requiredAllowance: bigint;
+        txHash?: string;
+        error?: string;
+    }>;
+};
+/**
+ * ✅ 通用方法：批量授权 ERC20 代币（自动检查，只在不足时才发送交易）
+ * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
+ *
+ * @param params - 批量授权参数
+ * @returns 批量授权结果
+ */
+export declare function approveTokenBatch(params: ApproveTokenBatchParams): Promise<ApproveTokenBatchResult>;

package/dist/utils/erc20.js

@@ -279,3 +279,160 @@ export async function batchCheckAllowances(provider, tokenAddress, owners, spend
         }
     });
 }
+/**
+ * ✅ 通用方法：检查 ERC20 代币授权额度（只读，不发送交易）
+ * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
+ *
+ * @param rpcUrl - RPC 节点地址
+ * @param tokenAddress - 代币合约地址
+ * @param ownerAddress - 代币持有者地址
+ * @param spenderAddress - 被授权的合约地址（如 Router、Portal、TokenManager 等）
+ * @returns 当前授权额度（bigint）
+ */
+export async function checkAllowance(rpcUrl, tokenAddress, ownerAddress, spenderAddress) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    // 验证地址
+    await validateContractAddress(provider, tokenAddress, 'Token');
+    await validateContractAddress(provider, spenderAddress, 'Spender');
+    const erc20 = new Contract(tokenAddress, ERC20_ABI, provider);
+    try {
+        const allowance = await erc20.allowance(ownerAddress, spenderAddress);
+        return allowance;
+    }
+    catch (error) {
+        throw new Error(`❌ 查询授权额度失败: ${error.message}`);
+    }
+}
+/**
+ * ✅ 通用方法：授权 ERC20 代币给指定合约（自动检查，只在不足时才发送交易）
+ * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
+ *
+ * @param rpcUrl - RPC 节点地址
+ * @param privateKey - 私钥
+ * @param tokenAddress - 代币合约地址
+ * @param spenderAddress - 被授权的合约地址（如 Router、Portal、TokenManager 等）
+ * @param amount - 授权数量（bigint），传 'max' 或 ethers.MaxUint256 表示最大授权
+ * @returns 授权结果
+ */
+export async function approveToken(rpcUrl, privateKey, tokenAddress, spenderAddress, amount) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    const signer = new Wallet(privateKey, provider);
+    const ownerAddress = signer.address;
+    // 验证地址
+    await validateContractAddress(provider, tokenAddress, 'Token');
+    await validateContractAddress(provider, spenderAddress, 'Spender');
+    const erc20 = new Contract(tokenAddress, ERC20_ABI, signer);
+    const requiredAmount = amount === 'max' ? BigInt('0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff') : amount;
+    // 检查当前授权额度
+    let currentAllowance;
+    try {
+        currentAllowance = await erc20.allowance(ownerAddress, spenderAddress);
+    }
+    catch (error) {
+        throw new Error(`❌ 查询授权额度失败: ${error.message}`);
+    }
+    // 如果已经授权足够，直接返回
+    if (currentAllowance >= requiredAmount) {
+        return {
+            alreadyApproved: true,
+            currentAllowance,
+            requiredAllowance: requiredAmount
+        };
+    }
+    // 发送授权交易
+    try {
+        const tx = await erc20.approve(spenderAddress, requiredAmount);
+        const receipt = await tx.wait();
+        return {
+            alreadyApproved: false,
+            currentAllowance,
+            requiredAllowance: requiredAmount,
+            txReceipt: receipt
+        };
+    }
+    catch (error) {
+        throw new Error(`❌ 授权交易失败: ${error.message}`);
+    }
+}
+/**
+ * ✅ 通用方法：批量检查多个钱包的授权额度（只读，不发送交易）
+ * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
+ *
+ * @param rpcUrl - RPC 节点地址
+ * @param tokenAddress - 代币合约地址
+ * @param ownerAddresses - 代币持有者地址数组
+ * @param spenderAddress - 被授权的合约地址
+ * @returns 每个地址的授权额度数组
+ */
+export async function checkAllowanceBatch(rpcUrl, tokenAddress, ownerAddresses, spenderAddress) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    // 验证地址
+    await validateContractAddress(provider, tokenAddress, 'Token');
+    await validateContractAddress(provider, spenderAddress, 'Spender');
+    return batchCheckAllowances(provider, tokenAddress, ownerAddresses, spenderAddress);
+}
+/**
+ * ✅ 通用方法：批量授权 ERC20 代币（自动检查，只在不足时才发送交易）
+ * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
+ *
+ * @param params - 批量授权参数
+ * @returns 批量授权结果
+ */
+export async function approveTokenBatch(params) {
+    const { rpcUrl, privateKeys, tokenAddress, spenderAddress, amounts } = params;
+    if (privateKeys.length === 0 || amounts.length !== privateKeys.length) {
+        throw new Error('❌ 私钥数量和授权数量必须匹配');
+    }
+    const provider = new JsonRpcProvider(rpcUrl);
+    // 验证地址
+    await validateContractAddress(provider, tokenAddress, 'Token');
+    await validateContractAddress(provider, spenderAddress, 'Spender');
+    const results = [];
+    let approvedCount = 0;
+    for (let i = 0; i < privateKeys.length; i++) {
+        const signer = new Wallet(privateKeys[i], provider);
+        const ownerAddress = signer.address;
+        const requiredAmount = amounts[i] === 'max'
+            ? BigInt('0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff')
+            : amounts[i];
+        try {
+            const erc20 = new Contract(tokenAddress, ERC20_ABI, signer);
+            // 检查当前授权
+            const currentAllowance = await erc20.allowance(ownerAddress, spenderAddress);
+            if (currentAllowance >= requiredAmount) {
+                results.push({
+                    owner: ownerAddress,
+                    alreadyApproved: true,
+                    currentAllowance,
+                    requiredAllowance: requiredAmount
+                });
+                continue;
+            }
+            // 发送授权交易
+            const tx = await erc20.approve(spenderAddress, requiredAmount);
+            const receipt = await tx.wait();
+            results.push({
+                owner: ownerAddress,
+                alreadyApproved: false,
+                currentAllowance,
+                requiredAllowance: requiredAmount,
+                txHash: receipt.hash
+            });
+            approvedCount++;
+        }
+        catch (error) {
+            results.push({
+                owner: ownerAddress,
+                alreadyApproved: false,
+                currentAllowance: 0n,
+                requiredAllowance: requiredAmount,
+                error: error.message
+            });
+        }
+    }
+    return {
+        success: approvedCount > 0,
+        approvedCount,
+        results
+    };
+}

package/package.json

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