four-flap-meme-sdk 1.9.43 → 1.9.45

package/dist/chains/eni/batch-router/bundle-buy.d.ts

@@ -1,19 +1,22 @@
 /**
- * ENI BatchRouter — 批量买入
- *
- * Phase 2: 部署 BatchRouter 合约后启用
- * 参考 xlayer/eip7702/bundle-buy.ts 的接口风格
+ * ENI BatchRouter — 批量买入 (内盘 + V2 + V3)
  */
 import type { BatchBuyParams, BatchBuyResult } from './types.js';
 /**
- * 内盘批量买入
- * 主钱包出 EGAS，代币直接到各 EOA
+ * 内盘批量买入 (DAOaaS Portal)
  */
 export declare function batchBuyPortal(params: BatchBuyParams): Promise<BatchBuyResult>;
 /**
- * 外盘 V2 批量买入
- * 通过 DSWAP V2 Router 买入
+ * 外盘 V2 批量买入 (DSWAP V2 / IROSwap V2)
  */
 export declare function batchBuyV2(params: BatchBuyParams & {
     path?: string[];
+    router?: string;
+}): Promise<BatchBuyResult>;
+/**
+ * 外盘 V3 批量买入 (DSWAP V3 Router02)
+ */
+export declare function batchBuyV3(params: BatchBuyParams & {
+    fee: number;
+    router: string;
 }): Promise<BatchBuyResult>;

package/dist/chains/eni/batch-router/bundle-buy.js

@@ -1,15 +1,11 @@
 /**
- * ENI BatchRouter — 批量买入
- *
- * Phase 2: 部署 BatchRouter 合约后启用
- * 参考 xlayer/eip7702/bundle-buy.ts 的接口风格
+ * ENI BatchRouter — 批量买入 (内盘 + V2 + V3)
  */
 import { DAOAAS_PORTAL, DSWAP_V2_ROUTER, WEGAS } from '../constants.js';
 import { estimateGas } from './constants.js';
