four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/domains/flap/reader.js

@@ -0,0 +1,275 @@
+/**
+ * Flap Portal — 只读查询（reader）
+ */
+import { Contract, JsonRpcProvider, formatEther, FixedNumber } from 'ethers';
+import { CDPV2 } from './curve.js';
+import { FLAP_PORTAL_ADDRESSES, FLAP_DEFAULT_FEE_RATES } from './constants.js';
+// Portal ABI (使用 ethers 标准格式)
+export const PORTAL_ABI = [
+    // Token 状态查询
+    'function getTokenV2(address token) external view returns (uint8,uint256,uint256,uint256,uint8,uint256,uint256)',
+    'function getTokenV3(address token) external view returns (uint8,uint256,uint256,uint256,uint8,uint256,uint256,address,bool)',
+    'function getTokenV4(address token) external view returns ((uint8,uint256,uint256,uint256,uint8,uint256,uint256,address,bool,bytes32))',
+    'function getTokenV5(address token) external view returns ((uint8,uint256,uint256,uint256,uint8,uint256,uint256,uint256,uint256,address,bool,bytes32))',
+    // V7: 包含 taxRate, pool, progress, lpFeeProfile
+    'function getTokenV7(address token) external view returns ((uint8,uint256,uint256,uint256,uint8,uint256,uint256,uint256,uint256,address,bool,bytes32,uint256,address,uint256,uint8))',
+    // 报价方法
+    'function previewBuy(address token, uint256 ethAmount) external view returns (uint256)',
+    'function previewSell(address token, uint256 tokenAmount) external view returns (uint256)',
+    'function quoteExactInput((address inputToken,address outputToken,uint256 inputAmount)) external returns (uint256)',
+    // 交易方法
+    'function buy(address token, address to, uint256 minAmount) external payable returns (uint256)',
+    'function sell(address token, uint256 amount, uint256 minEth) external returns (uint256)',
+    'function swapExactInput((address inputToken,address outputToken,uint256 inputAmount,uint256 minOutputAmount,bytes permitData)) external payable returns (uint256)',
+    'function swapExactInputBuy((address inputToken,address outputToken,uint256 inputAmount,uint256 minOutputAmount,bytes permitData)) external payable returns (uint256)',
+    'function swapExactInputSell((address inputToken,address outputToken,uint256 inputAmount,uint256 minOutputAmount,bytes permitData)) external returns (uint256)',
+    'function swapExactInputV3((address inputToken,address outputToken,uint256 inputAmount,uint256 minOutputAmount,bytes permitData,bytes extensionData)) external payable returns (uint256)',
+    // 创建代币
+    'function newTokenV2((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint16 taxRate,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData)) external payable returns (address)',
+    'function newTokenV3((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint16 taxRate,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData,bytes32 extensionID,bytes extensionData)) external payable returns (address)',
+    'function newTokenV4((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint16 taxRate,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData,bytes32 extensionID,bytes extensionData,uint8 dexId,uint8 lpFeeProfile)) external payable returns (address)',
+    // newTokenV5: 支持 Tax Token V2 高级税收分配（legacy，推荐 newTokenV6）
+    'function newTokenV5((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint16 taxRate,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData,bytes32 extensionID,bytes extensionData,uint8 dexId,uint8 lpFeeProfile,uint64 taxDuration,uint64 antiFarmerDuration,uint16 mktBps,uint16 deflationBps,uint16 dividendBps,uint16 lpBps,uint256 minimumShareBalance)) external payable returns (address)',
+    // newTokenV6: 统一入口（TOKEN_V2_PERMIT / TOKEN_TAXED_V3）
+    '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)',
+    // newTokenV7: TOKEN_V3_PERMIT + CL 迁移
+    'function newTokenV7((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint8 migratorType,address quoteToken,uint256 quoteAmt,bytes permitData,bytes32 extensionID,bytes extensionData,uint8 dexId,uint16 buyTaxRate,uint16 sellTaxRate,uint64 taxDuration,uint64 antiFarmerDuration,address commissionReceiver,uint8 tokenVersion,(uint8 feeType,uint16 bps,address marketingAddress,address dividendToken,uint256 minimumShareBalance)[4] feeConfigs)) external payable returns (address)',
+    // 受益人领取
+    'function claim(address token) external returns (uint256,uint256)',
+    'function delegateClaim(address token) external returns (uint256,uint256)',
+    // 合约信息
+    'function getFeeRate() external view returns (uint256,uint256)',
+    'function nonce() external view returns (uint256)',
+    'function version() external pure returns (string)',
+    'function getLocks(address token) external view returns (uint256[])',
+];
+export class FlapPortal {
+    rpcUrl;
+    portal;
+    contract;
+    buyFeeRate;
+    sellFeeRate;
+    constructor(cfg) {
+        this.rpcUrl = cfg.rpcUrl;
+        this.portal = cfg.addressOverride ?? FLAP_PORTAL_ADDRESSES[cfg.chain];
+        // 使用链对应的默认费率，如果用户指定了费率则覆盖
+        const defaultFees = FLAP_DEFAULT_FEE_RATES[cfg.chain];
+        this.buyFeeRate = cfg.buyFeeRate ?? defaultFees.buy;
+        this.sellFeeRate = cfg.sellFeeRate ?? defaultFees.sell;
+        // 使用 ethers v6 创建只读合约实例
+        const provider = new JsonRpcProvider(this.rpcUrl);
+        this.contract = new Contract(this.portal, PORTAL_ABI, provider);
+    }
+    async getTokenV2(token) {
+        const r = await this.contract.getTokenV2(token);
+        return {
+            status: r[0],
+            reserve: r[1],
+            circulatingSupply: r[2],
+            price: r[3],
+            tokenVersion: r[4],
+            r: r[5],
+            dexSupplyThresh: r[6],
+        };
+    }
+    async getTokenV3(token) {
+        const r = await this.contract.getTokenV3(token);
+        return {
+            status: r[0],
+            reserve: r[1],
+            circulatingSupply: r[2],
+            price: r[3],
+            tokenVersion: r[4],
+            r: r[5],
+            dexSupplyThresh: r[6],
+            quoteTokenAddress: r[7],
+            nativeToQuoteSwapEnabled: r[8],
+        };
+    }
+    async getTokenV4(token) {
+        const raw = await this.contract.getTokenV4(token);
+        return {
+            status: raw[0],
+            reserve: raw[1],
+            circulatingSupply: raw[2],
+            price: raw[3],
+            tokenVersion: raw[4],
+            r: raw[5],
+            dexSupplyThresh: raw[6],
+            quoteTokenAddress: raw[7],
+            nativeToQuoteSwapEnabled: raw[8],
+            extensionID: raw[9],
+        };
+    }
+    async getTokenV5(token) {
+        const raw = await this.contract.getTokenV5(token);
+        return {
+            status: raw[0],
+            reserve: raw[1],
+            circulatingSupply: raw[2],
+            price: raw[3],
+            tokenVersion: raw[4],
+            r: raw[5],
+            h: raw[6],
+            k: raw[7],
+            dexSupplyThresh: raw[8],
+            quoteTokenAddress: raw[9],
+            nativeToQuoteSwapEnabled: raw[10],
+            extensionID: raw[11],
+        };
+    }
+    /**
+     * 获取代币状态 V7（包含毕业相关信息）
+     * 注意：仅部分链支持 V7（如 XLayer v5.7+），不支持的链会 revert
+     */
+    async getTokenV7(token) {
+        const raw = await this.contract.getTokenV7(token);
+        return {
+            status: raw[0],
+            reserve: raw[1],
+            circulatingSupply: raw[2],
+            price: raw[3],
+            tokenVersion: raw[4],
+            r: raw[5],
+            h: raw[6],
+            k: raw[7],
+            dexSupplyThresh: raw[8],
+            quoteTokenAddress: raw[9],
+            nativeToQuoteSwapEnabled: raw[10],
+            extensionID: raw[11],
+            taxRate: raw[12],
+            pool: raw[13],
+            progress: raw[14],
+            lpFeeProfile: Number(raw[15]),
+        };
+    }
+    /**
+     * 计算距离毕业还需多少 OKB/ETH（含手续费）
+     * @param state TokenStateV5 或 TokenStateV7
+     * @returns 毕业相关信息
+     */
+    computeRemainingToGraduation(state) {
+        const r = Number(formatEther(state.r));
+        const h = Number(formatEther(state.h));
+        const k = Number(formatEther(state.k));
+        const curve = new CDPV2(r, h, k);
+        const currentReserve = formatEther(state.reserve);
+        const dexSupplyThresh = formatEther(state.dexSupplyThresh);
+        // 计算毕业时的储备
+        const graduationReserve = curve.estimateReserve(dexSupplyThresh);
+        const graduationReserveNum = parseFloat(graduationReserve.toString());
+        const currentReserveNum = parseFloat(currentReserve);
+        // 是否已毕业 (status == 4 表示 DEX)
+        const isGraduated = state.status === 4;
+        // 还需多少（净值）
+        const remainingNet = Math.max(0, graduationReserveNum - currentReserveNum);
+        // 含手续费（1% buy fee）
+        const remainingWithFee = remainingNet / (1 - this.buyFeeRate);
+        // 计算进度
+        const progressPercent = isGraduated ? '100.00' : ((currentReserveNum / graduationReserveNum) * 100).toFixed(2);
+        return {
+            remainingOkb: remainingWithFee.toFixed(6),
+            graduationReserve: graduationReserveNum.toFixed(6),
+            currentReserve: currentReserveNum.toFixed(6),
+            isGraduated,
+            progressPercent,
+        };
+    }
+    // 价格/进度
+    computePriceAndProgress(state) {
+        // 使用合约返回的实时价格，而不是重新计算
+        // 合约的 price 字段会在每次买卖后更新，是最准确的实时价格
+        const price = formatEther(state.price);
+        // 计算进度（保留4位小数，格式如 "0.5432" 或 "1.0000"）
+        let progress;
+        const supply = formatEther(state.circulatingSupply);
+        const dexThresh = formatEther(state.dexSupplyThresh);
+        const supplyNum = FixedNumber.fromString(supply);
+        const dexThreshNum = FixedNumber.fromString(dexThresh);
+        if (supplyNum.gte(dexThreshNum)) {
+            // 如果已达到或超过 DEX 阈值，进度为 100%
+            progress = '1.0000';
+        }
+        else {
+            // 使用曲线计算当前和预期的储备量
+            const curve = new CDPV2(Number(formatEther(state.r)), Number(formatEther(state.h)), Number(formatEther(state.k)));
+            const currReserve = curve.estimateReserve(supply);
+            const expectReserve = curve.estimateReserve(dexThresh);
+            if (expectReserve.isZero() || parseFloat(expectReserve.toString()) <= 0) {
+                // 如果预期储备量为 0 或负数，进度为 0
+                progress = '0.0000';
+            }
+            else {
+                // 使用 FixedNumber 进行精度计算，保留 4 位小数
+                const progressNum = currReserve.div(expectReserve);
+                progress = parseFloat(progressNum.toString()).toFixed(4);
+            }
+        }
+        return { price, progress };
+    }
+    // 示例报价（离线）
+    quoteBuy(state, inputEth) {
+        const curve = new CDPV2(Number(formatEther(state.r)), Number(formatEther(state.h)), Number(formatEther(state.k)));
+        const supply = formatEther(state.circulatingSupply);
+        const dexThresh = formatEther(state.dexSupplyThresh);
+        const currReserve = curve.estimateReserve(supply);
+        const maxReserve = curve.estimateReserve(dexThresh);
+        // 使用 FixedNumber 进行精度计算
+        const inputAfterFee = FixedNumber.fromString(inputEth).mul(FixedNumber.fromValue(1 - this.buyFeeRate));
+        let newReserve;
+        if (curve.h === 0) {
+            newReserve = currReserve.add(inputAfterFee);
+        }
+        else {
+            const availableReserve = maxReserve.sub(currReserve);
+            const actualInput = parseFloat(inputAfterFee.toString()) <= parseFloat(availableReserve.toString())
+                ? inputAfterFee
+                : availableReserve;
+            newReserve = currReserve.add(actualInput);
+        }
+        const newSupply = curve.estimateSupply(newReserve.toString());
+        const outputTokens = newSupply.sub(FixedNumber.fromString(supply));
+        return outputTokens.toString();
+    }
+    quoteSell(state, inputToken) {
+        const curve = new CDPV2(Number(formatEther(state.r)), Number(formatEther(state.h)), Number(formatEther(state.k)));
+        const currSupply = FixedNumber.fromString(formatEther(state.circulatingSupply));
+        const inputAmt = FixedNumber.fromString(inputToken);
+        // 使用 FixedNumber 进行精度计算
+        const currReserve = curve.estimateReserve(currSupply.toString());
+        const newSupply = currSupply.sub(inputAmt);
+        const newReserve = curve.estimateReserve(newSupply.toString());
+        const beforeFee = currReserve.sub(newReserve);
+        const afterFee = beforeFee.mul(FixedNumber.fromValue(1 - this.sellFeeRate));
+        return afterFee.toString();
+    }
+    // 合约链上报价（买入）
+    async previewBuy(token, ethAmount) {
+        return await this.contract.previewBuy(token, ethAmount);
+    }
+    // 合约链上报价（卖出）
+    async previewSell(token, tokenAmount) {
+        return await this.contract.previewSell(token, tokenAmount);
+    }
+    // 合约 quote（使用 staticCall 模拟）
+    async quoteExactInput(params) {
+        return await this.contract.quoteExactInput.staticCall(params);
+    }
+    // 获取平台手续费率
+    async getFeeRate() {
+        const result = await this.contract.getFeeRate();
+        return { buyFeeRate: result[0], sellFeeRate: result[1] };
+    }
+    // 获取合约 nonce
+    async nonce() {
+        return await this.contract.nonce();
+    }
+    // 获取合约版本
+    async version() {
+        return await this.contract.version();
+    }
+    // 获取代币的锁仓信息
+    async getLocks(token) {
+        return await this.contract.getLocks(token);
+    }
+}

