four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/chains/xlayer/eip7702/volume-wash.js

@@ -0,0 +1,191 @@
+/**
+ * EIP-7702 无币刷量 (Wash Mode)
+ *
+ * 每个钱包执行买入 + 卖出，不需要预先持有代币
+ * 只生成签名，由调用方决定如何提交
+ */
+import { ethers, Contract } from 'ethers';
+import { truncateDecimals } from './volume-helpers.js';
+import { getCachedProvider, createWallet, signAuthorizationsWithNonces, batchGetNonces, buildEIP7702TransactionSync, calculateProfitAmountByTxCount, getProfitRecipient, } from './utils.js';
+import { UNIFIED_DELEGATE_ADDRESS, UNIFIED_DELEGATE_ABI, FLAP_PORTAL_ABI, FLAP_PORTAL_ADDRESS, WOKB_ADDRESS, V3_FEE_TIERS, } from './constants.js';
+import { quoteV2, quoteV3 } from '../../../core/quote/quote-helpers.js';
+import { getDefaultRouter, buildBuyCall, buildSellCall, buildSellCallWithAmount } from './volume-internal.js';
+export async function washVolume(params) {
+    const { mainPrivateKey, privateKeys, tokenAddress, tokenDecimals = 18, buyAmountPerWallet, sellPercent = 100, poolType = 'V3', routerAddress, fee = V3_FEE_TIERS.MEDIUM, userType = 'v0', // ✅ 用户类型（影响利润率）
+    config, } = params;
+    if (!mainPrivateKey) {
+        throw new Error('必须提供 mainPrivateKey（Payer 钱包私钥）');
+    }
+    if (privateKeys.length === 0) {
+        throw new Error('至少需要一个钱包');
+    }
+    // ✅ 验证私钥格式
+    const isValidPrivateKey = (pk) => {
+        const trimmed = (pk || '').trim();
+        return trimmed.length >= 64 && (trimmed.startsWith('0x') || /^[0-9a-fA-F]{64}$/.test(trimmed));
+    };
+    if (!isValidPrivateKey(mainPrivateKey)) {
+        throw new Error('mainPrivateKey 格式无效');
+    }
+    const validPrivateKeys = privateKeys.filter((pk) => isValidPrivateKey(pk));
+    if (validPrivateKeys.length === 0) {
+        throw new Error('没有有效的私钥（私钥必须是 0x 开头的 66 位或 64 位十六进制字符串）');
+    }
+    const actualPrivateKeys = validPrivateKeys;
+    const provider = getCachedProvider(config?.rpcUrl);
+    // ✅ 空字符串也使用默认值
+    const delegateAddress = (config?.delegateAddress && config.delegateAddress.trim()) || UNIFIED_DELEGATE_ADDRESS;
+    const delegateInterface = new ethers.Interface(UNIFIED_DELEGATE_ABI);
+    const portalInterface = new ethers.Interface(FLAP_PORTAL_ABI);
+    // 获取实际路由地址
+    const actualRouter = routerAddress ?? getDefaultRouter(poolType);
+    // ✅ 创建 Payer 钱包（支付 Gas 费）
+    const mainWallet = createWallet(mainPrivateKey, provider);
+    // 创建交易钱包（使用验证后的私钥）
+    const wallets = actualPrivateKeys.map((pk) => createWallet(pk, provider));
+    // 计算金额（无币刷量：每个钱包 1买 + 1卖 = 2笔交易）
+    const buyAmountWei = ethers.parseEther(truncateDecimals(buyAmountPerWallet));
+    const totalBuyAmount = buyAmountWei * BigInt(wallets.length);
+    const totalTxCount = wallets.length * 2; // 每个钱包 1买 + 1卖
+    const profitAmount = calculateProfitAmountByTxCount(totalBuyAmount, totalTxCount, userType);
+    const profitRecipient = getProfitRecipient(config);
+    // ========================================
+    // 合并所有钱包（去重）
+    // mainWallet 需要参与授权签名（因为它执行利润刮取的 delegate 调用）
+    // ========================================
+    const allWalletsMap = new Map();
+    allWalletsMap.set(mainWallet.address.toLowerCase(), mainWallet);
+    wallets.forEach((w) => allWalletsMap.set(w.address.toLowerCase(), w));
+    const allWallets = Array.from(allWalletsMap.values());
+    // 找出 mainWallet 在 allWallets 中的索引
+    const mainWalletIndex = allWallets.findIndex((w) => w.address.toLowerCase() === mainWallet.address.toLowerCase());
+    // ========================================
+    // 并行获取数据
+    // ========================================
+    const allAddresses = allWallets.map((w) => w.address);
+    // ✅ 对所有模式，使用【总金额报价 + 按比例分配】
+    // 因为所有钱包在同一笔交易中执行，会累积影响价格
+    // 这确保了「买多少就卖多少」，避免清空钱包预存代币
+    let estimatedTokenAmounts = [];
+    const totalBuyWei = buyAmountWei * BigInt(wallets.length);
+    if (poolType === 'FLAP') {
+        try {
+            const portalContract = new Contract(FLAP_PORTAL_ADDRESS, FLAP_PORTAL_ABI, provider);
+            // ✅ 使用 previewBuy（与 AA 模式一致），降级到 quoteExactInput
+            // 某些代币的 previewBuy 会 revert (0xac5f6092)，降级到 quoteExactInput
+            let totalTokenAmount = 0n;
+            try {
+                totalTokenAmount = await portalContract.previewBuy(tokenAddress, totalBuyWei);
+            }
+            catch {
+                try {
+                    totalTokenAmount = await portalContract.quoteExactInput.staticCall({
+                        inputToken: ethers.ZeroAddress, // OKB
+                        outputToken: tokenAddress, // Token
+                        inputAmount: totalBuyWei,
+                    });
+                }
+                catch {
+                    totalTokenAmount = 0n;
+                }
+            }
+            // 按每个钱包的买入金额比例分配（由于每个钱包金额相同，均分即可）
+            if (totalBuyWei > 0n && totalTokenAmount > 0n) {
+                const sharePerWallet = totalTokenAmount / BigInt(wallets.length);
+                let allocated = 0n;
+                estimatedTokenAmounts = wallets.map((_, i) => {
+                    if (i === wallets.length - 1) {
+                        // 最后一个钱包分配剩余的全部（避免精度损失）
+                        return totalTokenAmount - allocated;
+                    }
+                    allocated += sharePerWallet;
+                    return sharePerWallet;
+                });
+            }
+        }
+        catch {
+            // FLAP quote failed
+        }
+    }
+    else if (poolType === 'V2' || poolType === 'V3') {
+        // ✅ V2/V3 外盘模式：通过报价获取预估代币数量，确保买卖对等
+        try {
+            let totalTokenAmount = 0n;
+            if (poolType === 'V3') {
+                const result = await quoteV3(provider, WOKB_ADDRESS, tokenAddress, totalBuyWei, 'XLAYER', fee);
+                totalTokenAmount = result.amountOut;
+            }
+            else {
+                const result = await quoteV2(provider, WOKB_ADDRESS, tokenAddress, totalBuyWei, 'XLAYER');
+                totalTokenAmount = result.amountOut;
+            }
+            // 均分到每个钱包
+            if (totalBuyWei > 0n && totalTokenAmount > 0n) {
+                const sharePerWallet = totalTokenAmount / BigInt(wallets.length);
+                let allocated = 0n;
+                estimatedTokenAmounts = wallets.map((_, i) => {
+                    if (i === wallets.length - 1) {
+                        return totalTokenAmount - allocated;
+                    }
+                    allocated += sharePerWallet;
+                    return sharePerWallet;
+                });
+            }
+        }
+        catch {
+            // V2/V3 quote failed
+        }
+    }
+    const [nonces, feeData] = await Promise.all([batchGetNonces(allAddresses, provider), provider.getFeeData()]);
+    // ========================================
+    // 同步签署授权
+    // ========================================
+    const authorizations = signAuthorizationsWithNonces(allWallets, nonces, delegateAddress, mainWalletIndex);
+    // ========================================
+    // 构建调用
+    // ========================================
+    const calls = [];
+    // ✅ 修复：先执行买卖，最后执行利润转账（与 bundleBuy 调用顺序一致）
+    // 每个钱包执行买入 + 卖出
+    for (let i = 0; i < wallets.length; i++) {
+        const wallet = wallets[i];
+        // 买入调用
+        const buyCall = buildBuyCall(wallet, buyAmountWei, tokenAddress, poolType, actualRouter, fee, delegateInterface, portalInterface);
+        calls.push(buyCall);
+        // 卖出调用（使用预估的代币数量）
+        // ✅ 统一所有模式：当有预估数量时使用精确卖出，确保买卖对等
+        const estimatedAmount = estimatedTokenAmounts[i] || 0n;
+        const sellCall = estimatedAmount > 0n
+            ? buildSellCallWithAmount(wallet, estimatedAmount, tokenAddress, poolType, actualRouter, fee, delegateInterface, portalInterface)
+            : buildSellCall(wallet, 0n, tokenAddress, sellPercent, tokenDecimals, poolType, actualRouter, fee, delegateInterface, portalInterface);
+        calls.push(sellCall);
+    }
+    // ✅ 修复：利润刮取从第一个参与刷量的钱包扣取（卖出后有OKB）
+    // 使用 transferAmount 从钱包余额转账，不需要通过 msg.value
+    if (profitAmount > 0n && wallets.length > 0) {
+        calls.push({
+            target: wallets[0].address, // 从第一个刷量钱包扣利润
+            allowFailure: false,
+            value: 0n,
+            callData: delegateInterface.encodeFunctionData('transferAmount', [profitRecipient, profitAmount]),
+        });
+    }
+    // ========================================
+    // 构建交易
+    // ========================================
+    // ✅ 修复：利润使用 transferAmount 从钱包余额转账，不需要通过 msg.value
+    const totalValue = 0n;
+    // ✅ 使用 mainWallet 的 nonce（mainWallet 是交易发起者和 Gas 支付者）
+    const signedTransaction = buildEIP7702TransactionSync(mainWallet, authorizations, calls, totalValue, nonces[mainWalletIndex], feeData, config);
+    return {
+        signedTransaction,
+        metadata: {
+            walletCount: wallets.length,
+            buyAmountPerWallet,
+            totalBuyAmount: ethers.formatEther(totalBuyAmount),
+            sellPercent,
+            poolType,
+            profitAmount: ethers.formatEther(profitAmount),
+        },
+    };
+}

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

