four-flap-meme-sdk 2.2.19 → 3.0.0

package/dist/core/types/erc20.d.ts

@@ -0,0 +1,65 @@
+import type { ContractTransactionReceipt } from 'ethers';
+import type { NonceManager } from '../nonce/nonce-manager.js';
+export type EnsureAllowanceResult = {
+    /** 是否已经授权 */
+    alreadyApproved: boolean;
+    /** 当前授权额度 */
+    currentAllowance: bigint;
+    /** 需要的授权额度 */
+    requiredAllowance: bigint;
+    /** 授权交易回执（如果发送了新交易） */
+    txReceipt?: ContractTransactionReceipt | null;
+};
+export type EnsureAllowanceBatchItemResult = EnsureAllowanceResult & {
+    owner: string;
+};
+export type ApproveTokenBatchParams = {
+    chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD';
+    platform: 'flap' | 'four' | 'pancake-v2' | 'pancake-v3';
+    rpcUrl: string;
+    privateKeys: string[];
+    tokenAddress: string;
+    amounts: (bigint | 'max')[];
+    signOnly?: boolean;
+    gasPriceGwei?: number;
+    gasLimit?: number;
+    chainId?: number;
+    skipValidation?: boolean;
+};
+export type ApproveTokenBatchRawParams = {
+    rpcUrl: string;
+    privateKeys: string[];
+    tokenAddress: string;
+    spenderAddress: string;
+    amounts: (bigint | 'max')[];
+    signOnly?: boolean;
+    gasPriceGwei?: number;
+    gasLimit?: number;
+    chainId?: number;
+    nonceManager?: NonceManager;
+    skipValidation?: boolean;
+};
+export type ApproveTokenBatchResult = {
+    success: boolean;
+    approvedCount: number;
+    results: Array<{
+        owner: string;
+        alreadyApproved: boolean;
+        currentAllowance: bigint;
+        requiredAllowance: bigint;
+        txHash?: string;
+        error?: string;
+    }>;
+};
+export type ApproveTokenBatchSignResult = {
+    signedTransactions: string[];
+    results: Array<{
+        owner: string;
+        alreadyApproved: boolean;
+        currentAllowance: bigint;
+        requiredAllowance: bigint;
+        signedTx?: string;
+    }>;
+    needApproveCount: number;
+    alreadyApprovedCount: number;
+};

package/dist/core/types/erc20.js

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

package/dist/core/types/holders-maker.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 刷持有人 - 类型定义
+ */
+import type { GeneratedWallet } from '../../utils/wallet.js';
+export type HoldersMakerChain = 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
+export type HoldersMakerTradeType = 'four' | 'flap' | 'v2' | 'v3' | 'daoaas';
+export type BaseTokenType = 'native' | 'usdt' | 'usdc';
+export type HoldersMakerConfig = {
+    rpcUrl: string;
+    chain?: HoldersMakerChain;
+    chainId?: number;
+    tradeType?: HoldersMakerTradeType;
+    gasLimit?: number;
+    gasPriceGwei?: number;
+    bribeAmount?: number;
+    txType?: 0 | 2;
+    maxWalletsPerBatch?: number;
+    fourApiUrl?: string;
+    disperseHopCount?: number;
+    v2Path?: string[];
+    v3TokenIn?: string;
+    v3Fee?: number;
+    v3LpAddresses?: string[];
+    v3Tokens?: string[];
+    v2RouterAddress?: string;
+};
+export type HoldersMakerParams = {
+    payerPrivateKey: string;
+    holdersCount: number;
+    buyAmountPerHolder: string;
+    tokenAddress: string;
+    baseToken?: BaseTokenType;
+    baseTokenAddress?: string;
+    baseTokenDecimals?: number;
+    config: HoldersMakerConfig;
+};
+export type TransactionLayer = {
+    name: string;
+    startIndex: number;
+    endIndex: number;
+    count: number;
+};
+export type BatchResult = {
+    batchIndex: number;
+    success: boolean;
+    signedTransactions?: string[];
+    txHashes?: string[];
+    error?: string;
+    walletCount: number;
+    transactionLayers?: TransactionLayer[];
+    disperseHopCount?: number;
+};
+export type HoldersMakerResult = {
+    success: boolean;
+    newWallets: GeneratedWallet[];
+    disperseHopWallets?: GeneratedWallet[];
+    profitHopWallets?: GeneratedWallet[];
+    signedTransactions: string[][];
+    batchResults: BatchResult[];
+    successBatchCount: number;
+    totalBatchCount: number;
+    error?: string;
+    disperseHopCount?: number;
+};

