four-flap-meme-sdk 4.4.3 → 4.5.1

package/README.md

@@ -2,7 +2,7 @@
 
 **four.meme 和 Flap Protocol 统一 SDK - 生产环境 MEV 保护方案**
 
-提供完整的代币发行和交易功能，所有操作均通过 **Merkle.io Bundle** 执行，确保 MEV 保护、原子性和私有性。
+提供完整的代币发行和交易功能，签名后通过 BlockRazor / 48.club / Emit 提交，确保 MEV 保护和原子性。
 
 ## 核心优势
 
@@ -20,9 +20,9 @@ npm i four-flap-meme-sdk ethers
 
 **要求**：Node.js >= 18, ESM, ethers v6
 
-## 获取 Merkle API Key
+## 提交
 
-从 [Merkle.io](https://merkle.io) 获取免费 API Key，用于 Bundle 服务。
+SDK 只负责构建与签名；Merkle 网络客户端和 `submitBundleToMerkle` 已移除，请使用 BlockRazor、48.club 或 Emit 提交。
 
 ## 浏览器环境 CORS 支持
 
@@ -66,7 +66,6 @@ const result = await createTokenWithBundleBuyMerkle({
     label: 'Meme'
   },
   config: {
-    apiKey: 'YOUR_MERKLE_API_KEY',
     rpcUrl: 'https://bsc-dataseed.binance.org'
   }
 });
@@ -84,7 +83,7 @@ await batchBuyWithBundleMerkle({
   privateKeys: ['0x...买家1', '0x...买家2', '0x...买家3'],
   buyAmounts: ['0.3', '0.5', '0.2'],
   tokenAddress: '0x...代币地址',
-  config: { apiKey: 'YOUR_MERKLE_API_KEY' }
+  config: {}
 });
 ```
 
@@ -98,7 +97,7 @@ await batchSellWithBundleMerkle({
   privateKeys: ['0x...卖家1', '0x...卖家2'],
   sellAmounts: ['1000', '2000'],
   tokenAddress: '0x...代币地址',
-  config: { apiKey: 'YOUR_MERKLE_API_KEY' }
+  config: {}
 });
 ```
 
@@ -110,7 +109,7 @@ import { approveFourBatchMerkle } from 'four-flap-meme-sdk';
 await approveFourBatchMerkle({
   privateKeys: ['0x...地址1', '0x...地址2'],
   tokenAddress: '0x...代币地址',
-  config: { apiKey: 'YOUR_MERKLE_API_KEY' }
+  config: {}
 });
 ```
 
@@ -131,7 +130,7 @@ await fourPancakeProxyBatchBuyMerkle({
     ['0x...WBNB', '0x...TOKEN']
   ],
   routeType: 'v2',
-  config: { apiKey: 'YOUR_MERKLE_API_KEY' }
+  config: {}
 });
 
 // V2 批量卖出
@@ -143,7 +142,7 @@ await fourPancakeProxyBatchSellMerkle({
     ['0x...TOKEN', '0x...WBNB']
   ],
   routeType: 'v2',
-  config: { apiKey: 'YOUR_MERKLE_API_KEY' }
+  config: {}
 });
 ```
 
@@ -158,7 +157,7 @@ await fourPancakeProxyBatchBuyMerkle({
   tokenOut: '0x...TOKEN',
   fee: 2500,  // 0.25%
   routeType: 'v3-single',
-  config: { apiKey: 'YOUR_MERKLE_API_KEY' }
+  config: {}
 });
 
 // V3 多跳买入
@@ -168,7 +167,7 @@ await fourPancakeProxyBatchBuyMerkle({
   lpAddresses: ['0x...WBNB_USDT_LP', '0x...USDT_TOKEN_LP'],
   exactTokenIn: '0x...WBNB',
   routeType: 'v3-multi',
-  config: { apiKey: 'YOUR_MERKLE_API_KEY' }
+  config: {}
 });
 ```
 
@@ -196,7 +195,6 @@ const result = await flapCreateTokenWithBundleBuyMerkle({
     meta: 'QmXxx...'  // IPFS CID
   },
   config: {
-    apiKey: 'YOUR_MERKLE_API_KEY',
     rpcUrl: 'https://bsc-dataseed.binance.org'
   },
   dexThresh: 1,
@@ -222,7 +220,7 @@ await flapBatchBuyWithBundleMerkle({
   privateKeys: ['0x...买家1', '0x...买家2'],
   buyAmounts: ['0.5', '1.0'],
   tokenAddress: '0x...代币地址',
-  config: { apiKey: 'YOUR_MERKLE_API_KEY' }
+  config: {}
 });
 
 // 批量卖出
@@ -231,7 +229,7 @@ await flapBatchSellWithBundleMerkle({
   privateKeys: ['0x...卖家1', '0x...卖家2'],
   sellAmounts: ['1000', '2000'],
   tokenAddress: '0x...代币地址',
-  config: { apiKey: 'YOUR_MERKLE_API_KEY' }
+  config: {}
 });
 ```
 
