four-flap-meme-sdk 1.4.24 → 1.4.26

package/dist/pancake/bundle-swap.js

@@ -56,34 +56,53 @@ async function quoteSellOutput({ routeParams, sellAmountWei, provider }) {
     throw new Error(`不支持的路由类型: ${routeParams.routeType}`);
 }
 async function buildSwapTransactions({ routeParams, sellAmountWei, buyAmountBNB, buyer, seller, tokenAddress, useNativeToken = true }) {
-    const proxySeller = new Contract(PANCAKE_PROXY_ADDRESS, PANCAKE_PROXY_ABI, seller);
-    const proxyBuyer = new Contract(PANCAKE_PROXY_ADDRESS, PANCAKE_PROXY_ABI, buyer);
-    const deadline = Math.floor(Date.now() / 1000) + 600;
+    const deadline = getDeadline();
     // ✅ ERC20 购买时，value 只需要 FLAT_FEE
     const buyValue = useNativeToken ? buyAmountBNB + FLAT_FEE : FLAT_FEE;
     if (routeParams.routeType === 'v2') {
         const { v2Path } = routeParams;
         const reversePath = [...v2Path].reverse();
-        const sellUnsigned = await proxySeller.swapV2.populateTransaction(sellAmountWei, 0n, v2Path, seller.address, deadline, { value: FLAT_FEE });
-        const buyUnsigned = await proxyBuyer.swapV2.populateTransaction(buyAmountBNB, 0n, reversePath, buyer.address, deadline, { value: buyValue } // ✅ 使用动态 value
-        );
+        // ✅ 使用官方 V2 Router
+        const v2RouterSeller = new Contract(PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V2_ROUTER_ABI, seller);
+        const v2RouterBuyer = new Contract(PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V2_ROUTER_ABI, buyer);
+        // 卖出：Token → BNB
+        const sellUnsigned = await v2RouterSeller.swapExactTokensForETHSupportingFeeOnTransferTokens.populateTransaction(sellAmountWei, 0n, v2Path, seller.address, deadline);
+        // 买入：BNB → Token
+        const buyUnsigned = await v2RouterBuyer.swapExactETHForTokensSupportingFeeOnTransferTokens.populateTransaction(0n, reversePath, buyer.address, deadline, { value: buyValue });
         return { sellUnsigned, buyUnsigned };
     }
     if (routeParams.routeType === 'v3-single') {
         const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
-        const sellUnsigned = await proxySeller.swapV3Single.populateTransaction(v3TokenIn, v3TokenOut, v3Fee, sellAmountWei, 0n, seller.address, { value: FLAT_FEE });
-        const buyUnsigned = await proxyBuyer.swapV3Single.populateTransaction(v3TokenOut, v3TokenIn, v3Fee, buyAmountBNB, 0n, buyer.address, { value: buyValue } // ✅ 使用动态 value
-        );
+        const v3RouterIface = new ethers.Interface(PANCAKE_V3_ROUTER_ABI);
+        const v3RouterSeller = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, seller);
+        const v3RouterBuyer = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, buyer);
+        // 卖出：Token → WBNB，需要 unwrapWETH9
+        const sellSwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
+                tokenIn: v3TokenIn,
+                tokenOut: v3TokenOut,
+                fee: v3Fee,
+                recipient: PANCAKE_V3_ROUTER_ADDRESS, // 先发给 Router
+                amountIn: sellAmountWei,
+                amountOutMinimum: 0n,
+                sqrtPriceLimitX96: 0n
+            }]);
+        const sellUnwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [0n, seller.address]);
+        const sellUnsigned = await v3RouterSeller.multicall.populateTransaction(deadline, [sellSwapData, sellUnwrapData]);
+        // 买入：WBNB → Token
+        const buySwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
+                tokenIn: v3TokenOut,
+                tokenOut: v3TokenIn,
+                fee: v3Fee,
+                recipient: buyer.address,
+                amountIn: buyAmountBNB,
+                amountOutMinimum: 0n,
+                sqrtPriceLimitX96: 0n
+            }]);
+        const buyUnsigned = await v3RouterBuyer.multicall.populateTransaction(deadline, [buySwapData], { value: buyValue });
         return { sellUnsigned, buyUnsigned };
     }
