four-flap-meme-sdk 2.0.0 → 2.1.0

package/dist/chains/bsc/four/pairwise.js

@@ -1,308 +0,0 @@
-import { ethers, Wallet } from 'ethers';
-import { getOptimizedGasPrice, NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT, buildGasFields } from '../../../utils/bundle-helpers.js';
-import { BLOCKRAZOR_BUILDER_EOA, calculateTransferFee } from '../../../utils/constants.js';
-import { GAS_LIMITS, CHAINS } from '../../../shared/constants/index.js';
-import { getTxType, getGasPriceConfig, shouldExtractProfit, getProfitRecipient, getBribeAmount } from './config.js';
-// ==================== Gas 常量（使用统一常量） ====================
-const NATIVE_TRANSFER_GAS_LIMIT = GAS_LIMITS.NATIVE_TRANSFER;
-const BRIBE_GAS_LIMIT = GAS_LIMITS.BRIBE;
-import { getErc20DecimalsMerkle as _getErc20DecimalsMerkle, generateHopWallets as _generateHopWallets, calculateGasLimit as _calculateGasLimit, isNativeTokenAddress as _isNativeTokenAddress } from './internal.js';
-// ==================== 钱包转账按地址收费 ====================
-/**
- * 分发（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
- */
-export async function pairwiseTransferWithBundleMerkle(params) {
-    const { senderPrivateKeys, receiverAddresses, amount, amounts, tokenAddress, tokenDecimals, hopCount = 0, hopPrivateKeys, config, startNonce, } = params;
-    if (!senderPrivateKeys || senderPrivateKeys.length === 0) {
-        return { signedTransactions: [], hopWallets: undefined };
-    }
-    if (!receiverAddresses || receiverAddresses.length === 0) {
-        return { signedTransactions: [], hopWallets: undefined };
-    }
-    if (senderPrivateKeys.length !== receiverAddresses.length) {
-        throw new Error(`senderPrivateKeys length (${senderPrivateKeys.length}) must match receiverAddresses length (${receiverAddresses.length})`);
-    }
-    const pairCount = senderPrivateKeys.length;
-    const normalizedAmounts = (() => {
-        if (amounts && amounts.length > 0) {
-            if (amounts.length !== pairCount) {
-                throw new Error(`amounts length (${amounts.length}) must match pair count (${pairCount})`);
-            }
-            return amounts.map(a => (typeof a === 'bigint' ? a.toString() : String(a)));
-        }
-        if (amount !== undefined && String(amount).trim().length > 0) {
-            const v = typeof amount === 'bigint' ? amount.toString() : String(amount);
-            return new Array(pairCount).fill(v);
-        }
-        throw new Error('Either amount or amounts must be provided');
-    })();
-    const chainIdNum = config.chainId ?? CHAINS.BSC.chainId;
-    const chainName = chainIdNum === CHAINS.MONAD.chainId ? 'Monad' : chainIdNum === CHAINS.BSC.chainId ? 'BSC' : `Chain-${chainIdNum}`;
-    const provider = new ethers.JsonRpcProvider(config.rpcUrl, { chainId: chainIdNum, name: chainName });
-    const txType = getTxType(config);
-    const isNative = _isNativeTokenAddress(tokenAddress);
-    const nonceManager = new NonceManager(provider);
-    // hop 私钥链优先使用传入
-    const providedHops = (() => {
-        if (hopPrivateKeys && hopPrivateKeys.length > 0) {
-            if (hopPrivateKeys.length !== pairCount) {
-                throw new Error(`hopPrivateKeys length (${hopPrivateKeys.length}) must match pair count (${pairCount})`);
-            }
-            return hopPrivateKeys.every(h => h.length === 0) ? null : hopPrivateKeys;
-        }
-        return null;
-    })();
-    const preparedHops = providedHops ?? _generateHopWallets(pairCount, hopCount);
-    const hasHops = preparedHops !== null;
-    const maxHopCount = hasHops ? Math.max(...preparedHops.map(h => h.length)) : 0;
-    const finalGasLimit = _calculateGasLimit(config, isNative, hasHops, maxHopCount);
-    const nativeGasLimit = (config.prefer21000ForNative ?? false) ? BRIBE_GAS_LIMIT : finalGasLimit;
-    // 与 disperse/swap.ts 保持一致：多跳场景固定 gas limit
-    const nativeTransferGasLimit = NATIVE_TRANSFER_GAS_LIMIT;
-    const erc20TransferGasLimit = GAS_LIMITS.ERC20_TRANSFER;
-    const [gasPrice, decimals] = await Promise.all([
-        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
-        isNative ? Promise.resolve(18) : Promise.resolve(tokenDecimals ?? await _getErc20DecimalsMerkle(provider, tokenAddress, chainIdNum))
-    ]);
-    const gasFields = buildGasFields(txType, gasPrice);
-    const iface = isNative ? null : new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
-    // ✅ 费用：按地址数量收取固定费用（原生代币），由第一个 sender 支付
-    const extractProfit = shouldExtractProfit(config);
-    const profitAddr = getProfitRecipient();
-    let totalAmountBeforeProfit = 0n;
-    let totalProfitNative = 0n;
-    const parsedAmountsWei = normalizedAmounts.map(v => {
-        const amt = isNative ? ethers.parseEther(v) : ethers.parseUnits(v, decimals);
-        totalAmountBeforeProfit += amt;
-        return amt;
-    });
-    // ✅ 按地址数量收取固定费用
-    if (extractProfit && pairCount > 0) {
-        totalProfitNative = calculateTransferFee(chainIdNum, pairCount);
-    }
-    // ✅ BSC 链贿赂支持（由第一个 sender 支付）
-    const bribeAmount = chainIdNum === CHAINS.BSC.chainId ? getBribeAmount(config) : 0n;
-    const needBribeTx = bribeAmount > 0n;
-    const bribeSignedTx = [];
-    // 计算每个 sender 需要的 nonce 数量（聚合到地址）
-    const senderWallets = senderPrivateKeys.map(pk => new Wallet(pk, provider));
-    const senderAddrLowerList = senderWallets.map(w => w.address.toLowerCase());
-    const firstSenderAddrLower = senderAddrLowerList[0];
-    const nonceNeedBySender = new Map();
-    for (let i = 0; i < pairCount; i++) {
-        const addrLower = senderAddrLowerList[i];
-        const hopLen = preparedHops ? preparedHops[i].length : 0;
-        const perPairTxCount = (() => {
-            if (isNative)
-                return 1;
-            return hopLen > 0 ? 2 : 1;
-        })();
-        const cur = nonceNeedBySender.get(addrLower);
-        if (cur)
-            cur.count += perPairTxCount;
-        else
-            nonceNeedBySender.set(addrLower, { wallet: senderWallets[i], count: perPairTxCount });
-    }
-    // ✅ 贿赂交易需要 1 个额外的 nonce
-    if (needBribeTx) {
-        const cur = nonceNeedBySender.get(firstSenderAddrLower);
-        if (cur)
-            cur.count += 1;
-    }
-    if (extractProfit && totalProfitNative > 0n) {
-        const cur = nonceNeedBySender.get(firstSenderAddrLower);
-        if (cur)
-            cur.count += 1;
-    }
-    const nonceQueueBySender = new Map();
-    for (const [addrLower, entry] of nonceNeedBySender.entries()) {
-        const count = entry.count;
-        const nonces = (addrLower === firstSenderAddrLower && startNonce !== undefined)
-            ? Array.from({ length: count }, (_, i) => startNonce + i)
-            : await nonceManager.getNextNonceBatch(entry.wallet, count);
-        nonceQueueBySender.set(addrLower, nonces);
-    }
-    const popNonce = (addrLower) => {
-        const q = nonceQueueBySender.get(addrLower);
-        if (!q || q.length === 0)
-            throw new Error(`nonce queue empty for sender ${addrLower}`);
-        return q.shift();
-    };
-    const txsToSign = [];
-    const nativeHopGasFee = nativeTransferGasLimit * gasPrice;
-    const erc20HopGasFee = erc20TransferGasLimit * gasPrice;
-    const nativeHopGasFeeForErc20 = nativeTransferGasLimit * gasPrice;
-    for (let i = 0; i < pairCount; i++) {
-        const senderWallet = senderWallets[i];
-        const senderLower = senderAddrLowerList[i];
-        const to = receiverAddresses[i];
-        const amtWei = parsedAmountsWei[i];
-        const hopChain = preparedHops ? preparedHops[i] : [];
-        if (!hopChain || hopChain.length === 0) {
-            const nonce = popNonce(senderLower);
-            if (isNative) {
-                txsToSign.push({
-                    wallet: senderWallet,
-                    tx: { to, value: amtWei, nonce, gasLimit: nativeGasLimit, chainId: chainIdNum, ...gasFields }
-                });
-            }
-            else {
-                const data = iface.encodeFunctionData('transfer', [to, amtWei]);
-                txsToSign.push({
-                    wallet: senderWallet,
-                    tx: { to: tokenAddress, data, value: 0n, nonce, gasLimit: finalGasLimit, chainId: chainIdNum, ...gasFields }
-                });
-            }
-            continue;
-        }
-        const fullChain = [senderWallet, ...hopChain.map(w => new Wallet(typeof w === 'string' ? w : w.privateKey, provider))];
-        const addresses = [...fullChain.map(w => w.address), to];
-        if (isNative) {
-            for (let j = 0; j < addresses.length - 1; j++) {
-                const fromWallet = fullChain[j];
-                const toAddress = addresses[j + 1];
-                const nonce = j === 0 ? popNonce(senderLower) : 0;
-                const remainingHops = addresses.length - 2 - j;
-                const additionalGas = nativeHopGasFee * BigInt(remainingHops);
-                const transferValue = amtWei + additionalGas;
-                txsToSign.push({
-                    wallet: fromWallet,
-                    tx: { to: toAddress, value: transferValue, nonce, gasLimit: nativeTransferGasLimit, chainId: chainIdNum, ...gasFields }
-                });
-            }
-        }
-        else {
-            const hopGasNeeds = [];
-            for (let j = hopChain.length - 1; j >= 0; j--) {
-                if (j === hopChain.length - 1)
-                    hopGasNeeds.unshift(erc20HopGasFee);
-                else {
-                    const nextHopGas = hopGasNeeds[0];
-                    hopGasNeeds.unshift(nativeHopGasFeeForErc20 + erc20HopGasFee + nextHopGas);
-                }
-            }
-            txsToSign.push({
-                wallet: senderWallet,
-                tx: {
-                    to: fullChain[1].address,
-                    value: hopGasNeeds[0],
-                    nonce: popNonce(senderLower),
-                    gasLimit: nativeTransferGasLimit,
-                    chainId: chainIdNum,
-                    ...gasFields
-                }
-            });
-            const mainToFirstHopData = iface.encodeFunctionData('transfer', [fullChain[1].address, amtWei]);
-            txsToSign.push({
-                wallet: senderWallet,
-                tx: {
-                    to: tokenAddress,
-                    data: mainToFirstHopData,
-                    value: 0n,
-                    nonce: popNonce(senderLower),
-                    gasLimit: erc20TransferGasLimit,
-                    chainId: chainIdNum,
-                    ...gasFields
-                }
-            });
-            // hop wallets：逐层传递
-            for (let j = 1; j < fullChain.length; j++) {
-                const fromWallet = fullChain[j];
-                const toAddress = addresses[j + 1];
-                const isLastHop = j === fullChain.length - 1;
-                if (!isLastHop) {
-                    const gasToTransfer = hopGasNeeds[j];
-                    txsToSign.push({
-                        wallet: fromWallet,
-                        tx: {
-                            to: toAddress,
-                            value: gasToTransfer,
-                            nonce: 0,
-                            gasLimit: nativeTransferGasLimit,
-                            chainId: chainIdNum,
-                            ...gasFields
-                        }
-                    });
-                    const erc20Data = iface.encodeFunctionData('transfer', [toAddress, amtWei]);
-                    txsToSign.push({
-                        wallet: fromWallet,
-                        tx: {
-                            to: tokenAddress,
-                            data: erc20Data,
-                            value: 0n,
-                            nonce: 1,
-                            gasLimit: erc20TransferGasLimit,
-                            chainId: chainIdNum,
-                            ...gasFields
-                        }
-                    });
-                }
-                else {
-                    const erc20Data = iface.encodeFunctionData('transfer', [toAddress, amtWei]);
-                    txsToSign.push({
-                        wallet: fromWallet,
-                        tx: {
-                            to: tokenAddress,
-                            data: erc20Data,
-                            value: 0n,
-                            nonce: 0,
-                            gasLimit: erc20TransferGasLimit,
-                            chainId: chainIdNum,
-                            ...gasFields
-                        }
-                    });
-                }
-            }
-        }
-    }
-    if (needBribeTx) {
-        const firstSenderWallet = senderWallets[0];
-        const bribeNonce = popNonce(firstSenderAddrLower);
-        const bribeTx = await firstSenderWallet.signTransaction({
-            to: BLOCKRAZOR_BUILDER_EOA,
-            value: bribeAmount,
-            nonce: bribeNonce,
-            gasLimit: BRIBE_GAS_LIMIT,
-            chainId: chainIdNum,
-            ...gasFields
-        });
-        bribeSignedTx.push(bribeTx);
-    }
-    const signedTxs = await Promise.all(txsToSign.map(({ wallet, tx }) => wallet.signTransaction(tx)));
-    // 利润多跳（固定 2 hop）
-    let profitHopWallets;
-    if (extractProfit && totalProfitNative > 0n) {
-        const firstSenderWallet = senderWallets[0];
-        const profitNonce = popNonce(firstSenderAddrLower);
-        const profitHopResult = await buildProfitHopTransactions({
-            provider,
-            payerWallet: firstSenderWallet,
-            profitAmount: totalProfitNative,
-            profitRecipient: profitAddr,
-            hopCount: PROFIT_HOP_COUNT,
-            gasPrice,
-            chainId: chainIdNum,
-            txType,
-            startNonce: profitNonce
-        });
-        signedTxs.push(...profitHopResult.signedTransactions);
-        profitHopWallets = profitHopResult.hopWallets;
-    }
-    return {
-        signedTransactions: [...bribeSignedTx, ...signedTxs], // ✅ 贿赂交易放在最前面
-        hopWallets: preparedHops || undefined,
-        profitHopWallets,
-        metadata: extractProfit ? {
-            pairCount,
-            isNative,
-            tokenAddress: isNative ? undefined : tokenAddress,
-            totalAmount: isNative ? ethers.formatEther(totalAmountBeforeProfit) : ethers.formatUnits(totalAmountBeforeProfit, decimals),
-            profitAmount: ethers.formatEther(totalProfitNative),
-            profitRecipient: profitAddr,
-            hasBribeTx: bribeSignedTx.length > 0, // ✅ 标记是否有贿赂交易
-            bribeAmount: bribeSignedTx.length > 0 ? ethers.formatEther(bribeAmount) : undefined
-        } : undefined
-    };
-}

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

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

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

