four-flap-meme-sdk 2.2.8 → 2.2.10

package/dist/utils/airdrop-sweep.js

@@ -1,15 +1,34 @@
 import { ethers, JsonRpcProvider } from 'ethers';
-import { GAS_LIMITS, isEniChain } from '../shared/constants/index.js';
-import { buildGasFields } from '../shared/foundation/gas/bundle-gas.js';
-import { getErc20Decimals } from '../bundle-core/internal.js';
-function getTxTypeForChain(chainId) {
-    return isEniChain(chainId) ? 2 : 0;
+import { GAS_LIMITS } from '../shared/constants/index.js';
+async function getErc20Decimals(provider, token) {
+    try {
+        const erc20 = new ethers.Contract(token, ['function decimals() view returns (uint8)'], provider);
+        const d = await erc20.decimals();
+        if (!Number.isFinite(d) || d < 0 || d > 36)
+            return 18;
+        return d;
+    }
+    catch {
+        return 18;
+    }
+}
+/**
+ * 分散（仅签名版本 - 不提交 Bundle）
+ * ✅ 精简版：只负责签名交易，不提交
+ */
+/** ENI Chain ID — EIP-1559 (type 2) */
+const ENI_CHAIN_ID = 173;
+function getTxType(chainId) {
+    return chainId === ENI_CHAIN_ID ? 2 : 0;
+}
+function buildGasFields(txType, gasPrice) {
+    if (txType === 2) {
+        return { type: 2, maxFeePerGas: gasPrice, maxPriorityFeePerGas: gasPrice / 10n || 1n };
+    }
+    return { type: 0, gasPrice };
 }
-// ==========================================
-// 通用：原生/代币 一键分散 & 一键归集（Bundle）
-// ==========================================
 export async function disperseWithBundle(params) {
-    const { rpcUrl, chainId, fromPrivateKey, recipients, amount, amounts, tokenAddress, gasPriceGwei, transferGasLimit = GAS_LIMITS.ERC20_TRANSFER, nativeGasLimit = GAS_LIMITS.BRIBE, } = params;
+    const { rpcUrl, chainId, fromPrivateKey, recipients, amount, amounts, tokenAddress, gasPriceGwei, transferGasLimit = GAS_LIMITS.ERC20_TRANSFER, nativeGasLimit = GAS_LIMITS.BRIBE } = params;
     if (!recipients || recipients.length === 0) {
         return { signedTransactions: [] };
     }
@@ -17,22 +36,22 @@ export async function disperseWithBundle(params) {
     const wallet = new ethers.Wallet(fromPrivateKey, provider);
     const gasPrice = gasPriceGwei && gasPriceGwei.trim().length > 0
         ? ethers.parseUnits(gasPriceGwei, 'gwei')
-        : ((await provider.getFeeData()).gasPrice ?? ethers.parseUnits('1', 'gwei'));
+        : (await provider.getFeeData()).gasPrice ?? ethers.parseUnits('1', 'gwei');
     // 规范化 amounts：优先使用数组；否则将单值扩展为数组
     const useAmountsArray = Array.isArray(amounts) && amounts.length > 0;
     const effAmounts = useAmountsArray
         ? amounts
-        : typeof amount === 'string' && amount.trim().length > 0
+        : (typeof amount === 'string' && amount.trim().length > 0
             ? new Array(recipients.length).fill(amount)
-            : [];
+            : []);
     if (effAmounts.length !== recipients.length) {
         throw new Error('recipients and amounts length mismatch');
     }
-    const isNative = !tokenAddress || tokenAddress.trim().length === 0;
+    let isNative = !tokenAddress || tokenAddress.trim().length === 0;
     const signedTxs = [];
     if (isNative) {
         const baseNonce = await provider.getTransactionCount(wallet.address, 'pending');
-        const txType = getTxTypeForChain(chainId);
+        const txType = getTxType(chainId);
         const signedTxList = await Promise.all(recipients.map(async (to, i) => {
             const amountWei = ethers.parseEther(effAmounts[i]);
             return wallet.signTransaction({
@@ -50,10 +69,10 @@ export async function disperseWithBundle(params) {
         // ✅ 并行获取 decimals 和 nonce
         const [decimals, baseNonce] = await Promise.all([
             getErc20Decimals(provider, tokenAddress),
-            provider.getTransactionCount(wallet.address, 'pending'),
+            provider.getTransactionCount(wallet.address, 'pending')
         ]);
         const iface = new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
-        const txType = getTxTypeForChain(chainId);
+        const txType = getTxType(chainId);
         const signedTxList = await Promise.all(recipients.map(async (to, i) => {
             const amountWei = ethers.parseUnits(effAmounts[i], decimals);
             const data = iface.encodeFunctionData('transfer', [to, amountWei]);
@@ -77,15 +96,15 @@ export async function disperseWithBundle(params) {
  * ✅ 精简版：只负责签名交易，不提交
  */
 export async function sweepWithBundle(params) {
-    const { rpcUrl, chainId, sourcePrivateKeys, target, ratioPct, amount, tokenAddress, gasPriceGwei, transferGasLimit = GAS_LIMITS.ERC20_TRANSFER, nativeGasLimit = GAS_LIMITS.BRIBE, skipIfInsufficient = true, } = params;
+    const { rpcUrl, chainId, sourcePrivateKeys, target, ratioPct, amount, tokenAddress, gasPriceGwei, transferGasLimit = GAS_LIMITS.ERC20_TRANSFER, nativeGasLimit = GAS_LIMITS.BRIBE, skipIfInsufficient = true } = params;
     if (!sourcePrivateKeys || sourcePrivateKeys.length === 0) {
         return { signedTransactions: [] };
     }
     const provider = new JsonRpcProvider(rpcUrl, chainId);
     const gasPrice = gasPriceGwei && gasPriceGwei.trim().length > 0
         ? ethers.parseUnits(gasPriceGwei, 'gwei')
-        : ((await provider.getFeeData()).gasPrice ?? ethers.parseUnits('1', 'gwei'));
-    const isNative = !tokenAddress || tokenAddress.trim().length === 0;
+        : (await provider.getFeeData()).gasPrice ?? ethers.parseUnits('1', 'gwei');
+    let isNative = !tokenAddress || tokenAddress.trim().length === 0;
     const signedTxs = [];
     const clampRatio = (n) => {
         if (typeof n !== 'number' || !Number.isFinite(n))
@@ -99,18 +118,18 @@ export async function sweepWithBundle(params) {
     const ratio = clampRatio(ratioPct);
     if (isNative) {
         // ✅ 并行处理所有源钱包
-        const wallets = sourcePrivateKeys.map((pk) => new ethers.Wallet(pk, provider));
+        const wallets = sourcePrivateKeys.map(pk => new ethers.Wallet(pk, provider));
         const gasCost = nativeGasLimit * gasPrice;
         // 并行获取所有余额和 nonce
         const [balances, nonces] = await Promise.all([
-            Promise.all(wallets.map((w) => provider.getBalance(w.address).catch(() => 0n))),
-            Promise.all(wallets.map((w) => provider.getTransactionCount(w.address, 'pending'))),
+            Promise.all(wallets.map(w => provider.getBalance(w.address).catch(() => 0n))),
+            Promise.all(wallets.map(w => provider.getTransactionCount(w.address, 'pending')))
         ]);
         // 计算每个钱包的发送金额
-        const sendAmounts = balances.map((bal) => {
+        const sendAmounts = balances.map(bal => {
             if (ratio !== undefined) {
                 const want = (bal * BigInt(ratio)) / 100n;
-                const maxSendable = bal > gasCost ? bal - gasCost : 0n;
+                const maxSendable = bal > gasCost ? (bal - gasCost) : 0n;
                 return want > maxSendable ? maxSendable : want;
             }
             else if (amount && amount.trim().length > 0) {
@@ -121,9 +140,9 @@ export async function sweepWithBundle(params) {
             }
             return 0n;
         });
-        const txType = getTxTypeForChain(chainId);
-        const validIndices = sendAmounts.map((amt, i) => (amt > 0n ? i : -1)).filter((i) => i >= 0);
-        const signedTxList = await Promise.all(validIndices.map((i) => wallets[i].signTransaction({
+        const txType = getTxType(chainId);
+        const validIndices = sendAmounts.map((amt, i) => amt > 0n ? i : -1).filter(i => i >= 0);
+        const signedTxList = await Promise.all(validIndices.map(i => wallets[i].signTransaction({
             to: target,
             value: sendAmounts[i],
             nonce: nonces[i],
@@ -134,11 +153,8 @@ export async function sweepWithBundle(params) {
         signedTxs.push(...signedTxList);
     }
     else {
-        const wallets = sourcePrivateKeys.map((pk) => new ethers.Wallet(pk, provider));
-        const iface = new ethers.Interface([
-            'function balanceOf(address) view returns (uint256)',
-            'function transfer(address,uint256) returns (bool)',
-        ]);
+        const wallets = sourcePrivateKeys.map(pk => new ethers.Wallet(pk, provider));
+        const iface = new ethers.Interface(['function balanceOf(address) view returns (uint256)', 'function transfer(address,uint256) returns (bool)']);
         // ✅ 并行获取 decimals、所有代币余额和 nonce
         const [decimals, balanceResults, nonces] = await Promise.all([
             getErc20Decimals(provider, tokenAddress),
@@ -146,18 +162,17 @@ export async function sweepWithBundle(params) {
                 try {
                     const balData = iface.encodeFunctionData('balanceOf', [w.address]);
                     const balRaw = await provider.call({ to: tokenAddress, data: balData });
-                    const decoded = iface.decodeFunctionResult('balanceOf', balRaw);
-                    const bal = decoded[0];
+                    const [bal] = iface.decodeFunctionResult('balanceOf', balRaw);
                     return bal;
                 }
                 catch {
                     return 0n;
                 }
             })),
-            Promise.all(wallets.map((w) => provider.getTransactionCount(w.address, 'pending'))),
+            Promise.all(wallets.map(w => provider.getTransactionCount(w.address, 'pending')))
         ]);
         // 计算每个钱包的发送金额
-        const sendAmounts = balanceResults.map((bal) => {
+        const sendAmounts = balanceResults.map(bal => {
             if (ratio !== undefined) {
                 return (bal * BigInt(ratio)) / 100n;
             }
@@ -169,17 +184,15 @@ export async function sweepWithBundle(params) {
             return 0n;
         });
         // 过滤余额不足的钱包
-        const validIndices = sendAmounts
-            .map((amt, i) => {
+        const validIndices = sendAmounts.map((amt, i) => {
             if (amt <= 0n)
                 return -1;
             if (skipIfInsufficient && balanceResults[i] < amt)
                 return -1;
             return i;
-        })
-            .filter((i) => i >= 0);
-        const txType = getTxTypeForChain(chainId);
-        const signedTxList = await Promise.all(validIndices.map((i) => {
+        }).filter(i => i >= 0);
+        const txType = getTxType(chainId);
+        const signedTxList = await Promise.all(validIndices.map(i => {
             const data = iface.encodeFunctionData('transfer', [target, sendAmounts[i]]);
             return wallets[i].signTransaction({
                 to: tokenAddress,

package/dist/utils/bundle-helpers.d.ts

@@ -1,10 +1,244 @@
 /**
- * Bundle 交易辅助工具 — 实现已迁至 shared/foundation/
- * 本文件保留 re-export，兼容现有 import 路径。
- */
-export { NonceManager } from '../shared/foundation/nonce/nonce-manager.js';
-export { type GasPriceConfig, type GasEstimateConfig, type BuildTransactionOptions, type CommonBundleConfig, getOptimizedGasPrice, estimateGasWithSafety, estimateGasBatch, buildTransaction, getGasLimit, getGasPriceConfig, getTxType, buildGasFields, } from '../shared/foundation/gas/bundle-gas.js';
-export { type ProfitHopConfig, type ProfitHopResult, PROFIT_HOP_COUNT, buildProfitHopTransactions, } from '../shared/foundation/gas/profit-hop.js';
-export { getChainId, signTransactionsBatch, signTransactionsBatchMultiWallet, validateSignedTransactions, } from '../shared/foundation/tx/sign-batch.js';
-export { getDeadline, encodeV3Path, decodeV3Path } from '../shared/foundation/dex/v3-path.js';
-import '../shared/foundation/tx/wallet-sign-patch.js';
+ * Bundle 交易辅助工具
+ * 提供可复用的 nonce 管理、gas 估算等功能
+ */
+import { JsonRpcProvider, Wallet } from 'ethers';
+import { type GeneratedWallet } from './wallet.js';
+/**
+ * Nonce 管理器
+ * 用于在 bundle 交易中管理多个钱包的 nonce
+ *
+ * 策略：
+ * 1. 每次获取 nonce 时查询链上状态（使用 'pending' 包含待处理交易）
+ * 2. 仅在同一批次内维护临时递增缓存
+ * 3. 不持久化缓存，避免因失败交易导致 nonce 过高
+ */
+export declare class NonceManager {
+    private provider;
+    private tempNonceCache;
+    private chainIdPromise?;
+    constructor(provider: JsonRpcProvider);
+    private getChainId;
+    /**
+     * 获取下一个可用的 nonce
+     * @param wallet 钱包对象或地址
+     * @returns 下一个 nonce
+     */
+    getNextNonce(wallet: Wallet | string): Promise<number>;
+    /**
+     * 批量获取连续 nonce（推荐用于同一地址的批量交易）
+     * @param wallet 钱包对象或地址
+     * @param count 需要的 nonce 数量
+     * @returns nonce 数组
+     */
+    getNextNonceBatch(wallet: Wallet | string, count: number): Promise<number[]>;
+    /**
+     * 清空临时缓存（建议在每次 bundle 提交后调用）
+     */
+    clearTemp(): void;
+    /**
+     * 获取当前临时缓存的 nonce（调试用）
+     */
+    getTempCachedNonce(address: string): number | undefined;
+    /**
+     * ✅ 批量获取多个不同地址的 nonce（真正的单次 JSON-RPC 批量请求）
+     * 使用 provider.send 发送批量请求，N 个地址只需 1 次网络往返
+     * @param wallets 钱包数组
+     * @returns nonce 数组（顺序与 wallets 对应）
+     */
+    getNextNoncesForWallets(wallets: (Wallet | string)[]): Promise<number[]>;
+}
+/**
+ * Gas 价格配置
+ */
+export interface GasPriceConfig {
+    /** 基础 gas price（如果不提供则从链上获取） */
+    baseGasPrice?: bigint;
+    /** Gas price 增幅百分比（默认 50，即提高 50%） */
+    multiplierPercent?: number;
+    /** 最小 gas price */
+    minGasPrice?: bigint;
+    /** 最大 gas price */
+    maxGasPrice?: bigint;
+}
+/**
+ * 获取优化后的 Gas Price
+ * @param provider Provider 实例
+ * @param config Gas 配置
+ * @returns Gas price
+ */
+export declare function getOptimizedGasPrice(provider: JsonRpcProvider, config?: GasPriceConfig): Promise<bigint>;
+/**
+ * Gas 估算配置
+ */
+export interface GasEstimateConfig {
+    /** Gas limit 安全余量倍数（默认 1.2 = 20%） */
+    multiplier?: number;
+    /** 失败时的默认 gas limit */
+    fallbackGasLimit?: bigint;
+    /** 是否允许估算失败 */
+    allowFailure?: boolean;
+}
+/**
+ * 估算 gas 并应用安全余量
+ * @param provider Provider 实例
+ * @param txRequest 交易请求
+ * @param config Gas 估算配置
+ * @returns Gas limit
+ */
+export declare function estimateGasWithSafety(provider: JsonRpcProvider, txRequest: any, config?: GasEstimateConfig): Promise<bigint>;
+/**
+ * 批量估算 gas（并行）
+ * @param provider Provider 实例
+ * @param txRequests 交易请求数组
+ * @param config Gas 估算配置
+ * @returns Gas limit 数组
+ */
+export declare function estimateGasBatch(provider: JsonRpcProvider, txRequests: any[], config?: GasEstimateConfig): Promise<bigint[]>;
+/**
+ * 构建交易对象
+ */
+export interface BuildTransactionOptions {
+    from: string;
+    to?: string;
+    data?: string;
+    value?: bigint;
+    nonce: number;
+    gasPrice: bigint;
+    gasLimit: bigint;
+    chainId: number;
+    type?: 0 | 2;
+}
+/**
+ * 构建标准交易对象
+ * @param options 交易选项
+ * @returns 交易对象
+ */
+export declare function buildTransaction(options: BuildTransactionOptions): any;
+/**
+ * 通用配置接口（用于提取公共配置字段）
+ */
+export interface CommonBundleConfig {
+    gasLimit?: number;
+    gasLimitMultiplier?: number;
+    minGasPriceGwei?: number;
+    maxGasPriceGwei?: number;
+    txType?: 0 | 2;
+    chainId?: number;
+}
+/**
+ * 获取 Gas Limit
+ * 优先使用 config.gasLimit，否则使用默认值 * multiplier
+ */
+export declare function getGasLimit(config: CommonBundleConfig, defaultGas?: number): bigint;
+/**
+ * 获取 Gas Price 配置（转换为 GasPriceConfig）
+ */
+export declare function getGasPriceConfig(config: CommonBundleConfig): GasPriceConfig;
+/**
+ * 获取交易类型
+ */
+export declare function getTxType(config: CommonBundleConfig): 0 | 2;
+/**
+ * 根据交易类型构建 gas 字段
+ * type 0 (Legacy): 使用 gasPrice
+ * type 2 (EIP-1559): 使用 maxFeePerGas + maxPriorityFeePerGas
+ *
+ * BaseWallet.signTransaction -> Transaction.from() 不会自动转换
+ * gasPrice 到 maxFeePerGas，必须显式传入正确字段
+ */
+export declare function buildGasFields(txType: number, gasPrice: bigint): Record<string, unknown>;
+/**
+ * 获取链 ID（从 provider 或 config）
+ */
+export declare function getChainId(provider: JsonRpcProvider, configChainId?: number): Promise<number>;
+/**
+ * 并行签名多个交易
+ * @param wallet 钱包
+ * @param transactions 交易数组
+ * @returns 已签名的交易数组
+ */
+export declare function signTransactionsBatch(wallet: Wallet, transactions: any[]): Promise<string[]>;
+/**
+ * 批量签名（支持多个钱包）
+ * @param wallets 钱包数组
+ * @param transactions 交易数组（必须与钱包一一对应）
+ * @returns 已签名的交易数组
+ */
+export declare function signTransactionsBatchMultiWallet(wallets: Wallet[], transactions: any[]): Promise<string[]>;
+/**
+ * 验证已签名交易的格式
+ * @param signedTxs 已签名的交易数组
+ * @returns 是否全部有效
+ */
+export declare function validateSignedTransactions(signedTxs: string[]): boolean;
+/**
+ * 获取交易 deadline（Unix 时间戳秒）
+ * @param minutes 有效分钟数，默认 20
+ * @returns Unix 时间戳（秒）
+ */
+export declare function getDeadline(minutes?: number): number;
+/**
+ * 编码 V3 多跳 path
+ * 格式：token0 (20 bytes) + fee (3 bytes) + token1 (20 bytes) + fee (3 bytes) + token2 (20 bytes) ...
+ *
+ * @param tokens 代币地址数组 [tokenIn, tokenMid1, tokenMid2, ..., tokenOut]
+ * @param fees 费率数组 [fee0, fee1, ...] - 长度应该是 tokens.length - 1
+ * @returns 编码后的 path（hex string）
+ *
+ * @example
+ * // WBNB → USDT(500) → TOKEN(2500)
+ * encodeV3Path(['0xWBNB...', '0xUSDT...', '0xTOKEN...'], [500, 2500])
+ */
+export declare function encodeV3Path(tokens: string[], fees: number[]): string;
+/**
+ * 解码 V3 path 为代币和费率数组
+ * @param path 编码后的 path
+ * @returns { tokens, fees }
+ */
+export declare function decodeV3Path(path: string): {
+    tokens: string[];
+    fees: number[];
+};
+/**
+ * 利润多跳转账配置
+ */
+export interface ProfitHopConfig {
+    provider: JsonRpcProvider;
+    payerWallet: Wallet;
+    profitAmount: bigint;
+    profitRecipient: string;
+    hopCount?: number;
+    gasPrice: bigint;
+    chainId: number;
+    txType: number;
+    startNonce?: number;
+}
+/**
+ * 利润多跳结果
+ */
+export interface ProfitHopResult {
+    signedTransactions: string[];
+    hopWallets: GeneratedWallet[];
+    totalNonceUsed: number;
+}
+/**
+ * 强制 2 跳的利润转账常量
+ */
+export declare const PROFIT_HOP_COUNT = 2;
+/**
+ * 生成利润转账交易
+ *
+ * BSC 链：使用多跳转账
+ * 流程（2 跳）：
+ * 1. 支付者 → 中转1（gas + 利润 + 中转1的gas）
+ * 2. 中转1 → 中转2（gas + 利润）
+ * 3. 中转2 → 利润地址（利润）
+ *
+ * 其他链：直接转账到收益地址
+ * 流程：支付者 → 利润地址
+ *
+ * @param config 配置参数
+ * @returns 签名交易和中转钱包私钥
+ */
+export declare function buildProfitHopTransactions(config: ProfitHopConfig): Promise<ProfitHopResult>;