four-flap-meme-sdk 1.9.49 → 2.1.0

package/dist/shared/foundation/types/airdrop-sweep.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 空投分散 / 归集（airdrop-sweep）— 类型定义
+ */
+import type { SoulPointSignatureMode, VNormalizationMode } from '../../clients/club48.js';
+export type BundleSubmitResult = {
+    bundleUuid: string;
+    signedTxs: string[];
+};
+export type SignedTransactionsResult = {
+    signedTransactions: string[];
+};
+export type AirdropDisperseParams = {
+    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 AirdropDisperseSignParams = {
+    rpcUrl: string;
+    chainId: number;
+    fromPrivateKey: string;
+    recipients: string[];
+    amount?: string;
+    amounts?: string[];
+    tokenAddress?: string;
+    gasPriceGwei?: string;
+    transferGasLimit?: bigint;
+    nativeGasLimit?: bigint;
+};
+export type AirdropSweepParams = {
+    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 AirdropSweepSignParams = {
+    rpcUrl: string;
+    chainId: number;
+    sourcePrivateKeys: string[];
+    target: string;
+    ratioPct?: number;
+    amount?: string;
+    tokenAddress?: string;
+    gasPriceGwei?: string;
+    transferGasLimit?: bigint;
+    nativeGasLimit?: bigint;
+    skipIfInsufficient?: boolean;
+};
+/** @deprecated 使用 `AirdropDisperseParams` */
+export type DisperseParams = AirdropDisperseParams;
+/** @deprecated 使用 `AirdropDisperseSignParams` */
+export type DisperseSignParams = AirdropDisperseSignParams;
+/** @deprecated 使用 `AirdropSweepParams` */
+export type SweepParams = AirdropSweepParams;
+/** @deprecated 使用 `AirdropSweepSignParams` */
+export type SweepSignParams = AirdropSweepSignParams;

package/dist/{utils/erc20/types.d.ts → shared/foundation/types/erc20.d.ts}

@@ -1,9 +1,14 @@
-import type { NonceManager } from '../bundle-helpers.js';
+import type { ContractTransactionReceipt } from 'ethers';
+import type { NonceManager } from '../nonce/nonce-manager.js';
 export type EnsureAllowanceResult = {
+    /** 是否已经授权 */
     alreadyApproved: boolean;
+    /** 当前授权额度 */
     currentAllowance: bigint;
+    /** 需要的授权额度 */
     requiredAllowance: bigint;
-    txReceipt?: any;
+    /** 授权交易回执（如果发送了新交易） */
+    txReceipt?: ContractTransactionReceipt | null;
 };
 export type EnsureAllowanceBatchItemResult = EnsureAllowanceResult & {
     owner: string;
@@ -15,15 +20,10 @@ export type ApproveTokenBatchParams = {
     privateKeys: string[];
     tokenAddress: string;
     amounts: (bigint | 'max')[];
-    /** 是否只签名不提交（默认 false，直接发送交易） */
     signOnly?: boolean;
-    /** Gas Price（可选，单位 Gwei，signOnly=true 时生效） */
     gasPriceGwei?: number;
-    /** Gas Limit（可选，默认 100000，signOnly=true 时生效） */
     gasLimit?: number;
-    /** 链ID（可选，默认56=BSC，signOnly=true 时生效） */
     chainId?: number;
-    /** 跳过合约地址验证（可选，用于某些特殊场景） */
     skipValidation?: boolean;
 };
 export type ApproveTokenBatchRawParams = {
@@ -32,17 +32,11 @@ export type ApproveTokenBatchRawParams = {
     tokenAddress: string;
     spenderAddress: string;
     amounts: (bigint | 'max')[];
-    /** 是否只签名不提交（默认 false，直接发送交易） */
     signOnly?: boolean;
-    /** Gas Price（可选，单位 Gwei，signOnly=true 时生效） */
     gasPriceGwei?: number;
-    /** Gas Limit（可选，默认 100000，signOnly=true 时生效） */
     gasLimit?: number;
-    /** 链ID（可选，默认56=BSC，signOnly=true 时生效） */
     chainId?: number;
-    /** 外部 NonceManager（可选，用于同一钱包签多笔交易时共享 nonce 状态） */
     nonceManager?: NonceManager;
-    /** 跳过合约地址验证（可选，用于某些特殊场景，如 RPC 返回异常时） */
     skipValidation?: boolean;
 };
 export type ApproveTokenBatchResult = {
@@ -58,20 +52,14 @@ export type ApproveTokenBatchResult = {
     }>;
 };
 export type ApproveTokenBatchSignResult = {
-    /** 需要授权的签名交易数组（已过滤掉已授权的钱包） */
     signedTransactions: string[];
-    /** 详细结果 */
     results: Array<{
         owner: string;
-        /** 是否已授权（无需发送交易） */
         alreadyApproved: boolean;
         currentAllowance: bigint;
         requiredAllowance: bigint;
-        /** 签名交易（仅当 alreadyApproved=false 时有值） */
         signedTx?: string;
     }>;
-    /** 需要授权的钱包数量 */
     needApproveCount: number;
-    /** 已授权的钱包数量 */
     alreadyApprovedCount: number;
 };

package/dist/{utils/holders-maker/types.d.ts → shared/foundation/types/holders-maker.d.ts}

@@ -1,19 +1,15 @@
 /**
- * 刷持有人（Holders Maker）类型定义
+ * 刷持有人 - 类型定义
  */
-import type { GeneratedWallet } from '../wallet.js';
-/** 链类型 */
+import type { GeneratedWallet } from '../../../utils/wallet.js';
 export type HoldersMakerChain = 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
-/** 交易类型 */
-export type TradeType = 'four' | 'flap' | 'v2' | 'v3' | 'daoaas';
-/** 基础代币类型 */
+export type HoldersMakerTradeType = 'four' | 'flap' | 'v2' | 'v3' | 'daoaas';
 export type BaseTokenType = 'native' | 'usdt' | 'usdc';
-/** 刷持有人配置 */
 export type HoldersMakerConfig = {
     rpcUrl: string;
     chain?: HoldersMakerChain;
     chainId?: number;
-    tradeType?: TradeType;
+    tradeType?: HoldersMakerTradeType;
     gasLimit?: number;
     gasPriceGwei?: number;
     bribeAmount?: number;
@@ -28,7 +24,6 @@ export type HoldersMakerConfig = {
     v3Tokens?: string[];
     v2RouterAddress?: string;
 };
-/** 刷持有人参数 */
 export type HoldersMakerParams = {
     payerPrivateKey: string;
     holdersCount: number;
@@ -39,14 +34,12 @@ export type HoldersMakerParams = {
     baseTokenDecimals?: number;
     config: HoldersMakerConfig;
 };
-/** 交易层级（用于按依赖顺序广播） */
 export type TransactionLayer = {
     name: string;
     startIndex: number;
     endIndex: number;
     count: number;
 };
-/** 批次结果 */
 export type BatchResult = {
     batchIndex: number;
     success: boolean;
@@ -57,7 +50,6 @@ export type BatchResult = {
     transactionLayers?: TransactionLayer[];
     disperseHopCount?: number;
 };
-/** 刷持有人结果 */
 export type HoldersMakerResult = {
     success: boolean;
     newWallets: GeneratedWallet[];

package/dist/shared/foundation/types/index.d.ts

@@ -0,0 +1,7 @@
+export type { Aggregate3CallResult } from './multicall.js';
+export type { EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult, } from './erc20.js';
+export type { HoldersMakerChain, HoldersMakerTradeType, BaseTokenType, HoldersMakerConfig, HoldersMakerParams, TransactionLayer, BatchResult, HoldersMakerResult, } from './holders-maker.js';
+export type { DexConfig, ChainDexConfig, PoolPairInfo, V3PoolInfo, DexPoolInfo, BestPoolInfo, LPPlatform, LPInfo, InspectOptions, } from './lp-inspect.js';
+export type { BundleSubmitResult, SignedTransactionsResult, AirdropDisperseParams, AirdropDisperseSignParams, AirdropSweepParams, AirdropSweepSignParams, DisperseParams, DisperseSignParams, SweepParams, SweepSignParams, } from './airdrop-sweep.js';
+export type { PrivateSaleSignConfig, PrivateSaleTransferParams, BatchPrivateSaleParams, PrivateSaleResult, } from './private-sale.js';
+export type { SupportedChain, QuoteParams, QuoteResult } from './quote-helpers.js';

package/dist/{utils/lp-inspect/types.d.ts → shared/foundation/types/lp-inspect.d.ts}

@@ -1,3 +1,7 @@
+/**
+ * LP 查询 - 类型定义
+ */
+import type { FlapChain } from '../../flap/portal.js';
 export interface DexConfig {
     name: string;
     v2Factory?: string;
@@ -53,7 +57,6 @@ export interface BestPoolInfo {
     poolRatio?: string;
 }
 export type LPPlatform = 'FOUR' | 'FLAP' | 'DAOAAS' | 'PANCAKESWAP_V2' | 'PANCAKESWAP_V3' | 'UNISWAP_V2' | 'UNISWAP_V3' | 'IROSWAP_V2' | 'MULTI_DEX' | 'UNKNOWN';
-/** LP 信息返回类型 */
 export interface LPInfo {
     platform: LPPlatform;
     decimals?: number;
@@ -87,7 +90,6 @@ export interface LPInfo {
     allPools: DexPoolInfo[];
     bestPools: BestPoolInfo[];
 }
-import type { FlapChain } from '../../shared/flap/portal.js';
 export interface InspectOptions {
     chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
     rpcUrl: string;

package/dist/shared/foundation/types/multicall.d.ts

@@ -0,0 +1,5 @@
+/** Multicall3 `aggregate3` 单条返回（与 IERC20 balanceOf / getEthBalance 解码路径一致） */
+export type Aggregate3CallResult = {
+    success: boolean;
+    returnData: string;
+};

package/dist/shared/foundation/types/multicall.js

@@ -0,0 +1 @@
+export {};

package/dist/shared/foundation/types/private-sale.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 私募转账签名 — 类型定义
+ */
+import type { GeneratedWallet } from '../../../utils/wallet.js';
+export interface PrivateSaleSignConfig {
+    rpcUrl: string;
+    chainId?: number;
+    gasLimit?: number;
+    gasPriceGwei?: number;
+    bribeAmount?: number;
+    extractProfit?: boolean;
+    profitBps?: number;
+}
+export interface PrivateSaleTransferParams {
+    senderPrivateKey: string;
+    recipient: string;
+    amount: number;
+}
+export interface BatchPrivateSaleParams {
+    transfers: PrivateSaleTransferParams[];
+    config: PrivateSaleSignConfig;
+}
+export interface PrivateSaleResult {
+    signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata: {
+        totalCount: number;
+        bribeCount: number;
+        transferCount: number;
+        profitCount: number;
+        totalAmountWei: string;
+        totalProfitWei: string;
+        bribeAmountWei: string;
+    };
+}

package/dist/shared/foundation/types/private-sale.js

@@ -0,0 +1 @@
+export {};

package/dist/{utils/quote-helpers/types.d.ts → shared/foundation/types/quote-helpers.d.ts}

@@ -1,4 +1,5 @@
 import type { JsonRpcProvider } from 'ethers';
+export type SupportedChain = 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
 export interface QuoteParams {
     provider: JsonRpcProvider;
     tokenIn: string;

package/dist/shared/foundation/types/quote-helpers.js

@@ -0,0 +1 @@
+export {};

package/dist/shared/four/tax-token.d.ts

@@ -1,4 +1,4 @@
-import TaxTokenAbi from '../abis/TaxToken.json';
+import TaxTokenAbi from '../../abis/contracts/TaxToken.json';
 /** TaxToken 转账模式 */
 export declare enum TransferMode {
     /** 正常转账模式 - 允许所有转账 */

package/dist/shared/four/tax-token.js

@@ -5,7 +5,7 @@
  * 基于 Four.meme 官方文档: API-Contract-TaxToken.md
  */
 import { ethers, Contract, Wallet, JsonRpcProvider } from 'ethers';
-import TaxTokenAbi from '../abis/TaxToken.json' with { type: 'json' };
+import TaxTokenAbi from '../../abis/contracts/TaxToken.json' with { type: 'json' };
 // ============================================================================
 // 常量
 // ============================================================================
@@ -123,11 +123,28 @@ export async function getTaxTokenInfo(tokenAddress, rpcUrl) {
     const token = new Contract(tokenAddress, TAX_TOKEN_READ_ABI, provider);
     // 批量查询所有状态（利用 Promise.all 减少 RPC 调用轮次）
     const [feeRate, rateFounder, rateHolder, rateBurn, rateLiquidity, founder, quote, pair, mode, minDispatch, minShare, totalShares, feePerShare, feeAccumulated, feeDispatched, feeFounderVal, feeHolderVal, feeBurnVal, feeLiquidityVal, quoteFounderVal, quoteHolderVal, quoteClaimed,] = await Promise.all([
-        token.feeRate(), token.rateFounder(), token.rateHolder(), token.rateBurn(), token.rateLiquidity(),
-        token.founder(), token.quote(), token.pair(), token._mode(), token.minDispatch(), token.minShare(),
-        token.totalShares(), token.feePerShare(), token.feeAccumulated(), token.feeDispatched(),
-        token.feeFounder(), token.feeHolder(), token.feeBurn(), token.feeLiquidity(),
-        token.quoteFounder(), token.quoteHolder(), token.quoteClaimed(),
+        token.feeRate(),
+        token.rateFounder(),
+        token.rateHolder(),
+        token.rateBurn(),
+        token.rateLiquidity(),
+        token.founder(),
+        token.quote(),
+        token.pair(),
+        token._mode(),
+        token.minDispatch(),
+        token.minShare(),
+        token.totalShares(),
+        token.feePerShare(),
+        token.feeAccumulated(),
+        token.feeDispatched(),
+        token.feeFounder(),
+        token.feeHolder(),
+        token.feeBurn(),
+        token.feeLiquidity(),
+        token.quoteFounder(),
+        token.quoteHolder(),
+        token.quoteClaimed(),
     ]);
     return {
         config: {
@@ -281,7 +298,10 @@ export function validateFourTokenTaxInfo(info) {
     // 四项比例之和必须为 100
     const rateSum = info.burnRate + info.divideRate + info.liquidityRate + info.recipientRate;
     if (rateSum !== 100) {
-        return { valid: false, error: `burnRate + divideRate + liquidityRate + recipientRate 必须等于 100，当前: ${rateSum}` };
+        return {
+            valid: false,
+            error: `burnRate + divideRate + liquidityRate + recipientRate 必须等于 100，当前: ${rateSum}`,
+        };
     }
     // 每项比例 >= 0
     if (info.burnRate < 0 || info.divideRate < 0 || info.liquidityRate < 0 || info.recipientRate < 0) {

package/dist/shared/index.d.ts

@@ -7,4 +7,10 @@
  * - four: Four.meme 工具（TaxToken 等）
  */
 export * from './constants/index.js';
+/** 错误规范化、可选 Logger（与根 `index` 导出同源） */
+export * as foundation from './foundation/index.js';
+/** HTTP / Bundle / BlockRazor 等（亦支持子路径 `four-flap-meme-sdk/clients`） */
+export * as clients from './clients/index.js';
 export * as FourUtils from './four/index.js';
+/** Flap 链标识（与 `./constants` 同源） */
+export type { FlapChain } from './flap/portal.js';

package/dist/shared/index.js

@@ -7,4 +7,8 @@
  * - four: Four.meme 工具（TaxToken 等）
  */
 export * from './constants/index.js';
+/** 错误规范化、可选 Logger（与根 `index` 导出同源） */
+export * as foundation from './foundation/index.js';
+/** HTTP / Bundle / BlockRazor 等（亦支持子路径 `four-flap-meme-sdk/clients`） */
+export * as clients from './clients/index.js';
 export * as FourUtils from './four/index.js';

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,