four-flap-meme-sdk 4.3.21 → 4.4.0

package/dist/core/quote/quote-helpers.js

@@ -6,8 +6,10 @@
  * - V3 Quoter 报价（多费率尝试 + 多跳路径）
  * - ERC20 → 原生代币转换报价
  */
-import { Contract } from 'ethers';
-import { V2_ROUTER_QUOTE_ABI, V3_QUOTER_ABI } from '../../abis/common.js';
+import { Contract, Interface } from 'ethers';
+import { MULTICALL3_ABI, V2_ROUTER_QUOTE_ABI, V3_QUOTER_ABI } from '../../abis/common.js';
+import { getMulticall3Address } from '../constants/addresses.js';
+import { CHAINS } from '../constants/chains.js';
 import { calculateBundleSwapRoundTripProfit } from '../constants/profit.js';
 import { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS, getQuoteChainKey } from '../constants/quote.js';
 const V2_ROUTER_ABI = V2_ROUTER_QUOTE_ABI;
@@ -62,27 +64,91 @@ export function buildV2QuotePaths(tokenIn, tokenOut, hops) {
 function hopTokensForChain(chainUpper) {
     return chainUpper === 'BSC' ? BSC_V2_HOP_TOKENS : [];
 }
-async function bestAmountsOut(router, amountIn, paths) {
-    const quotePromises = paths.map(async (path) => {
+export function selectBestV2Quote(paths, rows) {
+    let best;
+    for (let i = 0; i < paths.length; i++) {
+        const row = rows[i];
+        const path = paths[i];
+        if (!row?.success || !path || row.amountOut <= 0n)
+            continue;
+        if (!best || row.amountOut > best.amountOut) {
+            best = { amountOut: row.amountOut, path: [...path] };
+        }
+    }
+    return best;
+}
+function quoteChainId(chain) {
+    const key = chain.toUpperCase();
+    return CHAINS[key]?.chainId ?? CHAINS.BSC.chainId;
+}
+function readAggregateRow(row) {
+    return { success: Boolean(row.success), returnData: String(row.returnData ?? '0x') };
+}
+/** 多条 getAmountsOut 收成一次 Multicall3 aggregate3。失败的路径 allowFailure，不拖垮整批。 */
+async function quoteV2CallsMulticall(provider, chain, routerAddress, specs) {
+    const routerIface = new Interface(V2_ROUTER_ABI);
+    const multicall = new Contract(getMulticall3Address(quoteChainId(chain)), MULTICALL3_ABI, provider);
+    const calls = specs.map((spec) => ({
+        target: routerAddress,
+        allowFailure: true,
+        callData: routerIface.encodeFunctionData('getAmountsOut', [spec.amountIn, spec.path]),
+    }));
+    const raw = await multicall.aggregate3.staticCall(calls);
+    const rows = raw;
+    return rows.map((row) => {
+        const decodedRow = readAggregateRow(row);
+        if (!decodedRow.success || decodedRow.returnData === '0x') {
+            return { success: false, amountOut: 0n };
+        }
         try {
-            const amounts = await router.getAmountsOut(amountIn, path);
-            const amountOut = amounts[amounts.length - 1];
-            return { amountOut, path, success: amountOut > 0n };
+            const amounts = routerIface.decodeFunctionResult('getAmountsOut', decodedRow.returnData)[0];
+            const amountOut = amounts[amounts.length - 1] ?? 0n;
+            return { success: amountOut > 0n, amountOut };
         }
         catch {
-            return { amountOut: 0n, path, success: false };
+            return { success: false, amountOut: 0n };
         }
     });
-    const results = await Promise.all(quotePromises);
-    let best;
-    for (const result of results) {
-        if (!result.success)
-            continue;
-        if (!best || result.amountOut > best.amountOut) {
-            best = { amountOut: result.amountOut, path: result.path };
-        }
+}
+async function quoteV2PathsMulticall(provider, chain, routerAddress, amountIn, paths) {
+    return quoteV2CallsMulticall(provider, chain, routerAddress, paths.map((path) => ({ amountIn, path })));
+}
+/** 同一条 V2 path、多笔金额，一次 multicall。0 金额直接回 0，不打节点。 */
+export async function quoteV2SamePathAmounts(provider, chain, routerAddress, path, amountsIn) {
+    if (amountsIn.length === 0)
+        return [];
+    const indexed = amountsIn
+        .map((amountIn, index) => ({ amountIn, index }))
+        .filter((item) => item.amountIn > 0n);
+    const rows = await quoteV2CallsMulticall(provider, chain, routerAddress, indexed.map((item) => ({ amountIn: item.amountIn, path })));
+    const outs = amountsIn.map(() => 0n);
+    indexed.forEach((item, rowIndex) => {
+        outs[item.index] = rows[rowIndex]?.amountOut ?? 0n;
+    });
+    return outs;
+}
+async function bestAmountsOut(provider, chain, routerAddress, amountIn, paths) {
+    if (paths.length === 0)
+        return undefined;
+    try {
+        const rows = await quoteV2PathsMulticall(provider, chain, routerAddress, amountIn, paths);
+        return selectBestV2Quote(paths, rows);
+    }
+    catch {
+        const router = new Contract(routerAddress, V2_ROUTER_ABI, provider);
+        const quotePromises = paths.map(async (path) => {
+            try {
+                const amounts = await router.getAmountsOut(amountIn, path);
+                const amountOut = amounts[amounts.length - 1];
+                return { amountOut, success: amountOut > 0n };
+            }
+            catch {
+                return { amountOut: 0n, success: false };
+            }
+        });
+        const results = await Promise.all(quotePromises);
+        return selectBestV2Quote(paths, results);
     }
-    return best;
 }
 /**
  * V2 报价（直接路径 + 多跳路径）
@@ -105,8 +171,7 @@ export async function quoteV2(provider, tokenIn, tokenOut, amountIn, chain, rout
         return { amountOut: 0n };
     }
     const routerAddress = routerOverride || config.v2Router;
-    const router = new Contract(routerAddress, V2_ROUTER_ABI, provider);
-    const stableBest = await bestAmountsOut(router, amountIn, buildV2QuotePaths(tokenIn, tokenOut, config.stableCoins));
+    const stableBest = await bestAmountsOut(provider, chain, routerAddress, amountIn, buildV2QuotePaths(tokenIn, tokenOut, config.stableCoins));
     if (stableBest) {
         return { amountOut: stableBest.amountOut, path: stableBest.path };
     }
@@ -115,12 +180,48 @@ export async function quoteV2(provider, tokenIn, tokenOut, amountIn, chain, rout
         return { amountOut: 0n };
     }
     const hopOnly = buildV2QuotePaths(tokenIn, tokenOut, extraHops).filter((path) => path.length >= 3);
-    const hopBest = await bestAmountsOut(router, amountIn, hopOnly);
+    const hopBest = await bestAmountsOut(provider, chain, routerAddress, amountIn, hopOnly);
     if (hopBest) {
         return { amountOut: hopBest.amountOut, path: hopBest.path };
     }
     return { amountOut: 0n };
 }
+/** 多笔金额走同一套 V2 路径搜索，稳定币路径一次 multicall，不够再补一跳。 */
+export async function quoteV2ManyAmounts(provider, tokenIn, tokenOut, amountsIn, chain, routerOverride) {
+    const chainUpper = chain.toUpperCase();
+    const config = QUOTE_CONFIG[chainUpper];
+    if (!config)
+        return amountsIn.map(() => 0n);
+    const routerAddress = routerOverride || config.v2Router;
+    const outs = amountsIn.map(() => 0n);
+    const pending = amountsIn.map((amount, index) => ({ amount, index })).filter((item) => item.amount > 0n);
+    if (pending.length === 0)
+        return outs;
+    const fill = async (paths, indexes) => {
+        if (paths.length === 0 || indexes.length === 0)
+            return indexes;
+        const rows = await quoteV2CallsMulticall(provider, chain, routerAddress, indexes.flatMap((index) => paths.map((path) => ({ amountIn: amountsIn[index], path }))));
+        const missed = [];
+        indexes.forEach((amountIndex, group) => {
+            const slice = rows.slice(group * paths.length, (group + 1) * paths.length);
+            const best = selectBestV2Quote(paths, slice);
+            if (!best || best.amountOut <= 0n)
+                missed.push(amountIndex);
+            else
+                outs[amountIndex] = best.amountOut;
+        });
+        return missed;
+    };
+    try {
+        const stableMiss = await fill(buildV2QuotePaths(tokenIn, tokenOut, config.stableCoins), pending.map((item) => item.index));
+        const hopOnly = buildV2QuotePaths(tokenIn, tokenOut, hopTokensForChain(chainUpper)).filter((path) => path.length >= 3);
+        await fill(hopOnly, stableMiss);
+        return outs;
+    }
+    catch {
+        return null;
+    }
+}
 export async function resolveQuotedV2Path(provider, tokenIn, tokenOut, amountIn, chain, routerOverride) {
     if (amountIn <= 0n)
         return [tokenIn, tokenOut];

package/dist/core/quote/quote-helpers.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { buildV2QuotePaths } from './quote-helpers.js';
+import { buildV2QuotePaths, selectBestV2Quote } from './quote-helpers.js';
 const WBNB = '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c';
 const SPCXB = '0xbe9D156892E55e7154BcD3cB0FEA677F9D3103E1';
 const TOKEN = '0x7Db2F0c15f74aB0Dc0D4f49650dD60C45FFB7777';
@@ -11,6 +11,16 @@ describe('buildV2QuotePaths', () => {
         expect(paths).toContainEqual([WBNB, SPCXB, TOKEN]);
         expect(paths).toContainEqual([WBNB, USDT, TOKEN]);
     });
+    it('picks the largest successful getAmountsOut and skips failed paths', () => {
+        const paths = [
+            [WBNB, TOKEN],
+            [WBNB, USDT, TOKEN],
+        ];
+        expect(selectBestV2Quote(paths, [
+            { success: false, amountOut: 0n },
+            { success: true, amountOut: 5n },
+        ])).toEqual({ amountOut: 5n, path: [WBNB, USDT, TOKEN] });
+    });
     it('does not hop through the input token itself', () => {
         const paths = buildV2QuotePaths(SPCXB, TOKEN, [SPCXB, USDT]);
         expect(paths).toEqual([

package/dist/domains/dex/direct-router-v2-buy.js

@@ -7,6 +7,8 @@ import { getGasLimit } from '../../core/gas/bundle-gas.js';
 import { NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT, buildGasFields, } from '../../utils/bundle-helpers.js';
 import { getProfitRecipient, CHAINS, GAS_LIMITS } from '../../core/constants/index.js';
 import { ERC20_ABI } from '../../abis/common.js';
+import { batchCheckAllowances } from '../../core/erc20/allowances.js';
+import { batchGetBalances } from '../../bundle/internal.js';
 import { getTokenToNativeQuote, resolveQuotedV2Path } from '../../core/quote/quote-helpers.js';
 import { requireEvmAddress } from '../../core/erc20/helpers.js';
 import { CHAIN_IDS, DIRECT_ROUTERS, SWAP_ROUTER02_V2_ABI, V2_ROUTER_ABI, buildBribeTransaction, buildProfitTransactionWithHops, calculateProfitAmount, encodeDYORMulticall, encodeDYORRefundETH, encodeDYORSwapExactTokensForTokens, findMaxFlowIndex, filterEniNativeBuyIndices, getBribeAmount, getCachedProvider, getDeadline, getGasPrice, getWrappedNative, isDYORSwap, isNativeToken, isSwapRouter02, } from './direct-router-helpers.js';
@@ -40,7 +42,7 @@ export async function directV2BatchBuy(params) {
             ? getTokenToNativeQuote(provider, inputToken, baseProfitWei, chain, 'v2', undefined, router)
             : Promise.resolve(baseProfitWei),
         quoteTokenContract
-            ? Promise.all(wallets.map((w) => quoteTokenContract.allowance(w.address, router).catch(() => 0n)))
+            ? batchCheckAllowances(provider, inputToken, wallets.map((w) => w.address), router)
             : Promise.resolve(wallets.map(() => ethers.MaxUint256)),
         resolveQuotedV2Path(provider, inputToken, tokenOut, probeAmount, chain, router),
     ]);
@@ -55,7 +57,7 @@ export async function directV2BatchBuy(params) {
     // ENI 链原生代币买入：链上余额预检，跳过余额不足的钱包
     let activeIndices = null;
     if (useNative && chain.toUpperCase() === 'ENI') {
-        const eniBalances = await Promise.all(wallets.map((w) => provider.getBalance(w.address)));
+        const eniBalances = await batchGetBalances(provider, wallets.map((w) => w.address), undefined, chainId);
         activeIndices = filterEniNativeBuyIndices(eniBalances, flowAmounts, gasLimit, gasPrice, profitWei);
     }
     // 如果有钱包被跳过，重建数组（仅 ENI）

package/dist/domains/dex/direct-router-v2-sell.js

@@ -2,14 +2,63 @@
  * direct-router-v2-sell - V2 批量卖出（直接调用 Router）
  * 从 direct-router-v2.ts 抽取，direct-router-v2.ts 通过 re-export 保持对外不变。
  */
-import { ethers, Wallet, Contract } from 'ethers';
+import { ethers, Interface, Wallet, Contract } from 'ethers';
 import { getGasLimit } from '../../core/gas/bundle-gas.js';
 import { NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT, buildGasFields, } from '../../utils/bundle-helpers.js';
-import { getProfitRecipient, CHAINS, GAS_LIMITS } from '../../core/constants/index.js';
+import { getProfitRecipient, CHAINS, GAS_LIMITS, getMulticall3Address } from '../../core/constants/index.js';
+import { MULTICALL3_ABI } from '../../abis/common.js';
 import { getErrorMessageFromUnknown } from '../../core/index.js';
 import { ERC20_ABI } from '../../abis/common.js';
+import { batchGetBalances } from '../../bundle/internal.js';
+import { batchCheckAllowances } from '../../core/erc20/allowances.js';
 import { getTokenToNativeQuote, quoteV2, resolveQuotedV2Path } from '../../core/quote/quote-helpers.js';
 import { requireEvmAddress } from '../../core/erc20/helpers.js';
+const SELL_VIEW_ABI = [
+    'function decimals() view returns (uint8)',
+    'function balanceOf(address) view returns (uint256)',
+    'function allowance(address,address) view returns (uint256)',
+];
+/** 卖出前的精度、余额、授权收成一次 aggregate3。 */
+async function readV2SellTokenViews(provider, chainId, tokenIn, owners, spender, knownDecimals) {
+    const iface = new Interface(SELL_VIEW_ABI);
+    const includeDecimals = knownDecimals === undefined;
+    const calls = [
+        ...(includeDecimals
+            ? [{ target: tokenIn, allowFailure: true, callData: iface.encodeFunctionData('decimals', []) }]
+            : []),
+        ...owners.map((owner) => ({
+            target: tokenIn,
+            allowFailure: true,
+            callData: iface.encodeFunctionData('balanceOf', [owner]),
+        })),
+        ...owners.map((owner) => ({
+            target: tokenIn,
+            allowFailure: true,
+            callData: iface.encodeFunctionData('allowance', [owner, spender]),
+        })),
+    ];
+    const multicall = new Contract(getMulticall3Address(chainId), MULTICALL3_ABI, provider);
+    const aggregate3 = multicall.aggregate3;
+    if (!aggregate3)
+        throw new Error('aggregate3 missing');
+    const rows = (await aggregate3.staticCall(calls));
+    const decode = (index, name) => {
+        const row = rows[index];
+        if (!row?.success || row.returnData === '0x')
+            return 0n;
+        try {
+            return iface.decodeFunctionResult(name, row.returnData)[0];
+        }
+        catch {
+            return 0n;
+        }
+    };
+    let cursor = 0;
+    const decimals = includeDecimals ? Number(decode(cursor++, 'decimals') || 18n) : knownDecimals;
+    const balances = owners.map(() => decode(cursor++, 'balanceOf'));
+    const allowances = owners.map(() => decode(cursor++, 'allowance'));
+    return { decimals, balances, allowances };
+}
 import { CHAIN_IDS, DIRECT_ROUTERS, SWAP_ROUTER02_V2_ABI, V2_ROUTER_ABI, buildBribeTransaction, buildProfitTransactionWithHops, calculateProfitAmount, encodeDYORMulticall, encodeDYORSwapExactTokensForTokens, encodeDYORUnwrapWETH9, findMaxFlowIndex, getBribeAmount, getCachedProvider, getDeadline, getGasPrice, getWrappedNative, isDYORSwap, isNativeToken, isSwapRouter02, truncateDecimals, } from './direct-router-helpers.js';
 /**
  * V2 批量卖出（直接调用 Router）
@@ -27,21 +76,23 @@ export async function directV2BatchSell(params) {
     const wallets = privateKeys.map((pk) => new Wallet(pk, provider));
     const tokenContract = new Contract(tokenIn, ERC20_ABI, provider);
     // ✅ 性能优化：并行获取所有独立的 RPC 数据（包括授权额度）
-    const [fetchedDecimals, balances, allowances, nonces, gasPrice] = await Promise.all([
-        inputDecimals !== undefined
-            ? Promise.resolve(inputDecimals)
-            : tokenContract
-                .decimals()
-                .then((d) => Number(d))
-                .catch(() => 18),
-        Promise.all(wallets.map((w) => tokenContract.balanceOf(w.address))),
-        Promise.all(wallets.map((w) => tokenContract.allowance(w.address, router).catch(() => 0n))),
+    const owners = wallets.map((w) => w.address);
+    const [sellViews, nonces, gasPrice] = await Promise.all([
+        readV2SellTokenViews(provider, chainId, tokenIn, owners, router, inputDecimals).catch(async () => ({
+            decimals: inputDecimals ??
+                (await tokenContract
+                    .decimals()
+                    .then((d) => Number(d))
+                    .catch(() => 18)),
+            balances: await batchGetBalances(provider, owners, tokenIn, chainId),
+            allowances: await batchCheckAllowances(provider, tokenIn, owners, router),
+        })),
         startNonces && startNonces.length === wallets.length
             ? Promise.resolve(startNonces)
             : new NonceManager(provider).getNextNoncesForWallets(wallets),
         getGasPrice(provider, config),
     ]);
-    const tokenDecimals = fetchedDecimals;
+    const { decimals: tokenDecimals, balances, allowances } = sellViews;
     const gasLimit = getGasLimit(config, 300000);
     const txType = config.txType ?? 0;
     const deadline = getDeadline();

package/dist/domains/dex/direct-router-v3.js

@@ -1,12 +1,12 @@
 /**
  * direct-router-v3 - V3 批量买卖（直接调用 Router）
  */
-import { ethers, Wallet, Contract } from 'ethers';
+import { ethers, Wallet } from 'ethers';
 import { getGasLimit } from '../../core/gas/bundle-gas.js';
 import { NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT, buildGasFields, } from '../../utils/bundle-helpers.js';
 import { getProfitRecipient, CHAINS, GAS_LIMITS } from '../../core/constants/index.js';
 import { getErrorMessageFromUnknown } from '../../core/index.js';
-import { ERC20_ABI } from '../../abis/common.js';
+import { batchGetBalances } from '../../bundle/internal.js';
 import { getTokenToNativeQuote } from '../../core/quote/quote-helpers.js';
 import { CHAIN_IDS, V3_ROUTER02_ABI, V3_ROUTER_LEGACY_ABI, buildBribeTransaction, buildProfitTransactionWithHops, calculateProfitAmount, findMaxFlowIndex, getBribeAmount, getCachedProvider, getDeadline, getGasPrice, getWrappedNative, isLegacySwapRouter, isNativeToken, quoteXLayerV3TokenToNativeBySlot0, } from './direct-router-helpers.js';
 // ============================================================================
@@ -213,10 +213,9 @@ export async function directV3BatchSell(params) {
     const useLegacyRouter = isLegacySwapRouter(chain, routerAddress);
     const routerAbi = useLegacyRouter ? V3_ROUTER_LEGACY_ABI : V3_ROUTER02_ABI;
     const wallets = privateKeys.map((pk) => new Wallet(pk, provider));
-    const tokenContract = new Contract(tokenAddress, ERC20_ABI, provider);
     // ✅ 并行获取所有 RPC 数据
     const [balances, nonces, gasPrice] = await Promise.all([
-        Promise.all(wallets.map((w) => tokenContract.balanceOf(w.address))),
+        batchGetBalances(provider, wallets.map((w) => w.address), tokenAddress, chainId),
         startNonces && startNonces.length === wallets.length
             ? Promise.resolve(startNonces)
             : new NonceManager(provider).getNextNoncesForWallets(wallets),

package/dist/domains/dex/quote.js

@@ -1,5 +1,6 @@
-import { Contract } from 'ethers';
-import { ZERO_ADDRESS } from '../../core/constants/index.js';
+import { Contract, Interface } from 'ethers';
+import { CHAINS, ZERO_ADDRESS, getMulticall3Address } from '../../core/constants/index.js';
+import { MULTICALL3_ABI } from '../../abis/common.js';
 import { DIRECT_ROUTERS, V3_FEE_DENOMINATOR, XLAYER_V3_FACTORY_ABI, XLAYER_V3_POOL_ABI, } from './direct-router-types.js';
 // ============================================================================
 // XLAYER V3 报价（slot0 现货价，纯 V3，不串 V2）
@@ -23,10 +24,19 @@ export async function quoteXLayerV3TokenToNativeBySlot0(params) {
         const poolAddr = await factory.getPool?.(tokenIn, wrappedNative, fee);
         if (!poolAddr || poolAddr.toLowerCase() === ZERO_ADDRESS.toLowerCase())
             return 0n;
-        const pool = new Contract(poolAddr, XLAYER_V3_POOL_ABI, provider);
-        const [t0, t1, slot0] = await Promise.all([pool.token0?.(), pool.token1?.(), pool.slot0?.()]);
-        if (!t0 || !t1 || !slot0)
+        const poolIface = new Interface(XLAYER_V3_POOL_ABI);
+        const multicall = new Contract(getMulticall3Address(CHAINS.XLAYER.chainId), MULTICALL3_ABI, provider);
+        const aggregate3 = multicall.aggregate3;
+        if (!aggregate3)
             return 0n;
+        const poolRows = (await aggregate3.staticCall(['token0', 'token1', 'slot0'].map((name) => ({
+            target: poolAddr,
+            allowFailure: false,
+            callData: poolIface.encodeFunctionData(name, []),
+        }))));
+        const t0 = poolIface.decodeFunctionResult('token0', poolRows[0].returnData)[0];
+        const t1 = poolIface.decodeFunctionResult('token1', poolRows[1].returnData)[0];
+        const slot0 = poolIface.decodeFunctionResult('slot0', poolRows[2].returnData);
         const sqrtPriceX96 = BigInt(slot0[0]);
         if (sqrtPriceX96 <= 0n)
             return 0n;

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

@@ -1,9 +1,33 @@
-import { ethers, Wallet, Contract, } from 'ethers';
+import { ethers, Wallet, Contract, Interface, } from 'ethers';
 import { getGasLimit, } from '../../../../core/gas/bundle-gas.js';
 import { NonceManager, getOptimizedGasPrice, } from '../../../../utils/bundle-helpers.js';
-import { ERC20_ABI, } from '../../../../core/shared-abis/common.js';
+import { ERC20_ABI, MULTICALL3_ABI, } from '../../../../core/shared-abis/common.js';
+import { getMulticall3Address } from '../../../../core/constants/index.js';
 import { getErrorMessageFromUnknown, } from '../../../../core/index.js';
 import { CHAIN_ID_MAP, getTxType, getGasPriceConfig, } from '../config.js';
+import { batchCheckAllowances } from '../../../../core/erc20/allowances.js';
+async function readDecimalsAndAllowances(provider, chainId, tokenAddress, owners, spender, needDecimals) {
+    const iface = new Interface(ERC20_ABI);
+    const multicall = new Contract(getMulticall3Address(chainId), MULTICALL3_ABI, provider);
+    const aggregate3 = multicall.aggregate3;
+    if (!aggregate3)
+        throw new Error('aggregate3 missing');
+    const rows = (await aggregate3.staticCall([
+        ...(needDecimals
+            ? [{ target: tokenAddress, allowFailure: false, callData: iface.encodeFunctionData('decimals', []) }]
+            : []),
+        ...owners.map((owner) => ({
+            target: tokenAddress,
+            allowFailure: false,
+            callData: iface.encodeFunctionData('allowance', [owner, spender]),
+        })),
+    ]));
+    const offset = needDecimals ? 1 : 0;
+    return {
+        decimals: needDecimals ? Number(iface.decodeFunctionResult('decimals', rows[0].returnData)[0]) : 18,
+        allowances: owners.map((_, index) => iface.decodeFunctionResult('allowance', rows[index + offset].returnData)[0]),
+    };
+}
 import { getApprovalTarget, getCachedProvider, getTokenDecimals, } from './helpers.js';
 /**
  * ✅ 授权代币给 PancakeSwap Router
@@ -14,8 +38,19 @@ export async function approvePancakeProxy(params) {
     const provider = getCachedProvider(chain, rpcUrl);
     const wallet = new Wallet(privateKey, provider);
     const token = new Contract(tokenAddress, ERC20_ABI, wallet);
-    const decimals = await getTokenDecimals(tokenAddress, provider);
-    const currentAllowance = await token.allowance(wallet.address, approvalTarget);
+    const needDecimals = amount !== 'max';
+    const chainId = CHAIN_ID_MAP[chain];
+    let decimals;
+    let currentAllowance;
+    try {
+        const views = await readDecimalsAndAllowances(provider, chainId, tokenAddress, [wallet.address], approvalTarget, needDecimals);
+        decimals = views.decimals;
+        currentAllowance = views.allowances[0];
+    }
+    catch {
+        decimals = needDecimals ? await getTokenDecimals(tokenAddress, provider) : 18;
+        currentAllowance = await token.allowance(wallet.address, approvalTarget);
+    }
     const amountBigInt = amount === 'max' ? ethers.MaxUint256 : ethers.parseUnits(amount, decimals);
     if (currentAllowance >= amountBigInt) {
         return { txHash: '', approved: true };
@@ -38,12 +73,17 @@ export async function approvePancakeProxyBatch(params) {
     const approvalTarget = getApprovalTarget(routeType || 'v2');
     const chainId = CHAIN_ID_MAP[chain];
     const provider = getCachedProvider(chain, config.rpcUrl, chainId);
-    const gasPrice = await getOptimizedGasPrice(provider, getGasPriceConfig(config));
-    const decimals = await getTokenDecimals(tokenAddress, provider);
     const wallets = privateKeys.map((k) => new Wallet(k, provider));
+    const needDecimals = amounts.some((amount) => amount !== 'max');
+    const [gasPrice, views] = await Promise.all([
+        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+        readDecimalsAndAllowances(provider, chainId, tokenAddress, wallets.map((wallet) => wallet.address), approvalTarget, needDecimals).catch(async () => ({
+            decimals: needDecimals ? await getTokenDecimals(tokenAddress, provider) : 18,
+            allowances: await batchCheckAllowances(provider, tokenAddress, wallets.map((wallet) => wallet.address), approvalTarget),
+        })),
+    ]);
+    const { decimals, allowances } = views;
     const amountsBigInt = amounts.map((a) => (a === 'max' ? ethers.MaxUint256 : ethers.parseUnits(a, decimals)));
-    const tokens = wallets.map((w) => new Contract(tokenAddress, ERC20_ABI, w));
-    const allowances = await Promise.all(tokens.map((token, i) => token.allowance(wallets[i].address, approvalTarget)));
     const needApproval = wallets.filter((_, i) => allowances[i] < amountsBigInt[i]);
     const needApprovalAmounts = amountsBigInt.filter((amount, i) => allowances[i] < amount);
     if (needApproval.length === 0) {

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

@@ -6,10 +6,11 @@ import { getGasLimit } from '../../../core/gas/bundle-gas.js';
 import { calculateSellAmount } from '../../../utils/swap-helpers.js';
 import { NonceManager, getOptimizedGasPrice } from '../../../utils/bundle-helpers.js';
 import { ZERO_ADDRESS } from '../../../core/constants/index.js';
+import { batchGetBalances } from '../../../bundle/internal.js';
 import { quoteRoundTripProfitToNativeByChainId } from '../../../core/quote/quote-helpers.js';
 import { getGasPriceConfig, getTxType, getBribeAmount, BLOCKRAZOR_BUILDER_EOA, PORTAL_ABI, } from './config.js';
 import { buildTransactionRequest } from '../../../core/tx/build-request.js';
-import { BRIBE_GAS_LIMIT, ERC20_BALANCE_OF_ABI, } from './swap-helpers.js';
+import { BRIBE_GAS_LIMIT, } from './swap-helpers.js';
 import { buildApprovalTransaction, buildProfitTransaction, calculateProfitAmount, createChainContext, grossUpSellProceedsToBuySide, quoteSellOutput, } from './swap-planning.js';
 /**
  * Flap 内盘批量换手（一卖多买）
@@ -83,23 +84,20 @@ export async function flapBatchSwapMerkle(params) {
     }
     // ✅ 并行验证所有买方余额
     const reserveGas = ethers.parseEther((config.reserveGasETH || 0.0005).toString());
-    const erc20Contract = useNativeToken ? null : new Contract(quoteToken, ERC20_BALANCE_OF_ABI, chainContext.provider);
-    await Promise.all(buyers.map(async (buyer, i) => {
+    const buyerBalances = await batchGetBalances(chainContext.provider, buyers.map((buyer) => buyer.address), useNativeToken ? undefined : quoteToken, chainContext.chainId);
+    buyerBalances.forEach((buyerBalance, i) => {
         const buyAmount = buyAmountsWei[i];
         if (useNativeToken) {
-            const buyerBalance = await buyer.provider.getBalance(buyer.address);
             const required = buyAmount + reserveGas;
             if (buyerBalance < required) {
                 throw new Error(`买方 ${i + 1} 余额不足: 需要 ${ethers.formatEther(required)} ${chainContext.nativeToken}, 实际 ${ethers.formatEther(buyerBalance)}`);
             }
+            return;
         }
-        else {
-            const buyerBalance = await erc20Contract.balanceOf(buyer.address);
-            if (buyerBalance < buyAmount) {
-                throw new Error(`买方 ${i + 1} 代币余额不足: 需要 ${ethers.formatUnits(buyAmount, quoteTokenDecimals)}, 实际 ${ethers.formatUnits(buyerBalance, quoteTokenDecimals)}`);
-            }
+        if (buyerBalance < buyAmount) {
+            throw new Error(`买方 ${i + 1} 代币余额不足: 需要 ${ethers.formatUnits(buyAmount, quoteTokenDecimals)}, 实际 ${ethers.formatUnits(buyerBalance, quoteTokenDecimals)}`);
         }
-    }));
+    });
     // ✅ 计算利润。换手按卖出代币的买侧计价收万六，避免曲线折价后只剩万五点多
     const profitNotional = await grossUpSellProceedsToBuySide({
         provider: chainContext.provider,

package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-quote.js

@@ -2,11 +2,13 @@
  * Flap BuyFirst 报价/资金/余额 helper（从 swap-buy-first-helpers.ts 抽取）
  */
 import { ethers, Contract } from 'ethers';
-import { ZERO_ADDRESS } from '../../../core/constants/index.js';
+import { ZERO_ADDRESS, getMulticall3Address } from '../../../core/constants/index.js';
 import { ERC20_BALANCE_ABI } from '../../../core/shared-abis/common.js';
+import { MULTICALL3_ABI } from '../../../abis/common.js';
 import { getErrorMessageFromUnknown } from '../../../core/index.js';
 import { PORTAL_ABI } from './config.js';
 import { getTokenToNativeQuoteByChainId } from '../../../core/quote/quote-helpers.js';
+import { batchGetTokenAndNativeBalances } from '../../../bundle/internal.js';
 /**
  * 获取 ERC20 代币 → 原生代币的报价
  * @param provider - Provider 实例
@@ -18,19 +20,18 @@ import { getTokenToNativeQuoteByChainId } from '../../../core/quote/quote-helper
 export async function getTokenToNativeQuote(provider, tokenAddress, tokenAmount, chainId) {
     return getTokenToNativeQuoteByChainId(provider, tokenAddress, tokenAmount, chainId);
 }
-// ✅ 使用公共模块中的 ERC20_BALANCE_ABI
-const ERC20_BALANCE_OF_ABI = ERC20_BALANCE_ABI;
 export async function calculateBuyerFunds({ buyer, buyerFunds, buyerFundsPercentage, reserveGasEth, nativeToken, useNativeToken = true, quoteToken, quoteTokenDecimals = 18, provider, }) {
     const reserveGas = ethers.parseEther((reserveGasEth || 0.0005).toString());
     // ✅ 根据是否使用原生代币获取不同的余额
     let buyerBalance;
+    let buyerNativeBalance = 0n;
     if (useNativeToken) {
         buyerBalance = await buyer.provider.getBalance(buyer.address);
     }
     else {
-        // ERC20 代币余额
-        const erc20 = new Contract(quoteToken, ERC20_BALANCE_OF_ABI, provider || buyer.provider);
-        buyerBalance = await erc20.balanceOf(buyer.address);
+        const paired = await batchGetTokenAndNativeBalances((provider || buyer.provider), [buyer.address], quoteToken, 56);
+        buyerBalance = paired.token[0] ?? 0n;
+        buyerNativeBalance = paired.native[0] ?? 0n;
     }
     let buyerFundsWei;
     if (buyerFunds !== undefined) {
@@ -63,7 +64,7 @@ export async function calculateBuyerFunds({ buyer, buyerFunds, buyerFundsPercent
             throw new Error(`买方代币余额不足: 需要 ${ethers.formatUnits(buyerFundsWei, quoteTokenDecimals)}，实际 ${ethers.formatUnits(buyerBalance, quoteTokenDecimals)}`);
         }
         // ✅ ERC20 购买时，还需要检查买方是否有足够 BNB 支付 Gas
-        const buyerBnbBalance = await buyer.provider.getBalance(buyer.address);
+        const buyerBnbBalance = buyerNativeBalance;
         if (buyerBnbBalance < reserveGas) {
             throw new Error(`买方 BNB 余额不足 (用于支付 Gas): 需要 ${ethers.formatEther(reserveGas)} ${nativeToken}，实际 ${ethers.formatEther(buyerBnbBalance)} ${nativeToken}`);
         }
@@ -96,8 +97,22 @@ export async function quoteBuyerOutput({ portalAddress, tokenAddress, buyerFunds
     return { quotedToken, sellAmountWei };
 }
 export async function ensureSellerBalance({ tokenAddress, provider, seller, sellAmountWei, skipBalanceCheck, }) {
-    const erc20 = new Contract(tokenAddress, ERC20_BALANCE_ABI, provider);
-    const [sellerTokenBal, decimals] = await Promise.all([erc20.balanceOf(seller.address), erc20.decimals()]);
+    const ercIface = new ethers.Interface(ERC20_BALANCE_ABI);
+    const chainId = Number((await provider.getNetwork()).chainId);
+    const multicall = new Contract(getMulticall3Address(chainId), MULTICALL3_ABI, provider);
+    const aggregate3 = multicall.aggregate3;
+    if (!aggregate3)
+        throw new Error('aggregate3 missing');
+    const rows = (await aggregate3.staticCall([
+        {
+            target: tokenAddress,
+            allowFailure: false,
+            callData: ercIface.encodeFunctionData('balanceOf', [seller.address]),
+        },
+        { target: tokenAddress, allowFailure: false, callData: ercIface.encodeFunctionData('decimals', []) },
+    ]));
+    const sellerTokenBal = ercIface.decodeFunctionResult('balanceOf', rows[0].returnData)[0];
+    const decimals = Number(ercIface.decodeFunctionResult('decimals', rows[1].returnData)[0]);
     if (!skipBalanceCheck && sellerTokenBal < sellAmountWei) {
         throw new Error(`卖方代币余额不足: 需要 ${ethers.formatUnits(sellAmountWei, decimals)}，实际 ${ethers.formatUnits(sellerTokenBal, decimals)}`);
     }

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

@@ -6,6 +6,7 @@ import { ERC20_ALLOWANCE_ABI } from '../../../core/shared-abis/common.js';
 import { getGasPriceConfig, getTxType, getProfitRecipient, PORTAL_ABI } from './config.js';
 import { getErrorMessageFromUnknown } from '../../../core/index.js';
 import { createSignProvider } from '../../../bundle/sign-context-helpers.js';
+import { batchGetBalances } from '../../../bundle/internal.js';
 import { APPROVE_INTERFACE, ERC20_BALANCE_OF_ABI, getChainId, getNativeTokenName, } from './swap-helpers.js';
 const providerCache = new Map();
 const PROVIDER_CACHE_TTL_MS = 60 * 1000;
@@ -113,9 +114,12 @@ export async function calculateBuyerNeed({ buyer, quotedNative, reserveGasEth, n
     return { reserveGas, buyerBalance, buyerNeedTotal, maxBuyerValue };
 }
 export async function validateBalances({ buyerAddress, portalGasCost, provider, chainContext, seller, useNativeToken, }) {
-    const sellerBalance = await provider.getBalance(seller.address);
+    const nativeBalances = useNativeToken
+        ? [await provider.getBalance(seller.address)]
+        : await batchGetBalances(provider, [seller.address, buyerAddress], undefined, chainContext.chainId);
+    const sellerBalance = nativeBalances[0] ?? 0n;
     if (!useNativeToken) {
-        const buyerBnbBalance = await provider.getBalance(buyerAddress);
+        const buyerBnbBalance = nativeBalances[1] ?? 0n;
         const buyerGasCost = portalGasCost;
         if (buyerBnbBalance < buyerGasCost) {
             throw new Error(`买方 BNB 余额不足 (用于支付 Gas):\n` +