four-flap-meme-sdk 2.2.19 → 3.0.0

package/dist/{shared → core}/constants/addresses.d.ts

@@ -4,6 +4,8 @@
  */
 /** 零地址 */
 export declare const ZERO_ADDRESS: "0x0000000000000000000000000000000000000000";
+/** 32 字节零哈希（bytes32 零值） */
+export declare const ZERO_BYTES32: "0x0000000000000000000000000000000000000000000000000000000000000000";
 /** BlockRazor Builder EOA 地址（用于 BSC 链贿赂） */
 export declare const BLOCKRAZOR_BUILDER_EOA: "0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20";
 export declare const ADDRESSES: {
@@ -46,12 +48,22 @@ export declare const ADDRESSES: {
         readonly FlapTokenImpl: "0x12Dc83157Bf1cfCB8Db5952b3ba5bb56Cc38f8C9";
         /** V2 Router (标准 Uniswap V2 风格) */
         readonly PotatoSwapV2Router: "0x881fb2f98c13d521009464e7d1cbf16e1b394e8e";
+        /** V2 Factory */
+        readonly PotatoSwapV2Factory: "0x630DB8E822805c82Ca40a54daE02dd5aC31f7fcF";
         /** SwapRouter02 (V3 风格) */
         readonly PotatoSwapSwapRouter02: "0xB45D0149249488333E3F3f9F359807F4b810C1FC";
         /** V3 Router */
         readonly PotatoSwapV3Router: "0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41";
         /** V3 Factory */
         readonly PotatoSwapV3Factory: "0xa1415fAe79c4B196d087F02b8aD5a622B8A827E5";
+        /** QuoterV2 */
+        readonly PotatoSwapQuoterV2: "0x5A6f3723346aF54a4D0693bfC1718D64d4915C3e";
+        /** DYORSwap V2 Factory */
+        readonly DyorSwapV2Factory: "0x2CcaDb1e437AA9cDc741574bDa154686B1F04C09";
+        /** DYORSwap Router */
+        readonly DyorSwapRouter: "0xfb001fbbace32f09cb6d3c449b935183de53ee96";
+        /** DYORSwap ETHBack Dividend 合约（refundETH 固定地址） */
+        readonly DyorSwapEthBackDividend: "0x2e61b0b4410f6fb941d47205191cbb8963d44bcc";
         /** EntryPoint v0.6 合约地址 */
         readonly EntryPointV06: "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789";
         /** SimpleAccountFactory 合约地址 */
@@ -66,6 +78,16 @@ export declare const ADDRESSES: {
         readonly TaxTokenImplementation: "0x1C8847736521f5cD725dFB8f33c7c610826e7C42";
         readonly TaxTokenSplitterImplementation: "0x57Fed6832F12150a77D5952b49190d9447aCB5ee";
         readonly PancakeProxy: "0x20B89e7e088db3e06e0893Ce23162E475b9d8c7c";
+        readonly USDC: "0x754704bc059f8c67012fed69bc8a327a5aafb603";
+        readonly PancakeV2Factory: "0x44c90b66eb4c4f814cea6aaf2ac71ca88fa77308";
+        readonly PancakeV3Factory: "0x40ce898c43df68c8c4229cd5ce21d3ce1f3ddcf1";
+        readonly UniswapV2Factory: "0x182a927119d56008d921126764bf884221b10f59";
+        readonly UniswapV3Factory: "0x204faca1764b154221e35c0d20abb3c525710498";
+        readonly UniswapV2Router: "0x4b2ab38dbf28d31d467aa8993f6c2585981d6804";
+        readonly UniswapV3Router: "0xd6145b2d3f379919e8cdeda7b97e37c4b2ca9c40";
+        readonly UniswapV3Quoter: "0x661e93cca42afacb172121ef892830ca3b70f08d";
+        readonly PancakeV2Router: "0xb1bc24c34e88f7d43d5923034e3a14b24daacff9";
+        readonly PancakeV3Router: "0x1b81d678ffb9c0263b24a97847620c99d213eb14";
         readonly Multicall3: "0xca11bde05977b3631167028862be2a173976ca11";
     };
     readonly BASE: {
@@ -78,6 +100,10 @@ export declare const ADDRESSES: {
         readonly UniswapV3Factory: "0x33128a8fC17869897dcE68Ed026d694621f6FDfD";
         /** Uniswap V3 QuoterV2 */
         readonly UniswapV3Quoter: "0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a";
+        /** PancakeSwap V2 Router */
+        readonly PancakeV2Router: "0x8cFe327CEc66d1C090Dd72bd0FF11d690C33a2Eb";
+        /** PancakeSwap V3 Router */
+        readonly PancakeV3Router: "0x678Aa4bF4E210cf2166753e054d5b7c31cc7fa86";
         readonly Multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11";
     };
     readonly ARBITRUM_ONE: {
@@ -127,7 +153,7 @@ export declare const ENI_SPENDERS: {
  */
 export declare function getEniSpenders(mode?: boolean | 'all'): string[];
 export type ChainAddresses = keyof typeof ADDRESSES;
-export type AddressKey<C extends ChainAddresses> = keyof typeof ADDRESSES[C];
+export type AddressKey<C extends ChainAddresses> = keyof (typeof ADDRESSES)[C];
 /**
  * 获取指定链的合约地址
  */

package/dist/{shared → core}/constants/addresses.js

@@ -7,6 +7,8 @@
 // ============================================================================
 /** 零地址 */
 export const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+/** 32 字节零哈希（bytes32 零值） */
+export const ZERO_BYTES32 = '0x0000000000000000000000000000000000000000000000000000000000000000';
 /** BlockRazor Builder EOA 地址（用于 BSC 链贿赂） */
 export const BLOCKRAZOR_BUILDER_EOA = '0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20';
 // ============================================================================
@@ -71,12 +73,22 @@ export const ADDRESSES = {
         // ---------- PotatoSwap DEX 合约 ----------
         /** V2 Router (标准 Uniswap V2 风格) */
         PotatoSwapV2Router: '0x881fb2f98c13d521009464e7d1cbf16e1b394e8e',
+        /** V2 Factory */
+        PotatoSwapV2Factory: '0x630DB8E822805c82Ca40a54daE02dd5aC31f7fcF',
         /** SwapRouter02 (V3 风格) */
         PotatoSwapSwapRouter02: '0xB45D0149249488333E3F3f9F359807F4b810C1FC',
         /** V3 Router */
         PotatoSwapV3Router: '0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41',
         /** V3 Factory */
         PotatoSwapV3Factory: '0xa1415fAe79c4B196d087F02b8aD5a622B8A827E5',
+        /** QuoterV2 */
+        PotatoSwapQuoterV2: '0x5A6f3723346aF54a4D0693bfC1718D64d4915C3e',
+        /** DYORSwap V2 Factory */
+        DyorSwapV2Factory: '0x2CcaDb1e437AA9cDc741574bDa154686B1F04C09',
+        /** DYORSwap Router */
+        DyorSwapRouter: '0xfb001fbbace32f09cb6d3c449b935183de53ee96',
+        /** DYORSwap ETHBack Dividend 合约（refundETH 固定地址） */
+        DyorSwapEthBackDividend: '0x2e61b0b4410f6fb941d47205191cbb8963d44bcc',
         // ---------- ERC-4337 合约 ----------
         /** EntryPoint v0.6 合约地址 */
         EntryPointV06: '0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789',
@@ -99,6 +111,18 @@ export const ADDRESSES = {
         TaxTokenSplitterImplementation: '0x57Fed6832F12150a77D5952b49190d9447aCB5ee',
         // ---------- PancakeSwap Proxy ----------
         PancakeProxy: '0x20B89e7e088db3e06e0893Ce23162E475b9d8c7c',
+        // ---------- 稳定币 ----------
+        USDC: '0x754704bc059f8c67012fed69bc8a327a5aafb603',
+        // ---------- DEX ----------
+        PancakeV2Factory: '0x44c90b66eb4c4f814cea6aaf2ac71ca88fa77308',
+        PancakeV3Factory: '0x40ce898c43df68c8c4229cd5ce21d3ce1f3ddcf1',
+        UniswapV2Factory: '0x182a927119d56008d921126764bf884221b10f59',
+        UniswapV3Factory: '0x204faca1764b154221e35c0d20abb3c525710498',
+        UniswapV2Router: '0x4b2ab38dbf28d31d467aa8993f6c2585981d6804',
+        UniswapV3Router: '0xd6145b2d3f379919e8cdeda7b97e37c4b2ca9c40',
+        UniswapV3Quoter: '0x661e93cca42afacb172121ef892830ca3b70f08d',
+        PancakeV2Router: '0xb1bc24c34e88f7d43d5923034e3a14b24daacff9',
+        PancakeV3Router: '0x1b81d678ffb9c0263b24a97847620c99d213eb14',
         // ---------- 通用合约 ----------
         Multicall3: '0xca11bde05977b3631167028862be2a173976ca11',
     },
@@ -118,6 +142,10 @@ export const ADDRESSES = {
         UniswapV3Factory: '0x33128a8fC17869897dcE68Ed026d694621f6FDfD',
         /** Uniswap V3 QuoterV2 */
         UniswapV3Quoter: '0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a',
+        /** PancakeSwap V2 Router */
+        PancakeV2Router: '0x8cFe327CEc66d1C090Dd72bd0FF11d690C33a2Eb',
+        /** PancakeSwap V3 Router */
+        PancakeV3Router: '0x678Aa4bF4E210cf2166753e054d5b7c31cc7fa86',
         // ---------- 通用合约 ----------
         Multicall3: '0xcA11bde05977b3631167028862bE2a173976CA11',
     },
@@ -192,12 +220,21 @@ export const ENI_SPENDERS = {
  */
 export function getEniSpenders(mode = false) {
     if (mode === 'all' && ENI_SPENDERS.BATCH_ROUTER) {
-        return [ENI_SPENDERS.DIRECT.DAOAAS_PORTAL, ENI_SPENDERS.DIRECT.DSWAP_V2_ROUTER, ENI_SPENDERS.DIRECT.IROSWAP_V2_ROUTER, ENI_SPENDERS.BATCH_ROUTER];
+        return [
+            ENI_SPENDERS.DIRECT.DAOAAS_PORTAL,
+            ENI_SPENDERS.DIRECT.DSWAP_V2_ROUTER,
+            ENI_SPENDERS.DIRECT.IROSWAP_V2_ROUTER,
+            ENI_SPENDERS.BATCH_ROUTER,
+        ];
     }
     if (mode === true && ENI_SPENDERS.BATCH_ROUTER) {
         return [ENI_SPENDERS.BATCH_ROUTER];
     }
-    return [ENI_SPENDERS.DIRECT.DAOAAS_PORTAL, ENI_SPENDERS.DIRECT.DSWAP_V2_ROUTER, ENI_SPENDERS.DIRECT.IROSWAP_V2_ROUTER];
+    return [
+        ENI_SPENDERS.DIRECT.DAOAAS_PORTAL,
+        ENI_SPENDERS.DIRECT.DSWAP_V2_ROUTER,
+        ENI_SPENDERS.DIRECT.IROSWAP_V2_ROUTER,
+    ];
 }
 // ============================================================================
 // 工具函数

package/dist/{shared → core}/constants/chains.d.ts

@@ -107,7 +107,7 @@ export declare const CHAINS: {
 };
 export declare const CHAIN_ID_MAP: Record<string, number>;
 export type ChainKey = keyof typeof CHAINS;
-export type ChainConfig = typeof CHAINS[ChainKey];
+export type ChainConfig = (typeof CHAINS)[ChainKey];
 /**
  * 根据 chainId 获取链配置
  */

package/dist/{shared → core}/constants/chains.js

@@ -132,7 +132,7 @@ export const CHAIN_ID_MAP = {
  * 根据 chainId 获取链配置
  */
 export function getChainById(chainId) {
-    return Object.values(CHAINS).find(c => c.chainId === chainId);
+    return Object.values(CHAINS).find((c) => c.chainId === chainId);
 }
 /**
  * 根据 chainId 获取链名称

package/dist/{shared → core}/constants/gas.d.ts

@@ -63,7 +63,7 @@ export declare const V3_FEE_TIERS: {
     readonly HIGH: 10000;
 };
 export type GasLimitKey = keyof typeof GAS_LIMITS;
-export type V3FeeTier = typeof V3_FEE_TIERS[keyof typeof V3_FEE_TIERS];
+export type V3FeeTier = (typeof V3_FEE_TIERS)[keyof typeof V3_FEE_TIERS];
 /**
  * 根据链和交易类型计算 gas limit
  */

package/dist/{shared → core}/constants/gas.js

@@ -90,9 +90,7 @@ export function calculateGasLimit(chainId, isNative, hasHops = false, hopCount =
     }
     // 有多跳时，基础 gas + 每跳额外 gas
     if (hasHops && hopCount > 0) {
-        const hopGas = isNative
-            ? GAS_LIMITS.NATIVE_TRANSFER
-            : GAS_LIMITS.ERC20_TRANSFER;
+        const hopGas = isNative ? GAS_LIMITS.NATIVE_TRANSFER : GAS_LIMITS.ERC20_TRANSFER;
         return GAS_LIMITS.TRADE + hopGas * BigInt(hopCount);
     }
     // 普通转账
@@ -108,9 +106,7 @@ export function calculateGasLimit(chainId, isNative, hasHops = false, hopCount =
  */
 export function getTransferGasLimit(chainId, isNative) {
     if (isNative) {
-        return chainId === CHAINS.XLAYER.chainId
-            ? GAS_LIMITS.XLAYER_NATIVE_TRANSFER
-            : GAS_LIMITS.NATIVE_TRANSFER;
+        return chainId === CHAINS.XLAYER.chainId ? GAS_LIMITS.XLAYER_NATIVE_TRANSFER : GAS_LIMITS.NATIVE_TRANSFER;
     }
     return GAS_LIMITS.ERC20_TRANSFER;
 }

package/dist/{shared → core}/constants/index.d.ts

@@ -2,7 +2,7 @@
  * 统一常量导出
  *
  * 使用示例：
- * import { CHAINS, GAS_LIMITS, ADDRESSES, PROFIT_CONFIG } from './shared/constants';
+ * import { CHAINS, GAS_LIMITS, ADDRESSES, PROFIT_CONFIG } from '../../core/constants/shared/constants';
  *
  * const chainId = CHAINS.BSC.chainId;
  * const gasLimit = GAS_LIMITS.NATIVE_TRANSFER;
@@ -10,5 +10,8 @@
  */
 export { CHAINS, CHAIN_ID_MAP, getChainById, getChainName, getDefaultRpcUrl, isKnownChain, isBscChain, isXLayerChain, isMonadChain, isEniChain, getConfirmationTimeout, type ChainKey, type ChainConfig, } from './chains.js';
 export { GAS_LIMITS, GAS_CONFIG, V3_FEE_TIERS, calculateGasLimit, getTransferGasLimit, type GasLimitKey, type V3FeeTier, } from './gas.js';
-export { ZERO_ADDRESS, BLOCKRAZOR_BUILDER_EOA, ADDRESSES, getAddress, getWrappedNativeAddress, getMulticall3Address, getFlapPortalAddress, isZeroAddress, isNativeToken, ENI_SPENDERS, getEniSpenders, type ChainAddresses, type AddressKey, } from './addresses.js';
+export { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS, type QuoteConfigChain } from './quote.js';
+/** Flap 链标识（与 `FlapPortal` 一致，供子路径 `./constants` 使用） */
+export type { FlapChain } from '../../domains/flap/portal.js';
+export { ZERO_ADDRESS, ZERO_BYTES32, BLOCKRAZOR_BUILDER_EOA, ADDRESSES, getAddress, getWrappedNativeAddress, getMulticall3Address, getFlapPortalAddress, isZeroAddress, isNativeToken, ENI_SPENDERS, getEniSpenders, type ChainAddresses, type AddressKey, } from './addresses.js';
 export { PROFIT_CONFIG, getProfitRecipient, getAllProfitRecipients, getProfitRateBps, calculateProfitAmount, calculateProfitHopGasCost, type ProfitRateKey, TRANSFER_FEE_PER_ADDRESS, getTransferFeePerAddress, calculateTransferFee, } from './profit.js';

package/dist/{shared → core}/constants/index.js

@@ -2,7 +2,7 @@
  * 统一常量导出
  *
  * 使用示例：
- * import { CHAINS, GAS_LIMITS, ADDRESSES, PROFIT_CONFIG } from './shared/constants';
+ * import { CHAINS, GAS_LIMITS, ADDRESSES, PROFIT_CONFIG } from '../../core/constants/shared/constants';
  *
  * const chainId = CHAINS.BSC.chainId;
  * const gasLimit = GAS_LIMITS.NATIVE_TRANSFER;
@@ -16,10 +16,11 @@ export { CHAINS, CHAIN_ID_MAP, getChainById, getChainName, getDefaultRpcUrl, isK
 // Gas 常量
 // ============================================================================
 export { GAS_LIMITS, GAS_CONFIG, V3_FEE_TIERS, calculateGasLimit, getTransferGasLimit, } from './gas.js';
+export { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS } from './quote.js';
 // ============================================================================
 // 合约地址
 // ============================================================================
-export { ZERO_ADDRESS, BLOCKRAZOR_BUILDER_EOA, ADDRESSES, getAddress, getWrappedNativeAddress, getMulticall3Address, getFlapPortalAddress, isZeroAddress, isNativeToken, ENI_SPENDERS, getEniSpenders, } from './addresses.js';
+export { ZERO_ADDRESS, ZERO_BYTES32, BLOCKRAZOR_BUILDER_EOA, ADDRESSES, getAddress, getWrappedNativeAddress, getMulticall3Address, getFlapPortalAddress, isZeroAddress, isNativeToken, ENI_SPENDERS, getEniSpenders, } from './addresses.js';
 // ============================================================================
 // 利润配置
 // ============================================================================

package/dist/core/constants/quote.d.ts

@@ -0,0 +1,30 @@
+/** DEX 报价链配置（V2 Router / V3 Quoter / 包装原生币 / 稳定币） */
+export declare const QUOTE_CONFIG: {
+    readonly BSC: {
+        readonly v2Router: "0x10ED43C718714eb63d5aA57B78B54704E256024E";
+        readonly v3Quoter: "0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997";
+        readonly wrappedNative: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
+        readonly stableCoins: readonly ["0x55d398326f99059fF775485246999027B3197955", "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d", "0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56"];
+    };
+    readonly MONAD: {
+        readonly v2Router: "0xb1bc24c34e88f7d43d5923034e3a14b24daacff9";
+        readonly v3Quoter: "";
+        readonly wrappedNative: "0x3bd359c1119da7da1d913d1c4d2b7c461115433a";
+        readonly stableCoins: readonly [];
+    };
+    readonly XLAYER: {
+        readonly v2Router: "0x881fb2f98c13d521009464e7d1cbf16e1b394e8e";
+        readonly v3Quoter: "0x5A6f3723346aF54a4D0693bfC1718D64d4915C3e";
+        readonly wrappedNative: "0xe538905cf8410324e03a5a23c1c177a474d59b2b";
+        readonly stableCoins: readonly ["0x1E4a5963aBFD975d8c9021ce480b42188849D41d", "0x74b7f16337b8972027f6196a17a631ac6de26d22", "0x779ded0c9e1022225f8e0630b35a9b54be713736"];
+    };
+    readonly ENI: {
+        readonly v2Router: "0x97ed8be49d9a8b86247090aa41e908e76b8fcf22";
+        readonly v3Quoter: "";
+        readonly wrappedNative: "0x6d1e851446f4d004ae2a72f9afed85e8829a205e";
+        readonly stableCoins: readonly ["0xDC1a8A35b0BaA3229b13f348ED708a2fd50b5e3a", "0xaFF944b96c1BAEA587159ec446280E468B32ee15"];
+    };
+};
+/** V3 报价尝试费率列表（与 `gas.V3_FEE_TIERS` 命名对象区分） */
+export declare const QUOTE_V3_FEE_TIERS: readonly [100, 500, 2500, 10000];
+export type QuoteConfigChain = keyof typeof QUOTE_CONFIG;

package/dist/core/constants/quote.js

@@ -0,0 +1,37 @@
+/** DEX 报价链配置（V2 Router / V3 Quoter / 包装原生币 / 稳定币） */
+export const QUOTE_CONFIG = {
+    BSC: {
+        v2Router: '0x10ED43C718714eb63d5aA57B78B54704E256024E',
+        v3Quoter: '0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997',
+        wrappedNative: '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c',
+        stableCoins: [
+            '0x55d398326f99059fF775485246999027B3197955',
+            '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d',
+            '0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56',
+        ],
+    },
+    MONAD: {
+        v2Router: '0xb1bc24c34e88f7d43d5923034e3a14b24daacff9',
+        v3Quoter: '',
+        wrappedNative: '0x3bd359c1119da7da1d913d1c4d2b7c461115433a',
+        stableCoins: [],
+    },
+    XLAYER: {
+        v2Router: '0x881fb2f98c13d521009464e7d1cbf16e1b394e8e',
+        v3Quoter: '0x5A6f3723346aF54a4D0693bfC1718D64d4915C3e',
+        wrappedNative: '0xe538905cf8410324e03a5a23c1c177a474d59b2b',
+        stableCoins: [
+            '0x1E4a5963aBFD975d8c9021ce480b42188849D41d',
+            '0x74b7f16337b8972027f6196a17a631ac6de26d22',
+            '0x779ded0c9e1022225f8e0630b35a9b54be713736',
+        ],
+    },
+    ENI: {
+        v2Router: '0x97ed8be49d9a8b86247090aa41e908e76b8fcf22',
+        v3Quoter: '',
+        wrappedNative: '0x6d1e851446f4d004ae2a72f9afed85e8829a205e',
+        stableCoins: ['0xDC1a8A35b0BaA3229b13f348ED708a2fd50b5e3a', '0xaFF944b96c1BAEA587159ec446280E468B32ee15'],
+    },
+};
+/** V3 报价尝试费率列表（与 `gas.V3_FEE_TIERS` 命名对象区分） */
+export const QUOTE_V3_FEE_TIERS = [100, 500, 2500, 10000];

package/dist/core/dex/v3-path.d.ts

@@ -0,0 +1,6 @@
+export declare function getDeadline(minutes?: number): number;
+export declare function encodeV3Path(tokens: string[], fees: number[]): string;
+export declare function decodeV3Path(path: string): {
+    tokens: string[];
+    fees: number[];
+};

package/dist/core/dex/v3-path.js

@@ -0,0 +1,35 @@
+import { GAS_CONFIG } from '../constants/gas.js';
+export function getDeadline(minutes = GAS_CONFIG.DEFAULT_DEADLINE_MINUTES) {
+    return Math.floor(Date.now() / 1000) + 60 * minutes;
+}
+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++) {
+        path += tokens[i].slice(2).toLowerCase().padStart(40, '0');
+        if (i < fees.length) {
+            path += fees[i].toString(16).padStart(6, '0');
+        }
+    }
+    return path;
+}
+export function decodeV3Path(path) {
+    const cleanPath = path.startsWith('0x') ? path.slice(2) : path;
+    const tokens = [];
+    const fees = [];
+    let offset = 0;
+    while (offset < cleanPath.length) {
+        tokens.push('0x' + cleanPath.slice(offset, offset + 40));
+        offset += 40;
+        if (offset < cleanPath.length) {
+            fees.push(parseInt(cleanPath.slice(offset, offset + 6), 16));
+            offset += 6;
+        }
+    }
+    return { tokens, fees };
+}

package/dist/core/erc20/decimals.d.ts

@@ -0,0 +1,7 @@
+import { JsonRpcProvider } from 'ethers';
+/**
+ * 获取 ERC20 代币精度（带缓存）
+ */
+export declare function getErc20Decimals(provider: JsonRpcProvider, token: string, chainId?: number): Promise<number>;
+/** @deprecated 使用 getErc20Decimals */
+export declare const getErc20DecimalsMerkle: typeof getErc20Decimals;

package/dist/core/erc20/decimals.js

@@ -0,0 +1,24 @@
+import { ethers } from 'ethers';
+const decimalsCache = new Map();
+/**
+ * 获取 ERC20 代币精度（带缓存）
+ */
+export async function getErc20Decimals(provider, token, chainId) {
+    const resolvedChainId = chainId ?? Number((await provider.getNetwork()).chainId);
+    const key = `${resolvedChainId}_${token.toLowerCase()}`;
+    if (decimalsCache.has(key))
+        return decimalsCache.get(key);
+    try {
+        const erc20 = new ethers.Contract(token, ['function decimals() view returns (uint8)'], provider);
+        const d = await erc20.decimals();
+        if (!Number.isFinite(d) || d < 0 || d > 36)
+            return 18;
+        decimalsCache.set(key, d);
+        return d;
+    }
+    catch {
+        return 18;
+    }
+}
+/** @deprecated 使用 getErc20Decimals */
+export const getErc20DecimalsMerkle = getErc20Decimals;

package/dist/{utils → core}/erc20.d.ts

@@ -1,44 +1,31 @@
 import { JsonRpcProvider } from 'ethers';
-import { NonceManager } from './bundle-helpers.js';
-export type EnsureAllowanceResult = {
-    alreadyApproved: boolean;
-    currentAllowance: bigint;
-    requiredAllowance: bigint;
-    txReceipt?: any;
-};
-export type EnsureAllowanceBatchItemResult = EnsureAllowanceResult & {
-    owner: string;
-};
+import type { EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult } from './types-erc20.js';
+export type { EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult, } from './types-erc20.js';
+type SellApprovalChain = 'BSC' | 'BASE' | 'ARBITRUM_ONE';
 /**
  * 检查代币授权状态 - Four.meme V1（只读，不发送交易）
- * @returns 是否已授权足够的额度
  */
-export declare function checkSellApprovalV1(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, token: string, owner: string, amount: bigint): Promise<{
+export declare function checkSellApprovalV1(chain: SellApprovalChain, rpcUrl: string, token: string, owner: string, amount: bigint): Promise<{
     isApproved: boolean;
     currentAllowance: bigint;
     requiredAllowance: bigint;
 }>;
 /**
  * 确保代币已授权给 Four.meme V1 代理合约
- * 用于 Four.meme V1 代币的卖出操作
- * @returns 授权结果，包含是否已授权、当前额度、交易回执等信息
  */
-export declare function ensureSellApprovalV1(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
+export declare function ensureSellApprovalV1(chain: SellApprovalChain, rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
 /**
  * 检查代币授权状态 - Four.meme V2（只读，不发送交易）
- * @returns 是否已授权足够的额度
  */
-export declare function checkSellApprovalV2(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, token: string, owner: string, amount: bigint): Promise<{
+export declare function checkSellApprovalV2(chain: SellApprovalChain, rpcUrl: string, token: string, owner: string, amount: bigint): Promise<{
     isApproved: boolean;
     currentAllowance: bigint;
     requiredAllowance: bigint;
 }>;
 /**
  * 确保代币已授权给 Four.meme V2 代理合约
- * 用于 Four.meme V2 代币的卖出操作
- * @returns 授权结果，包含是否已授权、当前额度、交易回执等信息
  */
-export declare function ensureSellApprovalV2(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
+export declare function ensureSellApprovalV2(chain: SellApprovalChain, rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
 /**
  * 检查代币授权状态 - Four.meme（通用，默认使用 V2）
  * @deprecated 建议使用明确版本的方法：checkSellApprovalV1 或 checkSellApprovalV2
@@ -161,75 +148,6 @@ export declare function checkAllowanceBatch(chain: 'BSC' | 'BASE' | 'XLAYER' | '
  * @returns 每个地址的授权额度数组
  */
 export declare function checkAllowanceBatchRaw(rpcUrl: string, tokenAddress: string, ownerAddresses: string[], spenderAddress: string): Promise<bigint[]>;
-export type ApproveTokenBatchParams = {
-    chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD';
-    platform: 'flap' | 'four' | 'pancake-v2' | 'pancake-v3';
-    rpcUrl: string;
-    privateKeys: string[];
-    tokenAddress: string;
-    amounts: (bigint | 'max')[];
-    /** 是否只签名不提交（默认 false，直接发送交易） */
-    signOnly?: boolean;
-    /** Gas Price（可选，单位 Gwei，signOnly=true 时生效） */
-    gasPriceGwei?: number;
-    /** Gas Limit（可选，默认 100000，signOnly=true 时生效） */
-    gasLimit?: number;
-    /** 链ID（可选，默认56=BSC，signOnly=true 时生效） */
-    chainId?: number;
-    /** 跳过合约地址验证（可选，用于某些特殊场景） */
-    skipValidation?: boolean;
-};
-export type ApproveTokenBatchRawParams = {
-    rpcUrl: string;
-    privateKeys: string[];
-    tokenAddress: string;
-    spenderAddress: string;
-    amounts: (bigint | 'max')[];
-    /** 是否只签名不提交（默认 false，直接发送交易） */
-    signOnly?: boolean;
-    /** Gas Price（可选，单位 Gwei，signOnly=true 时生效） */
-    gasPriceGwei?: number;
-    /** Gas Limit（可选，默认 100000，signOnly=true 时生效） */
-    gasLimit?: number;
-    /** 链ID（可选，默认56=BSC，signOnly=true 时生效） */
-    chainId?: number;
-    /** 外部 NonceManager（可选，用于同一钱包签多笔交易时共享 nonce 状态） */
-    nonceManager?: NonceManager;
-    /** 跳过合约地址验证（可选，用于某些特殊场景，如 RPC 返回异常时） */
-    skipValidation?: boolean;
-};
-/** signOnly=false 时的返回结果（直接发送交易） */
-export type ApproveTokenBatchResult = {
-    success: boolean;
-    approvedCount: number;
-    results: Array<{
-        owner: string;
-        alreadyApproved: boolean;
-        currentAllowance: bigint;
-        requiredAllowance: bigint;
-        txHash?: string;
-        error?: string;
-    }>;
-};
-/** signOnly=true 时的返回结果（仅签名） */
-export type ApproveTokenBatchSignResult = {
-    /** 需要授权的签名交易数组（已过滤掉已授权的钱包） */
-    signedTransactions: string[];
-    /** 详细结果 */
-    results: Array<{
-        owner: string;
-        /** 是否已授权（无需发送交易） */
-        alreadyApproved: boolean;
-        currentAllowance: bigint;
-        requiredAllowance: bigint;
-        /** 签名交易（仅当 alreadyApproved=false 时有值） */
-        signedTx?: string;
-    }>;
-    /** 需要授权的钱包数量 */
-    needApproveCount: number;
-    /** 已授权的钱包数量 */
-    alreadyApprovedCount: number;
-};
 /**
  * ✅ 智能路由：批量授权 ERC20 代币（自动选择 spender，自动检查，只在不足时才发送交易）
  *