four-flap-meme-sdk 2.2.8 → 2.2.11

package/dist/chains/xlayer/eip7702/types.d.ts

@@ -53,8 +53,6 @@ export interface BundleBuyParams {
     routerAddress?: string;
     /** V3 费率（可选，默认 2500，仅 V3 使用） */
     fee?: number;
-    /** 用户类型（影响利润率） */
-    userType?: UserType;
     /** 配置 */
     config?: EIP7702Config;
 }
@@ -89,8 +87,6 @@ export interface BundleSellParams {
     routerAddress?: string;
     /** V3 费率（可选，默认 2500，仅 V3 使用） */
     fee?: number;
-    /** 用户类型（影响利润率） */
-    userType?: UserType;
     /** 配置 */
     config?: EIP7702Config;
 }
@@ -160,14 +156,6 @@ export interface BundleSwapParams {
     routerAddress?: string;
     /** V3 费率（可选，默认 2500，仅 V3 使用） */
     fee?: number;
-    /** 用户类型（影响利润率） */
-    userType?: UserType;
-    /**
-     * 是否使用资金利用率模式（默认 false）
-     * - false（普通模式）: 卖家卖出 OKB 留在卖家账户，买家用自己预存的 OKB 买入
-     * - true（资金利用率模式）: 卖家卖出的 OKB 通过多跳转账给买家，买家用收到的 OKB 买入
-     */
-    useFundUtilization?: boolean;
     /** 配置 */
     config?: EIP7702Config;
 }
@@ -192,14 +180,6 @@ export interface BundleBatchSwapParams {
     routerAddress?: string;
     /** V3 费率（可选，默认 2500，仅 V3 使用） */
     fee?: number;
-    /** 用户类型（影响利润率） */
-    userType?: UserType;
-    /**
-     * 是否使用资金利用率模式（默认 false）
-     * - false（普通模式）: 卖家卖出 OKB 留在卖家账户，买家用自己预存的 OKB 买入
-     * - true（资金利用率模式）: 卖家卖出的 OKB 通过多跳转账给买家，买家用收到的 OKB 买入
-     */
-    useFundUtilization?: boolean;
     /** 配置 */
     config?: EIP7702Config;
 }
@@ -462,74 +442,6 @@ export interface BundleCreateToDexResult {
         profitAmount: string;
     };
 }
