four-flap-meme-sdk 1.2.91 → 1.2.92

package/dist/contracts/tm-bundle-merkle/index.d.ts

@@ -9,5 +9,5 @@ export { fourPrivateBuyMerkle, fourPrivateSellMerkle, fourBatchPrivateBuyMerkle,
 export { disperseWithBundleMerkle, sweepWithBundleMerkle } from './utils.js';
 export { fourPancakeProxyBatchBuyMerkle, fourPancakeProxyBatchSellMerkle, approveFourPancakeProxy, approveFourPancakeProxyBatch } from './pancake-proxy.js';
 export { approveFourTokenManagerBatch, type ApproveFourTokenManagerBatchParams, type ApproveFourTokenManagerBatchResult } from './approve-tokenmanager.js';
-export { submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, type MerkleSubmitConfig, type SubmitBundleResult } from './submit.js';
+export { submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, type MerkleSubmitConfig, type SubmitBundleResult, submitDirectToRpc, submitDirectToRpcParallel, type DirectSubmitConfig, type DirectSubmitResult, type DirectTxResult } from './submit.js';
 export { fourBundleBuyFirstMerkle, type FourBundleBuyFirstSignParams, type FourBuyFirstSignConfig, type FourBuyFirstResult } from './swap-buy-first.js';

package/dist/contracts/tm-bundle-merkle/index.js

@@ -16,6 +16,8 @@ export { fourPancakeProxyBatchBuyMerkle, fourPancakeProxyBatchSellMerkle, approv
 // TokenManager 授权方法
 export { approveFourTokenManagerBatch } from './approve-tokenmanager.js';
 // Bundle提交方法（服务器端使用）
-export { submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel } from './submit.js';
+export { submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, 
+// ✅ Monad 等链的逐笔广播方法
+submitDirectToRpc, submitDirectToRpcParallel } from './submit.js';
 // 先买后卖换手方法
 export { fourBundleBuyFirstMerkle } from './swap-buy-first.js';

package/dist/contracts/tm-bundle-merkle/submit.d.ts

@@ -2,6 +2,7 @@
  * 独立的Bundle提交方法
  *
  * 用于服务器端接收前端构建的签名交易后，提交到Merkle
+ * 以及 Monad 等不支持 Bundle 的链的逐笔广播
  */
 /**
  * 精简的Merkle提交配置（只包含提交需要的字段）
@@ -86,3 +87,89 @@ export declare function submitMultipleBundles(bundles: string[][], config: Merkl
  * @returns Bundle提交结果数组
  */
 export declare function submitMultipleBundlesParallel(bundles: string[][], config: MerkleSubmitConfig): Promise<SubmitBundleResult[]>;
+/**
+ * 逐笔广播配置（用于不支持 Bundle 的链，如 Monad）
+ */
+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;
+}
+/**
+ * 逐笔广播提交结果
+ */
+export interface DirectSubmitResult {
+    /** 提交状态：至少有一笔成功则为true */
+    code: boolean;
+    /** 交易总数 */
+    totalTransactions: number;
+    /** 成功数量 */
+    successCount: number;
+    /** 失败数量 */
+    failedCount: number;
+    /** 交易哈希列表（成功的交易） */
+    txHashes: string[];
+    /** 每笔交易的详细结果 */
+    results: DirectTxResult[];
+    /** 错误摘要（如果有失败） */
+    errorSummary?: string;
+}
+/**
+ * 逐笔广播到 RPC（用于不支持 Bundle 的链，如 Monad）
+ *
+ * 这个方法接收前端构建和签名好的交易，逐笔广播到 RPC 节点
+ *
+ * @param signedTransactions 签名后的交易数组
+ * @param config 直接广播配置
+ * @returns 广播结果
+ *
+ * @example
+ * ```typescript
+ * // 服务器端代码（Monad 链）
+ * import { submitDirectToRpc } from 'four-flap-meme-sdk';
+ *
+ * const result = await submitDirectToRpc(signedTransactions, {
+ *   rpcUrl: 'https://rpc-mainnet.monadinfra.com',
+ *   chainId: 143,
+ *   chainName: 'MONAD'
+ * });
+ *
+ * if (result.code) {
+ *   console.log('✅ 广播成功:', result.successCount, '/', result.totalTransactions);
+ *   console.log('交易哈希:', result.txHashes);
+ * } else {
+ *   console.error('❌ 全部广播失败:', result.errorSummary);
+ * }
+ * ```
+ */
+export declare function submitDirectToRpc(signedTransactions: string[], config: DirectSubmitConfig): Promise<DirectSubmitResult>;
+/**
+ * 并行逐笔广播到 RPC（速度更快，但可能有 nonce 冲突）
+ *
+ * ⚠️ 注意：仅适用于不同钱包的交易，同一钱包的多笔交易应使用顺序广播
+ *
+ * @param signedTransactions 签名后的交易数组
+ * @param config 直接广播配置
+ * @returns 广播结果
+ */
+export declare function submitDirectToRpcParallel(signedTransactions: string[], config: DirectSubmitConfig): Promise<DirectSubmitResult>;

package/dist/contracts/tm-bundle-merkle/submit.js

@@ -2,8 +2,10 @@
  * 独立的Bundle提交方法
  *
  * 用于服务器端接收前端构建的签名交易后，提交到Merkle
+ * 以及 Monad 等不支持 Bundle 的链的逐笔广播
  */
 import { MerkleClient } from '../../clients/merkle.js';
+import { ethers } from 'ethers';
 /**
  * 提交已签名的交易到Merkle（服务器端使用）
  *
@@ -109,3 +111,188 @@ export async function submitMultipleBundlesParallel(bundles, config) {
     const promises = bundles.map(signedTransactions => submitBundleToMerkle(signedTransactions, config));
     return await Promise.all(promises);
 }
+/**
+ * 逐笔广播到 RPC（用于不支持 Bundle 的链，如 Monad）
+ *
+ * 这个方法接收前端构建和签名好的交易，逐笔广播到 RPC 节点
+ *
+ * @param signedTransactions 签名后的交易数组
+ * @param config 直接广播配置
+ * @returns 广播结果
+ *
+ * @example
+ * ```typescript
+ * // 服务器端代码（Monad 链）
+ * import { submitDirectToRpc } from 'four-flap-meme-sdk';
+ *
+ * const result = await submitDirectToRpc(signedTransactions, {
+ *   rpcUrl: 'https://rpc-mainnet.monadinfra.com',
+ *   chainId: 143,
+ *   chainName: 'MONAD'
+ * });
+ *
+ * if (result.code) {
+ *   console.log('✅ 广播成功:', result.successCount, '/', result.totalTransactions);
+ *   console.log('交易哈希:', result.txHashes);
+ * } else {
+ *   console.error('❌ 全部广播失败:', result.errorSummary);
+ * }
+ * ```
+ */
+export async function submitDirectToRpc(signedTransactions, config) {
+    const totalTransactions = signedTransactions?.length ?? 0;
+    // 验证输入
+    if (!signedTransactions || signedTransactions.length === 0) {
+        return {
+            code: false,
+            totalTransactions: 0,
+            successCount: 0,
+            failedCount: 0,
+            txHashes: [],
+            results: [],
+            errorSummary: 'signedTransactions cannot be empty'
+        };
+    }
+    if (!config.rpcUrl) {
+        return {
+            code: false,
+            totalTransactions,
+            successCount: 0,
+            failedCount: totalTransactions,
+            txHashes: [],
+            results: [],
+            errorSummary: 'rpcUrl is required in config'
+        };
+    }
+    const chainId = config.chainId ?? 143;
+    const chainName = config.chainName ?? 'MONAD';
+    // 创建 Provider
+    const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
+        chainId,
+        name: chainName
+    });
+    const results = [];
+    const txHashes = [];
+    const errors = [];
+    // 逐笔广播
+    for (let i = 0; i < signedTransactions.length; i++) {
+        const signedTx = signedTransactions[i];
+        try {
+            // 广播交易
+            const txResponse = await provider.broadcastTransaction(signedTx);
+            results.push({
+                index: i,
+                success: true,
+                txHash: txResponse.hash
+            });
+            txHashes.push(txResponse.hash);
+            console.log(`✅ [${chainName}] 交易 ${i + 1}/${totalTransactions} 广播成功: ${txResponse.hash}`);
+            // 如果需要等待确认
+            if (config.waitForConfirmation) {
+                try {
+                    const receipt = await provider.waitForTransaction(txResponse.hash, 1, config.confirmationTimeout ?? 30000);
+                    if (receipt && receipt.status === 0) {
+                        console.warn(`⚠️ [${chainName}] 交易 ${txResponse.hash} 执行失败（已上链但状态为0）`);
+                    }
+                }
+                catch (waitError) {
+                    console.warn(`⚠️ [${chainName}] 等待交易确认超时: ${txResponse.hash}`);
+                }
+            }
+        }
+        catch (error) {
+            const errorMessage = error?.message || String(error);
+            results.push({
+                index: i,
+                success: false,
+                error: errorMessage
+            });
+            errors.push(`交易 ${i + 1}: ${errorMessage}`);
+            console.error(`❌ [${chainName}] 交易 ${i + 1}/${totalTransactions} 广播失败:`, errorMessage);
+        }
+    }
+    const successCount = txHashes.length;
+    const failedCount = totalTransactions - successCount;
+    return {
+        code: successCount > 0,
+        totalTransactions,
+        successCount,
+        failedCount,
+        txHashes,
+        results,
+        errorSummary: errors.length > 0 ? errors.join('; ') : undefined
+    };
+}
+/**
+ * 并行逐笔广播到 RPC（速度更快，但可能有 nonce 冲突）
+ *
+ * ⚠️ 注意：仅适用于不同钱包的交易，同一钱包的多笔交易应使用顺序广播
+ *
+ * @param signedTransactions 签名后的交易数组
+ * @param config 直接广播配置
+ * @returns 广播结果
+ */
+export async function submitDirectToRpcParallel(signedTransactions, config) {
+    const totalTransactions = signedTransactions?.length ?? 0;
+    if (!signedTransactions || signedTransactions.length === 0) {
+        return {
+            code: false,
+            totalTransactions: 0,
+            successCount: 0,
+            failedCount: 0,
+            txHashes: [],
+            results: [],
+            errorSummary: 'signedTransactions cannot be empty'
+        };
+    }
+    if (!config.rpcUrl) {
+        return {
+            code: false,
+            totalTransactions,
+            successCount: 0,
+            failedCount: totalTransactions,
+            txHashes: [],
+            results: [],
+            errorSummary: 'rpcUrl is required in config'
+        };
+    }
+    const chainId = config.chainId ?? 143;
+    const chainName = config.chainName ?? 'MONAD';
+    const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
+        chainId,
+        name: chainName
+    });
+    // 并行广播
+    const broadcastPromises = signedTransactions.map(async (signedTx, i) => {
+        try {
+            const txResponse = await provider.broadcastTransaction(signedTx);
+            return {
+                index: i,
+                success: true,
+                txHash: txResponse.hash
+            };
+        }
+        catch (error) {
+            return {
+                index: i,
+                success: false,
+                error: error?.message || String(error)
+            };
+        }
+    });
+    const results = await Promise.all(broadcastPromises);
+    const txHashes = results.filter(r => r.success && r.txHash).map(r => r.txHash);
+    const errors = results.filter(r => !r.success).map(r => `交易 ${r.index + 1}: ${r.error}`);
+    const successCount = txHashes.length;
+    const failedCount = totalTransactions - successCount;
+    console.log(`📤 [${chainName}] 并行广播完成: ${successCount}/${totalTransactions} 成功`);
+    return {
+        code: successCount > 0,
+        totalTransactions,
+        successCount,
+        failedCount,
+        txHashes,
+        results,
+        errorSummary: errors.length > 0 ? errors.join('; ') : undefined
+    };
+}