-    const { v3LpAddresses, v3ExactTokenIn } = routeParams;
-    const exactTokenOut = v3ExactTokenIn.toLowerCase() === WBNB_ADDRESS.toLowerCase()
-        ? tokenAddress
-        : WBNB_ADDRESS;
-    const sellUnsigned = await proxySeller.swapV3MultiHop.populateTransaction(v3LpAddresses, v3ExactTokenIn, sellAmountWei, 0n, seller.address, { value: FLAT_FEE });
-    const buyUnsigned = await proxyBuyer.swapV3MultiHop.populateTransaction(v3LpAddresses, exactTokenOut, buyAmountBNB, 0n, buyer.address, { value: buyValue } // ✅ 使用动态 value
-    );
-    return { sellUnsigned, buyUnsigned };
+    // V3 多跳暂不支持官方合约
+    throw new Error('V3 多跳路由暂不支持官方合约，请使用 V2 路由或 V3 单跳');
 }
 async function calculateBuyerBudget({ buyer, quotedBNBOut, reserveGasBNB, useNativeToken = true, quoteToken, quoteTokenDecimals = 18, provider }) {
     const reserveGas = ethers.parseEther((reserveGasBNB ?? 0.0005).toString());
@@ -267,12 +286,10 @@ function countTruthy(values) {
  */
 import { ethers, Contract, Wallet } from 'ethers';
 import { calculateSellAmount } from '../utils/swap-helpers.js';
-import { NonceManager } from '../utils/bundle-helpers.js';
-import { ADDRESSES, PROFIT_CONFIG } from '../utils/constants.js';
+import { NonceManager, getDeadline } from '../utils/bundle-helpers.js';
+import { ADDRESSES, PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA } from '../utils/constants.js';
 import { quoteV2, quoteV3 } from '../utils/quote-helpers.js';
-// ✅ BlockRazor Builder EOA 地址（用于贿赂）
-// 参考文档: https://blockrazor.gitbook.io/blockrazor/bsc/block-builder/send-bundle
-const BLOCKRAZOR_BUILDER_EOA = '0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20';
+import { V2_ROUTER_ABI, V3_ROUTER02_ABI, ERC20_BALANCE_ABI } from '../abis/common.js';
 /**
  * 获取 Gas Limit
  */
@@ -299,20 +316,18 @@ async function getGasPrice(provider, config) {
     }
     return gasPrice;
 }
-// PancakeSwapProxy ABI（只需要 ExactInput 方法）
-const PANCAKE_PROXY_ABI = [
-    'function swapV2(uint256 amountIn, uint256 amountOutMin, address[] calldata path, address to, uint256 deadline) payable returns (uint256)',
-    'function swapV3Single(address tokenIn, address tokenOut, uint24 fee, uint256 amountIn, uint256 amountOutMin, address to) payable returns (uint256)',
-    'function swapV3MultiHop(address[] calldata lpAddresses, address exactTokenIn, uint256 amountIn, uint256 amountOutMin, address to) payable returns (uint256)'
-];
-// 兼容旧代码：默认使用 BSC 地址
-const PANCAKE_PROXY_ADDRESS = ADDRESSES.BSC.PancakeProxy;
-// ✅ V3 Quoter ABI 和地址已移至 ../utils/quote-helpers.ts
-// 代理合约手续费
-const FLAT_FEE = 0n; // ✅ 已移除合约固定手续费
-const WBNB_ADDRESS = '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c';
+// ✅ ABI 别名（从公共模块导入）
+const PANCAKE_V2_ROUTER_ABI = V2_ROUTER_ABI;
+const PANCAKE_V3_ROUTER_ABI = V3_ROUTER02_ABI;
+const ERC20_BALANCE_OF_ABI = ERC20_BALANCE_ABI;
+// ✅ 使用官方 PancakeSwap Router 地址
+const PANCAKE_V2_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV2Router;
+const PANCAKE_V3_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV3Router;
+// 常量
+const FLAT_FEE = 0n;
+const WBNB_ADDRESS = ADDRESSES.BSC.WBNB;
 const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
-const ERC20_BALANCE_OF_ABI = ['function balanceOf(address) view returns (uint256)'];
+// ✅ ERC20_BALANCE_OF_ABI 已在文件开头定义
 /**
  * PancakeSwap捆绑换手（V2/V3通用）
  * ✅ 支持 quoteToken：传入 USDT 等地址时，卖出得到该代币，买入使用该代币
@@ -564,41 +579,59 @@ export async function pancakeBatchSwapMerkle(params) {
             }
         }
     }));
-    // ✅ 构建卖出交易
-    const proxySeller = new Contract(PANCAKE_PROXY_ADDRESS, PANCAKE_PROXY_ABI, seller);
-    const deadline = Math.floor(Date.now() / 1000) + 600;
+    // ✅ 构建卖出交易（使用官方 Router）
+    const deadline = getDeadline();
+    const v3RouterIface = new ethers.Interface(PANCAKE_V3_ROUTER_ABI);
     let sellUnsigned;
     if (routeParams.routeType === 'v2') {
         const { v2Path } = routeParams;
-        sellUnsigned = await proxySeller.swapV2.populateTransaction(sellAmountWei, 0n, v2Path, seller.address, deadline, { value: FLAT_FEE });
+        const v2RouterSeller = new Contract(PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V2_ROUTER_ABI, seller);
+        sellUnsigned = await v2RouterSeller.swapExactTokensForETHSupportingFeeOnTransferTokens.populateTransaction(sellAmountWei, 0n, v2Path, seller.address, deadline);
     }
     else if (routeParams.routeType === 'v3-single') {
         const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
-        sellUnsigned = await proxySeller.swapV3Single.populateTransaction(v3TokenIn, v3TokenOut, v3Fee, sellAmountWei, 0n, seller.address, { value: FLAT_FEE });
+        const v3RouterSeller = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, seller);
+        const sellSwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
+                tokenIn: v3TokenIn,
+                tokenOut: v3TokenOut,
+                fee: v3Fee,
+                recipient: PANCAKE_V3_ROUTER_ADDRESS,
+                amountIn: sellAmountWei,
+                amountOutMinimum: 0n,
+                sqrtPriceLimitX96: 0n
+            }]);
+        const sellUnwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [0n, seller.address]);
+        sellUnsigned = await v3RouterSeller.multicall.populateTransaction(deadline, [sellSwapData, sellUnwrapData]);
     }
     else {
-        const { v3LpAddresses, v3ExactTokenIn } = routeParams;
-        sellUnsigned = await proxySeller.swapV3MultiHop.populateTransaction(v3LpAddresses, v3ExactTokenIn, sellAmountWei, 0n, seller.address, { value: FLAT_FEE });
+        throw new Error('V3 多跳路由暂不支持官方合约，请使用 V2 路由或 V3 单跳');
     }
-    // ✅ 并行构建多个买入交易
+    // ✅ 并行构建多个买入交易（使用官方 Router）
     const buyUnsignedList = await Promise.all(buyers.map(async (buyer, i) => {
         const buyAmount = buyAmountsWei[i];
-        const proxyBuyer = new Contract(PANCAKE_PROXY_ADDRESS, PANCAKE_PROXY_ABI, buyer);
         const buyValue = useNativeToken ? buyAmount + FLAT_FEE : FLAT_FEE;
         if (routeParams.routeType === 'v2') {
             const { v2Path } = routeParams;
             const reversePath = [...v2Path].reverse();
-            return await proxyBuyer.swapV2.populateTransaction(buyAmount, 0n, reversePath, buyer.address, deadline, { value: buyValue });
+            const v2RouterBuyer = new Contract(PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V2_ROUTER_ABI, buyer);
+            return await v2RouterBuyer.swapExactETHForTokensSupportingFeeOnTransferTokens.populateTransaction(0n, reversePath, buyer.address, deadline, { value: buyValue });
         }
         else if (routeParams.routeType === 'v3-single') {
             const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
-            return await proxyBuyer.swapV3Single.populateTransaction(v3TokenOut, // 买入时反向
-            v3TokenIn, v3Fee, buyAmount, 0n, buyer.address, { value: buyValue });
+            const v3RouterBuyer = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, buyer);
+            const buySwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
+                    tokenIn: v3TokenOut,
+                    tokenOut: v3TokenIn,
+                    fee: v3Fee,
+                    recipient: buyer.address,
+                    amountIn: buyAmount,
+                    amountOutMinimum: 0n,
+                    sqrtPriceLimitX96: 0n
+                }]);
+            return await v3RouterBuyer.multicall.populateTransaction(deadline, [buySwapData], { value: buyValue });
         }
         else {
-            const { v3LpAddresses } = routeParams;
-            const exactTokenOut = tokenAddress;
-            return await proxyBuyer.swapV3MultiHop.populateTransaction(v3LpAddresses, exactTokenOut, buyAmount, 0n, buyer.address, { value: buyValue });
+            throw new Error('V3 多跳路由暂不支持官方合约，请使用 V2 路由或 V3 单跳');
         }
     }));
     // ✅ 获取贿赂金额
@@ -902,20 +935,31 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         });
         console.log(`[pancakeQuickBatchSwapMerkle] 贿赂交易已签名`);
     }
-    // ==================== 2. 卖出交易 ====================
-    const proxySeller = new Contract(PANCAKE_PROXY_ADDRESS, PANCAKE_PROXY_ABI, seller);
+    // ==================== 2. 卖出交易（使用官方 Router）====================
+    const v3RouterIface2 = new ethers.Interface(PANCAKE_V3_ROUTER_ABI);
     let sellUnsigned;
     if (routeParams.routeType === 'v2') {
         const { v2Path } = routeParams;
-        sellUnsigned = await proxySeller.swapV2.populateTransaction(sellAmountWei, 0n, v2Path, seller.address, deadline, { value: FLAT_FEE });
+        const v2RouterSeller = new Contract(PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V2_ROUTER_ABI, seller);
+        sellUnsigned = await v2RouterSeller.swapExactTokensForETHSupportingFeeOnTransferTokens.populateTransaction(sellAmountWei, 0n, v2Path, seller.address, deadline);
     }
     else if (routeParams.routeType === 'v3-single') {
         const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
-        sellUnsigned = await proxySeller.swapV3Single.populateTransaction(v3TokenIn, v3TokenOut, v3Fee, sellAmountWei, 0n, seller.address, { value: FLAT_FEE });
+        const v3RouterSeller = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, seller);
+        const sellSwapData = v3RouterIface2.encodeFunctionData('exactInputSingle', [{
+                tokenIn: v3TokenIn,
+                tokenOut: v3TokenOut,
+                fee: v3Fee,
+                recipient: PANCAKE_V3_ROUTER_ADDRESS,
+                amountIn: sellAmountWei,
+                amountOutMinimum: 0n,
+                sqrtPriceLimitX96: 0n
+            }]);
+        const sellUnwrapData = v3RouterIface2.encodeFunctionData('unwrapWETH9', [0n, seller.address]);
+        sellUnsigned = await v3RouterSeller.multicall.populateTransaction(deadline, [sellSwapData, sellUnwrapData]);
     }
     else {
-        const { v3LpAddresses, v3ExactTokenIn } = routeParams;
-        sellUnsigned = await proxySeller.swapV3MultiHop.populateTransaction(v3LpAddresses, v3ExactTokenIn, sellAmountWei, 0n, seller.address, { value: FLAT_FEE });
+        throw new Error('V3 多跳路由暂不支持官方合约，请使用 V2 路由或 V3 单跳');
     }
     const signedSell = await seller.signTransaction({
         ...sellUnsigned,
@@ -978,7 +1022,6 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         : 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);
         // BNB 模式：value = buyAmount + FLAT_FEE
         // ERC20 模式：value = FLAT_FEE（买入金额通过授权支付）
         const buyValue = useNativeToken ? buyAmount + FLAT_FEE : FLAT_FEE;
@@ -986,15 +1029,25 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         if (routeParams.routeType === 'v2') {
             const { v2Path } = routeParams;
             const reversePath = [...v2Path].reverse();
-            buyUnsigned = await proxyBuyer.swapV2.populateTransaction(buyAmount, 0n, reversePath, buyer.address, deadline, { value: buyValue });
+            const v2RouterBuyer = new Contract(PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V2_ROUTER_ABI, buyer);
+            buyUnsigned = await v2RouterBuyer.swapExactETHForTokensSupportingFeeOnTransferTokens.populateTransaction(0n, reversePath, buyer.address, deadline, { value: buyValue });
         }
         else if (routeParams.routeType === 'v3-single') {
             const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
-            buyUnsigned = await proxyBuyer.swapV3Single.populateTransaction(v3TokenOut, v3TokenIn, v3Fee, buyAmount, 0n, buyer.address, { value: buyValue });
+            const v3RouterBuyer = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, buyer);
+            const buySwapData = v3RouterIface2.encodeFunctionData('exactInputSingle', [{
+                    tokenIn: v3TokenOut,
+                    tokenOut: v3TokenIn,
+                    fee: v3Fee,
+                    recipient: buyer.address,
+                    amountIn: buyAmount,
+                    amountOutMinimum: 0n,
+                    sqrtPriceLimitX96: 0n
+                }]);
+            buyUnsigned = await v3RouterBuyer.multicall.populateTransaction(deadline, [buySwapData], { value: buyValue });
         }
         else {
-            const { v3LpAddresses } = routeParams;
-            buyUnsigned = await proxyBuyer.swapV3MultiHop.populateTransaction(v3LpAddresses, tokenAddress, buyAmount, 0n, buyer.address, { value: buyValue });
+            throw new Error('V3 多跳路由暂不支持官方合约，请使用 V2 路由或 V3 单跳');
         }
         return buyer.signTransaction({
             ...buyUnsigned,

package/dist/utils/bundle-helpers.d.ts

@@ -160,3 +160,31 @@ export declare function signTransactionsBatchMultiWallet(wallets: Wallet[], tran
  * @returns 是否全部有效
  */
 export declare function validateSignedTransactions(signedTxs: string[]): boolean;
+/**
+ * 获取交易 deadline（Unix 时间戳秒）
+ * @param minutes 有效分钟数，默认 20
+ * @returns Unix 时间戳（秒）
+ */
+export declare function getDeadline(minutes?: number): number;
+/**
+ * 编码 V3 多跳 path
+ * 格式：token0 (20 bytes) + fee (3 bytes) + token1 (20 bytes) + fee (3 bytes) + token2 (20 bytes) ...
+ *
+ * @param tokens 代币地址数组 [tokenIn, tokenMid1, tokenMid2, ..., tokenOut]
+ * @param fees 费率数组 [fee0, fee1, ...] - 长度应该是 tokens.length - 1
+ * @returns 编码后的 path（hex string）
+ *
+ * @example
+ * // WBNB → USDT(500) → TOKEN(2500)
+ * encodeV3Path(['0xWBNB...', '0xUSDT...', '0xTOKEN...'], [500, 2500])
+ */
+export declare function encodeV3Path(tokens: string[], fees: number[]): string;
+/**
+ * 解码 V3 path 为代币和费率数组
+ * @param path 编码后的 path
+ * @returns { tokens, fees }
+ */
+export declare function decodeV3Path(path: string): {
+    tokens: string[];
+    fees: number[];
+};

package/dist/utils/bundle-helpers.js

@@ -301,3 +301,67 @@ export function validateSignedTransactions(signedTxs) {
     }
     return true;
 }
