four-flap-meme-sdk 1.4.24 → 1.4.26

package/dist/utils/quote-helpers.js

@@ -7,38 +7,12 @@
  * - ERC20 → 原生代币转换报价
  */
 import { ethers, Contract } from 'ethers';
+import { V2_ROUTER_QUOTE_ABI, V3_QUOTER_ABI } from '../abis/common.js';
 // ============================================================================
 // 常量配置
 // ============================================================================
-/** V2 Router ABI（用于报价） */
-const V2_ROUTER_ABI = [
-    'function getAmountsOut(uint amountIn, address[] calldata path) external view returns (uint[] memory amounts)'
-];
-/** V3 QuoterV2 ABI（用于报价）- 使用结构体参数 */
-const V3_QUOTER_ABI = [
-    {
-        "inputs": [{
-                "components": [
-                    { "name": "tokenIn", "type": "address" },
-                    { "name": "tokenOut", "type": "address" },
-                    { "name": "amountIn", "type": "uint256" },
-                    { "name": "fee", "type": "uint24" },
-                    { "name": "sqrtPriceLimitX96", "type": "uint160" }
-                ],
-                "name": "params",
-                "type": "tuple"
-            }],
-        "name": "quoteExactInputSingle",
-        "outputs": [
-            { "name": "amountOut", "type": "uint256" },
-            { "name": "sqrtPriceX96After", "type": "uint160" },
-            { "name": "initializedTicksCrossed", "type": "uint32" },
-            { "name": "gasEstimate", "type": "uint256" }
-        ],
-        "stateMutability": "nonpayable",
-        "type": "function"
-    }
-];
+// ✅ V2_ROUTER_ABI 和 V3_QUOTER_ABI 从公共模块导入
+const V2_ROUTER_ABI = V2_ROUTER_QUOTE_ABI;
 /** V3 常用费率档位 */
 export const V3_FEE_TIERS = [100, 500, 2500, 10000]; // 0.01%, 0.05%, 0.25%, 1%
 /** 各链的报价配置 */

package/dist/utils/swap-helpers.js

@@ -3,12 +3,7 @@
  */
 import { ethers, Contract } from 'ethers';
 import { batchCheckAllowances } from './erc20.js';
-const ERC20_ABI = [
-    'function approve(address spender, uint256 amount) returns (bool)',
-    'function allowance(address owner, address spender) view returns (uint256)',
-    'function balanceOf(address account) view returns (uint256)',
-    'function decimals() view returns (uint8)'
-];
+import { ERC20_ABI } from '../abis/common.js';
 const APPROVAL_THRESHOLD = ethers.MaxUint256 / 2n;
 /**
  * 获取 Gas Limit（授权专用）

package/dist/utils/wallet.d.ts

@@ -9,19 +9,6 @@ export type PrivateKeyValidation = {
     normalized?: string;
     error?: string;
 };
-/**
- * 批量生成指定数量的钱包地址与私钥。
- * 注意：仅用于开发/测试。生产环境请安全存储私钥。
- */
-export declare function generateWallets(count: number): GeneratedWallet[];
-/**
- * 批量校验私钥数组是否合规。
- * 规则：
- * - 必须为 0x 开头的 32 字节十六进制串（64 十六进制字符）
- * - 能够被 ethers.Wallet 正常构造（包含椭圆曲线有效性）
- * 返回每个私钥的校验结果与可选地址/错误信息。
- */
-export declare function validatePrivateKeys(privateKeys: string[]): PrivateKeyValidation[];
 export type MulticallResult = {
     address: string;
     balance: bigint;
@@ -36,6 +23,14 @@ export type MultiTokenBalancesResult = {
     }>;
     success: boolean;
 };