package/dist/index.d.ts

@@ -42,3 +42,4 @@ export { fourBundleBuyFirstMerkle, type FourBuyFirstConfig, type FourBundleBuyFi
 export { flapBundleBuyFirstMerkle, type FlapBuyFirstSignConfig, type FlapBuyFirstConfig, type FlapBundleBuyFirstSignParams, type FlapBundleBuyFirstParams, type FlapBuyFirstResult } from './flap/portal-bundle-merkle/swap-buy-first.js';
 export { pancakeBundleBuyFirstMerkle, type PancakeBuyFirstSignConfig, type PancakeBuyFirstConfig, type PancakeBundleBuyFirstSignParams, type PancakeBundleBuyFirstParams, type PancakeBuyFirstResult } from './pancake/bundle-buy-first.js';
 export { PROFIT_CONFIG } from './utils/constants.js';
+export { submitDirectToRpc, submitDirectToRpcParallel, type DirectSubmitConfig, type DirectSubmitResult, type DirectTxResult } from './contracts/tm-bundle-merkle/submit.js';

package/dist/index.js

@@ -62,3 +62,5 @@ export { flapBundleBuyFirstMerkle } from './flap/portal-bundle-merkle/swap-buy-f
 export { pancakeBundleBuyFirstMerkle } from './pancake/bundle-buy-first.js';
 // ✅ 硬编码利润配置（统一管理）
 export { PROFIT_CONFIG } from './utils/constants.js';
+// ✅ Monad 等不支持 Bundle 的链：逐笔 RPC 广播方法（服务器端使用）
+export { submitDirectToRpc, submitDirectToRpcParallel } from './contracts/tm-bundle-merkle/submit.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "four-flap-meme-sdk",
-  "version": "1.2.91",
+  "version": "1.2.92",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",