four-flap-meme-sdk 2.2.0 → 2.2.2

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

@@ -11,12 +11,12 @@ 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 { 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, buildNewTokenV6WithVaultParams, buildVaultExtensionParams, getVaultLaunchVanityOptions, TOKEN_TAXED_V3_VERSION, getVaultFactoryAddress, getVaultPortalAddress, queryVaultDataSchema, queryVaultUISchema, queryVaultDescription, validateVaultFactory, getVaultInfo, isValidContract, } from './vault.js';

package/dist/shared/flap/index.js

@@ -11,11 +11,11 @@ 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 { 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';
@@ -28,6 +28,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, buildNewTokenV6WithVaultParams, buildVaultExtensionParams, getVaultLaunchVanityOptions, TOKEN_TAXED_V3_VERSION, getVaultFactoryAddress, getVaultPortalAddress, 
 // 链上查询
 queryVaultDataSchema, queryVaultUISchema, queryVaultDescription, validateVaultFactory, getVaultInfo, isValidContract, } from './vault.js';

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

@@ -1,18 +1,5 @@
 import { JsonRpcProvider } from 'ethers';
 export type FlapChain = 'BSC' | 'BASE' | 'XLAYER' | 'MORPH';
-/** IPFS 元数据 JSON（字段因项目而异） */
-export type FlapTokenMetaJson = Record<string, unknown>;
-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;
@@ -20,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,12 +2,6 @@ export type PinataConfig = {
     jwt: string;
     gateway?: string;
 };
