four-flap-meme-sdk 1.9.49 → 2.0.0

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

@@ -0,0 +1,159 @@
+/**
+ * PancakeSwap V2/V3 通用捆绑换手（Merkle Bundle）- 先买后卖
+ *
+ * 功能：钱包B先买入代币 → 钱包A卖出相同数量 → 原子执行
+ */
+import { ethers } from 'ethers';
+import type { GeneratedWallet } from '../../../utils/wallet.js';
+import { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
+export interface PancakeBuyFirstSignConfig {
+    rpcUrl: string;
+    gasLimit?: number | bigint;
+    gasLimitMultiplier?: number;
+    minGasPriceGwei?: number;
+    maxGasPriceGwei?: number;
+    txType?: 0 | 2;
+    chainId?: number;
+    reserveGasBNB?: number;
+    skipQuoteOnError?: boolean;
+    userType?: UserType;
+    bribeAmount?: number;
+    v2RouterAddress?: string;
+}
+/**
+ * 获取 Gas Limit
+ */
+export declare function getGasLimit(config: PancakeBuyFirstSignConfig | PancakeBuyFirstConfig, defaultGas?: number): bigint;
+export declare function getGasPrice(provider: ethers.JsonRpcProvider, config: PancakeBuyFirstSignConfig | PancakeBuyFirstConfig): Promise<bigint>;
+export declare const PANCAKE_V2_ROUTER_ABI: string[];
+export declare const PANCAKE_V3_ROUTER_ABI: (string | {
+    inputs: {
+        components: {
+            name: string;
+            type: string;
+        }[];
+        name: string;
+        type: string;
+    }[];
+    name: string;
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+    type: string;
+})[];
+export declare const ERC20_BALANCE_OF_ABI: string[];
+export declare const PANCAKE_V2_ROUTER_ADDRESS: "0x10ED43C718714eb63d5aA57B78B54704E256024E";
+export declare const PANCAKE_V3_ROUTER_ADDRESS: "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
+export declare const FLAT_FEE = 0n;
+/** 最大 Bundle 签名数 */
+export declare const MAX_BUNDLE_SIGNATURES = 50;
+/** 贿赂交易数 */
+export declare const BRIBE_TX_COUNT = 1;
+/** 利润中转交易数（支付者 1 笔 + 中转钱包 PROFIT_HOP_COUNT 笔 + 最终接收 1 笔） */
+export declare const PROFIT_TX_COUNT: number;
+/** 最大买卖交易数 */
+export declare const MAX_SWAP_TX_COUNT: number;
+export type UserType = 'v0' | 'v1';
+/**
+ * 根据 userType 获取每笔交易的利润率
+ */
+export declare function getProfitRatePerTxBps(userType?: UserType): number;
+/**
+ * 验证买卖笔数
+ */
+export declare function validateSwapCounts(buyCount: number, sellCount: number): void;
+/**
+ * ✅ 将金额随机拆分成多份（更自然，不像机器人）
+ * 每份金额在平均值的 50%-150% 之间随机浮动
+ */
+export declare function splitAmount(totalAmount: bigint, count: number): bigint[];
+/** 多笔买卖 nonce 规划（与 Flap 一致） */
+export type MultiNoncePlan = {
+    buyerNonces: number[];
+    sellerNonces: number[];
+    bribeNonce?: number;
+    profitNonce?: number;
+};
+export type SwapRouteType = 'v2' | 'v3-single' | 'v3-multi';
+export interface V2RouteParams {
+    routeType: 'v2';
+    v2Path: string[];
+}
+export interface V3SingleRouteParams {
+    routeType: 'v3-single';
+    v3TokenIn: string;
+    v3TokenOut: string;
+    v3Fee: number;
+    v2Path?: string[];
+}
+export interface V3MultiRouteParams {
+    routeType: 'v3-multi';
+    v3LpAddresses: string[];
+    v3ExactTokenIn: string;
+    v2Path?: string[];
+}
+export type RouteParams = V2RouteParams | V3SingleRouteParams | V3MultiRouteParams;
+export interface PancakeBuyFirstConfig extends CommonBundleConfig {
+    apiKey: string;
+    customRpcUrl?: string;
+    bundleBlockOffset?: number;
+    reserveGasBNB?: number;
+    waitForConfirmation?: boolean;
+    waitTimeoutMs?: number;
+}
+export interface PancakeBundleBuyFirstSignParams {
+    buyerPrivateKey?: string;
+    buyerPrivateKeys?: string[];
+    sellerPrivateKey?: string;
+    sellerPrivateKeys?: string[];
+    tokenAddress: string;
+    routeParams: RouteParams;
+    buyerFunds?: string;
+    buyerFundsPercentage?: number;
+    config: PancakeBuyFirstSignConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    startNonces?: number[];
+    buyCount?: number;
+    sellCount?: number;
+    taxRateBps?: number;
+}
+export interface PancakeBundleBuyFirstParams {
+    buyerPrivateKey: string;
+    sellerPrivateKey: string;
+    tokenAddress: string;
+    routeParams: RouteParams;
+    buyerFunds?: string;
+    buyerFundsPercentage?: number;
+    config: PancakeBuyFirstConfig;
+}
+/** ✅ Pancake BuyFirst 结果（简化版） */
+export type PancakeBuyFirstResult = {
+    signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        buyerAddress: string;
+        sellerAddress: string;
+        buyAmount: string;
+        sellAmount: string;
+        profitAmount?: string;
+        buyCount?: number;
+        sellCount?: number;
+        buyAmounts?: string[];
+        sellAmounts?: string[];
+    };
+};
+export type PancakeContext = {
+    chainId: number;
+    provider: ethers.JsonRpcProvider;
+};
+export type BuyerFundsResult = {
+    buyerFundsWei: bigint;
+    buyerBalance: bigint;
+    reserveGas: bigint;
+};
+export type QuoteTokenResult = {
+    quotedTokenOut: bigint;
+};

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

