four-flap-meme-sdk 1.5.67 → 1.5.69

package/dist/flap/portal.d.ts

@@ -95,6 +95,20 @@ export type TokenStateV5 = {
     nativeToQuoteSwapEnabled: boolean;
     extensionID: `0x${string}`;
 };
+/**
+ * TokenStateV7 - 包含毕业相关信息（pool, progress, lpFeeProfile）
+ * 用于 XLayer 等支持 V7 的链
+ */
+export type TokenStateV7 = TokenStateV5 & {
+    taxRate: bigint;
+    pool: string;
+    progress: bigint;
+    lpFeeProfile: number;
+};
+/**
+ * 将 lpFeeProfile 转换为 V3 fee 值
+ */
+export declare function lpFeeProfileToV3Fee(profile: number): number;
 /**
  * Flap Portal 支持的链
  */
@@ -176,6 +190,23 @@ export declare class FlapPortal {
     getTokenV3(token: string): Promise<TokenStateV3>;
     getTokenV4(token: string): Promise<TokenStateV4>;
     getTokenV5(token: string): Promise<TokenStateV5>;
+    /**
+     * 获取代币状态 V7（包含毕业相关信息）
+     * 注意：仅部分链支持 V7（如 XLayer v5.7+），不支持的链会 revert
+     */
+    getTokenV7(token: string): Promise<TokenStateV7>;
+    /**
+     * 计算距离毕业还需多少 OKB/ETH（含手续费）
+     * @param state TokenStateV5 或 TokenStateV7
+     * @returns 毕业相关信息
+     */
+    computeRemainingToGraduation(state: TokenStateV5 | TokenStateV7): {
+        remainingOkb: string;
+        graduationReserve: string;
+        currentReserve: string;
+        isGraduated: boolean;
+        progressPercent: string;
+    };
     computePriceAndProgress(state: TokenStateV5): {
         price: string;
         progress: string;

package/dist/flap/portal.js

@@ -64,6 +64,8 @@ const PORTAL_ABI = [
     'function getTokenV3(address token) external view returns (uint8,uint256,uint256,uint256,uint8,uint256,uint256,address,bool)',
     'function getTokenV4(address token) external view returns ((uint8,uint256,uint256,uint256,uint8,uint256,uint256,address,bool,bytes32))',
     'function getTokenV5(address token) external view returns ((uint8,uint256,uint256,uint256,uint8,uint256,uint256,uint256,uint256,address,bool,bytes32))',
+    // V7: 包含 taxRate, pool, progress, lpFeeProfile
+    'function getTokenV7(address token) external view returns ((uint8,uint256,uint256,uint256,uint8,uint256,uint256,uint256,uint256,address,bool,bytes32,uint256,address,uint256,uint8))',
     // 报价方法
     'function previewBuy(address token, uint256 ethAmount) external view returns (uint256)',
     'function previewSell(address token, uint256 tokenAmount) external view returns (uint256)',
@@ -88,6 +90,17 @@ const PORTAL_ABI = [
     'function version() external pure returns (string)',
     'function getLocks(address token) external view returns (uint256[])'
 ];
+/**
+ * 将 lpFeeProfile 转换为 V3 fee 值
+ */
+export function lpFeeProfileToV3Fee(profile) {
+    switch (profile) {
+        case V3LPFeeProfile.LP_FEE_PROFILE_STANDARD: return 2500;
+        case V3LPFeeProfile.LP_FEE_PROFILE_LOW: return 100;
+        case V3LPFeeProfile.LP_FEE_PROFILE_HIGH: return 10000;
+        default: return 2500; // 默认 STANDARD
+    }
+}
 export class FlapPortal {
     constructor(cfg) {
         this.rpcUrl = cfg.rpcUrl;
@@ -144,6 +157,66 @@ export class FlapPortal {
             extensionID: raw[11],
         };
     }
+    /**
+     * 获取代币状态 V7（包含毕业相关信息）
+     * 注意：仅部分链支持 V7（如 XLayer v5.7+），不支持的链会 revert
+     */
+    async getTokenV7(token) {
+        const raw = await this.contract.getTokenV7(token);
+        return {
+            status: raw[0],
+            reserve: raw[1],
+            circulatingSupply: raw[2],
+            price: raw[3],
+            tokenVersion: raw[4],
+            r: raw[5],
+            h: raw[6],
+            k: raw[7],
+            dexSupplyThresh: raw[8],
+            quoteTokenAddress: raw[9],
+            nativeToQuoteSwapEnabled: raw[10],
+            extensionID: raw[11],
+            taxRate: raw[12],
+            pool: raw[13],
+            progress: raw[14],
+            lpFeeProfile: Number(raw[15]),
+        };
+    }
+    /**
+     * 计算距离毕业还需多少 OKB/ETH（含手续费）
+     * @param state TokenStateV5 或 TokenStateV7
+     * @returns 毕业相关信息
+     */
+    computeRemainingToGraduation(state) {
+        const r = Number(formatEther(state.r));
+        const h = Number(formatEther(state.h));
+        const k = Number(formatEther(state.k));
+        const curve = new CDPV2(r, h, k);
+        const currentReserve = formatEther(state.reserve);
+        const dexSupplyThresh = formatEther(state.dexSupplyThresh);
+        const circulatingSupply = formatEther(state.circulatingSupply);
+        // 计算毕业时的储备
+        const graduationReserve = curve.estimateReserve(dexSupplyThresh);
+        const graduationReserveNum = parseFloat(graduationReserve.toString());
+        const currentReserveNum = parseFloat(currentReserve);
+        // 是否已毕业 (status == 4 表示 DEX)
+        const isGraduated = state.status === 4;
+        // 还需多少（净值）
+        const remainingNet = Math.max(0, graduationReserveNum - currentReserveNum);
+        // 含手续费（1% buy fee）
+        const remainingWithFee = remainingNet / (1 - this.buyFeeRate);
+        // 计算进度
+        const progressPercent = isGraduated
+            ? '100.00'
+            : (currentReserveNum / graduationReserveNum * 100).toFixed(2);
+        return {
+            remainingOkb: remainingWithFee.toFixed(6),
+            graduationReserve: graduationReserveNum.toFixed(6),
+            currentReserve: currentReserveNum.toFixed(6),
+            isGraduated,
+            progressPercent,
+        };
+    }
     // 价格/进度
     computePriceAndProgress(state) {
         // 使用合约返回的实时价格，而不是重新计算

package/dist/index.d.ts

@@ -53,4 +53,4 @@ export { submitDirectToRpc, submitDirectToRpcSequential, // ✅ 新增：顺序
 submitDirectToRpcParallel, type DirectSubmitConfig, type DirectSubmitResult, type DirectTxResult } from './contracts/tm-bundle-merkle/submit.js';
 export { directV2BatchBuy, directV2BatchSell, directV3BatchBuy, directV3BatchSell, getRouterAddress, DIRECT_ROUTERS, type DirectV2BuyParams, type DirectV2SellParams, type DirectV3BuyParams, type DirectV3SellParams, type DirectRouterResult, type DirectRouterSignConfig, type DexKey, type RouterVersion, } from './dex/index.js';
 export * as XLayer from './xlayer/index.js';
-export { bundleBuy as xlayerBundleBuy, bundleSell as xlayerBundleSell, bundleBuySell as xlayerBundleBuySell, bundleCreateBuySign as xlayerBundleCreateBuySign, bundleCreateToDexSign as xlayerBundleCreateToDexSign, bundleGraduateBuy as xlayerBundleGraduateBuy, bundleSwapSign as xlayerBundleSwapSign, bundleBatchSwapSign as xlayerBundleBatchSwapSign, createBundleExecutor as xlayerCreateBundleExecutor, BundleExecutor as XLayerBundleExecutor, makeVolume as xlayerMakeVolume, singleRoundVolume as xlayerSingleRoundVolume, createVolumeExecutor as xlayerCreateVolumeExecutor, VolumeExecutor as XLayerVolumeExecutor, makeBuyFirstVolume as xlayerMakeBuyFirstVolume, BuyFirstVolumeExecutor as XLayerBuyFirstVolumeExecutor, AAPortalBuyFirstExecutor as XLayerAAPortalBuyFirstExecutor, AADexBuyFirstExecutor as XLayerAADexBuyFirstExecutor, createDexExecutor as xlayerCreateDexExecutor, createDexQuery as xlayerCreateDexQuery, quoteOkbToToken as xlayerQuoteOkbToToken, quoteTokenToOkb as xlayerQuoteTokenToOkb, DexExecutor as XLayerDexExecutor, DexQuery as XLayerDexQuery, createAAAccountManager as xlayerCreateAAAccountManager, predictSender as xlayerPredictSender, createWallet as xlayerCreateWallet, AAAccountManager as XLayerAAAccountManager, generateAAWallets as xlayerGenerateAAWallets, generateAAWalletsFromMnemonic as xlayerGenerateAAWalletsFromMnemonic, predictSendersFromPrivateKeys as xlayerPredictSendersFromPrivateKeys, createBundlerClient as xlayerCreateBundlerClient, BundlerClient as XLayerBundlerClient, createPortalQuery as xlayerCreatePortalQuery, PortalQuery as XLayerPortalQuery, encodeBuyCall as xlayerEncodeBuyCall, encodeSellCall as xlayerEncodeSellCall, encodeApproveCall as xlayerEncodeApproveCall, parseOkb as xlayerParseOkb, formatOkb as xlayerFormatOkb, XLAYER_CHAIN_ID, FLAP_PORTAL as XLAYER_FLAP_PORTAL, ENTRYPOINT_V06 as XLAYER_ENTRYPOINT, SIMPLE_ACCOUNT_FACTORY as XLAYER_FACTORY, PARTICLE_BUNDLER_URL as XLAYER_BUNDLER_URL, WOKB as XLAYER_WOKB, POTATOSWAP_V2_ROUTER as XLAYER_POTATOSWAP_ROUTER, type XLayerConfig, type BundleBuyParams as XLayerBundleBuyParams, type BundleSellParams as XLayerBundleSellParams, type BundleBuySellParams as XLayerBundleBuySellParams, type BundleSwapParams as XLayerBundleSwapParams, type BundleSwapSignParams as XLayerBundleSwapSignParams, type BundleBatchSwapParams as XLayerBundleBatchSwapParams, type BundleBatchSwapSignParams as XLayerBundleBatchSwapSignParams, type VolumeParams as XLayerVolumeParams, type BundleBuyResult as XLayerBundleBuyResult, type BundleSellResult as XLayerBundleSellResult, type BundleBuySellResult as XLayerBundleBuySellResult, type BundleCreateBuySignParams as XLayerBundleCreateBuySignParams, type BundleCreateBuySignResult as XLayerBundleCreateBuySignResult, type BundleCreateToDexSignParams as XLayerBundleCreateToDexSignParams, type BundleCreateToDexSignResult as XLayerBundleCreateToDexSignResult, type BundleGraduateBuyParams as XLayerBundleGraduateBuyParams, type BundleGraduateBuyResult as XLayerBundleGraduateBuyResult, type BundleSwapResult as XLayerBundleSwapResult, type BundleSwapSignResult as XLayerBundleSwapSignResult, type BundleBatchSwapResult as XLayerBundleBatchSwapResult, type BundleBatchSwapSignResult as XLayerBundleBatchSwapSignResult, type VolumeResult as XLayerVolumeResult, type BuyFirstParams as XLayerBuyFirstParams, type BuyFirstResult as XLayerBuyFirstResult, type BuyFirstVolumeParams as XLayerBuyFirstVolumeParams, type BuyFirstVolumeResult as XLayerBuyFirstVolumeResult, type HandleOpsResult as XLayerHandleOpsResult, type AAAccount as XLayerAAAccount, type UserOperation as XLayerUserOperation, type GeneratedAAWallet as XLayerGeneratedAAWallet, type GenerateAAWalletsParams as XLayerGenerateAAWalletsParams, type GenerateAAWalletsResult as XLayerGenerateAAWalletsResult, } from './xlayer/index.js';
+export { bundleBuy as xlayerBundleBuy, bundleSell as xlayerBundleSell, bundleBuySell as xlayerBundleBuySell, bundleCreateBuySign as xlayerBundleCreateBuySign, bundleCreateToDexSign as xlayerBundleCreateToDexSign, bundleGraduateBuy as xlayerBundleGraduateBuy, bundleSwapSign as xlayerBundleSwapSign, bundleBatchSwapSign as xlayerBundleBatchSwapSign, createBundleExecutor as xlayerCreateBundleExecutor, BundleExecutor as XLayerBundleExecutor, makeVolume as xlayerMakeVolume, singleRoundVolume as xlayerSingleRoundVolume, createVolumeExecutor as xlayerCreateVolumeExecutor, VolumeExecutor as XLayerVolumeExecutor, makeBuyFirstVolume as xlayerMakeBuyFirstVolume, BuyFirstVolumeExecutor as XLayerBuyFirstVolumeExecutor, AAPortalBuyFirstExecutor as XLayerAAPortalBuyFirstExecutor, AADexBuyFirstExecutor as XLayerAADexBuyFirstExecutor, AAVolumeBuyFirstExecutor as XLayerAAVolumeBuyFirstExecutor, createAAVolumeBuyFirstExecutor as xlayerCreateAAVolumeBuyFirstExecutor, type VolumeBuyFirstParams as XLayerVolumeBuyFirstParams, type VolumeBuyFirstResult as XLayerVolumeBuyFirstResult, type VolumeContinuousParams as XLayerVolumeContinuousParams, type VolumeContinuousResult as XLayerVolumeContinuousResult, type VolumeProgress as XLayerVolumeProgress, createDexExecutor as xlayerCreateDexExecutor, createDexQuery as xlayerCreateDexQuery, quoteOkbToToken as xlayerQuoteOkbToToken, quoteTokenToOkb as xlayerQuoteTokenToOkb, DexExecutor as XLayerDexExecutor, DexQuery as XLayerDexQuery, createAAAccountManager as xlayerCreateAAAccountManager, predictSender as xlayerPredictSender, createWallet as xlayerCreateWallet, AAAccountManager as XLayerAAAccountManager, generateAAWallets as xlayerGenerateAAWallets, generateAAWalletsFromMnemonic as xlayerGenerateAAWalletsFromMnemonic, predictSendersFromPrivateKeys as xlayerPredictSendersFromPrivateKeys, createBundlerClient as xlayerCreateBundlerClient, BundlerClient as XLayerBundlerClient, createPortalQuery as xlayerCreatePortalQuery, PortalQuery as XLayerPortalQuery, encodeBuyCall as xlayerEncodeBuyCall, encodeSellCall as xlayerEncodeSellCall, encodeApproveCall as xlayerEncodeApproveCall, parseOkb as xlayerParseOkb, formatOkb as xlayerFormatOkb, XLAYER_CHAIN_ID, FLAP_PORTAL as XLAYER_FLAP_PORTAL, ENTRYPOINT_V06 as XLAYER_ENTRYPOINT, SIMPLE_ACCOUNT_FACTORY as XLAYER_FACTORY, PARTICLE_BUNDLER_URL as XLAYER_BUNDLER_URL, WOKB as XLAYER_WOKB, POTATOSWAP_V2_ROUTER as XLAYER_POTATOSWAP_ROUTER, type XLayerConfig, type BundleBuyParams as XLayerBundleBuyParams, type BundleSellParams as XLayerBundleSellParams, type BundleBuySellParams as XLayerBundleBuySellParams, type BundleSwapParams as XLayerBundleSwapParams, type BundleSwapSignParams as XLayerBundleSwapSignParams, type BundleBatchSwapParams as XLayerBundleBatchSwapParams, type BundleBatchSwapSignParams as XLayerBundleBatchSwapSignParams, type VolumeParams as XLayerVolumeParams, type BundleBuyResult as XLayerBundleBuyResult, type BundleSellResult as XLayerBundleSellResult, type BundleBuySellResult as XLayerBundleBuySellResult, type BundleCreateBuySignParams as XLayerBundleCreateBuySignParams, type BundleCreateBuySignResult as XLayerBundleCreateBuySignResult, type BundleCreateToDexSignParams as XLayerBundleCreateToDexSignParams, type BundleCreateToDexSignResult as XLayerBundleCreateToDexSignResult, type BundleGraduateBuyParams as XLayerBundleGraduateBuyParams, type BundleGraduateBuyResult as XLayerBundleGraduateBuyResult, type BundleSwapResult as XLayerBundleSwapResult, type BundleSwapSignResult as XLayerBundleSwapSignResult, type BundleBatchSwapResult as XLayerBundleBatchSwapResult, type BundleBatchSwapSignResult as XLayerBundleBatchSwapSignResult, type VolumeResult as XLayerVolumeResult, type BuyFirstParams as XLayerBuyFirstParams, type BuyFirstResult as XLayerBuyFirstResult, type BuyFirstVolumeParams as XLayerBuyFirstVolumeParams, type BuyFirstVolumeResult as XLayerBuyFirstVolumeResult, type HandleOpsResult as XLayerHandleOpsResult, type AAAccount as XLayerAAAccount, type UserOperation as XLayerUserOperation, type GeneratedAAWallet as XLayerGeneratedAAWallet, type GenerateAAWalletsParams as XLayerGenerateAAWalletsParams, type GenerateAAWalletsResult as XLayerGenerateAAWalletsResult, } from './xlayer/index.js';

package/dist/index.js

@@ -107,6 +107,8 @@ bundleBuy as xlayerBundleBuy, bundleSell as xlayerBundleSell, bundleBuySell as x
 makeVolume as xlayerMakeVolume, singleRoundVolume as xlayerSingleRoundVolume, createVolumeExecutor as xlayerCreateVolumeExecutor, VolumeExecutor as XLayerVolumeExecutor, 
 // ✅ Buy-First 刷量（对齐 BSC buy-first）
 makeBuyFirstVolume as xlayerMakeBuyFirstVolume, BuyFirstVolumeExecutor as XLayerBuyFirstVolumeExecutor, AAPortalBuyFirstExecutor as XLayerAAPortalBuyFirstExecutor, AADexBuyFirstExecutor as XLayerAADexBuyFirstExecutor, 
+// ✅ Volume Buy-First（自动刷量）
+AAVolumeBuyFirstExecutor as XLayerAAVolumeBuyFirstExecutor, createAAVolumeBuyFirstExecutor as xlayerCreateAAVolumeBuyFirstExecutor, 
 // DEX 交易
 createDexExecutor as xlayerCreateDexExecutor, createDexQuery as xlayerCreateDexQuery, quoteOkbToToken as xlayerQuoteOkbToToken, quoteTokenToOkb as xlayerQuoteTokenToOkb, DexExecutor as XLayerDexExecutor, DexQuery as XLayerDexQuery, 
 // AA 账户管理

package/dist/xlayer/bundle.js

@@ -1469,14 +1469,13 @@ export class BundleExecutor {
             // ✅ 并行构建和签名所有外盘买入 UserOps
             const signedDexBuyOps = await mapWithConcurrency(dexBuyData, 5, async (data) => {
                 const { wallet, info, buyWei } = data;
-                // AA 模式外盘：使用 executeBatch 将 Approve + Swap 合并为一个 UserOp
-                const approveData = encodeApproveCall(POTATOSWAP_V2_ROUTER);
+                // ✅ 外盘买入：用 OKB 买代币，不需要 approve，直接调用 Router 的 swap 方法
                 const swapData = encodeSwapExactETHForTokensSupportingFee(0n, [WOKB, tokenAddress], info.sender, deadline);
-                const batchCallData = encodeExecuteBatch([tokenAddress, POTATOSWAP_V2_ROUTER], [0n, buyWei], [approveData, swapData]);
+                const dexBuyCallData = encodeExecute(POTATOSWAP_V2_ROUTER, buyWei, swapData);
                 const dexBuyOpRes = await aaManager.buildUserOpWithFixedGas({
                     ownerWallet: wallet,
                     sender: info.sender,
-                    callData: batchCallData,
+                    callData: dexBuyCallData,
                     nonce: nonceMap.next(info.sender),
                     initCode: '0x', // HandleOps1 已部署
                     deployed: true,

package/dist/xlayer/index.d.ts

@@ -69,6 +69,7 @@ export { AADexSwapExecutor, } from './dex-bundle-swap.js';
 export { AAPortalBuyFirstExecutor, createAAPortalBuyFirstExecutor, } from './portal-buy-first.js';
 export { AADexBuyFirstExecutor, createAADexBuyFirstExecutor, } from './dex-buy-first.js';
 export { BuyFirstVolumeExecutor, createBuyFirstVolumeExecutor, makeBuyFirstVolume, } from './buy-first-volume.js';
+export { AAVolumeBuyFirstExecutor, createAAVolumeBuyFirstExecutor, type VolumeMode, type VolumeTradeType, type VolumeBuyFirstParams, type VolumeBuyFirstResult, type VolumeContinuousParams, type VolumeContinuousResult, type VolumeProgress, } from './volume-buy-first.js';
 /**
  * XLayer AA 换手签名 (卖 -> 买)
  */

package/dist/xlayer/index.js

@@ -99,6 +99,10 @@ export { AADexSwapExecutor, } from './dex-bundle-swap.js';
 export { AAPortalBuyFirstExecutor, createAAPortalBuyFirstExecutor, } from './portal-buy-first.js';
 export { AADexBuyFirstExecutor, createAADexBuyFirstExecutor, } from './dex-buy-first.js';
 export { BuyFirstVolumeExecutor, createBuyFirstVolumeExecutor, makeBuyFirstVolume, } from './buy-first-volume.js';
+// ============================================================================
+// ✅ Volume Buy-First（自动刷量）
+// ============================================================================
+export { AAVolumeBuyFirstExecutor, createAAVolumeBuyFirstExecutor, } from './volume-buy-first.js';
 /**
  * XLayer AA 换手签名 (卖 -> 买)
  */

package/dist/xlayer/volume-buy-first.d.ts

@@ -0,0 +1,102 @@
+/**
+ * XLayer AA Volume Buy-First Executor
+ *
+ * 自动刷量执行器，支持 wash（一买一卖）和 bundle（多买多卖）模式
+ *
+ * 核心优化：
+ * - Nonce 预分配：减少 RPC 调用
+ * - 批量余额检查：提前验证钱包余额
+ * - 智能钱包轮换：避免同一钱包频繁交易
+ * - 并行构建 UserOps：提高执行效率
+ */
+import type { XLayerConfig } from './types.js';
+import type { BuyFirstResult } from './types.js';
+export type VolumeMode = 'wash' | 'bundle';
+export type VolumeTradeType = 'FLAP' | 'V2' | 'V3';
+export interface VolumeBuyFirstParams {
+    mode: VolumeMode;
+    tradeType: VolumeTradeType;
+    tokenAddress: string;
+    buyerPrivateKeys: string[];
+    sellerPrivateKeys: string[];
+    buyerFunds: string;
+    buyCount?: number;
+    sellCount?: number;
+    config?: Partial<XLayerConfig>;
+}
+export interface VolumeBuyFirstResult {
+    mode: VolumeMode;
+    tradeType: VolumeTradeType;
+    buySellResult: BuyFirstResult['buySellResult'];
+    withdrawResult?: BuyFirstResult['withdrawResult'];
+    metadata: {
+        buyCount: number;
+        sellCount: number;
+        roundTimestamp: number;
+        [key: string]: any;
+    };
+}
+export interface VolumeContinuousParams {
+    mode: VolumeMode;
+    tradeType: VolumeTradeType;
+    tokenAddress: string;
+    wallets: Array<{
+        privateKey: string;
+        address: string;
+    }>;
+    minBuyAmt: number;
+    maxBuyAmt: number;
+    buyCount?: number;
+    sellCount?: number;
+    durationSec: number;
+    intervalSec: number;
+    washBatchWalletCount?: number;
+    config?: Partial<XLayerConfig>;
+    onProgress?: (progress: VolumeProgress) => void;
+}
+export interface VolumeProgress {
+    currentRound: number;
+    totalRounds: number;
+    successCount: number;
+    failureCount: number;
+    elapsedMs: number;
+}
+export interface VolumeContinuousResult {
+    totalRounds: number;
+    successRounds: number;
+    failureRounds: number;
+    rounds: VolumeBuyFirstResult[];
+    totalDuration: number;
+    metadata: {
+        mode: VolumeMode;
+        tradeType: VolumeTradeType;
+        avgRoundTime: number;
+    };
+}
+export declare class AAVolumeBuyFirstExecutor {
+    private portalExecutor;
+    private dexExecutor;
+    private walletRotation;
+    private config;
+    constructor(config?: XLayerConfig);
+    /**
+     * 执行单轮 Buy-First 刷量
+     */
+    executeRound(params: VolumeBuyFirstParams): Promise<VolumeBuyFirstResult>;
+    /**
+     * 执行多轮持续刷量
+     */
+    executeContinuous(params: VolumeContinuousParams): Promise<VolumeContinuousResult>;
+    /**
+     * 生成随机总买入金额
+     */
+    private generateRandomTotalAmount;
+    /**
+     * 延迟函数
+     */
+    private delay;
+}
+/**
+ * 创建 Volume Buy-First 执行器
+ */
+export declare function createAAVolumeBuyFirstExecutor(config?: XLayerConfig): AAVolumeBuyFirstExecutor;

package/dist/xlayer/volume-buy-first.js

@@ -0,0 +1,258 @@
+/**
+ * XLayer AA Volume Buy-First Executor
+ *
+ * 自动刷量执行器，支持 wash（一买一卖）和 bundle（多买多卖）模式
+ *
+ * 核心优化：
+ * - Nonce 预分配：减少 RPC 调用
+ * - 批量余额检查：提前验证钱包余额
+ * - 智能钱包轮换：避免同一钱包频繁交易
+ * - 并行构建 UserOps：提高执行效率
+ */
+import { AAPortalBuyFirstExecutor } from './portal-buy-first.js';
+import { AADexBuyFirstExecutor } from './dex-buy-first.js';
+// ==================== 智能钱包轮换管理器 ====================
+class WalletRotationManager {
+    constructor(cooldownMs = 60000) {
+        this.lastUsedTime = new Map();
+        this.cooldownMs = cooldownMs;
+    }
+    /**
+     * 选择可用的钱包（过滤冷却中的钱包）
+     */
+    selectWallets(candidates, count) {
+        const now = Date.now();
+        // 过滤掉冷却中的钱包
+        const available = candidates.filter((w) => {
+            const lastUsed = this.lastUsedTime.get(w.address.toLowerCase()) ?? 0;
+            return now - lastUsed >= this.cooldownMs;
+        });
+        if (available.length < count) {
+            throw new Error(`可用钱包不足：需要 ${count} 个，实际 ${available.length} 个（${candidates.length - available.length} 个冷却中）`);
+        }
+        // 随机选择
+        const selected = this.randomSelect(available, count);
+        // 记录使用时间
+        for (const wallet of selected) {
+            this.lastUsedTime.set(wallet.address.toLowerCase(), now);
+        }
+        return selected;
+    }
+    /**
+     * 重置所有钱包的冷却时间
+     */
+    reset() {
+        this.lastUsedTime.clear();
+    }
+    randomSelect(arr, count) {
+        const shuffled = [...arr].sort(() => Math.random() - 0.5);
+        return shuffled.slice(0, count);
+    }
+}
+// ==================== 核心执行器 ====================
+export class AAVolumeBuyFirstExecutor {
+    constructor(config = {}) {
+        this.config = config;
+        this.portalExecutor = new AAPortalBuyFirstExecutor(config);
+        this.dexExecutor = new AADexBuyFirstExecutor(config);
+        this.walletRotation = new WalletRotationManager(60000); // 60 秒冷却
+    }
+    /**
+     * 执行单轮 Buy-First 刷量
+     */
+    async executeRound(params) {
+        const { mode, tradeType, tokenAddress, buyerPrivateKeys, sellerPrivateKeys, buyerFunds, buyCount, sellCount, config, } = params;
+        // 验证参数
+        if (buyerPrivateKeys.length === 0) {
+            throw new Error('buyerPrivateKeys 不能为空');
+        }
+        if (sellerPrivateKeys.length === 0) {
+            throw new Error('sellerPrivateKeys 不能为空');
+        }
+        // 合并配置
+        const effConfig = { ...this.config, ...config };
+        // 根据 tradeType 选择执行器
+        const executor = tradeType === 'FLAP' ? this.portalExecutor : this.dexExecutor;
+        // 构建 BuyFirstParams
+        const buyFirstParams = {
+            tradeType: tradeType === 'FLAP' ? 'FLAP' : 'V2',
+            routerVersion: tradeType === 'V3' ? 'V3' : 'V2',
+            tokenAddress,
+            buyerPrivateKeys,
+            sellerPrivateKeys,
+            buyerFunds,
+            buyCount: buyCount ?? buyerPrivateKeys.length,
+            sellCount: sellCount ?? sellerPrivateKeys.length,
+            withdrawToOwner: mode === 'wash', // wash 模式立即归集
+            config: effConfig,
+        };
+        // 执行 buy-first
+        const result = await executor.execute(buyFirstParams);
+        return {
+            mode,
+            tradeType,
+            buySellResult: result.buySellResult,
+            withdrawResult: result.withdrawResult,
+            metadata: {
+                ...result.metadata,
+                buyCount: buyCount ?? buyerPrivateKeys.length,
+                sellCount: sellCount ?? sellerPrivateKeys.length,
+                roundTimestamp: Date.now(),
+            },
+        };
+    }
+    /**
+     * 执行多轮持续刷量
+     */
+    async executeContinuous(params) {
+        const { mode, tradeType, tokenAddress, wallets, minBuyAmt, maxBuyAmt, buyCount = 1, sellCount = 1, durationSec, intervalSec, washBatchWalletCount = 23, config, onProgress, } = params;
+        const startTime = Date.now();
+        const endTime = startTime + durationSec * 1000;
+        const rounds = [];
+        let successCount = 0;
+        let failureCount = 0;
+        // 重置钱包轮换状态
+        this.walletRotation.reset();
+        console.log(`\n[AAVolumeBuyFirstExecutor] 开始持续刷量`);
+        console.log(`  模式: ${mode}`);
+        console.log(`  交易类型: ${tradeType}`);
+        console.log(`  钱包数: ${wallets.length}`);
+        console.log(`  持续时间: ${durationSec} 秒`);
+        console.log(`  间隔: ${intervalSec} 秒\n`);
+        while (Date.now() < endTime) {
+            try {
+                if (mode === 'wash') {
+                    // ✅ Wash 模式：按批次轮询
+                    for (let i = 0; i < wallets.length; i += washBatchWalletCount) {
+                        if (Date.now() >= endTime)
+                            break;
+                        const batch = wallets.slice(i, i + washBatchWalletCount);
+                        const totalBuyAmount = this.generateRandomTotalAmount(batch.length, minBuyAmt, maxBuyAmt);
+                        console.log(`[Wash Round ${rounds.length + 1}] 钱包 ${i + 1}-${i + batch.length}/${wallets.length}, 总买入: ${totalBuyAmount} OKB`);
+                        const result = await this.executeRound({
+                            mode: 'wash',
+                            tradeType,
+                            tokenAddress,
+                            buyerPrivateKeys: batch.map((w) => w.privateKey),
+                            sellerPrivateKeys: batch.map((w) => w.privateKey),
+                            buyerFunds: totalBuyAmount,
+                            buyCount: batch.length,
+                            sellCount: batch.length,
+                            config,
+                        });
+                        rounds.push(result);
+                        successCount++;
+                        // 进度回调
+                        if (onProgress) {
+                            onProgress({
+                                currentRound: rounds.length,
+                                totalRounds: Math.ceil((durationSec * 1000) / (intervalSec * 1000)),
+                                successCount,
+                                failureCount,
+                                elapsedMs: Date.now() - startTime,
+                            });
+                        }
+                        // 等待间隔
+                        if (Date.now() < endTime) {
+                            await this.delay(intervalSec * 1000);
+                        }
+                    }
+                }
+                else {
+                    // ✅ Bundle 模式：随机选择买方和卖方
+                    const buyers = this.walletRotation.selectWallets(wallets, buyCount);
+                    const sellers = this.walletRotation.selectWallets(wallets, sellCount);
+                    const totalBuyAmount = this.generateRandomTotalAmount(buyCount, minBuyAmt, maxBuyAmt);
+                    console.log(`[Bundle Round ${rounds.length + 1}] ${buyCount} 买 ${sellCount} 卖, 总买入: ${totalBuyAmount} OKB`);
+                    const result = await this.executeRound({
+                        mode: 'bundle',
+                        tradeType,
+                        tokenAddress,
+                        buyerPrivateKeys: buyers.map((w) => w.privateKey),
+                        sellerPrivateKeys: sellers.map((w) => w.privateKey),
+                        buyerFunds: totalBuyAmount,
+                        buyCount,
+                        sellCount,
+                        config,
+                    });
+                    rounds.push(result);
+                    successCount++;
+                    // 进度回调
+                    if (onProgress) {
+                        onProgress({
+                            currentRound: rounds.length,
+                            totalRounds: Math.ceil((durationSec * 1000) / (intervalSec * 1000)),
+                            successCount,
+                            failureCount,
+                            elapsedMs: Date.now() - startTime,
+                        });
+                    }
+                    // 等待间隔
+                    if (Date.now() < endTime) {
+                        await this.delay(intervalSec * 1000);
+                    }
+                }
+            }
+            catch (error) {
+                console.error(`[Round ${rounds.length + 1}] 执行失败:`, error);
+                failureCount++;
+                // 进度回调
+                if (onProgress) {
+                    onProgress({
+                        currentRound: rounds.length,
+                        totalRounds: Math.ceil((durationSec * 1000) / (intervalSec * 1000)),
+                        successCount,
+                        failureCount,
+                        elapsedMs: Date.now() - startTime,
+                    });
+                }
+                // 失败后等待间隔再继续
+                if (Date.now() < endTime) {
+                    await this.delay(intervalSec * 1000);
+                }
+            }
+        }
+        const totalDuration = Date.now() - startTime;
+        const avgRoundTime = rounds.length > 0 ? totalDuration / rounds.length : 0;
+        console.log(`\n[AAVolumeBuyFirstExecutor] 刷量完成`);
+        console.log(`  总轮数: ${rounds.length}`);
+        console.log(`  成功: ${successCount}`);
+        console.log(`  失败: ${failureCount}`);
+        console.log(`  总耗时: ${(totalDuration / 1000).toFixed(2)} 秒`);
+        console.log(`  平均每轮: ${(avgRoundTime / 1000).toFixed(2)} 秒\n`);
+        return {
+            totalRounds: rounds.length,
+            successRounds: successCount,
+            failureRounds: failureCount,
+            rounds,
+            totalDuration,
+            metadata: {
+                mode,
+                tradeType,
+                avgRoundTime,
+            },
+        };
+    }
+    /**
+     * 生成随机总买入金额
+     */
+    generateRandomTotalAmount(count, min, max) {
+        const amounts = Array(count)
+            .fill(0)
+            .map(() => min + Math.random() * (max - min));
+        const total = amounts.reduce((a, b) => a + b, 0);
+        return total.toFixed(6);
+    }
+    /**
+     * 延迟函数
+     */
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+/**
+ * 创建 Volume Buy-First 执行器
+ */
+export function createAAVolumeBuyFirstExecutor(config) {
+    return new AAVolumeBuyFirstExecutor(config);
+}

package/package.json

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

package/dist/flap/portal-bundle-merkle/encryption.d.ts

@@ -1,16 +0,0 @@
-/**
- * ECDH + AES-GCM 加密工具（浏览器兼容）
- * 用于将签名交易用服务器公钥加密
- */
-/**
- * 用服务器公钥加密签名交易（ECDH + AES-GCM）
- *
- * @param signedTransactions 签名后的交易数组
- * @param publicKeyBase64 服务器提供的公钥（Base64 格式）
- * @returns JSON 字符串 {e: 临时公钥, i: IV, d: 密文}
- */
-export declare function encryptWithPublicKey(signedTransactions: string[], publicKeyBase64: string): Promise<string>;
-/**
- * 验证公钥格式（Base64）
- */
-export declare function validatePublicKey(publicKeyBase64: string): boolean;

package/dist/flap/portal-bundle-merkle/encryption.js

@@ -1,146 +0,0 @@
-/**
- * ECDH + AES-GCM 加密工具（浏览器兼容）
- * 用于将签名交易用服务器公钥加密
- */
-/**
- * 获取全局 crypto 对象（最简单直接的方式）
- */
-function getCryptoAPI() {
-    // 尝试所有可能的全局对象，优先浏览器环境
-    const cryptoObj = (typeof window !== 'undefined' && window.crypto) ||
-        (typeof self !== 'undefined' && self.crypto) ||
-        (typeof global !== 'undefined' && global.crypto) ||
-        (typeof globalThis !== 'undefined' && globalThis.crypto);
-    if (!cryptoObj) {
-        const env = typeof window !== 'undefined' ? 'Browser' : 'Node.js';
-        const protocol = typeof location !== 'undefined' ? location.protocol : 'unknown';
-        throw new Error(`❌ Crypto API 不可用。环境: ${env}, 协议: ${protocol}. ` +
-            '请确保在 HTTPS 或 localhost 下运行');
-    }
-    return cryptoObj;
-}
-/**
- * 获取 SubtleCrypto（用于加密操作）
- */
-function getSubtleCrypto() {
-    const crypto = getCryptoAPI();
-    if (!crypto.subtle) {
-        const protocol = typeof location !== 'undefined' ? location.protocol : 'unknown';
-        const hostname = typeof location !== 'undefined' ? location.hostname : 'unknown';
-        throw new Error(`❌ SubtleCrypto API 不可用。协议: ${protocol}, 主机: ${hostname}. ` +
-            '请确保：1) 使用 HTTPS (或 localhost)；2) 浏览器支持 Web Crypto API；' +
-            '3) 不在无痕/隐私浏览模式下');
-    }
-    return crypto.subtle;
-}
-/**
- * Base64 转 ArrayBuffer（优先使用浏览器 API）
- */
-function base64ToArrayBuffer(base64) {
-    // 浏览器环境（优先）
-    if (typeof atob !== 'undefined') {
-        const binaryString = atob(base64);
-        const bytes = new Uint8Array(binaryString.length);
-        for (let i = 0; i < binaryString.length; i++) {
-            bytes[i] = binaryString.charCodeAt(i);
-        }
-        return bytes.buffer;
-    }
-    // Node.js 环境（fallback）
-    if (typeof Buffer !== 'undefined') {
-        return Buffer.from(base64, 'base64').buffer;
-    }
-    throw new Error('❌ Base64 解码不可用');
-}
-/**
- * ArrayBuffer 转 Base64（优先使用浏览器 API）
- */
-function arrayBufferToBase64(buffer) {
-    // 浏览器环境（优先）
-    if (typeof btoa !== 'undefined') {
-        const bytes = new Uint8Array(buffer);
-        let binary = '';
-        for (let i = 0; i < bytes.length; i++) {
-            binary += String.fromCharCode(bytes[i]);
-        }
-        return btoa(binary);
-    }
-    // Node.js 环境（fallback）
-    if (typeof Buffer !== 'undefined') {
-        return Buffer.from(buffer).toString('base64');
-    }
-    throw new Error('❌ Base64 编码不可用');
-}
-/**
- * 生成随机 Hex 字符串
- */
-function randomHex(length) {
-    const crypto = getCryptoAPI();
-    const array = new Uint8Array(length);
-    crypto.getRandomValues(array);
-    return Array.from(array)
-        .map(b => b.toString(16).padStart(2, '0'))
-        .join('');
-}
-/**
- * 用服务器公钥加密签名交易（ECDH + AES-GCM）
- *
- * @param signedTransactions 签名后的交易数组
- * @param publicKeyBase64 服务器提供的公钥（Base64 格式）
- * @returns JSON 字符串 {e: 临时公钥, i: IV, d: 密文}
- */
-export async function encryptWithPublicKey(signedTransactions, publicKeyBase64) {
-    try {
-        // 0. 获取 SubtleCrypto 和 Crypto API
-        const subtle = getSubtleCrypto();
-        const crypto = getCryptoAPI();
-        // 1. 准备数据
-        const payload = {
-            signedTransactions,
-            timestamp: Date.now(),
-            nonce: randomHex(8)
-        };
-        const plaintext = JSON.stringify(payload);
-        // 2. 生成临时 ECDH 密钥对
-        const ephemeralKeyPair = await subtle.generateKey({ name: 'ECDH', namedCurve: 'P-256' }, true, ['deriveKey']);
-        // 3. 导入服务器公钥
-        const publicKeyBuffer = base64ToArrayBuffer(publicKeyBase64);
-        const publicKey = await subtle.importKey('raw', publicKeyBuffer, { name: 'ECDH', namedCurve: 'P-256' }, false, []);
-        // 4. 派生共享密钥（AES-256）
-        const sharedKey = await subtle.deriveKey({ name: 'ECDH', public: publicKey }, ephemeralKeyPair.privateKey, { name: 'AES-GCM', length: 256 }, false, ['encrypt']);
-        // 5. AES-GCM 加密
-        const iv = crypto.getRandomValues(new Uint8Array(12));
-        const encrypted = await subtle.encrypt({ name: 'AES-GCM', iv }, sharedKey, new TextEncoder().encode(plaintext));
-        // 6. 导出临时公钥
-        const ephemeralPublicKeyRaw = await subtle.exportKey('raw', ephemeralKeyPair.publicKey);
-        // 7. 返回加密包（JSON 格式）
-        return JSON.stringify({
-            e: arrayBufferToBase64(ephemeralPublicKeyRaw), // 临时公钥
-            i: arrayBufferToBase64(iv.buffer), // IV
-            d: arrayBufferToBase64(encrypted) // 密文
-        });
-    }
-    catch (error) {
-        throw new Error(`加密失败: ${error?.message || String(error)}`);
-    }
-}
-/**
- * 验证公钥格式（Base64）
- */
-export function validatePublicKey(publicKeyBase64) {
-    try {
-        if (!publicKeyBase64)
-            return false;
-        // Base64 字符集验证
-        if (!/^[A-Za-z0-9+/=]+$/.test(publicKeyBase64))
-            return false;
-        // ECDH P-256 公钥固定长度 65 字节（未压缩）
-        // Base64 编码后约 88 字符
-        if (publicKeyBase64.length < 80 || publicKeyBase64.length > 100)
-            return false;
-        return true;
-    }
-    catch {
-        return false;
-    }
-}