four-flap-meme-sdk 1.9.49 → 2.1.0

package/dist/chains/bsc/four/submit/helpers.js

@@ -1,57 +0,0 @@
-/**
- * 独立的Bundle提交方法
- *
- * 用于服务器端接收前端构建的签名交易后，提交到Merkle或BlockRazor
- * 以及 Monad 等不支持 Bundle 的链的逐笔广播
- */
-import { MerkleClient } from '../../../../shared/clients/merkle.js';
-import { ethers } from 'ethers';
-// ✅ MerkleClient 缓存（复用连接，减少初始化开销）
-const merkleClientCache = new Map();
-const CLIENT_CACHE_TTL_MS = 60 * 1000; // 60秒缓存
-/**
- * 获取或创建 MerkleClient（带缓存）
- */
-export function getMerkleClient(config) {
-    const cacheKey = `${config.apiKey}-${config.chainId ?? 56}-${config.customRpcUrl || ''}`;
-    const now = Date.now();
-    const cached = merkleClientCache.get(cacheKey);
-    if (cached && cached.expireAt > now) {
-        return cached.client;
-    }
-    // 创建新客户端并缓存
-    const client = new MerkleClient({
-        apiKey: config.apiKey,
-        chainId: config.chainId ?? 56,
-        customRpcUrl: config.customRpcUrl
-    });
-    merkleClientCache.set(cacheKey, { client, expireAt: now + CLIENT_CACHE_TTL_MS });
-    return client;
-}
-/**
- * 精简的Merkle提交配置（只包含提交需要的字段）
- */
-export function shouldTreatBroadcastErrorAsMaybeSent(msg) {
-    const m = String(msg || '').toLowerCase();
-    return (m.includes('already known') ||
-        m.includes('known transaction') ||
-        m.includes('already exists') ||
-        m.includes('nonce too low') ||
-        m.includes('nonce has already been used') ||
-        m.includes('nonce expired') ||
-        m.includes('replacement transaction underpriced'));
-}
-export async function recoverTxHashIfAlreadySeen(provider, signedTx, errorMessage) {
-    if (!shouldTreatBroadcastErrorAsMaybeSent(errorMessage))
-        return undefined;
-    try {
-        const hash = ethers.keccak256(signedTx);
-        if (!hash)
-            return undefined;
-        const tx = await provider.getTransaction(hash);
-        return tx ? hash : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}

package/dist/chains/bsc/four/submit/index.d.ts

@@ -1,12 +0,0 @@
-/**
- * Bundle 提交方法
- *
- * 拆分自 submit.ts。包括：
- * - Merkle 提交
- * - BlockRazor 提交
- * - 直接 RPC 广播
- */
-export type { MerkleSubmitConfig, SubmitBundleResult, BlockRazorSubmitConfig, BlockRazorSubmitResult, DirectSubmitConfig, DirectTxResult, DirectSubmitResult, } from './types.js';
-export { submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, } from './merkle.js';
-export { submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, } from './blockrazor.js';
-export { submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, } from './direct.js';

package/dist/chains/bsc/four/submit/index.js

@@ -1,11 +0,0 @@
-/**
- * Bundle 提交方法
- *
- * 拆分自 submit.ts。包括：
- * - Merkle 提交
- * - BlockRazor 提交
- * - 直接 RPC 广播
- */
-export { submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, } from './merkle.js';
-export { submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, } from './blockrazor.js';
-export { submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, } from './direct.js';

package/dist/chains/bsc/four/submit/merkle.d.ts

@@ -1,18 +0,0 @@
-import type { MerkleSubmitConfig, SubmitBundleResult } from './types.js';
-export declare function submitBundleToMerkle(signedTransactions: string[], config: MerkleSubmitConfig): Promise<SubmitBundleResult>;
-/**
- * 批量提交多个Bundle到Merkle（顺序执行）
- *
- * @param bundles 多个Bundle的签名交易数组
- * @param config Merkle提交配置
- * @returns Bundle提交结果数组
- */
-export declare function submitMultipleBundles(bundles: string[][], config: MerkleSubmitConfig): Promise<SubmitBundleResult[]>;
-/**
- * 并行提交多个Bundle到Merkle（适用于独立的Bundle）
- *
- * @param bundles 多个Bundle的签名交易数组
- * @param config Merkle提交配置
- * @returns Bundle提交结果数组
- */
-export declare function submitMultipleBundlesParallel(bundles: string[][], config: MerkleSubmitConfig): Promise<SubmitBundleResult[]>;

package/dist/chains/bsc/four/submit/merkle.js

@@ -1,74 +0,0 @@
-import { getMerkleClient } from './helpers.js';
-export async function submitBundleToMerkle(signedTransactions, config) {
-    try {
-        const totalTransactions = signedTransactions?.length ?? 0;
-        // 验证输入
-        if (!signedTransactions || signedTransactions.length === 0) {
-            return {
-                code: false,
-                totalTransactions,
-                error: 'signedTransactions cannot be empty'
-            };
-        }
-        if (!config.apiKey) {
-            return {
-                code: false,
-                totalTransactions,
-                error: 'apiKey is required in config'
-            };
-        }
-        // ✅ 使用缓存的 MerkleClient（复用连接 + 区块号缓存）
-        const merkle = getMerkleClient(config);
-        // 提交Bundle
-        const bundleResult = await merkle.sendBundle({
-            transactions: signedTransactions,
-            blockOffset: config.bundleBlockOffset ?? 3,
-            minBlockOffset: config.minBlockOffset ?? 3,
-            autoRetry: config.autoRetryBundle ?? false,
-            maxRetries: config.maxBundleRetries ?? 2
-        });
-        // ✅ 提交成功
-        return {
-            code: true,
-            totalTransactions,
-            bundleHash: bundleResult.bundleHash,
-            txHashes: bundleResult.txHashes,
-            targetBlock: bundleResult.targetBlock,
-            txCount: bundleResult.txCount
-        };
-    }
-    catch (error) {
-        // ❌ 提交失败
-        return {
-            code: false,
-            totalTransactions: signedTransactions?.length ?? 0,
-            error: error?.message || String(error)
-        };
-    }
-}
-/**
- * 批量提交多个Bundle到Merkle（顺序执行）
- *
- * @param bundles 多个Bundle的签名交易数组
- * @param config Merkle提交配置
- * @returns Bundle提交结果数组
- */
-export async function submitMultipleBundles(bundles, config) {
-    const results = [];
-    for (const signedTransactions of bundles) {
-        const result = await submitBundleToMerkle(signedTransactions, config);
-        results.push(result);
-    }
-    return results;
-}
-/**
- * 并行提交多个Bundle到Merkle（适用于独立的Bundle）
- *
- * @param bundles 多个Bundle的签名交易数组
- * @param config Merkle提交配置
- * @returns Bundle提交结果数组
- */
-export async function submitMultipleBundlesParallel(bundles, config) {
-    const promises = bundles.map(signedTransactions => submitBundleToMerkle(signedTransactions, config));
-    return await Promise.all(promises);
-}

package/dist/chains/bsc/four/submit/types.d.ts

@@ -1,143 +0,0 @@
-export interface MerkleSubmitConfig {
-    /** Merkle API Key（必需） */
-    apiKey: string;
-    /** 自定义RPC URL（可选） */
-    customRpcUrl?: string;
-    /** 链ID（可选，默认56=BSC） */
-    chainId?: 56 | 1;
-    /** Bundle区块偏移量（可选，默认3） */
-    bundleBlockOffset?: number;
-    /** 最小区块偏移量（可选，默认3） */
-    minBlockOffset?: number;
-    /** 是否自动重试（可选，默认false） */
-    autoRetryBundle?: boolean;
-    /** 最大重试次数（可选，默认2） */
-    maxBundleRetries?: number;
-}
-/**
- * Bundle提交结果
- */
-export interface SubmitBundleResult {
-    /** 提交状态：true=成功，false=失败 */
-    code: boolean;
-    /** 交易总数（无论成功与否都会返回） */
-    totalTransactions: number;
-    /** Bundle哈希（成功时返回） */
-    bundleHash?: string;
-    /** 交易哈希列表（成功时返回） */
-    txHashes?: string[];
-    /** 目标区块号（成功时返回） */
-    targetBlock?: number;
-    /** 交易数量（成功时返回） */
-    txCount?: number;
-    /** 错误信息（失败时返回） */
-    error?: string;
-}
-/**
- * 提交已签名的交易到Merkle（服务器端使用）
- *
- * 这个方法接收前端构建和签名好的交易，直接提交到Merkle服务
- *
- * @param signedTransactions 签名后的交易数组
- * @param config Merkle提交配置（精简版，只需要提交相关参数）
- * @returns Bundle提交结果
- *
- * @example
- * ```typescript
- * // 服务器端代码
- * import { submitBundleToMerkle } from 'four-flap-meme-sdk';
- *
- * const result = await submitBundleToMerkle(signedTransactions, {
- *   apiKey: process.env.MERKLE_API_KEY,
- *   customRpcUrl: process.env.MERKLE_RPC_URL,
- *   bundleBlockOffset: 5
- * });
- *
- * if (result.code) {
- * } else {
- *   console.error('❌ Bundle提交失败:', result.error);
- * }
- * ```
- */
-export interface BlockRazorSubmitConfig {
-    /** API Key（可选，根据 Tier 需要） */
-    apiKey?: string;
-    /** 自定义 RPC URL（用于查询区块号等，可选） */
-    customRpcUrl?: string;
-    /** Builder RPC URL（用于发送 Bundle，可选） */
-    builderRpcUrl?: string;
-    /** 区块偏移量（默认 10，最大有效区块 = 当前区块 + offset） */
-    blockOffset?: number;
-    /** 最大区块偏移量（默认 100） */
-    maxBlockOffset?: number;
-    /** 是否禁止 Bundle 合并（默认 false，允许合并可提高打包率） */
-    noMerge?: boolean;
-    /** 允许 revert 的交易哈希列表 */
-    revertingTxHashes?: string[];
-    /** 是否自动重试（默认 false） */
-    autoRetry?: boolean;
-    /** 最大重试次数（默认 3） */
-    maxRetries?: number;
-}
-/**
- * BlockRazor Bundle 提交结果
- */
-export interface BlockRazorSubmitResult {
-    /** 提交状态：true=成功，false=失败 */
-    code: boolean;
-    /** 交易总数 */
-    totalTransactions: number;
-    /** Bundle 哈希（成功时返回） */
-    bundleHash?: string;
-    /** 交易哈希列表（成功时返回） */
-    txHashes?: string[];
-    /** 最大有效区块号（成功时返回） */
-    maxBlockNumber?: number;
-    /** 交易数量（成功时返回） */
-    txCount?: number;
-    /** 错误信息（失败时返回） */
-    error?: string;
-}
-export interface DirectSubmitConfig {
-    /** RPC URL（必需） */
-    rpcUrl: string;
-    /** 链ID（可选，默认143=Monad） */
-    chainId?: number;
-    /** 链名称（可选，用于日志） */
-    chainName?: string;
-    /** 是否等待交易确认（可选，默认false） */
-    waitForConfirmation?: boolean;
-    /** 确认超时时间ms（可选，默认30000） */
-    confirmationTimeout?: number;
-}
-/**
- * 单笔交易结果
- */
-export interface DirectTxResult {
-    /** 交易索引 */
-    index: number;
-    /** 是否成功 */
-    success: boolean;
-    /** 交易哈希（成功时返回） */
-    txHash?: string;
-    /** 错误信息（失败时返回） */
-    error?: string;
-}
-/**
- * 逐笔广播提交结果
- * ✅ 统一格式：与 SubmitBundleResult 保持一致
- */
-export interface DirectSubmitResult {
-    /** 提交状态：至少有一笔成功则为true */
-    code: boolean;
-    /** 交易总数 */
-    totalTransactions: number;
-    /** Bundle哈希（非捆绑模式为 "direct"） */
-    bundleHash?: string;
-    /** 交易哈希列表（所有成功的交易） */
-    txHashes: string[];
-    /** 交易数量（同 totalTransactions，保持与捆绑模式一致） */
-    txCount?: number;
-    /** 错误信息（失败时返回） */
-    error?: string;
-}

package/dist/chains/bsc/four/swap/index.d.ts

@@ -1,32 +0,0 @@
-/**
- * Four.meme 内盘捆绑换手（Merkle Bundle）
- *
- * 功能：钱包A卖出代币 → 钱包B买入相同数量 → 原子执行
- */
-import type { FourBatchSwapResult, FourBatchSwapSignParams, FourBundleSwapSignParams, FourQuickBatchSwapResult, FourQuickBatchSwapSignParams, FourSwapResult } from './types.js';
-export type { FourBatchSwapResult, FourBatchSwapSignParams, FourBundleSwapParams, FourBundleSwapSignParams, FourQuickBatchSwapResult, FourQuickBatchSwapSignParams, FourSwapConfig, FourSwapResult, FourSwapSignConfig, UserType, } from './types.js';
-/**
- * Four内盘捆绑换手
- */
-export declare function fourBundleSwapMerkle(params: FourBundleSwapSignParams): Promise<FourSwapResult>;
-/**
- * Four 内盘批量换手（一卖多买）
- *
- * 功能：主钱包一次卖出 → 多个子钱包同时买入 → 在同一个区块中完成
- * 限制：最多 24 个买方（服务器限制 25 笔交易，包含 1 笔利润交易）
- */
-export declare function fourBatchSwapMerkle(params: FourBatchSwapSignParams): Promise<FourBatchSwapResult>;
-/**
- * Four 内盘快捷批量换手（资金利用率模式）
- *
- * 流程：[贿赂] → [卖出] → [转账多跳...] → [买入1, 买入2, ...] → [利润]
- *
- * 特点：
- * - 子钱包不需要预先有 BNB
- * - 资金来自主钱包卖出代币所得
- * - 提升资金利用率
- * - ✅ 支持转账多跳，隐藏资金流向
- *
- * 限制：根据多跳数动态计算最大买方数量
- */
-export declare function fourQuickBatchSwapMerkle(params: FourQuickBatchSwapSignParams): Promise<FourQuickBatchSwapResult>;

package/dist/chains/bsc/four/swap/types.d.ts

@@ -1,70 +0,0 @@
-import type { CommonBundleConfig } from '../../../../utils/bundle-helpers.js';
-export type UserType = 'v0' | 'v1';
-export interface FourSwapSignConfig {
-    rpcUrl: string;
-    gasLimit?: number | bigint;
-    gasLimitMultiplier?: number;
-    minGasPriceGwei?: number;
-    maxGasPriceGwei?: number;
-    txType?: 0 | 2;
-    chainId?: number;
-    reserveGasBNB?: number;
-    userType?: UserType;
-    bribeAmount?: number;
-}
-export interface FourSwapConfig extends CommonBundleConfig {
-    apiKey: string;
-    customRpcUrl?: string;
-    bundleBlockOffset?: number;
-    reserveGasBNB?: number;
-    waitForConfirmation?: boolean;
-    waitTimeoutMs?: number;
-    skipApprovalCheck?: boolean;
-}
-export interface FourBundleSwapSignParams {
-    sellerPrivateKey: string;
-    sellAmount?: string;
-    sellPercentage?: number;
-    buyerPrivateKey: string;
-    tokenAddress: string;
-    config: FourSwapSignConfig;
-    startNonces?: number[];
-}
-export interface FourBundleSwapParams {
-    sellerPrivateKey: string;
-    sellAmount?: string;
-    sellPercentage?: number;
-    buyerPrivateKey: string;
-    tokenAddress: string;
-    config: FourSwapConfig;
-}
-/**
- * ✅ Swap 结果（简化版）
- */
-export type FourSwapResult = {
-    signedTransactions: string[];
-};
-/**
- * Four 批量换手参数（一卖多买）
- */
-export interface FourBatchSwapSignParams {
-    sellerPrivateKey: string;
-}
-/**
- * Four 批量换手结果
- */
-export interface FourBatchSwapResult {
-    signedTransactions: string[];
-}
-/**
- * Four 快捷批量换手参数
- */
-export interface FourQuickBatchSwapSignParams {
-    sellerPrivateKey: string;
-}
-/**
- * Four 快捷批量换手结果
- */
-export interface FourQuickBatchSwapResult {
-    signedTransactions: string[];
-}

package/dist/chains/bsc/four/utils/index.d.ts

@@ -1,20 +0,0 @@
-import { DisperseSignParams, DisperseMerkleResult, SweepSignParams, SweepMerkleResult, PairwiseTransferSignParams, PairwiseTransferMerkleResult } from '../types.js';
-/**
- * 分发（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
- */
-export declare function disperseWithBundleMerkle(params: DisperseSignParams): Promise<DisperseMerkleResult>;
-/**
- * 归集（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
- */
-export declare function sweepWithBundleMerkle(params: SweepSignParams): Promise<SweepMerkleResult>;
-/**
- * 多对多（地址一一对应）转账（仅签名版本 - 不依赖 Merkle）
- * - 支持原生币 / ERC20
- * - 支持多跳（逐对）
- * - 支持利润刮取：利润由第一个 sender 支付（作为额外费用，不扣减每对转账金额）
- */
-export declare function pairwiseTransferWithBundleMerkle(params: PairwiseTransferSignParams): Promise<PairwiseTransferMerkleResult>;