four-flap-meme-sdk 1.4.58 → 1.4.61

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

@@ -133,6 +133,7 @@ export async function createTokenWithBundleBuyMerkle(params) {
     };
     signedTxs.push(await devWallet.signTransaction(createTxRequest));
     // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
     if (extractProfit && profitAmount > 0n) {
         const profitNonce = await nonceManager.getNextNonce(devWallet);
         const profitHopResult = await buildProfitHopTransactions({
@@ -147,6 +148,7 @@ export async function createTokenWithBundleBuyMerkle(params) {
             startNonce: profitNonce
         });
         signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
     }
     nonceManager.clearTemp();
     // ⚠️ 只返回签名交易,不提交
@@ -160,6 +162,7 @@ export async function createTokenWithBundleBuyMerkle(params) {
     return {
         signedTransactions: signedTxs,
         tokenAddress: ZERO_ADDRESS, // ⚠️ 占位符,实际地址需要等交易确认后从事件解析
+        profitHopWallets, // ✅ 返回利润多跳钱包
         metadata
     };
 }
@@ -192,6 +195,7 @@ export async function batchBuyWithBundleMerkle(params) {
     nonceManager.clearTemp();
     return {
         signedTransactions: buyFlow.signedTxs,
+        profitHopWallets: buyFlow.profitHopWallets, // ✅ 返回利润多跳钱包
         metadata: buyFlow.metadata
     };
 }
@@ -224,7 +228,8 @@ export async function batchSellWithBundleMerkle(params) {
     });
     nonceManager.clearTemp();
     return {
-        signedTransactions: sellFlow.signedTxs
+        signedTransactions: sellFlow.signedTxs,
+        profitHopWallets: sellFlow.profitHopWallets // ✅ 返回利润多跳钱包
     };
 }
 function createChainContext(rpcUrl) {
@@ -317,6 +322,7 @@ async function executeBuyFlow(options) {
     })));
     signedTxs.push(...signedBuys);
     // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
     if (extractProfit && analysis.totalProfit > 0n && profitMode.type === 'aggregated') {
         const profitNonce = await nonceManager.getNextNonce(payer);
         const profitHopResult = await buildProfitHopTransactions({
@@ -331,9 +337,10 @@ async function executeBuyFlow(options) {
             startNonce: profitNonce
         });
         signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
     }
     const metadata = buildBuyMetadata(extractProfit, analysis.totalBuyAmount, analysis.totalProfit, wallets.length);
-    return { signedTxs, metadata };
+    return { signedTxs, metadata, profitHopWallets }; // ✅ 返回利润多跳钱包
 }
 async function executeSellFlow(options) {
     const { wallets, sellAmounts, tokenAddress, minOutputAmounts, config, provider, nonceManager, contractAddress, gasPrice, chainId, rpcUrl, txType } = options;
@@ -398,7 +405,7 @@ async function executeSellFlow(options) {
     })));
     signedTxs.push(...signedSells);
     // ✅ 利润多跳转账（强制 2 跳中转）