package/dist/domains/flap/types.d.ts

@@ -0,0 +1,246 @@
+/**
+ * Flap Portal — enum + 类型定义
+ *
+ * 包含 Token 状态/版本/费率等枚举、代币状态类型、创建代币参数、
+ * lpFeeProfileToV3Fee 与 validateTaxDistribution 纯工具函数。
+ */
+export declare enum TokenStatus {
+    Invalid = 0,
+    Tradable = 1,
+    InDuel = 2,
+    Killed = 3,
+    DEX = 4
+}
+export declare enum TokenVersion {
+    TOKEN_LEGACY_MINT_NO_PERMIT = 0,
+    TOKEN_LEGACY_MINT_NO_PERMIT_DUPLICATE = 1,
+    TOKEN_V2_PERMIT = 2,
+    TOKEN_GOPLUS = 3,
+    TOKEN_TAXED = 4,
+    TOKEN_TAXED_V2 = 5,
+    TOKEN_TAXED_V3 = 6,
+    TOKEN_V3_PERMIT = 7
+}
+/** newTokenV7 feeConfigs 槽位类型 */
+export declare enum FeeType {
+    NONE = 0,
+    MARKETING_OR_VAULT = 1,
+    DIVIDEND = 2,
+    DEFLATION = 3,
+    LP_BPS = 4
+}
+export declare enum DexThreshType {
+    TWO_THIRDS = 0,
+    FOUR_FIFTHS = 1,
+    HALF = 2,
+    _95_PERCENT = 3,
+    _81_PERCENT = 4,
+    _1_PERCENT = 5
+}
+export declare enum MigratorType {
+    V3_MIGRATOR = 0,
+    V2_MIGRATOR = 1,
+    /** PCS Infinity CL 迁移（newTokenV7 / TOKEN_V3_PERMIT） */
+    PCS_INFINITY_CL_MIGRATOR = 3
+}
+/**
+ * V3 LP 费率档位
+ * 决定代币迁移到 Uniswap V3 或 PancakeSwap V3 时使用的费率
+ */
+export declare enum V3LPFeeProfile {
+    /** 标准费率: PancakeSwap 0.25%, Uniswap 0.3% */
+    LP_FEE_PROFILE_STANDARD = 0,
+    /** 低费率: PancakeSwap 0.01%, Uniswap 0.05% (BNB 链需要白名单) */
+    LP_FEE_PROFILE_LOW = 1,
+    /** 高费率: 1% (适用于特殊交易对) */
+    LP_FEE_PROFILE_HIGH = 2
+}
+/**
+ * DEX ID
+ * 决定代币迁移到哪个 DEX
+ * - BSC: DEX0 = PancakeSwap
+ * - xLayer: DEX0 = PotatoSwap
+ * - Monad: DEX0 = Uniswap, DEX1 = PancakeSwap, DEX2 = Monday
+ */
+export declare enum DEXId {
+    DEX0 = 0,
+    DEX1 = 1,
+    DEX2 = 2
+}
+export type TokenStateV2 = {
+    status: number;
+    reserve: bigint;
+    circulatingSupply: bigint;
+    price: bigint;
+    tokenVersion: number;
+    r: bigint;
+    dexSupplyThresh: bigint;
+};
+export type TokenStateV3 = {
+    status: number;
+    reserve: bigint;
+    circulatingSupply: bigint;
+    price: bigint;
+    tokenVersion: number;
+    r: bigint;
+    dexSupplyThresh: bigint;
+    quoteTokenAddress: string;
+    nativeToQuoteSwapEnabled: boolean;
+};
+export type TokenStateV4 = {
+    status: number;
+    reserve: bigint;
+    circulatingSupply: bigint;
+    price: bigint;
+    tokenVersion: number;
+    r: bigint;
+    dexSupplyThresh: bigint;
+    quoteTokenAddress: string;
+    nativeToQuoteSwapEnabled: boolean;
+    extensionID: `0x${string}`;
+};
+export type TokenStateV5 = {
+    status: number;
+    reserve: bigint;
+    circulatingSupply: bigint;
+    price: bigint;
+    tokenVersion: number;
+    r: bigint;
+    h: bigint;
+    k: bigint;
+    dexSupplyThresh: bigint;
+    quoteTokenAddress: string;
+    nativeToQuoteSwapEnabled: boolean;
+    extensionID: `0x${string}`;
+};
+/**
+ * TokenStateV7 - 包含毕业相关信息（pool, progress, lpFeeProfile）
+ * 用于 XLayer 等支持 V7 的链
+ */
+export type TokenStateV7 = TokenStateV5 & {
+    taxRate: bigint;
+    pool: string;
+    progress: bigint;
+    lpFeeProfile: number;
+};
+/**
+ * 将 lpFeeProfile 转换为 V3 fee 值
+ */
+export declare function lpFeeProfileToV3Fee(profile: number): number;
+/**
+ * Flap Portal 支持的链
+ */
+export type FlapChain = 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD';
+/**
+ * Flap Portal 配置
+ */
+export type PortalConfig = {
+    chain: FlapChain;
+    rpcUrl: string;
+    addressOverride?: string;
+    buyFeeRate?: number;
+    sellFeeRate?: number;
+};
+export type QuoteExactInputParams = {
+    inputToken: string;
+    outputToken: string;
+    inputAmount: bigint;
+};
+export type ExactInputParams = {
+    inputToken: string;
+    outputToken: string;
+    inputAmount: bigint;
+    minOutputAmount: bigint;
+    permitData?: string;
+};
+export type ExactInputV3Params = {
+    inputToken: string;
+    outputToken: string;
+    inputAmount: bigint;
+    minOutputAmount: bigint;
+    permitData?: string;
+    extensionData?: string;
+};
+export type NewTokenV3Params = {
+    name: string;
+    symbol: string;
+    meta: string;
+    dexThresh: number;
+    salt: string;
+    taxRate: number;
+    migratorType: number;
+    quoteToken: string;
+    quoteAmt: bigint;
+    beneficiary: string;
+    permitData?: string;
+    extensionID: string;
+    extensionData?: string;
+};
+/**
+ * newTokenV4 参数
+ * 相比 V3 新增了 DEX 选择和 LP 费率配置
+ */
+export type NewTokenV4Params = {
+    name: string;
+    symbol: string;
+    meta: string;
+    dexThresh: number;
+    salt: string;
+    taxRate: number;
+    migratorType: number;
+    quoteToken: string;
+    quoteAmt: bigint;
+    beneficiary: string;
+    permitData?: string;
+    extensionID: string;
+    extensionData?: string;
+    dexId: number;
+    lpFeeProfile: number;
+};
+/**
+ * newTokenV5 参数
+ * 相比 V4 新增了 Tax Token V2 高级税收分配功能
+ * 当 taxRate > 0 时，支持多种税收分配方式：营销、销毁、分红、流动性
+ */
+export type NewTokenV5Params = {
+    name: string;
+    symbol: string;
+    meta: string;
+    dexThresh: number;
+    salt: string;
+    taxRate: number;
+    migratorType: number;
+    quoteToken: string;
+    quoteAmt: bigint;
+    beneficiary: string;
+    permitData?: string;
+    extensionID: string;
+    extensionData?: string;
+    dexId: number;
+    lpFeeProfile: number;
+    taxDuration: bigint;
+    antiFarmerDuration: bigint;
+    mktBps: number;
+    deflationBps: number;
+    dividendBps: number;
+    lpBps: number;
+    minimumShareBalance: bigint;
+};
+/**
+ * 税收分配配置（用于 UI）
+ * 注意：mktBps + deflationBps + dividendBps + lpBps 必须等于 10000 (100%)
+ */
+export type TaxDistributionConfig = {
+    mktBps: number;
+    deflationBps: number;
+    dividendBps: number;
+    lpBps: number;
+    minimumShareBalance?: bigint;
+};
+/**
+ * 验证税收分配是否有效
+ */
+export declare function validateTaxDistribution(config: TaxDistributionConfig): {
+    valid: boolean;
+    error?: string;
+};