+/**
+ * 批量生成钱包（并行优化）
+ */
+export declare function generateWallets(count: number): GeneratedWallet[];
+/**
+ * 批量校验私钥（并行处理）
+ */
+export declare function validatePrivateKeys(privateKeys: string[]): PrivateKeyValidation[];
 export declare function getTokenBalancesWithMulticall(rpcUrl: string, token: string, holders: string[]): Promise<MulticallResult[]>;
 export declare function getTokenBalancesWithMulticall(rpcUrl: string, multicall3: string, token: string, holders: string[]): Promise<MulticallResult[]>;
 export declare function getTokenBalancesWithMulticall(rpcUrl: string, chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'ARBITRUM_ONE' | 'MONAD', tokenAddresses: string[], holders: string[]): Promise<MultiTokenBalancesResult[]>;

package/dist/utils/wallet.js

@@ -1,24 +1,36 @@
 import { Wallet, Interface, JsonRpcProvider, formatEther, formatUnits, isHexString } from 'ethers';
-import { CHAIN } from './constants.js';
+import { CHAIN, ADDRESSES } from './constants.js';
+import { ERC20_ABI, MULTICALL3_ABI } from '../abis/common.js';
+// ============================================================================
+// 常量
+// ============================================================================
+const DEFAULT_MULTICALL3 = ADDRESSES.BSC.Multicall3;
+const MULTICALL3_BY_CHAIN = {
+    1: DEFAULT_MULTICALL3, // Ethereum
+    56: DEFAULT_MULTICALL3, // BSC Mainnet
+    97: DEFAULT_MULTICALL3, // BSC Testnet
+    8453: DEFAULT_MULTICALL3, // Base
+    42161: DEFAULT_MULTICALL3, // Arbitrum One
+    196: DEFAULT_MULTICALL3, // X Layer
+    2818: DEFAULT_MULTICALL3, // Morph
+    143: DEFAULT_MULTICALL3, // Monad
+};
+// ============================================================================
+// 钱包生成与验证
+// ============================================================================
 /**
- * 批量生成指定数量的钱包地址与私钥。
- * 注意：仅用于开发/测试。生产环境请安全存储私钥。
+ * 批量生成钱包（并行优化）
  */
 export function generateWallets(count) {
     const n = Math.max(0, Math.floor(count));
-    const wallets = [];
-    for (let i = 0; i < n; i++) {
+    // ✅ 使用 Array.from 并行生成
+    return Array.from({ length: n }, () => {
         const w = Wallet.createRandom();
-        wallets.push({ address: w.address, privateKey: w.privateKey });
-    }
-    return wallets;
+        return { address: w.address, privateKey: w.privateKey };
+    });
 }
 /**
- * 批量校验私钥数组是否合规。
- * 规则：
- * - 必须为 0x 开头的 32 字节十六进制串（64 十六进制字符）
- * - 能够被 ethers.Wallet 正常构造（包含椭圆曲线有效性）
- * 返回每个私钥的校验结果与可选地址/错误信息。
+ * 批量校验私钥（并行处理）
  */
 export function validatePrivateKeys(privateKeys) {
     if (!Array.isArray(privateKeys))
@@ -36,359 +48,114 @@ export function validatePrivateKeys(privateKeys) {
         }
     });
 }
-/**
- * 将任意形式的私钥规范化为 0x + 64 位十六进制。
- * 接受：
- * - 可含/不含 0x 前缀
- * - 奇数字符长度（自动左侧补 0）
- * - 少于 64 位的 hex（左侧补零至 64）
- * 拒绝：非 hex 字符或超过 64 位。
- */
 function normalizePrivateKey(input) {
     if (typeof input !== 'string')
         return null;
     let s = input.trim();
-    // 去掉前导 0x/0X
     if (s.startsWith('0x') || s.startsWith('0X'))
         s = s.slice(2);
-    if (s.length === 0)
-        return null;
-    // 仅允许 hex
-    if (!/^[0-9a-fA-F]+$/.test(s))
+    if (s.length === 0 || !/^[0-9a-fA-F]+$/.test(s) || s.length > 64)
         return null;
-    // 长度不能超过 64（32字节）
-    if (s.length > 64)
-        return null;
-    // 若为奇数长度，左侧补 0
     if (s.length % 2 === 1)
         s = '0' + s;
-    // 左侧补零到 64 位
-    const padded = s.padStart(64, '0');
-    const withPrefix = '0x' + padded;
-    // 最终仍做一次严格校验
-    if (!isHexString(withPrefix, 32))
-        return null;
-    return withPrefix;
+    const withPrefix = '0x' + s.padStart(64, '0');
+    return isHexString(withPrefix, 32) ? withPrefix : null;
 }