-import { validateBatchParams, encodeBatchBuy, encodeBatchBuyV2, buildBatchRouterTx } from './utils.js';
+import { validateBatchParams, encodeBatchBuy, encodeBatchBuyV2, encodeBatchBuyV3, buildBatchRouterTx } from './utils.js';
 /**
- * 内盘批量买入
- * 主钱包出 EGAS，代币直接到各 EOA
+ * 内盘批量买入 (DAOaaS Portal)
  */
 export async function batchBuyPortal(params) {
     const { buyers, amounts, target = DAOAAS_PORTAL, token, profitAmount = 0n } = params;
@@ -17,7 +13,7 @@ export async function batchBuyPortal(params) {
     const totalBuyAmount = amounts.reduce((a, b) => a + b, 0n);
     const totalValue = totalBuyAmount + profitAmount;
     const calldata = encodeBatchBuy(target, token, buyers, amounts);
-    const gasLimit = estimateGas(buyers.length, true);
+    const gasLimit = estimateGas(buyers.length, 'portal');
     const result = await buildBatchRouterTx({
         rpcUrl: params.rpcUrl,
         mainPrivateKey: params.mainPrivateKey,
@@ -27,24 +23,19 @@ export async function batchBuyPortal(params) {
         gasLimit,
         gasPrice: params.gasPrice,
     });
-    return {
-        ...result,
-        totalValue,
-        estimatedGas: gasLimit,
-    };
+    return { ...result, totalValue, estimatedGas: gasLimit };
 }
 /**
- * 外盘 V2 批量买入
- * 通过 DSWAP V2 Router 买入
+ * 外盘 V2 批量买入 (DSWAP V2 / IROSwap V2)
  */
 export async function batchBuyV2(params) {
-    const { buyers, amounts, token, profitAmount = 0n, path } = params;
+    const { buyers, amounts, token, profitAmount = 0n, path, router = DSWAP_V2_ROUTER } = params;
     validateBatchParams(buyers, amounts, 'batchBuyV2');
     const totalBuyAmount = amounts.reduce((a, b) => a + b, 0n);
     const totalValue = totalBuyAmount + profitAmount;
     const buyPath = path ?? [WEGAS, token];
-    const calldata = encodeBatchBuyV2(DSWAP_V2_ROUTER, buyPath, buyers, amounts);
-    const gasLimit = estimateGas(buyers.length, false);
+    const calldata = encodeBatchBuyV2(router, buyPath, buyers, amounts);
+    const gasLimit = estimateGas(buyers.length, 'v2');
     const result = await buildBatchRouterTx({
         rpcUrl: params.rpcUrl,
         mainPrivateKey: params.mainPrivateKey,
@@ -54,9 +45,26 @@ export async function batchBuyV2(params) {
         gasLimit,
         gasPrice: params.gasPrice,
     });
-    return {
-        ...result,
-        totalValue,
-        estimatedGas: gasLimit,
-    };
+    return { ...result, totalValue, estimatedGas: gasLimit };
+}
+/**
+ * 外盘 V3 批量买入 (DSWAP V3 Router02)
+ */
+export async function batchBuyV3(params) {
+    const { buyers, amounts, token, profitAmount = 0n, fee, router } = params;
+    validateBatchParams(buyers, amounts, 'batchBuyV3');
+    const totalBuyAmount = amounts.reduce((a, b) => a + b, 0n);
+    const totalValue = totalBuyAmount + profitAmount;
+    const calldata = encodeBatchBuyV3(router, token, fee, buyers, amounts);
+    const gasLimit = estimateGas(buyers.length, 'v3');
+    const result = await buildBatchRouterTx({
+        rpcUrl: params.rpcUrl,
+        mainPrivateKey: params.mainPrivateKey,
+        batchRouterAddress: params.batchRouterAddress,
+        calldata,
+        value: totalValue,
+        gasLimit,
+        gasPrice: params.gasPrice,
+    });
+    return { ...result, totalValue, estimatedGas: gasLimit };
 }

package/dist/chains/eni/batch-router/bundle-sell.d.ts

@@ -1,18 +1,22 @@
 /**
- * ENI BatchRouter — 批量卖出
- *
- * Phase 2: 部署 BatchRouter 合约后启用
- * 各钱包需提前 approve(BatchRouter, amount)
+ * ENI BatchRouter — 批量卖出 (内盘 + V2 + V3)
  */
 import type { BatchSellParams, BatchSellResult } from './types.js';
 /**
- * 内盘批量卖出
- * BatchRouter 从各钱包 transferFrom 代币后执行 saleToken
+ * 内盘批量卖出 (DAOaaS Portal)
  */
 export declare function batchSellPortal(params: BatchSellParams): Promise<BatchSellResult>;
 /**
- * 外盘 V2 批量卖出
+ * 外盘 V2 批量卖出 (DSWAP V2 / IROSwap V2)
  */
 export declare function batchSellV2(params: BatchSellParams & {
     path?: string[];
+    router?: string;
+}): Promise<BatchSellResult>;
+/**
+ * 外盘 V3 批量卖出 (DSWAP V3 Router02)
+ */
+export declare function batchSellV3(params: BatchSellParams & {
+    fee: number;
+    router: string;
 }): Promise<BatchSellResult>;

package/dist/chains/eni/batch-router/bundle-sell.js

@@ -1,21 +1,17 @@
 /**
- * ENI BatchRouter — 批量卖出
- *
- * Phase 2: 部署 BatchRouter 合约后启用
- * 各钱包需提前 approve(BatchRouter, amount)
+ * ENI BatchRouter — 批量卖出 (内盘 + V2 + V3)
  */
 import { DAOAAS_PORTAL, DSWAP_V2_ROUTER, WEGAS } from '../constants.js';
 import { estimateGas } from './constants.js';
-import { validateBatchParams, encodeBatchSell, encodeBatchSellV2, buildBatchRouterTx } from './utils.js';
+import { validateBatchParams, encodeBatchSell, encodeBatchSellV2, encodeBatchSellV3, buildBatchRouterTx } from './utils.js';
 /**
- * 内盘批量卖出
- * BatchRouter 从各钱包 transferFrom 代币后执行 saleToken
+ * 内盘批量卖出 (DAOaaS Portal)
  */
 export async function batchSellPortal(params) {
     const { sellers, amounts, target = DAOAAS_PORTAL, token } = params;
     validateBatchParams(sellers, amounts, 'batchSellPortal');
     const calldata = encodeBatchSell(target, token, sellers, amounts);
-    const gasLimit = estimateGas(sellers.length, true);
+    const gasLimit = estimateGas(sellers.length, 'portal');
     const result = await buildBatchRouterTx({
         rpcUrl: params.rpcUrl,
         mainPrivateKey: params.mainPrivateKey,
@@ -27,14 +23,32 @@ export async function batchSellPortal(params) {
     return { ...result, estimatedGas: gasLimit };
 }
 /**
- * 外盘 V2 批量卖出
+ * 外盘 V2 批量卖出 (DSWAP V2 / IROSwap V2)
  */
 export async function batchSellV2(params) {
-    const { sellers, amounts, token, path } = params;
+    const { sellers, amounts, token, path, router = DSWAP_V2_ROUTER } = params;
     validateBatchParams(sellers, amounts, 'batchSellV2');
     const sellPath = path ?? [token, WEGAS];
-    const calldata = encodeBatchSellV2(DSWAP_V2_ROUTER, sellPath, sellers, amounts);
-    const gasLimit = estimateGas(sellers.length, false);
+    const calldata = encodeBatchSellV2(router, sellPath, sellers, amounts);
+    const gasLimit = estimateGas(sellers.length, 'v2');
+    const result = await buildBatchRouterTx({
+        rpcUrl: params.rpcUrl,
+        mainPrivateKey: params.mainPrivateKey,
+        batchRouterAddress: params.batchRouterAddress,
+        calldata,
+        gasLimit,
+        gasPrice: params.gasPrice,
+    });
+    return { ...result, estimatedGas: gasLimit };
+}
+/**
+ * 外盘 V3 批量卖出 (DSWAP V3 Router02)
+ */
+export async function batchSellV3(params) {
+    const { sellers, amounts, token, fee, router } = params;
+    validateBatchParams(sellers, amounts, 'batchSellV3');
+    const calldata = encodeBatchSellV3(router, token, fee, sellers, amounts);
+    const gasLimit = estimateGas(sellers.length, 'v3');
     const result = await buildBatchRouterTx({
         rpcUrl: params.rpcUrl,
         mainPrivateKey: params.mainPrivateKey,

package/dist/chains/eni/batch-router/bundle-swap.d.ts

@@ -1,29 +1,16 @@
 /**
- * ENI BatchRouter — 原子换手（内盘 + V2 外盘）
+ * ENI BatchRouter — 原子换手 (内盘 + V2 + V3)
  *
- * Phase 2: 卖出 + 买入在同一笔 tx 中原子执行
- * 对标 BSC: fourBundleSwapMerkle / pancakeBundleSwapMerkle
- *
- * 内盘: atomicSwapPortal / batchSwapPortal
- * 外盘: atomicSwapV2 / batchSwapV2
+ * 支持 1→N (atomicSwap) 和 M→N (batchSwap)
  */
 import type { AtomicSwapParams, AtomicSwapResult } from './types.js';
-/**
- * 内盘 1 卖 N 买 原子换手
- * 卖出钱包卖出代币 → EGAS 留在合约 → 用于买入到各钱包
- */
 export declare function atomicSwapPortal(params: AtomicSwapParams): Promise<AtomicSwapResult>;
-/**
- * 内盘 M 卖 N 买 批量换手
- */
 export declare function batchSwapPortal(params: AtomicSwapParams): Promise<AtomicSwapResult>;
-/**
- * V2 外盘 1 卖 N 买 原子换手
- * token → WEGAS (卖出) → WEGAS → token (买入)，同一笔 tx
- */
 export declare function atomicSwapV2(params: AtomicSwapParams): Promise<AtomicSwapResult>;
-/**
- * V2 外盘 M 卖 N 买 批量换手
- * 对标 BSC pancakeBatchSwapMerkle
- */
 export declare function batchSwapV2(params: AtomicSwapParams): Promise<AtomicSwapResult>;
+export interface V3SwapParams extends AtomicSwapParams {
+    fee: number;
+    router: string;
+}
+export declare function atomicSwapV3(params: V3SwapParams): Promise<AtomicSwapResult>;
+export declare function batchSwapV3(params: V3SwapParams): Promise<AtomicSwapResult>;

package/dist/chains/eni/batch-router/bundle-swap.js

@@ -1,29 +1,21 @@
 /**
- * ENI BatchRouter — 原子换手（内盘 + V2 外盘）
+ * ENI BatchRouter — 原子换手 (内盘 + V2 + V3)
  *
- * Phase 2: 卖出 + 买入在同一笔 tx 中原子执行
- * 对标 BSC: fourBundleSwapMerkle / pancakeBundleSwapMerkle
- *
- * 内盘: atomicSwapPortal / batchSwapPortal
- * 外盘: atomicSwapV2 / batchSwapV2
+ * 支持 1→N (atomicSwap) 和 M→N (batchSwap)
  */
 import { DAOAAS_PORTAL, DSWAP_V2_ROUTER } from '../constants.js';
 import { estimateGas } from './constants.js';
-import { validateBatchParams, encodeAtomicSwap, encodeBatchSwap, encodeAtomicSwapV2, encodeBatchSwapV2, buildBatchRouterTx, } from './utils.js';
+import { validateBatchParams, encodeAtomicSwap, encodeBatchSwap, encodeAtomicSwapV2, encodeBatchSwapV2, encodeAtomicSwapV3, encodeBatchSwapV3, buildBatchRouterTx, } from './utils.js';
 // ============================================================================
 // 内盘换手 (DAOaaS Portal)
 // ============================================================================
-/**
- * 内盘 1 卖 N 买 原子换手
- * 卖出钱包卖出代币 → EGAS 留在合约 → 用于买入到各钱包
- */
 export async function atomicSwapPortal(params) {
     const { sellers, sellAmounts, buyers, buyAmounts, target = DAOAAS_PORTAL, token, extraValue = 0n } = params;
     if (sellers.length === 1) {
         validateBatchParams(buyers, buyAmounts, 'atomicSwapPortal.buyers');
         const calldata = encodeAtomicSwap(target, token, sellers[0], sellAmounts[0], buyers, buyAmounts);
         const totalWallets = 1 + buyers.length;
-        const gasLimit = estimateGas(totalWallets, true);
+        const gasLimit = estimateGas(totalWallets, 'portal');
         const result = await buildBatchRouterTx({
             rpcUrl: params.rpcUrl,
             mainPrivateKey: params.mainPrivateKey,
@@ -37,16 +29,13 @@ export async function atomicSwapPortal(params) {
     }
     return batchSwapPortal(params);
 }
-/**
- * 内盘 M 卖 N 买 批量换手
- */
 export async function batchSwapPortal(params) {
     const { sellers, sellAmounts, buyers, buyAmounts, target = DAOAAS_PORTAL, token, extraValue = 0n } = params;
     validateBatchParams(sellers, sellAmounts, 'batchSwap.sellers');
     validateBatchParams(buyers, buyAmounts, 'batchSwap.buyers');
     const calldata = encodeBatchSwap(target, token, sellers, sellAmounts, buyers, buyAmounts);
     const totalWallets = sellers.length + buyers.length;
-    const gasLimit = estimateGas(totalWallets, true);
+    const gasLimit = estimateGas(totalWallets, 'portal');
     const result = await buildBatchRouterTx({
         rpcUrl: params.rpcUrl,
         mainPrivateKey: params.mainPrivateKey,
@@ -59,19 +48,15 @@ export async function batchSwapPortal(params) {
     return { ...result, totalValue: extraValue, estimatedGas: gasLimit };
 }
 // ============================================================================
-// V2 外盘换手 (DSWAP V2) — 对标 BSC pancakeBundleSwapMerkle
+// V2 外盘换手 (DSWAP V2 / IROSwap V2)
 // ============================================================================
-/**
- * V2 外盘 1 卖 N 买 原子换手
- * token → WEGAS (卖出) → WEGAS → token (买入)，同一笔 tx
- */
 export async function atomicSwapV2(params) {
     const { sellers, sellAmounts, buyers, buyAmounts, target = DSWAP_V2_ROUTER, token, extraValue = 0n } = params;
     if (sellers.length === 1) {
         validateBatchParams(buyers, buyAmounts, 'atomicSwapV2.buyers');
         const calldata = encodeAtomicSwapV2(target, token, sellers[0], sellAmounts[0], buyers, buyAmounts);
         const totalWallets = 1 + buyers.length;
-        const gasLimit = estimateGas(totalWallets, false);
+        const gasLimit = estimateGas(totalWallets, 'v2');
         const result = await buildBatchRouterTx({
             rpcUrl: params.rpcUrl,
             mainPrivateKey: params.mainPrivateKey,
@@ -85,17 +70,51 @@ export async function atomicSwapV2(params) {
     }
     return batchSwapV2(params);
 }
-/**
- * V2 外盘 M 卖 N 买 批量换手
- * 对标 BSC pancakeBatchSwapMerkle
- */
 export async function batchSwapV2(params) {
     const { sellers, sellAmounts, buyers, buyAmounts, target = DSWAP_V2_ROUTER, token, extraValue = 0n } = params;
     validateBatchParams(sellers, sellAmounts, 'batchSwapV2.sellers');
     validateBatchParams(buyers, buyAmounts, 'batchSwapV2.buyers');
     const calldata = encodeBatchSwapV2(target, token, sellers, sellAmounts, buyers, buyAmounts);
     const totalWallets = sellers.length + buyers.length;
-    const gasLimit = estimateGas(totalWallets, false);
+    const gasLimit = estimateGas(totalWallets, 'v2');
+    const result = await buildBatchRouterTx({
+        rpcUrl: params.rpcUrl,
+        mainPrivateKey: params.mainPrivateKey,
+        batchRouterAddress: params.batchRouterAddress,
+        calldata,
+        value: extraValue,
+        gasLimit,
+        gasPrice: params.gasPrice,
+    });
+    return { ...result, totalValue: extraValue, estimatedGas: gasLimit };
+}
+export async function atomicSwapV3(params) {
+    const { sellers, sellAmounts, buyers, buyAmounts, token, extraValue = 0n, fee, router } = params;
+    if (sellers.length === 1) {
+        validateBatchParams(buyers, buyAmounts, 'atomicSwapV3.buyers');
+        const calldata = encodeAtomicSwapV3(router, token, fee, sellers[0], sellAmounts[0], buyers, buyAmounts);
+        const totalWallets = 1 + buyers.length;
+        const gasLimit = estimateGas(totalWallets, 'v3');
+        const result = await buildBatchRouterTx({
+            rpcUrl: params.rpcUrl,
+            mainPrivateKey: params.mainPrivateKey,
+            batchRouterAddress: params.batchRouterAddress,
+            calldata,
+            value: extraValue,
+            gasLimit,
+            gasPrice: params.gasPrice,
+        });
+        return { ...result, totalValue: extraValue, estimatedGas: gasLimit };
+    }
+    return batchSwapV3(params);
+}
+export async function batchSwapV3(params) {
+    const { sellers, sellAmounts, buyers, buyAmounts, token, extraValue = 0n, fee, router } = params;
+    validateBatchParams(sellers, sellAmounts, 'batchSwapV3.sellers');
+    validateBatchParams(buyers, buyAmounts, 'batchSwapV3.buyers');
+    const calldata = encodeBatchSwapV3(router, token, fee, sellers, sellAmounts, buyers, buyAmounts);
+    const totalWallets = sellers.length + buyers.length;
+    const gasLimit = estimateGas(totalWallets, 'v3');
     const result = await buildBatchRouterTx({
         rpcUrl: params.rpcUrl,
         mainPrivateKey: params.mainPrivateKey,

package/dist/chains/eni/batch-router/constants.d.ts

@@ -1,23 +1,28 @@
 /**
- * ENI BatchRouter 合约常量
+ * ENI BatchRouter V2 合约常量
  *
- * 对标 BSC 全部 Bundle 功能
+ * V2 变更:
+ *   - V2 swap 改用 SupportingFeeOnTransferTokens
+ *   - 新增 V3 (DSWAP V3 Router02) 全套批量操作
+ *   - buyAmounts[i]==0 自动均分 (原子刷量)
  */
-/** BatchRouter 合约地址 (V2 无权限公共版) */
+/** BatchRouter V2 合约地址 (部署后更新) */
 export declare const BATCH_ROUTER_ADDRESS = "0xDe44dC76cE29f743FbC250930a92a847Bf1662F2";
 /** 每个钱包操作的预估 Gas (内盘) */
 export declare const GAS_PER_WALLET_PORTAL = 250000n;
 /** 每个钱包操作的预估 Gas (V2 外盘) */
 export declare const GAS_PER_WALLET_V2 = 200000n;
+/** 每个钱包操作的预估 Gas (V3 外盘) */
+export declare const GAS_PER_WALLET_V3 = 280000n;
 /** 基础 Gas (合约开销) */
 export declare const BASE_GAS = 100000n;
 /** 最大钱包数 (受 10M gas 限制) */
 export declare const MAX_BATCH_SIZE = 35;
-/** BatchRouter ABI — 完整接口 (对标 BSC 全部 Bundle 功能) */
-export declare const BATCH_ROUTER_ABI: readonly ["function batchBuy(address portal, address token, address[] buyers, uint256[] amounts) payable", "function batchSell(address portal, address token, address[] sellers, uint256[] amounts)", "function batchBuyV2(address router, address[] path, address[] buyers, uint256[] amounts) payable", "function batchSellV2(address router, address[] path, address[] sellers, uint256[] amounts)", "function atomicSwap(address portal, address token, address seller, uint256 sellAmount, address[] buyers, uint256[] buyAmounts) payable", "function batchSwap(address portal, address token, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable", "function atomicSwapV2(address router, address token, address seller, uint256 sellAmount, address[] buyers, uint256[] buyAmounts) payable", "function batchSwapV2(address router, address token, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable", "function buyFirstSwap(address portal, address token, address[] buyers, uint256[] buyAmounts, address[] sellers, uint256[] sellAmounts) payable", "function buyFirstSwapV2(address router, address token, address[] buyers, uint256[] buyAmounts, address[] sellers, uint256[] sellAmounts) payable", "function createAndBatchBuy(address portal, string name, string symbol, uint256 salt, uint256 createValue, address token, address[] buyers, uint256[] buyAmounts) payable", "function fairLaunchAndBatchBuyV2(address launcher, tuple(string name, string symbol, string logo, string metadata, address quoteTokenAddr, uint256 initialLp, uint256 initialQuote, uint256 lpAddRate, uint256 lpAddMin, uint256 buybackRate, uint256 buybackMin, address[] buybackPath, uint256[] marketingRates, address[] marketingAddrs, uint256 vestingAmount, uint256 vestingLockEndTime, uint256 vestingReleaseEndTime, address[] vestingRecipients, uint256[] vestingRatios, uint256 tradeStartTime, uint256 claimStartTime, uint256 claimEndTime, uint256 lockTime, uint256 releasePeriod, uint256 maxCount, uint256 minAmount, uint256 maxAmount, bool whitelistEnabled, address[] whitelistAddrs, bool inviteCodeEnabled, bytes32[] inviteCodes) launchParams, uint256 launchValue, address router, address token, address[] buyers, uint256[] buyAmounts) payable", "function crossSwapPortalToV2(address portal, address router, address token, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable", "function crossSwapV2ToPortal(address portal, address router, address token, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable", "function batchTransfer(address[] recipients, uint256[] amounts) payable", "function batchTransferToken(address token, address[] recipients, uint256[] amounts)", "function batchSweepToken(address token, address[] sources, address target)", "function owner() view returns (address)", "function transferOwnership(address o)", "function withdrawETH()", "function withdrawToken(address t)"];
+/** BatchRouter V2 ABI — 25 个业务函数 */
+export declare const BATCH_ROUTER_ABI: readonly ["function batchBuy(address portal, address token, address[] buyers, uint256[] amounts) payable", "function batchSell(address portal, address token, address[] sellers, uint256[] amounts)", "function batchBuyV2(address router, address[] path, address[] buyers, uint256[] amounts) payable", "function batchSellV2(address router, address[] path, address[] sellers, uint256[] amounts)", "function batchBuyV3(address router, address token, uint24 fee, address[] buyers, uint256[] amounts) payable", "function batchSellV3(address router, address token, uint24 fee, address[] sellers, uint256[] amounts)", "function atomicSwap(address portal, address token, address seller, uint256 sellAmount, address[] buyers, uint256[] buyAmounts) payable", "function batchSwap(address portal, address token, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable", "function atomicSwapV2(address router, address token, address seller, uint256 sellAmount, address[] buyers, uint256[] buyAmounts) payable", "function batchSwapV2(address router, address token, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable", "function atomicSwapV3(address router, address token, uint24 fee, address seller, uint256 sellAmount, address[] buyers, uint256[] buyAmounts) payable", "function batchSwapV3(address router, address token, uint24 fee, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable", "function buyFirstSwap(address portal, address token, address[] buyers, uint256[] buyAmounts, address[] sellers, uint256[] sellAmounts) payable", "function buyFirstSwapV2(address router, address token, address[] buyers, uint256[] buyAmounts, address[] sellers, uint256[] sellAmounts) payable", "function buyFirstSwapV3(address router, address token, uint24 fee, address[] buyers, uint256[] buyAmounts, address[] sellers, uint256[] sellAmounts) payable", "function createAndBatchBuy(address portal, string name, string symbol, uint256 salt, uint256 createValue, address token, address[] buyers, uint256[] buyAmounts) payable", "function fairLaunchAndBatchBuyV2(address launcher, tuple(string name, string symbol, string logo, string metadata, address quoteTokenAddr, uint256 initialLp, uint256 initialQuote, uint256 lpAddRate, uint256 lpAddMin, uint256 buybackRate, uint256 buybackMin, address[] buybackPath, uint256[] marketingRates, address[] marketingAddrs, uint256 vestingAmount, uint256 vestingLockEndTime, uint256 vestingReleaseEndTime, address[] vestingRecipients, uint256[] vestingRatios, uint256 tradeStartTime, uint256 claimStartTime, uint256 claimEndTime, uint256 lockTime, uint256 releasePeriod, uint256 maxCount, uint256 minAmount, uint256 maxAmount, bool whitelistEnabled, address[] whitelistAddrs, bool inviteCodeEnabled, bytes32[] inviteCodes) launchParams, uint256 launchValue, address router, address token, address[] buyers, uint256[] buyAmounts) payable", "function fairLaunchAndBatchBuyV3(address launcher, tuple(string name, string symbol, string logo, string metadata, address quoteTokenAddr, uint256 initialLp, uint256 initialQuote, uint256 lpAddRate, uint256 lpAddMin, uint256 buybackRate, uint256 buybackMin, address[] buybackPath, uint256[] marketingRates, address[] marketingAddrs, uint256 vestingAmount, uint256 vestingLockEndTime, uint256 vestingReleaseEndTime, address[] vestingRecipients, uint256[] vestingRatios, uint256 tradeStartTime, uint256 claimStartTime, uint256 claimEndTime, uint256 lockTime, uint256 releasePeriod, uint256 maxCount, uint256 minAmount, uint256 maxAmount, bool whitelistEnabled, address[] whitelistAddrs, bool inviteCodeEnabled, bytes32[] inviteCodes) launchParams, uint256 launchValue, address router, address token, uint24 fee, address[] buyers, uint256[] buyAmounts) payable", "function crossSwapPortalToV2(address portal, address router, address token, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable", "function crossSwapV2ToPortal(address portal, address router, address token, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable", "function crossSwapPortalToV3(address portal, address router, address token, uint24 fee, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable", "function crossSwapV3ToPortal(address portal, address router, address token, uint24 fee, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable", "function batchTransfer(address[] recipients, uint256[] amounts) payable", "function batchTransferToken(address token, address[] recipients, uint256[] amounts)", "function batchSweepToken(address token, address[] sources, address target)", "function owner() view returns (address)", "function transferOwnership(address o)", "function withdrawETH()", "function withdrawToken(address t)"];
 /**
  * 估算 Gas
  * @param walletCount 钱包数量
- * @param isPortal 是否为内盘操作
+ * @param mode 操作类型: 'portal' | 'v2' | 'v3'
  */
-export declare function estimateGas(walletCount: number, isPortal?: boolean): bigint;
+export declare function estimateGas(walletCount: number, mode?: 'portal' | 'v2' | 'v3'): bigint;

package/dist/chains/eni/batch-router/constants.js

@@ -1,42 +1,56 @@
 /**
- * ENI BatchRouter 合约常量
+ * ENI BatchRouter V2 合约常量
  *
- * 对标 BSC 全部 Bundle 功能
+ * V2 变更:
+ *   - V2 swap 改用 SupportingFeeOnTransferTokens
+ *   - 新增 V3 (DSWAP V3 Router02) 全套批量操作
+ *   - buyAmounts[i]==0 自动均分 (原子刷量)
  */
-/** BatchRouter 合约地址 (V2 无权限公共版) */
+/** BatchRouter V2 合约地址 (部署后更新) */
 export const BATCH_ROUTER_ADDRESS = '0xDe44dC76cE29f743FbC250930a92a847Bf1662F2';
 /** 每个钱包操作的预估 Gas (内盘) */
 export const GAS_PER_WALLET_PORTAL = 250000n;
 /** 每个钱包操作的预估 Gas (V2 外盘) */
 export const GAS_PER_WALLET_V2 = 200000n;
+/** 每个钱包操作的预估 Gas (V3 外盘) */
+export const GAS_PER_WALLET_V3 = 280000n;
 /** 基础 Gas (合约开销) */
 export const BASE_GAS = 100000n;
 /** 最大钱包数 (受 10M gas 限制) */
 export const MAX_BATCH_SIZE = 35;
-/** BatchRouter ABI — 完整接口 (对标 BSC 全部 Bundle 功能) */
+/** BatchRouter V2 ABI — 25 个业务函数 */
 export const BATCH_ROUTER_ABI = [
     // ── 内盘批量操作 (DAOaaS Portal) ──
     'function batchBuy(address portal, address token, address[] buyers, uint256[] amounts) payable',
     'function batchSell(address portal, address token, address[] sellers, uint256[] amounts)',
-    // ── 外盘批量操作 (DSWAP V2) ──
+    // ── V2 外盘批量操作 (SupportingFeeOnTransfer + balanceOf) ──
     'function batchBuyV2(address router, address[] path, address[] buyers, uint256[] amounts) payable',
     'function batchSellV2(address router, address[] path, address[] sellers, uint256[] amounts)',
+    // ── V3 外盘批量操作 (DSWAP V3 Router02) ──
+    'function batchBuyV3(address router, address token, uint24 fee, address[] buyers, uint256[] amounts) payable',
+    'function batchSellV3(address router, address token, uint24 fee, address[] sellers, uint256[] amounts)',
     // ── 内盘换手 (先卖后买) ──
     'function atomicSwap(address portal, address token, address seller, uint256 sellAmount, address[] buyers, uint256[] buyAmounts) payable',
     'function batchSwap(address portal, address token, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable',
     // ── V2 外盘换手 (先卖后买) ──
     'function atomicSwapV2(address router, address token, address seller, uint256 sellAmount, address[] buyers, uint256[] buyAmounts) payable',
     'function batchSwapV2(address router, address token, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable',
-    // ── ⭐ 先买后卖 (Buy-First, 对标 BSC fourBundleBuyFirstMerkle) ──
+    // ── V3 外盘换手 (先卖后买) ──
+    'function atomicSwapV3(address router, address token, uint24 fee, address seller, uint256 sellAmount, address[] buyers, uint256[] buyAmounts) payable',
+    'function batchSwapV3(address router, address token, uint24 fee, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable',
+    // ── 先买后卖 ──
     'function buyFirstSwap(address portal, address token, address[] buyers, uint256[] buyAmounts, address[] sellers, uint256[] sellAmounts) payable',
     'function buyFirstSwapV2(address router, address token, address[] buyers, uint256[] buyAmounts, address[] sellers, uint256[] sellAmounts) payable',
-    // ── ⭐ 发币+首买: Portal bonding curve ──
+    'function buyFirstSwapV3(address router, address token, uint24 fee, address[] buyers, uint256[] buyAmounts, address[] sellers, uint256[] sellAmounts) payable',
+    // ── 发币+首买 ──
     'function createAndBatchBuy(address portal, string name, string symbol, uint256 salt, uint256 createValue, address token, address[] buyers, uint256[] buyAmounts) payable',
-    // ── ⭐ 发币+首买: FairLaunch 5种模式 → V2 ──
     'function fairLaunchAndBatchBuyV2(address launcher, tuple(string name, string symbol, string logo, string metadata, address quoteTokenAddr, uint256 initialLp, uint256 initialQuote, uint256 lpAddRate, uint256 lpAddMin, uint256 buybackRate, uint256 buybackMin, address[] buybackPath, uint256[] marketingRates, address[] marketingAddrs, uint256 vestingAmount, uint256 vestingLockEndTime, uint256 vestingReleaseEndTime, address[] vestingRecipients, uint256[] vestingRatios, uint256 tradeStartTime, uint256 claimStartTime, uint256 claimEndTime, uint256 lockTime, uint256 releasePeriod, uint256 maxCount, uint256 minAmount, uint256 maxAmount, bool whitelistEnabled, address[] whitelistAddrs, bool inviteCodeEnabled, bytes32[] inviteCodes) launchParams, uint256 launchValue, address router, address token, address[] buyers, uint256[] buyAmounts) payable',
-    // ── ⭐ 跨盘换手 (对标 BSC flapBundleCurveToDex) ──
+    'function fairLaunchAndBatchBuyV3(address launcher, tuple(string name, string symbol, string logo, string metadata, address quoteTokenAddr, uint256 initialLp, uint256 initialQuote, uint256 lpAddRate, uint256 lpAddMin, uint256 buybackRate, uint256 buybackMin, address[] buybackPath, uint256[] marketingRates, address[] marketingAddrs, uint256 vestingAmount, uint256 vestingLockEndTime, uint256 vestingReleaseEndTime, address[] vestingRecipients, uint256[] vestingRatios, uint256 tradeStartTime, uint256 claimStartTime, uint256 claimEndTime, uint256 lockTime, uint256 releasePeriod, uint256 maxCount, uint256 minAmount, uint256 maxAmount, bool whitelistEnabled, address[] whitelistAddrs, bool inviteCodeEnabled, bytes32[] inviteCodes) launchParams, uint256 launchValue, address router, address token, uint24 fee, address[] buyers, uint256[] buyAmounts) payable',
+    // ── 跨盘换手 ──
     'function crossSwapPortalToV2(address portal, address router, address token, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable',
     'function crossSwapV2ToPortal(address portal, address router, address token, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable',
+    'function crossSwapPortalToV3(address portal, address router, address token, uint24 fee, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable',
+    'function crossSwapV3ToPortal(address portal, address router, address token, uint24 fee, address[] sellers, uint256[] sellAmounts, address[] buyers, uint256[] buyAmounts) payable',
     // ── 分发 / 归集 ──
     'function batchTransfer(address[] recipients, uint256[] amounts) payable',
     'function batchTransferToken(address token, address[] recipients, uint256[] amounts)',
@@ -50,9 +64,11 @@ export const BATCH_ROUTER_ABI = [
 /**
  * 估算 Gas
  * @param walletCount 钱包数量
- * @param isPortal 是否为内盘操作
+ * @param mode 操作类型: 'portal' | 'v2' | 'v3'
  */
-export function estimateGas(walletCount, isPortal = true) {
-    const perWallet = isPortal ? GAS_PER_WALLET_PORTAL : GAS_PER_WALLET_V2;
+export function estimateGas(walletCount, mode = 'portal') {
+    const perWallet = mode === 'portal' ? GAS_PER_WALLET_PORTAL
+        : mode === 'v3' ? GAS_PER_WALLET_V3
+            : GAS_PER_WALLET_V2;
     return BASE_GAS + perWallet * BigInt(walletCount);
 }

package/dist/chains/eni/batch-router/index.d.ts

@@ -1,14 +1,14 @@
 /**
- * ENI BatchRouter 模块入口 — 完整版
+ * ENI BatchRouter V2 模块入口
  *
- * 对标 BSC 全部 Bundle 功能
+ * 支持内盘 (Portal) / V2 (DSWAP/IROSwap) / V3 (DSWAP V3) 全部操作
  */
 export type { BatchRouterConfig, BatchBuyParams, BatchBuyResult, BatchSellParams, BatchSellResult, AtomicSwapParams, AtomicSwapResult, BatchApproveParams, BatchApproveResult, BatchTransferParams, BatchTransferResult, } from './types.js';
-export { BATCH_ROUTER_ADDRESS, BATCH_ROUTER_ABI, GAS_PER_WALLET_PORTAL, GAS_PER_WALLET_V2, BASE_GAS, MAX_BATCH_SIZE, estimateGas, } from './constants.js';
-export { validateBatchParams, encodeBatchBuy, encodeBatchSell, encodeBatchBuyV2, encodeBatchSellV2, encodeAtomicSwap, encodeBatchSwap, encodeAtomicSwapV2, encodeBatchSwapV2, encodeBuyFirstSwap, encodeBuyFirstSwapV2, encodeCreateAndBatchBuy, encodeFairLaunchAndBatchBuyV2, type FairLaunchParamsForRouter, encodeCrossSwapPortalToV2, encodeCrossSwapV2ToPortal, encodeBatchTransfer, encodeBatchTransferToken, encodeBatchSweepToken, buildBatchRouterTx, } from './utils.js';
-export { batchBuyPortal, batchBuyV2 } from './bundle-buy.js';
-export { batchSellPortal, batchSellV2 } from './bundle-sell.js';
-export { atomicSwapPortal, batchSwapPortal, atomicSwapV2, batchSwapV2 } from './bundle-swap.js';
+export { BATCH_ROUTER_ADDRESS, BATCH_ROUTER_ABI, GAS_PER_WALLET_PORTAL, GAS_PER_WALLET_V2, GAS_PER_WALLET_V3, BASE_GAS, MAX_BATCH_SIZE, estimateGas, } from './constants.js';
+export { validateBatchParams, encodeBatchBuy, encodeBatchSell, encodeBatchBuyV2, encodeBatchSellV2, encodeBatchBuyV3, encodeBatchSellV3, encodeAtomicSwap, encodeBatchSwap, encodeAtomicSwapV2, encodeBatchSwapV2, encodeAtomicSwapV3, encodeBatchSwapV3, encodeBuyFirstSwap, encodeBuyFirstSwapV2, encodeBuyFirstSwapV3, encodeCreateAndBatchBuy, encodeFairLaunchAndBatchBuyV2, encodeFairLaunchAndBatchBuyV3, type FairLaunchParamsForRouter, encodeCrossSwapPortalToV2, encodeCrossSwapV2ToPortal, encodeCrossSwapPortalToV3, encodeCrossSwapV3ToPortal, encodeBatchTransfer, encodeBatchTransferToken, encodeBatchSweepToken, buildBatchRouterTx, } from './utils.js';
+export { batchBuyPortal, batchBuyV2, batchBuyV3 } from './bundle-buy.js';
+export { batchSellPortal, batchSellV2, batchSellV3 } from './bundle-sell.js';
+export { atomicSwapPortal, batchSwapPortal, atomicSwapV2, batchSwapV2, atomicSwapV3, batchSwapV3, type V3SwapParams, } from './bundle-swap.js';
 export { batchApprove } from './bundle-approve.js';
-export { washVolume, washVolumeV2, type WashVolumeParams, type WashVolumeResult } from './volume.js';
+export { washVolume, washVolumeV2, washVolumeV3, type WashVolumeParams, type WashVolumeResult, } from './volume.js';
 export { batchTransferEgas, batchTransferToken, batchSweepToken, batchSweepEgas, eniDisperseForSubmit, eniSweepForSubmit, type BatchTransferTokenParams, type BatchSweepTokenParams, type BatchSweepTokenResult, type BatchSweepEgasParams, type EniDisperseParams, type EniDisperseResult, type EniSweepParams, type EniSweepResult, } from './transfer.js';

package/dist/chains/eni/batch-router/index.js

@@ -1,28 +1,34 @@
 /**
- * ENI BatchRouter 模块入口 — 完整版
+ * ENI BatchRouter V2 模块入口
  *
- * 对标 BSC 全部 Bundle 功能
+ * 支持内盘 (Portal) / V2 (DSWAP/IROSwap) / V3 (DSWAP V3) 全部操作
  */
 // ============================================================================
 // 常量
 // ============================================================================
-export { BATCH_ROUTER_ADDRESS, BATCH_ROUTER_ABI, GAS_PER_WALLET_PORTAL, GAS_PER_WALLET_V2, BASE_GAS, MAX_BATCH_SIZE, estimateGas, } from './constants.js';
+export { BATCH_ROUTER_ADDRESS, BATCH_ROUTER_ABI, GAS_PER_WALLET_PORTAL, GAS_PER_WALLET_V2, GAS_PER_WALLET_V3, BASE_GAS, MAX_BATCH_SIZE, estimateGas, } from './constants.js';
 // ============================================================================
 // calldata 编码工具 (全部操作)
 // ============================================================================
 export { validateBatchParams, 
-// 基础操作
-encodeBatchBuy, encodeBatchSell, encodeBatchBuyV2, encodeBatchSellV2, 
-// 换手 (先卖后买)
-encodeAtomicSwap, encodeBatchSwap, encodeAtomicSwapV2, encodeBatchSwapV2, 
-// ⭐ 先买后卖
-encodeBuyFirstSwap, encodeBuyFirstSwapV2, 
-// ⭐ 发币+首买 (Portal)
-encodeCreateAndBatchBuy, 
-// ⭐ 发币+首买 (FairLaunch 5种模式)
-encodeFairLaunchAndBatchBuyV2, 
-// ⭐ 跨盘换手
-encodeCrossSwapPortalToV2, encodeCrossSwapV2ToPortal, 
+// 内盘
+encodeBatchBuy, encodeBatchSell, 
+// V2
+encodeBatchBuyV2, encodeBatchSellV2, 
+// V3
+encodeBatchBuyV3, encodeBatchSellV3, 
+// 内盘换手
+encodeAtomicSwap, encodeBatchSwap, 
+// V2 换手
+encodeAtomicSwapV2, encodeBatchSwapV2, 
+// V3 换手
+encodeAtomicSwapV3, encodeBatchSwapV3, 
+// 先买后卖
+encodeBuyFirstSwap, encodeBuyFirstSwapV2, encodeBuyFirstSwapV3, 
+// 发币+首买
+encodeCreateAndBatchBuy, encodeFairLaunchAndBatchBuyV2, encodeFairLaunchAndBatchBuyV3, 
+// 跨盘换手
+encodeCrossSwapPortalToV2, encodeCrossSwapV2ToPortal, encodeCrossSwapPortalToV3, encodeCrossSwapV3ToPortal, 
 // 分发 / 归集
 encodeBatchTransfer, encodeBatchTransferToken, encodeBatchSweepToken, 
 // 交易构建
@@ -30,9 +36,9 @@ buildBatchRouterTx, } from './utils.js';
 // ============================================================================
 // 高层操作
 // ============================================================================
-export { batchBuyPortal, batchBuyV2 } from './bundle-buy.js';
-export { batchSellPortal, batchSellV2 } from './bundle-sell.js';
-export { atomicSwapPortal, batchSwapPortal, atomicSwapV2, batchSwapV2 } from './bundle-swap.js';
+export { batchBuyPortal, batchBuyV2, batchBuyV3 } from './bundle-buy.js';
+export { batchSellPortal, batchSellV2, batchSellV3 } from './bundle-sell.js';
+export { atomicSwapPortal, batchSwapPortal, atomicSwapV2, batchSwapV2, atomicSwapV3, batchSwapV3, } from './bundle-swap.js';
 export { batchApprove } from './bundle-approve.js';
-export { washVolume, washVolumeV2 } from './volume.js';
+export { washVolume, washVolumeV2, washVolumeV3, } from './volume.js';
 export { batchTransferEgas, batchTransferToken, batchSweepToken, batchSweepEgas, eniDisperseForSubmit, eniSweepForSubmit, } from './transfer.js';

package/dist/chains/eni/batch-router/transfer.js

@@ -26,7 +26,7 @@ export async function batchTransferEgas(params) {
     validateBatchParams(recipients, amounts, 'batchTransferEgas');
     const totalValue = amounts.reduce((a, b) => a + b, 0n);
     const calldata = encodeBatchTransfer(recipients, amounts);
-    const gasLimit = estimateGas(recipients.length, false);
+    const gasLimit = estimateGas(recipients.length, 'v2');
     const result = await buildBatchRouterTx({
         rpcUrl: params.rpcUrl,
         mainPrivateKey: params.mainPrivateKey,
@@ -43,7 +43,7 @@ export async function batchTransferToken(params) {
     validateBatchParams(recipients, amounts, 'batchTransferToken');
     const routerAddr = params.batchRouterAddress || BATCH_ROUTER_ADDRESS;
     const calldata = encodeBatchTransferToken(token, recipients, amounts);
-    const gasLimit = estimateGas(recipients.length, false);
+    const gasLimit = estimateGas(recipients.length, 'v2');
     const result = await buildBatchRouterTx({
         rpcUrl: params.rpcUrl,
         mainPrivateKey: params.mainPrivateKey,
@@ -156,7 +156,7 @@ export async function eniDisperseForSubmit(params) {
     const totalNeeded = amountsWei.reduce((a, b) => a + b, 0n);
     const signedTxs = [];
     let currentNonce = await mainWallet.getNonce();
-    const gasLimit = estimateGas(recipients.length, false);
+    const gasLimit = estimateGas(recipients.length, 'v2');
     if (allowance < totalNeeded) {
         const approveTx = await mainWallet.signTransaction({
             to: tokenAddress,

package/dist/chains/eni/batch-router/utils.d.ts

@@ -1,19 +1,24 @@
 /**
- * ENI BatchRouter 编码工具 — 完整版
+ * ENI BatchRouter V2 编码工具
  *
- * 对标 BSC 全部 Bundle 操作的 calldata 编码
+ * 支持内盘 (Portal) / V2 / V3 全部操作的 calldata 编码
  */
 export declare function validateBatchParams(addresses: string[], amounts: bigint[], label?: string): void;
 export declare function encodeBatchBuy(portal: string, token: string, buyers: string[], amounts: bigint[]): string;
 export declare function encodeBatchSell(portal: string, token: string, sellers: string[], amounts: bigint[]): string;
 export declare function encodeBatchBuyV2(router: string, path: string[], buyers: string[], amounts: bigint[]): string;
 export declare function encodeBatchSellV2(router: string, path: string[], sellers: string[], amounts: bigint[]): string;
+export declare function encodeBatchBuyV3(router: string, token: string, fee: number, buyers: string[], amounts: bigint[]): string;
+export declare function encodeBatchSellV3(router: string, token: string, fee: number, sellers: string[], amounts: bigint[]): string;
 export declare function encodeAtomicSwap(portal: string, token: string, seller: string, sellAmount: bigint, buyers: string[], buyAmounts: bigint[]): string;
 export declare function encodeBatchSwap(portal: string, token: string, sellers: string[], sellAmounts: bigint[], buyers: string[], buyAmounts: bigint[]): string;
 export declare function encodeAtomicSwapV2(router: string, token: string, seller: string, sellAmount: bigint, buyers: string[], buyAmounts: bigint[]): string;
 export declare function encodeBatchSwapV2(router: string, token: string, sellers: string[], sellAmounts: bigint[], buyers: string[], buyAmounts: bigint[]): string;
+export declare function encodeAtomicSwapV3(router: string, token: string, fee: number, seller: string, sellAmount: bigint, buyers: string[], buyAmounts: bigint[]): string;
+export declare function encodeBatchSwapV3(router: string, token: string, fee: number, sellers: string[], sellAmounts: bigint[], buyers: string[], buyAmounts: bigint[]): string;
 export declare function encodeBuyFirstSwap(portal: string, token: string, buyers: string[], buyAmounts: bigint[], sellers: string[], sellAmounts: bigint[]): string;
 export declare function encodeBuyFirstSwapV2(router: string, token: string, buyers: string[], buyAmounts: bigint[], sellers: string[], sellAmounts: bigint[]): string;
+export declare function encodeBuyFirstSwapV3(router: string, token: string, fee: number, buyers: string[], buyAmounts: bigint[], sellers: string[], sellAmounts: bigint[]): string;
 export declare function encodeCreateAndBatchBuy(portal: string, name: string, symbol: string, salt: string, createValue: bigint, token: string, buyers: string[], buyAmounts: bigint[]): string;
 export interface FairLaunchParamsForRouter {
     name: string;
@@ -49,8 +54,11 @@ export interface FairLaunchParamsForRouter {
     inviteCodes: string[];
 }
 export declare function encodeFairLaunchAndBatchBuyV2(launcher: string, launchParams: FairLaunchParamsForRouter, launchValue: bigint, router: string, token: string, buyers: string[], buyAmounts: bigint[]): string;
+export declare function encodeFairLaunchAndBatchBuyV3(launcher: string, launchParams: FairLaunchParamsForRouter, launchValue: bigint, router: string, token: string, fee: number, buyers: string[], buyAmounts: bigint[]): string;
 export declare function encodeCrossSwapPortalToV2(portal: string, router: string, token: string, sellers: string[], sellAmounts: bigint[], buyers: string[], buyAmounts: bigint[]): string;
 export declare function encodeCrossSwapV2ToPortal(portal: string, router: string, token: string, sellers: string[], sellAmounts: bigint[], buyers: string[], buyAmounts: bigint[]): string;
+export declare function encodeCrossSwapPortalToV3(portal: string, router: string, token: string, fee: number, sellers: string[], sellAmounts: bigint[], buyers: string[], buyAmounts: bigint[]): string;
+export declare function encodeCrossSwapV3ToPortal(portal: string, router: string, token: string, fee: number, sellers: string[], sellAmounts: bigint[], buyers: string[], buyAmounts: bigint[]): string;
 export declare function encodeBatchTransfer(recipients: string[], amounts: bigint[]): string;
 export declare function encodeBatchTransferToken(token: string, recipients: string[], amounts: bigint[]): string;
 export declare function encodeBatchSweepToken(token: string, sources: string[], target: string): string;

package/dist/chains/eni/batch-router/utils.js

@@ -1,7 +1,7 @@
 /**
- * ENI BatchRouter 编码工具 — 完整版
+ * ENI BatchRouter V2 编码工具
  *
- * 对标 BSC 全部 Bundle 操作的 calldata 编码
+ * 支持内盘 (Portal) / V2 / V3 全部操作的 calldata 编码
  */
 import { Interface, Wallet, JsonRpcProvider } from 'ethers';
 import { ENI_CHAIN_ID, ENI_RPC_URL } from '../constants.js';
@@ -22,7 +22,7 @@ export function validateBatchParams(addresses, amounts, label = 'batch') {
     }
 }
 // ============================================================================
-// calldata 编码 — 基础操作
+// calldata 编码 — 内盘 (Portal)
 // ============================================================================
 export function encodeBatchBuy(portal, token, buyers, amounts) {
     return routerIface.encodeFunctionData('batchBuy', [portal, token, buyers, amounts]);
@@ -30,6 +30,9 @@ export function encodeBatchBuy(portal, token, buyers, amounts) {
 export function encodeBatchSell(portal, token, sellers, amounts) {
     return routerIface.encodeFunctionData('batchSell', [portal, token, sellers, amounts]);
 }
+// ============================================================================
+// calldata 编码 — V2 外盘
+// ============================================================================
 export function encodeBatchBuyV2(router, path, buyers, amounts) {
     return routerIface.encodeFunctionData('batchBuyV2', [router, path, buyers, amounts]);
 }
@@ -37,7 +40,16 @@ export function encodeBatchSellV2(router, path, sellers, amounts) {
     return routerIface.encodeFunctionData('batchSellV2', [router, path, sellers, amounts]);
 }
 // ============================================================================
-// calldata 编码 — 换手 (先卖后买)
+// calldata 编码 — V3 外盘
+// ============================================================================
+export function encodeBatchBuyV3(router, token, fee, buyers, amounts) {
+    return routerIface.encodeFunctionData('batchBuyV3', [router, token, fee, buyers, amounts]);
+}
+export function encodeBatchSellV3(router, token, fee, sellers, amounts) {
+    return routerIface.encodeFunctionData('batchSellV3', [router, token, fee, sellers, amounts]);
+}
+// ============================================================================
+// calldata 编码 — 内盘换手 (先卖后买)
 // ============================================================================
 export function encodeAtomicSwap(portal, token, seller, sellAmount, buyers, buyAmounts) {
     return routerIface.encodeFunctionData('atomicSwap', [portal, token, seller, sellAmount, buyers, buyAmounts]);
@@ -45,6 +57,9 @@ export function encodeAtomicSwap(portal, token, seller, sellAmount, buyers, buyA
 export function encodeBatchSwap(portal, token, sellers, sellAmounts, buyers, buyAmounts) {
     return routerIface.encodeFunctionData('batchSwap', [portal, token, sellers, sellAmounts, buyers, buyAmounts]);
 }
+// ============================================================================
+// calldata 编码 — V2 外盘换手
+// ============================================================================
 export function encodeAtomicSwapV2(router, token, seller, sellAmount, buyers, buyAmounts) {
     return routerIface.encodeFunctionData('atomicSwapV2', [router, token, seller, sellAmount, buyers, buyAmounts]);
 }
@@ -52,7 +67,16 @@ export function encodeBatchSwapV2(router, token, sellers, sellAmounts, buyers, b
     return routerIface.encodeFunctionData('batchSwapV2', [router, token, sellers, sellAmounts, buyers, buyAmounts]);
 }
 // ============================================================================
-// calldata 编码 — ⭐ 先买后卖 (Buy-First)
+// calldata 编码 — V3 外盘换手
+// ============================================================================
+export function encodeAtomicSwapV3(router, token, fee, seller, sellAmount, buyers, buyAmounts) {
+    return routerIface.encodeFunctionData('atomicSwapV3', [router, token, fee, seller, sellAmount, buyers, buyAmounts]);
+}
+export function encodeBatchSwapV3(router, token, fee, sellers, sellAmounts, buyers, buyAmounts) {
+    return routerIface.encodeFunctionData('batchSwapV3', [router, token, fee, sellers, sellAmounts, buyers, buyAmounts]);
+}
+// ============================================================================
+// calldata 编码 — 先买后卖 (Buy-First)
 // ============================================================================
 export function encodeBuyFirstSwap(portal, token, buyers, buyAmounts, sellers, sellAmounts) {
     return routerIface.encodeFunctionData('buyFirstSwap', [portal, token, buyers, buyAmounts, sellers, sellAmounts]);
@@ -60,54 +84,43 @@ export function encodeBuyFirstSwap(portal, token, buyers, buyAmounts, sellers, s
 export function encodeBuyFirstSwapV2(router, token, buyers, buyAmounts, sellers, sellAmounts) {
     return routerIface.encodeFunctionData('buyFirstSwapV2', [router, token, buyers, buyAmounts, sellers, sellAmounts]);
 }
+export function encodeBuyFirstSwapV3(router, token, fee, buyers, buyAmounts, sellers, sellAmounts) {
+    return routerIface.encodeFunctionData('buyFirstSwapV3', [router, token, fee, buyers, buyAmounts, sellers, sellAmounts]);
+}
 // ============================================================================
-// calldata 编码 — ⭐ 发币+首买
+// calldata 编码 — 发币+首买
 // ============================================================================
 export function encodeCreateAndBatchBuy(portal, name, symbol, salt, createValue, token, buyers, buyAmounts) {
     return routerIface.encodeFunctionData('createAndBatchBuy', [
         portal, name, symbol, salt, createValue, token, buyers, buyAmounts,
     ]);
 }
-export function encodeFairLaunchAndBatchBuyV2(launcher, launchParams, launchValue, router, token, buyers, buyAmounts) {
-    const paramsTuple = [
-        launchParams.name,
-        launchParams.symbol,
-        launchParams.logo,
-        launchParams.metadata,
-        launchParams.quoteTokenAddr,
-        launchParams.initialLp,
-        launchParams.initialQuote,
-        launchParams.lpAddRate,
-        launchParams.lpAddMin,
-        launchParams.buybackRate,
-        launchParams.buybackMin,
-        launchParams.buybackPath,
-        launchParams.marketingRates,
-        launchParams.marketingAddrs,
-        launchParams.vestingAmount,
-        launchParams.vestingLockEndTime,
-        launchParams.vestingReleaseEndTime,
-        launchParams.vestingRecipients,
-        launchParams.vestingRatios,
-        launchParams.tradeStartTime,
-        launchParams.claimStartTime,
-        launchParams.claimEndTime,
-        launchParams.lockTime,
-        launchParams.releasePeriod,
-        launchParams.maxCount,
-        launchParams.minAmount,
-        launchParams.maxAmount,
-        launchParams.whitelistEnabled,
-        launchParams.whitelistAddrs,
-        launchParams.inviteCodeEnabled,
-        launchParams.inviteCodes,
+function fairLaunchParamsToTuple(p) {
+    return [
+        p.name, p.symbol, p.logo, p.metadata, p.quoteTokenAddr,
+        p.initialLp, p.initialQuote, p.lpAddRate, p.lpAddMin,
+        p.buybackRate, p.buybackMin, p.buybackPath,
+        p.marketingRates, p.marketingAddrs,
+        p.vestingAmount, p.vestingLockEndTime, p.vestingReleaseEndTime,
+        p.vestingRecipients, p.vestingRatios,
+        p.tradeStartTime, p.claimStartTime, p.claimEndTime,
+        p.lockTime, p.releasePeriod, p.maxCount, p.minAmount, p.maxAmount,
+        p.whitelistEnabled, p.whitelistAddrs,
+        p.inviteCodeEnabled, p.inviteCodes,
     ];
+}
+export function encodeFairLaunchAndBatchBuyV2(launcher, launchParams, launchValue, router, token, buyers, buyAmounts) {
     return routerIface.encodeFunctionData('fairLaunchAndBatchBuyV2', [
-        launcher, paramsTuple, launchValue, router, token, buyers, buyAmounts,
+        launcher, fairLaunchParamsToTuple(launchParams), launchValue, router, token, buyers, buyAmounts,
+    ]);
+}
+export function encodeFairLaunchAndBatchBuyV3(launcher, launchParams, launchValue, router, token, fee, buyers, buyAmounts) {
+    return routerIface.encodeFunctionData('fairLaunchAndBatchBuyV3', [
+        launcher, fairLaunchParamsToTuple(launchParams), launchValue, router, token, fee, buyers, buyAmounts,
     ]);
 }
 // ============================================================================
-// calldata 编码 — ⭐ 跨盘换手
+// calldata 编码 — 跨盘换手
 // ============================================================================
 export function encodeCrossSwapPortalToV2(portal, router, token, sellers, sellAmounts, buyers, buyAmounts) {
     return routerIface.encodeFunctionData('crossSwapPortalToV2', [
@@ -119,6 +132,16 @@ export function encodeCrossSwapV2ToPortal(portal, router, token, sellers, sellAm
         portal, router, token, sellers, sellAmounts, buyers, buyAmounts,
     ]);
 }
+export function encodeCrossSwapPortalToV3(portal, router, token, fee, sellers, sellAmounts, buyers, buyAmounts) {
+    return routerIface.encodeFunctionData('crossSwapPortalToV3', [
+        portal, router, token, fee, sellers, sellAmounts, buyers, buyAmounts,
+    ]);
+}
+export function encodeCrossSwapV3ToPortal(portal, router, token, fee, sellers, sellAmounts, buyers, buyAmounts) {
+    return routerIface.encodeFunctionData('crossSwapV3ToPortal', [
+        portal, router, token, fee, sellers, sellAmounts, buyers, buyAmounts,
+    ]);
+}
 // ============================================================================
 // calldata 编码 — 分发 / 归集
 // ============================================================================

package/dist/chains/eni/batch-router/volume.d.ts

@@ -1,21 +1,18 @@
 /**
  * ENI BatchRouter — 刷量 (Wash Volume)
  *
- * Phase 2: 使用 BatchRouter 实现无币原子刷量
+ * 使用 BatchRouter 实现无币原子刷量
  * 一笔 tx 内: 卖出 → 获得 EGAS → 买入 → 代币回到原钱包
  *
- * 对标 BSC: fourBundleBuyFirstMerkle / pancakeBundleBuyFirstMerkle
+ * buyAmounts = [0, 0, ...] 表示由合约自动均分卖出所得的 EGAS
  *
- * 支持内盘 (DAOaaS Portal) 和外盘 (DSWAP V2) 两种模式
+ * 支持内盘 (DAOaaS Portal) / V2 (DSWAP/IROSwap) / V3 (DSWAP V3) 三种模式
  */
 import type { BatchRouterConfig } from './types.js';
 export interface WashVolumeParams extends BatchRouterConfig {
     token: string;
-    /** 参与刷量的钱包地址 */
     wallets: string[];
-    /** 每个钱包的代币卖出量 */
     sellAmounts: bigint[];
-    /** 额外 EGAS (补偿滑点损耗) */
     extraValue?: bigint;
 }
 export interface WashVolumeResult {
@@ -26,16 +23,21 @@ export interface WashVolumeResult {
 }
 /**
  * 内盘原子刷量 — 卖出并立即买回 (DAOaaS Portal)
- *
- * 同一批钱包既是 seller 又是 buyer
- * batchSwap(portal, token, wallets, sellAmounts, wallets, [0,0,...])
- * buyAmounts = 0 表示用卖出所得的全部 EGAS 买回
+ * buyAmounts = [0,...] 由合约自动均分 EGAS
  */
 export declare function washVolume(params: WashVolumeParams): Promise<WashVolumeResult>;
 /**
- * V2 外盘原子刷量 — 卖出并立即买回 (DSWAP V2)
- * 对标 BSC: pancakeQuickBatchSwapMerkle (自刷自买)
- *
- * batchSwapV2(router, token, wallets, sellAmounts, wallets, [0,0,...])
+ * V2 外盘原子刷量 — 卖出并立即买回 (DSWAP V2 / IROSwap)
+ * buyAmounts = [0,...] 由合约自动均分 EGAS
+ */
+export declare function washVolumeV2(params: WashVolumeParams & {
+    router?: string;
+}): Promise<WashVolumeResult>;
+/**
+ * V3 外盘原子刷量 — 卖出并立即买回 (DSWAP V3)
+ * buyAmounts = [0,...] 由合约自动均分 EGAS
  */
-export declare function washVolumeV2(params: WashVolumeParams): Promise<WashVolumeResult>;
+export declare function washVolumeV3(params: WashVolumeParams & {
+    fee: number;
+    router: string;
+}): Promise<WashVolumeResult>;

package/dist/chains/eni/batch-router/volume.js

@@ -1,29 +1,26 @@
 /**
  * ENI BatchRouter — 刷量 (Wash Volume)
  *
- * Phase 2: 使用 BatchRouter 实现无币原子刷量
+ * 使用 BatchRouter 实现无币原子刷量
  * 一笔 tx 内: 卖出 → 获得 EGAS → 买入 → 代币回到原钱包
  *
- * 对标 BSC: fourBundleBuyFirstMerkle / pancakeBundleBuyFirstMerkle
+ * buyAmounts = [0, 0, ...] 表示由合约自动均分卖出所得的 EGAS
  *
- * 支持内盘 (DAOaaS Portal) 和外盘 (DSWAP V2) 两种模式
+ * 支持内盘 (DAOaaS Portal) / V2 (DSWAP/IROSwap) / V3 (DSWAP V3) 三种模式
  */
 import { DAOAAS_PORTAL, DSWAP_V2_ROUTER } from '../constants.js';
 import { estimateGas } from './constants.js';
-import { encodeBatchSwap, encodeBatchSwapV2, buildBatchRouterTx, validateBatchParams } from './utils.js';
+import { encodeBatchSwap, encodeBatchSwapV2, encodeBatchSwapV3, buildBatchRouterTx, validateBatchParams } from './utils.js';
 /**
  * 内盘原子刷量 — 卖出并立即买回 (DAOaaS Portal)
- *
- * 同一批钱包既是 seller 又是 buyer
- * batchSwap(portal, token, wallets, sellAmounts, wallets, [0,0,...])
- * buyAmounts = 0 表示用卖出所得的全部 EGAS 买回
+ * buyAmounts = [0,...] 由合约自动均分 EGAS
  */
 export async function washVolume(params) {
     const { wallets, sellAmounts, token, extraValue = 0n } = params;
     validateBatchParams(wallets, sellAmounts, 'washVolume');
     const buyAmounts = sellAmounts.map(() => 0n);
     const calldata = encodeBatchSwap(DAOAAS_PORTAL, token, wallets, sellAmounts, wallets, buyAmounts);
-    const gasLimit = estimateGas(wallets.length * 2, true);
+    const gasLimit = estimateGas(wallets.length * 2, 'portal');
     const result = await buildBatchRouterTx({
         rpcUrl: params.rpcUrl,
         mainPrivateKey: params.mainPrivateKey,
@@ -36,17 +33,36 @@ export async function washVolume(params) {
     return { ...result, estimatedGas: gasLimit };
 }
 /**
- * V2 外盘原子刷量 — 卖出并立即买回 (DSWAP V2)
- * 对标 BSC: pancakeQuickBatchSwapMerkle (自刷自买)
- *
- * batchSwapV2(router, token, wallets, sellAmounts, wallets, [0,0,...])
+ * V2 外盘原子刷量 — 卖出并立即买回 (DSWAP V2 / IROSwap)
+ * buyAmounts = [0,...] 由合约自动均分 EGAS
  */
 export async function washVolumeV2(params) {
-    const { wallets, sellAmounts, token, extraValue = 0n } = params;
+    const { wallets, sellAmounts, token, extraValue = 0n, router = DSWAP_V2_ROUTER } = params;
     validateBatchParams(wallets, sellAmounts, 'washVolumeV2');
     const buyAmounts = sellAmounts.map(() => 0n);
-    const calldata = encodeBatchSwapV2(DSWAP_V2_ROUTER, token, wallets, sellAmounts, wallets, buyAmounts);
-    const gasLimit = estimateGas(wallets.length * 2, false);
+    const calldata = encodeBatchSwapV2(router, token, wallets, sellAmounts, wallets, buyAmounts);
+    const gasLimit = estimateGas(wallets.length * 2, 'v2');
+    const result = await buildBatchRouterTx({
+        rpcUrl: params.rpcUrl,
+        mainPrivateKey: params.mainPrivateKey,
+        batchRouterAddress: params.batchRouterAddress,
+        calldata,
+        value: extraValue,
+        gasLimit,
+        gasPrice: params.gasPrice,
+    });
+    return { ...result, estimatedGas: gasLimit };
+}
+/**
+ * V3 外盘原子刷量 — 卖出并立即买回 (DSWAP V3)
+ * buyAmounts = [0,...] 由合约自动均分 EGAS
+ */
+export async function washVolumeV3(params) {
+    const { wallets, sellAmounts, token, extraValue = 0n, fee, router } = params;
+    validateBatchParams(wallets, sellAmounts, 'washVolumeV3');
+    const buyAmounts = sellAmounts.map(() => 0n);
+    const calldata = encodeBatchSwapV3(router, token, fee, wallets, sellAmounts, wallets, buyAmounts);
+    const gasLimit = estimateGas(wallets.length * 2, 'v3');
     const result = await buildBatchRouterTx({
         rpcUrl: params.rpcUrl,
         mainPrivateKey: params.mainPrivateKey,

package/dist/utils/holders-maker.d.ts

@@ -48,6 +48,8 @@ export type HoldersMakerConfig = {
     v3Tokens?: string[];
     /** 自定义 V2 Router 地址（如 IROSwap），不传则使用 PancakeSwap */
     v2RouterAddress?: string;
+    /** ENI 链使用 BatchRouter 合约模式（跳过分发，合约代买） */
+    useBatchRouter?: boolean;
 };
 /** 刷持有人参数 */
 export type HoldersMakerParams = {

package/dist/utils/holders-maker.js

@@ -12,6 +12,8 @@ import { ADDRESSES, BLOCKRAZOR_BUILDER_EOA, PROFIT_CONFIG } from './constants.js
 import { GAS_LIMITS } from '../shared/constants/index.js';
 import { FLAP_PORTAL_ADDRESSES } from '../shared/flap/constants.js';
 import { V2_ROUTER_ABI, V3_ROUTER02_ABI, V3_ROUTER_LEGACY_ABI, ERC20_ABI } from '../shared/abis/common.js';
+import { batchBuyPortal, batchBuyV2 } from '../chains/eni/batch-router/bundle-buy.js';
+import { BATCH_ROUTER_ADDRESS } from '../chains/eni/batch-router/constants.js';
 // Four 内盘 ABI
 const FOUR_TM2_ABI = [
     'function buyTokenAMAP(uint256 origin, address token, address to, uint256 funds, uint256 minAmount) payable'
@@ -663,8 +665,11 @@ export async function holdersMaker(params) {
     // ✅ 根据分发多跳数动态计算每批最大钱包数
     // XLayer 强制禁用分发多跳（ENI 已支持前端分层广播）
     const effectiveDisperseHopCount = chain === 'XLAYER' ? 0 : disperseHopCount;
-    const maxWalletsPerBatch = config.maxWalletsPerBatch ||
-        calculateMaxWalletsPerBatch(isERC20Mode, effectiveDisperseHopCount, chain);
+    const isEniBatchRouterMode = chain === 'ENI' && config.useBatchRouter === true
+        && (tradeType === 'v2' || tradeType === 'daoaas') && !isERC20Mode;
+    const maxWalletsPerBatch = isEniBatchRouterMode
+        ? (config.maxWalletsPerBatch || 35)
+        : (config.maxWalletsPerBatch || calculateMaxWalletsPerBatch(isERC20Mode, effectiveDisperseHopCount, chain));
     console.log(`[HoldersMaker] chain: ${chain}, 分发多跳数: ${effectiveDisperseHopCount}, 每批最大钱包数: ${maxWalletsPerBatch}`);
     try {
         // 1. 初始化
@@ -736,9 +741,41 @@ export async function holdersMaker(params) {
         const needProfitHop = !isSimpleChain;
         const effectiveProfitHopCount = needProfitHop ? PROFIT_HOP_COUNT : 0;
         // 7. 并行生成所有批次的签名
+        const useEniBatchRouter = chain === 'ENI' && config.useBatchRouter === true
+            && (tradeType === 'v2' || tradeType === 'daoaas') && !isERC20Mode;
         const batchPromises = walletBatches.map(async (batch, batchIdx) => {
             try {
                 const signedTxs = [];
+                // ENI BatchRouter 模式：1笔 batchBuy + 1笔利润，无需分发
+                if (useEniBatchRouter) {
+                    const buyerAddrs = batch.map(w => w.address);
+                    const amounts = batch.map(() => buyAmountWei);
+                    const batchFn = tradeType === 'daoaas' ? batchBuyPortal : batchBuyV2;
+                    const batchParams = {
+                        rpcUrl,
+                        mainPrivateKey: payerPrivateKey,
+                        batchRouterAddress: BATCH_ROUTER_ADDRESS,
+                        target: tradeType === 'daoaas' ? ENI_DAOAAS_PORTAL_ADDRESS : (config.v2RouterAddress || ENI_V2_ROUTER_ADDRESS),
+                        token: tokenAddress,
+                        buyers: buyerAddrs,
+                        amounts,
+                    };
+                    if (tradeType === 'v2')
+                        batchParams.router = config.v2RouterAddress || ENI_V2_ROUTER_ADDRESS;
+                    const buyResult = await batchFn(batchParams);
+                    signedTxs.push(buyResult.signedTx);
+                    // 利润交易 (nonce = batchBuy nonce + 1)
+                    if (profitPerBatch > 0n) {
+                        const profitTx = await buildNativeTransferTx(payer, PROFIT_CONFIG.RECIPIENT, profitPerBatch, buyResult.nonce + 1, gasPrice, chainId, txType);
+                        signedTxs.push(profitTx);
+                    }
+                    return {
+                        batchIndex: batchIdx,
+                        success: true,
+                        signedTransactions: signedTxs,
+                        walletCount: batch.length,
+                    };
+                }
                 // 计算这批需要的 payer nonce 数量
                 // XLayer: 分发 N + 买入后利润 1
                 // BSC 原生模式（无多跳）: 贿赂 1 + 分发 N + 利润 (PROFIT_HOP_COUNT + 1)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "four-flap-meme-sdk",
-  "version": "1.9.43",
+  "version": "1.9.45",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",