four-flap-meme-sdk 4.1.0 → 4.2.0

package/dist/utils/pancake-router-tx.d.ts

@@ -0,0 +1,41 @@
+/**
+ * PancakeSwap Router 交易构建 / 报价 / 授权目标
+ *
+ * flap 与 four-meme pancake-proxy helpers 共用，避免两份实现分叉。
+ * 不负责 minOut / 滑点（同钱包刷量仍走 quote.ts 的 0n）。
+ */
+import { Wallet, Contract, type JsonRpcProvider } from 'ethers';
+import type { ContractTransaction } from 'ethers/contract';
+export declare const MULTICALL3_ADDRESS: "0xcA11bde05977b3631167028862bE2a173976CA11";
+export declare const WBNB_ADDRESS: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
+export declare const PANCAKE_V2_ROUTER_ADDRESS: "0x10ED43C718714eb63d5aA57B78B54704E256024E";
+export declare const PANCAKE_V3_ROUTER_ADDRESS: "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
+export declare const PANCAKE_V3_QUOTER_ADDRESS: "0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997";
+export declare const V3_ROUTER_ABI: (string | {
+    inputs: {
+        components: {
+            name: string;
+            type: string;
+        }[];
+        name: string;
+        type: string;
+    }[];
+    name: string;
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+    type: string;
+})[];
+export type PancakeRouteNeedBnb = {
+    v2Path?: string[];
+    v3TokenIn?: string;
+    v3ExactTokenIn?: string;
+};
+export declare function needSendBNBFromRoute(routeType: string, params: PancakeRouteNeedBnb, wbnbAddress?: string): boolean;
+export declare function getApprovalTarget(routeType: string): string;
+export declare function buildV2Transactions(routers: Contract[], wallets: Wallet[], amountsWei: bigint[], minOuts: bigint[], path: string[], isBuy: boolean, needBNB: boolean): Promise<ContractTransaction[]>;
+export declare function buildV3SingleTransactions(routers: Contract[], wallets: Wallet[], tokenIn: string, tokenOut: string, fee: number, amountsWei: bigint[], minOuts: bigint[], isBuy: boolean, needBNB: boolean): Promise<ContractTransaction[]>;
+export declare function buildV3MultiHopTransactions(routers: Contract[], wallets: Wallet[], tokens: string[], fees: number[], amountsWei: bigint[], minOuts: bigint[], isBuy: boolean, needBNB: boolean): Promise<ContractTransaction[]>;
+export declare function batchGetV2Quotes(provider: JsonRpcProvider, amountsWei: bigint[], v2Path: string[]): Promise<bigint[]>;

package/dist/utils/pancake-router-tx.js