@@ -1,37 +1,9 @@
-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';
-export declare function washVolume(params: WashVolumeParams): Promise<WashVolumeResult>;
 /**
- * 捆绑刷量 - 多钱包批量买入 + 批量卖出
- *
- * 核心逻辑：[利润刮取] + [买入Ops...] + [卖出Ops...]
+ * volume - 主函数
  */
-export declare function bundleVolume(params: BundleVolumeParams): Promise<BundleVolumeResult>;
-/** 生成单轮刷量签名（买入 + 卖出分开，两笔独立交易） */
-export declare function singleRoundVolume(params: {
-    privateKeys: string[];
-    tokenAddress: string;
-    tokenDecimals?: number;
-    buyAmountPerWallet: string;
-    sellPercent?: number;
-    tradeType?: TradeType;
-    routerAddress?: string;
-    fee?: number;
-    config?: EIP7702Config;
-}): Promise<SingleRoundVolumeResult>;
-/** 生成多轮刷量签名（由于 nonce 限制，仅预生成第一轮） */
-export declare function makeVolume(params: MakeVolumeParams): Promise<MakeVolumeSignResult>;
-/** 生成换手刷量签名 */
-export declare function makeVolumeWithSwap(params: {
-    sellerPrivateKey: string;
-    buyerPrivateKey: string;
-    tokenAddress: string;
-    tokenDecimals?: number;
-    sellAmount: string;
-    hopCount?: number;
-    tradeType?: TradeType;
-    routerAddress?: string;
-    fee?: number;
-    config?: EIP7702Config;
-}): Promise<SwapVolumeSignResult>;
+export { washVolume } from './volume-wash.js';
+export { bundleVolume } from './volume-bundle.js';
+export { singleRoundVolume } from './volume-single-round.js';
+export { makeVolume } from './volume-make.js';
+export { makeVolumeWithSwap } from './volume-swap.js';
+export type { VolumeMode, PoolType, VolumeProgress, WashVolumeParams, WashVolumeResult, BundleVolumeParams, BundleVolumeResult, SingleRoundVolumeResult, MakeVolumeParams, MakeVolumeSignResult, SwapVolumeSignResult, } from './volume-helpers.js';