four-flap-meme-sdk 1.9.49 → 2.1.0

package/dist/bundle-core/four-meme/types/buy-first.d.ts

@@ -0,0 +1,50 @@
+import type { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
+import type { GeneratedWallet } from '../../../utils/wallet.js';
+import type { FourSignConfig, UserType } from './index.js';
+export type FourBuyFirstSignConfig = FourSignConfig & {
+    reserveGasBNB?: number;
+    userType?: UserType;
+};
+export type FourBuyFirstConfig = CommonBundleConfig & {
+    apiKey: string;
+    customRpcUrl?: string;
+    bundleBlockOffset?: number;
+    reserveGasBNB?: number;
+    waitForConfirmation?: boolean;
+    waitTimeoutMs?: number;
+};
+export type FourBundleBuyFirstSignParams = {
+    buyerPrivateKey?: string;
+    buyerPrivateKeys?: string[];
+    buyerFunds?: string;
+    buyerFundsPercentage?: number;
+    sellerPrivateKey?: string;
+    sellerPrivateKeys?: string[];
+    tokenAddress: string;
+    config: FourBuyFirstSignConfig;
+    buyCount?: number;
+    sellCount?: number;
+};
+export type FourBundleBuyFirstParams = {
+    buyerPrivateKey: string;
+    buyerFunds?: string;
+    buyerFundsPercentage?: number;
+    sellerPrivateKey: string;
+    tokenAddress: string;
+    config: FourBuyFirstConfig;
+};
+export type FourBuyFirstResult = {
+    signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        buyerAddress: string;
+        sellerAddress: string;
+        buyAmount: string;
+        sellAmount: string;
+        profitAmount?: string;
+        buyCount?: number;
+        sellCount?: number;
+        buyAmounts?: string[];
+        sellAmounts?: string[];
+    };
+};

package/dist/bundle-core/four-meme/types/core-flow.d.ts

@@ -0,0 +1,63 @@
+import type { Wallet, JsonRpcProvider } from 'ethers';
+import type { NonceManager } from '../../../utils/bundle-helpers.js';
+import type { GeneratedWallet } from '../../../utils/wallet.js';
+import type { FourBundleMerkleConfig, FourCreateWithBundleBuySignParams, FourSignConfig, MerkleResultMetadata } from './index.js';
+export type FourAnyConfig = FourBundleMerkleConfig | FourSignConfig;
+export type ProfitMode = {
+    type: 'individual';
+} | {
+    type: 'aggregated';
+    payer?: Wallet;
+};
+export type BuyMetadata = MerkleResultMetadata | undefined;
+export interface ChainContext {
+    provider: JsonRpcProvider;
+    chainId: number;
+}
+export interface BuyFundsAnalysis {
+    fundsList: bigint[];
+    profitList: bigint[];
+    totalProfit: bigint;
+    totalBuyAmount: bigint;
+}
+export interface SellOutputs {
+    minOuts: bigint[];
+    quotedOutputs: bigint[];
+}
+export interface BuyFlowResult {
+    signedTxs: string[];
+    metadata: BuyMetadata;
+    profitHopWallets?: GeneratedWallet[];
+}
+export interface SellFlowResult {
+    signedTxs: string[];
+    profitHopWallets?: GeneratedWallet[];
+}
+export interface BuyFlowOptions {
+    wallets: Wallet[];
+    buyAmounts: string[];
+    tokenAddress: string;
+    config: FourAnyConfig;
+    provider: JsonRpcProvider;
+    nonceManager: NonceManager;
+    contractAddress: string;
+    gasPrice: bigint;
+    chainId: number;
+    profitMode: ProfitMode;
+    txType: number;
+}
+export interface SellFlowOptions {
+    wallets: Wallet[];
+    sellAmounts: string[];
+    tokenAddress: string;
+    minOutputAmounts?: (string | bigint)[];
+    config: FourAnyConfig;
+    provider: JsonRpcProvider;
+    nonceManager: NonceManager;
+    contractAddress: string;
+    gasPrice: bigint;
+    chainId: number;
+    rpcUrl: string;
+    txType: number;
+}
+export type FourCreateTokenInfo = FourCreateWithBundleBuySignParams['tokenInfo'];

package/dist/bundle-core/four-meme/types/index.d.ts

