four-flap-meme-sdk 4.1.0 → 4.2.0

package/dist/bundle/four-meme/types/pancake-proxy-types.d.ts

@@ -0,0 +1,118 @@
+import type { FourBundleMerkleConfig, FourSignConfig, MerkleSignedResult } from './config.js';
+/** ✅ PancakeProxy 批量购买参数（Merkle 版本 - 完整） */
+export type FourPancakeProxyBatchBuyParams = {
+    privateKeys: string[];
+    buyAmounts: string[];
+    tokenAddress: string;
+    routeType: 'v2' | 'v3-single' | 'v3-multi';
+    v2Path?: string[];
+    v3TokenIn?: string;
+    v3Fee?: number;
+    v3LpAddresses?: string[];
+    v3ExactTokenIn?: string;
+    /** V3 多跳：代币路径 [tokenIn, tokenMid1, ..., tokenOut] */
+    v3Tokens?: string[];
+    /** V3 多跳：费率路径 [fee0, fee1, ...] - 长度 = v3Tokens.length - 1 */
+    v3Fees?: number[];
+    minOutputAmounts?: (string | bigint)[];
+    config: FourBundleMerkleConfig;
+};
+/** ✅ PancakeProxy 批量购买参数（仅签名版本 - 精简） */
+export type FourPancakeProxyBatchBuySignParams = {
+    privateKeys: string[];
+    buyAmounts: string[];
+    tokenAddress: string;
+    routeType: 'v2' | 'v3-single' | 'v3-multi';
+    v2Path?: string[];
+    v3TokenIn?: string;
+    v3Fee?: number;
+    v3LpAddresses?: string[];
+    v3ExactTokenIn?: string;
+    /** V3 多跳：代币路径 [tokenIn, tokenMid1, ..., tokenOut] */
+    v3Tokens?: string[];
+    /** V3 多跳：费率路径 [fee0, fee1, ...] - 长度 = v3Tokens.length - 1 */
+    v3Fees?: number[];
+    minOutputAmounts?: (string | bigint)[];
+    config: FourSignConfig;
+};
+/** ✅ PancakeProxy 批量购买结果（简化版） */
+export type FourPancakeProxyBatchBuyResult = MerkleSignedResult;
+/** ✅ PancakeProxy 批量卖出参数（Merkle 版本 - 完整） */
+export type FourPancakeProxyBatchSellParams = {
+    privateKeys: string[];
+    sellAmounts: string[];
+    tokenAddress: string;
+    routeType: 'v2' | 'v3-single' | 'v3-multi';
+    v2Path?: string[];
+    v3TokenOut?: string;
+    v3Fee?: number;
+    v3LpAddresses?: string[];
+    v3ExactTokenIn?: string;
+    /** V3 多跳：代币路径 [tokenIn, tokenMid1, ..., tokenOut] */
+    v3Tokens?: string[];
+    /** V3 多跳：费率路径 [fee0, fee1, ...] - 长度 = v3Tokens.length - 1 */
+    v3Fees?: number[];
+    minOutputAmounts?: (string | bigint)[];
+    config: FourBundleMerkleConfig;
+};
+/** ✅ PancakeProxy 批量卖出参数（仅签名版本 - 精简） */
+export type FourPancakeProxyBatchSellSignParams = {
+    privateKeys: string[];
+    sellAmounts: string[];
+    tokenAddress: string;
+    routeType: 'v2' | 'v3-single' | 'v3-multi';
+    v2Path?: string[];
+    v3TokenOut?: string;
+    v3Fee?: number;
+    v3LpAddresses?: string[];
+    v3ExactTokenIn?: string;
+    /** V3 多跳：代币路径 [tokenIn, tokenMid1, ..., tokenOut] */
+    v3Tokens?: string[];
+    /** V3 多跳：费率路径 [fee0, fee1, ...] - 长度 = v3Tokens.length - 1 */
+    v3Fees?: number[];
+    minOutputAmounts?: (string | bigint)[];
+    config: FourSignConfig;
+};
+/** ✅ PancakeProxy 批量卖出结果（简化版） */
+export type FourPancakeProxyBatchSellResult = MerkleSignedResult;
+export type FourPancakeProxyApprovalParams = {
+    privateKey: string;
+    tokenAddress: string;
+    amount: string | 'max';
+    rpcUrl: string;
+    /** 路由类型，用于确定授权目标（V2 或 V3 Router） */
+    routeType?: 'v2' | 'v3-single' | 'v3-multi';
+};
+export type FourPancakeProxyApprovalBatchParams = {
+    privateKeys: string[];
+    tokenAddress: string;
+    amounts: (string | 'max')[];
+    config: FourSignConfig;
+    /** 路由类型，用于确定授权目标（V2 或 V3 Router） */
+    routeType?: 'v2' | 'v3-single' | 'v3-multi';
+};
+/** ✅ PancakeProxy 批量授权结果 */
+export type FourPancakeProxyApprovalBatchResult = {
+    success: boolean;
+    approvedCount: number;
+    signedTransactions: string[];
+    txHashes?: string[];
+    bundleHash?: string;
+    message: string;
+};
+/** 批量授权 TokenManager 参数（直接 RPC 提交） */
+export type ApproveFourTokenManagerBatchParams = {
+    privateKeys: string[];
+    tokenAddress: string;
+    amounts: string[];
+    config: FourSignConfig;
+};
+/** 批量授权 TokenManager 结果 */
+export type ApproveFourTokenManagerBatchResult = {
+    success: boolean;
+    signedTransactions: string[];
+    approvedCount: number;
+    skippedCount: number;
+    txHashes?: string[];
+    message: string;
+};

