four-flap-meme-sdk 1.9.49 → 2.0.0

package/dist/utils/airdrop-sweep.d.ts

@@ -1,80 +1,8 @@
-import type { SoulPointSignatureMode, VNormalizationMode } from '../shared/clients/club48.js';
-/** ✅ Bundle 提交结果（完整版 - 包含 bundleUuid） */
-export type BundleSubmitResult = {
-    bundleUuid: string;
-    signedTxs: string[];
-};
-/** ✅ 签名结果（精简版 - 仅返回签名交易） */
-export type SignedTransactionsResult = {
-    signedTransactions: string[];
-};
-/** ✅ 分散参数（完整版 - 包含 Bundle 提交） */
-export type DisperseParams = {
-    rpcUrl: string;
-    chainId: number;
-    fromPrivateKey: string;
-    recipients: string[];
-    amount?: string;
-    amounts?: string[];
-    tokenAddress?: string;
-    bundleEndpoint?: string;
-    gasPriceGwei?: string;
-    transferGasLimit?: bigint;
-    nativeGasLimit?: bigint;
-    blockOffset?: number;
-    spMode?: SoulPointSignatureMode;
-    spPrivateKey?: string;
-    spVMode?: VNormalizationMode;
-};
-/** ✅ 分散参数（精简版 - 仅签名） */
-export type DisperseSignParams = {
-    rpcUrl: string;
-    chainId: number;
-    fromPrivateKey: string;
-    recipients: string[];
-    amount?: string;
-    amounts?: string[];
-    tokenAddress?: string;
-    gasPriceGwei?: string;
-    transferGasLimit?: bigint;
-    nativeGasLimit?: bigint;
-};
-export declare function disperseWithBundle(params: DisperseSignParams): Promise<SignedTransactionsResult>;
-/** ✅ 归集参数（完整版 - 包含 Bundle 提交） */
-export type SweepParams = {
-    rpcUrl: string;
-    chainId: number;
-    sourcePrivateKeys: string[];
-    target: string;
-    ratioPct?: number;
-    amount?: string;
-    tokenAddress?: string;
-    bundleEndpoint?: string;
-    gasPriceGwei?: string;
-    transferGasLimit?: bigint;
-    nativeGasLimit?: bigint;
-    blockOffset?: number;
-    skipIfInsufficient?: boolean;
-    spMode?: SoulPointSignatureMode;
-    spPrivateKey?: string;
-    spVMode?: VNormalizationMode;
-};
-/** ✅ 归集参数（精简版 - 仅签名） */
-export type SweepSignParams = {
-    rpcUrl: string;
-    chainId: number;
-    sourcePrivateKeys: string[];
-    target: string;
-    ratioPct?: number;
-    amount?: string;
-    tokenAddress?: string;
-    gasPriceGwei?: string;
-    transferGasLimit?: bigint;
-    nativeGasLimit?: bigint;
-    skipIfInsufficient?: boolean;
-};
+import type { AirdropDisperseSignParams, SignedTransactionsResult, AirdropSweepSignParams } from './types/airdrop-sweep.js';
+export declare function disperseWithBundle(params: AirdropDisperseSignParams): Promise<SignedTransactionsResult>;
 /**
  * 归集（仅签名版本 - 不提交 Bundle）
  * ✅ 精简版：只负责签名交易，不提交
  */
-export declare function sweepWithBundle(params: SweepSignParams): Promise<SignedTransactionsResult>;
+export declare function sweepWithBundle(params: AirdropSweepSignParams): Promise<SignedTransactionsResult>;
+export type { BundleSubmitResult, SignedTransactionsResult, AirdropDisperseParams, AirdropDisperseSignParams, AirdropSweepParams, AirdropSweepSignParams, DisperseParams, DisperseSignParams, SweepParams, SweepSignParams, } from './types/airdrop-sweep.js';

package/dist/utils/airdrop-sweep.js

@@ -1,34 +1,15 @@
 import { ethers, JsonRpcProvider } from 'ethers';
-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 };
+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;
 }
+// ==========================================
+// 通用：原生/代币 一键分散 & 一键归集（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: [] };
     }
@@ -36,14 +17,14 @@ 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');
     }
@@ -51,7 +32,7 @@ export async function disperseWithBundle(params) {
     const signedTxs = [];
     if (isNative) {
         const baseNonce = await provider.getTransactionCount(wallet.address, 'pending');
-        const txType = getTxType(chainId);
+        const txType = getTxTypeForChain(chainId);
         const signedTxList = await Promise.all(recipients.map(async (to, i) => {
             const amountWei = ethers.parseEther(effAmounts[i]);
             return wallet.signTransaction({
@@ -69,10 +50,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 = getTxType(chainId);
+        const txType = getTxTypeForChain(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]);
@@ -96,14 +77,14 @@ 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');
+        : ((await provider.getFeeData()).gasPrice ?? ethers.parseUnits('1', 'gwei'));
     const isNative = !tokenAddress || tokenAddress.trim().length === 0;
     const signedTxs = [];
     const clampRatio = (n) => {
@@ -118,18 +99,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) {
@@ -140,9 +121,9 @@ export async function sweepWithBundle(params) {
             }
             return 0n;
         });
-        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({
+        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({
             to: target,
             value: sendAmounts[i],
             nonce: nonces[i],
@@ -153,8 +134,11 @@ 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),
@@ -169,10 +153,10 @@ export async function sweepWithBundle(params) {
                     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;
             }
@@ -184,15 +168,17 @@ 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 = getTxType(chainId);
-        const signedTxList = await Promise.all(validIndices.map(i => {
+        })
+            .filter((i) => i >= 0);
+        const txType = getTxTypeForChain(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,244 +1,10 @@
 /**
- * Bundle 交易辅助工具
- * 提供可复用的 nonce 管理、gas 估算等功能
- */
-import { ethers, 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: ethers.TransactionLike, config?: GasEstimateConfig): Promise<bigint>;
-/**
- * 批量估算 gas（并行）
- * @param provider Provider 实例
- * @param txRequests 交易请求数组
- * @param config Gas 估算配置
- * @returns Gas limit 数组
- */
-export declare function estimateGasBatch(provider: JsonRpcProvider, txRequests: ethers.TransactionLike[], 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): ethers.TransactionLike;
-/**
- * 通用配置接口（用于提取公共配置字段）
- */
-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: ethers.TransactionLike[]): Promise<string[]>;
-/**
- * 批量签名（支持多个钱包）
- * @param wallets 钱包数组
- * @param transactions 交易数组（必须与钱包一一对应）
- * @returns 已签名的交易数组
- */
-export declare function signTransactionsBatchMultiWallet(wallets: Wallet[], transactions: ethers.TransactionLike[]): 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>;
+ * 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';