four-flap-meme-sdk 2.2.2 → 2.2.3

package/dist/shared/flap/portal-bundle.js

@@ -8,7 +8,7 @@ const PORTAL_ABI = [
     '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 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 quoteExactInput((address inputToken,address outputToken,uint256 inputAmount)) external returns (uint256)'
+    'function quoteExactInput((address inputToken,address outputToken,uint256 inputAmount)) external returns (uint256)',
 ];
 /**
  * Flap Protocol Bundle 交易方法
@@ -18,20 +18,20 @@ const PORTAL_ABI = [
 const ERRORS = {
     NO_PRIVATE_KEY: {
         en: 'At least 1 private key (creator) is required',
-        zh: '至少需要 1 个私钥（创建者）'
+        zh: '至少需要 1 个私钥（创建者）',
     },
     AMOUNT_MISMATCH: {
         en: (buyCount, buyerCount) => `Buy amount count (${buyCount}) must equal buyer count (${buyerCount})`,
-        zh: (buyCount, buyerCount) => `购买金额数量(${buyCount})必须等于买家数量(${buyerCount})`
+        zh: (buyCount, buyerCount) => `购买金额数量(${buyCount})必须等于买家数量(${buyerCount})`,
     },
     KEY_AMOUNT_MISMATCH: {
         en: 'Private key count and amount count must match',
-        zh: '私钥和购买金额数量必须一致'
+        zh: '私钥和购买金额数量必须一致',
     },
     SELL_KEY_AMOUNT_MISMATCH: {
         en: 'Private key count and sell amount count must match',
-        zh: '私钥和卖出数量必须一致'
-    }
+        zh: '私钥和卖出数量必须一致',
+    },
 };
 // 获取错误信息（根据环境语言）
 function getErrorMessage(key, ...args) {
@@ -56,28 +56,11 @@ async function estimateGasWithMultiplier(provider, txRequest, multiplier) {
 function getTxType(config) {
     return config.txType ?? 0; // 默认 Legacy (type 0)，适用于 48.club/BSC
 }
-/**
- * 构建完整的交易请求（包含 gas 估算和交易类型）
- */
-async function buildTxRequest(provider, unsigned, from, nonce, gasPrice, config, value) {
-    const gasLimit = await estimateGasWithMultiplier(provider, { ...unsigned, from, value }, config.gasLimitMultiplier);
-    return {
-        ...unsigned,
-        from,
-        nonce,
-        gasLimit,
-        gasPrice,
-        chainId: 56,
-        type: getTxType(config)
-    };
-}
 /**
  * Flap Protocol: 创建代币 + 捆绑购买
  */
 export async function createTokenWithBundleBuy(params) {
-    const { chain, privateKeys, buyAmounts, tokenInfo, quoteToken, tokenAddress, config } = params;
-    // 默认使用 BNB (0地址)
-    const quoteTokenAddress = quoteToken || '0x0000000000000000000000000000000000000000';
+    const { chain, privateKeys, buyAmounts, tokenInfo, tokenAddress, config } = params;
     if (privateKeys.length === 0) {
         throw new Error(getErrorMessage('NO_PRIVATE_KEY'));
     }
@@ -88,7 +71,7 @@ export async function createTokenWithBundleBuy(params) {
     const devWallet = new Wallet(privateKeys[0], provider);
     const club48 = new Club48Client({
         endpoint: config.club48Endpoint,
-        explorerEndpoint: config.club48ExplorerEndpoint
+        explorerEndpoint: config.club48ExplorerEndpoint,
     });
     const blockOffset = config.bundleBlockOffset ?? 100;
     // 1. 构建交易（为重复地址分配顺序 nonce）
@@ -122,7 +105,7 @@ export async function createTokenWithBundleBuy(params) {
         quoteToken: params.quoteToken || '0x0000000000000000000000000000000000000000',
         quoteAmt: 0n,
         beneficiary: new Wallet(privateKeys[0]).address,
-        permitData: '0x'
+        permitData: '0x',
     });
     // 估算 gas 并应用用户配置的安全余量
     const createGasLimit = await estimateGasWithMultiplier(provider, { ...createTxUnsigned, from: devWallet.address }, config.gasLimitMultiplier);
@@ -133,7 +116,7 @@ export async function createTokenWithBundleBuy(params) {
         gasLimit: createGasLimit,
         gasPrice: gasPrice,
         chainId: 56, // BSC
-        type: getTxType(config) // 用户可配置：0=Legacy（默认），2=EIP-1559
+        type: getTxType(config), // 用户可配置：0=Legacy（默认），2=EIP-1559
     };
     const signedCreateTx = await devWallet.signTransaction(createTxRequest);
     signedTxs.push(signedCreateTx);
@@ -146,7 +129,7 @@ export async function createTokenWithBundleBuy(params) {
             gasLimit: GAS_LIMITS.BRIBE,
             chainId: 56,
             type: 0, // Legacy transaction
-            nonce: await getNextNonce(devWallet)
+            nonce: await getNextNonce(devWallet),
         });
         signedTxs.push(tipTx);
     }