package/dist/bundle/four-meme/types/pancake-proxy-types.js

@@ -0,0 +1,3 @@
+export {};
+// ========================================
+// 内盘 Swap（换手）类型

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

@@ -0,0 +1,103 @@
+import type { GeneratedWallet } from '../../../utils/wallet.js';
+import type { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
+import type { UserType } from './config.js';
+/** Swap 签名配置（不含 Merkle 字段） */
+export type FourSwapSignConfig = {
+    rpcUrl: string;
+    gasLimit?: number | bigint;
+    gasLimitMultiplier?: number;
+    minGasPriceGwei?: number;
+    maxGasPriceGwei?: number;
+    txType?: 0 | 2;
+    chainId?: number;
+    reserveGasBNB?: number;
+    userType?: UserType;
+    bribeAmount?: number;
+};
+/** Swap Merkle 配置（保留兼容） */
+export type FourSwapConfig = CommonBundleConfig & {
+    apiKey: string;
+    customRpcUrl?: string;
+    bundleBlockOffset?: number;
+    reserveGasBNB?: number;
+    waitForConfirmation?: boolean;
+    waitTimeoutMs?: number;
+    skipApprovalCheck?: boolean;
+};
+export type FourBundleSwapSignParams = {
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKey: string;
+    tokenAddress: string;
+    config: FourSwapSignConfig;
+    startNonces?: number[];
+};
+export type FourBundleSwapParams = {
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKey: string;
+    tokenAddress: string;
+    config: FourSwapConfig;
+};
+export type FourSwapResult = {
+    signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        sellerAddress: string;
+        buyerAddress: string;
+        sellAmount: string;
+        buyAmount: string;
+        hasApproval?: boolean;
+        profitAmount?: string;
+    };
+};
+export type FourBatchSwapSignParams = {
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKeys: string[];
+    buyerRatios?: number[];
+    tokenAddress: string;
+    config: FourSwapSignConfig;
+    startNonces?: number[];
+};
+export type FourBatchSwapResult = {
+    signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        sellerAddress: string;
+        buyerAddresses: string[];
+        sellAmount: string;
+        buyAmounts: string[];
+        hasApproval?: boolean;
+        profitAmount?: string;
+    };
+};
+export type FourQuickBatchSwapSignParams = {
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKeys: string[];
+    buyerRatios?: number[];
+    buyerAmounts?: string[];
+    tokenAddress: string;
+    config: FourSwapSignConfig;
+    disperseHopCount?: number;
+    startNonces?: number[];
+};
+export type FourQuickBatchSwapResult = {
+    signedTransactions: string[];
+    disperseHopWallets?: GeneratedWallet[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        sellerAddress: string;
+        buyerAddresses: string[];
+        sellAmount: string;
+        estimatedBNBOut: string;
+        transferAmounts: string[];
+        profitAmount?: string;
+        disperseHopCount?: number;
+    };
+};