+// ============================================================================
+// 交易时间和路径工具
+// ============================================================================
+import { DEFAULT_DEADLINE_MINUTES } from './constants.js';
+/**
+ * 获取交易 deadline（Unix 时间戳秒）
+ * @param minutes 有效分钟数，默认 20
+ * @returns Unix 时间戳（秒）
+ */
+export function getDeadline(minutes = DEFAULT_DEADLINE_MINUTES) {
+    return Math.floor(Date.now() / 1000) + 60 * minutes;
+}
+/**
+ * 编码 V3 多跳 path
+ * 格式：token0 (20 bytes) + fee (3 bytes) + token1 (20 bytes) + fee (3 bytes) + token2 (20 bytes) ...
+ *
+ * @param tokens 代币地址数组 [tokenIn, tokenMid1, tokenMid2, ..., tokenOut]
+ * @param fees 费率数组 [fee0, fee1, ...] - 长度应该是 tokens.length - 1
+ * @returns 编码后的 path（hex string）
+ *
+ * @example
+ * // WBNB → USDT(500) → TOKEN(2500)
+ * encodeV3Path(['0xWBNB...', '0xUSDT...', '0xTOKEN...'], [500, 2500])
+ */
+export function encodeV3Path(tokens, fees) {
+    if (tokens.length < 2) {
+        throw new Error('V3 path 需要至少 2 个代币');
+    }
+    if (fees.length !== tokens.length - 1) {
+        throw new Error(`费率数量 (${fees.length}) 必须等于代币数量 - 1 (${tokens.length - 1})`);
+    }
+    let path = '0x';
+    for (let i = 0; i < tokens.length; i++) {
+        // 添加代币地址 (20 bytes)
+        path += tokens[i].slice(2).toLowerCase().padStart(40, '0');
+        // 添加费率 (3 bytes) - 除了最后一个代币
+        if (i < fees.length) {
+            path += fees[i].toString(16).padStart(6, '0');
+        }
+    }
+    return path;
+}
+/**
+ * 解码 V3 path 为代币和费率数组
+ * @param path 编码后的 path
+ * @returns { tokens, fees }
+ */
+export function decodeV3Path(path) {
+    const cleanPath = path.startsWith('0x') ? path.slice(2) : path;
+    const tokens = [];
+    const fees = [];
+    let offset = 0;
+    while (offset < cleanPath.length) {
+        // 读取代币地址 (40 hex chars = 20 bytes)
+        tokens.push('0x' + cleanPath.slice(offset, offset + 40));
+        offset += 40;
+        // 读取费率 (6 hex chars = 3 bytes)
+        if (offset < cleanPath.length) {
+            fees.push(parseInt(cleanPath.slice(offset, offset + 6), 16));
+            offset += 6;
+        }
+    }
+    return { tokens, fees };
+}