package/dist/core/types/holders-maker.js

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

package/dist/core/types/index.d.ts

@@ -0,0 +1,7 @@
+export type { Aggregate3CallResult } from './multicall.js';
+export type { EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult, } from './erc20.js';
+export type { HoldersMakerChain, HoldersMakerTradeType, BaseTokenType, HoldersMakerConfig, HoldersMakerParams, TransactionLayer, BatchResult, HoldersMakerResult, } from './holders-maker.js';
+export type { DexConfig, ChainDexConfig, PoolPairInfo, V3PoolInfo, DexPoolInfo, BestPoolInfo, LPPlatform, LPInfo, InspectOptions, } from './lp-inspect.js';
+export type { BundleSubmitResult, SignedTransactionsResult, AirdropDisperseParams, AirdropDisperseSignParams, AirdropSweepParams, AirdropSweepSignParams, DisperseParams, DisperseSignParams, SweepParams, SweepSignParams, } from './airdrop-sweep.js';
+export type { PrivateSaleSignConfig, PrivateSaleTransferParams, BatchPrivateSaleParams, PrivateSaleResult, } from './private-sale.js';
+export type { SupportedChain, QuoteParams, QuoteResult } from './quote-helpers.js';

package/dist/core/types/index.js

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

package/dist/{utils → core/types}/lp-inspect.d.ts