package/dist/bundle/four-meme/types/swap-types.js

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

package/dist/bundle/four-meme/types/transfer-ops.d.ts

@@ -0,0 +1,134 @@
+import type { AmountLike } from '../../types/index.js';
+import type { FourBundleMerkleConfig, FourSignConfig, MerkleSignedResult, QuoteTokenType, TokenPoolType, UserType } from './config.js';
+export type DisperseMerkleParams = {
+    fromPrivateKey: string;
+    recipients: string[];
+    amount?: AmountLike;
+    amounts?: AmountLike[];
+    tokenAddress?: string;
+    tokenDecimals?: number;
+    hopCount?: number | number[];
+    hopPrivateKeys?: string[][];
+    items?: Array<{
+        to: string;
+        amount: AmountLike;
+        hopCount?: number;
+        hopPrivateKeys?: string[];
+    }>;
+    config: FourBundleMerkleConfig;
+};
+/** ✅ 分发参数（仅签名版本 - 精简） */
+export type DisperseSignParams = {
+    fromPrivateKey: string;
+    recipients: string[];
+    amount?: AmountLike;
+    amounts?: AmountLike[];
+    tokenAddress?: string;
+    tokenDecimals?: number;
+    hopCount?: number | number[];
+    hopPrivateKeys?: string[][];
+    items?: Array<{
+        to: string;
+        amount: AmountLike;
+        hopCount?: number;
+        hopPrivateKeys?: string[];
+    }>;
+    config: FourSignConfig;
+    /** ✅ 新增：起始 nonce（用于并行调用时避免 nonce 冲突） */
+    startNonce?: number;
+    /** ✅ 新增：代币池子类型（用于利润报价），默认 'v2' */
+    tokenPoolType?: TokenPoolType;
+    /** ✅ 新增：报价代币类型（池子的计价代币），默认 'native'（BNB/MON） */
+    quoteToken?: QuoteTokenType;
+    /** ✅ 新增：用户类型（用于利润费率），v0=万分之6，v1=万分之5，默认 v0 */
+    userType?: UserType;
+};
+/**
+ * ✅ 分发结果（简化版）
+ * 包含 hopWallets 用于返回生成的多跳钱包私钥
+ */
+export type DisperseMerkleResult = MerkleSignedResult;
+/** ✅ 归集参数（Merkle 版本 - 完整） */
+export type SweepMerkleParams = {
+    sourcePrivateKeys: string[];
+    target: string;
+    targetPrivateKey?: string;
+    ratioPct?: number;
+    ratios?: number[];
+    amount?: AmountLike;
+    amounts?: AmountLike[];
+    tokenAddress?: string;
+    tokenDecimals?: number;
+    skipIfInsufficient?: boolean;
+    hopCount?: number | number[];
+    hopPrivateKeys?: string[][];
+    sources?: Array<{
+        privateKey: string;
+        ratioPct?: number;
+        amount?: AmountLike;
+        hopCount?: number;
+        hopPrivateKeys?: string[];
+    }>;
+    config: FourBundleMerkleConfig;
+};
+/** ✅ 归集参数（仅签名版本 - 精简） */
+export type SweepSignParams = {
+    sourcePrivateKeys: string[];
+    target: string;
+    /** ✅ 新增：归集目标地址的私钥（用于支付利润，不提供则由归集金额最大的源钱包支付） */
+    targetPrivateKey?: string;
+    ratioPct?: number;
+    ratios?: number[];
+    amount?: AmountLike;
+    amounts?: AmountLike[];
+    tokenAddress?: string;
+    tokenDecimals?: number;
+    skipIfInsufficient?: boolean;
+    hopCount?: number | number[];
+    hopPrivateKeys?: string[][];
+    sources?: Array<{
+        privateKey: string;
+        ratioPct?: number;
+        amount?: AmountLike;
+        hopCount?: number;
+        hopPrivateKeys?: string[];
+    }>;
+    config: FourSignConfig;
+    /** ✅ 新增：起始 nonce（用于并行调用时避免 nonce 冲突，仅对第一个源钱包生效） */
+    startNonce?: number;
+    /** ✅ 新增：代币池子类型（用于利润报价），默认 'v2' */
+    tokenPoolType?: TokenPoolType;
+    /** ✅ 新增：报价代币类型（池子的计价代币），默认 'native'（BNB/MON） */
+    quoteToken?: QuoteTokenType;
+    /** ✅ 新增：用户类型（用于利润费率），v0=万分之6，v1=万分之5，默认 v0 */
+    userType?: UserType;
+};
+/**
+ * ✅ 归集结果（简化版）
+ * 包含 hopWallets 用于返回生成的多跳钱包私钥
+ */
+export type SweepMerkleResult = MerkleSignedResult;
+/**
+ * 多对多（地址一一对应）转账参数（仅签名版本）
+ * - senderPrivateKeys / receiverAddresses 必须等长
+ * - amount / amounts 二选一（amounts 优先）
+ * - 支持多跳：hopCount 可为 number 或逐对数组
+ * - 支持利润刮取：利润由第一个 sender 支付（作为额外费用，不扣减每对转账金额）
+ */
+export type PairwiseTransferSignParams = {
+    senderPrivateKeys: string[];
+    receiverAddresses: string[];
+    amount?: AmountLike;
+    amounts?: AmountLike[];
+    tokenAddress?: string;
+    tokenDecimals?: number;
+    hopCount?: number | number[];
+    hopPrivateKeys?: string[][];
+    config: FourSignConfig;
+    /** ✅ 起始 nonce（仅对第一个 sender 生效，用于并行调用避免 nonce 冲突） */
+    startNonce?: number;
+    tokenPoolType?: TokenPoolType;
+    quoteToken?: QuoteTokenType;
+    userType?: UserType;
+};
+export type PairwiseTransferMerkleResult = MerkleSignedResult;