@@ -1,86 +0,0 @@
-import { BlockRazorClient } from '../../../../shared/clients/blockrazor.js';
-const blockRazorClientCache = new Map();
-const CLIENT_CACHE_TTL_MS = 60 * 1000;
-function getBlockRazorClient(config) {
-    const cacheKey = `${config.apiKey || ''}-${config.builderRpcUrl || ''}`;
-    const now = Date.now();
-    const cached = blockRazorClientCache.get(cacheKey);
-    if (cached && cached.expireAt > now)
-        return cached.client;
-    const client = new BlockRazorClient({
-        apiKey: config.apiKey,
-        customRpcUrl: config.customRpcUrl,
-        builderRpcUrl: config.builderRpcUrl,
-        chainId: 56,
-    });
-    blockRazorClientCache.set(cacheKey, { client, expireAt: now + CLIENT_CACHE_TTL_MS });
-    return client;
-}
-export async function submitBundleToBlockRazor(signedTransactions, config) {
-    try {
-        const totalTransactions = signedTransactions?.length ?? 0;
-        // 验证输入
-        if (!signedTransactions || signedTransactions.length === 0) {
-            return {
-                code: false,
-                totalTransactions,
-                error: 'signedTransactions cannot be empty'
-            };
-        }
-        // ✅ 使用缓存的 BlockRazorClient
-        const client = getBlockRazorClient(config);
-        // 提交 Bundle
-        const bundleResult = await client.sendBundle({
-            transactions: signedTransactions,
-            blockOffset: config.blockOffset ?? 100,
-            maxBlockOffset: config.maxBlockOffset ?? 100,
-            noMerge: config.noMerge ?? false,
-            revertingTxHashes: config.revertingTxHashes,
-            autoRetry: config.autoRetry ?? false,
-            maxRetries: config.maxRetries ?? 3
-        });
-        // ✅ 提交成功
-        return {
-            code: true,
-            totalTransactions,
-            bundleHash: bundleResult.bundleHash,
-            txHashes: bundleResult.txHashes,
-            maxBlockNumber: bundleResult.maxBlockNumber,
-            txCount: bundleResult.txCount
-        };
-    }
-    catch (error) {
-        // ❌ 提交失败
-        return {
-            code: false,
-            totalTransactions: signedTransactions?.length ?? 0,
-            error: error?.message || String(error)
-        };
-    }
-}
-/**
- * 批量提交多个 Bundle 到 BlockRazor（顺序执行）
- *
- * @param bundles 多个 Bundle 的签名交易数组
- * @param config BlockRazor 提交配置
- * @returns Bundle 提交结果数组
- */
-export async function submitMultipleBundlesToBlockRazor(bundles, config) {
-    const results = [];
-    for (const signedTransactions of bundles) {
-        const result = await submitBundleToBlockRazor(signedTransactions, config);
-        results.push(result);
-    }
-    return results;
-}
-/**
- * 并行提交多个 Bundle 到 BlockRazor（适用于独立的 Bundle）
- *
- * @param bundles 多个 Bundle 的签名交易数组
- * @param config BlockRazor 提交配置
- * @returns Bundle 提交结果数组
- */
-export async function submitMultipleBundlesToBlockRazorParallel(bundles, config) {
-    const promises = bundles.map(signedTransactions => submitBundleToBlockRazor(signedTransactions, config));
-    return await Promise.all(promises);
-}

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

