four-flap-meme-sdk 2.2.19 → 3.0.0

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

@@ -0,0 +1,81 @@
+import type { GeneratedWallet } from '../../utils/wallet.js';
+export interface DirectRouterSignConfig {
+    rpcUrl: string;
+    chainId?: number;
+    gasLimit?: number | bigint;
+    gasLimitMultiplier?: number;
+    gasPrice?: bigint;
+    minGasPriceGwei?: number;
+    maxGasPriceGwei?: number;
+    txType?: 0 | 2;
+    /** 是否跳过授权检查 */
+    skipApprovalCheck?: boolean;
+    /** 滑点（基点），默认 100 = 1% */
+    slippageBps?: number;
+    /** BlockRazor 贿赂金额（BNB），仅 BSC 链有效，用于提高 bundle 打包优先级 */
+    bribeAmount?: number;
+    /** ✅ 利润模式：'single'（默认，从最大钱包统一扣）或 'distributed'（每个钱包独立扣） */
+    profitMode?: 'single' | 'distributed';
+    /** ✅ 是否跳过利润扣除（EOA 普通模式使用） */
+    skipProfit?: boolean;
+}
+export interface DirectV2BuyParams {
+    chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
+    privateKeys: string[];
+    buyAmounts: string[];
+    tokenAddress: string;
+    routerAddress: string;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    startNonces?: number[];
+    config: DirectRouterSignConfig;
+}
+export interface DirectV2SellParams {
+    chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
+    privateKeys: string[];
+    sellPercentages?: number[];
+    sellAmounts?: string[];
+    startNonces?: number[];
+    tokenAddress: string;
+    tokenDecimals?: number;
+    routerAddress: string;
+    quoteToken?: string;
+    config: DirectRouterSignConfig;
+}
+export interface DirectV3BuyParams {
+    chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
+    privateKeys: string[];
+    buyAmounts: string[];
+    tokenAddress: string;
+    routerAddress: string;
+    fee: number;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    startNonces?: number[];
+    config: DirectRouterSignConfig;
+}
+export interface DirectV3SellParams {
+    chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
+    privateKeys: string[];
+    sellPercentages?: number[];
+    sellAmounts?: string[];
+    tokenAddress: string;
+    tokenDecimals?: number;
+    routerAddress: string;
+    fee: number;
+    quoteToken?: string;
+    startNonces?: number[];
+    config: DirectRouterSignConfig;
+}
+export interface DirectRouterResult {
+    signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        profitMode?: 'single' | 'distributed';
+        profitAmount: string;
+        profitRecipient: string;
+        totalFlow: string;
+    };
+}
+export type DexKey = 'PANCAKESWAP' | 'UNISWAP' | 'POTATOSWAP' | 'DYORSWAP' | 'IROSWAP';
+export type RouterVersion = 'v2' | 'v3';

package/dist/domains/dex/types.js

@@ -0,0 +1 @@
+export {};

package/dist/{shared → domains}/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 → domains}/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 '../../core/constants/index.js';

package/dist/{shared → domains}/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 '../../core/constants/index.js';

package/dist/{shared → domains}/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 → domains}/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 → domains}/flap/errors.js

@@ -1,3 +1,7 @@
+/**
+ * Flap Protocol 错误代码
+ */
+import { getErrorMessageFromUnknown } from '../../core/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/domains/flap/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Flap domain public facade
+ */
+export { FlapPortal, FlapPortalWriter, type TokenStateV7, V3LPFeeProfile, lpFeeProfileToV3Fee, FLAP_TOTAL_SUPPLY, } from './module.js';
+export { flapBundleSwapMerkle, flapBatchSwapMerkle, flapQuickBatchSwapMerkle, flapCrossSwapMerkle, flapBundleBuyFirstMerkle, flapDisperseWithBundleMerkle, flapSweepWithBundleMerkle, createTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle, batchSellWithBundleMerkle, flapBundleCreateToDex, } from './portal-bundle-merkle/index.js';
+export type { FlapSwapSignConfig, FlapSwapConfig, FlapBundleSwapSignParams, FlapBundleSwapParams, FlapSwapResult, FlapBatchSwapSignParams, FlapBatchSwapResult, FlapQuickBatchSwapSignParams, FlapQuickBatchSwapResult, FlapCrossSwapParams, FlapCrossSwapResult, UserType as FlapSwapUserType, FlapBuyFirstSignConfig, FlapBuyFirstConfig, FlapBundleBuyFirstSignParams, FlapBundleBuyFirstParams, FlapBuyFirstResult, FlapDisperseSignParams, FlapDisperseMerkleResult, FlapSweepSignParams, FlapSweepMerkleResult, } from './portal-bundle-merkle/index.js';
+export type { FlapChain } from './portal.js';