package/dist/bundle/four-meme/types/transfer-ops.js

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

package/dist/chains/bsc/pancake/bundle-buy-first-multi-wallet.js

@@ -11,7 +11,7 @@ import { createPancakeContext, getGasPrice, quoteTokenOutput } from './bundle-bu
 import { validateSwapCounts } from './bundle-buy-first-plan.js';
 import { buildSingleBuyTx, buildSingleSellTx } from './bundle-buy-first-build.js';
 import { buildProfitTransaction } from './bundle-buy-first-profit.js';
-import { splitQuotedMins } from './quote.js';
+import { isSameWalletBuySell, resolveBuyFirstSellMins, splitQuotedMins } from './quote.js';
 /**
  * ✅ 多钱包捆绑换手
  * - 多个买方钱包执行买入（每个钱包1笔）
@@ -91,7 +91,7 @@ export async function pancakeBundleBuyFirstMultiWallet(params) {
     const sellAmountsWei = splitAmount(actualTokenOut, sellCount);
     const slippageBps = config.slippageBps ?? 100;
     const buyAmountOutMins = splitQuotedMins(quoteResult.quotedTokenOut, buyAmountsWei, slippageBps);
-    const sellAmountOutMins = splitQuotedMins(totalFundsWei, sellAmountsWei, slippageBps);
+    const sellAmountOutMins = resolveBuyFirstSellMins(isSameWalletBuySell(buyers, sellers), totalFundsWei, sellAmountsWei, slippageBps);
     // 买合计万三 + 卖合计万三。ERC-20 先把买入合计折成 BNB 再计提，避免 ANTFUN 微额报价为 0
     let profitAmount = 0n;
     if (useNativeToken) {

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

@@ -6,7 +6,7 @@ import { getGasLimit } from '../../../core/gas/bundle-gas.js';
 import { NonceManager } from '../../../utils/bundle-helpers.js';
 import { BLOCKRAZOR_BUILDER_EOA, ZERO_ADDRESS, GAS_LIMITS, calculateBundleSwapRoundTripProfit } from '../../../core/constants/index.js';
 import { quoteRoundTripProfitToNative } from '../../../core/quote/quote-helpers.js';
-import { splitQuotedMins } from './quote.js';
+import { resolveBuyFirstSellMins, splitQuotedMins } from './quote.js';
 import { buildMultiRouteTransactions, buildProfitTransaction, calculateBuyerFunds, createPancakeContext, getGasPrice, pancakeBundleBuyFirstMultiWallet, planMultiNonces, quoteTokenOutput, splitAmount, validateFinalBalances, validateSwapCounts, } from './bundle-buy-first-helpers.js';
 export async function pancakeBundleBuyFirstMerkle(params) {
     const { buyerPrivateKey, buyerPrivateKeys, sellerPrivateKey, sellerPrivateKeys, routeParams, buyerFunds, buyerFundsPercentage, config, quoteToken, quoteTokenDecimals = 18, buyCount: _buyCount, sellCount: _sellCount, taxRateBps = 0, // ✅ 税率（基点），用于计算实际可卖出代币数量
@@ -69,7 +69,7 @@ export async function pancakeBundleBuyFirstMerkle(params) {
     const sellAmountsWei = splitAmount(actualTokenOut, sellCount);
     const slippageBps = config.slippageBps ?? 100;
     const buyAmountOutMins = splitQuotedMins(quoteResult.quotedTokenOut, buyAmountsWei, slippageBps);
-    const sellAmountOutMins = splitQuotedMins(buyerFundsInfo.buyerFundsWei, sellAmountsWei, slippageBps);
+    const sellAmountOutMins = resolveBuyFirstSellMins(sameAddress, buyerFundsInfo.buyerFundsWei, sellAmountsWei, slippageBps);
     // ✅ 构建多笔买入和卖出交易
     const swapUnsignedArray = await buildMultiRouteTransactions({
         routeParams,

package/dist/chains/bsc/pancake/hop-chain.d.ts

@@ -1,18 +1 @@
-import { Wallet, JsonRpcProvider } from 'ethers';
-import { type DisperseHopPath } from './bundle-swap-types.js';
-/**
- * 生成分发多跳路径
- */
-export declare function generateDisperseHopPaths(targetAddresses: string[], hopCount: number, provider: JsonRpcProvider): DisperseHopPath[];
-/**
- * 构建原生代币多跳转账链
- */
-export declare function buildNativeHopChain(payer: Wallet, path: DisperseHopPath, finalAmount: bigint, gasPrice: bigint, chainId: number, txType: 0 | 2, payerNonce: number): Promise<string[]>;
-/**
- * 构建 ERC20 多跳转账链（需要配合 BNB 多跳使用）
- */
-export declare function buildERC20HopChain(payer: Wallet, path: DisperseHopPath, erc20Address: string, erc20Amount: bigint, gasPrice: bigint, chainId: number, txType: 0 | 2, payerNonce: number): Promise<string[]>;
-/**
- * 构建 BNB 多跳转账链（为 ERC20 中间钱包预留 gas）
- */
-export declare function buildBNBHopChainForERC20(payer: Wallet, path: DisperseHopPath, finalGasAmount: bigint, gasPrice: bigint, chainId: number, txType: 0 | 2, payerNonce: number): Promise<string[]>;
+export { generateDisperseHopPaths, buildNativeHopChain, buildERC20HopChain, buildBNBHopChainForERC20, } from '../../../utils/hop-chains.js';

