four-flap-meme-sdk 2.2.19 → 3.0.0

package/dist/{shared → domains}/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/domains/flap/portal-bundle-merkle/config.d.ts

@@ -0,0 +1,10 @@
+import type { FlapBundleMerkleConfig, FlapSignConfig, FlapChainForMerkleBundle } from './types.js';
+export type { FlapBundleMerkleConfig, FlapSignConfig, FlapChainForMerkleBundle };
+export declare const BLOCKRAZOR_BUILDER_EOA: "0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20";
+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 declare const PORTAL_ABI: string[];
+export { BUNDLE_ERRORS as ERRORS, getBundleErrorMessage as getErrorMessage } from '../../../bundle/errors.js';
+export { getTxType, getGasPriceMultiplier, getBundleOptions, getGasPriceConfig, shouldExtractProfit, getProfitRateBps, getProfitRecipient, calculateProfit, calculateBatchProfit, getBribeAmount, } from '../../../bundle/config-helpers.js';

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

@@ -0,0 +1,13 @@
+import { FLAP_PORTAL_ABI } from '../../../core/shared-abis/common.js';
+import { BLOCKRAZOR_BUILDER_EOA as _BLOCKRAZOR_BUILDER_EOA } from '../../../core/constants/index.js';
+export const BLOCKRAZOR_BUILDER_EOA = _BLOCKRAZOR_BUILDER_EOA;
+export const CHAIN_ID_MAP = {
+    BSC: 56,
+    MONAD: 143,
+    XLAYER: 196,
+    BASE: 8453,
+};
+export const MERKLE_SUPPORTED_CHAIN_IDS = [56, 1];
+export const PORTAL_ABI = FLAP_PORTAL_ABI;
+export { BUNDLE_ERRORS as ERRORS, getBundleErrorMessage as getErrorMessage } from '../../../bundle/errors.js';
+export { getTxType, getGasPriceMultiplier, getBundleOptions, getGasPriceConfig, shouldExtractProfit, getProfitRateBps, getProfitRecipient, calculateProfit, calculateBatchProfit, getBribeAmount, } from '../../../bundle/config-helpers.js';

package/dist/domains/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/domains/flap/portal-bundle-merkle/core-helpers.js

@@ -0,0 +1,83 @@
+import { Contract } from 'ethers';
+import { ADDRESSES } from '../../../core/constants/index.js';
+import { CHAINS } from '../../../core/constants/index.js';
+import { V2_ROUTER_QUOTE_ABI } from '../../../core/shared-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 → domains}/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）