package/dist/domains/flap/index.js

@@ -0,0 +1,5 @@
+/**
+ * Flap domain public facade
+ */
+export { FlapPortal, FlapPortalWriter, V3LPFeeProfile, lpFeeProfileToV3Fee, FLAP_TOTAL_SUPPLY, } from './module.js';
+export { flapBundleSwapMerkle, flapBatchSwapMerkle, flapQuickBatchSwapMerkle, flapCrossSwapMerkle, flapBundleBuyFirstMerkle, flapDisperseWithBundleMerkle, flapSweepWithBundleMerkle, createTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle, batchSellWithBundleMerkle, flapBundleCreateToDex, } from './portal-bundle-merkle/index.js';

package/dist/{shared → domains}/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[]>;

package/dist/{shared → domains}/flap/meta.js

@@ -1,10 +1,12 @@
 import { JsonRpcProvider, Contract, Interface } from 'ethers';
-import { ADDRESSES } from '../../utils/constants.js';
+import { ADDRESSES } from '../../core/constants/index.js';
+import { getErrorMessageFromUnknown, consoleSdkLogger } from '../../core/index.js';
+const sdkLogger = consoleSdkLogger;
 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)
@@ -18,26 +20,27 @@ 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();
         if (typeof v === 'string' && v.length > 0)
             return v;
     }
-    catch { }
+    catch (error) {
+        sdkLogger.debug?.('[Flap meta] metaURI() 读取失败，尝试 fallback 到 meta()', getErrorMessageFromUnknown(error));
+    }
     try {
         const v = await c.meta();
         if (typeof v === 'string' && v.length > 0)
             return v;
     }