@@ -0,0 +1,117 @@
+/**
+ * PancakeSwap V2/V3 通用捆绑换手（Merkle Bundle）- 先买后卖
+ *
+ * 功能：钱包B先买入代币 → 钱包A卖出相同数量 → 原子执行
+ */
+import { ethers } from 'ethers';
+import { PROFIT_HOP_COUNT } from '../../../utils/bundle-helpers.js';
+import { V2_ROUTER_ABI, V3_ROUTER02_ABI, ERC20_BALANCE_ABI } from '../../../abis/common.js';
+import { getProfitRateBps } from '../../../shared/constants/index.js';
+import { ADDRESSES } from '../../../shared/constants/index.js';
+/**
+ * 获取 Gas Limit
+ */
+export function getGasLimit(config, defaultGas = 800000) {
+    if (config.gasLimit !== undefined) {
+        return typeof config.gasLimit === 'bigint' ? config.gasLimit : BigInt(config.gasLimit);
+    }
+    const multiplier = config.gasLimitMultiplier ?? 1.0;
+    const calculatedGas = Math.ceil(defaultGas * multiplier);
+    return BigInt(calculatedGas);
+}
+export async function getGasPrice(provider, config) {
+    const feeData = await provider.getFeeData();
+    let gasPrice = feeData.gasPrice || ethers.parseUnits('3', 'gwei');
+    if (config.minGasPriceGwei) {
+        const minGas = ethers.parseUnits(config.minGasPriceGwei.toString(), 'gwei');
+        if (gasPrice < minGas)
+            gasPrice = minGas;
+    }
+    if (config.maxGasPriceGwei) {
+        const maxGas = ethers.parseUnits(config.maxGasPriceGwei.toString(), 'gwei');
+        if (gasPrice > maxGas)
+            gasPrice = maxGas;
+    }
+    return gasPrice;
+}
+// ✅ ABI 别名（从公共模块导入）
+export const PANCAKE_V2_ROUTER_ABI = V2_ROUTER_ABI;
+export const PANCAKE_V3_ROUTER_ABI = V3_ROUTER02_ABI;
+export const ERC20_BALANCE_OF_ABI = ERC20_BALANCE_ABI;
+// ✅ 使用官方 PancakeSwap Router 地址
+export const PANCAKE_V2_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV2Router;
+export const PANCAKE_V3_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV3Router;
+// 常量
+export const FLAT_FEE = 0n;
+// ==================== 多笔买卖常量 ====================
+/** 最大 Bundle 签名数 */
+export const MAX_BUNDLE_SIGNATURES = 50;
+/** 贿赂交易数 */
+export const BRIBE_TX_COUNT = 1;
+/** 利润中转交易数（支付者 1 笔 + 中转钱包 PROFIT_HOP_COUNT 笔 + 最终接收 1 笔） */
+export const PROFIT_TX_COUNT = PROFIT_HOP_COUNT + 2; // 2 + 2 = 4
+/** 最大买卖交易数 */
+export const MAX_SWAP_TX_COUNT = MAX_BUNDLE_SIGNATURES - BRIBE_TX_COUNT - PROFIT_TX_COUNT; // 50 - 1 - 4 = 45
+/**
+ * 根据 userType 获取每笔交易的利润率
+ */
+export function getProfitRatePerTxBps(userType) {
+    if (userType === 'v1') {
+        return getProfitRateBps('v1Double');
+    }
+    return getProfitRateBps('v0Double'); // v0 或默认
+}
+/**
+ * 验证买卖笔数
+ */
+export function validateSwapCounts(buyCount, sellCount) {
+    if (buyCount < 1) {
+        throw new Error(`买入笔数必须至少为 1，当前为 ${buyCount}`);
+    }
+    if (sellCount < 1) {
+        throw new Error(`卖出笔数必须至少为 1，当前为 ${sellCount}`);
+    }
+    const totalSwaps = buyCount + sellCount;
+    if (totalSwaps > MAX_SWAP_TX_COUNT) {
+        throw new Error(`买卖笔数总和 (${totalSwaps}) 超出限制 (${MAX_SWAP_TX_COUNT})，` +
+            `最大签名数为 ${MAX_BUNDLE_SIGNATURES}（${BRIBE_TX_COUNT} 贿赂 + ${PROFIT_TX_COUNT} 利润 + ${MAX_SWAP_TX_COUNT} 买卖）`);
+    }
+}
+/**
+ * ✅ 将金额随机拆分成多份（更自然，不像机器人）
+ * 每份金额在平均值的 50%-150% 之间随机浮动
+ */
+export function splitAmount(totalAmount, count) {
+    if (count <= 0) {
+        throw new Error('拆分份数必须大于 0');
+    }
+    if (count === 1) {
+        return [totalAmount];
+    }
+    // 生成随机权重（0.5 - 1.5 之间）
+    const weights = [];
+    for (let i = 0; i < count; i++) {
+        // 随机值在 0.5 - 1.5 之间，使每份金额有 ±50% 的浮动
+        weights.push(0.5 + Math.random());
+    }
+    // 计算权重总和
+    const totalWeight = weights.reduce((a, b) => a + b, 0);
+    // 根据权重分配金额
+    const amounts = [];
+    let allocated = 0n;
+    for (let i = 0; i < count - 1; i++) {
+        // 按权重比例分配
+        const ratio = weights[i] / totalWeight;
+        const amount = BigInt(Math.floor(Number(totalAmount) * ratio));
+        amounts.push(amount);
+        allocated += amount;
+    }
+    // 最后一份分配剩余的全部（确保总和精确）
+    amounts.push(totalAmount - allocated);
+    // 随机打乱顺序（让大小金额交错出现）
+    for (let i = amounts.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [amounts[i], amounts[j]] = [amounts[j], amounts[i]];
+    }
+    return amounts;
+}

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