package/dist/utils/constants.d.ts

@@ -1,3 +1,17 @@
+/** BlockRazor Builder EOA 地址（用于 BSC 链贿赂） */
+export declare const BLOCKRAZOR_BUILDER_EOA = "0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20";
+/** 零地址 */
+export declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+/** 交易 deadline 默认分钟数 */
+export declare const DEFAULT_DEADLINE_MINUTES = 20;
+/** V3 常用费率档位 */
+export declare const V3_FEE_TIERS: {
+    readonly LOWEST: 100;
+    readonly LOW: 500;
+    readonly MEDIUM: 2500;
+    readonly HIGH: 10000;
+};
+/** ✅ 硬编码：利润提取配置（统一管理，所有方法强制使用） */
 export declare const PROFIT_CONFIG: {
     /** 利润接收地址 */
     readonly RECIPIENT: "0xe8D0334fAf713884133640CAEe4ECdd2106AF103";
@@ -34,6 +48,10 @@ export declare const CHAIN: {
 };
 export declare const ADDRESSES: {
     readonly BSC: {
+        readonly WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
+        readonly USDT: "0x55d398326f99059fF775485246999027B3197955";
+        readonly USDC: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d";
+        readonly BUSD: "0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56";
         readonly TokenManagerOriginal: "0x5c952063c7fc8610FFDB798152D69F0B9550762b";
         readonly TokenManagerV1Proxy: "0xf7F823d0E790219dBf727bDb971837574655fCB0";
         readonly TokenManagerV2Proxy: "0x342399a59943B5815849657Aa0e06D7058D9d5C6";
@@ -41,7 +59,11 @@ export declare const ADDRESSES: {
         readonly TokenManagerV2: "0x342399a59943B5815849657Aa0e06D7058D9d5C6";
         readonly TokenManagerHelper3: "0xF251F83e40a78868FcfA3FA4599Dad6494E46034";
         readonly FlapPortal: "0xe2cE6ab80874Fa9Fa2aAE65D277Dd6B8e65C9De0";
-        readonly PancakeProxy: "0xaC4fA4E0b6f6a45B199cFf43A21a69a374857682";
+        readonly PancakeV2Router: "0x10ED43C718714eb63d5aA57B78B54704E256024E";
+        readonly PancakeV2Factory: "0xcA143Ce32Fe78f1f7019d7d551a6402fC5350c73";
+        readonly PancakeV3Router: "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
+        readonly PancakeV3Quoter: "0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997";
+        readonly PancakeV3Factory: "0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865";
         readonly Multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11";
     };
     readonly BASE: {

package/dist/utils/constants.js

@@ -1,4 +1,23 @@
-// ✅ 硬编码：利润提取配置（统一管理，所有方法强制使用）
+// ============================================================================
+// 公共常量 - 各链通用
+// ============================================================================
+/** BlockRazor Builder EOA 地址（用于 BSC 链贿赂） */
+export const BLOCKRAZOR_BUILDER_EOA = '0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20';
+/** 零地址 */
+export const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+/** 交易 deadline 默认分钟数 */
+export const DEFAULT_DEADLINE_MINUTES = 20;
+/** V3 常用费率档位 */
+export const V3_FEE_TIERS = {
+    LOWEST: 100, // 0.01%
+    LOW: 500, // 0.05%
+    MEDIUM: 2500, // 0.25%
+    HIGH: 10000, // 1%
+};
+// ============================================================================
+// 利润配置
+// ============================================================================
+/** ✅ 硬编码：利润提取配置（统一管理，所有方法强制使用） */
 export const PROFIT_CONFIG = {
     /** 利润接收地址 */
     RECIPIENT: '0xe8D0334fAf713884133640CAEe4ECdd2106AF103',
@@ -21,9 +40,16 @@ export const CHAIN = {
 };
 export const ADDRESSES = {
     BSC: {
-        // Four.meme 原始合约（TokenManager2，创建代币专用，不收费）
+        // ========== 原生代币 ==========
+        WBNB: '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c',
+        // ========== 稳定币 ==========
+        USDT: '0x55d398326f99059fF775485246999027B3197955',
+        USDC: '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d',
+        BUSD: '0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56',
+        // ========== Four.meme 合约 ==========
+        // 原始合约（TokenManager2，创建代币专用，不收费）
         TokenManagerOriginal: '0x5c952063c7fc8610FFDB798152D69F0B9550762b',
-        // Four.meme 代理合约（收费版，仅交易）
+        // 代理合约（收费版，仅交易）
         TokenManagerV1Proxy: '0xf7F823d0E790219dBf727bDb971837574655fCB0',
         TokenManagerV2Proxy: '0x342399a59943B5815849657Aa0e06D7058D9d5C6',
         // ✅ 向后兼容别名（保持旧代码可用）
@@ -31,11 +57,15 @@ export const ADDRESSES = {
         TokenManagerV2: '0x342399a59943B5815849657Aa0e06D7058D9d5C6',
         // 查询辅助合约（Helper3）
         TokenManagerHelper3: '0xF251F83e40a78868FcfA3FA4599Dad6494E46034',
-        // Flap Portal 代理合约（收费版）
+        // ========== Flap Portal ==========
         FlapPortal: '0xe2cE6ab80874Fa9Fa2aAE65D277Dd6B8e65C9De0',
-        // PancakeSwap 代理合约
-        PancakeProxy: '0xaC4fA4E0b6f6a45B199cFf43A21a69a374857682',
-        // Multicall3 合约
+        // ========== PancakeSwap 官方合约 ==========
+        PancakeV2Router: '0x10ED43C718714eb63d5aA57B78B54704E256024E',
+        PancakeV2Factory: '0xcA143Ce32Fe78f1f7019d7d551a6402fC5350c73',
+        PancakeV3Router: '0x13f4EA83D0bd40E75C8222255bc855a974568Dd4',
+        PancakeV3Quoter: '0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997',
+        PancakeV3Factory: '0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865',
+        // ========== 通用合约 ==========
         Multicall3: '0xcA11bde05977b3631167028862bE2a173976CA11',
     },
     BASE: {

package/dist/utils/erc20.js

@@ -1,12 +1,7 @@
 import { Contract, Wallet, JsonRpcProvider, Interface, parseUnits } from 'ethers';
-import { ADDRESSES } from './constants.js';
+import { ADDRESSES, ZERO_ADDRESS } from './constants.js';
 import { NonceManager } from './bundle-helpers.js';
-const ERC20_ABI = [
-    { "constant": false, "inputs": [{ "name": "spender", "type": "address" }, { "name": "value", "type": "uint256" }], "name": "approve", "outputs": [{ "name": "", "type": "bool" }], "type": "function" },
-    { "constant": true, "inputs": [{ "name": "owner", "type": "address" }, { "name": "spender", "type": "address" }], "name": "allowance", "outputs": [{ "name": "", "type": "uint256" }], "type": "function" },
-    { "constant": true, "inputs": [{ "name": "account", "type": "address" }], "name": "balanceOf", "outputs": [{ "name": "", "type": "uint256" }], "type": "function" },
-    { "constant": true, "inputs": [], "name": "decimals", "outputs": [{ "name": "", "type": "uint8" }], "type": "function" }
-];
+import { ERC20_ABI, MULTICALL3_ABI } from '../abis/common.js';
 /**
  * 验证合约地址是否有效（是否部署了代码）
  */
@@ -265,12 +260,9 @@ export async function checkFlapSellApprovalBatch(chain, rpcUrl, token, owners, r
  * @returns 每个地址的授权额度数组
  */
 export async function batchCheckAllowances(provider, tokenAddress, owners, spender) {
-    // ✅ 动态获取 Multicall3 地址（所有链使用相同地址）
-    const multicall3Address = '0xca11bde05977b3631167028862be2a173976ca11';
-    const multicall3ABI = [
-        'function aggregate3(tuple(address target, bool allowFailure, bytes callData)[] calls) view returns (tuple(bool success, bytes returnData)[] returnData)'
-    ];
-    const multicall3 = new Contract(multicall3Address, multicall3ABI, provider);
+    // ✅ 使用公共常量和 ABI
+    const multicall3Address = ADDRESSES.BSC.Multicall3;
+    const multicall3 = new Contract(multicall3Address, MULTICALL3_ABI, provider);
     // 编码 allowance(owner, spender) 调用数据
     const erc20Interface = new Contract(tokenAddress, ERC20_ABI, provider).interface;
     const calls = owners.map(owner => ({
@@ -310,29 +302,29 @@ function resolveSpenderAddress(chain, platform) {
             // Four.meme 使用 TokenManagerV2Proxy（默认）
             BSC: ADDRESSES.BSC.TokenManagerV2Proxy,
             BASE: ADDRESSES.BASE.TokenManagerHelper3,
-            XLAYER: '0x0000000000000000000000000000000000000000', // XLAYER 暂不支持 Four.meme
-            MORPH: '0x0000000000000000000000000000000000000000', // MORPH 暂不支持 Four.meme
-            MONAD: '0x0000000000000000000000000000000000000000', // ❌ MONAD 不支持 Four.meme
+            XLAYER: ZERO_ADDRESS, // XLAYER 暂不支持 Four.meme
+            MORPH: ZERO_ADDRESS, // MORPH 暂不支持 Four.meme
+            MONAD: ZERO_ADDRESS, // MONAD 不支持 Four.meme
         },
         'pancake-v2': {
             // PancakeSwap V2 Router 地址
-            BSC: '0x10ED43C718714eb63d5aA57B78B54704E256024E', // BSC PancakeSwap V2 Router
+            BSC: ADDRESSES.BSC.PancakeV2Router,
             BASE: '0x8cFe327CEc66d1C090Dd72bd0FF11d690C33a2Eb', // BASE PancakeSwap V2 Router
-            XLAYER: '0x0000000000000000000000000000000000000000', // XLAYER 暂不支持
-            MORPH: '0x0000000000000000000000000000000000000000', // MORPH 暂不支持
-            MONAD: '0xb1bc24c34e88f7d43d5923034e3a14b24daacff9', // ✅ Monad PancakeSwap V2 Router
+            XLAYER: ZERO_ADDRESS, // XLAYER 暂不支持
+            MORPH: ZERO_ADDRESS, // MORPH 暂不支持
+            MONAD: '0xb1bc24c34e88f7d43d5923034e3a14b24daacff9', // Monad PancakeSwap V2 Router
         },
         'pancake-v3': {
             // PancakeSwap V3 SmartRouter 地址
-            BSC: '0x13f4EA83D0bd40E75C8222255bc855a974568Dd4', // BSC PancakeSwap V3 SmartRouter
+            BSC: ADDRESSES.BSC.PancakeV3Router,
             BASE: '0x678Aa4bF4E210cf2166753e054d5b7c31cc7fa86', // BASE PancakeSwap V3 SmartRouter
-            XLAYER: '0x0000000000000000000000000000000000000000', // XLAYER 暂不支持
-            MORPH: '0x0000000000000000000000000000000000000000', // MORPH 暂不支持
-            MONAD: '0x1b81d678ffb9c0263b24a97847620c99d213eb14', // ✅ Monad PancakeSwap V3 Router
+            XLAYER: ZERO_ADDRESS, // XLAYER 暂不支持
+            MORPH: ZERO_ADDRESS, // MORPH 暂不支持
+            MONAD: '0x1b81d678ffb9c0263b24a97847620c99d213eb14', // Monad PancakeSwap V3 Router
         },
     };
     const spender = spenderMap[platform]?.[chain];
-    if (!spender || spender === '0x0000000000000000000000000000000000000000') {
+    if (!spender || spender === ZERO_ADDRESS) {
         throw new Error(`❌ 不支持的链或平台: ${chain} / ${platform}`);
     }
     return spender;

package/dist/utils/lp-inspect.js

@@ -1,5 +1,6 @@
 import { Contract, JsonRpcProvider, Interface, formatUnits } from 'ethers';
-import { ADDRESSES } from './constants.js';
+import { ADDRESSES, ZERO_ADDRESS } from './constants.js';
+import { MULTICALL3_ABI, V2_FACTORY_ABI, V2_PAIR_ABI, V3_FACTORY_ABI, ERC20_ABI } from '../abis/common.js';
 import { Helper3 } from '../contracts/helper3.js';
 import { FlapPortal } from '../flap/portal.js';
 // ============================================================================
@@ -206,28 +207,16 @@ export function getQuoteTokens(chain) {
     ];
 }
 // ============================================================================
-// ABIs
+// ABI 别名（从公共模块导入）
 // ============================================================================
-const I_UNIV2_FACTORY_ABI = ['function getPair(address,address) view returns (address)'];
-const I_UNIV2_PAIR_ABI = [
-    'function token0() view returns (address)',
-    'function token1() view returns (address)',
-    'function getReserves() view returns (uint112,uint112,uint32)'
-];
-const I_ERC20_ABI = [
-    'function balanceOf(address) view returns (uint256)',
-    'function decimals() view returns (uint8)',
-    'function symbol() view returns (string)'
-];
-const MULTICALL3_ABI = [
-    'function aggregate((address target, bytes callData)[]) public returns (uint256 blockNumber, bytes[] returnData)'
-];
-const I_UNIV3_FACTORY_ABI = ['function getPool(address,address,uint24) view returns (address)'];
+const I_UNIV2_FACTORY_ABI = V2_FACTORY_ABI;
+const I_UNIV2_PAIR_ABI = V2_PAIR_ABI;
+const I_ERC20_ABI = ERC20_ABI;
+const I_UNIV3_FACTORY_ABI = V3_FACTORY_ABI;
 // ============================================================================
-// 工具函数
+// 常量（从公共模块导入）
 // ============================================================================
-const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
-const MULTICALL3_ADDRESS = '0xca11bde05977b3631167028862be2a173976ca11';
+const MULTICALL3_ADDRESS = ADDRESSES.BSC.Multicall3;
 /** Provider 缓存 */
 const providerCache = new Map();
 function getProvider(rpcUrl) {

package/dist/utils/private-sale.js

@@ -6,8 +6,7 @@
  * - 利润提取：千分之三（30 bps）
  */
 import { ethers, Wallet, JsonRpcProvider } from 'ethers';
-import { PROFIT_CONFIG } from './constants.js';
-import { BLOCKRAZOR_BUILDER_EOA } from '../clients/blockrazor.js';
+import { PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA } from './constants.js';
 import { NonceManager } from './bundle-helpers.js';
 // ============================================================================
 // 核心功能