four-flap-meme-sdk 2.2.7 → 2.2.10

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

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

package/dist/shared/flap/constants.js

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

package/dist/shared/flap/curve.js

@@ -10,9 +10,6 @@ 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,3 +1,6 @@
+/**
+ * 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 错误信息
@@ -17,7 +20,7 @@ export type FlapErrorCode = 'TOKEN_ALREADY_EXISTS' | 'TOKEN_NOT_FOUND' | 'TOKEN_
  * }
  * ```
  */
-export declare function parseFlapError(error: unknown): FlapErrorCode | null;
+export declare function parseFlapError(error: any): FlapErrorCode | null;
 /**
  * 获取错误的友好提示信息（中文）
  *

package/dist/shared/flap/errors.js

@@ -1,7 +1,3 @@
-/**
- * Flap Protocol 错误代码
- */
-import { getErrorMessageFromUnknown } from '../foundation/normalize-unknown.js';
 /**
  * 解析 Flap Protocol 错误信息
  *
@@ -21,7 +17,7 @@ import { getErrorMessageFromUnknown } from '../foundation/normalize-unknown.js';
  * ```
  */
 export function parseFlapError(error) {
-    const msg = getFlapErrorText(error);
+    const msg = error?.message || error?.data?.message || String(error);
     const msgLower = msg.toLowerCase();
     // Token 状态相关错误
     if (msgLower.includes('token already exists') || msgLower.includes('already created')) {
@@ -64,21 +60,6 @@ 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

@@ -7,17 +7,17 @@
  * 使用时请从具体文件导入
  */
 export { FlapPortal, FlapPortalWriter, type FlapChain, // 主要的 FlapChain 定义
-type PortalConfig, type TokenStateV2, type TokenStateV3, type TokenStateV4, type TokenStateV5, type TokenStateV7, type QuoteExactInputParams, type ExactInputParams, type ExactInputV3Params, type NewTokenV3Params, type NewTokenV4Params, type NewTokenV5Params, type TaxDistributionConfig, validateTaxDistribution, TokenStatus, TokenVersion, FeeType, DexThreshType, MigratorType, V3LPFeeProfile, lpFeeProfileToV3Fee, DEXId, } from './portal.js';
+type PortalConfig, type TokenStateV2, type TokenStateV3, type TokenStateV4, type TokenStateV5, type TokenStateV7, type QuoteExactInputParams, type ExactInputParams, type ExactInputV3Params, type NewTokenV3Params, type NewTokenV4Params, type NewTokenV5Params, type TaxDistributionConfig, validateTaxDistribution, TokenStatus, TokenVersion, DexThreshType, MigratorType, V3LPFeeProfile, lpFeeProfileToV3Fee, DEXId, } from './portal.js';
 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 { MAGIC_DIVIDEND_SELF, normalizeTaxLaunchConfig, populateCreateTokenTransaction, type NormalizedTaxLaunchConfig, } from './portal-create-token.js';
+export { buildNewTokenV6Params, normalizeTaxV2Fields, NEW_TOKEN_V6_ABI, getTaxV3LaunchVanityOptions, } from './launch-v6.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, 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, buildNewTokenV6WithVaultParams, getVaultLaunchVanityOptions, TOKEN_TAXED_V3_VERSION, getVaultFactoryAddress, getVaultPortalAddress, queryVaultDataSchema, queryVaultUISchema, queryVaultDescription, validateVaultFactory, getVaultInfo, isValidContract, } from './vault.js';

package/dist/shared/flap/index.js

@@ -7,16 +7,16 @@
  * 使用时请从具体文件导入
  */
 // 核心模块 - 显式导出避免冲突
-export { FlapPortal, FlapPortalWriter, validateTaxDistribution, TokenStatus, TokenVersion, FeeType, DexThreshType, MigratorType, V3LPFeeProfile, lpFeeProfileToV3Fee, DEXId, } from './portal.js';
+export { FlapPortal, FlapPortalWriter, validateTaxDistribution, TokenStatus, TokenVersion, DexThreshType, MigratorType, V3LPFeeProfile, lpFeeProfileToV3Fee, DEXId, } from './portal.js';
 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 { MAGIC_DIVIDEND_SELF, normalizeTaxLaunchConfig, populateCreateTokenTransaction, } from './portal-create-token.js';
+export { buildNewTokenV6Params, normalizeTaxV2Fields, NEW_TOKEN_V6_ABI, getTaxV3LaunchVanityOptions, } from './launch-v6.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';
@@ -29,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, getVaultFactoryAddress, getVaultPortalAddress, 
+encodeVaultData, buildVaultParams, buildVaultExtensionParams, buildNewTokenV6WithVaultParams, getVaultLaunchVanityOptions, TOKEN_TAXED_V3_VERSION, getVaultFactoryAddress, getVaultPortalAddress, 
 // 链上查询
 queryVaultDataSchema, queryVaultUISchema, queryVaultDescription, validateVaultFactory, getVaultInfo, isValidContract, } from './vault.js';

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