@@ -163,7 +146,7 @@ export async function createTokenWithBundleBuy(params) {
             const exactOut = await quote.quoteExactInput.staticCall({
                 inputToken: '0x0000000000000000000000000000000000000000',
                 outputToken: tokenAddress,
-                inputAmount: amountIn
+                inputAmount: amountIn,
             });
             const keep = BigInt(10000 - slippageBps);
             minAmountOut = (exactOut * keep) / 10000n;
@@ -193,7 +176,7 @@ export async function createTokenWithBundleBuy(params) {
             gasLimit: buyGasLimit,
             gasPrice: gasPrice,
             chainId: 56, // BSC
-            type: getTxType(config) // 用户可配置
+            type: getTxType(config), // 用户可配置
         };
         const signedBuyTx = await buyerWallet.signTransaction(buyTxRequest);
         signedTxs.push(signedBuyTx);
@@ -203,11 +186,11 @@ export async function createTokenWithBundleBuy(params) {
     const bundleUuid = await club48.sendBundle({
         txs: signedTxs,
         maxBlockNumber: (await provider.getBlockNumber()) + blockOffset,
-        noMerge: config.noMerge
+        noMerge: config.noMerge,
     }, {
         spMode: params.config.spMode ?? 'timestampPersonalSign',
         spPrivateKey: params.config.spPrivateKey || privateKeys[0],
-        spVMode: params.config.spVMode
+        spVMode: params.config.spVMode,
     });
     // 3. 等待完成
     const status = await club48.waitForBundle(bundleUuid, params.config.waitTimeoutMs ?? 60000);
@@ -216,7 +199,7 @@ export async function createTokenWithBundleBuy(params) {
         tokenAddress,
         status,
         createTx: signedCreateTx,
-        buyTxs
+        buyTxs,
     };
 }
 /**
@@ -230,7 +213,7 @@ export async function batchBuyWithBundle(params) {
     const provider = new JsonRpcProvider(config.rpcUrl);
     const club48 = new Club48Client({
         endpoint: config.club48Endpoint,
-        explorerEndpoint: config.club48ExplorerEndpoint
+        explorerEndpoint: config.club48ExplorerEndpoint,
     });
     const blockOffset = config.bundleBlockOffset ?? 100;
     const portalAddr = FLAP_PORTAL_ADDRESSES[chain];
@@ -259,7 +242,7 @@ export async function batchBuyWithBundle(params) {
             gasLimit: GAS_LIMITS.BRIBE,
             chainId: 56,
             type: 0, // Legacy transaction
-            nonce: await getNextNonce(tipWallet)
+            nonce: await getNextNonce(tipWallet),
         });
         signedTxs.unshift(tipTx);
     }
@@ -274,7 +257,7 @@ export async function batchBuyWithBundle(params) {
             const exactOut = await quote.quoteExactInput.staticCall({
                 inputToken: '0x0000000000000000000000000000000000000000',
                 outputToken: tokenAddress,
-                inputAmount: amountIn
+                inputAmount: amountIn,
             });
             const keep = BigInt(10000 - slippageBps);
             minAmountOut = (exactOut * keep) / 10000n;
@@ -292,7 +275,7 @@ export async function batchBuyWithBundle(params) {
         const estimatedGas = await provider.estimateGas({
             ...buyTxUnsigned,
             from: buyerWallet.address,
-            value: amountIn
+            value: amountIn,
         });
         const gasLimit = (estimatedGas * 120n) / 100n;
         const buyTxRequest = {
@@ -302,7 +285,7 @@ export async function batchBuyWithBundle(params) {
             gasLimit: gasLimit,
             gasPrice: gasPrice,
             chainId: 56, // BSC
-            type: 0 // Legacy transaction
+            type: 0, // Legacy transaction
         };
         const signedBuyTx = await buyerWallet.signTransaction(buyTxRequest);
         signedTxs.push(signedBuyTx);
@@ -310,11 +293,11 @@ export async function batchBuyWithBundle(params) {
     const bundleUuid = await club48.sendBundle({
         txs: signedTxs,
         maxBlockNumber: (await provider.getBlockNumber()) + blockOffset,
-        noMerge: config.noMerge
+        noMerge: config.noMerge,
     }, {
         spMode: params.config.spMode ?? 'timestampPersonalSign',
         spPrivateKey: params.config.spPrivateKey || privateKeys[0],
-        spVMode: params.config.spVMode
+        spVMode: params.config.spVMode,
     });
     const status = await club48.waitForBundle(bundleUuid);
     return { bundleUuid, status, buyTxs: signedTxs };
@@ -330,7 +313,7 @@ export async function batchSellWithBundle(params) {
     const provider = new JsonRpcProvider(config.rpcUrl);
     const club48 = new Club48Client({
         endpoint: config.club48Endpoint,
-        explorerEndpoint: config.club48ExplorerEndpoint
+        explorerEndpoint: config.club48ExplorerEndpoint,
     });
     const blockOffset = config.bundleBlockOffset ?? 100;
     const portalAddr = FLAP_PORTAL_ADDRESSES[chain];
@@ -359,7 +342,7 @@ export async function batchSellWithBundle(params) {
             gasLimit: GAS_LIMITS.BRIBE,
             chainId: 56,
             type: 0, // Legacy transaction
-            nonce: await getNextNonce(tipWallet)
+            nonce: await getNextNonce(tipWallet),
         });
         signedTxs.unshift(tipTx);
     }
@@ -378,7 +361,7 @@ export async function batchSellWithBundle(params) {
         // 估算 gas 并添加 20% 安全余量
         const estimatedGas = await provider.estimateGas({
             ...sellTxUnsigned,
-            from: sellerWallet.address
+            from: sellerWallet.address,
         });
         const gasLimit = (estimatedGas * 120n) / 100n;
         const sellTxRequest = {
@@ -388,7 +371,7 @@ export async function batchSellWithBundle(params) {
             gasLimit: gasLimit,
             gasPrice: gasPrice,
             chainId: 56, // BSC
-            type: 0 // Legacy transaction
+            type: 0, // Legacy transaction
         };
         const signedSellTx = await sellerWallet.signTransaction(sellTxRequest);
         signedTxs.push(signedSellTx);
@@ -396,17 +379,17 @@ export async function batchSellWithBundle(params) {
     const bundleUuid = await club48.sendBundle({
         txs: signedTxs,
         maxBlockNumber: (await provider.getBlockNumber()) + blockOffset,
-        noMerge: config.noMerge
+        noMerge: config.noMerge,
     }, {
         spMode: params.config.spMode ?? 'timestampPersonalSign',
         spPrivateKey: params.config.spPrivateKey || privateKeys[0],
-        spVMode: params.config.spVMode
+        spVMode: params.config.spVMode,
     });
     const status = await club48.waitForBundle(bundleUuid);
     return { bundleUuid, status, sellTxs: signedTxs };
 }
 export async function flapPrivateBuy(params) {
-    const { chain, privateKey, tokenAddress, amountIn, to, config, spPrivateKey } = params;
+    const { chain, privateKey, tokenAddress, amountIn, config, spPrivateKey } = params;
     const provider = new JsonRpcProvider(config.rpcUrl);
     const wallet = new Wallet(privateKey, provider);
     const club48 = new Club48Client({ endpoint: config.club48Endpoint, explorerEndpoint: config.club48ExplorerEndpoint });
@@ -426,7 +409,7 @@ export async function flapPrivateBuy(params) {
     const estimatedGas = await provider.estimateGas({
         ...unsigned,
         from: wallet.address,
-        value: amountWei
+        value: amountWei,
     });
     const gasLimit = (estimatedGas * 120n) / 100n;
     const req = {
@@ -436,7 +419,7 @@ export async function flapPrivateBuy(params) {
         gasLimit: gasLimit,
         gasPrice,
         chainId: 56,
-        type: 0 // Legacy transaction
+        type: 0, // Legacy transaction
     };
     const signed = await wallet.signTransaction(req);
     if (spPrivateKey)
@@ -463,7 +446,7 @@ export async function flapPrivateSell(params) {
     // 估算 gas 并添加 20% 安全余量
     const estimatedGas = await provider.estimateGas({
         ...unsigned,
-        from: wallet.address
+        from: wallet.address,
     });
     const gasLimit = (estimatedGas * 120n) / 100n;
     const req = {
@@ -473,7 +456,7 @@ export async function flapPrivateSell(params) {
         gasLimit: gasLimit,
         gasPrice,
         chainId: 56,
-        type: 0 // Legacy transaction
+        type: 0, // Legacy transaction
     };
     const signed = await wallet.signTransaction(req);
     if (spPrivateKey)
@@ -516,13 +499,21 @@ export async function flapBatchPrivateBuy(params) {
         // 估算 gas 并添加 20% 安全余量
         const estimatedGas = await provider.estimateGas({ ...unsigned, from: w.address, value: amountWei });
         const gasLimit = (estimatedGas * 120n) / 100n;
-        const req = { ...unsigned, from: w.address, nonce: await getNextNonce(w), gasLimit, gasPrice, chainId: 56, type: 0 };
+        const req = {
+            ...unsigned,
+            from: w.address,
+            nonce: await getNextNonce(w),
+            gasLimit,
+            gasPrice,
+            chainId: 56,
+            type: 0,
+        };
         signedTxs.push(await w.signTransaction(req));
     }
     return await sendBatchPrivateTransactions(signedTxs, spPrivateKey, config.club48Endpoint || 'https://puissant-bsc.48.club');
 }
 export async function flapBatchPrivateSell(params) {
-    const { chain, privateKeys, amounts, tokenAddress, config, spPrivateKey, minEthEach } = params;
+    const { chain, privateKeys, amounts, tokenAddress, config, minEthEach } = params;
     if (privateKeys.length !== amounts.length)
         throw new Error('privateKeys and amounts length mismatch');
     const provider = new JsonRpcProvider(config.rpcUrl);
@@ -558,7 +549,15 @@ export async function flapBatchPrivateSell(params) {
         // 估算 gas 并添加 20% 安全余量
         const estimatedGas = await provider.estimateGas({ ...unsigned, from: w.address });
         const gasLimit = (estimatedGas * 120n) / 100n;
-        const req = { ...unsigned, from: w.address, nonce: await getNextNonce(w), gasLimit, gasPrice, chainId: 56, type: 0 };
+        const req = {
+            ...unsigned,
+            from: w.address,
+            nonce: await getNextNonce(w),
+            gasLimit,
+            gasPrice,
+            chainId: 56,
+            type: 0,
+        };
         signedTxs.push(await w.signTransaction(req));
     }
     // 使用 bundle 通道提交（统一与捆绑买保持一致）
@@ -566,12 +565,12 @@ export async function flapBatchPrivateSell(params) {
     const bundleUuid = await club48.sendBundle({
         txs: signedTxs,
         maxBlockNumber: (await provider.getBlockNumber()) + blockOffset,
-        noMerge: config.noMerge
+        noMerge: config.noMerge,
     }, {
         // 若传入 sp 配置，则用于生成 48SP 签名提升打包优先级（与批量买一致）
         spMode: params.config.spMode ?? 'timestampPersonalSign',
         spPrivateKey: params.config.spPrivateKey || 'https://puissant-bsc.48.club',
-        spVMode: params.config.spVMode
+        spVMode: params.config.spVMode,
     });
     try {
         const status = await club48.waitForBundle(bundleUuid);

package/dist/shared/flap/portal-create-token.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Portal 发币交易构建（newTokenV6 / newTokenV7 / VaultPortal）
+ *
+ * 对齐 Flap 官方文档：
+ * - newTokenV6：TOKEN_V2_PERMIT / TOKEN_TAXED_V3
+ * - newTokenV7：TOKEN_V3_PERMIT（CL 迁移）
+ * - VaultPortal.newTaxTokenWithVault：带金库的税币（legacy 参数结构）
+ */
+import { Contract, type Wallet } from 'ethers';
+import { type TaxVaultConfig } from './vault.js';
+/** 分红代币：将 launching token 本身作为分红代币 */
+export declare const MAGIC_DIVIDEND_SELF = "0xfEEDFEEDfeEDFEedFEEdFEEDFeEdfEEdFeEdFEEd";
+export type NormalizedTaxLaunchConfig = {
+    taxDuration: number;
+    antiFarmerDuration: number;
+    mktBps: number;
+    deflationBps: number;
+    dividendBps: number;
+    lpBps: number;
+    minimumShareBalance?: number;
+    buyTaxRate: number;
+    sellTaxRate: number;
+    dividendToken?: string;
+    commissionReceiver?: string;
+    vaultConfig?: TaxVaultConfig;
+};
+export type PopulateCreateTokenParams = {
+    chain: string;
+    devWallet: Wallet;
+    originalPortal: Contract;
+    tokenInfo: {
+        name: string;
+        symbol: string;
+        meta: string;
+    };
+    quoteToken?: string;
+    beneficiary: string;
+    dexThresh?: number;
+    salt?: string;
+    migratorType?: number;
+    /** legacy 单税率（bps），无 buy/sell 时作为对称税率 */
+    taxRate?: number;
+    dexId?: number;
+    lpFeeProfile?: number;
+    extensionID?: string;
+    extensionData?: string;
+    /** 标准 V3 代币（newTokenV7 + TOKEN_V3_PERMIT） */
+    useV3Standard?: boolean;
+    /** 高级税币 / 税币 V3 配置 */
+    taxConfig?: NormalizedTaxLaunchConfig;
+};
+/** 将 TaxV2Config（含 distribution 嵌套）或 flat 结构归一化 */
+export declare function normalizeTaxLaunchConfig(input?: {
+    taxDuration: number;
+    antiFarmerDuration: number;
+    mktBps?: number;
+    deflationBps?: number;
+    dividendBps?: number;
+    lpBps?: number;
+    minimumShareBalance?: number;
+    buyTaxRate?: number;
+    sellTaxRate?: number;
+    dividendToken?: string;
+    commissionReceiver?: string;
+    vaultConfig?: TaxVaultConfig;
+    distribution?: {
+        mktBps: number;
+        deflationBps: number;
+        dividendBps: number;
+        lpBps: number;
+        minimumShareBalance?: number;
+    };
+}, fallbackTaxRate?: number): NormalizedTaxLaunchConfig | undefined;
+/**
+ * 构建发币 populateTransaction（优先 V6/V7，Vault 走 VaultPortal）
+ */
+export declare function populateCreateTokenTransaction(params: PopulateCreateTokenParams): Promise<import("ethers").ContractTransaction>;

package/dist/shared/flap/portal-create-token.js

@@ -0,0 +1,214 @@
+/**
+ * Portal 发币交易构建（newTokenV6 / newTokenV7 / VaultPortal）
+ *
+ * 对齐 Flap 官方文档：
+ * - newTokenV6：TOKEN_V2_PERMIT / TOKEN_TAXED_V3
+ * - newTokenV7：TOKEN_V3_PERMIT（CL 迁移）
+ * - VaultPortal.newTaxTokenWithVault：带金库的税币（legacy 参数结构）
+ */
+import { Contract, ZeroAddress } from 'ethers';
+import { ZERO_ADDRESS } from '../constants/index.js';
+import { buildVaultParams, VAULT_PORTAL_ADDRESSES, VAULT_PORTAL_ABI } from './vault.js';
+import { TokenVersion, MigratorType, FeeType } from './portal.js';
+/** 分红代币：将 launching token 本身作为分红代币 */
+export const MAGIC_DIVIDEND_SELF = '0xfEEDFEEDfeEDFEedFEEdFEEDFeEdfEEdFeEdFEEd';
+function zeroBytes32() {
+    return '0x' + '00'.repeat(32);
+}
+function resolveTaxRates(taxConfig, taxRate) {
+    const buy = taxConfig?.buyTaxRate ?? taxRate ?? 0;
+    const sell = taxConfig?.sellTaxRate ?? taxRate ?? 0;
+    return { buyTaxRate: buy & 0xffff, sellTaxRate: sell & 0xffff };
+}
+function validateTaxDistribution(mkt, def, div, lp) {
+    const total = mkt + def + div + lp;
+    if (total !== 10000) {
+        throw new Error(`Tax distribution must sum to 10000 (100%), got ${total}`);
+    }
+}
+function buildV6TaxParams(params, taxConfig, dist) {
+    const { buyTaxRate, sellTaxRate } = resolveTaxRates(taxConfig, params.taxRate);
+    validateTaxDistribution(dist.mktBps, dist.deflationBps, dist.dividendBps, dist.lpBps);
+    return {
+        name: params.tokenInfo.name,
+        symbol: params.tokenInfo.symbol,
+        meta: params.tokenInfo.meta,
+        dexThresh: (params.dexThresh ?? 1) & 0xff,
+        salt: params.salt ?? zeroBytes32(),
+        migratorType: (params.migratorType ?? MigratorType.V2_MIGRATOR) & 0xff,
+        quoteToken: params.quoteToken || ZERO_ADDRESS,
+        quoteAmt: 0n,
+        beneficiary: params.beneficiary,
+        permitData: '0x',
+        extensionID: params.extensionID ?? zeroBytes32(),
+        extensionData: params.extensionData ?? '0x',
+        dexId: (params.dexId ?? 0) & 0xff,
+        lpFeeProfile: (params.lpFeeProfile ?? 0) & 0xff,
+        buyTaxRate,
+        sellTaxRate,
+        taxDuration: BigInt(taxConfig.taxDuration),
+        antiFarmerDuration: BigInt(taxConfig.antiFarmerDuration),
+        mktBps: dist.mktBps,
+        deflationBps: dist.deflationBps,
+        dividendBps: dist.dividendBps,
+        lpBps: dist.lpBps,
+        minimumShareBalance: BigInt(taxConfig.minimumShareBalance ?? 10000) * 10n ** 18n,
+        dividendToken: taxConfig.dividendToken || ZeroAddress,
+        commissionReceiver: taxConfig.commissionReceiver || ZeroAddress,
+        tokenVersion: TokenVersion.TOKEN_TAXED_V3,
+    };
+}
+/** 将 TaxV2Config（含 distribution 嵌套）或 flat 结构归一化 */
+export function normalizeTaxLaunchConfig(input, fallbackTaxRate) {
+    if (!input)
+        return undefined;
+    const dist = 'distribution' in input ? input.distribution : undefined;
+    const mktBps = dist?.mktBps ?? input.mktBps ?? 10000;
+    const deflationBps = dist?.deflationBps ?? input.deflationBps ?? 0;
+    const dividendBps = dist?.dividendBps ?? input.dividendBps ?? 0;
+    const lpBps = dist?.lpBps ?? input.lpBps ?? 0;
+    const minimumShareBalance = dist?.minimumShareBalance ?? input.minimumShareBalance;
+    const buyTaxRate = input.buyTaxRate ?? fallbackTaxRate ?? 0;
+    const sellTaxRate = input.sellTaxRate ?? fallbackTaxRate ?? 0;
+    if (buyTaxRate <= 0 && sellTaxRate <= 0)
+        return undefined;
+    return {
+        taxDuration: input.taxDuration,
+        antiFarmerDuration: input.antiFarmerDuration,
+        mktBps,
+        deflationBps,
+        dividendBps,
+        lpBps,
+        minimumShareBalance,
+        buyTaxRate,
+        sellTaxRate,
+        dividendToken: input.dividendToken,
+        commissionReceiver: input.commissionReceiver,
+        vaultConfig: input.vaultConfig,
+    };
+}
+/**
+ * 构建发币 populateTransaction（优先 V6/V7，Vault 走 VaultPortal）
+ */
+export async function populateCreateTokenTransaction(params) {
+    const taxConfig = params.taxConfig;
+    const { buyTaxRate, sellTaxRate } = resolveTaxRates(taxConfig, params.taxRate);
+    const isTaxLaunch = buyTaxRate > 0 || sellTaxRate > 0;
+    // 1) Vault 金库税币
+    if (taxConfig?.vaultConfig && taxConfig.vaultConfig.vaultType !== 'none') {
+        validateTaxDistribution(taxConfig.mktBps, taxConfig.deflationBps, taxConfig.dividendBps, taxConfig.lpBps);
+        const chainKey = params.chain.toUpperCase();
+        const vaultPortalAddr = VAULT_PORTAL_ADDRESSES[chainKey];
+        if (!vaultPortalAddr) {
+            throw new Error(`链 "${params.chain}" 不支持 Tax Vault 金库功能`);
+        }
+        const vaultPortal = new Contract(vaultPortalAddr, VAULT_PORTAL_ABI, params.devWallet);
+        const { vaultFactory, vaultData } = buildVaultParams(taxConfig.vaultConfig, chainKey);
+        return vaultPortal.newTaxTokenWithVault.populateTransaction({
+            name: params.tokenInfo.name,
+            symbol: params.tokenInfo.symbol,
+            meta: params.tokenInfo.meta,
+            dexThresh: (params.dexThresh ?? 1) & 0xff,
+            salt: params.salt ?? zeroBytes32(),
+            taxRate: Math.max(buyTaxRate, sellTaxRate) & 0xffff,
+            migratorType: (params.migratorType ?? MigratorType.V2_MIGRATOR) & 0xff,
+            quoteToken: params.quoteToken || ZERO_ADDRESS,
+            quoteAmt: 0n,
+            permitData: '0x',
+            extensionID: zeroBytes32(),
+            extensionData: '0x',
+            dexId: (params.dexId ?? 0) & 0xff,
+            lpFeeProfile: (params.lpFeeProfile ?? 0) & 0xff,
+            taxDuration: BigInt(taxConfig.taxDuration),
+            antiFarmerDuration: BigInt(taxConfig.antiFarmerDuration),
+            mktBps: taxConfig.mktBps,
+            deflationBps: taxConfig.deflationBps,
+            dividendBps: taxConfig.dividendBps,
+            lpBps: taxConfig.lpBps,
+            minimumShareBalance: BigInt(taxConfig.minimumShareBalance ?? 10000) * 10n ** 18n,
+            vaultFactory,
+            vaultData,
+        });
+    }
+    // 2) 税币 V3（newTokenV6 + TOKEN_TAXED_V3）
+    if (isTaxLaunch && taxConfig) {
+        return params.originalPortal.newTokenV6.populateTransaction(buildV6TaxParams(params, taxConfig, {
+            mktBps: taxConfig.mktBps,
+            deflationBps: taxConfig.deflationBps,
+            dividendBps: taxConfig.dividendBps,
+            lpBps: taxConfig.lpBps,
+        }));
+    }
+    if (isTaxLaunch) {
+        return params.originalPortal.newTokenV6.populateTransaction(buildV6TaxParams(params, {
+            taxDuration: 365 * 24 * 60 * 60,
+            antiFarmerDuration: 3 * 24 * 60 * 60,
+            mktBps: 10000,
+            deflationBps: 0,
+            dividendBps: 0,
+            lpBps: 0,
+            buyTaxRate,
+            sellTaxRate,
+        }, { mktBps: 10000, deflationBps: 0, dividendBps: 0, lpBps: 0 }));
+    }
+    // 3) 标准 V3（newTokenV7 + TOKEN_V3_PERMIT）
+    if (params.useV3Standard) {
+        const emptyFeeConfig = {
+            feeType: FeeType.NONE,
+            bps: 0,
+            marketingAddress: ZeroAddress,
+            dividendToken: ZeroAddress,
+            minimumShareBalance: 0n,
+        };
+        return params.originalPortal.newTokenV7.populateTransaction({
+            name: params.tokenInfo.name,
+            symbol: params.tokenInfo.symbol,
+            meta: params.tokenInfo.meta,
+            dexThresh: (params.dexThresh ?? 1) & 0xff,
+            salt: params.salt ?? zeroBytes32(),
+            migratorType: MigratorType.PCS_INFINITY_CL_MIGRATOR,
+            quoteToken: params.quoteToken || ZERO_ADDRESS,
+            quoteAmt: 0n,
+            permitData: '0x',
+            extensionID: params.extensionID ?? zeroBytes32(),
+            extensionData: params.extensionData ?? '0x',
+            dexId: (params.dexId ?? 0) & 0xff,
+            buyTaxRate: 0,
+            sellTaxRate: 0,
+            taxDuration: 0n,
+            antiFarmerDuration: 0n,
+            commissionReceiver: ZeroAddress,
+            tokenVersion: TokenVersion.TOKEN_V3_PERMIT,
+            feeConfigs: [emptyFeeConfig, emptyFeeConfig, emptyFeeConfig, emptyFeeConfig],
+        });
+    }
+    // 4) 标准 V2（newTokenV6 + TOKEN_V2_PERMIT）
+    return params.originalPortal.newTokenV6.populateTransaction({
+        name: params.tokenInfo.name,
+        symbol: params.tokenInfo.symbol,
+        meta: params.tokenInfo.meta,
+        dexThresh: (params.dexThresh ?? 1) & 0xff,
+        salt: params.salt ?? zeroBytes32(),
+        migratorType: (params.migratorType ?? MigratorType.V2_MIGRATOR) & 0xff,
+        quoteToken: params.quoteToken || ZERO_ADDRESS,
+        quoteAmt: 0n,
+        beneficiary: params.beneficiary,
+        permitData: '0x',
+        extensionID: params.extensionID ?? zeroBytes32(),
+        extensionData: params.extensionData ?? '0x',
+        dexId: (params.dexId ?? 0) & 0xff,
+        lpFeeProfile: (params.lpFeeProfile ?? 0) & 0xff,
+        buyTaxRate: 0,
+        sellTaxRate: 0,
+        taxDuration: 0n,
+        antiFarmerDuration: 0n,
+        mktBps: 0,
+        deflationBps: 0,
+        dividendBps: 0,
+        lpBps: 0,
+        minimumShareBalance: 0n,
+        dividendToken: ZeroAddress,
+        commissionReceiver: ZeroAddress,
+        tokenVersion: TokenVersion.TOKEN_V2_PERMIT,
+    });
+}

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

@@ -12,8 +12,17 @@ export declare enum TokenVersion {
     TOKEN_V2_PERMIT = 2,
     TOKEN_GOPLUS = 3,
     TOKEN_TAXED = 4,
-    /** VaultPortal.newTokenV6WithVault 金库发射必须使用此版本 */
-    TOKEN_TAXED_V3 = 6
+    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,
@@ -25,7 +34,9 @@ export declare enum DexThreshType {
 }
 export declare enum MigratorType {
     V3_MIGRATOR = 0,
-    V2_MIGRATOR = 1
+    V2_MIGRATOR = 1,
+    /** PCS Infinity CL 迁移（newTokenV7 / TOKEN_V3_PERMIT） */
+    PCS_INFINITY_CL_MIGRATOR = 3
 }
 /**
  * V3 LP 费率档位