@@ -1,66 +0,0 @@
-import type { DirectSubmitConfig, DirectSubmitResult } from './types.js';
-export declare function submitDirectToRpc(signedTransactions: string[], config: DirectSubmitConfig): Promise<DirectSubmitResult>;
-/**
- * ✅ 顺序广播并等待确认（用于多跳交易等需要顺序执行的场景）
- *
- * 每笔交易广播后会等待上链确认，确保后续交易能正确执行
- *
- * ⚠️ 多跳场景：如果某笔交易失败，会立即停止（因为后续交易肯定也会失败）
- *
- * @param signedTransactions 签名后的交易数组
- * @param config 直接广播配置
- * @returns 广播结果
- */
-export declare function submitDirectToRpcSequential(signedTransactions: string[], config: DirectSubmitConfig): Promise<DirectSubmitResult>;
-/**
- * ✅ 顺序广播但不等待确认（用于 AA handleOps + tail 等 nonce 连续的场景）
- *
- * 按顺序逐笔发送交易，每笔只等待广播成功（RPC 返回 txHash），不等待链上确认。
- * 这样可以保证交易按顺序进入 mempool，同时避免等待确认超时。
- *
- * @param signedTransactions 签名后的交易数组
- * @param config 直接广播配置
- * @returns 广播结果
- */
-export declare function submitDirectToRpcSequentialNoWait(signedTransactions: string[], config: DirectSubmitConfig): Promise<DirectSubmitResult>;
-/**
- * 并行逐笔广播到 RPC（速度更快，但可能有 nonce 冲突）
- *
- * ⚠️ 注意：仅适用于不同钱包的交易，同一钱包的多笔交易应使用顺序广播
- *
- * @param signedTransactions 签名后的交易数组
- * @param config 直接广播配置
- * @returns 广播结果
- */
-export declare function submitDirectToRpcParallel(signedTransactions: string[], config: DirectSubmitConfig): Promise<DirectSubmitResult>;
-/**
- * ✅ 智能广播到 RPC（自动选择并行或顺序）
- *
- * 根据交易的发送者地址自动决定广播策略：
- * - 如果所有交易来自不同钱包：使用并行广播（速度快）
- * - 如果存在同一钱包的多笔交易：使用顺序广播（确保 nonce 顺序）
- *
- * @param signedTransactions 签名后的交易数组
- * @param config 直接广播配置
- * @param options 额外选项
- * @returns 广播结果（包含使用的模式）
- *
- * @example
- * ```typescript
- * import { submitDirectToRpcSmart } from 'four-flap-meme-sdk';
- *
- * const result = await submitDirectToRpcSmart(signedTransactions, {
- *   rpcUrl: 'https://xlayerrpc.okx.com',
- *   chainId: 196,
- *   chainName: 'XLAYER'
- * });
- *
- * console.log('使用模式:', result.mode);  // 'parallel' 或 'sequential'
- * ```
- */
-export declare function submitDirectToRpcSmart(signedTransactions: string[], config: DirectSubmitConfig, options?: {
-    /** 顺序模式时是否等待确认（默认 false） */
-    waitConfirmation?: boolean;
-}): Promise<DirectSubmitResult & {
-    mode: 'parallel' | 'sequential';
-}>;