@@ -1,92 +1,2 @@
-/**
- * PancakeSwap V2/V3 通用捆绑换手（Merkle Bundle）- 先买后卖
- *
- * 功能：钱包B先买入代币 → 钱包A卖出相同数量 → 原子执行
- */
-import { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
-import type { GeneratedWallet } from '../../../utils/wallet.js';
-export interface PancakeBuyFirstSignConfig {
-    rpcUrl: string;
-    gasLimit?: number | bigint;
-    gasLimitMultiplier?: number;
-    minGasPriceGwei?: number;
-    maxGasPriceGwei?: number;
-    txType?: 0 | 2;
-    chainId?: number;
-    reserveGasBNB?: number;
-    skipQuoteOnError?: boolean;
-    userType?: UserType;
-    bribeAmount?: number;
-    v2RouterAddress?: string;
-}
-export type UserType = 'v0' | 'v1';
-export type SwapRouteType = 'v2' | 'v3-single' | 'v3-multi';
-export interface V2RouteParams {
-    routeType: 'v2';
-    v2Path: string[];
-}
-export interface V3SingleRouteParams {
-    routeType: 'v3-single';
-    v3TokenIn: string;
-    v3TokenOut: string;
-    v3Fee: number;
-    v2Path?: string[];
-}
-export interface V3MultiRouteParams {
-    routeType: 'v3-multi';
-    v3LpAddresses: string[];
-    v3ExactTokenIn: string;
-    v2Path?: string[];
-}
-export type RouteParams = V2RouteParams | V3SingleRouteParams | V3MultiRouteParams;
-export interface PancakeBuyFirstConfig extends CommonBundleConfig {
-    apiKey: string;
-    customRpcUrl?: string;
-    bundleBlockOffset?: number;
-    reserveGasBNB?: number;
-    waitForConfirmation?: boolean;
-    waitTimeoutMs?: number;
-}
-export interface PancakeBundleBuyFirstSignParams {
-    buyerPrivateKey?: string;
-    buyerPrivateKeys?: string[];
-    sellerPrivateKey?: string;
-    sellerPrivateKeys?: string[];
-    tokenAddress: string;
-    routeParams: RouteParams;
-    buyerFunds?: string;
-    buyerFundsPercentage?: number;
-    config: PancakeBuyFirstSignConfig;
-    quoteToken?: string;
-    quoteTokenDecimals?: number;
-    startNonces?: number[];
-    buyCount?: number;
-    sellCount?: number;
-    taxRateBps?: number;
-}
-export interface PancakeBundleBuyFirstParams {
-    buyerPrivateKey: string;
-    sellerPrivateKey: string;
-    tokenAddress: string;
-    routeParams: RouteParams;
-    buyerFunds?: string;
-    buyerFundsPercentage?: number;
-    config: PancakeBuyFirstConfig;
-}
-/** ✅ Pancake BuyFirst 结果（简化版） */
-export type PancakeBuyFirstResult = {
-    signedTransactions: string[];
-    profitHopWallets?: GeneratedWallet[];
-    metadata?: {
-        buyerAddress: string;
-        sellerAddress: string;
-        buyAmount: string;
-        sellAmount: string;
-        profitAmount?: string;
-        buyCount?: number;
-        sellCount?: number;
-        buyAmounts?: string[];
-        sellAmounts?: string[];
-    };
-};
+import { PancakeBundleBuyFirstSignParams, PancakeBuyFirstResult } from './bundle-buy-first-helpers.js';
 export declare function pancakeBundleBuyFirstMerkle(params: PancakeBundleBuyFirstSignParams): Promise<PancakeBuyFirstResult>;