four-flap-meme-sdk 3.0.0 → 4.0.0

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

@@ -1,486 +1,21 @@
 /**
- * EIP-7702 XLayer 工具函数
- */
-import { ethers, Wallet } from 'ethers';
-import { createXLayerProvider } from '../../../utils/provider-factory.js';
-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 '../../../core/constants/index.js';
-// ========================================
-// 字节转换工具
-// ========================================
-export function bigintToBytes(value) {
-    if (value === 0n)
-        return new Uint8Array(0);
-    let hex = value.toString(16);
-    if (hex.length % 2 !== 0)
-        hex = '0' + hex;
-    const bytes = new Uint8Array(hex.length / 2);
-    for (let i = 0; i < bytes.length; i++) {
-        bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
-    }
-    return bytes;
-}
-export function addressToBytes(address) {
-    return ethers.getBytes(address);
-}
-export function hexToBytes(hex) {
-    if (hex === '0x' || hex === '')
-        return new Uint8Array(0);
-    return ethers.getBytes(hex);
-}
-export function trimLeadingZeros(bytes) {
-    let start = 0;
-    while (start < bytes.length - 1 && bytes[start] === 0) {
-        start++;
-    }
-    return bytes.slice(start);
-}
-// ========================================
-// Provider 缓存
-// ========================================
-const providerCache = new Map();
-export function getCachedProvider(rpcUrl = XLAYER_RPC_URL) {
-    let provider = providerCache.get(rpcUrl);
-    if (!provider) {
-        provider = createXLayerProvider(rpcUrl);
-        providerCache.set(rpcUrl, provider);
-    }
-    return provider;
-}
-export function clearProviderCache() {
-    providerCache.clear();
-}
-/**
- * 分析 callData 推断操作类型
- */
-function inferOperationType(callData) {
-    if (!callData || callData === '0x')
-        return 'transfer';
-    // 根据函数签名推断操作类型
-    const selector = callData.slice(0, 10).toLowerCase();
-    // 常见的函数选择器
-    const selectors = {
-        // 转账
-        '0xa9059cbb': 'transfer', // transfer(address,uint256)
-        // 买入相关
-        '0x7ff36ab5': 'buy', // swapExactETHForTokens
-        '0xb6f9de95': 'buy', // swapExactETHForTokensSupportingFeeOnTransferTokens
-        '0x414bf389': 'buy', // exactInputSingle (V3)
-        '0xc04b8d59': 'buy', // exactInput (V3)
-        // 卖出相关
-        '0x18cbafe5': 'sell', // swapExactTokensForETH
-        '0x791ac947': 'sell', // swapExactTokensForETHSupportingFeeOnTransferTokens
-        '0xdb3e2198': 'sell', // exactOutputSingle (V3)
-        // 授权
-        '0x095ea7b3': 'approve', // approve(address,uint256)
-        // 创建代币
-        '0x': 'create', // 需要更精确的匹配
-    };
-    // UnifiedDelegate 函数选择器（计算得到的 4 字节选择器）
-    const delegateSelectors = {
-        '0x3edd1128': 'transfer', // transferTo(address)
-        '0x2ada9a96': 'transfer', // transferAmount(address,uint256)
-        '0x2cdaa6d3': 'buy', // executeBuy(address,address,address,uint24,uint256)
-        '0x2e87f7de': 'buy', // executeBuyV2(address,address[],uint256)
-        '0x6fcda3a1': 'sell', // executeSell(address,address,address,uint24,uint256)
-        '0x0a3e9e95': 'sell', // executeSellV2(address,address[],uint256)
-        '0x72c18b75': 'sell', // executeSellAndTransfer(address,address,address,uint24,uint256,address)
-        '0x9db6b375': 'sell', // executeSellAndTransferV2(address,address[],uint256,address)
-    };
-    // 先检查标准选择器
-    if (selectors[selector]) {
-        return selectors[selector];
-    }
-    // 检查 UnifiedDelegate 选择器
-    if (delegateSelectors[selector]) {
-        return delegateSelectors[selector];
-    }
-    // 检查 callData 长度和模式
-    if (callData.length < 20) {
-        return 'transfer';
-    }
-    // 默认根据 callData 长度估算
-    if (callData.length > 500) {
-        return 'swap'; // 复杂调用可能是 swap
-    }
-    return 'unknown';
-}
-/**
- * 根据操作类型获取额外 gas
- */
-function getExtraGasForOperation(opType) {
-    switch (opType) {
-        case 'transfer':
-            return GAS_ESTIMATE.TRANSFER;
-        case 'buy':
-            return GAS_ESTIMATE.BUY_EXTRA;
-        case 'sell':
-            return GAS_ESTIMATE.SELL_EXTRA;
-        case 'swap':
-            return GAS_ESTIMATE.BUY_EXTRA + GAS_ESTIMATE.SELL_EXTRA;
-        case 'approve':
-            return 50000n;
-        case 'create':
-            return GAS_ESTIMATE.CREATE_TOKEN;
-        default:
-            return GAS_ESTIMATE.PER_CALL_BASE;
-    }
-}
-/**
- * 动态估算 Gas Limit
+ * EIP-7702 XLayer 工具函数（barrel re-export）
  *
- * @param authorizationCount 授权数量
- * @param calls Multicall 调用列表
- * @param configGasLimit 配置的 gas limit（可选，优先使用）
- * @returns 估算的 gas limit
- */
-export function estimateGasLimit(authorizationCount, calls, configGasLimit) {
-    // 如果明确指定了 gasLimit，优先使用
-    if (configGasLimit && configGasLimit > 0n) {
-        return configGasLimit;
-    }
-    // 基础 gas
-    let estimated = GAS_ESTIMATE.BASE;
-    // 授权 gas
-    estimated += BigInt(authorizationCount) * GAS_ESTIMATE.PER_AUTHORIZATION;
-    // 每个调用的 gas
-    for (const call of calls) {
-        // 基础调用 gas
-        estimated += GAS_ESTIMATE.PER_CALL_BASE;
-        // 根据操作类型添加额外 gas
-        const opType = inferOperationType(call.callData);
-        estimated += getExtraGasForOperation(opType);
-    }
-    // 应用安全系数
-    const withSafety = BigInt(Math.ceil(Number(estimated) * GAS_ESTIMATE.SAFETY_MULTIPLIER));
-    // 限制在最小和最大值之间
-    if (withSafety < GAS_ESTIMATE.MIN) {
-        return GAS_ESTIMATE.MIN;
-    }
-    if (withSafety > GAS_ESTIMATE.MAX) {
-        return GAS_ESTIMATE.MAX;
-    }
-    return withSafety;
-}
-/**
- * 简化版 gas 估算（仅根据调用数量）
- * 适用于无法分析 callData 的场景
- */
-export function estimateGasLimitSimple(authorizationCount, callCount, operationType = 'simple', configGasLimit) {
-    if (configGasLimit && configGasLimit > 0n) {
-        return configGasLimit;
-    }
-    // 毕业操作需要固定的高 gas（约 800 万）
-    if (operationType === 'graduate') {
-        return GAS_ESTIMATE.GRADUATE;
-    }
-    let estimated = GAS_ESTIMATE.BASE;
-    estimated += BigInt(authorizationCount) * GAS_ESTIMATE.PER_AUTHORIZATION;
-    estimated += BigInt(callCount) * GAS_ESTIMATE.PER_CALL_BASE;
-    // 根据操作类型添加额外 gas
-    switch (operationType) {
-        case 'buy':
-            estimated += BigInt(callCount) * GAS_ESTIMATE.BUY_EXTRA;
-            break;
-        case 'sell':
-            estimated += BigInt(callCount) * GAS_ESTIMATE.SELL_EXTRA;
-            break;
-        case 'swap':
-            estimated += BigInt(callCount) * (GAS_ESTIMATE.BUY_EXTRA + GAS_ESTIMATE.SELL_EXTRA);
-            break;
-        case 'create':
-            estimated += GAS_ESTIMATE.CREATE_TOKEN;
-            break;
-        default:
-            estimated += BigInt(callCount) * GAS_ESTIMATE.TRANSFER;
-    }
-    const withSafety = BigInt(Math.ceil(Number(estimated) * GAS_ESTIMATE.SAFETY_MULTIPLIER));
-    if (withSafety < GAS_ESTIMATE.MIN)
-        return GAS_ESTIMATE.MIN;
-    if (withSafety > GAS_ESTIMATE.MAX)
-        return GAS_ESTIMATE.MAX;
-    return withSafety;
-}
-// ========================================
-// 钱包工具
-// ========================================
-export function createWallet(privateKey, provider) {
-    return new Wallet(privateKey, provider);
-}
-export function generateRandomWallet() {
-    const wallet = Wallet.createRandom();
-    return {
-        address: wallet.address,
-        privateKey: wallet.privateKey,
-    };
-}
-export function generateRandomWallets(count) {
-    return Array.from({ length: count }, () => generateRandomWallet());
-}
-// ========================================
-// EIP-7702 授权签名
-// ========================================
-export async function signAuthorization(wallet, delegateAddress, nonce, chainId = XLAYER_CHAIN_ID) {
-    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;
-    toSign.set(rlpEncoded, 1);
-    const msgHash = ethers.keccak256(toSign);
-    const signingKey = new ethers.SigningKey(wallet.privateKey);
-    const sig = signingKey.sign(msgHash);
-    return {
-        chainId: BigInt(chainId),
-        address: delegateAddress,
-        nonce: nonce,
-        yParity: sig.yParity,
-        r: ethers.getBytes(sig.r),
-        s: ethers.getBytes(sig.s),
-    };
-}
-export async function signAuthorizationWithNonce(wallet, delegateAddress, provider, isTransactionSender = false) {
-    let nonce = await provider.getTransactionCount(wallet.address, 'pending');
-    if (isTransactionSender) {
-        nonce += 1;
-    }
-    return signAuthorization(wallet, delegateAddress, BigInt(nonce));
-}
-/**
- * 批量签署授权 - 并行获取 nonce，并行签名
- */
-export async function signAuthorizationsBatch(wallets, delegateAddress, provider, mainWalletIndex) {
-    // 并行获取所有钱包的 nonce
-    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;
-        const nonce = isMainWallet ? nonces[i] + 1 : nonces[i];
-        return signAuthorization(wallet, delegateAddress, BigInt(nonce));
-    }));
-}
-/**
- * 批量签署授权（带预取 nonce）- 用于与其他操作并行
- */
-export function signAuthorizationsWithNonces(wallets, nonces, delegateAddress, mainWalletIndex) {
-    return wallets.map((wallet, i) => {
-        const isMainWallet = mainWalletIndex !== undefined && i === mainWalletIndex;
-        const nonce = isMainWallet ? nonces[i] + 1 : nonces[i];
-        // signAuthorization 内部实际是同步的，直接调用
-        const authData = [
-            bigintToBytes(BigInt(XLAYER_CHAIN_ID)),
-            addressToBytes(delegateAddress),
-            bigintToBytes(BigInt(nonce)),
-        ];
-        const rlpEncoded = rlp.encode(authData);
-        const toSign = new Uint8Array(1 + rlpEncoded.length);
-        toSign[0] = EIP7702_AUTH_PREFIX;
-        toSign.set(rlpEncoded, 1);
-        const msgHash = ethers.keccak256(toSign);
-        const signingKey = new ethers.SigningKey(wallet.privateKey);
-        const sig = signingKey.sign(msgHash);
-        return {
-            chainId: BigInt(XLAYER_CHAIN_ID),
-            address: delegateAddress,
-            nonce: BigInt(nonce),
-            yParity: sig.yParity,
-            r: ethers.getBytes(sig.r),
-            s: ethers.getBytes(sig.s),
-        };
-    });
-}
-/**
- * 批量获取多个地址的 nonce - 并行
- */
-export async function batchGetNonces(addresses, provider) {
-    return Promise.all(addresses.map((addr) => provider.getTransactionCount(addr, 'pending')));
-}
-// ========================================
-// EIP-7702 交易构建
-// ========================================
-export async function buildEIP7702Transaction(mainWallet, authorizations, calls, totalValue, config) {
-    const provider = getCachedProvider(config?.rpcUrl);
-    const chainId = config?.chainId ?? XLAYER_CHAIN_ID;
-    // ✅ 动态 Gas 估算：根据授权数量和调用复杂度自动计算
-    const gasLimit = estimateGasLimit(authorizations.length, calls, config?.gasLimit);
-    // ✅ 并行获取 nonce 和 fee data
-    const [nonce, feeData] = await Promise.all([
-        provider.getTransactionCount(mainWallet.address, 'pending'),
-        provider.getFeeData(),
-    ]);
-    const maxPriorityFeePerGas = feeData.maxPriorityFeePerGas || ethers.parseUnits('1', 'gwei');
-    const maxFeePerGas = feeData.maxFeePerGas || ethers.parseUnits('50', 'gwei');
-    const multicall3 = new ethers.Interface(MULTICALL3_ABI);
-    const callData = multicall3.encodeFunctionData('aggregate3Value', [
-        calls.map((c) => ({
-            target: c.target,
-            allowFailure: c.allowFailure,
-            value: c.value,
-            callData: c.callData,
-        })),
-    ]);
-    const authList = authorizations.map((auth) => [
-        bigintToBytes(auth.chainId),
-        addressToBytes(auth.address),
-        bigintToBytes(auth.nonce),
-        bigintToBytes(BigInt(auth.yParity)),
-        trimLeadingZeros(auth.r),
-        trimLeadingZeros(auth.s),
-    ]);
-    const txData = [
-        bigintToBytes(BigInt(chainId)),
-        bigintToBytes(BigInt(nonce)),
-        bigintToBytes(maxPriorityFeePerGas),
-        bigintToBytes(maxFeePerGas),
-        bigintToBytes(gasLimit),
-        addressToBytes(MULTICALL3_ADDRESS),
-        bigintToBytes(totalValue),
-        hexToBytes(callData),
-        [],
-        authList,
-    ];
-    const rlpEncoded = rlp.encode(txData);
-    const toSign = new Uint8Array(1 + rlpEncoded.length);
-    toSign[0] = EIP7702_TX_TYPE;
-    toSign.set(rlpEncoded, 1);
-    const txHash = ethers.keccak256(toSign);
-    const signingKey = new ethers.SigningKey(mainWallet.privateKey);
-    const sig = signingKey.sign(txHash);
-    // ✅ 交易签名的 r/s 也需要去除前导零，符合 RLP 规范
-    const signedTxData = [
-        ...txData,
-        bigintToBytes(BigInt(sig.yParity)),
-        trimLeadingZeros(ethers.getBytes(sig.r)),
-        trimLeadingZeros(ethers.getBytes(sig.s)),
-    ];
-    const signedRlp = rlp.encode(signedTxData);
-    const signedTx = new Uint8Array(1 + signedRlp.length);
-    signedTx[0] = EIP7702_TX_TYPE;
-    signedTx.set(signedRlp, 1);
-    return ethers.hexlify(signedTx);
-}
-/**
- * 构建 EIP-7702 交易（带预取数据）- 用于已并行获取 nonce/feeData 的场景
- */
-export function buildEIP7702TransactionSync(mainWallet, authorizations, calls, totalValue, nonce, feeData, config) {
-    const chainId = config?.chainId ?? XLAYER_CHAIN_ID;
-    // ✅ 动态 Gas 估算：根据授权数量和调用复杂度自动计算
-    const gasLimit = estimateGasLimit(authorizations.length, calls, config?.gasLimit);
-    const maxPriorityFeePerGas = feeData.maxPriorityFeePerGas || ethers.parseUnits('1', 'gwei');
-    const maxFeePerGas = feeData.maxFeePerGas || ethers.parseUnits('50', 'gwei');
-    const multicall3 = new ethers.Interface(MULTICALL3_ABI);
-    const callData = multicall3.encodeFunctionData('aggregate3Value', [
-        calls.map((c) => ({
-            target: c.target,
-            allowFailure: c.allowFailure,
-            value: c.value,
-            callData: c.callData,
-        })),
-    ]);
-    const authList = authorizations.map((auth) => [
-        bigintToBytes(auth.chainId),
-        addressToBytes(auth.address),
-        bigintToBytes(auth.nonce),
-        bigintToBytes(BigInt(auth.yParity)),
-        trimLeadingZeros(auth.r),
-        trimLeadingZeros(auth.s),
-    ]);
-    const txData = [
-        bigintToBytes(BigInt(chainId)),
-        bigintToBytes(BigInt(nonce)),
-        bigintToBytes(maxPriorityFeePerGas),
-        bigintToBytes(maxFeePerGas),
-        bigintToBytes(gasLimit),
-        addressToBytes(MULTICALL3_ADDRESS),
-        bigintToBytes(totalValue),
-        hexToBytes(callData),
-        [],
-        authList,
-    ];
-    const rlpEncoded = rlp.encode(txData);
-    const toSign = new Uint8Array(1 + rlpEncoded.length);
-    toSign[0] = EIP7702_TX_TYPE;
-    toSign.set(rlpEncoded, 1);
-    const txHash = ethers.keccak256(toSign);
-    const signingKey = new ethers.SigningKey(mainWallet.privateKey);
-    const sig = signingKey.sign(txHash);
-    // ✅ 交易签名的 r/s 也需要去除前导零，符合 RLP 规范
-    const signedTxData = [
-        ...txData,
-        bigintToBytes(BigInt(sig.yParity)),
-        trimLeadingZeros(ethers.getBytes(sig.r)),
-        trimLeadingZeros(ethers.getBytes(sig.s)),
-    ];
-    const signedRlp = rlp.encode(signedTxData);
-    const signedTx = new Uint8Array(1 + signedRlp.length);
-    signedTx[0] = EIP7702_TX_TYPE;
-    signedTx.set(signedRlp, 1);
-    return ethers.hexlify(signedTx);
-}
-/**
- * 根据用户类型获取利润率（单边模式）
- * - v0: 8 bps = 0.08%
- * - v1: 10 bps = 0.10%
- * - default: 8 bps = 0.08%
- */
-export function getProfitRateBps(userType) {
-    if (userType === 'v0')
-        return getSharedProfitRateBps('v0Single');
-    if (userType === 'v1')
-        return getSharedProfitRateBps('v1Single');
-    return getSharedProfitRateBps('v0Single');
-}
-/**
- * 根据用户类型获取利润率（双边/换手模式）
- */
-export function getProfitRateBpsDouble(userType) {
-    if (userType === 'v0')
-        return getSharedProfitRateBps('v0Double');
-    if (userType === 'v1')
-        return getSharedProfitRateBps('v1Double');
-    return getSharedProfitRateBps('v0Double');
-}
-/**
- * 计算利润金额（旧版兼容）
- */
-export function calculateProfitAmount(totalFlowWei, isSwapMode = false) {
-    const rateBps = getSharedProfitRateBps(isSwapMode ? 'bundleSwap' : 'normal');
-    return (totalFlowWei * BigInt(rateBps)) / 10000n;
-}
-/**
- * 计算利润金额（基于用户类型）
- * @param totalFlowWei 总资金流水
- * @param userType 用户类型
- * @param isDoubleMode 是否双边模式（换手模式）
- */
-export function calculateProfitAmountByUserType(totalFlowWei, userType, isDoubleMode = false) {
-    if (totalFlowWei <= 0n)
-        return 0n;
-    const rateBps = isDoubleMode ? getProfitRateBpsDouble(userType) : getProfitRateBps(userType);
-    return (totalFlowWei * BigInt(rateBps)) / 10000n;
-}
-/**
- * 根据交易数量计算利润金额
- * @param totalFlowWei 总资金流水
- * @param txCount 交易数量
- * @param userType 用户类型
- */
-export function calculateProfitAmountByTxCount(totalFlowWei, txCount, userType) {
-    if (totalFlowWei <= 0n || txCount <= 0)
-        return 0n;
-    const rateBpsPerTx = getProfitRateBps(userType);
-    const totalRateBps = rateBpsPerTx * txCount;
-    return (totalFlowWei * BigInt(totalRateBps)) / 10000n;
-}
-export function getProfitRecipient(config) {
-    return config?.profitRecipient ?? pickRandomProfitRecipient();
-}
-// ========================================
-// 时间工具
-// ========================================
-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));
-}
+ * 本文件为兼容性入口，实现已按职责拆分到子文件：
+ * - bytes.ts: 字节转换工具
+ * - provider.ts: Provider 缓存
+ * - gas.ts: Gas 动态估算
+ * - wallet.ts: 钱包工具
+ * - auth.ts: EIP-7702 授权签名
+ * - tx-build.ts: EIP-7702 交易构建
+ * - profit.ts: 利润计算
+ * - time.ts: 时间工具
+ */
+export * from './bytes.js';
+export * from './provider.js';
+export * from './gas.js';
+export * from './wallet.js';
+export * from './auth.js';
+export * from './tx-build.js';
+export * from './profit.js';
+export * from './time.js';

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

@@ -0,0 +1,13 @@
+/**
+ * EIP-7702 捆绑刷量 (Bundle Mode)
+ *
+ * 多钱包批量买入 + 批量卖出
+ * 只生成签名，由调用方决定如何提交
+ */
+import { type BundleVolumeParams, type BundleVolumeResult } from './volume-helpers.js';
+/**
+ * 捆绑刷量 - 多钱包批量买入 + 批量卖出
+ *
+ * 核心逻辑：[利润刮取] + [买入Ops...] + [卖出Ops...]
+ */
+export declare function bundleVolume(params: BundleVolumeParams): Promise<BundleVolumeResult>;