four-flap-meme-sdk 2.2.2 → 2.2.3

package/dist/shared/flap/errors.js

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

@@ -7,16 +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, 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, FeeType, 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 { 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, buildNewTokenV6WithVaultParams, buildVaultExtensionParams, 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

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

package/dist/shared/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/flap/meta.js

@@ -1,10 +1,11 @@
 import { JsonRpcProvider, Contract, Interface } from 'ethers';
-import { ADDRESSES } from '../../utils/constants.js';
+import { ADDRESSES } from '../constants/index.js';
+import { getErrorMessageFromUnknown } from '../foundation/index.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)
@@ -18,13 +19,10 @@ 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();
@@ -93,17 +91,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 +106,7 @@ export async function getFlapMetaUrisWithMulticall(provider, chain, tokenAddress
     try {
         res1 = await mc.tryAggregate(false, calls1);
     }
-    catch (e) {
+    catch {
         // 如果 multicall 不可用，降级为逐个查询
         const fallbacks = await Promise.all(tokenAddresses.map(async (t) => {
             try {
@@ -119,7 +114,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 +127,7 @@ export async function getFlapMetaUrisWithMulticall(provider, chain, tokenAddress
                 const [uri] = iface.decodeFunctionResult('metaURI', r.returnData);
                 return { token: t, cid: String(uri) };
             }
-            catch (e) {
+            catch {
                 needMeta.push(t);
                 return { token: t };
             }
@@ -171,7 +166,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 {

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 } from '../../utils/constants.js';
+import { CHAIN_ID_MAP } from '../constants/index.js';
 /**
  * 构建 Permit Piggyback 数据
  * 自动签名并使用正确的 Portal 代理地址
@@ -22,7 +22,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) {

package/dist/shared/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 {};

package/dist/shared/flap/pinata.js

@@ -1,14 +1,15 @@
+import { createReadStream } from 'node:fs';
+import axios from 'axios';
+import NodeFormData from 'form-data';
+import { PinataSDK } from 'pinata';
 export class PinataClient {
+    client;
     constructor(cfg) {
-        this.ready = (async () => {
-            const mod = await import('pinata');
-            this.client = new mod.PinataSDK({ pinataJwt: cfg.jwt, pinataGateway: cfg.gateway });
-        })();
+        this.client = new 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' });
@@ -16,12 +17,9 @@ export class PinataClient {
         return await this.uploadFile(file);
     }
     async get(cid) {
-        await this.ready;
-        const data = await this.client.gateways.public.get(cid);
-        return data;
+        return await this.client.gateways.public.get(cid);
     }
     async url(cid) {
-        await this.ready;
         return await this.client.gateways.convert(cid);
     }
 }
@@ -33,12 +31,9 @@ export class PinataClient {
  * @param fileName 可选：内存数据的文件名
  */
 export async function pinFileToIPFSWithJWT(jwt, filePath, data, fileName) {
-    const axiosMod = await import('axios');
-    const FormDataMod = await import('form-data');
-    const fsMod = await import('fs');
-    const form = new FormDataMod.default ? new FormDataMod.default() : new FormDataMod();
+    const form = new NodeFormData();
     if (filePath && filePath.length > 0) {
-        form.append('file', fsMod.createReadStream(filePath));
+        form.append('file', createReadStream(filePath));
     }
     else if (data) {
         form.append('file', data, { filename: fileName || 'upload.bin' });
@@ -46,17 +41,17 @@ export async function pinFileToIPFSWithJWT(jwt, filePath, data, fileName) {
     else {
         throw new Error('pinFileToIPFSWithJWT: either filePath or data must be provided');
     }
-    const resp = await axiosMod.default.post('https://api.pinata.cloud/pinning/pinFileToIPFS', form, {
-        headers: { Authorization: `Bearer ${jwt}`, ...(form.getHeaders ? form.getHeaders() : {}) },
+    const resp = await axios.post('https://api.pinata.cloud/pinning/pinFileToIPFS', form, {
+        headers: { Authorization: `Bearer ${jwt}`, ...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,
     };
 }
 /**
@@ -70,23 +65,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.name || 'upload.bin';
+    const name = fileName || (file instanceof File ? file.name : undefined) || '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,76 +4,7 @@ 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 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;
+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';

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

@@ -1,133 +1,13 @@
-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（非捆绑，顺序广播）
+    BASE: 8453,
 };
-// Merkle 服务支持的 chainId（用于类型断言）
 export const MERKLE_SUPPORTED_CHAIN_IDS = [56, 1];
-// ✅ Portal ABI 从公共模块导入
 export const PORTAL_ABI = FLAP_PORTAL_ABI;
-// 错误信息国际化
-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));
-}
+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';