four-flap-meme-sdk 2.2.19 → 3.0.0

package/dist/chains/xlayer/eoa/dex-helpers.js

@@ -1,7 +1,8 @@
 /**
  * XLayer AA DEX 工具函数
  */
-import { PROFIT_CONFIG } from '../../../utils/constants.js';
+import { getProfitRecipient, getProfitRateBps, ADDRESSES } from '../../../core/constants/index.js';
+export { splitAmountByWeight as splitAmount } from '../../../core/amount/split-by-weight.js';
 export function getDexDeadline(minutes = 20) {
     return Math.floor(Date.now() / 1000) + minutes * 60;
 }
@@ -14,53 +15,22 @@ export function calculateProfitWei(amountWei, profitBps) {
 }
 export function resolveProfitSettings(config) {
     const extractProfit = config?.extractProfit !== false;
-    const profitBpsRaw = config?.profitBps ?? PROFIT_CONFIG.RATE_BPS_SWAP;
-    const profitBps = Math.max(0, Math.min(10000, Number(profitBpsRaw)));
-    const profitRecipient = config?.profitRecipient ?? PROFIT_CONFIG.RECIPIENT;
+    const profitBpsRaw = config?.profitBps ?? getProfitRateBps('bundleSwap');
+    const profitBps = Math.max(0, Math.min(10_000, Number(profitBpsRaw)));
+    const profitRecipient = config?.profitRecipient ?? getProfitRecipient();
     return { extractProfit, profitBps, profitRecipient };
 }