@@ -0,0 +1,174 @@
+/**
+ * PancakeSwap Router 交易构建 / 报价 / 授权目标
+ *
+ * flap 与 four-meme pancake-proxy helpers 共用，避免两份实现分叉。
+ * 不负责 minOut / 滑点（同钱包刷量仍走 quote.ts 的 0n）。
+ */
+import { Contract, Interface } from 'ethers';
+import { getDeadline, encodeV3Path } from './bundle-helpers.js';
+import { ADDRESSES } from '../core/constants/index.js';
+import { V2_ROUTER_ABI, MULTICALL3_ABI, V3_ROUTER02_ABI } from '../abis/common.js';
+export const MULTICALL3_ADDRESS = ADDRESSES.BSC.Multicall3;
+export const WBNB_ADDRESS = ADDRESSES.BSC.WBNB;
+export const PANCAKE_V2_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV2Router;
+export const PANCAKE_V3_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV3Router;
+export const PANCAKE_V3_QUOTER_ADDRESS = ADDRESSES.BSC.PancakeV3Quoter;
+export const V3_ROUTER_ABI = V3_ROUTER02_ABI;
+export function needSendBNBFromRoute(routeType, params, wbnbAddress = WBNB_ADDRESS) {
+    const wbnb = wbnbAddress.toLowerCase();
+    if (routeType === 'v2' && params.v2Path && params.v2Path[0].toLowerCase() === wbnb) {
+        return true;
+    }
+    if (routeType === 'v3-single' && params.v3TokenIn && params.v3TokenIn.toLowerCase() === wbnb) {
+        return true;
+    }
+    if (routeType === 'v3-multi' &&
+        params.v3ExactTokenIn &&
+        params.v3ExactTokenIn.toLowerCase() === wbnb) {
+        return true;
+    }
+    return false;
+}
+export function getApprovalTarget(routeType) {
+    if (routeType === 'v2') {
+        return PANCAKE_V2_ROUTER_ADDRESS;
+    }
+    return PANCAKE_V3_ROUTER_ADDRESS;
+}
+export async function buildV2Transactions(routers, wallets, amountsWei, minOuts, path, isBuy, needBNB) {
+    const deadline = getDeadline();
+    return Promise.all(routers.map(async (router, i) => {
+        if (isBuy && needBNB) {
+            return router.swapExactETHForTokensSupportingFeeOnTransferTokens.populateTransaction(minOuts[i], path, wallets[i].address, deadline, { value: amountsWei[i] });
+        }
+        return router.swapExactTokensForETHSupportingFeeOnTransferTokens.populateTransaction(amountsWei[i], minOuts[i], path, wallets[i].address, deadline);
+    }));
+}
+export async function buildV3SingleTransactions(routers, wallets, tokenIn, tokenOut, fee, amountsWei, minOuts, isBuy, needBNB) {
+    const deadline = getDeadline();
+    const v3RouterIface = new Interface(V3_ROUTER_ABI);
+    return Promise.all(routers.map(async (router, i) => {
+        const isTokenOutWBNB = tokenOut.toLowerCase() === WBNB_ADDRESS.toLowerCase();
+        const exactInputSingleData = v3RouterIface.encodeFunctionData('exactInputSingle', [
+            {
+                tokenIn: tokenIn,
+                tokenOut: tokenOut,
+                fee: fee,
+                recipient: isTokenOutWBNB ? PANCAKE_V3_ROUTER_ADDRESS : wallets[i].address,
+                amountIn: amountsWei[i],
+                amountOutMinimum: minOuts[i],
+                sqrtPriceLimitX96: 0n,
+            },
+        ]);
+        if (isBuy && needBNB) {
+            return router.multicall.populateTransaction(deadline, [exactInputSingleData], { value: amountsWei[i] });
+        }
+        if (!isBuy && isTokenOutWBNB) {
+            const unwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [minOuts[i], wallets[i].address]);
+            return router.multicall.populateTransaction(deadline, [exactInputSingleData, unwrapData]);
+        }
+        return router.multicall.populateTransaction(deadline, [exactInputSingleData]);
+    }));
+}
+export async function buildV3MultiHopTransactions(routers, wallets, tokens, fees, amountsWei, minOuts, isBuy, needBNB) {
+    if (!tokens || tokens.length < 2) {
+        throw new Error('V3 多跳需要至少 2 个代币（v3Tokens）');
+    }
+    if (!fees || fees.length !== tokens.length - 1) {
+        throw new Error(`V3 多跳费率数量 (${fees?.length || 0}) 必须等于代币数量 - 1 (${tokens.length - 1})（v3Fees）`);
+    }
+    const deadline = getDeadline();
+    const v3RouterIface = new Interface(V3_ROUTER_ABI);
+    const forwardPath = encodeV3Path(tokens, fees);
+    const reversedTokens = [...tokens].reverse();
+    const reversedFees = [...fees].reverse();
+    const reversePath = encodeV3Path(reversedTokens, reversedFees);
+    const tokenOut = tokens[tokens.length - 1];
+    const isTokenOutWBNB = tokenOut.toLowerCase() === WBNB_ADDRESS.toLowerCase();
+    return Promise.all(routers.map(async (router, i) => {
+        if (isBuy && needBNB) {
+            const swapData = v3RouterIface.encodeFunctionData('exactInput', [
+                {
+                    path: forwardPath,
+                    recipient: wallets[i].address,
+                    amountIn: amountsWei[i],
+                    amountOutMinimum: minOuts[i],
+                },
+            ]);
+            return router.multicall.populateTransaction(deadline, [swapData], { value: amountsWei[i] });
+        }
+        if (!isBuy) {
+            const swapData = v3RouterIface.encodeFunctionData('exactInput', [
+                {
+                    path: reversePath,
+                    recipient: isTokenOutWBNB ? PANCAKE_V3_ROUTER_ADDRESS : wallets[i].address,
+                    amountIn: amountsWei[i],
+                    amountOutMinimum: minOuts[i],
+                },
+            ]);
+            if (isTokenOutWBNB) {
+                const unwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [minOuts[i], wallets[i].address]);
+                return router.multicall.populateTransaction(deadline, [swapData, unwrapData]);
+            }
+            return router.multicall.populateTransaction(deadline, [swapData]);
+        }
+        const swapData = v3RouterIface.encodeFunctionData('exactInput', [
+            {
+                path: forwardPath,
+                recipient: wallets[i].address,
+                amountIn: amountsWei[i],
+                amountOutMinimum: minOuts[i],
+            },
+        ]);
+        return router.multicall.populateTransaction(deadline, [swapData]);
+    }));
+}
+export async function batchGetV2Quotes(provider, amountsWei, v2Path) {
+    if (amountsWei.length === 0)
+        return [];
+    if (amountsWei.length === 1) {
+        try {
+            const v2Router = new Contract(PANCAKE_V2_ROUTER_ADDRESS, V2_ROUTER_ABI, provider);
+            const amounts = await v2Router.getAmountsOut(amountsWei[0], v2Path);
+            return [amounts[amounts.length - 1]];
+        }
+        catch {
+            return [0n];
+        }
+    }
+    try {
+        const v2RouterIface = new Interface(V2_ROUTER_ABI);
+        const multicall = new Contract(MULTICALL3_ADDRESS, MULTICALL3_ABI, provider);
+        const calls = amountsWei.map((amount) => ({
+            target: PANCAKE_V2_ROUTER_ADDRESS,
+            allowFailure: true,
+            callData: v2RouterIface.encodeFunctionData('getAmountsOut', [amount, v2Path]),
+        }));
+        const results = await multicall.aggregate3.staticCall(calls);
+        return results.map((r) => {
+            if (r.success && r.returnData && r.returnData !== '0x') {
+                try {
+                    const decoded = v2RouterIface.decodeFunctionResult('getAmountsOut', r.returnData);
+                    const amounts = decoded[0];
+                    return amounts[amounts.length - 1];
+                }
+                catch {
+                    return 0n;
+                }
+            }
+            return 0n;
+        });
+    }
+    catch {
+        return await Promise.all(amountsWei.map(async (amount) => {
+            try {
+                const v2Router = new Contract(PANCAKE_V2_ROUTER_ADDRESS, V2_ROUTER_ABI, provider);
+                const amounts = await v2Router.getAmountsOut(amount, v2Path);
+                return amounts[amounts.length - 1];
+            }
+            catch {
+                return 0n;
+            }
+        }));
+    }
+}

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

