four-flap-meme-sdk 2.2.18 → 2.2.20

package/dist/shared/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/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/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/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/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/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/constants/index.d.ts

@@ -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 '../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/constants/index.js

@@ -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/shared/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/shared/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/shared/flap/abi.js

@@ -9,5 +9,5 @@ export const PORTAL_EVENTS_ABI = [
     'event FlapTokenTaxSet(address token, uint256 tax)',
     'event FlapTokenCirculatingSupplyChanged(address token, uint256 newSupply)',
     'event LaunchedToDEX(address token, address pool, uint256 amount, uint256 eth)',
-    'event TokenExtensionEnabled(address token, bytes32 extensionID, address extensionAddress, uint8 version)'
+    'event TokenExtensionEnabled(address token, bytes32 extensionID, address extensionAddress, uint8 version)',
 ];

package/dist/shared/flap/constants.d.ts

@@ -31,7 +31,6 @@ export declare const FLAP_TOKEN_IMPL_ADDRESSES: {
     readonly BSC_V3_PERMIT: "0x88881b6f03090462a969eC7f48385744Eeb63333";
     readonly BSC_TAXED: "0x29e6383F0ce68507b5A72a53c2B118a118332aA8";
     readonly BSC_TAXED_V5: "0xae562c6A05b798499507c6276C6Ed796027807BA";
-    readonly BSC_TAXED_V3: "0x024f18294970B5c76c0691b87f138A0317156422";
     readonly BASE: "0xF3c514E04f83166E80718f29f0d34F206be40A0A";
     readonly XLAYER: "0x12Dc83157Bf1cfCB8Db5952b3ba5bb56Cc38f8C9";
     readonly MORPH: "0x8b4329947e34b6d56d71a3385cac122bade7d78d";
@@ -128,4 +127,4 @@ export declare const FLAP_TOTAL_SUPPLY: bigint;
  * 零地址（用于表示原生代币）
  * ✅ 从公共模块重新导出
  */
-export { ZERO_ADDRESS } from '../../utils/constants.js';
+export { ZERO_ADDRESS } from '../constants/index.js';

package/dist/shared/flap/constants.js

@@ -32,8 +32,7 @@ export const FLAP_TOKEN_IMPL_ADDRESSES = {
     /** TOKEN_V3_PERMIT / newTokenV7（Flap Portal v5.8.6+，vanity 后缀仍为 8888） */
     BSC_V3_PERMIT: '0x88881b6f03090462a969eC7f48385744Eeb63333',
     BSC_TAXED: '0x29e6383F0ce68507b5A72a53c2B118a118332aA8', // V2: 只有运营钱包的税代币
-    BSC_TAXED_V5: '0xae562c6A05b798499507c6276C6Ed796027807BA', // Legacy V5 impl（已由 V3 取代）
-    BSC_TAXED_V3: '0x024f18294970B5c76c0691b87f138A0317156422', // V3: VaultPortal.newTokenV6WithVault / Portal.newTokenV6 税币
+    BSC_TAXED_V5: '0xae562c6A05b798499507c6276C6Ed796027807BA', // V5: 高级税代币 (mkt/deflation/dividend/lp)
     BASE: '0xF3c514E04f83166E80718f29f0d34F206be40A0A',
     XLAYER: '0x12Dc83157Bf1cfCB8Db5952b3ba5bb56Cc38f8C9',
     MORPH: '0x8b4329947e34b6d56d71a3385cac122bade7d78d', // 暂时使用 BSC NORMAL 地址
@@ -138,9 +137,9 @@ export const FLAP_DEX_THRESHOLDS = {
 /**
  * 代币总供应量（固定为 10 亿）
  */
-export const FLAP_TOTAL_SUPPLY = BigInt(1000000000) * BigInt(10 ** 18);
+export const FLAP_TOTAL_SUPPLY = BigInt(1_000_000_000) * BigInt(10 ** 18);
 /**
  * 零地址（用于表示原生代币）
  * ✅ 从公共模块重新导出
  */
-export { ZERO_ADDRESS } from '../../utils/constants.js';
+export { ZERO_ADDRESS } from '../constants/index.js';

package/dist/shared/flap/curve.js

@@ -10,6 +10,9 @@ import { FixedNumber } from 'ethers';
  */
 const BILLION = FixedNumber.fromString('1000000000');
 export class CDPV2 {
+    r;
+    h;
+    k;
     static defaultDexSupplyThreshold() {
         return FixedNumber.fromString('800000000');
     }

package/dist/shared/flap/errors.d.ts

@@ -1,6 +1,3 @@
-/**
- * Flap Protocol 错误代码
- */
 export type FlapErrorCode = 'TOKEN_ALREADY_EXISTS' | 'TOKEN_NOT_FOUND' | 'TOKEN_NOT_TRADABLE' | 'ALREADY_ON_DEX' | 'INSUFFICIENT_BALANCE' | 'SLIPPAGE_EXCEEDED' | 'INVALID_TOKEN' | 'INVALID_QUOTE_TOKEN' | 'INVALID_AMOUNT' | 'TAX_RATE_TOO_HIGH' | 'PERMIT_EXPIRED' | 'PERMIT_INVALID' | 'UNKNOWN_ERROR';
 /**
  * 解析 Flap Protocol 错误信息
@@ -20,7 +17,7 @@ export type FlapErrorCode = 'TOKEN_ALREADY_EXISTS' | 'TOKEN_NOT_FOUND' | 'TOKEN_
  * }
  * ```
  */
-export declare function parseFlapError(error: any): FlapErrorCode | null;
+export declare function parseFlapError(error: unknown): FlapErrorCode | null;
 /**
  * 获取错误的友好提示信息（中文）
  *

package/dist/shared/flap/errors.js

@@ -1,3 +1,7 @@
+/**
+ * Flap Protocol 错误代码
+ */
+import { getErrorMessageFromUnknown } from '../foundation/normalize-unknown.js';
 /**
  * 解析 Flap Protocol 错误信息
  *
@@ -17,7 +21,7 @@
  * ```
  */
 export function parseFlapError(error) {
-    const msg = error?.message || error?.data?.message || String(error);
+    const msg = getFlapErrorText(error);
     const msgLower = msg.toLowerCase();
     // Token 状态相关错误
     if (msgLower.includes('token already exists') || msgLower.includes('already created')) {
@@ -60,6 +64,21 @@ export function parseFlapError(error) {
     // 无法识别的错误
     return null;
 }
+function getFlapErrorText(error) {
+    if (error !== null && typeof error === 'object') {
+        const record = error;
+        const topLevel = record.message;
+        if (typeof topLevel === 'string' && topLevel)
+            return topLevel;
+        const data = record.data;
+        if (data !== null && typeof data === 'object') {
+            const nestedMessage = data.message;
+            if (typeof nestedMessage === 'string' && nestedMessage)
+                return nestedMessage;
+        }
+    }
+    return getErrorMessageFromUnknown(error);
+}
 /**
  * 获取错误的友好提示信息（中文）
  *

package/dist/shared/flap/index.d.ts

@@ -11,14 +11,13 @@ type PortalConfig, type TokenStateV2, type TokenStateV3, type TokenStateV4, type
 export { CDPV2 } from './curve.js';
 export { buildPermitPiggybackAuto } from './permit.js';
 export { uploadTokenMeta, type TokenMetaInput } from './ipfs.js';
-export { PinataClient, type PinataConfig, pinFileToIPFSWithJWT, pinImageByPath, pinFileToIPFSWithJWTWeb, pinDataURLWithJWTWeb, dataURLToBlob, type PinataPinResp } from './pinata.js';
+export { PinataClient, type PinataConfig, pinFileToIPFSWithJWT, pinImageByPath, pinFileToIPFSWithJWTWeb, pinDataURLWithJWTWeb, dataURLToBlob, type PinataPinResp, } from './pinata.js';
 export { predictVanityTokenAddressByChain, findSaltEndingByChain } from './vanity.js';
-export { buildNewTokenV6Params, normalizeTaxV2Fields, resolveDividendTokenForQuote, NEW_TOKEN_V6_ABI, getTaxV3LaunchVanityOptions, getV3PermitLaunchVanityOptions, } from './launch-v6.js';
-export { populateCreateTokenTransaction, normalizeTaxLaunchConfig, resolveCreateTokenLaunchFlags, MAGIC_DIVIDEND_SELF, type PopulateCreateTokenParams, type NormalizedTaxLaunchConfig, } from './portal-create-token.js';
+export { MAGIC_DIVIDEND_SELF, normalizeTaxLaunchConfig, populateCreateTokenTransaction, type NormalizedTaxLaunchConfig, } from './portal-create-token.js';
 export { getFlapMetaByAddress, getFlapMetasByAddresses } from './meta.js';
 export { parseFlapError, getFlapErrorMessage, getFlapErrorMessageEn, type FlapErrorCode } from './errors.js';
-export { FLAP_DEFAULT_FEE_RATES, FLAP_IPFS_API_URL, FLAP_VANITY_SUFFIX, FLAP_DEX_THRESHOLDS, FLAP_TOTAL_SUPPLY, ZERO_ADDRESS, CHAIN_TAX_SUPPORT, getVanitySuffix, isChainSupportTax, FLAP_PORTAL_ADDRESSES } from './constants.js';
+export { FLAP_DEFAULT_FEE_RATES, FLAP_IPFS_API_URL, FLAP_VANITY_SUFFIX, FLAP_DEX_THRESHOLDS, FLAP_TOTAL_SUPPLY, ZERO_ADDRESS, CHAIN_TAX_SUPPORT, getVanitySuffix, isChainSupportTax, FLAP_PORTAL_ADDRESSES, } from './constants.js';
 export * from './abi.js';
 export { createTokenWithBundleBuy, batchBuyWithBundle, batchSellWithBundle, type FlapBundleConfig, type FlapChainForBundle, type FlapCreateWithBundleBuyParams, type FlapCreateWithBundleBuyResult, type FlapBatchBuyParams, type FlapBatchBuyResult, type FlapBatchSellParams, type FlapBatchSellResult, flapPrivateBuy, flapPrivateSell, flapBatchPrivateBuy, flapBatchPrivateSell, type FlapPrivateBuyParams, type FlapPrivateSellParams, type FlapBatchPrivateBuyParams, type FlapBatchPrivateSellParams, type FlapBatchPrivateSellResult, } from './portal-bundle.js';
 export * from './portal-bundle-merkle/index.js';
-export { NONE_EXTENSION_ID, VAULT_TYPE_LABELS, VAULT_TYPE_CATEGORIES, VAULT_FACTORY_ADDRESSES, VAULT_PORTAL_ADDRESSES, VAULT_PORTAL_ABI, VAULT_EXTRA_CONFIG, FLAP_GUARDIAN_ADDRESSES, VAULT_FACTORY_ABI, VAULT_FACTORY_V2_ABI, VAULT_BASE_ABI, VAULT_BASE_V2_ABI, type VaultType, type TaxVaultConfig, type VaultInfo, type FieldDescriptor, type VaultDataSchema, type ApproveAction, type VaultMethodSchema, type VaultUISchema, encodeVaultData, buildVaultParams, buildVaultExtensionParams, buildNewTokenV6WithVaultParams, getVaultLaunchVanityOptions, TOKEN_TAXED_V3_VERSION, getVaultFactoryAddress, getVaultPortalAddress, queryVaultDataSchema, queryVaultUISchema, queryVaultDescription, validateVaultFactory, getVaultInfo, isValidContract, } from './vault.js';
+export { NONE_EXTENSION_ID, VAULT_TYPE_LABELS, VAULT_TYPE_CATEGORIES, VAULT_FACTORY_ADDRESSES, VAULT_PORTAL_ADDRESSES, VAULT_PORTAL_ABI, VAULT_EXTRA_CONFIG, FLAP_GUARDIAN_ADDRESSES, VAULT_FACTORY_ABI, VAULT_FACTORY_V2_ABI, VAULT_BASE_ABI, VAULT_BASE_V2_ABI, type VaultType, type TaxVaultConfig, type VaultInfo, type FieldDescriptor, type VaultDataSchema, type ApproveAction, type VaultMethodSchema, type VaultUISchema, encodeVaultData, buildVaultParams, buildVaultExtensionParams, getVaultFactoryAddress, getVaultPortalAddress, queryVaultDataSchema, queryVaultUISchema, queryVaultDescription, validateVaultFactory, getVaultInfo, isValidContract, } from './vault.js';

package/dist/shared/flap/index.js

@@ -11,13 +11,12 @@ export { FlapPortal, FlapPortalWriter, validateTaxDistribution, TokenStatus, Tok
 export { CDPV2 } from './curve.js';
 export { buildPermitPiggybackAuto } from './permit.js';
 export { uploadTokenMeta } from './ipfs.js';
-export { PinataClient, pinFileToIPFSWithJWT, pinImageByPath, pinFileToIPFSWithJWTWeb, pinDataURLWithJWTWeb, dataURLToBlob } from './pinata.js';
+export { PinataClient, pinFileToIPFSWithJWT, pinImageByPath, pinFileToIPFSWithJWTWeb, pinDataURLWithJWTWeb, dataURLToBlob, } from './pinata.js';
 export { predictVanityTokenAddressByChain, findSaltEndingByChain } from './vanity.js';
-export { buildNewTokenV6Params, normalizeTaxV2Fields, resolveDividendTokenForQuote, NEW_TOKEN_V6_ABI, getTaxV3LaunchVanityOptions, getV3PermitLaunchVanityOptions, } from './launch-v6.js';
-export { populateCreateTokenTransaction, normalizeTaxLaunchConfig, resolveCreateTokenLaunchFlags, MAGIC_DIVIDEND_SELF, } from './portal-create-token.js';
+export { MAGIC_DIVIDEND_SELF, normalizeTaxLaunchConfig, populateCreateTokenTransaction, } from './portal-create-token.js';
 export { getFlapMetaByAddress, getFlapMetasByAddresses } from './meta.js';
 export { parseFlapError, getFlapErrorMessage, getFlapErrorMessageEn } from './errors.js';
-export { FLAP_DEFAULT_FEE_RATES, FLAP_IPFS_API_URL, FLAP_VANITY_SUFFIX, FLAP_DEX_THRESHOLDS, FLAP_TOTAL_SUPPLY, ZERO_ADDRESS, CHAIN_TAX_SUPPORT, getVanitySuffix, isChainSupportTax, FLAP_PORTAL_ADDRESSES } from './constants.js';
+export { FLAP_DEFAULT_FEE_RATES, FLAP_IPFS_API_URL, FLAP_VANITY_SUFFIX, FLAP_DEX_THRESHOLDS, FLAP_TOTAL_SUPPLY, ZERO_ADDRESS, CHAIN_TAX_SUPPORT, getVanitySuffix, isChainSupportTax, FLAP_PORTAL_ADDRESSES, } from './constants.js';
 export * from './abi.js';
 // Bundle 功能
 export { createTokenWithBundleBuy, batchBuyWithBundle, batchSellWithBundle, flapPrivateBuy, flapPrivateSell, flapBatchPrivateBuy, flapBatchPrivateSell, } from './portal-bundle.js';
@@ -30,6 +29,6 @@ NONE_EXTENSION_ID, VAULT_TYPE_LABELS, VAULT_TYPE_CATEGORIES, VAULT_FACTORY_ADDRE
 // ABI
 VAULT_FACTORY_ABI, VAULT_FACTORY_V2_ABI, VAULT_BASE_ABI, VAULT_BASE_V2_ABI, 
 // 工具函数
-encodeVaultData, buildVaultParams, buildVaultExtensionParams, buildNewTokenV6WithVaultParams, getVaultLaunchVanityOptions, TOKEN_TAXED_V3_VERSION, getVaultFactoryAddress, getVaultPortalAddress, 
+encodeVaultData, buildVaultParams, buildVaultExtensionParams, getVaultFactoryAddress, getVaultPortalAddress, 
 // 链上查询
 queryVaultDataSchema, queryVaultUISchema, queryVaultDescription, validateVaultFactory, getVaultInfo, isValidContract, } from './vault.js';

package/dist/shared/flap/launch-v6.d.ts

@@ -58,11 +58,6 @@ export type BuildNewTokenV6FromTaxV2Input = {
 };
 /** Portal.newTokenV6 ABI（ethers 简写格式，供 Contract 使用） */
 export declare const NEW_TOKEN_V6_ABI = "function newTokenV6((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData,bytes32 extensionID,bytes extensionData,uint8 dexId,uint8 lpFeeProfile,uint16 buyTaxRate,uint16 sellTaxRate,uint64 taxDuration,uint64 antiFarmerDuration,uint16 mktBps,uint16 deflationBps,uint16 dividendBps,uint16 lpBps,uint256 minimumShareBalance,address dividendToken,address commissionReceiver,uint8 tokenVersion)) external payable returns (address)";
-/**
- * Portal 要求：quoteToken 为 ERC20 时 dividendToken 不能为 0。
- * 未显式传入时默认与 quoteToken 相同（分红币种 = 报价币）。
- */
-export declare function resolveDividendTokenForQuote(quoteToken?: string, dividendToken?: string): string;
 export declare function normalizeTaxV2Fields(taxV2: TaxV2Config): (TaxV2Config & {
     mktBps: number;
     deflationBps: number;

package/dist/shared/flap/launch-v6.js

@@ -7,20 +7,6 @@ import { TokenVersion } from './portal.js';
 const NONE_EXTENSION_ID = '0x' + '00'.repeat(32);
 /** Portal.newTokenV6 ABI（ethers 简写格式，供 Contract 使用） */
 export const NEW_TOKEN_V6_ABI = 'function newTokenV6((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData,bytes32 extensionID,bytes extensionData,uint8 dexId,uint8 lpFeeProfile,uint16 buyTaxRate,uint16 sellTaxRate,uint64 taxDuration,uint64 antiFarmerDuration,uint16 mktBps,uint16 deflationBps,uint16 dividendBps,uint16 lpBps,uint256 minimumShareBalance,address dividendToken,address commissionReceiver,uint8 tokenVersion)) external payable returns (address)';
-/**
- * Portal 要求：quoteToken 为 ERC20 时 dividendToken 不能为 0。
- * 未显式传入时默认与 quoteToken 相同（分红币种 = 报价币）。
- */
-export function resolveDividendTokenForQuote(quoteToken, dividendToken) {
-    if (dividendToken && dividendToken !== ZeroAddress) {
-        return dividendToken;
-    }
-    const qt = quoteToken || ZeroAddress;
-    if (qt === ZeroAddress) {
-        return ZeroAddress;
-    }
-    return qt;
-}
 export function normalizeTaxV2Fields(taxV2) {
     if ('distribution' in taxV2) {
         return {
@@ -77,7 +63,7 @@ export function buildNewTokenV6Params(input) {
             dividendBps: tv2.dividendBps & 0xffff,
             lpBps: tv2.lpBps & 0xffff,
             minimumShareBalance: BigInt(tv2.minimumShareBalance ?? 10000) * (10n ** 18n),
-            dividendToken: resolveDividendTokenForQuote(input.quoteToken, input.dividendToken),
+            dividendToken: input.dividendToken ?? ZeroAddress,
             commissionReceiver: input.commissionReceiver ?? ZeroAddress,
             tokenVersion: TokenVersion.TOKEN_TAXED_V3,
         };
@@ -108,7 +94,7 @@ export function buildNewTokenV6Params(input) {
         dividendBps: (p.dividendBps ?? 0) & 0xffff,
         lpBps: (p.lpBps ?? 0) & 0xffff,
         minimumShareBalance: p.minimumShareBalance ?? 0n,
-        dividendToken: resolveDividendTokenForQuote(p.quoteToken, p.dividendToken),
+        dividendToken: p.dividendToken ?? ZeroAddress,
         commissionReceiver: isStandard ? ZeroAddress : (p.commissionReceiver ?? ZeroAddress),
         tokenVersion: p.tokenVersion ?? TokenVersion.TOKEN_V2_PERMIT,
     };

package/dist/shared/flap/meta.d.ts

@@ -1,5 +1,24 @@
 import { JsonRpcProvider } from 'ethers';
 export type FlapChain = 'BSC' | 'BASE' | 'XLAYER' | 'MORPH';
+/** JSON 可序列化值（递归） */
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/** IPFS 元数据 JSON（字段因项目而异） */
+export type FlapTokenMetaJson = {
+    [key: string]: JsonValue;
+};
+export type FlapMetaByAddressResult = {
+    cid: string;
+    data?: FlapTokenMetaJson;
+};
+export type FlapMetaByTokenResult = {
+    token: string;
+    cid?: string;
+    data?: FlapTokenMetaJson;
+    imageUrl?: string;
+    error?: string;
+};
 export type FetchMetaOptions = {
     ipfsGateway?: string;
     multicall3?: string;
@@ -7,24 +26,9 @@ export type FetchMetaOptions = {
 /**
  * 根据代币地址直接读取合约 metaURI()/meta()（IPFS CID），并拉取元数据 JSON。
  */
-export declare function getFlapMetaByAddress(chain: FlapChain, rpcUrl: string, tokenAddress: string, opts?: FetchMetaOptions): Promise<{
-    cid: string;
-    data?: any;
-} | undefined>;
-export declare function getFlapMetasByAddresses(chain: FlapChain, rpcUrl: string, tokenAddresses: string[], opts?: FetchMetaOptions): Promise<Array<{
-    token: string;
-    cid?: string;
-    data?: any;
-    imageUrl?: string;
-    error?: string;
-}>>;
+export declare function getFlapMetaByAddress(chain: FlapChain, rpcUrl: string, tokenAddress: string, opts?: FetchMetaOptions): Promise<FlapMetaByAddressResult | undefined>;
+export declare function getFlapMetasByAddresses(chain: FlapChain, rpcUrl: string, tokenAddresses: string[], opts?: FetchMetaOptions): Promise<FlapMetaByTokenResult[]>;
 /**
  * 使用 Multicall3 批量读取 metaURI()/meta()，metaURI 优先、meta 兜底。
  */
-export declare function getFlapMetaUrisWithMulticall(provider: JsonRpcProvider, chain: FlapChain, tokenAddresses: string[], multicall3?: string, ipfsGateway?: string): Promise<Array<{
-    token: string;
-    cid?: string;
-    data?: any;
-    imageUrl?: string;
-    error?: string;
-}>>;
+export declare function getFlapMetaUrisWithMulticall(provider: JsonRpcProvider, chain: FlapChain, tokenAddresses: string[], multicall3?: string, ipfsGateway?: string): Promise<FlapMetaByTokenResult[]>;