@@ -253,7 +251,7 @@ await flapPancakeProxyBatchBuyMerkle({
     ['0x...WBNB', '0x...TOKEN']
   ],
   routeType: 'v2',
-  config: { apiKey: 'YOUR_MERKLE_API_KEY' }
+  config: {}
 });
 
 // V3 单跳卖出
@@ -265,7 +263,7 @@ await flapPancakeProxyBatchSellMerkle({
   tokenOut: '0x...WBNB',
   fee: 2500,
   routeType: 'v3-single',
-  config: { apiKey: 'YOUR_MERKLE_API_KEY' }
+  config: {}
 });
 ```
 
@@ -275,7 +273,6 @@ await flapPancakeProxyBatchSellMerkle({
 
 ```typescript
 type BundleMerkleConfig = {
-  apiKey: string;                    // Merkle API Key（必填）
   rpcUrl?: string;                   // RPC 节点（可选）
   bundleBlockOffset?: number;        // Bundle 有效期，默认 200 区块
   gasLimitMultiplier?: number;       // Gas limit 倍数，默认 1.2
@@ -331,11 +328,8 @@ type BundleMerkleConfig = {
 
 ## 常见问题
 
-**Q: 为什么只推荐 Merkle Bundle 方法？**  
-A: 生产环境必须使用 MEV 保护，防止抢跑和三明治攻击。Merkle Bundle 是目前最可靠的 MEV 保护方案。
-
-**Q: Merkle API Key 如何获取？**  
-A: 访问 [Merkle.io](https://merkle.io) 注册并获取免费 API Key。
+**Q: 现在如何提交 Bundle？**  
+A: 使用 BlockRazor、48.club 或 Emit service；Merkle 网络客户端已移除。
 
 **Q: Bundle 交易失败怎么办？**  
 A: 检查配置参数（gasLimit、blockOffset、slippage），确保所有地址有足够余额，适当增大超时时间。

package/dist/bundle/four-meme/types/buy-first.d.ts

@@ -6,7 +6,8 @@ export type FourBuyFirstSignConfig = FourSignConfig & {
     userType?: UserType;
 };
 export type FourBuyFirstConfig = CommonBundleConfig & {
-    apiKey: string;
+    /** @deprecated Merkle 提交已移除；字段仅为旧调用兼容，不再读取 */
+    apiKey?: string;
     customRpcUrl?: string;
     bundleBlockOffset?: number;
     reserveGasBNB?: number;

package/dist/bundle/four-meme/types/config.d.ts

@@ -22,7 +22,8 @@ export type FourSignConfig = {
     bribeAmount?: number;
 };
 export type FourBundleMerkleConfig = {
-    apiKey: string;
+    /** @deprecated Merkle 提交已移除；字段仅为旧调用兼容，不再读取 */
+    apiKey?: string;
     customRpcUrl?: string;
     fourApiUrl?: string;
     bundleBlockOffset?: number;

package/dist/bundle/four-meme/types/swap-types.d.ts

@@ -16,7 +16,8 @@ export type FourSwapSignConfig = {
 };
 /** Swap Merkle 配置（保留兼容） */
 export type FourSwapConfig = CommonBundleConfig & {
-    apiKey: string;
+    /** @deprecated Merkle 提交已移除；字段仅为旧调用兼容，不再读取 */
+    apiKey?: string;
     customRpcUrl?: string;
     bundleBlockOffset?: number;
     reserveGasBNB?: number;

package/dist/bundle/four-meme/utils-sweep/erc20-no-hop.js

@@ -113,14 +113,23 @@ export async function sweepErc20NoHop(ctx) {
         }
     }
     // ✅ 第二步：生成归集交易（ERC20 全额归集，费用以原生币单独支付）
+    // 支付者可能既要归集又要发利润，必须先按“主交易 + 利润”预留连续 nonce；
+    // 且支付者不能再从批量 nonce 里取一次，否则 target 同时在 sources 时会拿到 m+1 做主交易、m 做利润。
     let payerProfitNonce;
+    let payerMainNonce;
+    const payerAddressErc20 = extractProfit && nativeProfitAmount > 0n && profitPayerWalletErc20
+        ? profitPayerWalletErc20.address.toLowerCase()
+        : undefined;
     if (extractProfit && nativeProfitAmount > 0n && profitPayerWalletErc20) {
-        const nonces = await nonceManager.getNextNonceBatch(profitPayerWalletErc20, useTargetAsPayerErc20 ? 1 : 2);
-        payerProfitNonce = useTargetAsPayerErc20 ? nonces[0] : nonces[1];
+        const payerIsSourceWithAmount = targetIndexInSources >= 0 && useTargetAsPayerErc20 && sweepAmounts[targetIndexInSources] > 0n;
+        const payerNeedsMain = !useTargetAsPayerErc20 || payerIsSourceWithAmount;
+        const nonces = await nonceManager.getNextNonceBatch(profitPayerWalletErc20, payerNeedsMain ? 2 : 1);
+        if (payerNeedsMain)
+            payerMainNonce = nonces[0];
+        payerProfitNonce = payerNeedsMain ? nonces[1] : nonces[0];
     }
-    // ✅ 优化：批量获取所有钱包的 nonce（JSON-RPC 批量请求）
-    // 过滤出需要归集的钱包（如果用 targetWallet 支付利润，则不排除 maxSweepIndex）
-    const walletsToSweepErc20 = wallets.filter((_, i) => sweepAmounts[i] > 0n && (useTargetAsPayerErc20 || i !== maxSweepIndex));
+    // 支付者已单独预留 nonce，不能再进入批量查询。
+    const walletsToSweepErc20 = wallets.filter((w, i) => sweepAmounts[i] > 0n && (!payerAddressErc20 || w.address.toLowerCase() !== payerAddressErc20));
     const noncesErc20 = walletsToSweepErc20.length > 0 ? await nonceManager.getNextNoncesForWallets(walletsToSweepErc20) : [];
     let nonceIdxErc20 = 0;
     const txPromises = wallets.map(async (w, i) => {
@@ -129,10 +138,9 @@ export async function sweepErc20NoHop(ctx) {
             return null;
         // ✅ ERC20 归集：全部归集，不扣除代币（利润从 BNB 支付）
         const actualToSend = toSend;
-        // ✅ 支付者使用预留的第一个 nonce，其他钱包使用批量获取的 nonce
         let nonce;
-        if (!useTargetAsPayerErc20 && i === maxSweepIndex && payerProfitNonce !== undefined) {
-            nonce = payerProfitNonce - 1; // 使用预留的第一个 nonce
+        if (payerMainNonce !== undefined && w.address.toLowerCase() === payerAddressErc20) {
+            nonce = payerMainNonce;
         }
         else {
             nonce = noncesErc20[nonceIdxErc20++];

package/dist/bundle/four-meme/utils-sweep/main.js

@@ -16,7 +16,7 @@ import { sweepNativeNoHop } from './native-no-hop.js';
 import { sweepErc20NoHop } from './erc20-no-hop.js';
 import { sweepWithHops } from './with-hops.js';
 export async function sweepWithBundleMerkle(params) {
-    const { sourcePrivateKeys, target, targetPrivateKey, ratioPct, ratios, amount, amounts, tokenAddress, tokenDecimals, skipIfInsufficient = true, hopCount = 0, hopPrivateKeys, sources, config, } = params;
+    const { sourcePrivateKeys, target, targetPrivateKey, ratioPct, ratios, amount, amounts, tokenAddress, tokenDecimals, skipIfInsufficient = true, hopCount = 0, hopPrivateKeys, sources, config, startNonce, } = params;
     // 快速返回空结果
     if (!sourcePrivateKeys || sourcePrivateKeys.length === 0) {
         return {
@@ -45,6 +45,17 @@ export async function sweepWithBundleMerkle(params) {
     const hopCountInput = resolveHopCountInput(actualKeys.length, hopCount, sources);
     const preparedHops = providedHops ?? _generateHopWallets(actualKeys.length, hopCountInput);
     const hasHops = preparedHops !== null;
+    if (providedHops) {
+        // 中转交易当前按 nonce 0/1 组装；复用已发过交易的 hop key 会直接冲突。
+        for (const group of providedHops) {
+            for (const key of group) {
+                const address = new Wallet(key).address;
+                if (await provider.getTransactionCount(address, 'latest') > 0) {
+                    throw new Error('hopPrivateKeys 中包含已使用的地址；请换用未发过交易的中转私钥');
+                }
+            }
+        }
+    }
     const maxHopCount = hasHops ? Math.max(...preparedHops.map((h) => h.length)) : 0;
     // 先按配置算上限，再向节点估算。估算成功就用估算值，归集才不会把没用完的 gas 退回钱包。
     let finalGasLimit = _calculateGasLimit(config, isNative, hasHops, maxHopCount);
@@ -74,6 +85,9 @@ export async function sweepWithBundleMerkle(params) {
     const bribeSignedTx = [];
     // ✅ 共享 NonceManager：统一协调 贿赂/利润提取 等 targetWallet 交易的 nonce，避免同一钱包 nonce 冲突
     const nonceManager = new NonceManager(provider);
+    if (startNonce !== undefined && actualKeys[0]) {
+        nonceManager.seedNextNonce(new Wallet(actualKeys[0]).address, startNonce);
+    }
     // ✅ 贿赂交易放在最前面（由 targetWallet 签名）
     if (needBribeTx && targetWallet) {
         const [bribeGasPrice, bribeNonce] = await Promise.all([

package/dist/bundle/four-meme/utils-sweep/native-no-hop.js

@@ -15,6 +15,7 @@ export async function sweepNativeNoHop(ctx) {
     let profitHopWallets;
     const wallets = actualKeys.map((pk) => new Wallet(pk, provider));
     const addresses = wallets.map((w) => w.address);
+    const targetIndexInSources = addresses.findIndex((addr) => addr.toLowerCase() === target.toLowerCase());
     // ✅ 复用主流程共享的 NonceManager（贿赂交易已用它预留 targetWallet 的 nonce，避免利润提取与之冲突）
     const nonceManager = ctx.nonceManager ?? new NonceManager(provider);
     // ✅ 优化：并行获取 gasPrice 和余额
@@ -91,13 +92,20 @@ export async function sweepNativeNoHop(ctx) {
     const profitPayerWallet = useTargetAsPayer ? targetWallet : maxSweepIndex >= 0 ? wallets[maxSweepIndex] : null;
     // ✅ 先为支付者预留 nonce，确保 nonce 连续
     let payerProfitNonce;
+    let payerMainNonce;
+    const payerAddress = extractProfit && totalProfit > 0n && profitPayerWallet
+        ? profitPayerWallet.address.toLowerCase()
+        : undefined;
     if (extractProfit && totalProfit > 0n && profitPayerWallet) {
-        const nonces = await nonceManager.getNextNonceBatch(profitPayerWallet, useTargetAsPayer ? 1 : 2);
-        payerProfitNonce = useTargetAsPayer ? nonces[0] : nonces[1]; // targetWallet 只需要 1 个 nonce
+        const payerIsSourceWithAmount = targetIndexInSources >= 0 && useTargetAsPayer && sweepAmounts[targetIndexInSources] > 0n;
+        const payerNeedsMain = !useTargetAsPayer || payerIsSourceWithAmount;
+        const nonces = await nonceManager.getNextNonceBatch(profitPayerWallet, payerNeedsMain ? 2 : 1);
+        if (payerNeedsMain)
+            payerMainNonce = nonces[0];
+        payerProfitNonce = payerNeedsMain ? nonces[1] : nonces[0];
     }
-    // ✅ 优化：批量获取所有钱包的 nonce（JSON-RPC 批量请求）
-    // 过滤出需要归集的钱包（如果用 targetWallet 支付利润，则不排除 maxSweepIndex）
-    const walletsToSweep = wallets.filter((_, i) => sweepAmounts[i] > 0n && (useTargetAsPayer || i !== maxSweepIndex));
+    // 支付者已单独预留 nonce，不能再进入批量查询。
+    const walletsToSweep = wallets.filter((w, i) => sweepAmounts[i] > 0n && (!payerAddress || w.address.toLowerCase() !== payerAddress));
     const nonces = walletsToSweep.length > 0 ? await nonceManager.getNextNoncesForWallets(walletsToSweep) : [];
     let nonceIdx = 0;
     const txPromises = wallets.map(async (w, i) => {
@@ -108,17 +116,17 @@ export async function sweepNativeNoHop(ctx) {
         if (extractProfit && !useTargetAsPayer) {
             // ✅ 如果由源钱包支付利润，支付者扣除所有利润总和；其他钱包不扣利润，归集干净
             if (i === maxSweepIndex && totalProfit > 0n) {
-                actualToSend = toSend - totalProfit; // 支付者扣除所有利润总和
+                actualToSend = toSend > totalProfit ? toSend - totalProfit : 0n; // 支付者扣除利润，不足则不发
             }
             else {
                 actualToSend = toSend; // 其他钱包不扣利润，归集全部
             }
         }
         // ✅ 如果由 targetWallet 支付利润，所有源钱包都归集全部金额
-        // ✅ 支付者使用预留的第一个 nonce，其他钱包使用批量获取的 nonce
+        // 支付者 actualToSend=0 时仍发 0 值交易，消费预留 nonce，避免利润 nonce 出现空洞。
         let nonce;
-        if (!useTargetAsPayer && i === maxSweepIndex && payerProfitNonce !== undefined) {
-            nonce = payerProfitNonce - 1; // 使用预留的第一个 nonce
+        if (payerMainNonce !== undefined && w.address.toLowerCase() === payerAddress) {
+            nonce = payerMainNonce;
         }
         else {
             nonce = nonces[nonceIdx++];

package/dist/bundle/index.d.ts

@@ -5,4 +5,4 @@ export { getErc20Decimals, getErc20DecimalsMerkle, generateHopWallets, normalize
 export { resolveChainName, createSignProvider, createSignWallet, resolveSignContext, normalizeItemsOrRecipientsAmounts, resolveProvidedHops, resolveHopCountInput, signBribeTransaction, type SignConfigInput, type HopItem, } from './sign-context-helpers.js';
 export { BUNDLE_ERRORS, ERRORS, getBundleErrorMessage, getErrorMessage } from './errors.js';
 export { getTxType, getGasPriceMultiplier, getBundleOptions, getGasPriceConfig, shouldExtractProfit, getProfitRateBps, getProfitRecipient, calculateProfit, calculateBatchProfit, getBribeAmount, type BundleGasConfigInput, type BundleMerkleConfigInput, } from './config-helpers.js';
-export { submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, type MerkleSubmitConfig, type SubmitBundleResult, type BlockRazorSubmitConfig, type BlockRazorSubmitResult, type DirectSubmitConfig, type DirectSubmitResult, type DirectTxResult, } from './submit.js';
+export { submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, type BlockRazorSubmitConfig, type BlockRazorSubmitResult, type DirectSubmitConfig, type DirectSubmitResult, type DirectTxResult, } from './submit.js';

package/dist/bundle/index.js

@@ -5,4 +5,4 @@ export { getErc20Decimals, getErc20DecimalsMerkle, generateHopWallets, normalize
 export { resolveChainName, createSignProvider, createSignWallet, resolveSignContext, normalizeItemsOrRecipientsAmounts, resolveProvidedHops, resolveHopCountInput, signBribeTransaction, } from './sign-context-helpers.js';
 export { BUNDLE_ERRORS, ERRORS, getBundleErrorMessage, getErrorMessage } from './errors.js';
 export { getTxType, getGasPriceMultiplier, getBundleOptions, getGasPriceConfig, shouldExtractProfit, getProfitRateBps, getProfitRecipient, calculateProfit, calculateBatchProfit, getBribeAmount, } from './config-helpers.js';
-export { submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, } from './submit.js';
+export { submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, } from './submit.js';

package/dist/bundle/internal.d.ts

@@ -22,6 +22,8 @@ export declare function estimateSweepLimits(params: {
     tokenAddress?: string;
     nativeFallback: bigint;
     tokenFallback: bigint;
+    /** 估算值安全垫；节点估值通常是刚好够，批量转账/合约收款方需要余量 */
+    bufferPercent?: number;
 }): Promise<{
     nativeGasLimit: bigint;
     tokenGasLimit: bigint;

package/dist/bundle/internal.js

@@ -131,6 +131,10 @@ export async function batchGetTokenAndNativeBalances(provider, addresses, tokenA
 }
 /** 归集/分发：按节点估算这笔转账的 gas。失败返回 null，调用方再用固定上限。 */
 export async function estimateSweepLimits(params) {
+    const withBuffer = (gas) => {
+        const pct = params.bufferPercent ?? 20;
+        return gas + (gas * BigInt(Math.max(0, Math.floor(pct)))) / 100n;
+    };
     try {
         if (!params.tokenAddress) {
             const gas = await params.provider.estimateGas({
@@ -139,7 +143,7 @@ export async function estimateSweepLimits(params) {
                 value: 0n,
             });
             if (gas > 0n)
-                return { nativeGasLimit: gas, tokenGasLimit: gas, estimated: true };
+                return { nativeGasLimit: withBuffer(gas), tokenGasLimit: withBuffer(gas), estimated: true };
         }
         else {
             const iface = new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
@@ -155,8 +159,8 @@ export async function estimateSweepLimits(params) {
             ]);
             if (tokenGas > 0n) {
                 return {
-                    nativeGasLimit: nativeGas > 0n ? nativeGas : params.nativeFallback,
-                    tokenGasLimit: tokenGas,
+                    nativeGasLimit: nativeGas > 0n ? withBuffer(nativeGas) : params.nativeFallback,
+                    tokenGasLimit: withBuffer(tokenGas),
                     estimated: true,
                 };
             }

package/dist/bundle/submit/index.d.ts

@@ -2,13 +2,11 @@
  * Bundle 提交 barrel
  *
  * 原超长文件按提交后端拆分为：
- * - helpers.ts：Merkle / BlockRazor 共用缓存与批量提交辅助
- * - merkle.ts：Merkle 提交后端
+ * - helpers.ts：BlockRazor 共用批量提交辅助
  * - blockrazor.ts：BlockRazor 提交后端
  * - direct.ts：逐笔 RPC 广播后端
  *
  * 对外 export 符号与路径保持不变。
  */
-export { submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, type MerkleSubmitConfig, type SubmitBundleResult, } from './merkle.js';
 export { submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, type BlockRazorSubmitConfig, type BlockRazorSubmitResult, } from './blockrazor.js';
 export { submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, type DirectSubmitConfig, type DirectTxResult, type DirectSubmitResult, } from './direct.js';

package/dist/bundle/submit/index.js

@@ -2,13 +2,11 @@
  * Bundle 提交 barrel
  *
  * 原超长文件按提交后端拆分为：
- * - helpers.ts：Merkle / BlockRazor 共用缓存与批量提交辅助
- * - merkle.ts：Merkle 提交后端
+ * - helpers.ts：BlockRazor 共用批量提交辅助
  * - blockrazor.ts：BlockRazor 提交后端
  * - direct.ts：逐笔 RPC 广播后端
  *
  * 对外 export 符号与路径保持不变。
  */
-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/index.d.ts

@@ -5,6 +5,6 @@
  */
 export * from './constants.js';
 export * as platforms from './platforms/index.js';
-export { disperseWithBundleMerkle, sweepWithBundleMerkle, pairwiseTransferWithBundleMerkle, fourBundleSwapMerkle, fourBatchSwapMerkle, fourQuickBatchSwapMerkle, fourBundleBuyFirstMerkle, createTokenWithBundleBuyMerkle as fourCreateTokenWithBundleBuyMerkle, batchSellWithBundleMerkle as fourBatchSellWithBundleMerkle, fourBatchPrivateBuyMerkle, submitBundleToMerkle, submitBundleToBlockRazor, submitDirectToRpc, submitDirectToRpcSmart, approveFourTokenManagerBatch, } from './platforms/four/index.js';
+export { disperseWithBundleMerkle, sweepWithBundleMerkle, pairwiseTransferWithBundleMerkle, fourBundleSwapMerkle, fourBatchSwapMerkle, fourQuickBatchSwapMerkle, fourBundleBuyFirstMerkle, createTokenWithBundleBuyMerkle as fourCreateTokenWithBundleBuyMerkle, batchSellWithBundleMerkle as fourBatchSellWithBundleMerkle, fourBatchPrivateBuyMerkle, submitBundleToBlockRazor, submitDirectToRpc, submitDirectToRpcSmart, approveFourTokenManagerBatch, } from './platforms/four/index.js';
 export { pancakeBundleSwapMerkle, pancakeBatchSwapMerkle, pancakeQuickBatchSwapMerkle, pancakeCrossSwapMerkle, pancakeBundleBuyFirstMerkle, } from './platforms/pancake/index.js';
 export { IroFactoryQuery, createProject as iroCreateProject, encodeCreateProjectCall as iroEncodeCreateProjectCall, parseCreateProjectEvent as iroParseCreateProjectEvent, IroTokenQuery, subscribe as iroSubscribe, pledge as iroPledge, batchSubscribe as iroBatchSubscribe, batchSubscribeForSubmit as iroBatchSubscribeForSubmit, IroPoolQuery, poolRemovePledge as iroPoolRemovePledge, poolExtract as iroPoolExtract, poolTransferAwards as iroPoolTransferAwards, batchExtract as iroBatchExtract, IRO_FACTORY_ADDRESS, IRO_FACTORY_ABI, IRO_TOKEN_ABI, IRO_POOL_ABI, CREATE_PROJECT_GAS_LIMIT as BSC_CREATE_PROJECT_GAS_LIMIT, IRO_PLATFORM_URL, IRO_TESTNET_PLATFORM_URL, setIroApiBase, setIroTestApiBase, iroApiCreateProject, iroApiUploadImage, } from './platforms/iro/index.js';

package/dist/chains/bsc/index.js

@@ -20,7 +20,7 @@ fourBundleBuyFirstMerkle,
 // 发币 / 批量卖 / 私有买入（消费者白名单别名）
 createTokenWithBundleBuyMerkle as fourCreateTokenWithBundleBuyMerkle, batchSellWithBundleMerkle as fourBatchSellWithBundleMerkle, fourBatchPrivateBuyMerkle, 
 // 提交
-submitBundleToMerkle, submitBundleToBlockRazor, submitDirectToRpc, submitDirectToRpcSmart, 
+submitBundleToBlockRazor, submitDirectToRpc, submitDirectToRpcSmart, 
 // 授权
 approveFourTokenManagerBatch, } from './platforms/four/index.js';
 // ============================================================================

package/dist/chains/bsc/pancake/bundle-buy-first-types.d.ts

@@ -48,7 +48,8 @@ export interface V3MultiRouteParams {
 }
 export type RouteParams = V2RouteParams | V3SingleRouteParams | V3MultiRouteParams;
 export interface PancakeBuyFirstConfig extends CommonBundleConfig {
-    apiKey: string;
+    /** @deprecated Merkle 提交已移除；字段仅为旧调用兼容，不再读取 */
+    apiKey?: string;
     customRpcUrl?: string;
     bundleBlockOffset?: number;
     reserveGasBNB?: number;

package/dist/chains/bsc/pancake/bundle-swap-types.d.ts

@@ -103,7 +103,8 @@ export interface PancakeSwapSignConfig {
     v2RouterAddress?: string;
 }
 export interface PancakeSwapConfig extends CommonBundleConfig {
-    apiKey: string;
+    /** @deprecated Merkle 提交已移除；字段仅为旧调用兼容，不再读取 */
+    apiKey?: string;
     customRpcUrl?: string;
     bundleBlockOffset?: number;
     reserveGasBNB?: number;

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

@@ -19,6 +19,6 @@ export { sweepWithBundleMerkle } from '../../../../bundle/four-meme/utils-sweep.
 export { pairwiseTransferWithBundleMerkle } from '../../../../bundle/four-meme/utils-pairwise.js';
 export { fourPancakeProxyBatchBuyMerkle, fourPancakeProxyBatchSellMerkle, approveFourPancakeProxy, approveFourPancakeProxyBatch, } from '../../../../bundle/four-meme/pancake-proxy.js';
 export { approveFourTokenManagerBatch } from '../../../../bundle/four-meme/approve-tokenmanager.js';
-export { submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, type MerkleSubmitConfig, type SubmitBundleResult, type BlockRazorSubmitConfig, type BlockRazorSubmitResult, type DirectSubmitConfig, type DirectSubmitResult, type DirectTxResult, } from '../../../../bundle/submit.js';
+export { submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, type BlockRazorSubmitConfig, type BlockRazorSubmitResult, type DirectSubmitConfig, type DirectSubmitResult, type DirectTxResult, } from '../../../../bundle/submit.js';
 export { fourBundleBuyFirstMerkle } from '../../../../bundle/four-meme/swap-buy-first.js';
 export { fourBundleSwapMerkle, fourBatchSwapMerkle, fourQuickBatchSwapMerkle, } from '../../../../bundle/four-meme/swap.js';

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

@@ -24,7 +24,7 @@ export { fourPancakeProxyBatchBuyMerkle, fourPancakeProxyBatchSellMerkle, approv
 // TokenManager 授权方法
 export { approveFourTokenManagerBatch } from '../../../../bundle/four-meme/approve-tokenmanager.js';
 // Bundle 提交方法（服务器端使用）
-export { submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, } from '../../../../bundle/submit.js';
+export { submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, } from '../../../../bundle/submit.js';
 // 先买后卖换手方法
 export { fourBundleBuyFirstMerkle } from '../../../../bundle/four-meme/swap-buy-first.js';
 // 换手方法

package/dist/core/clients/blockrazor.js

@@ -146,16 +146,18 @@ export class BlockRazorClient {
         }
         // 验证 Gas Price（最低 0.05 Gwei）
         for (const rawTx of params.txs) {
+            let tx;
             try {
-                const tx = Transaction.from(rawTx);
-                const gasPrice = tx.gasPrice || 0n;
-                const minGasPrice = ethers.parseUnits(String(MIN_GAS_PRICE_GWEI), 'gwei');
-                if (gasPrice < minGasPrice) {
-                    throw new Error(`Transaction gas price (${ethers.formatUnits(gasPrice, 'gwei')} gwei) is below minimum (${MIN_GAS_PRICE_GWEI} gwei)`);
-                }
+                tx = Transaction.from(rawTx);
             }
             catch {
                 // 解析失败，跳过检查
+                continue;
+            }
+            const gasPrice = tx.gasPrice && tx.gasPrice > 0n ? tx.gasPrice : tx.maxFeePerGas ?? 0n;
+            const minGasPrice = ethers.parseUnits(String(MIN_GAS_PRICE_GWEI), 'gwei');
+            if (gasPrice < minGasPrice) {
+                throw new Error(`Transaction gas price (${ethers.formatUnits(gasPrice, 'gwei')} gwei) is below minimum (${MIN_GAS_PRICE_GWEI} gwei)`);
             }
         }
         // 构建请求参数

package/dist/core/clients/blockrazor.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/clients/blockrazor.test.js

@@ -0,0 +1,23 @@
+import { Wallet } from 'ethers';
+import { describe, expect, it } from 'vitest';
+import { BlockRazorClient } from './blockrazor.js';
+describe('BlockRazor gas price validation', () => {
+    it('低于 0.05 Gwei 的签名交易被拒绝', async () => {
+        const client = new BlockRazorClient({
+            apiKey: 'test',
+            chainId: 56,
+            customRpcUrl: 'http://127.0.0.1:1',
+        });
+        const wallet = Wallet.createRandom();
+        const raw = await wallet.signTransaction({
+            to: Wallet.createRandom().address,
+            value: 0n,
+            nonce: 0,
+            gasLimit: 21000n,
+            gasPrice: 1n,
+            chainId: 56,
+            type: 0,
+        });
+        await expect(client.sendBundleRaw({ txs: [raw] })).rejects.toThrow(/below minimum/);
+    });
+});

package/dist/core/clients/index.d.ts

@@ -3,6 +3,5 @@
  */
 export { FourClient, buildLoginMessage, buildCreateTokenReq, type FourConfig, type GenerateNonceReq, type LoginReq, type CreateTokenReq, type CreateTokenResp, type FourTokenTaxInfo, type FourRaisedToken, type FourTokenLabel, } from './four.js';
 export { Club48Client, sendBatchPrivateTransactions, sendBackrunBundle, type BundleParams, type BundleStatus, type Club48Config, } from './club48.js';
-export { MerkleClient, createMerkleClient, type MerkleConfig, type BundleParams as MerkleBundleParams, type SendBundleOptions, type BundleResult, type TransactionResult, } from './merkle.js';
 export { BlockRazorClient, createBlockRazorClient, BLOCKRAZOR_BUILDER_EOA, type BlockRazorConfig, type BlockRazorBundleParams, type SendBundleOptions as BlockRazorSendBundleOptions, type BundleResult as BlockRazorBundleResult, type TransactionResult as BlockRazorTransactionResult, type IncentiveTransactionParams, } from './blockrazor.js';
 export { EmitServiceClient, submitToEmitServiceBlockRazor, type EmitServiceClientConfig, type EmitServiceSubmitRequest, type EmitServiceSubmitResponse, type EmitServiceSubmitResponseData, type EmitServiceRouteConfigResponse, } from './emitservice.js';

package/dist/core/clients/index.js

@@ -3,6 +3,5 @@
  */
 export { FourClient, buildLoginMessage, buildCreateTokenReq, } from './four.js';
 export { Club48Client, sendBatchPrivateTransactions, sendBackrunBundle, } from './club48.js';
-export { MerkleClient, createMerkleClient, } from './merkle.js';
 export { BlockRazorClient, createBlockRazorClient, BLOCKRAZOR_BUILDER_EOA, } from './blockrazor.js';
 export { EmitServiceClient, submitToEmitServiceBlockRazor, } from './emitservice.js';

package/dist/core/clients/merkle.js

@@ -38,12 +38,15 @@ export class MerkleClient {
     constructor(config) {
         this.chainId = config.chainId;
         this.chainName = config.chainId === CHAINS.BSC.chainId ? 'bsc' : 'ethereum';
-        // ✅ 修复：移除弃用的 mempool.merkle.io RPC，使用公共 RPC 作为默认值
-        // 优先使用用户自定义 RPC，否则使用官方公共 RPC
-        const defaultRpc = config.chainId === CHAINS.BSC.chainId
-            ? CHAINS.BSC.rpcUrls.backup // bsc-dataseed1
-            : CHAINS.ETHEREUM.rpcUrls.default;
-        const rpcUrl = config.customRpcUrl || defaultRpc;
+        // Blink/Merkle 的 bundle RPC 是带 API key 的节点 endpoint；公共 BSC 节点
+        // 不支持 eth_sendBundle。customRpcUrl 可显式覆盖（需自带 key）。
+        const bundleBase = config.chainId === CHAINS.BSC.chainId
+            ? CHAINS.BSC.bundleRpcUrl
+            : CHAINS.ETHEREUM.bundleRpcUrl;
+        const rpcUrl = config.customRpcUrl || (bundleBase ? `${bundleBase}/v1/${config.apiKey}` : '');
+        if (!rpcUrl) {
+            throw new Error('Merkle bundle RPC endpoint is not configured');
+        }
         this.provider = createProvider(rpcUrl, this.chainId, this.chainName);
     }
     /**
@@ -366,10 +369,12 @@ export class MerkleClient {
      */
     getProviderInfo() {
         const rpcConnection = this.provider._getConnection?.();
+        const rawUrl = rpcConnection?.url ?? 'unknown';
         return {
             chainId: this.chainId,
             chainName: this.chainName,
-            rpcUrl: rpcConnection?.url ?? 'unknown',
+            // API key 在路径中，调试输出只保留脱敏后的 endpoint。
+            rpcUrl: rawUrl.replace(/\/v1\/[^/?#]+/, '/v1/***'),
         };
     }
 }

package/dist/core/clients/merkle.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/clients/merkle.test.js

@@ -0,0 +1,8 @@
+import { describe, expect, it } from 'vitest';
+import { MerkleClient } from './merkle.js';
+describe('MerkleClient endpoint', () => {
+    it('默认使用带 apiKey 的 Blink BSC bundle RPC', () => {
+        const client = new MerkleClient({ apiKey: 'test-key', chainId: 56 });
+        expect(client.getProviderInfo().rpcUrl).toContain('https://bsc.blinklabs.xyz/v1/***');
+    });
+});

package/dist/core/nonce/nonce-manager.d.ts

@@ -14,6 +14,8 @@ export declare class NonceManager {
     private readOnchainNonce;
     getNextNonce(wallet: Wallet | string): Promise<number>;
     getNextNonceBatch(wallet: Wallet | string, count: number): Promise<number[]>;
+    /** 预填某个地址的下一个 nonce（用于调用方显式 startNonce 的并行场景）。 */
+    seedNextNonce(wallet: Wallet | string, nextNonce: number): void;
     clearTemp(): void;
     getTempCachedNonce(address: string): number | undefined;
     getNextNoncesForWallets(wallets: (Wallet | string)[]): Promise<number[]>;