four-flap-meme-sdk 1.4.39 → 1.4.41

package/dist/index.js

@@ -53,6 +53,8 @@ export { generateWallets } from './utils/wallet.js';
 export { getTokenBalancesWithMulticall } from './utils/wallet.js';
 export { validatePrivateKeys } from './utils/wallet.js';
 export { stealthTransfer } from './utils/stealth-transfer.js';
+// ✅ 刷持有人（一键完成：生成钱包 → 分发资金 → 批量买入）
+export { holdersMaker, estimateHoldersMakerCost, } from './utils/holders-maker.js';
 // ✅ 私募转账签名（带贿赂和利润提取）
 export { privateSaleMerkle, batchPrivateSaleMerkle, } from './utils/private-sale.js';
 export { inspectTokenLP, getFactoryFromRouter, registerDYORSwap, registerDex, getChainConfig, } from './utils/lp-inspect.js';

package/dist/pancake/bundle-buy-first.js

@@ -4,7 +4,7 @@
  * 功能：钱包B先买入代币 → 钱包A卖出相同数量 → 原子执行
  */
 import { ethers, Contract, Wallet } from 'ethers';
-import { NonceManager, getDeadline } from '../utils/bundle-helpers.js';
+import { NonceManager, getDeadline, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../utils/bundle-helpers.js';
 import { ADDRESSES, PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA, ZERO_ADDRESS } from '../utils/constants.js';
 import { quoteV2, quoteV3, getTokenToNativeQuote, getWrappedNativeAddress } from '../utils/quote-helpers.js';
 import { V2_ROUTER_ABI, V3_ROUTER02_ABI, ERC20_BALANCE_ABI } from '../abis/common.js';
@@ -149,15 +149,6 @@ export async function pancakeBundleBuyFirstMerkle(params) {
         chainId: context.chainId,
         type: txType
     });