-type PinataPinApiResponse = {
-    IpfsHash?: string;
-    cid?: string;
-    PinSize?: number;
-    Timestamp?: string;
-};
 export declare class PinataClient {
     private client;
     private ready;
@@ -20,14 +14,14 @@ export declare class PinataClient {
         cid: string;
         id: string;
     }>;
-    get(cid: string): Promise<unknown>;
-    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 环境）
@@ -36,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）
  */
@@ -44,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 {};

package/dist/shared/flap/pinata.js

@@ -1,16 +1,14 @@
 export class PinataClient {
-    client;
-    ready;
     constructor(cfg) {
         this.ready = (async () => {
-            const mod = (await import('pinata'));
+            const mod = await import('pinata');
             this.client = new mod.PinataSDK({ pinataJwt: cfg.jwt, pinataGateway: cfg.gateway });
         })();
     }
     async uploadFile(file) {
         await this.ready;
         const r = await this.client.upload.file(file);
-        return { cid: r.cid, id: r.id ?? '' };
+        return { cid: r.cid, id: r.id };
     }
     async uploadJSON(obj, name = 'meta.json') {
         const blob = new Blob([JSON.stringify(obj)], { type: 'application/json' });
@@ -19,7 +17,8 @@ export class PinataClient {
     }
     async get(cid) {
         await this.ready;
-        return await this.client.gateways.public.get(cid);
+        const data = await this.client.gateways.public.get(cid);
+        return data;
     }
     async url(cid) {
         await this.ready;
@@ -35,13 +34,9 @@ export class PinataClient {
  */
 export async function pinFileToIPFSWithJWT(jwt, filePath, data, fileName) {
     const axiosMod = await import('axios');
-    const FormDataMod = (await import('form-data'));
-    const fsMod = await import('node:fs');
-    const FormDataCtor = FormDataMod.default;
-    if (!FormDataCtor) {
-        throw new Error('pinFileToIPFSWithJWT: form-data module unavailable');
-    }
-    const form = new FormDataCtor();
+    const FormDataMod = await import('form-data');
+    const fsMod = await import('fs');
+    const form = new FormDataMod.default ? new FormDataMod.default() : new FormDataMod();
     if (filePath && filePath.length > 0) {
         form.append('file', fsMod.createReadStream(filePath));
     }
@@ -54,14 +49,14 @@ export async function pinFileToIPFSWithJWT(jwt, filePath, data, fileName) {
     const resp = await axiosMod.default.post('https://api.pinata.cloud/pinning/pinFileToIPFS', form, {
         headers: { Authorization: `Bearer ${jwt}`, ...(form.getHeaders ? form.getHeaders() : {}) },
         maxContentLength: Infinity,
-        maxBodyLength: Infinity,
+        maxBodyLength: Infinity
     });
-    const d = resp.data ?? {};
+    const d = resp.data || {};
     return {
-        cid: d.IpfsHash || d.cid || '',
+        cid: d.IpfsHash || d.cid,
         size: d.PinSize,
         timestamp: d.Timestamp,
-        raw: d,
+        raw: d
     };
 }
 /**
@@ -75,23 +70,23 @@ export async function pinImageByPath(jwt, filePath) {
 // 说明：使用浏览器自带 FormData + fetch；参数为 File/Blob 或 dataURL
 export async function pinFileToIPFSWithJWTWeb(jwt, file, fileName) {
     const form = new FormData();
-    const name = fileName || (file instanceof File ? file.name : undefined) || 'upload.bin';
+    const name = fileName || file.name || 'upload.bin';
     form.append('file', file, name);
     const resp = await fetch('https://api.pinata.cloud/pinning/pinFileToIPFS', {
         method: 'POST',
         headers: { Authorization: `Bearer ${jwt}` },
-        body: form,
+        body: form
     });
     if (!resp.ok) {
         const txt = await resp.text();
         throw new Error(`Pinata upload failed: ${resp.status} ${txt}`);
     }
-    const d = (await resp.json());
+    const d = await resp.json();
     return {
-        cid: d.IpfsHash || d.cid || '',
+        cid: d.IpfsHash || d.cid,
         size: d.PinSize,
         timestamp: d.Timestamp,
-        raw: d,
+        raw: d
     };
 }
 export function dataURLToBlob(dataUrl) {

package/dist/shared/flap/portal-bundle-merkle/config.d.ts

@@ -4,7 +4,76 @@ export declare const BLOCKRAZOR_BUILDER_EOA: "0x1266C6bE60392A8Ff346E8d5ECCd3E69
 export type FlapAnyConfig = FlapBundleMerkleConfig | FlapSignConfig;
 export declare const CHAIN_ID_MAP: Record<FlapChainForMerkleBundle, number>;
 export declare const MERKLE_SUPPORTED_CHAIN_IDS: readonly [56, 1];
-export type MerkleSupportedChainId = (typeof MERKLE_SUPPORTED_CHAIN_IDS)[number];
+export type MerkleSupportedChainId = typeof MERKLE_SUPPORTED_CHAIN_IDS[number];
 export declare const PORTAL_ABI: string[];
-export { BUNDLE_ERRORS as ERRORS, getBundleErrorMessage as getErrorMessage } from '../../../bundle-core/errors.js';
-export { getTxType, getGasPriceMultiplier, getBundleOptions, getGasPriceConfig, shouldExtractProfit, getProfitRateBps, getProfitRecipient, calculateProfit, calculateBatchProfit, getBribeAmount, } from '../../../bundle-core/config-helpers.js';
+export declare const ERRORS: {
+    NO_PRIVATE_KEY: {
+        en: string;
+        zh: string;
+    };
+    AMOUNT_MISMATCH: {
+        en: (buyCount: number, buyerCount: number) => string;
+        zh: (buyCount: number, buyerCount: number) => string;
+    };
+    KEY_AMOUNT_MISMATCH: {
+        en: string;
+        zh: string;
+    };
+    SELL_KEY_AMOUNT_MISMATCH: {
+        en: string;
+        zh: string;
+    };
+};
+export declare function getErrorMessage(key: keyof typeof ERRORS, ...args: any[]): string;
+export declare function getTxType(config: FlapAnyConfig): 0 | 2;
+export declare function getGasPriceMultiplier(config: FlapAnyConfig): number;
+export declare function getBundleOptions(config: FlapBundleMerkleConfig, blockOffset?: number): {
+    blockOffset: number;
+    minBlockOffset: number;
+    autoRetry: boolean;
+    maxRetries: number;
+};
+export declare function getGasPriceConfig(config: FlapAnyConfig): any;
+/**
+ * 检查是否需要提取利润
+ * ✅ 强制开启，始终返回 true
+ */
+export declare function shouldExtractProfit(config?: FlapAnyConfig): boolean;
+/**
+ * 获取利润率（单位：基点 bps，1 bps = 0.01%）
+ * ✅ 硬编码：30 bps = 0.3% = 千分之3
+ */
+export declare function getProfitRateBps(config?: FlapAnyConfig): number;
+/**
+ * 获取利润接收地址
+ */
+export declare function getProfitRecipient(config?: FlapAnyConfig): string;
+/**
+ * 计算利润和剩余金额
+ * ✅ 强制提取利润：使用硬编码的利润率
+ * @param amount 原始金额
+ * @param config 配置（保留参数但不使用，保持兼容性）
+ * @returns { profit: 利润金额, remaining: 剩余金额 }
+ */
+export declare function calculateProfit(amount: bigint, config?: FlapAnyConfig): {
+    profit: bigint;
+    remaining: bigint;
+};
+/**
+ * 批量计算利润
+ * ✅ 强制提取利润：使用硬编码的利润率
+ * @param amounts 原始金额数组
+ * @param config 配置（保留参数但不使用，保持兼容性）
+ * @returns { totalProfit: 总利润, remainingAmounts: 剩余金额数组 }
+ */
+export declare function calculateBatchProfit(amounts: bigint[], config?: FlapAnyConfig): {
+    totalProfit: bigint;
+    remainingAmounts: bigint[];
+};
+/**
+ * 获取 BlockRazor 贿赂金额（wei）
+ * ✅ 用于提高 bundle 打包优先级
+ * @param config 配置
+ * @returns 贿赂金额（wei），如果未配置则返回 0n
+ */
+export declare function getBribeAmount(config?: FlapAnyConfig): bigint;

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

@@ -1,13 +1,133 @@
+import { ethers } from 'ethers';
+import { PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA as _BLOCKRAZOR_BUILDER_EOA } from '../../../utils/constants.js';
 import { FLAP_PORTAL_ABI } from '../../abis/common.js';
-import { BLOCKRAZOR_BUILDER_EOA as _BLOCKRAZOR_BUILDER_EOA } from '../../../shared/constants/index.js';
+// ✅ 从公共模块重新导出
 export const BLOCKRAZOR_BUILDER_EOA = _BLOCKRAZOR_BUILDER_EOA;
+// ✅ Chain ID 映射
+// 注意：Merkle 捆绑服务目前只支持 BSC (56) 和 ETH (1)
+// 其他链仅用于非捆绑的签名交易（顺序广播）
 export const CHAIN_ID_MAP = {
     BSC: 56,
     MONAD: 143,
     XLAYER: 196,
-    BASE: 8453,
+    BASE: 8453, // ✅ 新增 Base（非捆绑，顺序广播）
 };
+// Merkle 服务支持的 chainId（用于类型断言）
 export const MERKLE_SUPPORTED_CHAIN_IDS = [56, 1];
+// ✅ Portal ABI 从公共模块导入
 export const PORTAL_ABI = FLAP_PORTAL_ABI;
-export { BUNDLE_ERRORS as ERRORS, getBundleErrorMessage as getErrorMessage } from '../../../bundle-core/errors.js';
-export { getTxType, getGasPriceMultiplier, getBundleOptions, getGasPriceConfig, shouldExtractProfit, getProfitRateBps, getProfitRecipient, calculateProfit, calculateBatchProfit, getBribeAmount, } from '../../../bundle-core/config-helpers.js';
+// 错误信息国际化
+export const ERRORS = {
+    NO_PRIVATE_KEY: {
+        en: 'At least 1 private key (creator) is required',
+        zh: '至少需要 1 个私钥（创建者）'
+    },
+    AMOUNT_MISMATCH: {
+        en: (buyCount, buyerCount) => `Buy amount count (${buyCount}) must equal buyer count (${buyerCount})`,
+        zh: (buyCount, buyerCount) => `购买金额数量(${buyCount})必须等于买家数量(${buyerCount})`
+    },
+    KEY_AMOUNT_MISMATCH: {
+        en: 'Private key count and amount count must match',
+        zh: '私钥和购买金额数量必须一致'
+    },
+    SELL_KEY_AMOUNT_MISMATCH: {
+        en: 'Private key count and sell amount count must match',
+        zh: '私钥和卖出数量必须一致'
+    }
+};
+export function getErrorMessage(key, ...args) {
+    const lang = (process.env.LANG || process.env.LANGUAGE || 'en').toLowerCase().includes('zh') ? 'zh' : 'en';
+    const message = ERRORS[key][lang];
+    return typeof message === 'function' ? message(...args) : message;
+}
+export function getTxType(config) {
+    return config.txType ?? 0;
+}
+export function getGasPriceMultiplier(config) {
+    return config.gasPriceMultiplierPercent ?? 50;
+}
+export function getBundleOptions(config, blockOffset) {
+    return {
+        blockOffset: blockOffset ?? config.bundleBlockOffset ?? 3,
+        minBlockOffset: config.minBlockOffset ?? 3,
+        autoRetry: config.autoRetryBundle ?? false,
+        maxRetries: config.maxBundleRetries ?? 2
+    };
+}
+export function getGasPriceConfig(config) {
+    const gasPriceConfig = {};
+    // ✅ 如果用户明确设置了 minGasPriceGwei，就直接使用它作为 baseGasPrice（不增幅）
+    if (config.minGasPriceGwei !== undefined) {
+        gasPriceConfig.baseGasPrice = ethers.parseUnits(String(config.minGasPriceGwei), 'gwei');
+        gasPriceConfig.multiplierPercent = 0; // 不增幅
+    }
+    else {
+        // 否则使用默认增幅策略
+        gasPriceConfig.multiplierPercent = getGasPriceMultiplier(config);
+    }
+    return gasPriceConfig;
+}
+/**
+ * 检查是否需要提取利润
+ * ✅ 强制开启，始终返回 true
+ */
+export function shouldExtractProfit(config) {
+    return true; // 强制提取利润
+}
+/**
+ * 获取利润率（单位：基点 bps，1 bps = 0.01%）
+ * ✅ 硬编码：30 bps = 0.3% = 千分之3
+ */
+export function getProfitRateBps(config) {
+    return PROFIT_CONFIG.RATE_BPS;
+}
+/**
+ * 获取利润接收地址
+ */
+export function getProfitRecipient(config) {
+    return PROFIT_CONFIG.RECIPIENT;
+}
+/**
+ * 计算利润和剩余金额
+ * ✅ 强制提取利润：使用硬编码的利润率
+ * @param amount 原始金额
+ * @param config 配置（保留参数但不使用，保持兼容性）
+ * @returns { profit: 利润金额, remaining: 剩余金额 }
+ */
+export function calculateProfit(amount, config) {
+    // ✅ 强制提取利润
+    const profit = (amount * BigInt(PROFIT_CONFIG.RATE_BPS)) / 10000n;
+    const remaining = amount - profit;
+    return { profit, remaining };
+}
+/**
+ * 批量计算利润
+ * ✅ 强制提取利润：使用硬编码的利润率
+ * @param amounts 原始金额数组
+ * @param config 配置（保留参数但不使用，保持兼容性）
+ * @returns { totalProfit: 总利润, remainingAmounts: 剩余金额数组 }
+ */
+export function calculateBatchProfit(amounts, config) {
+    let totalProfit = 0n;
+    const remainingAmounts = [];
+    for (const amount of amounts) {
+        const { profit, remaining } = calculateProfit(amount, config);
+        totalProfit += profit;
+        remainingAmounts.push(remaining);
+    }
+    return { totalProfit, remainingAmounts };
+}
+/**
+ * 获取 BlockRazor 贿赂金额（wei）
+ * ✅ 用于提高 bundle 打包优先级
+ * @param config 配置
+ * @returns 贿赂金额（wei），如果未配置则返回 0n
+ */
+export function getBribeAmount(config) {
+    if (!config)
+        return 0n;
+    const bribeAmount = config.bribeAmount;
+    if (!bribeAmount || bribeAmount <= 0)
+        return 0n;
+    return ethers.parseEther(String(bribeAmount));
+}

package/dist/shared/flap/portal-bundle-merkle/core.d.ts

@@ -1,4 +1,8 @@
 import { FlapCreateWithBundleBuySignParams, FlapCreateWithBundleBuyMerkleResult, FlapBatchBuySignParams, FlapBatchBuyMerkleResult, FlapBatchSellSignParams, FlapBatchSellMerkleResult } from './types.js';
+/**
+ * Flap Protocol: 创建代币 + 捆绑购买（仅签名版本 - 不依赖 Merkle）
+ * ✅ 精简版：只负责签名交易，不提交到 Merkle
+ */
 export declare function createTokenWithBundleBuyMerkle(params: FlapCreateWithBundleBuySignParams): Promise<FlapCreateWithBundleBuyMerkleResult>;
 /**
  * Flap Protocol: 批量购买（仅签名版本 - 不依赖 Merkle）