@@ -1,5 +1,7 @@
-import { type FlapChain } from '../shared/flap/portal.js';
-/** DEX 配置 */
+/**
+ * LP 查询 - 类型定义
+ */
+import type { FlapChain } from '../../domains/flap/portal.js';
 export interface DexConfig {
     name: string;
     v2Factory?: string;
@@ -9,7 +11,6 @@ export interface DexConfig {
     quoterV2?: string;
     enabled: boolean;
 }
-/** 链配置 */
 export interface ChainDexConfig {
     wrappedNative: string;
     wrappedNativeSymbol: string;
@@ -20,7 +21,6 @@ export interface ChainDexConfig {
     }>;
     dexes: Record<string, DexConfig>;
 }
-/** 单个交易对信息 */
 export interface PoolPairInfo {
     quoteToken: string;
     quoteSymbol: string;
@@ -32,18 +32,15 @@ export interface PoolPairInfo {
     reserveTokenRaw?: bigint;
     poolRatio?: string;
 }
-/** V3 池子信息（带 fee） */
 export interface V3PoolInfo extends PoolPairInfo {
     fee: number;
 }
-/** DEX 池子信息 */
 export interface DexPoolInfo {
     dexName: string;
     dexKey: string;
     v2Pairs: PoolPairInfo[];
     v3Pools: V3PoolInfo[];
 }
-/** 最佳池子推荐 */
 export interface BestPoolInfo {
     dex: string;
     dexKey: string;
@@ -59,9 +56,7 @@ export interface BestPoolInfo {
     reserveTokenRaw?: bigint;
     poolRatio?: string;
 }
-/** LP 平台类型 */
 export type LPPlatform = 'FOUR' | 'FLAP' | 'DAOAAS' | 'PANCAKESWAP_V2' | 'PANCAKESWAP_V3' | 'UNISWAP_V2' | 'UNISWAP_V3' | 'IROSWAP_V2' | 'MULTI_DEX' | 'UNKNOWN';
-/** LP 信息返回类型 */
 export interface LPInfo {
     platform: LPPlatform;
     decimals?: number;
@@ -95,7 +90,6 @@ export interface LPInfo {
     allPools: DexPoolInfo[];
     bestPools: BestPoolInfo[];
 }
-/** 查询选项 */
 export interface InspectOptions {
     chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
     rpcUrl: string;
@@ -106,45 +100,3 @@ export interface InspectOptions {
     debug?: boolean;
     formatBalances?: boolean;
 }
-/**
- * 从 Router 合约获取 Factory 地址
- * 支持 Uniswap V2 Router 和 V3 SwapRouter02
- */
-export declare function getFactoryFromRouter(routerAddress: string, rpcUrl: string, routerType?: 'v2' | 'v3'): Promise<{
-    v2Factory?: string;
-    v3Factory?: string;
-}>;
-/**
- * 动态注册 DYORSwap（从 Router 获取 Factory）
- */
-export declare function registerDYORSwap(rpcUrl: string): Promise<boolean>;
-/** 注册新的 DEX */
-export declare function registerDex(chain: string, dexKey: string, config: DexConfig): void;
-/** 注册新的稳定币 */
-export declare function registerStableCoin(chain: string, coin: {
-    address: string;
-    symbol: string;
-    decimals: number;
-}): void;
-/** 获取链配置（优先运行时配置） */
-export declare function getChainConfig(chain: string): ChainDexConfig | undefined;
-/** 获取支持的 DEX 列表 */
-export declare function getSupportedDexes(chain: string): Array<{
-    key: string;
-    name: string;
-    enabled: boolean;
-}>;
-/** 获取支持的稳定币列表 */
-export declare function getSupportedStableCoins(chain: string): Array<{
-    address: string;
-    symbol: string;
-    decimals: number;
-}>;
-/** 获取所有报价代币（包装原生 + 稳定币） */
-export declare function getQuoteTokens(chain: string): Array<{
-    address: string;
-    symbol: string;
-    decimals: number;
-    isNative: boolean;
-}>;
-export declare function inspectTokenLP(token: string, opts: InspectOptions): Promise<LPInfo>;

package/dist/core/types/lp-inspect.js

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

package/dist/core/types/multicall.d.ts

@@ -0,0 +1,5 @@
+/** Multicall3 `aggregate3` 单条返回（与 IERC20 balanceOf / getEthBalance 解码路径一致） */
+export type Aggregate3CallResult = {
+    success: boolean;
+    returnData: string;
+};

package/dist/core/types/multicall.js

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

package/dist/core/types/private-sale.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 私募转账签名 — 类型定义
+ */
+import type { GeneratedWallet } from '../../utils/wallet.js';
+export interface PrivateSaleSignConfig {
+    rpcUrl: string;
+    chainId?: number;
+    gasLimit?: number;
+    gasPriceGwei?: number;
+    bribeAmount?: number;
+    extractProfit?: boolean;
+    profitBps?: number;
+}
+export interface PrivateSaleTransferParams {
+    senderPrivateKey: string;
+    recipient: string;
+    amount: number;
+}
+export interface BatchPrivateSaleParams {
+    transfers: PrivateSaleTransferParams[];
+    config: PrivateSaleSignConfig;
+}
+export interface PrivateSaleResult {
+    signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata: {
+        totalCount: number;
+        bribeCount: number;
+        transferCount: number;
+        profitCount: number;
+        totalAmountWei: string;
+        totalProfitWei: string;
+        bribeAmountWei: string;
+    };
+}

package/dist/core/types/private-sale.js

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

package/dist/core/types/quote-helpers.d.ts

@@ -0,0 +1,17 @@
+import type { JsonRpcProvider } from 'ethers';
+export type SupportedChain = 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
+export interface QuoteParams {
+    provider: JsonRpcProvider;
+    tokenIn: string;
+    tokenOut: string;
+    amountIn: bigint;
+    chain: string;
+    version?: 'v2' | 'v3';
+    fee?: number;
+    routerOverride?: string;
+}
+export interface QuoteResult {
+    amountOut: bigint;
+    path?: string[];
+    fee?: number;
+}

package/dist/core/types/quote-helpers.js

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

package/dist/core/types-erc20.d.ts

@@ -0,0 +1 @@
+export type { EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult, } from './types/erc20.js';

package/dist/core/types-erc20.js

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

package/dist/core/wallet/generate.d.ts

@@ -0,0 +1,5 @@
+export type GeneratedWallet = {
+    address: string;
+    privateKey: string;
+};
+export declare function generateWallets(count: number): GeneratedWallet[];

package/dist/core/wallet/generate.js

@@ -0,0 +1,8 @@
+import { Wallet } from 'ethers';
+export function generateWallets(count) {
+    const n = Math.max(0, Math.floor(count));
+    return Array.from({ length: n }, () => {
+        const w = Wallet.createRandom();
+        return { address: w.address, privateKey: w.privateKey };
+    });
+}

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

@@ -0,0 +1,269 @@
+import { ethers, Wallet, JsonRpcProvider } from 'ethers';
+import type { DirectRouterSignConfig } from './types.js';
+import type { GeneratedWallet } from '../../utils/wallet.js';
+/**
+ * 直接 Router 交易（不走代理合约）
+ *
+ * 支持：
+ * - BSC: PancakeSwap V2/V3
+ * - Monad: PancakeSwap V2, Uniswap V2/V3
+ *
+ * 收费方式：交易末尾附加利润提取交易（和内盘一致）
+ */
+export declare const providerCache: Map<string, ethers.JsonRpcProvider>;
+export declare const PROVIDER_CACHE_TTL = 60000;
+export declare const providerCacheTimestamps: Map<string, number>;
+/**
+ * 获取缓存的 Provider 实例
+ * - 根据 rpcUrl + chainId 作为缓存 key
+ * - 60秒后自动失效，避免长连接问题
+ */
+export declare function getCachedProvider(rpcUrl: string, chainId: number, chainName: string): JsonRpcProvider;
+export declare const DEFAULT_GAS_LIMIT = 300000;
+export declare const DEADLINE_MINUTES = 20;
+/**
+ * 截断小数位数，避免超过代币精度导致 parseUnits 报错
+ * 例如：truncateDecimals("21906.025000000000000000", 1) => "21906.0"
+ */
+export declare function truncateDecimals(value: string, decimals: number): string;
+/** Router 地址配置 - ✅ 使用公共模块中的地址 */
+export declare const DIRECT_ROUTERS: {
+    readonly BSC: {
+        readonly PANCAKESWAP_V2: "0x10ED43C718714eb63d5aA57B78B54704E256024E";
+        readonly PANCAKESWAP_V3: "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
+        readonly IROSWAP_V2: "0xe90fb729E458092592a79EdaFefB3404ecb3C463";
+        readonly WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
+    };
+    readonly MONAD: {
+        readonly PANCAKESWAP_V2: "0xb1bc24c34e88f7d43d5923034e3a14b24daacff9";
+        readonly PANCAKESWAP_V3: "0x1b81d678ffb9c0263b24a97847620c99d213eb14";
+        readonly UNISWAP_V2: "0x4b2ab38dbf28d31d467aa8993f6c2585981d6804";
+        readonly UNISWAP_V3: "0xd6145b2d3f379919e8cdeda7b97e37c4b2ca9c40";
+        readonly WMON: "0x3bd359c1119da7da1d913d1c4d2b7c461115433a";
+    };
+    readonly XLAYER: {
+        readonly POTATOSWAP_V2: "0x881fb2f98c13d521009464e7d1cbf16e1b394e8e";
+        readonly POTATOSWAP_V3: "0xB45D0149249488333E3F3f9F359807F4b810C1FC";
+        readonly DYORSWAP_ROUTER: "0xfb001fbbace32f09cb6d3c449b935183de53ee96";
+        readonly DYORSWAP_FACTORY: "0x2CcaDb1e437AA9cDc741574bDa154686B1F04C09";
+        readonly V3_ROUTER: "0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41";
+        readonly V3_FACTORY: "0xa1415fAe79c4B196d087F02b8aD5a622B8A827E5";
+        readonly WOKB: "0xe538905cf8410324e03a5a23c1c177a474d59b2b";
+    };
+    readonly ENI: {
+        readonly DSWAP_V2: "0x97ed8be49d9a8b86247090aa41e908e76b8fcf22";
+        readonly DSWAP_V3: "0xcdE487F5B460a516f31FaC520D4e18BA1C8cda49";
+        readonly IROSWAP_V2: "0x93b1199fA96f6b9b1f993AA0226eB6076968a9BF";
+        readonly WEGAS: "0x6d1e851446f4d004ae2a72f9afed85e8829a205e";
+    };
+};
+/** 链 ID 映射 */
+export declare const CHAIN_IDS: {
+    readonly BSC: 56;
+    readonly MONAD: 143;
+    readonly XLAYER: 196;
+    readonly ENI: 173;
+};
+/** 获取原生包装代币地址 */
+export declare function getWrappedNative(chain: string): string;
+/** V2 Router ABI */
+export declare const V2_ROUTER_ABI: string[];
+/** SwapRouter02 的 V2 方法 ABI - ✅ 从公共模块导入 */
+export declare const SWAP_ROUTER02_V2_ABI: string[];
+/**
+ * DYORSwap SwapRouter02 的 V2 方法
+ *
+ * ⚠️ 重要：DYORSwap 使用自定义的函数签名，无法通过标准 ABI 编码
+ * 必须手动构造 calldata
+ *
+ * swapExactTokensForTokens selector: 0x3234fe0d
+ * unwrapWETH9 selector: 0x7342292e
+ * refundETH selector: 0x6d29fcf4
+ */
+export declare const DYORSWAP_SELECTORS: {
+    swapExactTokensForTokens: string;
+    unwrapWETH9: string;
+    refundETH: string;
+    multicall: string;
+};
+/**
+ * 手动编码 DYORSwap 的 swapExactTokensForTokens calldata
+ *
+ * 参数格式 (根据成功交易分析):
+ * - amountIn: uint256
+ * - amountOutMin: uint256
+ * - path: address[] (动态) - offset from start
+ * - pools: address[] (动态) - offset from start
+ * - to: uint256 (address(2) = 2)
+ * - flag: uint256 (1)
+ * - factory: address
+ *
+ * 成功交易的布局:
+ * [0] amountIn
+ * [1] amountOutMin
+ * [2] offset to path = 0xa0 = 160 = 5 * 32 (从参数区域开始)
+ * [3] offset to pools = 0xe0 = 224 = 7 * 32
+ * [4] to = 2
+ * [5] flag = 1
+ * [6] factory
+ * [7] path.length
+ * [8+] path elements
+ * [N] pools.length
+ * [N+1+] pools elements
+ */
+export declare function encodeDYORSwapExactTokensForTokens(amountIn: bigint, amountOutMin: bigint, path: string[], pools: string[], to: string | bigint, // 可以是地址 (string) 或 address(2) 这样的特殊值 (bigint)
+flag: bigint, factory: string): string;
+/**
+ * 手动编码 DYORSwap 的 unwrapWETH9 calldata
+ *
+ * 参数格式 (根据成功交易分析):
+ * - amountMinimum: uint256
+ * - recipient: address
+ * - pools: bytes (动态) - 包含特殊的 pool 数据
+ *
+ * 成功交易的布局:
+ * [0] amountMinimum
+ * [1] recipient
+ * [2] offset to pools = 0x60 = 96 = 3 * 32
+ * [3] pools 数据 (bytes)
+ */
+export declare function encodeDYORUnwrapWETH9(amountMinimum: bigint, recipient: string, poolsData?: string): string;
+/**
+ * DYORSwap 的 ETHBack_Dividend 合约地址
+ * 这是 refundETH 中使用的固定地址，不是 LP 池地址
+ */
+export declare const DYORSWAP_ETHBACK_DIVIDEND: "0x2e61b0b4410f6fb941d47205191cbb8963d44bcc";
+/**
+ * 手动编码 DYORSwap 的 refundETH calldata
+ *
+ * 根据成功交易分析，refundETH 的格式是:
+ * refundETH(bytes pools)
+ *
+ * 成功交易的 refundETH (0x6d29fcf4):
+ * [0] offset to pools = 0x20 = 32
+ * [1] pools 数组长度 = 1
+ * [2] fee = 30 (0x1e)
+ * [3] ETHBack_Dividend 合约地址
+ */
+export declare function encodeDYORRefundETH(fee?: number): string;
+/**
+ * 手动编码 DYORSwap 的 multicall calldata
+ *
+ * multicall(uint256 deadline, bytes[] data)
+ * 这个函数使用标准 ABI 编码
+ */
+export declare function encodeDYORMulticall(deadline: bigint, data: string[]): string;
+/** V3 SwapRouter02 ABI (PancakeSwap V3, 新版 Uniswap) */
+export declare const V3_ROUTER02_ABI: (string | {
+    inputs: {
+        components: {
+            name: string;
+            type: string;
+        }[];
+        name: string;
+        type: string;
+    }[];
+    name: string;
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+    type: string;
+})[];
+/** V3 SwapRouter（旧版）ABI (Monad Uniswap V3) */
+export declare const V3_ROUTER_LEGACY_ABI: (string | {
+    inputs: {
+        components: {
+            name: string;
+            type: string;
+        }[];
+        name: string;
+        type: string;
+    }[];
+    name: string;
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+    type: string;
+})[];
+/**
+ * 判断是否使用旧版 SwapRouter
+ *
+ * 旧版特征：
+ * - exactInputSingle 包含 deadline 字段
+ * - multicall 只有 bytes[] 参数
+ *
+ * Monad 上的 V3 DEX 都使用旧版：
+ * - Uniswap V3: 0xd6145b2d3f379919e8cdeda7b97e37c4b2ca9c40
+ * - PancakeSwap V3: 0x1b81D678ffb9C0263b24A97847620C99d213eB14
+ *
+ * XLayer:
+ * - V3 Router (0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41) - 旧版（exactInputSingle 包含 deadline）
+ * - SwapRouter02 (0xB45D0149249488333E3F3f9F359807F4b810C1FC) - 新版（V2+V3 混合）
+ *
+ * BSC PancakeSwap V3 使用新版 SwapRouter02
+ */
+export declare function isLegacySwapRouter(chain: string, routerAddress: string): boolean;
+/** ERC20 ABI - ✅ 从公共模块导入 */
+export declare function getDeadline(minutes?: number): number;
+export declare function getGasLimit(config: DirectRouterSignConfig, defaultGas?: number): bigint;
+export declare function getGasPrice(provider: JsonRpcProvider, config: DirectRouterSignConfig): Promise<bigint>;
+export declare function isNativeToken(quoteToken?: string): boolean;
+export declare const XLAYER_V3_FACTORY_ABI: readonly ["function getPool(address tokenA, address tokenB, uint24 fee) view returns (address pool)"];
+export declare const XLAYER_V3_POOL_ABI: readonly ["function slot0() view returns (uint160 sqrtPriceX96,int24 tick,uint16 observationIndex,uint16 observationCardinality,uint16 observationCardinalityNext,uint8 feeProtocol,bool unlocked)", "function token0() view returns (address)", "function token1() view returns (address)"];
+export declare const V3_FEE_DENOMINATOR = 1000000n;
+export declare function quoteXLayerV3TokenToNativeBySlot0(params: {
+    provider: JsonRpcProvider;
+    tokenIn: string;
+    amountIn: bigint;
+    fee: number;
+}): Promise<bigint>;
+/**
+ * ✅ 找到金额最大的钱包索引（和 core.ts 逻辑一致）
+ */
+export declare function findMaxFlowIndex(amounts: bigint[]): number;
+/** 计算利润金额 */
+export declare function calculateProfitAmount(totalFlowWei: bigint): bigint;
+/**
+ * 构建利润多跳转账交易（强制 2 跳中转）
+ */
+export declare function buildProfitTransactionWithHops(provider: JsonRpcProvider, wallet: Wallet, profitAmountWei: bigint, nonce: number, gasPrice: bigint, chainId: number, txType?: 0 | 2, profitRecipient?: string): Promise<{
+    signedTransactions: string[];
+    hopWallets?: GeneratedWallet[];
+}>;
+/**
+ * 获取贿赂金额（wei）
+ * ✅ 仅 BSC 链支持贿赂
+ */
+export declare function getBribeAmount(config: DirectRouterSignConfig, chain: string): bigint;
+/** 构建贿赂交易（向 BlockRazor Builder EOA 转账 BNB） */
+export declare function buildBribeTransaction(wallet: Wallet, bribeAmountWei: bigint, nonce: number, gasPrice: bigint, chainId: number, txType?: 0 | 2): Promise<string>;
+/**
+ * 判断是否是 SwapRouter02 (XLayer PotatoSwap V3)
+ *
+ * SwapRouter02 风格的 Router 使用 multicall 包装 V2 方法：
+ * - multicall(uint256 deadline, bytes[] data)
+ * - data 内包含 swapExactTokensForTokens 等 V2 方法
+ *
+ * SwapRouter02 的 V2 方法签名不同：
+ * - swapExactTokensForTokens(amountIn, amountOutMin, path[], to) - 没有 deadline
+ * - 需要通过 multicall 的 deadline 参数传递 deadline
+ *
+ * ⚠️ 注意：DYORSwap 虽然也用 multicall，但它的 ABI 完全不同，需要单独处理
+ */
+export declare function isSwapRouter02(chain: string, routerAddress: string): boolean;
+/**
+ * 判断是否是 DYORSwap Router
+ *
+ * DYORSwap 使用 multicall，但它的 swapExactTokensForTokens 有特殊的 ABI：
+ * - swapExactTokensForTokens(amountIn, amountOutMin, path[], payer, flags, factory, pools)
+ * - unwrapWETH9(amountMinimum, recipient, pools)
+ */
+export declare function isDYORSwap(chain: string, routerAddress: string): boolean;
+export declare function filterEniNativeBuyIndices(balances: bigint[], flowAmounts: bigint[], gasLimit: number | bigint, gasPrice: bigint, profitWei: bigint): number[] | null;
+/**
+ * V2 批量买入（直接调用 Router）
+ */