-    catch { }
+    catch (error) {
+        sdkLogger.debug?.('[Flap meta] meta() 读取失败', getErrorMessageFromUnknown(error));
+    }
     return undefined;
 }
 /**
@@ -54,12 +57,15 @@ export async function getFlapMetaByAddress(chain, rpcUrl, tokenAddress, opts = {
                 const data = await fetchIpfsJson(onChainCid, gateway);
                 return { cid: onChainCid, data };
             }
-            catch {
+            catch (error) {
+                sdkLogger.debug?.('[Flap meta] 获取 on-chain CID 对应 IPFS JSON 失败，回退仅返回 CID', getErrorMessageFromUnknown(error));
                 return { cid: onChainCid };
             }
         }
     }
-    catch { }
+    catch (error) {
+        sdkLogger.debug?.('[Flap meta] 直接读取 on-chain CID 失败', getErrorMessageFromUnknown(error));
+    }
     return undefined;
 }
 export async function getFlapMetasByAddresses(chain, rpcUrl, tokenAddresses, opts = {}) {
@@ -78,7 +84,8 @@ export async function getFlapMetasByAddresses(chain, rpcUrl, tokenAddresses, opt
             const data = await fetchIpfsJson(u.cid, gateway);
             return { token: u.token, cid: u.cid, data };
         }
-        catch {
+        catch (error) {
+            sdkLogger.debug?.('[Flap meta] 批量拉取 IPFS JSON 失败，回退 imageUrl', getErrorMessageFromUnknown(error));
             return { token: u.token, cid: u.cid, imageUrl: `${gateway}${normalizeCid(u.cid)}` };
         }
     }));
@@ -93,17 +100,14 @@ 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 }));
@@ -111,7 +115,8 @@ export async function getFlapMetaUrisWithMulticall(provider, chain, tokenAddress
     try {
         res1 = await mc.tryAggregate(false, calls1);
     }
-    catch (e) {
+    catch (error) {
+        sdkLogger.debug?.('[Flap meta] multicall metaURI() 失败，降级逐个查询', getErrorMessageFromUnknown(error));
         // 如果 multicall 不可用，降级为逐个查询
         const fallbacks = await Promise.all(tokenAddresses.map(async (t) => {
             try {
@@ -119,7 +124,7 @@ export async function getFlapMetaUrisWithMulticall(provider, chain, tokenAddress
                 return { token: t, cid };
             }
             catch (err) {
-                return { token: t, error: String(err?.message || err) };
+                return { token: t, error: getErrorMessageFromUnknown(err) };
             }
         }));
         return fallbacks;
@@ -132,7 +137,8 @@ export async function getFlapMetaUrisWithMulticall(provider, chain, tokenAddress
                 const [uri] = iface.decodeFunctionResult('metaURI', r.returnData);
                 return { token: t, cid: String(uri) };
             }
-            catch (e) {
+            catch (error) {
+                sdkLogger.debug?.('[Flap meta] decode metaURI() 失败，回退到 meta()', getErrorMessageFromUnknown(error));
                 needMeta.push(t);
                 return { token: t };
             }
@@ -150,7 +156,8 @@ export async function getFlapMetaUrisWithMulticall(provider, chain, tokenAddress
                 const data = await fetchIpfsJson(x.cid, gateway);
                 return { ...x, data };
             }
-            catch {
+            catch (error) {
+                sdkLogger.debug?.('[Flap meta] enrich metaURI 数据失败，回退 imageUrl', getErrorMessageFromUnknown(error));
                 return { ...x, imageUrl: `${gateway}${normalizeCid(x.cid)}` };
             }
         }));
@@ -171,7 +178,7 @@ export async function getFlapMetaUrisWithMulticall(provider, chain, tokenAddress
                 interim[i].cid = String(uri);
             }
             catch (e) {
-                interim[i].error = String(e?.message || e);
+                interim[i].error = getErrorMessageFromUnknown(e);
             }
         }
         else {
@@ -187,7 +194,8 @@ export async function getFlapMetaUrisWithMulticall(provider, chain, tokenAddress
             const data = await fetchIpfsJson(x.cid, gateway);
             return { ...x, data };
         }
-        catch {
+        catch (error) {
+            sdkLogger.debug?.('[Flap meta] enrich meta 数据失败，回退 imageUrl', getErrorMessageFromUnknown(error));
             return { ...x, imageUrl: `${gateway}${normalizeCid(x.cid)}` };
         }
     }));

package/dist/{shared/flap/index.d.ts → domains/flap/module.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 → domains/flap/module.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 → domains}/flap/permit.js

@@ -1,6 +1,8 @@
 import { Wallet, AbiCoder, Contract, JsonRpcProvider } from 'ethers';
 import { FLAP_PORTAL_ADDRESSES } from './constants.js';
-import { CHAIN } from '../../utils/constants.js';
+import { CHAIN_ID_MAP } from '../../core/constants/index.js';
+import { consoleSdkLogger } from '../../core/index.js';
+const sdkLogger = consoleSdkLogger;
 /**
  * 构建 Permit Piggyback 数据
  * 自动签名并使用正确的 Portal 代理地址
@@ -22,7 +24,10 @@ export async function buildPermitPiggybackAuto(chain, privateKey, tokenAddress,
     const wallet = new Wallet(privateKey);
     const owner = wallet.address;
     // 获取 chainId
-    const chainId = CHAIN[chain].chainId;
+    const chainId = CHAIN_ID_MAP[chain];
+    if (chainId === undefined) {
+        throw new Error(`Unknown chain: ${chain}`);
+    }
     // 读取代币 name（优先 override，其次链上查询，不可用时回退为空字符串）
     let tokenName = opts?.tokenNameOverride ?? '';
     if (!tokenName && opts?.rpcUrl) {
@@ -30,7 +35,9 @@ export async function buildPermitPiggybackAuto(chain, privateKey, tokenAddress,
             const erc20 = new Contract(tokenAddress, ['function name() view returns (string)'], new JsonRpcProvider(opts.rpcUrl));
             tokenName = await erc20.name();
         }
-        catch { }
+        catch (error) {
+            sdkLogger.debug?.('[Flap permit] 读取 token name 失败，回退为空字符串签名域', error);
+        }
     }
     // 构建 EIP-2612 Permit 消息（name 可能为空字符串，符合部分实现）
     const domain = {

package/dist/{shared → domains}/flap/pinata.d.ts

@@ -2,26 +2,41 @@ 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: unknown, name?: string): Promise<{
+    uploadJSON(obj: PinataJsonUpload, name?: string): Promise<{
         cid: string;
         id: string;
     }>;
-    get(cid: string): Promise<any>;
-    url(cid: string): Promise<any>;
+    get(cid: string): Promise<PinataGatewayJson>;
+    url(cid: string): Promise<string>;
 }
 export type PinataPinResp = {
     cid: string;
     size?: number;
     timestamp?: string;
-    raw?: any;
+    raw?: PinataPinApiResponse;
 };
 /**
  * 使用 Pinata JWT 直接上传文件（Node 环境）
@@ -30,7 +45,7 @@ export type PinataPinResp = {
  * @param data 可选：内存 Buffer（当未提供 filePath 时使用）
  * @param fileName 可选：内存数据的文件名
  */
-export declare function pinFileToIPFSWithJWT(jwt: string, filePath?: string, data?: any, fileName?: string): Promise<PinataPinResp>;
+export declare function pinFileToIPFSWithJWT(jwt: string, filePath?: string, data?: Buffer | Uint8Array, fileName?: string): Promise<PinataPinResp>;
 /**
  * 便捷方法：上传本地图片路径（返回 CID）
  */
@@ -38,3 +53,4 @@ 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 {};