four-flap-meme-sdk 1.9.49 → 2.0.0

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

@@ -1,5 +1,18 @@
 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;
@@ -7,24 +20,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?: unknown;
-} | undefined>;
-export declare function getFlapMetasByAddresses(chain: FlapChain, rpcUrl: string, tokenAddresses: string[], opts?: FetchMetaOptions): Promise<Array<{
-    token: string;
-    cid?: string;
-    data?: unknown;
-    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?: unknown;
-    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,30 +19,23 @@ 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 {
-        void 0;
-    }
+    catch { }
     try {
         const v = await c.meta();
         if (typeof v === 'string' && v.length > 0)
             return v;
     }
-    catch {
-        void 0;
-    }
+    catch { }
     return undefined;
 }
 /**
@@ -63,9 +57,7 @@ export async function getFlapMetaByAddress(chain, rpcUrl, tokenAddress, opts = {
             }
         }
     }
-    catch {
-        void 0;
-    }
+    catch { }
     return undefined;
 }
 export async function getFlapMetasByAddresses(chain, rpcUrl, tokenAddresses, opts = {}) {
@@ -99,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 }));
@@ -125,8 +114,7 @@ export async function getFlapMetaUrisWithMulticall(provider, chain, tokenAddress
                 return { token: t, cid };
             }
             catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                return { token: t, error: msg };
+                return { token: t, error: getErrorMessageFromUnknown(err) };
             }
         }));
         return fallbacks;
@@ -177,8 +165,8 @@ export async function getFlapMetaUrisWithMulticall(provider, chain, tokenAddress
                 const [uri] = iface.decodeFunctionResult('meta', r.returnData);
                 interim[i].cid = String(uri);
             }
-            catch {
-                interim[i].error = 'decode meta() failed';
+            catch (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) {
@@ -30,9 +33,7 @@ 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 {
-            void 0;
-        }
+        catch { }
     }
     // 构建 EIP-2612 Permit 消息（name 可能为空字符串，符合部分实现）
     const domain = {

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

@@ -2,6 +2,12 @@ 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;
@@ -21,7 +27,7 @@ export type PinataPinResp = {
     cid: string;
     size?: number;
     timestamp?: string;
-    raw?: Record<string, unknown>;
+    raw?: PinataPinApiResponse;
 };
 /**
  * 使用 Pinata JWT 直接上传文件（Node 环境）
@@ -30,7 +36,7 @@ export type PinataPinResp = {
  * @param data 可选：内存 Buffer（当未提供 filePath 时使用）
  * @param fileName 可选：内存数据的文件名
  */
-export declare function pinFileToIPFSWithJWT(jwt: string, filePath?: string, data?: Blob | Buffer, fileName?: string): Promise<PinataPinResp>;
+export declare function pinFileToIPFSWithJWT(jwt: string, filePath?: string, data?: Buffer | Uint8Array, fileName?: string): Promise<PinataPinResp>;
 /**
  * 便捷方法：上传本地图片路径（返回 CID）
  */