package/dist/chains/bsc/pancake/hop-chain.js

@@ -1,229 +1 @@
-import { ethers, Wallet } from 'ethers';
-import { ERC20_ABI } from '../../../abis/common.js';
-import { generateWallets } from '../../../utils/wallet.js';
-import { ERC20_TRANSFER_GAS_LIMIT_HOP, NATIVE_TRANSFER_GAS_LIMIT, } from './bundle-swap-types.js';
-/**
- * 生成分发多跳路径
- */
-export function generateDisperseHopPaths(targetAddresses, hopCount, provider) {
-    if (hopCount <= 0) {
-        return targetAddresses.map((addr) => ({
-            targetAddress: addr,
-            hopWallets: [],
-            hopWalletsInfo: [],
-        }));
-    }
-    return targetAddresses.map((targetAddress) => {
-        const hopWalletsInfo = generateWallets(hopCount);
-        const hopWallets = hopWalletsInfo.map((w) => new Wallet(w.privateKey, provider));
-        return { targetAddress, hopWallets, hopWalletsInfo };
-    });
-}
-/**
- * 构建原生代币多跳转账链
- */
-export async function buildNativeHopChain(payer, path, finalAmount, gasPrice, chainId, txType, payerNonce) {
-    const signedTxs = [];
-    const hopCount = path.hopWallets.length;
-    if (hopCount === 0) {
-        const tx = {
-            to: path.targetAddress,
-            value: finalAmount,
-            nonce: payerNonce,
-            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-            chainId,
-            type: txType,
-        };
-        if (txType === 2) {
-            tx.maxFeePerGas = gasPrice;
-            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
-        }
-        else {
-            tx.gasPrice = gasPrice;
-        }
-        signedTxs.push(await payer.signTransaction(tx));
-        return signedTxs;
-    }
-    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
-    // 计算每跳需要的金额
-    const amountsPerHop = [];
-    for (let i = 0; i < hopCount; i++) {
-        const remainingHops = hopCount - i;
-        amountsPerHop.push(finalAmount + hopGasCost * BigInt(remainingHops));
-    }
-    // payer → hop1
-    const firstTx = {
-        to: path.hopWallets[0].address,
-        value: amountsPerHop[0],
-        nonce: payerNonce,
-        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-        chainId,
-        type: txType,
-    };
-    if (txType === 2) {
-        firstTx.maxFeePerGas = gasPrice;
-        firstTx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
-    }
-    else {
-        firstTx.gasPrice = gasPrice;
-    }
-    signedTxs.push(await payer.signTransaction(firstTx));
-    // hop1 → hop2 → ... → target
-    for (let i = 0; i < hopCount; i++) {
-        const fromWallet = path.hopWallets[i];
-        const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
-        const amount = i === hopCount - 1 ? finalAmount : amountsPerHop[i + 1];
-        const tx = {
-            to: toAddress,
-            value: amount,
-            nonce: 0,
-            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-            chainId,
-            type: txType,
-        };
-        if (txType === 2) {
-            tx.maxFeePerGas = gasPrice;
-            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
-        }
-        else {
-            tx.gasPrice = gasPrice;
-        }
-        signedTxs.push(await fromWallet.signTransaction(tx));
-    }
-    return signedTxs;
-}
-/**
- * 构建 ERC20 多跳转账链（需要配合 BNB 多跳使用）
- */
-export async function buildERC20HopChain(payer, path, erc20Address, erc20Amount, gasPrice, chainId, txType, payerNonce) {
-    const signedTxs = [];
-    const hopCount = path.hopWallets.length;
-    const erc20Interface = new ethers.Interface(ERC20_ABI);
-    if (hopCount === 0) {
-        const data = erc20Interface.encodeFunctionData('transfer', [path.targetAddress, erc20Amount]);
-        const tx = {
-            to: erc20Address,
-            data,
-            value: 0n,
-            nonce: payerNonce,
-            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
-            chainId,
-            type: txType,
-        };
-        if (txType === 2) {
-            tx.maxFeePerGas = gasPrice;
-            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
-        }
-        else {
-            tx.gasPrice = gasPrice;
-        }
-        signedTxs.push(await payer.signTransaction(tx));
-        return signedTxs;
-    }
-    // payer → hop1
-    const firstData = erc20Interface.encodeFunctionData('transfer', [path.hopWallets[0].address, erc20Amount]);
-    const firstTx = {
-        to: erc20Address,
-        data: firstData,
-        value: 0n,
-        nonce: payerNonce,
-        gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
-        chainId,
-        type: txType,
-    };
-    if (txType === 2) {
-        firstTx.maxFeePerGas = gasPrice;
-        firstTx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
-    }
-    else {
-        firstTx.gasPrice = gasPrice;
-    }
-    signedTxs.push(await payer.signTransaction(firstTx));
-    // hop1 → hop2 → ... → target (nonce=1，nonce=0 用于 BNB 转发)
-    for (let i = 0; i < hopCount; i++) {
-        const fromWallet = path.hopWallets[i];
-        const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
-        const data = erc20Interface.encodeFunctionData('transfer', [toAddress, erc20Amount]);
-        const tx = {
-            to: erc20Address,
-            data,
-            value: 0n,
-            nonce: 1, // nonce=0 已用于 BNB 转发
-            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
-            chainId,
-            type: txType,
-        };
-        if (txType === 2) {
-            tx.maxFeePerGas = gasPrice;
-            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
-        }
-        else {
-            tx.gasPrice = gasPrice;
-        }
-        signedTxs.push(await fromWallet.signTransaction(tx));
-    }
-    return signedTxs;
-}
-/**
- * 构建 BNB 多跳转账链（为 ERC20 中间钱包预留 gas）
- */
-export async function buildBNBHopChainForERC20(payer, path, finalGasAmount, gasPrice, chainId, txType, payerNonce) {
-    const signedTxs = [];
-    const hopCount = path.hopWallets.length;
-    if (hopCount === 0) {
-        // 无多跳时不需要转 gas
-        return signedTxs;
-    }
-    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
-    const erc20GasCost = ERC20_TRANSFER_GAS_LIMIT_HOP * gasPrice;
-    // 每个中间钱包需要: BNB 转发 gas + ERC20 转发 gas
-    const gasPerHop = hopGasCost + erc20GasCost * 2n; // 2倍安全系数
-    // 计算每跳需要的金额
-    const amountsPerHop = [];
-    for (let i = 0; i < hopCount; i++) {
-        const remainingHops = hopCount - i;
-        amountsPerHop.push(finalGasAmount + gasPerHop * BigInt(remainingHops));
-    }
-    // payer → hop1
-    const firstTx = {
-        to: path.hopWallets[0].address,
-        value: amountsPerHop[0],
-        nonce: payerNonce,
-        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-        chainId,
-        type: txType,
-    };
-    if (txType === 2) {
-        firstTx.maxFeePerGas = gasPrice;
-        firstTx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
-    }
-    else {
-        firstTx.gasPrice = gasPrice;
-    }
-    signedTxs.push(await payer.signTransaction(firstTx));
-    // hop1 → hop2 → ... → target (nonce=0)
-    for (let i = 0; i < hopCount; i++) {
-        const fromWallet = path.hopWallets[i];
-        const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
-        const amount = i === hopCount - 1 ? finalGasAmount : amountsPerHop[i + 1];
-        if (i === hopCount - 1 && amount === 0n)
-            continue;
-        const tx = {
-            to: toAddress,
-            value: amount,
-            nonce: 0,
-            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-            chainId,
-            type: txType,
-        };
-        if (txType === 2) {
-            tx.maxFeePerGas = gasPrice;
-            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
-        }
-        else {
-            tx.gasPrice = gasPrice;
-        }
-        signedTxs.push(await fromWallet.signTransaction(tx));
-    }
-    return signedTxs;
-}
+export { generateDisperseHopPaths, buildNativeHopChain, buildERC20HopChain, buildBNBHopChainForERC20, } from '../../../utils/hop-chains.js';