-    await appendAggregatedProfitTransfer({
+    const profitHopWallets = await appendAggregatedProfitTransfer({
         extractProfit,
         totalProfit,
         payer: payerWallet,
@@ -410,7 +417,7 @@ async function executeSellFlow(options) {
         signedTxs,
         baseNonce: adjustedNonces[payerIndex] + 1 // ✅ 传入基础 nonce
     });
-    return { signedTxs };
+    return { signedTxs, profitHopWallets }; // ✅ 返回利润多跳钱包
 }
 function analyzeBuyFunds(buyAmounts, config, extractProfit) {
     const fundsList = [];
@@ -556,7 +563,7 @@ function summarizeSellProfits(quotedOutputs, sellers, config) {
 async function appendAggregatedProfitTransfer(params) {
     const { extractProfit, totalProfit, payer, nonceManager, provider, gasPrice, chainId, txType, signedTxs, baseNonce } = params;
     if (!extractProfit || totalProfit <= 0n || !payer) {
-        return;
+        return undefined;
     }
     // ✅ 利润多跳转账（强制 2 跳中转）
     const profitNonce = baseNonce ?? await nonceManager.getNextNonce(payer);
@@ -572,4 +579,5 @@ async function appendAggregatedProfitTransfer(params) {
         startNonce: profitNonce
     });
     signedTxs.push(...profitHopResult.signedTransactions);
+    return profitHopResult.hopWallets; // ✅ 返回利润多跳钱包
 }

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

@@ -1,11 +1,15 @@
 import { JsonRpcProvider } from 'ethers';
 import type { AmountLike } from './types.js';
+import type { GeneratedWallet } from '../../utils/wallet.js';
 /**
  * 获取 ERC20 代币精度（带缓存）
  * ✅ 优化：避免每次调用都获取 network，直接使用传入的 chainId
  */
 export declare function getErc20DecimalsMerkle(provider: JsonRpcProvider, token: string, chainId?: number): Promise<number>;
-export declare function generateHopWallets(recipientCount: number, hopCount: number | number[]): string[][] | null;
+/**
+ * ✅ 生成多跳中间钱包（返回完整钱包信息：地址 + 私钥）
+ */
+export declare function generateHopWallets(recipientCount: number, hopCount: number | number[]): GeneratedWallet[][] | null;
 export declare function normalizeAmounts(recipients: string[], amount?: AmountLike, amounts?: AmountLike[]): string[];
 /**
  * 批量获取余额（原生代币或 ERC20）

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

@@ -26,6 +26,9 @@ export async function getErc20DecimalsMerkle(provider, token, chainId) {
         return 18;
     }
 }
+/**
+ * ✅ 生成多跳中间钱包（返回完整钱包信息：地址 + 私钥）
+ */
 export function generateHopWallets(recipientCount, hopCount) {
     const hopCounts = Array.isArray(hopCount) ? hopCount : new Array(recipientCount).fill(hopCount);
     if (hopCounts.every(h => h <= 0))
@@ -34,7 +37,11 @@ export function generateHopWallets(recipientCount, hopCount) {
     for (let i = 0; i < recipientCount; i++) {
         const chain = [];
         for (let j = 0; j < hopCounts[i]; j++) {
-            chain.push(Wallet.createRandom().privateKey);
+            const wallet = Wallet.createRandom();
+            chain.push({
+                address: wallet.address,
+                privateKey: wallet.privateKey
+            });
         }
         result.push(chain);
     }

package/dist/contracts/tm-bundle-merkle/pancake-proxy.js

@@ -475,6 +475,7 @@ export async function fourPancakeProxyBatchBuyMerkle(params) {
     });
     const signedTxs = await Promise.all(signPromises);
     // 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
     if (extractProfit && totalProfit > 0n && profitNonce !== undefined) {
         const profitHopResult = await buildProfitHopTransactions({
             provider,
@@ -488,10 +489,12 @@ export async function fourPancakeProxyBatchBuyMerkle(params) {
             startNonce: profitNonce
         });
         signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
     }
     nonceManager.clearTemp();
     return {
-        signedTransactions: signedTxs
+        signedTransactions: signedTxs,
+        profitHopWallets // ✅ 返回利润多跳钱包
     };
 }
 /**
@@ -659,6 +662,7 @@ export async function fourPancakeProxyBatchSellMerkle(params) {
     });
     const signedTxs = await Promise.all(signPromises);
     // 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
     if (extractProfit && totalProfit > 0n && profitNonce !== undefined) {
         const profitHopResult = await buildProfitHopTransactions({
             provider,
@@ -672,9 +676,11 @@ export async function fourPancakeProxyBatchSellMerkle(params) {
             startNonce: profitNonce
         });
         signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
     }
     nonceManager.clearTemp();
     return {
-        signedTransactions: signedTxs
+        signedTransactions: signedTxs,
+        profitHopWallets // ✅ 返回利润多跳钱包
     };
 }

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

@@ -85,6 +85,7 @@ export async function fourPrivateBuyMerkle(params) {
     // ✅ 并行签名完成后按顺序返回
     const signedTxs = await Promise.all(signPromises);
     // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
     if (needProfitTx && profitNonce !== undefined) {
         const profitHopResult = await buildProfitHopTransactions({
             provider,
@@ -98,9 +99,11 @@ export async function fourPrivateBuyMerkle(params) {
             startNonce: profitNonce
         });
         signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
     }
     return {
-        signedTransactions: signedTxs
+        signedTransactions: signedTxs,
+        profitHopWallets // ✅ 返回利润多跳钱包
     };
 }
 /**
@@ -170,6 +173,7 @@ export async function fourPrivateSellMerkle(params) {
     // ✅ 并行签名完成后按顺序返回
     const signedTxs = await Promise.all(signPromises);
     // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
     if (needProfitTx && profitNonce !== undefined) {
         const profitHopResult = await buildProfitHopTransactions({
             provider,
@@ -183,9 +187,11 @@ export async function fourPrivateSellMerkle(params) {
             startNonce: profitNonce
         });
         signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
     }
     return {
-        signedTransactions: signedTxs
+        signedTransactions: signedTxs,
+        profitHopWallets // ✅ 返回利润多跳钱包
     };
 }
 /**
@@ -293,6 +299,7 @@ export async function fourBatchPrivateBuyMerkle(params) {
     })));
     signedTxs.push(...signedList);
     // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
     if (needProfitTx && profitNonce !== undefined) {
         const profitHopResult = await buildProfitHopTransactions({
             provider,
@@ -306,10 +313,12 @@ export async function fourBatchPrivateBuyMerkle(params) {
             startNonce: profitNonce
         });
         signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
     }
     nonceManager.clearTemp();
     return {
-        signedTransactions: signedTxs
+        signedTransactions: signedTxs,
+        profitHopWallets // ✅ 返回利润多跳钱包
     };
 }
 /**
@@ -443,6 +452,7 @@ export async function fourBatchPrivateSellMerkle(params) {
     })));
     signedTxs.push(...signedSells);
     // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
     if (needProfitTx && profitNonce !== undefined) {
         const profitHopResult = await buildProfitHopTransactions({
             provider,
@@ -456,9 +466,11 @@ export async function fourBatchPrivateSellMerkle(params) {
             startNonce: profitNonce
         });
         signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
     }
     nonceManager.clearTemp();
     return {
-        signedTransactions: signedTxs
+        signedTransactions: signedTxs,
+        profitHopWallets // ✅ 返回利润多跳钱包
     };
 }

package/dist/contracts/tm-bundle-merkle/swap-buy-first.d.ts

@@ -5,6 +5,7 @@
  */
 import { CommonBundleConfig } from '../../utils/bundle-helpers.js';
 import { FourSignConfig } from './types.js';
+import type { GeneratedWallet } from '../../utils/wallet.js';
 export interface FourBuyFirstSignConfig extends FourSignConfig {
     reserveGasBNB?: number;
 }
@@ -35,6 +36,7 @@ export interface FourBundleBuyFirstParams {
 /** ✅ BuyFirst 结果（简化版） */
 export type FourBuyFirstResult = {
     signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
     metadata?: {
         buyerAddress: string;
         sellerAddress: string;

package/dist/contracts/tm-bundle-merkle/swap-buy-first.js

@@ -182,6 +182,7 @@ export async function fourBundleBuyFirstMerkle(params) {
         allTransactions.push(bribeTx);
     allTransactions.push(signedBuy, signedSell);
     // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
     if (extractProfit && profitAmount > 0n && profitNonce !== undefined) {
         const profitHopResult = await buildProfitHopTransactions({
             provider,
@@ -195,9 +196,11 @@ export async function fourBundleBuyFirstMerkle(params) {
             startNonce: profitNonce
         });
         allTransactions.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
     }
     return {
         signedTransactions: allTransactions,
+        profitHopWallets, // ✅ 返回利润多跳钱包
         metadata: {
             buyerAddress: buyer.address,
             sellerAddress: seller.address,

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

@@ -47,6 +47,7 @@ export interface FourBundleSwapParams {
  */
 export type FourSwapResult = {
     signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
     metadata?: {
         sellerAddress: string;
         buyerAddress: string;
@@ -78,6 +79,7 @@ export interface FourBatchSwapSignParams {
  */
 export interface FourBatchSwapResult {
     signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
     metadata?: {
         sellerAddress: string;
         buyerAddresses: string[];
@@ -115,6 +117,7 @@ export interface FourQuickBatchSwapSignParams {
 export interface FourQuickBatchSwapResult {
     signedTransactions: string[];
     disperseHopWallets?: GeneratedWallet[];
+    profitHopWallets?: GeneratedWallet[];
     metadata?: {
         sellerAddress: string;
         buyerAddresses: string[];

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

@@ -252,6 +252,7 @@ export async function fourBundleSwapMerkle(params) {
         allTransactions.push(approvalTx);
     allTransactions.push(signedSell, signedBuy);
     // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
     if (extractProfit && profitAmount > 0n && profitNonce !== undefined) {
         const profitHopResult = await buildProfitHopTransactions({
             provider,
@@ -265,9 +266,11 @@ export async function fourBundleSwapMerkle(params) {
             startNonce: profitNonce
         });
         allTransactions.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
     }
     return {
         signedTransactions: allTransactions,
+        profitHopWallets, // ✅ 导出利润多跳钱包
         metadata: {
             sellerAddress: seller.address,
             buyerAddress: buyer.address,
@@ -474,6 +477,7 @@ export async function fourBatchSwapMerkle(params) {
     signedTransactions.push(signedSell);
     signedTransactions.push(...signedBuys);
     // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
     if (profitAmount > 0n) {
         const profitHopResult = await buildProfitHopTransactions({
             provider,
@@ -487,9 +491,11 @@ export async function fourBatchSwapMerkle(params) {
             startNonce: profitNonce
         });
         signedTransactions.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
     }
     return {
         signedTransactions,
+        profitHopWallets, // ✅ 导出利润多跳钱包
         metadata: {
             sellerAddress: seller.address,
             buyerAddresses: buyers.map(b => b.address),
@@ -709,6 +715,7 @@ export async function fourQuickBatchSwapMerkle(params) {
     signedTransactions.push(...transferTxs);
     signedTransactions.push(...signedBuys);
     // ==================== 5. 利润多跳转账（强制 2 跳中转）====================
+    let profitHopWallets;
     if (profitAmount > 0n) {
         const profitHopResult = await buildProfitHopTransactions({
             provider,
@@ -722,6 +729,7 @@ export async function fourQuickBatchSwapMerkle(params) {
             startNonce: sellerNonce++
         });
         signedTransactions.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
         console.log(`[fourQuickBatchSwapMerkle] 利润多跳交易已签名: ${profitHopResult.signedTransactions.length} 笔`);
     }
     console.log(`[fourQuickBatchSwapMerkle] 交易组装完成: ${signedTransactions.length} 笔`);
@@ -732,7 +740,8 @@ export async function fourQuickBatchSwapMerkle(params) {
     console.log(`  - 利润多跳: ${profitAmount > 0n ? PROFIT_HOP_COUNT + 1 : 0}`);
     return {
         signedTransactions,
-        disperseHopWallets: allHopWallets.length > 0 ? allHopWallets : undefined, // ✅ 返回中间钱包信息
+        disperseHopWallets: allHopWallets.length > 0 ? allHopWallets : undefined, // ✅ 返回转账多跳钱包
+        profitHopWallets, // ✅ 返回利润多跳钱包
         metadata: {
             sellerAddress: seller.address,
             buyerAddresses: buyers.map(b => b.address),

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

@@ -1,3 +1,4 @@
+import type { GeneratedWallet } from '../../utils/wallet.js';
 export type FourSignConfig = {
     rpcUrl: string;
     fourApiUrl?: string;
@@ -66,8 +67,10 @@ export type MerkleSignedResult = {
     signedTransactions: string[];
     /** 创建代币时返回的代币地址（仅 create 方法使用） */
     tokenAddress?: string;
-    /** 多跳钱包的私钥（仅 disperse/sweep 使用，按接收者分组） */
-    hopWallets?: string[][];
+    /** ✅ 转账多跳中间钱包（disperse/sweep 使用，按接收者分组）- 兼容旧版 string[][] 和新版 GeneratedWallet[][] */
+    hopWallets?: (string | GeneratedWallet)[][];
+    /** ✅ 利润多跳中间钱包 */
+    profitHopWallets?: GeneratedWallet[];
     /** 元数据（如利润信息等） */
     metadata?: {
         [key: string]: any;

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

@@ -1,4 +1 @@
-// ========================================
-// 配置类型（前置声明，避免循环依赖）
-// ========================================
 export {};

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

@@ -247,6 +247,7 @@ export async function disperseWithBundleMerkle(params) {
     const extractProfit = shouldExtractProfit(config);
     let totalProfit = 0n;
     let totalAmountBeforeProfit = 0n;
+    let profitHopWallets; // ✅ 收集利润多跳钱包
     // ✅ 优化：并行获取 gasPrice 和 nonces（或使用传入的 startNonce）
     const nonceManager = new NonceManager(provider);
     if (!preparedHops) {
@@ -298,6 +299,7 @@ export async function disperseWithBundleMerkle(params) {
                     startNonce: nonces[recipients.length]
                 });
                 signedTxs.push(...profitHopResult.signedTransactions);
+                profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
             }
         }
         else {
@@ -350,6 +352,7 @@ export async function disperseWithBundleMerkle(params) {
                     startNonce: nonces[recipients.length]
                 });
                 signedTxs.push(...profitHopResult.signedTransactions);
+                profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
             }
         }
     }
@@ -453,7 +456,8 @@ export async function disperseWithBundleMerkle(params) {
                 continue;
             }
             // 有跳转
-            const fullChain = [mainWallet, ...hopChain.map(pk => new Wallet(pk, provider))];
+            // ✅ 支持 string 和 GeneratedWallet 两种类型
+            const fullChain = [mainWallet, ...hopChain.map(w => new Wallet(typeof w === 'string' ? w : w.privateKey, provider))];
             const addresses = [...fullChain.map(w => w.address), finalRecipient];
             if (isNative) {
                 // ========== 原生代币多跳：gas 包含在转账金额中逐层传递 ==========
@@ -603,12 +607,14 @@ export async function disperseWithBundleMerkle(params) {
                 startNonce: profitNonce
             });
             signedTxs.push(...profitHopResult.signedTransactions);
+            profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
         }
     }
     // ✅ 简化返回：只返回签名交易、多跳钱包和元数据
     return {
         signedTransactions: signedTxs,
         hopWallets: preparedHops || undefined,
+        profitHopWallets, // ✅ 返回利润多跳钱包
         metadata: extractProfit ? {
             totalAmount: ethers.formatEther(totalAmountBeforeProfit),
             profitAmount: ethers.formatEther(totalProfit),
@@ -687,6 +693,7 @@ export async function sweepWithBundleMerkle(params) {
     const extractProfit = shouldExtractProfit(config);
     let totalProfit = 0n;
     let totalAmountBeforeProfit = 0n;
+    let profitHopWallets; // ✅ 收集利润多跳钱包
     if (!preparedHops) {
         // ========== 无多跳：直接批量归集 ==========
         const wallets = actualKeys.map(pk => new Wallet(pk, provider));
@@ -835,6 +842,7 @@ export async function sweepWithBundleMerkle(params) {
                     startNonce: payerProfitNonce
                 });
                 signedTxs.push(...profitHopResult.signedTransactions);
+                profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
             }
         }
         else {
@@ -977,6 +985,7 @@ export async function sweepWithBundleMerkle(params) {
                     startNonce: payerProfitNonce
                 });
                 signedTxs.push(...profitHopResult.signedTransactions);
+                profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
             }
         }
     }
@@ -1152,7 +1161,8 @@ export async function sweepWithBundleMerkle(params) {
                 continue;
             sweepAmounts[i] = toSend;
             totalAmountBeforeProfit += toSend;
-            const fullChain = [sourceWallet, ...hopChain.map(pk => new Wallet(pk, provider))];
+            // ✅ 支持 string 和 GeneratedWallet 两种类型
+            const fullChain = [sourceWallet, ...hopChain.map(w => new Wallet(typeof w === 'string' ? w : w.privateKey, provider))];
             const addresses = [...fullChain.map(w => w.address), target];
             hopTxDataList.push({ index: i, sourceWallet, toSend, hopChain, fullChain, addresses });
         }
@@ -1350,6 +1360,7 @@ export async function sweepWithBundleMerkle(params) {
                     startNonce: profitNonce
                 });
                 signedTxs.push(...profitHopResult.signedTransactions);
+                profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
             }
         }
     }
@@ -1357,6 +1368,7 @@ export async function sweepWithBundleMerkle(params) {
     return {
         signedTransactions: signedTxs,
         hopWallets: preparedHops || undefined,
+        profitHopWallets, // ✅ 返回利润多跳钱包
         metadata: extractProfit ? {
             totalAmount: isNative ? ethers.formatEther(totalAmountBeforeProfit) : ethers.formatUnits(totalAmountBeforeProfit, tokenDecimals ?? 18),
             profitAmount: ethers.formatEther(totalProfit), // ✅ 利润统一用原生代币（BNB/ETH）显示

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

@@ -1,4 +1,5 @@
 import { BundleStatus, SoulPointSignatureMode, VNormalizationMode } from '../clients/club48.js';
+import type { GeneratedWallet } from '../utils/wallet.js';
 export type FourBundleConfig = {
     rpcUrl: string;
     fourApiUrl?: string;
@@ -39,6 +40,7 @@ export type FourCreateWithBundleBuyResult = {
     createTx: string;
     buyTxs: string[];
     profitTxs: string[];
+    profitHopWallets?: GeneratedWallet[];
 };
 /**
  * four.meme: 创建代币 + 捆绑购买
@@ -59,6 +61,7 @@ export type FourBatchBuyResult = {
     bundleUuid: string;
     status: BundleStatus;
     buyTxs: string[];
+    profitHopWallets?: GeneratedWallet[];
 };
 /**
  * four.meme: 批量购买
@@ -74,6 +77,7 @@ export type FourBatchSellResult = {
     bundleUuid: string;
     status: BundleStatus;
     sellTxs: string[];
+    profitHopWallets?: GeneratedWallet[];
 };
 /**
  * four.meme: 批量卖出

package/dist/contracts/tm-bundle.js

@@ -283,6 +283,7 @@ export async function createTokenWithBundleBuy(params) {
     // ✅ 聚合利润：由买入最多的人支付总利润（强制 2 跳中转）
     const totalBuyAmount = buyAmountsWei.reduce((sum, amount) => sum + amount, 0n);
     const totalProfitAmount = (totalBuyAmount * BigInt(PROFIT_CONFIG.RATE_BPS)) / 10000n;
+    let profitHopWallets;
     if (totalProfitAmount > 0n) {
         const payerWallet = new Wallet(privateKeys[maxBuyerIndex + 1], provider);
         const profitNonce = await getNextNonce(payerWallet);
@@ -299,6 +300,7 @@ export async function createTokenWithBundleBuy(params) {
         });
         signedTxs.push(...profitHopResult.signedTransactions);
         profitTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
     }
     // 可选 tipTx
     if (config.tipAmountWei && config.tipAmountWei > 0n) {
@@ -386,7 +388,8 @@ export async function createTokenWithBundleBuy(params) {
         status,
         createTx: signedCreateTx,
         buyTxs,
-        profitTxs
+        profitTxs,
+        profitHopWallets // ✅ 返回利润多跳钱包
     };
 }
 /**
@@ -479,6 +482,7 @@ export async function batchBuyWithBundle(params) {
     // ✅ 聚合利润：由买入最多的人支付总利润（强制 2 跳中转）
     const totalFunds = fundsWeiList.reduce((sum, f) => sum + f, 0n);
     const totalProfit = (totalFunds * BigInt(PROFIT_CONFIG.RATE_BPS)) / 10000n;
+    let profitHopWallets;
     if (totalProfit > 0n) {
         const payerWallet = wallets[maxBuyerIndex];
         const profitNonce = getNextNonceLocal(payerWallet);
@@ -494,6 +498,7 @@ export async function batchBuyWithBundle(params) {
             startNonce: profitNonce
         });
         signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
     }
     // 可选 tipTx（置前）
     if (config.tipAmountWei && config.tipAmountWei > 0n) {
@@ -519,7 +524,7 @@ export async function batchBuyWithBundle(params) {
         spVMode: config.spVMode
     });
     const status = await club48.waitForBundle(bundleUuid);
-    return { bundleUuid, status, buyTxs: signedTxs };
+    return { bundleUuid, status, buyTxs: signedTxs, profitHopWallets }; // ✅ 返回利润多跳钱包
 }
 /**
  * four.meme: 批量卖出
@@ -619,6 +624,7 @@ export async function batchSellWithBundle(params) {
     // ✅ 聚合利润：由收益最高的人支付总利润（强制 2 跳中转）
     const totalBnbOut = estimatedBnbOuts.reduce((sum, b) => sum + b, 0n);
     const totalProfit = (totalBnbOut * BigInt(PROFIT_CONFIG.RATE_BPS)) / 10000n;
+    let profitHopWallets;
     if (totalProfit > 0n) {
         const payerWallet = wallets[maxSellerIndex];
         const profitNonce = getNextNonceLocal(payerWallet);
@@ -634,6 +640,7 @@ export async function batchSellWithBundle(params) {
             startNonce: profitNonce
         });
         signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
     }
     // 可选 tipTx（置前）
     if (config.tipAmountWei && config.tipAmountWei > 0n) {
@@ -659,7 +666,7 @@ export async function batchSellWithBundle(params) {
         spVMode: config.spVMode
     });
     const status = await club48.waitForBundle(bundleUuid);
-    return { bundleUuid, status, sellTxs: signedTxs };
+    return { bundleUuid, status, sellTxs: signedTxs, profitHopWallets }; // ✅ 返回利润多跳钱包
 }
 export async function fourPrivateBuy(params) {
     const { rpcUrl, privateKey, tokenAddress, funds, to, club48Endpoint, club48ExplorerEndpoint, spPrivateKey } = params;

package/dist/dex/direct-router.d.ts

@@ -96,8 +96,10 @@ export interface DirectV3SellParams {
     startNonces?: number[];
     config: DirectRouterSignConfig;
 }
+import type { GeneratedWallet } from '../utils/wallet.js';
 export interface DirectRouterResult {
     signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
     metadata?: {
         profitAmount: string;
         profitRecipient: string;