@@ -38,3 +44,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,15 +1,16 @@
 export class PinataClient {
+    client;
+    ready;
     constructor(cfg) {
         this.ready = (async () => {
-            const mod = await import('pinata');
-            const PinataSDK = mod.PinataSDK;
-            this.client = new PinataSDK({ pinataJwt: cfg.jwt, pinataGateway: cfg.gateway });
+            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' });
@@ -18,8 +19,7 @@ export class PinataClient {
     }
     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;
@@ -35,9 +35,12 @@ 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('fs');
-    const FormDataCtor = (FormDataMod.default ?? FormDataMod);
+    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();
     if (filePath && filePath.length > 0) {
         form.append('file', fsMod.createReadStream(filePath));
@@ -51,14 +54,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 ?? {};
     return {
-        cid: d.IpfsHash ?? d.cid ?? "",
+        cid: d.IpfsHash || d.cid || '',
         size: d.PinSize,
         timestamp: d.Timestamp,
-        raw: d
+        raw: d,
     };
 }
 /**
@@ -72,24 +75,23 @@ export async function pinImageByPath(jwt, filePath) {
 // 说明：使用浏览器自带 FormData + fetch；参数为 File/Blob 或 dataURL
 export async function pinFileToIPFSWithJWTWeb(jwt, file, fileName) {
     const form = new FormData();
-    const inferredName = file.name;
-    const name = fileName || inferredName || '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';

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

@@ -0,0 +1,32 @@
+import { JsonRpcProvider } from 'ethers';
+import { FlapAnyConfig } from './config.js';
+import { FlapCreateWithBundleBuySignParams } from './types.js';
+export declare const MULTICALL3_ADDRESS: "0xcA11bde05977b3631167028862bE2a173976CA11";
+export declare const BSC_PANCAKE_V2_ROUTER: "0x10ED43C718714eb63d5aA57B78B54704E256024E";
+export declare const BSC_WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
+export declare const MONAD_PANCAKE_V2_ROUTER = "0xb1bc24c34e88f7d43d5923034e3a14b24daacff9";
+export declare const MONAD_WMON: "0x3bd359c1119da7da1d913d1c4d2b7c461115433a";
+export declare const XLAYER_POTATOSWAP_V2_ROUTER: "0x881fb2f98c13d521009464e7d1cbf16e1b394e8e";
+export declare const XLAYER_WOKB: "0xe538905cf8410324e03a5a23c1c177a474d59b2b";
+export declare const ROUTER_ABI: string[];
+/**
+ * 获取 ERC20 代币 → 原生代币的报价
+ * @param provider - Provider 实例
+ * @param tokenAddress - ERC20 代币地址
+ * @param tokenAmount - 代币数量（wei）
+ * @param chainId - 链 ID（56=BSC, 143=Monad）
+ * @returns 等值的原生代币数量（wei），失败返回 0n
+ */
+export declare function getTokenToNativeQuote(provider: JsonRpcProvider, tokenAddress: string, tokenAmount: bigint, chainId: number): Promise<bigint>;
+export type FlapChain = FlapCreateWithBundleBuySignParams['chain'];
+/**
+ * 获取 Gas Limit
+ * 优先使用 config.gasLimit，否则使用默认值 * multiplier
+ *
+ * ✅ ethers v6 最佳实践：直接使用 bigint 类型
+ */
+export declare function getGasLimit(config: FlapAnyConfig, defaultGas?: number): bigint;
+/**
+ * Flap Protocol: 创建代币 + 捆绑购买（仅签名版本 - 不依赖 Merkle）
+ * ✅ 精简版：只负责签名交易，不提交到 Merkle
+ */

package/dist/shared/flap/portal-bundle-merkle/core-helpers.js

@@ -0,0 +1,83 @@
+import { Contract } from 'ethers';
+import { ADDRESSES } from '../../../shared/constants/index.js';
+import { CHAINS } from '../../constants/index.js';
+import { V2_ROUTER_QUOTE_ABI } from '../../abis/common.js';
+// ✅ 常量
+export const MULTICALL3_ADDRESS = ADDRESSES.BSC.Multicall3;
+// ==================== ERC20 → 原生代币报价 ====================
+// BSC 链常量
+export const BSC_PANCAKE_V2_ROUTER = ADDRESSES.BSC.PancakeV2Router;
+export const BSC_WBNB = ADDRESSES.BSC.WBNB;
+// ✅ Monad 链常量
+export const MONAD_PANCAKE_V2_ROUTER = '0xb1bc24c34e88f7d43d5923034e3a14b24daacff9';
+export const MONAD_WMON = ADDRESSES.MONAD.WMON;
+// ✅ XLAYER 链常量（PotatoSwap V2）
+export const XLAYER_POTATOSWAP_V2_ROUTER = ADDRESSES.XLAYER.PotatoSwapV2Router;
+export const XLAYER_WOKB = ADDRESSES.XLAYER.WOKB;
+export const ROUTER_ABI = V2_ROUTER_QUOTE_ABI;
+/**
+ * 获取 ERC20 代币 → 原生代币的报价
+ * @param provider - Provider 实例
+ * @param tokenAddress - ERC20 代币地址
+ * @param tokenAmount - 代币数量（wei）
+ * @param chainId - 链 ID（56=BSC, 143=Monad）
+ * @returns 等值的原生代币数量（wei），失败返回 0n
+ */
+export async function getTokenToNativeQuote(provider, tokenAddress, tokenAmount, chainId) {
+    if (tokenAmount <= 0n)
+        return 0n;
+    try {
+        if (chainId === CHAINS.BSC.chainId) {
+            // BSC: 使用 PancakeSwap V2 Router
+            const router = new Contract(BSC_PANCAKE_V2_ROUTER, ROUTER_ABI, provider);
+            const amounts = await router.getAmountsOut(tokenAmount, [tokenAddress, BSC_WBNB]);
+            return amounts[1];
+        }
+        if (chainId === CHAINS.MONAD.chainId) {
+            // ✅ Monad: 使用 PancakeSwap V2 Router
+            const router = new Contract(MONAD_PANCAKE_V2_ROUTER, ROUTER_ABI, provider);
+            const amounts = await router.getAmountsOut(tokenAmount, [tokenAddress, MONAD_WMON]);
+            return amounts[1];
+        }
+        if (chainId === CHAINS.XLAYER.chainId) {
+            // ✅ XLAYER: 使用 PotatoSwap V2 Router（USDT0 → WOKB）
+            const router = new Contract(XLAYER_POTATOSWAP_V2_ROUTER, ROUTER_ABI, provider);
+            const amounts = await router.getAmountsOut(tokenAmount, [tokenAddress, XLAYER_WOKB]);
+            return amounts[1];
+        }
+        if (chainId === CHAINS.BASE.chainId) {
+            // ✅ Base: 目前大部分 Flap 交易使用 ETH（原生代币），ERC20 报价暂不支持
+            // Base 主力 DEX 是 Uniswap V3，V2 Router 流动性有限，暂返回 0
+            // TODO: 后续可接入 Uniswap V3 QuoterV2 进行精确报价
+            return 0n;
+        }
+        // 其他链暂不支持报价，返回 0
+        return 0n;
+    }
+    catch {
+        // 报价失败返回 0（可能是流动性不足或路径不存在）
+        return 0n;
+    }
+}
+/**
+ * 获取 Gas Limit
+ * 优先使用 config.gasLimit，否则使用默认值 * multiplier
+ *
+ * ✅ ethers v6 最佳实践：直接使用 bigint 类型
+ */
+export function getGasLimit(config, defaultGas = 800000) {
+    // 优先使用前端传入的 gasLimit
+    if (config.gasLimit !== undefined) {
+        // 如果已经是 bigint，直接返回；否则转换
+        return typeof config.gasLimit === 'bigint' ? config.gasLimit : BigInt(config.gasLimit);
+    }
+    // 使用默认值 * multiplier
+    const multiplier = config.gasLimitMultiplier ?? 1.0;
+    const calculatedGas = Math.ceil(defaultGas * multiplier);
+    // JavaScript 原生 BigInt 转换（ethers v6 兼容）
+    return BigInt(calculatedGas);
+}
+/**
+ * Flap Protocol: 创建代币 + 捆绑购买（仅签名版本 - 不依赖 Merkle）
+ * ✅ 精简版：只负责签名交易，不提交到 Merkle
+ */

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

@@ -1,8 +1,4 @@
 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）