-export interface BundleMultiSwapParams {
-    /** Payer 钱包私钥（支付 Gas 费） */
-    mainPrivateKey: string;
-    /** 卖出钱包私钥列表 */
-    sellerPrivateKeys: string[];
-    /** 买入钱包私钥列表 */
-    buyerPrivateKeys: string[];
-    /** 买入总金额 (OKB) */
-    totalBuyAmount: string;
-    /** 代币地址 */
-    tokenAddress: string;
-    /** 代币精度 */
-    tokenDecimals?: number;
-    /** 卖出百分比（1-100，默认 100） */
-    sellPercent?: number;
-    /** 交易类型：FLAP 内盘 / V2 / V3（默认 V3） */
-    tradeType?: TradeType;
-    /** 路由地址（可选，根据 tradeType 自动选择） */
-    routerAddress?: string;
-    /** V3 费率（可选，默认 2500，仅 V3 使用） */
-    fee?: number;
-    /** 用户类型（影响利润率） */
-    userType?: UserType;
-    /** 配置 */
-    config?: EIP7702Config;
-}
-export interface BundleMultiSwapResult {
-    /** 签名后的交易 */
-    signedTransaction: string;
-    /** 元数据 */
-    metadata: {
-        payerAddress: string;
-        sellerAddresses: string[];
-        buyerAddresses: string[];
-        sellerCount: number;
-        buyerCount: number;
-        totalBuyAmount: string;
-        totalSellAmount: string;
-        profitAmount: string;
-        profitRecipient: string;
-        userType: string;
-    };
-}
-export interface BundleApproveMultiSpendersParams {
-    /** 主钱包（发起交易，支付 gas） */
-    mainPrivateKey: string;
-    /** 需要授权的钱包私钥列表 */
-    privateKeys: string[];
-    /** 代币地址 */
-    tokenAddress: string;
-    /** 授权给的地址列表（多个 spender） */
-    spenderAddresses: string[];
-    /** 授权金额（可选，默认 MaxUint256） */
-    amount?: bigint;
-    /** 配置 */
-    config?: EIP7702Config;
-}
-export interface BundleApproveMultiSpendersResult {
-    /** 签名后的交易 */
-    signedTransaction: string;
-    /** 元数据 */
-    metadata: {
-        walletCount: number;
-        tokenAddress: string;
-        spenderAddresses: string[];
-        totalApproveCalls: number;
-    };
-}
 export type AmountMode = 'average' | 'random' | 'custom';
 export interface BundleGraduateBuyParams {
     /** 代币地址 */

package/dist/chains/xlayer/eip7702/utils.d.ts

@@ -62,6 +62,9 @@ export type UserType = 'v0' | 'v1' | 'default';
 export declare function getProfitRateBps(userType?: UserType): number;
 /**
  * 根据用户类型获取利润率（双边/换手模式）
+ * - v0: 4 bps = 0.04%
+ * - v1: 5 bps = 0.05%
+ * - default: 4 bps = 0.04%
  */
 export declare function getProfitRateBpsDouble(userType?: UserType): number;
 /**

package/dist/chains/xlayer/eip7702/utils.js

@@ -1,11 +1,9 @@
 /**
  * EIP-7702 XLayer 工具函数
  */
-import { ethers, Wallet } from 'ethers';
-import { createXLayerProvider } from '../../../utils/provider-factory.js';
+import { ethers, Wallet, JsonRpcProvider } from 'ethers';
 import * as rlp from '@ethereumjs/rlp';
-import { XLAYER_CHAIN_ID, XLAYER_RPC_URL, MULTICALL3_ADDRESS, GAS_ESTIMATE, EIP7702_TX_TYPE, EIP7702_AUTH_PREFIX, MULTICALL3_ABI, DEFAULT_DEADLINE_MINUTES, } from './constants.js';
-import { getProfitRateBps as getSharedProfitRateBps, getProfitRecipient as pickRandomProfitRecipient, } from '../../../shared/constants/index.js';
+import { XLAYER_CHAIN_ID, XLAYER_RPC_URL, MULTICALL3_ADDRESS, GAS_ESTIMATE, EIP7702_TX_TYPE, EIP7702_AUTH_PREFIX, MULTICALL3_ABI, PROFIT_CONFIG, DEFAULT_DEADLINE_MINUTES, } from './constants.js';
 // ========================================
 // 字节转换工具
 // ========================================
@@ -43,7 +41,7 @@ const providerCache = new Map();
 export function getCachedProvider(rpcUrl = XLAYER_RPC_URL) {
     let provider = providerCache.get(rpcUrl);
     if (!provider) {
-        provider = createXLayerProvider(rpcUrl);
+        provider = new JsonRpcProvider(rpcUrl, { chainId: XLAYER_CHAIN_ID, name: 'xlayer' });
         providerCache.set(rpcUrl, provider);
     }
     return provider;
@@ -222,7 +220,11 @@ export function generateRandomWallets(count) {
 // EIP-7702 授权签名
 // ========================================
 export async function signAuthorization(wallet, delegateAddress, nonce, chainId = XLAYER_CHAIN_ID) {
-    const authData = [bigintToBytes(BigInt(chainId)), addressToBytes(delegateAddress), bigintToBytes(nonce)];
+    const authData = [
+        bigintToBytes(BigInt(chainId)),
+        addressToBytes(delegateAddress),
+        bigintToBytes(nonce),
+    ];
     const rlpEncoded = rlp.encode(authData);
     const toSign = new Uint8Array(1 + rlpEncoded.length);
     toSign[0] = EIP7702_AUTH_PREFIX;
@@ -251,7 +253,7 @@ export async function signAuthorizationWithNonce(wallet, delegateAddress, provid
  */
 export async function signAuthorizationsBatch(wallets, delegateAddress, provider, mainWalletIndex) {
     // 并行获取所有钱包的 nonce
-    const nonces = await Promise.all(wallets.map((w) => provider.getTransactionCount(w.address, 'pending')));
+    const nonces = await Promise.all(wallets.map(w => provider.getTransactionCount(w.address, 'pending')));
     // 并行签署所有授权（签名是同步 CPU 操作，但包装成 Promise 以保持一致性）
     return Promise.all(wallets.map((wallet, i) => {
         const isMainWallet = mainWalletIndex !== undefined && i === mainWalletIndex;
@@ -293,7 +295,7 @@ export function signAuthorizationsWithNonces(wallets, nonces, delegateAddress, m
  * 批量获取多个地址的 nonce - 并行
  */
 export async function batchGetNonces(addresses, provider) {
-    return Promise.all(addresses.map((addr) => provider.getTransactionCount(addr, 'pending')));
+    return Promise.all(addresses.map(addr => provider.getTransactionCount(addr, 'pending')));
 }
 // ========================================
 // EIP-7702 交易构建
@@ -312,14 +314,14 @@ export async function buildEIP7702Transaction(mainWallet, authorizations, calls,
     const maxFeePerGas = feeData.maxFeePerGas || ethers.parseUnits('50', 'gwei');
     const multicall3 = new ethers.Interface(MULTICALL3_ABI);
     const callData = multicall3.encodeFunctionData('aggregate3Value', [
-        calls.map((c) => ({
+        calls.map(c => ({
             target: c.target,
             allowFailure: c.allowFailure,
             value: c.value,
             callData: c.callData,
-        })),
+        }))
     ]);
-    const authList = authorizations.map((auth) => [
+    const authList = authorizations.map(auth => [
         bigintToBytes(auth.chainId),
         addressToBytes(auth.address),
         bigintToBytes(auth.nonce),
@@ -370,14 +372,14 @@ export function buildEIP7702TransactionSync(mainWallet, authorizations, calls, t
     const maxFeePerGas = feeData.maxFeePerGas || ethers.parseUnits('50', 'gwei');
     const multicall3 = new ethers.Interface(MULTICALL3_ABI);
     const callData = multicall3.encodeFunctionData('aggregate3Value', [
-        calls.map((c) => ({
+        calls.map(c => ({
             target: c.target,
             allowFailure: c.allowFailure,
             value: c.value,
             callData: c.callData,
-        })),
+        }))
     ]);
-    const authList = authorizations.map((auth) => [
+    const authList = authorizations.map(auth => [
         bigintToBytes(auth.chainId),
         addressToBytes(auth.address),
         bigintToBytes(auth.nonce),
@@ -425,26 +427,29 @@ export function buildEIP7702TransactionSync(mainWallet, authorizations, calls, t
  */
 export function getProfitRateBps(userType) {
     if (userType === 'v0')
-        return getSharedProfitRateBps('v0Single');
+        return PROFIT_CONFIG.RATE_BPS_V0;
     if (userType === 'v1')
-        return getSharedProfitRateBps('v1Single');
-    return getSharedProfitRateBps('v0Single');
+        return PROFIT_CONFIG.RATE_BPS_V1;
+    return PROFIT_CONFIG.RATE_BPS_V0; // 默认使用 v0 费率
 }
 /**
  * 根据用户类型获取利润率（双边/换手模式）
+ * - v0: 4 bps = 0.04%
+ * - v1: 5 bps = 0.05%
+ * - default: 4 bps = 0.04%
  */
 export function getProfitRateBpsDouble(userType) {
     if (userType === 'v0')
-        return getSharedProfitRateBps('v0Double');
+        return PROFIT_CONFIG.RATE_BPS_V0_DOUBLE;
     if (userType === 'v1')
-        return getSharedProfitRateBps('v1Double');
-    return getSharedProfitRateBps('v0Double');
+        return PROFIT_CONFIG.RATE_BPS_V1_DOUBLE;
+    return PROFIT_CONFIG.RATE_BPS_V0_DOUBLE; // 默认使用 v0 费率
 }
 /**
  * 计算利润金额（旧版兼容）
  */
 export function calculateProfitAmount(totalFlowWei, isSwapMode = false) {
-    const rateBps = getSharedProfitRateBps(isSwapMode ? 'bundleSwap' : 'normal');
+    const rateBps = isSwapMode ? PROFIT_CONFIG.RATE_BPS_SWAP : PROFIT_CONFIG.RATE_BPS;
     return (totalFlowWei * BigInt(rateBps)) / 10000n;
 }
 /**
@@ -473,7 +478,7 @@ export function calculateProfitAmountByTxCount(totalFlowWei, txCount, userType)
     return (totalFlowWei * BigInt(totalRateBps)) / 10000n;
 }
 export function getProfitRecipient(config) {
-    return config?.profitRecipient ?? pickRandomProfitRecipient();
+    return config?.profitRecipient ?? PROFIT_CONFIG.RECIPIENT;
 }
 // ========================================
 // 时间工具
@@ -482,5 +487,5 @@ export function getDeadline(minutes = DEFAULT_DEADLINE_MINUTES) {
     return Math.floor(Date.now() / 1000) + minutes * 60;
 }
 export function delay(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
+    return new Promise(resolve => setTimeout(resolve, ms));
 }

package/dist/chains/xlayer/eip7702/volume.d.ts

@@ -1,14 +1,156 @@
-import type { EIP7702Config, TradeType } from './types.js';
-import { WashVolumeParams, WashVolumeResult, BundleVolumeParams, BundleVolumeResult, SingleRoundVolumeResult, MakeVolumeParams, MakeVolumeSignResult, SwapVolumeSignResult } from './volume-helpers.js';
-export type { VolumeMode, PoolType, VolumeProgress, WashVolumeParams, WashVolumeResult, BundleVolumeParams, BundleVolumeResult, SingleRoundVolumeResult, MakeVolumeParams, MakeVolumeSignResult, SwapVolumeSignResult, } from './volume-helpers.js';
+/**
+ * EIP-7702 XLayer 刷量功能
+ *
+ * 支持两种模式：
+ * 1. 无币模式 (Wash): 单钱包买入+卖出，不需要预先持有代币
+ * 2. 捆绑模式 (Bundle): 多钱包批量买入 + 批量卖出
+ *
+ * 支持池子类型：
+ * - FLAP: 内盘 (Flap Portal)
+ * - V2: PotatoSwap V2 外盘
+ * - V3: PotatoSwap V3 外盘
+ *
+ * 只生成签名，由调用方决定如何提交
+ */
+import type { EIP7702Config, TradeType, GeneratedWallet } from './types.js';
+import { type UserType } from './utils.js';
+export type VolumeMode = 'wash' | 'bundle';
+export type PoolType = 'FLAP' | 'V2' | 'V3';
+export interface VolumeProgress {
+    currentRound: number;
+    totalRounds: number;
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    message?: string;
+}
+export interface WashVolumeParams {
+    /** Payer 钱包私钥（支付 Gas 费） */
+    mainPrivateKey: string;
+    /** 钱包私钥列表（每个钱包独立执行买入+卖出） */
+    privateKeys: string[];
+    /** 代币地址 */
+    tokenAddress: string;
+    /** 代币精度 */
+    tokenDecimals?: number;
+    /** 每个钱包的买入金额 (OKB) */
+    buyAmountPerWallet: string;
+    /** 卖出百分比（1-100） */
+    sellPercent?: number;
+    /** 池子类型 */
+    poolType?: PoolType;
+    /** 路由地址（V2/V3 模式） */
+    routerAddress?: string;
+    /** V3 费率 */
+    fee?: number;
+    /** 用户类型（影响利润率） */
+    userType?: UserType;
+    /** EIP-7702 配置 */
+    config?: EIP7702Config;
+}
+export interface WashVolumeResult {
+    signedTransaction: string;
+    metadata: {
+        walletCount: number;
+        buyAmountPerWallet: string;
+        totalBuyAmount: string;
+        sellPercent: number;
+        poolType: PoolType;
+        profitAmount: string;
+    };
+}
+/**
+ * 无币刷量 - 每个钱包执行买入+卖出
+ *
+ * 核心逻辑：[利润刮取] + [钱包1买入] + [钱包1卖出] + [钱包2买入] + [钱包2卖出] + ...
+ *
+ * 特点：
+ * - 钱包不需要预先持有代币
+ * - 每个钱包在同一笔交易中完成买入和卖出
+ * - 利润从主钱包统一支付
+ *
+ * @example
+ * const result = await washVolume({
+ *   privateKeys: ['0x...', '0x...'],
+ *   tokenAddress: '0x...',
+ *   buyAmountPerWallet: '0.01',
+ *   sellPercent: 100,
+ *   poolType: 'V3',
+ * });
+ */
 export declare function washVolume(params: WashVolumeParams): Promise<WashVolumeResult>;
+export interface BundleVolumeParams {
+    /** Payer 钱包私钥（支付 Gas 费） */
+    mainPrivateKey: string;
+    /** 买入钱包私钥列表 */
+    buyerPrivateKeys: string[];
+    /** 每个买家的买入金额 (OKB) */
+    buyAmounts: string[];
+    /** 卖出钱包私钥列表 */
+    sellerPrivateKeys: string[];
+    /** 每个卖家的卖出数量（代币）或百分比 */
+    sellAmounts?: string[];
+    /** 卖出百分比（当 sellAmounts 未提供时使用） */
+    sellPercent?: number;
+    /** 代币地址 */
+    tokenAddress: string;
+    /** 代币精度 */
+    tokenDecimals?: number;
+    /** 池子类型 */
+    poolType?: PoolType;
+    /** 路由地址 */
+    routerAddress?: string;
+    /** V3 费率 */
+    fee?: number;
+    /** 用户类型（影响利润率） */
+    userType?: UserType;
+    /** EIP-7702 配置 */
+    config?: EIP7702Config;
+}
+export interface BundleVolumeResult {
+    signedTransaction: string;
+    metadata: {
+        buyerCount: number;
+        sellerCount: number;
+        totalBuyAmount: string;
+        totalSellAmount: string;
+        poolType: PoolType;
+        profitAmount: string;
+    };
+}
 /**
  * 捆绑刷量 - 多钱包批量买入 + 批量卖出
  *
  * 核心逻辑：[利润刮取] + [买入Ops...] + [卖出Ops...]
+ *
+ * 特点：
+ * - 买入和卖出可以使用不同的钱包
+ * - 所有操作在一笔交易中原子执行
+ * - 卖出钱包需要预先持有代币
+ *
+ * @example
+ * const result = await bundleVolume({
+ *   buyerPrivateKeys: ['0x...', '0x...'],
+ *   buyAmounts: ['0.01', '0.02'],
+ *   sellerPrivateKeys: ['0x...'],
+ *   sellPercent: 100,
+ *   tokenAddress: '0x...',
+ *   poolType: 'FLAP',
+ * });
  */
 export declare function bundleVolume(params: BundleVolumeParams): Promise<BundleVolumeResult>;
-/** 生成单轮刷量签名（买入 + 卖出分开，两笔独立交易） */
+export interface SingleRoundVolumeResult {
+    buySignedTransaction: string;
+    sellSignedTransaction: string;
+    metadata: {
+        buyAmount: string;
+        sellPercent: number;
+        walletCount: number;
+    };
+}
+/**
+ * 生成单轮刷量签名（买入 + 卖出分开）
+ *
+ * 注意：买入和卖出是两笔独立交易
+ */
 export declare function singleRoundVolume(params: {
     privateKeys: string[];
     tokenAddress: string;
@@ -20,9 +162,45 @@ export declare function singleRoundVolume(params: {
     fee?: number;
     config?: EIP7702Config;
 }): Promise<SingleRoundVolumeResult>;
-/** 生成多轮刷量签名（由于 nonce 限制，仅预生成第一轮） */
+export interface MakeVolumeParams {
+    privateKeys: string[];
+    tokenAddress: string;
+    tokenDecimals?: number;
+    buyAmountPerRound: string;
+    rounds: number;
+    tradeType?: TradeType;
+    routerAddress?: string;
+    fee?: number;
+    onProgress?: (progress: VolumeProgress) => void;
+    config?: EIP7702Config;
+}
+export interface MakeVolumeSignResult {
+    rounds: SingleRoundVolumeResult[];
+    metadata: {
+        totalRounds: number;
+        totalBuyAmount: string;
+        walletCount: number;
+    };
+}
+/**
+ * 生成多轮刷量签名
+ *
+ * 注意：由于 nonce 问题，只能预生成第一轮
+ * 后续轮次需要在前一轮交易确认后才能生成
+ */
 export declare function makeVolume(params: MakeVolumeParams): Promise<MakeVolumeSignResult>;
-/** 生成换手刷量签名 */
+export interface SwapVolumeSignResult {
+    signedTransaction: string;
+    hopWallets: GeneratedWallet[];
+    metadata: {
+        sellerAddress: string;
+        buyerAddress: string;
+        sellAmount: string;
+    };
+}
+/**
+ * 生成换手刷量签名
+ */
 export declare function makeVolumeWithSwap(params: {
     sellerPrivateKey: string;
     buyerPrivateKey: string;