@@ -0,0 +1,117 @@
+/**
+ * Flap Portal newTokenV6 参数构建（对齐官方文档）
+ * @see https://docs.flap.sh/flap/developers/token-launcher-developers/launch-token-through-portal
+ */
+import { TokenVersion } from './portal.js';
+import type { TaxV2Config } from './portal-bundle-merkle/types.js';
+export type NewTokenV6LaunchFields = {
+    name: string;
+    symbol: string;
+    meta: string;
+    dexThresh?: number;
+    salt?: string;
+    migratorType?: number;
+    quoteToken?: string;
+    quoteAmt?: bigint;
+    beneficiary: string;
+    permitData?: string;
+    extensionID?: string;
+    extensionData?: string;
+    dexId?: number;
+    lpFeeProfile?: number;
+    buyTaxRate?: number;
+    sellTaxRate?: number;
+    taxRate?: number;
+    taxDuration?: bigint | number;
+    antiFarmerDuration?: bigint | number;
+    mktBps?: number;
+    deflationBps?: number;
+    dividendBps?: number;
+    lpBps?: number;
+    minimumShareBalance?: bigint;
+    dividendToken?: string;
+    commissionReceiver?: string;
+    tokenVersion?: TokenVersion;
+};
+export type BuildNewTokenV6FromTaxV2Input = {
+    tokenInfo: {
+        name: string;
+        symbol: string;
+        meta: string;
+    };
+    taxV2: TaxV2Config;
+    beneficiary: string;
+    salt?: string;
+    taxRate?: number;
+    buyTaxRate?: number;
+    sellTaxRate?: number;
+    dexThresh?: number;
+    migratorType?: number;
+    quoteToken?: string;
+    quoteAmt?: bigint;
+    dexId?: number;
+    lpFeeProfile?: number;
+    extensionID?: string;
+    extensionData?: string;
+    commissionReceiver?: string;
+    dividendToken?: string;
+};
+/** 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)";
+export declare function normalizeTaxV2Fields(taxV2: TaxV2Config): (TaxV2Config & {
+    mktBps: number;
+    deflationBps: number;
+    dividendBps: number;
+    lpBps: number;
+    minimumShareBalance?: number;
+}) | {
+    taxDuration: number;
+    antiFarmerDuration: number;
+    mktBps: number;
+    deflationBps: number;
+    dividendBps: number;
+    lpBps: number;
+    minimumShareBalance: number | undefined;
+    vaultConfig: import("./vault.js").TaxVaultConfig | undefined;
+};
+/**
+ * 构建 Portal.newTokenV6 参数
+ * - 无税：tokenVersion = TOKEN_V2_PERMIT，税字段为 0
+ * - 高级税（无金库）：tokenVersion = TOKEN_TAXED_V3
+ */
+export declare function buildNewTokenV6Params(input: BuildNewTokenV6FromTaxV2Input | NewTokenV6LaunchFields): {
+    name: string;
+    symbol: string;
+    meta: string;
+    dexThresh: number;
+    salt: string;
+    migratorType: number;
+    quoteToken: string;
+    quoteAmt: bigint;
+    beneficiary: string;
+    permitData: string;
+    extensionID: string;
+    extensionData: string;
+    dexId: number;
+    lpFeeProfile: number;
+    buyTaxRate: number;
+    sellTaxRate: number;
+    taxDuration: bigint;
+    antiFarmerDuration: bigint;
+    mktBps: number;
+    deflationBps: number;
+    dividendBps: number;
+    lpBps: number;
+    minimumShareBalance: bigint;
+    dividendToken: string;
+    commissionReceiver: string;
+    tokenVersion: TokenVersion;
+};
+/** 高级税（无金库）Vanity：TOKEN_TAXED_V3 + 后缀 7777 */
+export declare function getTaxV3LaunchVanityOptions(chain: string): {
+    taxed: boolean;
+    taxedV3: boolean;
+    taxedV5: boolean;
+    suffix: string | undefined;
+    chain: "BSC" | "BASE" | "XLAYER" | "MORPH" | "MONAD";
+};

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

