four-flap-meme-sdk 2.2.19 → 2.2.20

package/dist/shared/flap/meta.js

@@ -1,10 +1,12 @@
 import { JsonRpcProvider, Contract, Interface } from 'ethers';
-import { ADDRESSES } from '../../utils/constants.js';
+import { ADDRESSES } from '../constants/index.js';
+import { getErrorMessageFromUnknown, consoleSdkLogger } from '../foundation/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/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 '../constants/index.js';
+import { consoleSdkLogger } from '../foundation/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/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';

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
+ */