@@ -20,10 +20,14 @@ export declare function ensureTokenApproval(provider: JsonRpcProvider, merkle: M
  * 获取代币余额
  */
 export declare function getTokenBalance(provider: JsonRpcProvider, tokenAddress: string, walletAddress: string): Promise<bigint>;
+export type GetTokenDecimalsOptions = {
+    fallback?: number;
+    cache?: boolean;
+};
 /**
- * 获取代币精度
+ * 获取代币精度。cache 按地址缓存；fallback 在 RPC 失败时使用（不抛）。
  */
-export declare function getTokenDecimals(provider: JsonRpcProvider, tokenAddress: string): Promise<number>;
+export declare function getTokenDecimals(provider: JsonRpcProvider, tokenAddress: string, options?: GetTokenDecimalsOptions): Promise<number>;
 /**
  * 计算卖出数量（支持百分比）
  */

package/dist/utils/swap-helpers.js

@@ -90,12 +90,32 @@ export async function getTokenBalance(provider, tokenAddress, walletAddress) {
     const tokenContract = new Contract(tokenAddress, ERC20_ABI, provider);
     return await tokenContract.balanceOf(walletAddress);
 }
+const tokenDecimalsCache = new Map();
 /**
- * 获取代币精度
+ * 获取代币精度。cache 按地址缓存；fallback 在 RPC 失败时使用（不抛）。
  */
-export async function getTokenDecimals(provider, tokenAddress) {
-    const tokenContract = new Contract(tokenAddress, ERC20_ABI, provider);
-    return await tokenContract.decimals();
+export async function getTokenDecimals(provider, tokenAddress, options) {
+    const key = tokenAddress.toLowerCase();
+    if (options?.cache) {
+        const cached = tokenDecimalsCache.get(key);
+        if (cached !== undefined)
+            return cached;
+    }
+    try {
+        const tokenContract = new Contract(tokenAddress, ERC20_ABI, provider);
+        const value = Number(await tokenContract.decimals());
+        if (options?.cache)
+            tokenDecimalsCache.set(key, value);
+        return value;
+    }
+    catch (error) {
+        if (options?.fallback !== undefined) {
+            if (options.cache)
+                tokenDecimalsCache.set(key, options.fallback);
+            return options.fallback;
+        }
+        throw error;
+    }
 }
 /**
  * 计算卖出数量（支持百分比）

package/dist/utils/wallet.js

@@ -116,8 +116,8 @@ async function _queryMultiTokenBalancesSingle(provider, multicallAddress, tokenA
     // ✅ 单次 multicall 获取所有数据
     const callData = multiIface.encodeFunctionData('aggregate', [calls]);
     const result = await provider.call({ to: multicallAddress, data: callData });
-    const decoded = multiIface.decodeFunctionResult('aggregate', result);
-    const returnData = decoded[1];
+    const aggregateDecoded = multiIface.decodeFunctionResult('aggregate', result);
+    const returnData = aggregateDecoded[1];
     // ✅ 并行解码结果
     const outputs = holders.map((addr) => ({
         address: addr,
@@ -129,8 +129,8 @@ async function _queryMultiTokenBalancesSingle(provider, multicallAddress, tokenA
     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]);
+            const nativeDecoded = multiIface.decodeFunctionResult('getEthBalance', returnData[idx]);
+            outputs[i].native = formatEther(nativeDecoded[0]);
         }
         catch {
             outputs[i].native = '0';
@@ -142,13 +142,13 @@ async function _queryMultiTokenBalancesSingle(provider, multicallAddress, tokenA
     for (const token of tokenAddresses) {
         for (let i = 0; i < holders.length; i++, idx++) {
             try {
-                const decoded = erc20Iface.decodeFunctionResult('balanceOf', returnData[idx]);
+                const tokenBalanceDecoded = erc20Iface.decodeFunctionResult('balanceOf', returnData[idx]);
                 let balanceMap = rawBalances.get(i);
                 if (!balanceMap) {
                     balanceMap = new Map();
                     rawBalances.set(i, balanceMap);
                 }
-                balanceMap.set(token, decoded[0]);
+                balanceMap.set(token, tokenBalanceDecoded[0]);
             }
             catch {
                 let balanceMap = rawBalances.get(i);
@@ -165,8 +165,8 @@ async function _queryMultiTokenBalancesSingle(provider, multicallAddress, tokenA
     const tokenDecimals = new Map();
     for (const token of tokenAddresses) {
         try {
-            const decoded = erc20Iface.decodeFunctionResult('decimals', returnData[idx]);
-            tokenDecimals.set(token, Number(decoded[0]));
+            const decimalsDecoded = erc20Iface.decodeFunctionResult('decimals', returnData[idx]);
+            tokenDecimals.set(token, Number(decimalsDecoded[0]));
         }
         catch {
             tokenDecimals.set(token, 18);
@@ -216,12 +216,12 @@ async function _querySingleTokenBalancesSingle(provider, multicallAddress, token
     }));
     const callData = multiIface.encodeFunctionData('aggregate', [calls]);
     const result = await provider.call({ to: multicallAddress, data: callData });
-    const decoded = multiIface.decodeFunctionResult('aggregate', result);
-    const returnData = decoded[1];
+    const aggregateDecoded = multiIface.decodeFunctionResult('aggregate', result);
+    const returnData = aggregateDecoded[1];
     return holders.map((addr, i) => {
         try {
-            const decoded = erc20Iface.decodeFunctionResult('balanceOf', returnData[i]);
-            return { address: addr, balance: decoded[0], success: true };
+            const tokenBalanceDecoded = erc20Iface.decodeFunctionResult('balanceOf', returnData[i]);
+            return { address: addr, balance: tokenBalanceDecoded[0], success: true };
         }
         catch {
             return { address: addr, balance: 0n, success: false };

package/package.json

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