@@ -0,0 +1,111 @@
+/**
+ * Flap Portal newTokenV6 参数构建（对齐官方文档）
+ * @see https://docs.flap.sh/flap/developers/token-launcher-developers/launch-token-through-portal
+ */
+import { ZeroAddress } from 'ethers';
+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)';
+export function normalizeTaxV2Fields(taxV2) {
+    if ('distribution' in taxV2) {
+        return {
+            taxDuration: taxV2.taxDuration,
+            antiFarmerDuration: taxV2.antiFarmerDuration,
+            mktBps: taxV2.distribution.mktBps,
+            deflationBps: taxV2.distribution.deflationBps,
+            dividendBps: taxV2.distribution.dividendBps,
+            lpBps: taxV2.distribution.lpBps,
+            minimumShareBalance: taxV2.distribution.minimumShareBalance,
+            vaultConfig: taxV2.vaultConfig,
+        };
+    }
+    return taxV2;
+}
+/**
+ * 构建 Portal.newTokenV6 参数
+ * - 无税：tokenVersion = TOKEN_V2_PERMIT，税字段为 0
+ * - 高级税（无金库）：tokenVersion = TOKEN_TAXED_V3
+ */
+export function buildNewTokenV6Params(input) {
+    if ('taxV2' in input && input.taxV2) {
+        const tv2 = normalizeTaxV2Fields(input.taxV2);
+        const total = tv2.mktBps + tv2.deflationBps + tv2.dividendBps + tv2.lpBps;
+        if (total !== 10000) {
+            throw new Error(`Tax distribution must sum to 10000 (100%), got ${total}`);
+        }
+        const buyTaxRate = (input.buyTaxRate ?? input.taxRate ?? 0) & 0xffff;
+        const sellTaxRate = (input.sellTaxRate ?? input.taxRate ?? 0) & 0xffff;
+        if (buyTaxRate <= 0 || sellTaxRate <= 0) {
+            throw new Error('Tax launch requires buyTaxRate and sellTaxRate > 0');
+        }
+        return {
+            name: input.tokenInfo.name,
+            symbol: input.tokenInfo.symbol,
+            meta: input.tokenInfo.meta,
+            dexThresh: (input.dexThresh ?? 1) & 0xff,
+            salt: input.salt ?? ('0x' + '00'.repeat(32)),
+            migratorType: (input.migratorType ?? 0) & 0xff,
+            quoteToken: input.quoteToken || ZeroAddress,
+            quoteAmt: input.quoteAmt ?? 0n,
+            beneficiary: input.beneficiary,
+            permitData: '0x',
+            extensionID: input.extensionID ?? NONE_EXTENSION_ID,
+            extensionData: input.extensionData ?? '0x',
+            dexId: (input.dexId ?? 0) & 0xff,
+            lpFeeProfile: (input.lpFeeProfile ?? 0) & 0xff,
+            buyTaxRate,
+            sellTaxRate,
+            taxDuration: BigInt(tv2.taxDuration),
+            antiFarmerDuration: BigInt(tv2.antiFarmerDuration),
+            mktBps: tv2.mktBps & 0xffff,
+            deflationBps: tv2.deflationBps & 0xffff,
+            dividendBps: tv2.dividendBps & 0xffff,
+            lpBps: tv2.lpBps & 0xffff,
+            minimumShareBalance: BigInt(tv2.minimumShareBalance ?? 10000) * (10n ** 18n),
+            dividendToken: input.dividendToken ?? ZeroAddress,
+            commissionReceiver: input.commissionReceiver ?? ZeroAddress,
+            tokenVersion: TokenVersion.TOKEN_TAXED_V3,
+        };
+    }
+    const p = input;
+    const isStandard = (p.tokenVersion ?? TokenVersion.TOKEN_V2_PERMIT) === TokenVersion.TOKEN_V2_PERMIT;
+    return {
+        name: p.name,
+        symbol: p.symbol,
+        meta: p.meta,
+        dexThresh: (p.dexThresh ?? 1) & 0xff,
+        salt: p.salt ?? ('0x' + '00'.repeat(32)),
+        migratorType: (p.migratorType ?? 0) & 0xff,
+        quoteToken: p.quoteToken || ZeroAddress,
+        quoteAmt: p.quoteAmt ?? 0n,
+        beneficiary: p.beneficiary,
+        permitData: p.permitData ?? '0x',
+        extensionID: p.extensionID ?? NONE_EXTENSION_ID,
+        extensionData: p.extensionData ?? '0x',
+        dexId: (p.dexId ?? 0) & 0xff,
+        lpFeeProfile: (p.lpFeeProfile ?? 0) & 0xff,
+        buyTaxRate: isStandard ? 0 : ((p.buyTaxRate ?? p.taxRate ?? 0) & 0xffff),
+        sellTaxRate: isStandard ? 0 : ((p.sellTaxRate ?? p.taxRate ?? 0) & 0xffff),
+        taxDuration: BigInt(p.taxDuration ?? 0),
+        antiFarmerDuration: BigInt(p.antiFarmerDuration ?? 0),
+        mktBps: (p.mktBps ?? 0) & 0xffff,
+        deflationBps: (p.deflationBps ?? 0) & 0xffff,
+        dividendBps: (p.dividendBps ?? 0) & 0xffff,
+        lpBps: (p.lpBps ?? 0) & 0xffff,
+        minimumShareBalance: p.minimumShareBalance ?? 0n,
+        dividendToken: p.dividendToken ?? ZeroAddress,
+        commissionReceiver: isStandard ? ZeroAddress : (p.commissionReceiver ?? ZeroAddress),
+        tokenVersion: p.tokenVersion ?? TokenVersion.TOKEN_V2_PERMIT,
+    };
+}
+/** 高级税（无金库）Vanity：TOKEN_TAXED_V3 + 后缀 7777 */
+export function getTaxV3LaunchVanityOptions(chain) {
+    return {
+        taxed: true,
+        taxedV3: true,
+        taxedV5: false,
+        suffix: undefined,
+        chain: chain.toUpperCase(),
+    };
+}

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