-    // ✅ 利润交易放在末尾
-    const profitTx = await buildProfitTransaction({
-        seller,
-        profitAmount,
-        profitNonce: noncePlan.profitNonce,
-        gasPrice,
-        chainId: context.chainId,
-        txType
-    });
     nonceManager.clearTemp();
     validateFinalBalances({
         sameAddress,
@@ -171,13 +162,23 @@ export async function pancakeBundleBuyFirstMerkle(params) {
         provider: context.provider,
         buyerAddress: buyer.address
     });
-    // ✅ 组装顺序：贿赂 → 买入 → 卖出 → 利润
+    // ✅ 组装顺序：贿赂 → 买入 → 卖出
     const allTransactions = [];
     if (bribeTx)
         allTransactions.push(bribeTx);
     allTransactions.push(signedBuy, signedSell);
-    if (profitTx)
-        allTransactions.push(profitTx);
+    // ✅ 利润多跳转账（强制 2 跳中转）
+    const profitTxs = await buildProfitTransaction({
+        provider: context.provider,
+        seller,
+        profitAmount,
+        profitNonce: noncePlan.profitNonce,
+        gasPrice,
+        chainId: context.chainId,
+        txType
+    });
+    if (profitTxs)
+        allTransactions.push(...profitTxs);
     return {
         signedTransactions: allTransactions,
         metadata: {
@@ -411,19 +412,25 @@ async function planNonces({ buyer, seller, sameAddress, extractProfit, needBribe
     ]);
     return { buyerNonce, sellerNonce };
 }
-async function buildProfitTransaction({ seller, profitAmount, profitNonce, gasPrice, chainId, txType }) {
+/**
+ * 构建利润多跳转账交易（强制 2 跳中转）
+ */
+async function buildProfitTransaction({ provider, seller, profitAmount, profitNonce, gasPrice, chainId, txType }) {
     if (profitNonce === undefined || profitAmount === 0n) {
         return null;
     }
-    return await seller.signTransaction({
-        to: PROFIT_CONFIG.RECIPIENT,
-        value: profitAmount,
-        nonce: profitNonce,
+    const profitHopResult = await buildProfitHopTransactions({
+        provider,
+        payerWallet: seller,
+        profitAmount,
+        profitRecipient: PROFIT_CONFIG.RECIPIENT,
+        hopCount: PROFIT_HOP_COUNT,
         gasPrice,
-        gasLimit: 21000n,
         chainId,
-        type: txType
+        txType,
+        startNonce: profitNonce
     });
+    return profitHopResult.signedTransactions;
 }
 async function validateFinalBalances({ sameAddress, buyerFundsWei, buyerBalance, reserveGas, gasLimit, gasPrice, useNativeToken = true, quoteTokenDecimals = 18, provider, buyerAddress }) {
     const gasCost = gasLimit * gasPrice;

package/dist/pancake/bundle-swap.js

@@ -299,7 +299,7 @@ function countTruthy(values) {
  */
 import { ethers, Contract, Wallet } from 'ethers';
 import { calculateSellAmount } from '../utils/swap-helpers.js';
-import { NonceManager, getDeadline } from '../utils/bundle-helpers.js';
+import { NonceManager, getDeadline, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../utils/bundle-helpers.js';
 import { ADDRESSES, PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA } from '../utils/constants.js';
 import { quoteV2, quoteV3 } from '../utils/quote-helpers.js';
 import { V2_ROUTER_ABI, V3_ROUTER02_ABI, ERC20_BALANCE_ABI } from '../abis/common.js';
@@ -457,25 +457,12 @@ export async function pancakeBundleSwapMerkle(params) {
         chainId: context.chainId,
         type: txType
     }).then(tx => ({ type: 'buy', tx })));
-    // 利润交易
-    if (profitAmount > 0n && noncePlan.profitNonce !== undefined) {
-        signPromises.push(seller.signTransaction({
-            to: PROFIT_CONFIG.RECIPIENT,
-            value: profitAmount,
-            nonce: noncePlan.profitNonce,
-            gasPrice,
-            gasLimit: 21000n,
-            chainId: context.chainId,
-            type: txType
-        }).then(tx => ({ type: 'profit', tx })));
-    }
     // ✅ 并行执行所有签名
     const signedResults = await Promise.all(signPromises);
     // 按类型提取结果
     const bribeTx = signedResults.find(r => r.type === 'bribe')?.tx || null;
     const signedSell = signedResults.find(r => r.type === 'sell').tx;
     const signedBuy = signedResults.find(r => r.type === 'buy').tx;
-    const profitTx = signedResults.find(r => r.type === 'profit')?.tx || null;
     nonceManager.clearTemp();
     validateFinalBalances({
         sameAddress,
@@ -489,13 +476,26 @@ export async function pancakeBundleSwapMerkle(params) {
         provider: context.provider,
         buyerAddress: buyer.address
     });
-    // ✅ 组装顺序：贿赂 → 卖出 → 买入 → 利润
+    // ✅ 组装顺序：贿赂 → 卖出 → 买入
     const signedTransactions = [];
     if (bribeTx)
         signedTransactions.push(bribeTx);
     signedTransactions.push(signedSell, signedBuy);
-    if (profitTx)
-        signedTransactions.push(profitTx);
+    // ✅ 利润多跳转账（强制 2 跳中转）
+    if (profitAmount > 0n && noncePlan.profitNonce !== undefined) {
+        const profitHopResult = await buildProfitHopTransactions({
+            provider: context.provider,
+            payerWallet: seller,
+            profitAmount,
+            profitRecipient: PROFIT_CONFIG.RECIPIENT,
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId: context.chainId,
+            txType,
+            startNonce: noncePlan.profitNonce
+        });
+        signedTransactions.push(...profitHopResult.signedTransactions);
+    }
     return {
         signedTransactions,
         metadata: {
@@ -720,23 +720,10 @@ export async function pancakeBatchSwapMerkle(params) {
         profitAmount = calculateProfitAmount(estimatedBNBValue);
         console.log(`[pancakeBatchSwapMerkle] ERC20→BNB 报价: ${ethers.formatUnits(estimatedBNBOut, quoteTokenDecimals)} → ${ethers.formatEther(estimatedBNBValue)} BNB, 利润: ${ethers.formatEther(profitAmount)} BNB`);
     }
-    let profitTx = null;
-    if (profitAmount > 0n) {
-        // ✅ 利润由卖方发送（与贿赂交易同一钱包）
-        // 如果使用 startNonces，利润 nonce = 卖出 nonce + 1
-        const profitNonce = startNonces && startNonces.length >= 1
-            ? sellNonce + 1
-            : await nonceManager.getNextNonce(seller);
-        profitTx = await seller.signTransaction({
-            to: PROFIT_CONFIG.RECIPIENT,
-            value: profitAmount,
-            nonce: profitNonce,
-            gasPrice,
-            gasLimit: 21000n,
-            chainId: context.chainId,
-            type: txType
-        });
-    }
+    // 计算利润 nonce
+    const profitNonce = profitAmount > 0n
+        ? (startNonces && startNonces.length >= 1 ? sellNonce + 1 : await nonceManager.getNextNonce(seller))
+        : undefined;
     nonceManager.clearTemp();
     // ✅ 并行签名所有交易
     // 1. 签名卖出交易
@@ -764,14 +751,27 @@ export async function pancakeBatchSwapMerkle(params) {
         signedSellPromise,
         ...signedBuyPromises
     ]);
-    // 4. 按顺序组装交易数组：贿赂 → 卖出 → 买入 → 利润
+    // 4. 按顺序组装交易数组：贿赂 → 卖出 → 买入
     const signedTransactions = [];
     if (bribeTx)
         signedTransactions.push(bribeTx); // 贿赂（首位）
     signedTransactions.push(signedSell); // 卖出
     signedTransactions.push(...signedBuys); // 多个买入
-    if (profitTx)
-        signedTransactions.push(profitTx); // 利润（末尾）
+    // ✅ 利润多跳转账（强制 2 跳中转）
+    if (profitAmount > 0n && profitNonce !== undefined) {
+        const profitHopResult = await buildProfitHopTransactions({
+            provider: context.provider,
+            payerWallet: seller,
+            profitAmount,
+            profitRecipient: PROFIT_CONFIG.RECIPIENT,
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId: context.chainId,
+            txType,
+            startNonce: profitNonce
+        });
+        signedTransactions.push(...profitHopResult.signedTransactions);
+    }
     return {
         signedTransactions,
         metadata: {
@@ -1115,38 +1115,38 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         });
     }));
     console.log(`[pancakeQuickBatchSwapMerkle] ${signedBuys.length} 笔买入交易已签名`);
-    // ==================== 5. 利润交易 ====================
-    let profitTx = null;
-    if (profitAmount > 0n) {
-        profitTx = await seller.signTransaction({
-            to: PROFIT_CONFIG.RECIPIENT,
-            value: profitAmount,
-            nonce: sellerNonce++,
-            gasPrice,
-            gasLimit: 21000n,
-            chainId: context.chainId,
-            type: txType
-        });
-        console.log(`[pancakeQuickBatchSwapMerkle] 利润交易已签名`);
-    }
     nonceManager.clearTemp();
     // ==================== 组装交易数组 ====================
-    // BNB 模式：贿赂 → 卖出 → 转账 → 买入 → 利润
-    // ERC20 模式：贿赂 → 卖出 → ERC20转账 → BNB Gas转账 → 买入 → 利润
+    // BNB 模式：贿赂 → 卖出 → 转账 → 买入 → 利润多跳
+    // ERC20 模式：贿赂 → 卖出 → ERC20转账 → BNB Gas转账 → 买入 → 利润多跳
     const signedTransactions = [];
     if (bribeTx)
         signedTransactions.push(bribeTx);
     signedTransactions.push(signedSell);
     signedTransactions.push(...transferTxs);
     signedTransactions.push(...signedBuys);
-    if (profitTx)
-        signedTransactions.push(profitTx);
+    // ==================== 5. 利润多跳转账（强制 2 跳中转）====================
+    if (profitAmount > 0n) {
+        const profitHopResult = await buildProfitHopTransactions({
+            provider: context.provider,
+            payerWallet: seller,
+            profitAmount,
+            profitRecipient: PROFIT_CONFIG.RECIPIENT,
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId: context.chainId,
+            txType,
+            startNonce: sellerNonce++
+        });
+        signedTransactions.push(...profitHopResult.signedTransactions);
+        console.log(`[pancakeQuickBatchSwapMerkle] 利润多跳交易已签名: ${profitHopResult.signedTransactions.length} 笔`);
+    }
     console.log(`[pancakeQuickBatchSwapMerkle] 交易组装完成: ${signedTransactions.length} 笔`);
     console.log(`  - 贿赂: ${bribeTx ? 1 : 0}`);
     console.log(`  - 卖出: 1`);
     console.log(`  - 转账: ${transferTxs.length}`);
     console.log(`  - 买入: ${signedBuys.length}`);
-    console.log(`  - 利润: ${profitTx ? 1 : 0}`);
+    console.log(`  - 利润多跳: ${profitAmount > 0n ? PROFIT_HOP_COUNT + 1 : 0}`);
     const outputUnit = useNativeToken ? 'BNB' : 'ERC20';
     return {
         signedTransactions,

package/dist/utils/bundle-helpers.d.ts

@@ -188,3 +188,41 @@ export declare function decodeV3Path(path: string): {
     tokens: string[];
     fees: number[];
 };
+/**
+ * 利润多跳转账配置
+ */
+export interface ProfitHopConfig {
+    provider: JsonRpcProvider;
+    payerWallet: Wallet;
+    profitAmount: bigint;
+    profitRecipient: string;
+    hopCount?: number;
+    gasPrice: bigint;
+    chainId: number;
+    txType: number;
+    startNonce?: number;
+}
+/**
+ * 利润多跳结果
+ */
+export interface ProfitHopResult {
+    signedTransactions: string[];
+    hopWallets: string[];
+    totalNonceUsed: number;
+}
+/**
+ * 强制 2 跳的利润转账常量
+ */
+export declare const PROFIT_HOP_COUNT = 2;
+/**
+ * 生成利润多跳转账交易
+ *
+ * 流程（2 跳）：
+ * 1. 支付者 → 中转1（gas + 利润 + 中转1的gas）
+ * 2. 中转1 → 中转2（gas + 利润）
+ * 3. 中转2 → 利润地址（利润）
+ *
+ * @param config 配置参数
+ * @returns 签名交易和中转钱包私钥
+ */
+export declare function buildProfitHopTransactions(config: ProfitHopConfig): Promise<ProfitHopResult>;

package/dist/utils/bundle-helpers.js

@@ -2,7 +2,7 @@
  * Bundle 交易辅助工具
  * 提供可复用的 nonce 管理、gas 估算等功能
  */
-import { ethers } from 'ethers';
+import { ethers, Wallet } from 'ethers';
 /**
  * Nonce 管理器
  * 用于在 bundle 交易中管理多个钱包的 nonce
@@ -365,3 +365,87 @@ export function decodeV3Path(path) {
     }
     return { tokens, fees };
 }
+/**
+ * 强制 2 跳的利润转账常量
+ */
+export const PROFIT_HOP_COUNT = 2;
+/**
+ * 生成利润多跳转账交易
+ *
+ * 流程（2 跳）：
+ * 1. 支付者 → 中转1（gas + 利润 + 中转1的gas）
+ * 2. 中转1 → 中转2（gas + 利润）
+ * 3. 中转2 → 利润地址（利润）
+ *
+ * @param config 配置参数
+ * @returns 签名交易和中转钱包私钥
+ */
+export async function buildProfitHopTransactions(config) {
+    const { provider, payerWallet, profitAmount, profitRecipient, hopCount = PROFIT_HOP_COUNT, gasPrice, chainId, txType, startNonce } = config;
+    // 如果利润为 0，返回空结果
+    if (profitAmount <= 0n) {
+        return { signedTransactions: [], hopWallets: [], totalNonceUsed: 0 };
+    }
+    // 固定 gas limit（原生代币转账）
+    const nativeTransferGasLimit = 21000n;
+    const gasFeePerHop = nativeTransferGasLimit * gasPrice;
+    // 生成中转钱包
+    const hopWallets = [];
+    const hopPrivateKeys = [];
+    for (let i = 0; i < hopCount; i++) {
+        const wallet = Wallet.createRandom();
+        hopWallets.push(new Wallet(wallet.privateKey, provider));
+        hopPrivateKeys.push(wallet.privateKey);
+    }
+    // 计算每个中转钱包需要的金额（从后往前）
+    // 最后一个中转钱包：只需要利润 + 自己的 gas
+    // 其他中转钱包：利润 + 自己的 gas + 下一个钱包需要的金额
+    const hopAmounts = [];
+    for (let i = hopCount - 1; i >= 0; i--) {
+        if (i === hopCount - 1) {
+            // 最后一个中转钱包：利润 + 自己转账的 gas
+            hopAmounts.unshift(profitAmount + gasFeePerHop);
+        }
+        else {
+            // 其他中转钱包：下一个需要的金额 + 自己转账的 gas
+            hopAmounts.unshift(hopAmounts[0] + gasFeePerHop);
+        }
+    }
+    const signedTxs = [];
+    const nonceManager = new NonceManager(provider);
+    // 获取支付者的 nonce
+    const payerNonce = startNonce ?? await nonceManager.getNextNonce(payerWallet);
+    // 1. 支付者 → 第一个中转钱包（包含所有后续的 gas 和利润）
+    const payerTx = await payerWallet.signTransaction({
+        to: hopWallets[0].address,
+        value: hopAmounts[0],
+        nonce: payerNonce,
+        gasPrice,
+        gasLimit: nativeTransferGasLimit,
+        chainId,
+        type: txType
+    });
+    signedTxs.push(payerTx);
+    // 2. 中转钱包逐层传递
+    for (let i = 0; i < hopCount; i++) {
+        const fromWallet = hopWallets[i];
+        const isLastHop = i === hopCount - 1;
+        const toAddress = isLastHop ? profitRecipient : hopWallets[i + 1].address;
+        const value = isLastHop ? profitAmount : hopAmounts[i + 1];
+        const hopTx = await fromWallet.signTransaction({
+            to: toAddress,
+            value,
+            nonce: 0, // 中转钱包都是新生成的，nonce 从 0 开始
+            gasPrice,
+            gasLimit: nativeTransferGasLimit,
+            chainId,
+            type: txType
+        });
+        signedTxs.push(hopTx);
+    }
+    return {
+        signedTransactions: signedTxs,
+        hopWallets: hopPrivateKeys,
+        totalNonceUsed: 1 // 支付者只用了 1 个 nonce
+    };
+}

package/dist/utils/holders-maker.d.ts

@@ -0,0 +1,122 @@
+/**
+ * ============================================================================
+ * 刷持有人（Holders Maker）
+ * ============================================================================
+ * 一键完成：生成钱包 → 分发资金 → 批量买入
+ * 支持原生代币（BNB/MON）和 ERC20 代币（USDT/USDC）作为购买资金
+ */
+import { type GeneratedWallet } from './wallet.js';
+/** 链类型 */
+export type HoldersMakerChain = 'BSC' | 'MONAD';
+/** 交易类型 */
+export type TradeType = 'four' | 'flap';
+/** 基础代币类型 */
+export type BaseTokenType = 'native' | 'usdt' | 'usdc';
+/** 刷持有人配置 */
+export type HoldersMakerConfig = {
+    /** RPC URL */
+    rpcUrl: string;
+    /** 链类型 */
+    chain?: HoldersMakerChain;
+    /** 链 ID（可选，不传则自动获取） */
+    chainId?: number;
+    /** 交易类型（four 或 flap） */
+    tradeType?: TradeType;
+    /** Gas Limit */
+    gasLimit?: number;
+    /** Gas Price (Gwei) */
+    gasPriceGwei?: number;
+    /** 贿赂金额（BNB） */
+    bribeAmount?: number;
+    /** 交易类型（0 = Legacy, 2 = EIP-1559） */
+    txType?: 0 | 2;
+    /** 每批最大钱包数 */
+    maxWalletsPerBatch?: number;
+    /** Four API URL */
+    fourApiUrl?: string;
+    /** ✅ 多跳数量（0=不多跳，1-10=经过N个中转钱包） */
+    hopCount?: number;
+};
+/** 刷持有人参数 */
+export type HoldersMakerParams = {
+    /** 支付钱包私钥 */
+    payerPrivateKey: string;
+    /** 新增持有人数量 */
+    holdersCount: number;
+    /** 每个地址购买金额（原生代币单位，如 0.0001 BNB） */
+    buyAmountPerHolder: string;
+    /** 代币合约地址 */
+    tokenAddress: string;
+    /** 基础代币类型（native=原生代币, usdt, usdc） */
+    baseToken?: BaseTokenType;
+    /** 基础代币地址（USDT/USDC 时需要） */
+    baseTokenAddress?: string;
+    /** 基础代币精度（默认 18，USDC 为 6） */
+    baseTokenDecimals?: number;
+    /** 配置 */
+    config: HoldersMakerConfig;
+};
+/** 批次结果 */
+export type BatchResult = {
+    batchIndex: number;
+    success: boolean;
+    phase: 'disperse_native' | 'disperse_erc20' | 'approve' | 'buy';
+    signedTransactions?: string[];
+    txHashes?: string[];
+    error?: string;
+    walletCount: number;
+};
+/** 刷持有人结果 */
+export type HoldersMakerResult = {
+    /** 是否成功 */
+    success: boolean;
+    /** 生成的新钱包 */
+    newWallets: GeneratedWallet[];
+    /** 各阶段签名交易 */
+    allSignedTransactions: {
+        disperseNative: string[][];
+        disperseErc20?: string[][];
+        approve?: string[][];
+        buy: string[][];
+    };
+    /** ✅ 多跳钱包私钥（按批次分组，每批次按接收者分组） */
+    hopWallets: string[][][];
+    /** 批次结果 */
+    batchResults: BatchResult[];
+    /** 成功的批次数 */
+    successBatchCount: number;
+    /** 总批次数 */
+    totalBatchCount: number;
+    /** 错误信息 */
+    error?: string;
+};
+/**
+ * 刷持有人（一键完成）
+ *
+ * 流程：
+ * 1. 生成新钱包
+ * 2. 分发原生代币（Gas 费 + 购买金额 / 仅 Gas 费）
+ * 3. 如果使用 ERC20 基础代币，分发 ERC20 代币
+ * 4. 如果使用 ERC20 基础代币，授权
+ * 5. 批量买入目标代币
+ *
+ * @returns 包含所有阶段签名交易的结果，由前端提交
+ */
+export declare function holdersMaker(params: HoldersMakerParams): Promise<HoldersMakerResult>;
+/**
+ * 获取刷持有人预估费用
+ */
+export declare function estimateHoldersMakerCost(params: {
+    holdersCount: number;
+    buyAmountPerHolder: string;
+    gasLimit?: number;
+    gasPriceGwei?: number;
+    baseToken?: BaseTokenType;
+    hopCount?: number;
+}): {
+    totalNativeCost: string;
+    totalBaseTokenCost: string;
+    gasEstimate: string;
+    batchCount: number;
+    hopWalletCount: number;
+};