package/dist/chains/bsc/pancake/quote.d.ts

@@ -1,8 +1,16 @@
 import { ethers } from 'ethers';
+import { applySlippageBps } from '../../../core/constants/index.js';
 import { type QuoteBNBResult, type QuoteSellParams, type RouteParams, type UserType } from './bundle-swap-types.js';
-/** 100 bps = 1%。上限 50%，避免写成 0 输出。 */
-export declare function applyPancakeSlippage(quotedOut: bigint, slippageBps?: number): bigint;
+/** Pancake 买卖 minOut；实现见 core applySlippageBps。 */
+export declare const applyPancakeSlippage: typeof applySlippageBps;
 export declare function splitQuotedMins(quotedTotal: bigint, amounts: bigint[], slippageBps?: number): bigint[];
+export declare function isSameWalletBuySell(buyers: Array<{
+    address: string;
+}>, sellers: Array<{
+    address: string;
+}>): boolean;
+/** 同钱包无币刷量卖出必须 minOut=0：同块先买后卖，卖出到账必然低于买入报价。 */
+export declare function resolveBuyFirstSellMins(sameWallet: boolean, quotedTotal: bigint, sellAmounts: bigint[], slippageBps?: number): bigint[];
 export declare function quoteBuyOutput(params: {
     routeParams: RouteParams;
     buyAmountWei: bigint;