@@ -1,24 +1,5 @@
 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;
@@ -26,9 +7,24 @@ export type FetchMetaOptions = {
 /**
  * 根据代币地址直接读取合约 metaURI()/meta()（IPFS CID），并拉取元数据 JSON。
  */
-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[]>;
+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;
+}>>;
 /**
  * 使用 Multicall3 批量读取 metaURI()/meta()，metaURI 优先、meta 兜底。
  */
-export declare function getFlapMetaUrisWithMulticall(provider: JsonRpcProvider, chain: FlapChain, tokenAddresses: string[], multicall3?: string, ipfsGateway?: string): Promise<FlapMetaByTokenResult[]>;
+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;
+}>>;

package/dist/shared/flap/meta.js

@@ -1,11 +1,10 @@
 import { JsonRpcProvider, Contract, Interface } from 'ethers';
-import { ADDRESSES } from '../constants/index.js';
-import { getErrorMessageFromUnknown } from '../foundation/index.js';
+import { ADDRESSES } from '../../utils/constants.js';
 const DEFAULT_GATEWAYS = {
     BSC: 'https://ipfs.io/ipfs/',
     BASE: 'https://ipfs.io/ipfs/',
     XLAYER: 'https://ipfs.io/ipfs/',
-    MORPH: 'https://ipfs.io/ipfs/',
+    MORPH: 'https://ipfs.io/ipfs/'
 };
 function normalizeCid(cidOrUrl) {
     if (!cidOrUrl)
@@ -19,10 +18,13 @@ async function fetchIpfsJson(cid, gateway) {
     const resp = await fetch(url);
     if (!resp.ok)
         throw new Error(`IPFS fetch failed: ${resp.status} ${await resp.text()}`);
-    return (await resp.json());
+    return await resp.json();
 }
 async function readCidFromToken(provider, tokenAddress) {
-    const abi = ['function metaURI() view returns (string)', 'function meta() view returns (string)'];
+    const abi = [
+        'function metaURI() view returns (string)',
+        'function meta() view returns (string)'
+    ];
     const c = new Contract(tokenAddress, abi, provider);
     try {
         const v = await c.metaURI();
@@ -91,14 +93,17 @@ export async function getFlapMetaUrisWithMulticall(provider, chain, tokenAddress
         BSC: ADDRESSES.BSC.Multicall3,
         BASE: ADDRESSES.BSC.Multicall3, // 所有链使用相同地址
         XLAYER: ADDRESSES.BSC.Multicall3,
-        MORPH: ADDRESSES.BSC.Multicall3,
+        MORPH: ADDRESSES.BSC.Multicall3
     };
     const mcAddress = multicall3 || DEFAULT_MULTICALL3[chain];
     const mcAbi = [
-        'function tryAggregate(bool requireSuccess, tuple(address target, bytes callData)[] calls) public returns (tuple(bool success, bytes returnData)[])',
+        'function tryAggregate(bool requireSuccess, tuple(address target, bytes callData)[] calls) public returns (tuple(bool success, bytes returnData)[])'
     ];
     const mc = new Contract(mcAddress, mcAbi, provider);
-    const iface = new Interface(['function metaURI() view returns (string)', 'function meta() view returns (string)']);
+    const iface = new Interface([
+        'function metaURI() view returns (string)',
+        'function meta() view returns (string)'
+    ]);
     // 第一轮：metaURI()
     const callDataMetaURI = iface.encodeFunctionData('metaURI', []);
     const calls1 = tokenAddresses.map((t) => ({ target: t, callData: callDataMetaURI }));
@@ -106,7 +111,7 @@ export async function getFlapMetaUrisWithMulticall(provider, chain, tokenAddress
     try {
         res1 = await mc.tryAggregate(false, calls1);
     }
-    catch {
+    catch (e) {
         // 如果 multicall 不可用，降级为逐个查询
         const fallbacks = await Promise.all(tokenAddresses.map(async (t) => {
             try {
@@ -114,7 +119,7 @@ export async function getFlapMetaUrisWithMulticall(provider, chain, tokenAddress
                 return { token: t, cid };
             }
             catch (err) {
-                return { token: t, error: getErrorMessageFromUnknown(err) };
+                return { token: t, error: String(err?.message || err) };
             }
         }));
         return fallbacks;
@@ -127,7 +132,7 @@ export async function getFlapMetaUrisWithMulticall(provider, chain, tokenAddress
                 const [uri] = iface.decodeFunctionResult('metaURI', r.returnData);
                 return { token: t, cid: String(uri) };
             }
-            catch {
+            catch (e) {
                 needMeta.push(t);
                 return { token: t };
             }
@@ -166,7 +171,7 @@ export async function getFlapMetaUrisWithMulticall(provider, chain, tokenAddress
                 interim[i].cid = String(uri);
             }
             catch (e) {
-                interim[i].error = getErrorMessageFromUnknown(e);
+                interim[i].error = String(e?.message || e);
             }
         }
         else {

package/dist/shared/flap/permit.js

@@ -1,6 +1,6 @@
 import { Wallet, AbiCoder, Contract, JsonRpcProvider } from 'ethers';
 import { FLAP_PORTAL_ADDRESSES } from './constants.js';
-import { CHAIN_ID_MAP } from '../constants/index.js';
+import { CHAIN } from '../../utils/constants.js';
 /**
  * 构建 Permit Piggyback 数据
  * 自动签名并使用正确的 Portal 代理地址
@@ -22,10 +22,7 @@ export async function buildPermitPiggybackAuto(chain, privateKey, tokenAddress,
     const wallet = new Wallet(privateKey);
     const owner = wallet.address;
     // 获取 chainId
-    const chainId = CHAIN_ID_MAP[chain];
-    if (chainId === undefined) {
-        throw new Error(`Unknown chain: ${chain}`);
-    }
+    const chainId = CHAIN[chain].chainId;
     // 读取代币 name（优先 override，其次链上查询，不可用时回退为空字符串）
     let tokenName = opts?.tokenNameOverride ?? '';
     if (!tokenName && opts?.rpcUrl) {

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

@@ -2,41 +2,26 @@ export type PinataConfig = {
     jwt: string;
     gateway?: string;
 };
-type JsonValue = string | number | boolean | null | JsonValue[] | {
-    [key: string]: JsonValue;
-};
-/** Pinata gateway JSON 响应（结构因 CID 内容而异） */
-export type PinataGatewayJson = {
-    [key: string]: JsonValue;
-};
-type PinataPinApiResponse = {
-    IpfsHash?: string;
-    cid?: string;
-    PinSize?: number;
-    Timestamp?: string;
-};
-export type PinataJsonUpload = {
-    [key: string]: JsonValue;
-};
 export declare class PinataClient {
     private client;
+    private ready;
     constructor(cfg: PinataConfig);
     uploadFile(file: File): Promise<{
         cid: string;
         id: string;
     }>;
-    uploadJSON(obj: PinataJsonUpload, name?: string): Promise<{
+    uploadJSON(obj: unknown, name?: string): Promise<{
         cid: string;
         id: string;
     }>;
-    get(cid: string): Promise<PinataGatewayJson>;
-    url(cid: string): Promise<string>;
+    get(cid: string): Promise<any>;
+    url(cid: string): Promise<any>;
 }
 export type PinataPinResp = {
     cid: string;
     size?: number;
     timestamp?: string;
-    raw?: PinataPinApiResponse;
+    raw?: any;
 };
 /**
  * 使用 Pinata JWT 直接上传文件（Node 环境）
@@ -45,7 +30,7 @@ export type PinataPinResp = {
  * @param data 可选：内存 Buffer（当未提供 filePath 时使用）
  * @param fileName 可选：内存数据的文件名
  */
-export declare function pinFileToIPFSWithJWT(jwt: string, filePath?: string, data?: Buffer | Uint8Array, fileName?: string): Promise<PinataPinResp>;
+export declare function pinFileToIPFSWithJWT(jwt: string, filePath?: string, data?: any, fileName?: string): Promise<PinataPinResp>;
 /**
  * 便捷方法：上传本地图片路径（返回 CID）
  */
@@ -53,4 +38,3 @@ export declare function pinImageByPath(jwt: string, filePath: string): Promise<s
 export declare function pinFileToIPFSWithJWTWeb(jwt: string, file: Blob, fileName?: string): Promise<PinataPinResp>;
 export declare function dataURLToBlob(dataUrl: string): Blob;
 export declare function pinDataURLWithJWTWeb(jwt: string, dataUrl: string, fileName?: string): Promise<PinataPinResp>;
-export {};