package/dist/domains/flap/types.js

@@ -0,0 +1,104 @@
+/**
+ * Flap Portal — enum + 类型定义
+ *
+ * 包含 Token 状态/版本/费率等枚举、代币状态类型、创建代币参数、
+ * lpFeeProfileToV3Fee 与 validateTaxDistribution 纯工具函数。
+ */
+export var TokenStatus;
+(function (TokenStatus) {
+    TokenStatus[TokenStatus["Invalid"] = 0] = "Invalid";
+    TokenStatus[TokenStatus["Tradable"] = 1] = "Tradable";
+    TokenStatus[TokenStatus["InDuel"] = 2] = "InDuel";
+    TokenStatus[TokenStatus["Killed"] = 3] = "Killed";
+    TokenStatus[TokenStatus["DEX"] = 4] = "DEX";
+})(TokenStatus || (TokenStatus = {}));
+export var TokenVersion;
+(function (TokenVersion) {
+    TokenVersion[TokenVersion["TOKEN_LEGACY_MINT_NO_PERMIT"] = 0] = "TOKEN_LEGACY_MINT_NO_PERMIT";
+    TokenVersion[TokenVersion["TOKEN_LEGACY_MINT_NO_PERMIT_DUPLICATE"] = 1] = "TOKEN_LEGACY_MINT_NO_PERMIT_DUPLICATE";
+    TokenVersion[TokenVersion["TOKEN_V2_PERMIT"] = 2] = "TOKEN_V2_PERMIT";
+    TokenVersion[TokenVersion["TOKEN_GOPLUS"] = 3] = "TOKEN_GOPLUS";
+    TokenVersion[TokenVersion["TOKEN_TAXED"] = 4] = "TOKEN_TAXED";
+    TokenVersion[TokenVersion["TOKEN_TAXED_V2"] = 5] = "TOKEN_TAXED_V2";
+    TokenVersion[TokenVersion["TOKEN_TAXED_V3"] = 6] = "TOKEN_TAXED_V3";
+    TokenVersion[TokenVersion["TOKEN_V3_PERMIT"] = 7] = "TOKEN_V3_PERMIT";
+})(TokenVersion || (TokenVersion = {}));
+/** newTokenV7 feeConfigs 槽位类型 */
+export var FeeType;
+(function (FeeType) {
+    FeeType[FeeType["NONE"] = 0] = "NONE";
+    FeeType[FeeType["MARKETING_OR_VAULT"] = 1] = "MARKETING_OR_VAULT";
+    FeeType[FeeType["DIVIDEND"] = 2] = "DIVIDEND";
+    FeeType[FeeType["DEFLATION"] = 3] = "DEFLATION";
+    FeeType[FeeType["LP_BPS"] = 4] = "LP_BPS";
+})(FeeType || (FeeType = {}));
+export var DexThreshType;
+(function (DexThreshType) {
+    DexThreshType[DexThreshType["TWO_THIRDS"] = 0] = "TWO_THIRDS";
+    DexThreshType[DexThreshType["FOUR_FIFTHS"] = 1] = "FOUR_FIFTHS";
+    DexThreshType[DexThreshType["HALF"] = 2] = "HALF";
+    DexThreshType[DexThreshType["_95_PERCENT"] = 3] = "_95_PERCENT";
+    DexThreshType[DexThreshType["_81_PERCENT"] = 4] = "_81_PERCENT";
+    DexThreshType[DexThreshType["_1_PERCENT"] = 5] = "_1_PERCENT";
+})(DexThreshType || (DexThreshType = {}));
+export var MigratorType;
+(function (MigratorType) {
+    MigratorType[MigratorType["V3_MIGRATOR"] = 0] = "V3_MIGRATOR";
+    MigratorType[MigratorType["V2_MIGRATOR"] = 1] = "V2_MIGRATOR";
+    /** PCS Infinity CL 迁移（newTokenV7 / TOKEN_V3_PERMIT） */
+    MigratorType[MigratorType["PCS_INFINITY_CL_MIGRATOR"] = 3] = "PCS_INFINITY_CL_MIGRATOR";
+})(MigratorType || (MigratorType = {}));
+/**
+ * V3 LP 费率档位
+ * 决定代币迁移到 Uniswap V3 或 PancakeSwap V3 时使用的费率
+ */
+export var V3LPFeeProfile;
+(function (V3LPFeeProfile) {
+    /** 标准费率: PancakeSwap 0.25%, Uniswap 0.3% */
+    V3LPFeeProfile[V3LPFeeProfile["LP_FEE_PROFILE_STANDARD"] = 0] = "LP_FEE_PROFILE_STANDARD";
+    /** 低费率: PancakeSwap 0.01%, Uniswap 0.05% (BNB 链需要白名单) */
+    V3LPFeeProfile[V3LPFeeProfile["LP_FEE_PROFILE_LOW"] = 1] = "LP_FEE_PROFILE_LOW";
+    /** 高费率: 1% (适用于特殊交易对) */
+    V3LPFeeProfile[V3LPFeeProfile["LP_FEE_PROFILE_HIGH"] = 2] = "LP_FEE_PROFILE_HIGH";
+})(V3LPFeeProfile || (V3LPFeeProfile = {}));
+/**
+ * DEX ID
+ * 决定代币迁移到哪个 DEX
+ * - BSC: DEX0 = PancakeSwap
+ * - xLayer: DEX0 = PotatoSwap
+ * - Monad: DEX0 = Uniswap, DEX1 = PancakeSwap, DEX2 = Monday
+ */
+export var DEXId;
+(function (DEXId) {
+    DEXId[DEXId["DEX0"] = 0] = "DEX0";
+    DEXId[DEXId["DEX1"] = 1] = "DEX1";
+    DEXId[DEXId["DEX2"] = 2] = "DEX2";
+})(DEXId || (DEXId = {}));
+/**
+ * 将 lpFeeProfile 转换为 V3 fee 值
+ */
+export function lpFeeProfileToV3Fee(profile) {
+    switch (profile) {
+        case V3LPFeeProfile.LP_FEE_PROFILE_STANDARD:
+            return 2500;
+        case V3LPFeeProfile.LP_FEE_PROFILE_LOW:
+            return 100;
+        case V3LPFeeProfile.LP_FEE_PROFILE_HIGH:
+            return 10000;
+        default:
+            return 2500; // 默认 STANDARD
+    }
+}
+/**
+ * 验证税收分配是否有效
+ */
+export function validateTaxDistribution(config) {
+    const total = config.mktBps + config.deflationBps + config.dividendBps + config.lpBps;
+    if (total !== 10000) {
+        return { valid: false, error: `税收分配总计必须为 100%，当前为 ${total / 100}%` };
+    }
+    if (config.dividendBps > 0 && (!config.minimumShareBalance || config.minimumShareBalance < 10000n * 10n ** 18n)) {
+        return { valid: false, error: '启用分红时，最低持仓门槛必须至少为 10,000 个代币' };
+    }
+    return { valid: true };
+}