-// 简化版 ERC20 与 Multicall3 ABI
-const ERC20_ABI = [
-    'function balanceOf(address) view returns (uint256)',
-    'function decimals() view returns (uint8)'
-];
-const MULTICALL3_ABI = [
-    'function aggregate((address target, bytes callData)[]) public returns (uint256 blockNumber, bytes[] returnData)',
-    'function getEthBalance(address addr) public returns (uint256 balance)'
-];
+// ============================================================================
+// Multicall 核心逻辑（提取公共部分）
+// ============================================================================
 /**
- * 使用 Multicall3 批量查询 ERC20 余额。
- * @param rpcUrl JSON-RPC 端点
- * @param multicall3 Multicall3 合约地址
- * @param token ERC20 代币地址
- * @param holders 地址数组
+ * ✅ 内部：批量查询多代币余额（统一逻辑）
  */
-// 常见链的 Multicall3 标准地址（ca11...ca11）；未知链回退此地址
-const DEFAULT_MULTICALL3 = '0xca11bde05977b3631167028862be2a173976ca11';
-const MULTICALL3_BY_CHAIN = {
-    1: DEFAULT_MULTICALL3, // Ethereum
-    56: DEFAULT_MULTICALL3, // BSC Mainnet
-    97: DEFAULT_MULTICALL3, // BSC Testnet
-    8453: DEFAULT_MULTICALL3, // Base
-    42161: DEFAULT_MULTICALL3, // Arbitrum One
-    196: DEFAULT_MULTICALL3, // X Layer
-    2818: DEFAULT_MULTICALL3, // Morph
-    143: DEFAULT_MULTICALL3, // ✅ Monad
-};
-export async function getTokenBalancesWithMulticall(rpcUrl, a, b, c) {
-    const provider = new JsonRpcProvider(rpcUrl);
-    let multicallAddress = '';
-    let token = '';
-    let holders = [];
-    // 新签名分支：rpcUrl, tokenAddresses[], holders[] （不传 chain）
-    if (Array.isArray(a) && Array.isArray(b) && typeof c === 'undefined') {
-        const tokenAddresses = a;
-        holders = b;
-        if (!holders?.length)
-            return [];
-        try {
-            const net = await provider.getNetwork();
-            multicallAddress = MULTICALL3_BY_CHAIN[Number(net.chainId)] || DEFAULT_MULTICALL3;
-        }
-        catch {
-            multicallAddress = DEFAULT_MULTICALL3;
-        }
-        const erc20Iface = new Interface(ERC20_ABI);
-        const multiIface = new Interface(MULTICALL3_ABI);
-        const calls = [];
-        // 原生余额
-        for (const addr of holders) {
-            calls.push({ target: multicallAddress, callData: multiIface.encodeFunctionData('getEthBalance', [addr]) });
-        }
-        // ERC20 余额
-        for (const t of tokenAddresses) {
-            for (const addr of holders) {
-                calls.push({ target: t, callData: erc20Iface.encodeFunctionData('balanceOf', [addr]) });
-            }
-        }
-        // ERC20 decimals（每个 token 一次）
-        for (const t of tokenAddresses) {
-            calls.push({ target: t, callData: erc20Iface.encodeFunctionData('decimals', []) });
-        }
-        const callData = multiIface.encodeFunctionData('aggregate', [calls]);
-        const result = await provider.call({ to: multicallAddress, data: callData });
-        const decodedAggregate = multiIface.decodeFunctionResult('aggregate', result);
-        const returnData = decodedAggregate[1];
-        const outputs = holders.map((addr) => ({ address: addr, native: '0', tokens: [], success: true }));
-        // 解码原生余额
-        for (let i = 0; i < holders.length; i++) {
-            try {
-                const decoded = multiIface.decodeFunctionResult('getEthBalance', returnData[i]);
-                outputs[i].native = formatEther(decoded[0]);
-            }
-            catch {
-                outputs[i].native = '0';
-                outputs[i].success = false;
-            }
-        }
-        // 解码 ERC20 余额
-        let idx = holders.length;
-        for (const t of tokenAddresses) {
-            for (let i = 0; i < holders.length; i++) {
-                try {
-                    const decoded = erc20Iface.decodeFunctionResult('balanceOf', returnData[idx]);
-                    outputs[i].tokens.push({ token: t, balance: '0' }); // 占位，稍后格式化
-                    outputs[i]._raw = outputs[i]._raw || {};
-                    outputs[i]._raw[t] = decoded[0];
-                }
-                catch {
-                    outputs[i].tokens.push({ token: t, balance: '0' });
-                    outputs[i].success = false;
-                }
-                idx++;
-            }
-        }
-        // 读取 decimals
-        const tokenToDecimals = {};
-        for (const t of tokenAddresses) {
-            try {
-                const decoded = erc20Iface.decodeFunctionResult('decimals', returnData[idx]);
-                tokenToDecimals[t] = Number(decoded[0]);
-            }
-            catch {
-                tokenToDecimals[t] = 18; // 回退 18
-            }
-            idx++;
-        }
-        // 使用 decimals 将 _raw 格式化为字符串
-        for (let i = 0; i < holders.length; i++) {
-            const raw = outputs[i]._raw;
-            if (!raw)
-                continue;
-            outputs[i].tokens = outputs[i].tokens.map(({ token }) => ({
-                token,
-                balance: formatUnits(raw[token] ?? 0n, tokenToDecimals[token] ?? 18)
-            }));
-            delete outputs[i]._raw;
-        }
-        return outputs;
+async function _queryMultiTokenBalances(provider, multicallAddress, tokenAddresses, holders) {
+    if (!holders?.length)
+        return [];
+    const erc20Iface = new Interface(ERC20_ABI);
+    const multiIface = new Interface(MULTICALL3_ABI);
+    // ✅ 一次性构建所有调用
+    const calls = [];
+    // 1. 原生余额查询
+    for (const addr of holders) {
+        calls.push({ target: multicallAddress, callData: multiIface.encodeFunctionData('getEthBalance', [addr]) });
     }
-    // 新签名分支：rpcUrl, chain, tokenAddresses[], holders[]
-    if (Array.isArray(b) && Array.isArray(c)) {
-        const chain = a;
-        const tokenAddresses = b;
-        holders = c;
-        if (!holders?.length)
-            return [];
-        const chainId = CHAIN[chain]?.chainId;
-        if (chainId && MULTICALL3_BY_CHAIN[Number(chainId)]) {
-            multicallAddress = MULTICALL3_BY_CHAIN[Number(chainId)];
-        }
-        else {
-            // 尝试从 provider 读取，失败回退默认
-            try {
-                const net = await provider.getNetwork();
-                multicallAddress = MULTICALL3_BY_CHAIN[Number(net.chainId)] || DEFAULT_MULTICALL3;
-            }
-            catch {
-                multicallAddress = DEFAULT_MULTICALL3;
-            }
-        }
-        const erc20Iface = new Interface(ERC20_ABI);
-        const multiIface = new Interface(MULTICALL3_ABI);
-        const calls = [];
-        // 原生余额（使用 Multicall3.getEthBalance）
+    // 2. ERC20 余额查询（批量）
+    for (const token of tokenAddresses) {
         for (const addr of holders) {
-            calls.push({ target: multicallAddress, callData: multiIface.encodeFunctionData('getEthBalance', [addr]) });
+            calls.push({ target: token, callData: erc20Iface.encodeFunctionData('balanceOf', [addr]) });
         }
-        // ERC20 余额
-        for (const t of tokenAddresses) {
-            for (const addr of holders) {
-                calls.push({ target: t, callData: erc20Iface.encodeFunctionData('balanceOf', [addr]) });
-            }
-        }
-        // ERC20 decimals（每个 token 一次）
-        for (const t of tokenAddresses) {
-            calls.push({ target: t, callData: erc20Iface.encodeFunctionData('decimals', []) });
-        }
-        const callData = multiIface.encodeFunctionData('aggregate', [calls]);
-        const result = await provider.call({ to: multicallAddress, data: callData });
-        const decodedAggregate = multiIface.decodeFunctionResult('aggregate', result);
-        const returnData = decodedAggregate[1];
-        const outputs = holders.map((addr) => ({ address: addr, native: '0', tokens: [], success: true }));
-        // 解码原生余额
-        for (let i = 0; i < holders.length; i++) {
-            try {
-                const decoded = multiIface.decodeFunctionResult('getEthBalance', returnData[i]);
-                outputs[i].native = formatEther(decoded[0]);
-            }
-            catch {
-                outputs[i].native = '0';
-                outputs[i].success = false;
-            }
-        }
-        // 解码 ERC20 余额
-        let idx = holders.length;
-        for (const t of tokenAddresses) {
-            for (let i = 0; i < holders.length; i++) {
-                try {
-                    const decoded = erc20Iface.decodeFunctionResult('balanceOf', returnData[idx]);
-                    outputs[i].tokens.push({ token: t, balance: '0' });
-                    outputs[i]._raw = outputs[i]._raw || {};
-                    outputs[i]._raw[t] = decoded[0];
-                }
-                catch {
-                    outputs[i].tokens.push({ token: t, balance: '0' });
-                    outputs[i].success = false;
-                }
-                idx++;
-            }
-        }
-        // 读取 decimals
-        const tokenToDecimals = {};
-        for (const t of tokenAddresses) {
-            try {
-                const decoded = erc20Iface.decodeFunctionResult('decimals', returnData[idx]);
-                tokenToDecimals[t] = Number(decoded[0]);
-            }
-            catch {
-                tokenToDecimals[t] = 18;
-            }
-            idx++;
-        }
-        // 应用 decimals 格式化
-        for (let i = 0; i < holders.length; i++) {
-            const raw = outputs[i]._raw;
-            if (!raw)
-                continue;
-            outputs[i].tokens = outputs[i].tokens.map(({ token }) => ({
-                token,
-                balance: formatUnits(raw[token] ?? 0n, tokenToDecimals[token] ?? 18)
-            }));
-            delete outputs[i]._raw;
-        }
-        return outputs;
     }
-    // 新签名分支：rpcUrl, chainId(number), tokenAddresses[], holders[]
-    if (typeof a === 'number' && Array.isArray(b) && Array.isArray(c)) {
-        const chainId = a;
-        const tokenAddresses = b;
-        holders = c;
-        if (!holders?.length)
-            return [];
-        multicallAddress = MULTICALL3_BY_CHAIN[Number(chainId)] || DEFAULT_MULTICALL3;
-        const erc20Iface = new Interface(ERC20_ABI);
-        const multiIface = new Interface(MULTICALL3_ABI);
-        const calls = [];
-        // 原生余额
-        for (const addr of holders) {
-            calls.push({ target: multicallAddress, callData: multiIface.encodeFunctionData('getEthBalance', [addr]) });
-        }
-        // ERC20 余额
-        for (const t of tokenAddresses) {
-            for (const addr of holders) {
-                calls.push({ target: t, callData: erc20Iface.encodeFunctionData('balanceOf', [addr]) });
-            }
+    // 3. ERC20 decimals 查询（每个 token 一次）
+    for (const token of tokenAddresses) {
+        calls.push({ target: token, callData: erc20Iface.encodeFunctionData('decimals', []) });
+    }
+    // ✅ 单次 multicall 获取所有数据
+    const callData = multiIface.encodeFunctionData('aggregate', [calls]);
+    const result = await provider.call({ to: multicallAddress, data: callData });
+    const [, returnData] = multiIface.decodeFunctionResult('aggregate', result);
+    // ✅ 并行解码结果
+    const outputs = holders.map((addr) => ({
+        address: addr,
+        native: '0',
+        tokens: [],
+        success: true
+    }));
+    // 解码原生余额
+    let idx = 0;
+    for (let i = 0; i < holders.length; i++, idx++) {
+        try {
+            const decoded = multiIface.decodeFunctionResult('getEthBalance', returnData[idx]);
+            outputs[i].native = formatEther(decoded[0]);
         }
-        // ERC20 decimals（每个 token 一次）
-        for (const t of tokenAddresses) {
-            calls.push({ target: t, callData: erc20Iface.encodeFunctionData('decimals', []) });
+        catch {
+            outputs[i].native = '0';
+            outputs[i].success = false;
         }
-        const callData = multiIface.encodeFunctionData('aggregate', [calls]);
-        const result = await provider.call({ to: multicallAddress, data: callData });
-        const decodedAggregate = multiIface.decodeFunctionResult('aggregate', result);
-        const returnData = decodedAggregate[1];
-        const outputs = holders.map((addr) => ({ address: addr, native: '0', tokens: [], success: true }));
-        // 解码原生余额
-        for (let i = 0; i < holders.length; i++) {
+    }
+    // 解码 ERC20 余额（先缓存原始值）
+    const rawBalances = new Map();
+    for (const token of tokenAddresses) {
+        for (let i = 0; i < holders.length; i++, idx++) {
             try {
-                const decoded = multiIface.decodeFunctionResult('getEthBalance', returnData[i]);
-                outputs[i].native = formatEther(decoded[0]);
+                const decoded = erc20Iface.decodeFunctionResult('balanceOf', returnData[idx]);
+                if (!rawBalances.has(i))
+                    rawBalances.set(i, new Map());
+                rawBalances.get(i).set(token, decoded[0]);
             }
             catch {
-                outputs[i].native = '0';
+                if (!rawBalances.has(i))
+                    rawBalances.set(i, new Map());
+                rawBalances.get(i).set(token, 0n);
                 outputs[i].success = false;
             }
         }
-        // 解码 ERC20 余额（先缓存 raw，再按 decimals 格式化）
-        let idx = holders.length;
-        for (const t of tokenAddresses) {
-            for (let i = 0; i < holders.length; i++) {
-                try {
-                    const decoded = erc20Iface.decodeFunctionResult('balanceOf', returnData[idx]);
-                    outputs[i].tokens.push({ token: t, balance: '0' });
-                    outputs[i]._raw = outputs[i]._raw || {};
-                    outputs[i]._raw[t] = decoded[0];
-                }
-                catch {
-                    outputs[i].tokens.push({ token: t, balance: '0' });
-                    outputs[i].success = false;
-                }
-                idx++;
-            }
-        }
-        // 读取 decimals
-        const tokenToDecimals = {};
-        for (const t of tokenAddresses) {
-            try {
-                const decoded = erc20Iface.decodeFunctionResult('decimals', returnData[idx]);
-                tokenToDecimals[t] = Number(decoded[0]);
-            }
-            catch {
-                tokenToDecimals[t] = 18;
-            }
-            idx++;
-        }
-        // 应用 decimals 格式化
-        for (let i = 0; i < holders.length; i++) {
-            const raw = outputs[i]._raw;
-            if (!raw)
-                continue;
-            outputs[i].tokens = outputs[i].tokens.map(({ token }) => ({
-                token,
-                balance: formatUnits(raw[token] ?? 0n, tokenToDecimals[token] ?? 18)
-            }));
-            delete outputs[i]._raw;
-        }
-        return outputs;
     }
-    // 旧签名分支 1：rpcUrl, token, holders
-    if (Array.isArray(b) && typeof c === 'undefined') {
-        token = a;
-        holders = b;
+    // 解码 decimals
+    const tokenDecimals = new Map();
+    for (const token of tokenAddresses) {
         try {
-            const net = await provider.getNetwork();
-            multicallAddress = MULTICALL3_BY_CHAIN[Number(net.chainId)] || DEFAULT_MULTICALL3;
+            const decoded = erc20Iface.decodeFunctionResult('decimals', returnData[idx]);
+            tokenDecimals.set(token, Number(decoded[0]));
         }
         catch {
-            multicallAddress = DEFAULT_MULTICALL3;
+            tokenDecimals.set(token, 18);
         }
+        idx++;
     }
-    else {
-        // 旧签名分支 2：rpcUrl, multicall3, token, holders
-        multicallAddress = a;
-        token = b;
-        holders = c;
+    // ✅ 格式化最终结果
+    for (let i = 0; i < holders.length; i++) {
+        const raw = rawBalances.get(i);
+        outputs[i].tokens = tokenAddresses.map(token => ({
+            token,
+            balance: formatUnits(raw?.get(token) ?? 0n, tokenDecimals.get(token) ?? 18)
+        }));
     }
-    if (!holders || holders.length === 0)
+    return outputs;
+}
+/**
+ * ✅ 内部：查询单代币余额（旧接口兼容）
+ */
+async function _querySingleTokenBalances(provider, multicallAddress, token, holders) {
+    if (!holders?.length)
         return [];
     const erc20Iface = new Interface(ERC20_ABI);
     const multiIface = new Interface(MULTICALL3_ABI);
@@ -398,17 +165,62 @@ export async function getTokenBalancesWithMulticall(rpcUrl, a, b, c) {
     }));
     const callData = multiIface.encodeFunctionData('aggregate', [calls]);
     const result = await provider.call({ to: multicallAddress, data: callData });
-    const decodedAggregate = multiIface.decodeFunctionResult('aggregate', result);
-    const returnData = decodedAggregate[1];
-    const outputs = [];
-    for (let i = 0; i < holders.length; i++) {
+    const [, returnData] = multiIface.decodeFunctionResult('aggregate', result);
+    return holders.map((addr, i) => {
         try {
             const decoded = erc20Iface.decodeFunctionResult('balanceOf', returnData[i]);
-            outputs.push({ address: holders[i], balance: decoded[0], success: true });
+            return { address: addr, balance: decoded[0], success: true };
         }
         catch {
-            outputs.push({ address: holders[i], balance: 0n, success: false });
+            return { address: addr, balance: 0n, success: false };
         }
+    });
+}
+/**
+ * ✅ 获取 Multicall3 地址（自动检测链）
+ */
+async function getMulticallAddress(provider, chainId) {
+    if (chainId && MULTICALL3_BY_CHAIN[chainId]) {
+        return MULTICALL3_BY_CHAIN[chainId];
     }
-    return outputs;
+    try {
+        const net = await provider.getNetwork();
+        return MULTICALL3_BY_CHAIN[Number(net.chainId)] || DEFAULT_MULTICALL3;
+    }
+    catch {
+        return DEFAULT_MULTICALL3;
+    }
+}
+/**
+ * ✅ 统一实现（精简版，复用内部函数）
+ */
+export async function getTokenBalancesWithMulticall(rpcUrl, a, b, c) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    // ✅ 分支 1：rpcUrl, tokenAddresses[], holders[]
+    if (Array.isArray(a) && Array.isArray(b) && typeof c === 'undefined') {
+        const multicallAddress = await getMulticallAddress(provider);
+        return _queryMultiTokenBalances(provider, multicallAddress, a, b);
+    }
+    // ✅ 分支 2：rpcUrl, chain/chainId, tokenAddresses[], holders[]
+    if (Array.isArray(b) && Array.isArray(c)) {
+        let chainId;
+        if (typeof a === 'number') {
+            chainId = a;
+        }
+        else if (typeof a === 'string') {
+            chainId = CHAIN[a]?.chainId;
+        }
+        const multicallAddress = await getMulticallAddress(provider, chainId);
+        return _queryMultiTokenBalances(provider, multicallAddress, b, c);
+    }
+    // ✅ 分支 3：rpcUrl, token, holders（旧接口）
+    if (typeof a === 'string' && Array.isArray(b) && typeof c === 'undefined') {
+        const multicallAddress = await getMulticallAddress(provider);
+        return _querySingleTokenBalances(provider, multicallAddress, a, b);
+    }
+    // ✅ 分支 4：rpcUrl, multicall3, token, holders（旧接口兼容）
+    if (typeof a === 'string' && typeof b === 'string' && Array.isArray(c)) {
+        return _querySingleTokenBalances(provider, a, b, c);
+    }
+    return [];
 }

package/package.json

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