-function shuffle(arr) {
-    const a = arr.slice();
-    for (let i = a.length - 1; i > 0; i--) {
-        const j = Math.floor(Math.random() * (i + 1));
-        [a[i], a[j]] = [a[j], a[i]];
-    }
-    return a;
-}
-export function splitAmount(totalAmount, count) {
-    if (count <= 0)
-        throw new Error('拆分份数必须大于 0');
-    if (count === 1)
-        return [totalAmount];
-    if (totalAmount <= 0n)
-        return new Array(count).fill(0n);
-    const weights = [];
-    for (let i = 0; i < count; i++) {
-        const w = BigInt(500000 + Math.floor(Math.random() * 1000000));
-        weights.push(w);
-    }
-    const totalWeight = weights.reduce((a, b) => a + b, 0n);
-    const amounts = [];
-    let allocated = 0n;
-    for (let i = 0; i < count - 1; i++) {
-        const amt = (totalAmount * weights[i]) / totalWeight;
-        amounts.push(amt);
-        allocated += amt;
-    }
-    amounts.push(totalAmount - allocated);
-    return shuffle(amounts);
-}
 export function getEffectiveRouter(params, defaultRouter) {
     // 优先使用显式指定的地址
     if (params.routerAddress)
         return params.routerAddress;
     // 根据 dexKey 选择
     if (params.dexKey === 'DYORSWAP') {
-        return '0xfb001fbbace32f09cb6d3c449b935183de53ee96';
+        return ADDRESSES.XLAYER.DyorSwapRouter;
     }
     // 根据 routerVersion 选择
     if (params.routerVersion === 'V3') {
-        return '0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41'; // POTATOSWAP_V3_ROUTER
+        return ADDRESSES.XLAYER.PotatoSwapV3Router;
     }
     // 默认使用传入的 defaultRouter（通常是 V2）
     return defaultRouter;

package/dist/chains/xlayer/eoa/eoa-bundle-swap-helpers.d.ts

@@ -0,0 +1,126 @@
+import { ethers, Wallet, JsonRpcProvider } from 'ethers';
+import { type GeneratedWallet } from '../../../utils/wallet.js';
+/**
+
+ * XLayer EOA 模式批量换手
+
+ *
+
+ * 专门为 XLayer 链设计，不影响 BSC 链的逻辑
+
+ * - 使用 PotatoSwap V3 Quoter
+
+ * - 使用 WOKB 作为 Wrapped Native Token
+
+ * - 支持多跳转账和利润刮取
+
+ */
+export declare const XLAYER_CHAIN_ID: 196;
+export declare const WOKB_ADDRESS: string;
+export declare const POTATO_V2_ROUTER: string;
+export declare const POTATO_V3_ROUTER: string;
+export declare const NATIVE_TRANSFER_GAS_LIMIT: 21055n;
+export { ZERO_ADDRESS } from '../../../core/constants/index.js';
+export type UserType = 'v0' | 'v1';
+export type SwapRouteType = 'v2' | 'v3-single' | 'v3-multi';
+export interface V2RouteParams {
+    routeType: 'v2';
+    v2Path: string[];
+}
+export interface V3SingleRouteParams {
+    routeType: 'v3-single';
+    v3TokenIn: string;
+    v3TokenOut: string;
+    v3Fee: number;
+    v2Path?: string[];
+}
+export interface V3MultiRouteParams {
+    routeType: 'v3-multi';
+    v3LpAddresses: string[];
+    v3ExactTokenIn: string;
+    v2Path?: string[];
+}
+export type RouteParams = V2RouteParams | V3SingleRouteParams | V3MultiRouteParams;
+export interface XLayerEoaSwapConfig {
+    rpcUrl: string;
+    gasLimit?: number | bigint;
+    gasLimitMultiplier?: number;
+    minGasPriceGwei?: number;
+    maxGasPriceGwei?: number;
+    txType?: 0 | 2;
+    reserveGasBNB?: number;
+    userType?: UserType;
+    bribeAmount?: number;
+}
+export interface XLayerQuickBatchSwapParams {
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKeys: string[];
+    buyerRatios?: number[];
+    buyerAmounts?: string[];
+    tokenAddress: string;
+    routeParams: RouteParams;
+    config: XLayerEoaSwapConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    disperseHopCount?: number;
+    startNonces?: number[];
+}
+export interface XLayerQuickBatchSwapResult {
+    signedTransactions: string[];
+    disperseHopWallets?: GeneratedWallet[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        sellerAddress: string;
+        buyerAddresses: string[];
+        sellAmount: string;
+        estimatedOutput: string;
+        transferAmounts: string[];
+        profitAmount?: string;
+        useNativeToken: boolean;
+        disperseHopCount?: number;
+    };
+}
+export interface XLayerCrossSwapParams {
+    sellerPrivateKeys: string[];
+    sellAmounts: string[];
+    buyerPrivateKeys: string[];
+    tokenAddress: string;
+    routeParams: RouteParams;
+    config: XLayerEoaSwapConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    buyersPerSell?: number;
+    disperseHopCount?: number;
+    /** ✅ 预获取的 nonce（地址 -> nonce），避免 nonce 不同步 */
+    startNonces?: Map<string, number>;
+}
+export interface XLayerCrossSwapResult {
+    signedTransactions: string[];
+    rounds: Array<{
+        sellerAddress: string;
+        buyerAddresses: string[];
+        sellAmount: string;
+        bundleHash?: string;
+    }>;
+    disperseHopWallets?: GeneratedWallet[];
+    profitHopWallets?: GeneratedWallet[];
+}
+export declare function createXLayerContext(config: XLayerEoaSwapConfig): {
+    chainId: 196;
+    provider: ethers.JsonRpcProvider;
+};
+export declare function getGasLimit(config: XLayerEoaSwapConfig, defaultGas?: number): bigint;
+export declare function getGasPrice(provider: JsonRpcProvider, config: XLayerEoaSwapConfig): Promise<bigint>;
+export declare function getProfitRateBps(userType?: UserType): number;
+export declare function calculateProfitAmount(estimatedOutput: bigint, userType?: UserType): bigint;
+export declare function quoteSellOutput(provider: JsonRpcProvider, routeParams: RouteParams, sellAmountWei: bigint): Promise<bigint>;
+export declare function getERC20ToOkbQuote(provider: JsonRpcProvider, tokenAddress: string, tokenAmount: bigint, version?: 'v2' | 'v3', fee?: number): Promise<bigint>;
+export type DisperseHopPath = {
+    targetAddress: string;
+    hopWallets: Wallet[];
+    hopWalletsInfo: GeneratedWallet[];
+};
+export declare function generateDisperseHopPaths(targetAddresses: string[], hopCount: number, provider: JsonRpcProvider): DisperseHopPath[];
+export declare function buildNativeHopChain(payer: Wallet, path: DisperseHopPath, finalAmount: bigint, gasPrice: bigint, txType: 0 | 2, payerNonce: number): Promise<string[]>;

package/dist/chains/xlayer/eoa/eoa-bundle-swap-helpers.js

@@ -0,0 +1,228 @@
+import { ethers, Wallet } from 'ethers';
+import { createXLayerProvider } from '../../../utils/provider-factory.js';
+import { GAS_LIMITS, CHAINS, getProfitRateBps as getSharedProfitRateBps } from '../../../core/constants/index.js';
+import { quoteV2, quoteV3 } from '../../../domains/quote/quote-helpers.js';
+import { generateWallets } from '../../../utils/wallet.js';
+import { WOKB, POTATOSWAP_V2_ROUTER, POTATOSWAP_SWAP_ROUTER02 } from './constants.js';
+/**
+
+ * XLayer EOA 模式批量换手
+
+ *
+
+ * 专门为 XLayer 链设计，不影响 BSC 链的逻辑
+
+ * - 使用 PotatoSwap V3 Quoter
+
+ * - 使用 WOKB 作为 Wrapped Native Token
+
+ * - 支持多跳转账和利润刮取
+
+ */
+// ✅ 从 XLayer 常量导入正确的路由地址
+// ==================== XLayer 专用常量 ====================
+export const XLAYER_CHAIN_ID = CHAINS.XLAYER.chainId;
+const XLAYER_CHAIN_NAME = CHAINS.XLAYER.name;
+export const WOKB_ADDRESS = ethers.getAddress(WOKB);
+// ✅ 强制校验和，避免大小写错误导致的 bad address checksum
+export const POTATO_V2_ROUTER = ethers.getAddress(POTATOSWAP_V2_ROUTER);
+export const POTATO_V3_ROUTER = ethers.getAddress(POTATOSWAP_SWAP_ROUTER02); // ✅ SwapRouter02 用于 V3 交易
+export const NATIVE_TRANSFER_GAS_LIMIT = GAS_LIMITS.NATIVE_TRANSFER;
+export { ZERO_ADDRESS } from '../../../core/constants/index.js';
+// ==================== 工具函数 ====================
+export function createXLayerContext(config) {
+    const provider = createXLayerProvider(config.rpcUrl);
+    return { chainId: XLAYER_CHAIN_ID, provider };
+}
+export function getGasLimit(config, defaultGas = 800000) {
+    if (config.gasLimit !== undefined) {
+        return typeof config.gasLimit === 'bigint' ? config.gasLimit : BigInt(config.gasLimit);
+    }
+    const multiplier = config.gasLimitMultiplier ?? 1.0;
+    return BigInt(Math.ceil(defaultGas * multiplier));
+}
+export async function getGasPrice(provider, config) {
+    const feeData = await provider.getFeeData();
+    let gasPrice = feeData.gasPrice || ethers.parseUnits('0.1', 'gwei');
+    if (config.minGasPriceGwei) {
+        const minGas = ethers.parseUnits(config.minGasPriceGwei.toString(), 'gwei');
+        if (gasPrice < minGas)
+            gasPrice = minGas;
+    }
+    if (config.maxGasPriceGwei) {
+        const maxGas = ethers.parseUnits(config.maxGasPriceGwei.toString(), 'gwei');
+        if (gasPrice > maxGas)
+            gasPrice = maxGas;
+    }
+    return gasPrice;
+}
+export function getProfitRateBps(userType) {
+    if (userType === 'v0')
+        return getSharedProfitRateBps('v0Single');
+    if (userType === 'v1')
+        return getSharedProfitRateBps('v1Single');
+    return getSharedProfitRateBps('v0Single');
+}
+export function calculateProfitAmount(estimatedOutput, userType) {
+    if (estimatedOutput <= 0n)
+        return 0n;
+    const rateBps = getProfitRateBps(userType);
+    return (estimatedOutput * BigInt(rateBps)) / 10000n;
+}
+// ==================== 报价函数 ====================
+export async function quoteSellOutput(provider, routeParams, sellAmountWei) {
+    if (routeParams.routeType === 'v2') {
+        const { v2Path } = routeParams;
+        const tokenIn = v2Path[0];
+        const tokenOut = v2Path[v2Path.length - 1];
+        const result = await quoteV2(provider, tokenIn, tokenOut, sellAmountWei, XLAYER_CHAIN_NAME);
+        if (result.amountOut > 0n) {
+            return result.amountOut;
+        }
+        throw new Error('V2 报价失败');
+    }
+    if (routeParams.routeType === 'v3-single') {
+        const params = routeParams;
+        const result = await quoteV3(provider, params.v3TokenIn, params.v3TokenOut, sellAmountWei, XLAYER_CHAIN_NAME, params.v3Fee);
+        if (result.amountOut > 0n) {
+            return result.amountOut;
+        }
+        // ❗️兜底：如果 V3 报价失败且提供了 v2Path，则尝试 V2 报价（避免因为无对应费率池导致失败）
+        if (params.v2Path && params.v2Path.length >= 2) {
+            const tokenIn = params.v2Path[0];
+            const tokenOut = params.v2Path[params.v2Path.length - 1];
+            const v2Result = await quoteV2(provider, tokenIn, tokenOut, sellAmountWei, XLAYER_CHAIN_NAME);
+            if (v2Result.amountOut > 0n) {
+                return v2Result.amountOut;
+            }
+        }
+        throw new Error(`V3 单跳报价失败: tokenIn=${params.v3TokenIn}, tokenOut=${params.v3TokenOut}, fee=${params.v3Fee}`);
+    }
+    if (routeParams.routeType === 'v3-multi') {
+        const params = routeParams;
+        const tokenIn = params.v3ExactTokenIn;
+        const result = await quoteV3(provider, tokenIn, WOKB_ADDRESS, sellAmountWei, XLAYER_CHAIN_NAME);
+        if (result.amountOut > 0n) {
+            return result.amountOut;
+        }
+        // ❗️兜底：如果 V3 多跳失败且提供 v2Path，则尝试 V2 报价
+        if (params.v2Path && params.v2Path.length >= 2) {
+            const tokenInV2 = params.v2Path[0];
+            const tokenOutV2 = params.v2Path[params.v2Path.length - 1];
+            const v2Result = await quoteV2(provider, tokenInV2, tokenOutV2, sellAmountWei, XLAYER_CHAIN_NAME);
+            if (v2Result.amountOut > 0n) {
+                return v2Result.amountOut;
+            }
+        }
+        throw new Error(`V3 多跳报价失败`);
+    }
+    // ✅ 用类型判断收窄 RouteParams 联合类型
+    const routeType = routeParams.routeType ??
+        routeParams.routeType ??
+        routeParams.routeType;
+    throw new Error(`不支持的路由类型: ${routeType}`);
+}
+export async function getERC20ToOkbQuote(provider, tokenAddress, tokenAmount, version = 'v2', fee) {
+    if (tokenAmount <= 0n)
+        return 0n;
+    const tokenLower = tokenAddress.toLowerCase();
+    const wokbLower = WOKB_ADDRESS.toLowerCase();
+    if (tokenLower === wokbLower)
+        return tokenAmount;
+    if (version === 'v3') {
+        const result = await quoteV3(provider, tokenAddress, WOKB_ADDRESS, tokenAmount, XLAYER_CHAIN_NAME, fee);
+        if (result.amountOut > 0n) {
+            return result.amountOut;
+        }
+        return 0n;
+    }
+    const result = await quoteV2(provider, tokenAddress, WOKB_ADDRESS, tokenAmount, XLAYER_CHAIN_NAME);
+    if (result.amountOut > 0n) {
+        return result.amountOut;
+    }
+    return 0n;
+}
+export function generateDisperseHopPaths(targetAddresses, hopCount, provider) {
+    if (hopCount <= 0) {
+        return targetAddresses.map((addr) => ({
+            targetAddress: addr,
+            hopWallets: [],
+            hopWalletsInfo: [],
+        }));
+    }
+    return targetAddresses.map((targetAddress) => {
+        const hopWalletsInfo = generateWallets(hopCount);
+        const hopWallets = hopWalletsInfo.map((w) => new Wallet(w.privateKey, provider));
+        return { targetAddress, hopWallets, hopWalletsInfo };
+    });
+}
+export async function buildNativeHopChain(payer, path, finalAmount, gasPrice, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    if (hopCount === 0) {
+        const tx = {
+            to: path.targetAddress,
+            value: finalAmount,
+            nonce: payerNonce,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            chainId: XLAYER_CHAIN_ID,
+            type: txType,
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await payer.signTransaction(tx));
+        return signedTxs;
+    }
+    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
+    const amountsPerHop = [];
+    for (let i = 0; i < hopCount; i++) {
+        const remainingHops = hopCount - i;
+        amountsPerHop.push(finalAmount + hopGasCost * BigInt(remainingHops));
+    }
+    // payer → hop1
+    const firstTx = {
+        to: path.hopWallets[0].address,
+        value: amountsPerHop[0],
+        nonce: payerNonce,
+        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+        chainId: XLAYER_CHAIN_ID,
+        type: txType,
+    };
+    if (txType === 2) {
+        firstTx.maxFeePerGas = gasPrice;
+        firstTx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+    }
+    else {
+        firstTx.gasPrice = gasPrice;
+    }
+    signedTxs.push(await payer.signTransaction(firstTx));
+    // hop1 → hop2 → ... → target
+    for (let i = 0; i < hopCount; i++) {
+        const fromWallet = path.hopWallets[i];
+        const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
+        const amount = i === hopCount - 1 ? finalAmount : amountsPerHop[i + 1];
+        const tx = {
+            to: toAddress,
+            value: amount,
+            nonce: 0,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            chainId: XLAYER_CHAIN_ID,
+            type: txType,
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await fromWallet.signTransaction(tx));
+    }
+    return signedTxs;
+}
+// ==================== XLayer 快捷批量换手 ====================

package/dist/chains/xlayer/eoa/eoa-bundle-swap.d.ts

@@ -1,98 +1,4 @@
-/**
- * XLayer EOA 模式批量换手
- *
- * 专门为 XLayer 链设计，不影响 BSC 链的逻辑
- * - 使用 PotatoSwap V3 Quoter
- * - 使用 WOKB 作为 Wrapped Native Token
- * - 支持多跳转账和利润刮取
- */
-import { type GeneratedWallet } from '../../../utils/wallet.js';
-export type UserType = 'v0' | 'v1';
-export type SwapRouteType = 'v2' | 'v3-single' | 'v3-multi';
-export interface V2RouteParams {
-    routeType: 'v2';
-    v2Path: string[];
-}
-export interface V3SingleRouteParams {
-    routeType: 'v3-single';
-    v3TokenIn: string;
-    v3TokenOut: string;
-    v3Fee: number;
-    v2Path?: string[];
-}
-export interface V3MultiRouteParams {
-    routeType: 'v3-multi';
-    v3LpAddresses: string[];
-    v3ExactTokenIn: string;
-    v2Path?: string[];
-}
-export type RouteParams = V2RouteParams | V3SingleRouteParams | V3MultiRouteParams;
-export interface XLayerEoaSwapConfig {
-    rpcUrl: string;
-    gasLimit?: number | bigint;
-    gasLimitMultiplier?: number;
-    minGasPriceGwei?: number;
-    maxGasPriceGwei?: number;
-    txType?: 0 | 2;
-    reserveGasBNB?: number;
-    userType?: UserType;
-    bribeAmount?: number;
-}
-export interface XLayerQuickBatchSwapParams {
-    sellerPrivateKey: string;
-    sellAmount?: string;
-    sellPercentage?: number;
-    buyerPrivateKeys: string[];
-    buyerRatios?: number[];
-    buyerAmounts?: string[];
-    tokenAddress: string;
-    routeParams: RouteParams;
-    config: XLayerEoaSwapConfig;
-    quoteToken?: string;
-    quoteTokenDecimals?: number;
-    disperseHopCount?: number;
-    startNonces?: number[];
-}
-export interface XLayerQuickBatchSwapResult {
-    signedTransactions: string[];
-    disperseHopWallets?: GeneratedWallet[];
-    profitHopWallets?: GeneratedWallet[];
-    metadata?: {
-        sellerAddress: string;
-        buyerAddresses: string[];
-        sellAmount: string;
-        estimatedOutput: string;
-        transferAmounts: string[];
-        profitAmount?: string;
-        useNativeToken: boolean;
-        disperseHopCount?: number;
-    };
-}
-export interface XLayerCrossSwapParams {
-    sellerPrivateKeys: string[];
-    sellAmounts: string[];
-    buyerPrivateKeys: string[];
-    tokenAddress: string;
-    routeParams: RouteParams;
-    config: XLayerEoaSwapConfig;
-    quoteToken?: string;
-    quoteTokenDecimals?: number;
-    buyersPerSell?: number;
-    disperseHopCount?: number;
-    /** ✅ 预获取的 nonce（地址 -> nonce），避免 nonce 不同步 */
-    startNonces?: Map<string, number>;
-}
-export interface XLayerCrossSwapResult {
-    signedTransactions: string[];
-    rounds: Array<{
-        sellerAddress: string;
-        buyerAddresses: string[];
-        sellAmount: string;
-        bundleHash?: string;
-    }>;
-    disperseHopWallets?: GeneratedWallet[];
-    profitHopWallets?: GeneratedWallet[];
-}
+import { RouteParams, XLayerCrossSwapParams, XLayerCrossSwapResult, XLayerEoaSwapConfig, XLayerQuickBatchSwapParams, XLayerQuickBatchSwapResult } from './eoa-bundle-swap-helpers.js';
 export declare function xlayerQuickBatchSwapMerkle(params: XLayerQuickBatchSwapParams): Promise<XLayerQuickBatchSwapResult>;
 export declare function xlayerCrossSwapMerkle(params: XLayerCrossSwapParams): Promise<XLayerCrossSwapResult>;
 /**