@@ -0,0 +1,600 @@
+import type { GeneratedWallet } from '../../../utils/wallet.js';
+import type { FourTokenTaxInfo } from '../../../shared/clients/four.js';
+import type { AmountLike } from '../../types.js';
+import type { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
+export type { AmountLike };
+export type FourSignConfig = {
+    rpcUrl: string;
+    fourApiUrl?: string;
+    club48Endpoint?: string;
+    club48ExplorerEndpoint?: string;
+    txType?: 0 | 2;
+    gasLimit?: number | bigint;
+    gasLimitMultiplier?: number;
+    gasPriceMultiplierPercent?: number;
+    minGasPriceGwei?: number;
+    chainId?: number;
+    prefer21000ForNative?: boolean;
+    checkBnbForErc20NoHop?: boolean;
+    estimateGas?: boolean;
+    customSubmitFn?: (signedTxs: string[]) => Promise<string>;
+    spPrivateKey?: string;
+    spMode?: 'none' | 'timestampPersonalSign' | 'concatTxHash' | 'rawTimestamp';
+    spVMode?: '27_28' | '0_1';
+    bribeAmount?: number;
+};
+export type FourBundleMerkleConfig = {
+    apiKey: string;
+    customRpcUrl?: string;
+    fourApiUrl?: string;
+    bundleBlockOffset?: number;
+    minBlockOffset?: number;
+    autoRetryBundle?: boolean;
+    maxBundleRetries?: number;
+    txType?: 0 | 2;
+    gasLimit?: number | bigint;
+    gasLimitMultiplier?: number;
+    gasPriceMultiplierPercent?: number;
+    minGasPriceGwei?: number;
+    waitForConfirmation?: boolean;
+    waitTimeoutMs?: number;
+    chainId?: number;
+    prefer21000ForNative?: boolean;
+    checkBnbForErc20NoHop?: boolean;
+    skipSubmit?: boolean;
+    /** BlockRazor 贿赂金额（BNB），与 `FourSignConfig` 对齐 */
+    bribeAmount?: number;
+};
+export type MerkleTransactionStatus = {
+    index: number;
+    hash: string;
+    success: boolean;
+    blockNumber?: number;
+    gasUsed?: string;
+    effectiveGasPrice?: string;
+    gasCost?: string;
+    error?: string;
+};
+export type MerkleBundleStatus = {
+    bundleHash: string;
+    txHashes: string[];
+    results: MerkleTransactionStatus[];
+    successCount: number;
+    totalGasUsed: bigint;
+    targetBlock: number;
+};
+/** Merkle 结果 metadata 字段值（各方法返回的键不固定，值类型统一收窄） */
+export type MerkleResultMetadataValue = string | number | boolean | string[] | undefined;
+/** 元数据（如利润信息等） */
+export type MerkleResultMetadata = Record<string, MerkleResultMetadataValue>;
+/**
+ * 统一的 Merkle 方法返回类型
+ * SDK 不再内部提交，只返回签名交易和元数据
+ */
+export type MerkleSignedResult = {
+    /** 已签名的交易数组（发送到服务器进行提交） */
+    signedTransactions: string[];
+    /** 创建代币时返回的代币地址（仅 create 方法使用） */
+    tokenAddress?: string;
+    /** ✅ 转账多跳中间钱包（disperse/sweep 使用，按接收者分组）- 兼容旧版 string[][] 和新版 GeneratedWallet[][] */
+    hopWallets?: (string | GeneratedWallet)[][];
+    /** ✅ 利润多跳中间钱包 */
+    profitHopWallets?: GeneratedWallet[];
+    /** 元数据（如利润信息等） */
+    metadata?: MerkleResultMetadata;
+    /** 交易哈希数组（内部提交时返回） */
+    txHashes?: string[];
+};
+/** ✅ 创建代币 + 购买参数（Merkle 版本 - 完整） */
+export type FourCreateWithBundleBuyMerkleParams = {
+    privateKeys: string[];
+    buyAmounts: string[];
+    b0Amount?: string;
+    tokenInfo: {
+        name: string;
+        symbol: string;
+        description: string;
+        imageUrl?: string;
+        imageFile?: Blob;
+        label?: 'Meme' | 'AI' | 'Defi' | 'Games' | 'Infra' | 'De-Sci' | 'Social' | 'Depin' | 'Charity' | 'Others';
+        preSale?: string;
+        webUrl?: string;
+        twitterUrl?: string;
+        telegramUrl?: string;
+        /** ✅ AntiSniperFeeMode（开盘高税模式） */
+        feePlan?: boolean;
+        /** ✅ 税币配置（Tax Token, creatorType=5） */
+        tokenTaxInfo?: FourTokenTaxInfo;
+    };
+    config: FourBundleMerkleConfig;
+};
+/** ✅ 创建代币 + 购买参数（仅签名版本 - 精简） */
+export type FourCreateWithBundleBuySignParams = {
+    privateKeys: string[];
+    buyAmounts: string[];
+    b0Amount?: string;
+    tokenInfo: {
+        name: string;
+        symbol: string;
+        description: string;
+        imageUrl?: string;
+        imageFile?: Blob;
+        label?: 'Meme' | 'AI' | 'Defi' | 'Games' | 'Infra' | 'De-Sci' | 'Social' | 'Depin' | 'Charity' | 'Others';
+        preSale?: string;
+        webUrl?: string;
+        twitterUrl?: string;
+        telegramUrl?: string;
+        /** ✅ AntiSniperFeeMode（开盘高税模式） */
+        feePlan?: boolean;
+        /** ✅ 税币配置（Tax Token, creatorType=5） */
+        tokenTaxInfo?: FourTokenTaxInfo;
+    };
+    config: FourSignConfig;
+};
+/**
+ * ✅ 创建代币 + 购买结果（简化版）
+ * 包含 tokenAddress 用于返回创建的代币地址
+ */
+export type FourCreateWithBundleBuyMerkleResult = MerkleSignedResult;
+/** ✅ 批量购买参数（Merkle 版本 - 完整） */
+export type FourBatchBuyMerkleParams = {
+    privateKeys: string[];
+    buyAmounts: string[];
+    tokenAddress: string;
+    config: FourBundleMerkleConfig;
+};
+/** ✅ 批量购买参数（仅签名版本 - 精简） */
+export type FourBatchBuySignParams = {
+    privateKeys: string[];
+    buyAmounts: string[];
+    tokenAddress: string;
+    config: FourSignConfig;
+};
+/** ✅ 批量购买结果（简化版） */
+export type FourBatchBuyMerkleResult = MerkleSignedResult;
+/** ✅ 批量卖出参数（Merkle 版本 - 完整） */
+export type FourBatchSellMerkleParams = {
+    privateKeys: string[];
+    sellAmounts: string[];
+    tokenAddress: string;
+    minOutputAmounts?: (string | bigint)[];
+    config: FourBundleMerkleConfig;
+};
+/** ✅ 批量卖出参数（仅签名版本 - 精简） */
+export type FourBatchSellSignParams = {
+    privateKeys: string[];
+    sellAmounts: string[];
+    tokenAddress: string;
+    minOutputAmounts?: (string | bigint)[];
+    config: FourSignConfig;
+};
+/** ✅ 批量卖出结果（简化版） */
+export type FourBatchSellMerkleResult = MerkleSignedResult;
+/** ✅ 私有交易基础配置（Merkle 版本 - 完整） */
+export type FourPrivateMerkleBase = {
+    config: FourBundleMerkleConfig;
+};
+/** ✅ 私有交易基础配置（仅签名版本 - 精简） */
+export type FourPrivateSignBase = {
+    config: FourSignConfig;
+};
+/** ✅ 私有购买参数（Merkle 版本 - 完整） */
+export type FourPrivateBuyMerkleParams = FourPrivateMerkleBase & {
+    privateKey: string;
+    tokenAddress: string;
+    funds: string;
+    to?: string;
+};
+/** ✅ 私有购买参数（仅签名版本 - 精简） */
+export type FourPrivateBuySignParams = FourPrivateSignBase & {
+    privateKey: string;
+    tokenAddress: string;
+    funds: string;
+    to?: string;
+};
+/** ✅ 私有卖出参数（Merkle 版本 - 完整） */
+export type FourPrivateSellMerkleParams = FourPrivateMerkleBase & {
+    privateKey: string;
+    tokenAddress: string;
+    amount: string;
+    minFunds?: bigint;
+};
+/** ✅ 私有卖出参数（仅签名版本 - 精简） */
+export type FourPrivateSellSignParams = FourPrivateSignBase & {
+    privateKey: string;
+    tokenAddress: string;
+    amount: string;
+    minFunds?: bigint;
+};
+/** ✅ 私有交易结果（简化版） */
+export type FourPrivateTransactionResult = MerkleSignedResult;
+/** ✅ 批量私有购买参数（Merkle 版本 - 完整） */
+export type FourBatchPrivateBuyMerkleParams = FourPrivateMerkleBase & {
+    privateKeys: string[];
+    fundsList: string[];
+    tokenAddress: string;
+};
+/** ✅ 批量私有购买参数（仅签名版本 - 精简） */
+export type FourBatchPrivateBuySignParams = FourPrivateSignBase & {
+    privateKeys: string[];
+    fundsList: string[];
+    tokenAddress: string;
+};
+/** ✅ 批量私有卖出参数（Merkle 版本 - 完整） */
+export type FourBatchPrivateSellMerkleParams = FourPrivateMerkleBase & {
+    privateKeys: string[];
+    amounts: string[];
+    tokenAddress: string;
+    minFundsEach?: bigint;
+};
+/** ✅ 批量私有卖出参数（仅签名版本 - 精简） */
+export type FourBatchPrivateSellSignParams = FourPrivateSignBase & {
+    privateKeys: string[];
+    amounts: string[];
+    tokenAddress: string;
+    minFundsEach?: bigint;
+};
+/** ✅ 批量私有交易结果（简化版） */
+export type FourBatchPrivateMerkleResult = MerkleSignedResult;
+/** ✅ 分发参数（Merkle 版本 - 完整） */
+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 TokenPoolType = 'flap' | 'four' | 'v2' | 'v3';
+/** 报价代币类型（池子的计价代币） */
+export type QuoteTokenType = 'native' | 'usdt' | 'usdc';
+/**
+ * 用户类型（用于利润费率）
+ * - v0: 万分之6 (6 bps = 0.06%)
+ * - v1: 万分之5 (5 bps = 0.05%)
+ */
+export type UserType = 'v0' | 'v1';
+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;
+/** ✅ 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;
+};
+/** 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;
+    };
+};
+export type * from './swap-internal.js';
+export type * from './buy-first.js';