four-flap-meme-sdk 1.5.63 → 1.5.65

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, 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 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, 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

@@ -102,7 +102,7 @@ DIRECT_ROUTERS, } 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, bundleSwapSign as xlayerBundleSwapSign, bundleBatchSwapSign as xlayerBundleBatchSwapSign, createBundleExecutor as xlayerCreateBundleExecutor, BundleExecutor as XLayerBundleExecutor, 
+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, 
 // ✅ Buy-First 刷量（对齐 BSC buy-first）

package/dist/xlayer/bundle.d.ts

@@ -7,7 +7,7 @@
  * - 买卖一体化：买入 -> 授权 -> 卖出 -> 归集
  * - OKB 归集：将 sender 的 OKB 转回 owner
  */
-import type { XLayerConfig, BundleBuyParams, BundleBuyResult, BundleSellParams, BundleSellResult, BundleBuySellParams, BundleBuySellResult, BundleCreateBuySignParams, BundleCreateBuySignResult, BundleCreateToDexSignParams, BundleCreateToDexSignResult, BundlePreApproveParams, BundlePreApproveResult, ApprovalStatusResult } from './types.js';
+import type { XLayerConfig, BundleBuyParams, BundleBuyResult, BundleSellParams, BundleSellResult, BundleBuySellParams, BundleBuySellResult, BundleCreateBuySignParams, BundleCreateBuySignResult, BundleCreateToDexSignParams, BundleCreateToDexSignResult, BundlePreApproveParams, BundlePreApproveResult, ApprovalStatusResult, BundleGraduateBuyParams, BundleGraduateBuyResult } from './types.js';
 import { AAAccountManager } from './aa-account.js';
 import { PortalQuery } from './portal-ops.js';
 /**
@@ -46,11 +46,6 @@ export declare class BundleExecutor {
      * - 用于 AA 交易的尾部，将利润转账给指定地址
      */
     private signProfitTransaction;
-    private getErc20Decimals;
-    /**
-     * 构建买入 UserOp
-     */
-    private buildBuyUserOp;
     /**
      * 构建授权 UserOp
      */
@@ -59,19 +54,15 @@ export declare class BundleExecutor {
      * 构建卖出 UserOp
      */
     private buildSellUserOp;
-    /**
-     * 构建归集 UserOp（将 OKB 从 sender 转回 owner）
-     */
-    private buildWithdrawUserOp;
     /**
      * 构建归集 UserOp（已知 sender/nonce/balance 的快速版本）
      * - 用于批量流程：避免重复 getAccountInfo / getOkbBalance
      */
     private buildWithdrawUserOpWithState;
     /**
-     * 构建代币转账 UserOp（将代币从 sender 转回 owner）
+     * 获取代币精度 (用于内部逻辑)
      */
-    private buildTransferTokenUserOp;
+    getErc20Decimals(tokenAddress: string): Promise<number>;
     /**
      * 捆绑买入
      *
@@ -116,6 +107,12 @@ export declare class BundleExecutor {
      * @returns 签名后的交易列表及元数据
      */
     bundleCreateToDexSign(params: BundleCreateToDexSignParams): Promise<BundleCreateToDexSignResult>;
+    /**
+     * 捆绑买到毕业（签名版本）
+     *
+     * 自动计算剩余毕业容量，将钱包分为内盘和外盘组，生成签名的交易列表
+     */
+    bundleGraduateBuy(params: BundleGraduateBuyParams): Promise<BundleGraduateBuyResult>;
     /**
      * 检查多个 AA 账户的授权状态
      *
@@ -171,9 +168,13 @@ export declare function bundleBuySell(params: BundleBuySellParams): Promise<Bund
  */
 export declare function bundleCreateBuySign(params: BundleCreateBuySignParams): Promise<BundleCreateBuySignResult>;
 /**
- * 快速一键发射到外盘（仅签名，AA 模式）
+ * 快速捆绑发射到外盘（仅签名，AA 模式）
  */
 export declare function bundleCreateToDexSign(params: BundleCreateToDexSignParams): Promise<BundleCreateToDexSignResult>;
+/**
+ * 快速买到毕业（仅签名，AA 模式）
+ */
+export declare function bundleGraduateBuy(params: BundleGraduateBuyParams): Promise<BundleGraduateBuyResult>;
 /**
  * 快速预授权
  *

package/dist/xlayer/bundle.js

@@ -253,62 +253,6 @@ export class BundleExecutor {
             type: 0,
         });
     }
-    async getErc20Decimals(tokenAddress) {
-        const provider = this.aaManager.getProvider();
-        const token = new Contract(tokenAddress, ['function decimals() view returns (uint8)'], provider);
-        try {
-            const d = await token.decimals();
-            const n = Number(d);
-            return Number.isFinite(n) ? n : 18;
-        }
-        catch {
-            return 18;
-        }
-    }
-    /**
-     * 构建买入 UserOp
-     */
-    async buildBuyUserOp(ownerWallet, tokenAddress, buyAmountWei, ownerName) {
-        const accountInfo = await this.aaManager.getAccountInfo(ownerWallet.address);
-        const initCode = accountInfo.deployed
-            ? '0x'
-            : this.aaManager.generateInitCode(ownerWallet.address);
-        // 构建 callData: execute(portal, value=buyAmountWei, swapExactInput)
-        const swapData = encodeBuyCall(tokenAddress, buyAmountWei, 0n);
-        const callData = encodeExecute(this.portalAddress, buyAmountWei, swapData);
-        // 估算前确保 sender 有足够余额（用于模拟）
-        await this.aaManager.ensureSenderBalance(ownerWallet, accountInfo.sender, buyAmountWei + parseOkb('0.0003'), `${ownerName ?? 'owner'}/buy-prefund-before-estimate`);
-        const gasPolicy = this.config.gasPolicy ?? 'bundlerEstimate';
-        const { userOp, prefundWei } = gasPolicy === 'fixed'
-            ? await this.aaManager.buildUserOpWithFixedGas({
-                ownerWallet,
-                sender: accountInfo.sender,
-                callData,
-                nonce: accountInfo.nonce,
-                initCode,
-                deployed: accountInfo.deployed,
-                fixedGas: {
-                    ...(this.config.fixedGas ?? {}),
-                    callGasLimit: this.config.fixedGas?.callGasLimit ?? DEFAULT_CALL_GAS_LIMIT_BUY,
-                },
-            })
-            : await this.aaManager.buildUserOpWithBundlerEstimate({
-                ownerWallet,
-                sender: accountInfo.sender,
-                callData,
-                nonce: accountInfo.nonce,
-                initCode,
-            });
-        // 补足 prefund + 买入金额
-        await this.aaManager.ensureSenderBalance(ownerWallet, accountInfo.sender, buyAmountWei + prefundWei + parseOkb('0.0002'), `${ownerName ?? 'owner'}/buy-fund`);
-        // 签名
-        const signed = await this.aaManager.signUserOp(userOp, ownerWallet);
-        return {
-            ...signed,
-            prefundWei,
-            ownerName,
-        };
-    }
     /**
      * 构建授权 UserOp
      */
@@ -409,23 +353,6 @@ export class BundleExecutor {
         const signed = await this.aaManager.signUserOp(userOp, ownerWallet);
         return { ...signed, prefundWei, ownerName };
     }
-    /**
-     * 构建归集 UserOp（将 OKB 从 sender 转回 owner）
-     */
-    async buildWithdrawUserOp(ownerWallet, reserveWei, ownerName) {
-        const accountInfo = await this.aaManager.getAccountInfo(ownerWallet.address);
-        const senderBalance = await this.portalQuery.getOkbBalance(accountInfo.sender);
-        const initCode = accountInfo.deployed ? '0x' : this.aaManager.generateInitCode(ownerWallet.address);
-        return await this.buildWithdrawUserOpWithState({
-            ownerWallet,
-            sender: accountInfo.sender,
-            nonce: accountInfo.nonce,
-            initCode,
-            senderBalance,
-            reserveWei,
-            ownerName,
-        });
-    }
     /**
      * 构建归集 UserOp（已知 sender/nonce/balance 的快速版本）
      * - 用于批量流程：避免重复 getAccountInfo / getOkbBalance
@@ -527,42 +454,16 @@ export class BundleExecutor {
         return { ...signed, prefundWei, ownerName: params.ownerName };
     }
     /**
-     * 构建代币转账 UserOp（将代币从 sender 转回 owner）
+     * 获取代币精度 (用于内部逻辑)
      */
-    async buildTransferTokenUserOp(ownerWallet, tokenAddress, ownerName) {
-        const accountInfo = await this.aaManager.getAccountInfo(ownerWallet.address);
-        const tokenBalance = await this.portalQuery.getTokenBalance(tokenAddress, accountInfo.sender);
-        if (tokenBalance === 0n) {
-            console.log(`\n[${ownerName ?? 'owner'}] sender 没有代币，跳过转账`);
-            return null;
+    async getErc20Decimals(tokenAddress) {
+        const token = new Contract(tokenAddress, ['function decimals() view returns (uint8)'], this.aaManager.getProvider());
+        try {
+            return Number(await token.decimals());
+        }
+        catch {
+            return 18;
         }
-        const transferData = encodeTransferCall(ownerWallet.address, tokenBalance);
-        const callData = encodeExecute(tokenAddress, 0n, transferData);
-        await this.aaManager.ensureSenderBalance(ownerWallet, accountInfo.sender, parseOkb('0.0002'), `${ownerName ?? 'owner'}/transfer-prefund`);
-        const gasPolicy = this.config.gasPolicy ?? 'bundlerEstimate';
-        const { userOp, prefundWei } = gasPolicy === 'fixed'
-            ? await this.aaManager.buildUserOpWithFixedGas({
-                ownerWallet,
-                sender: accountInfo.sender,
-                callData,
-                nonce: accountInfo.nonce,
-                initCode: accountInfo.deployed ? '0x' : this.aaManager.generateInitCode(ownerWallet.address),
-                deployed: accountInfo.deployed,
-                fixedGas: {
-                    ...(this.config.fixedGas ?? {}),
-                    callGasLimit: this.config.fixedGas?.callGasLimit ?? DEFAULT_CALL_GAS_LIMIT_TRANSFER,
-                },
-            })
-            : await this.aaManager.buildUserOpWithBundlerEstimate({
-                ownerWallet,
-                sender: accountInfo.sender,
-                callData,
-                nonce: accountInfo.nonce,
-            });
-        await this.aaManager.ensureSenderBalance(ownerWallet, accountInfo.sender, prefundWei + parseOkb('0.00005'), `${ownerName ?? 'owner'}/transfer-fund`);
-        console.log(`\n[${ownerName ?? 'owner'}] transfer token: ${tokenBalance.toString()}`);
-        const signed = await this.aaManager.signUserOp(userOp, ownerWallet);
-        return { ...signed, prefundWei, ownerName };
     }
     // ============================================================================
     // 公开 API
@@ -1628,6 +1529,160 @@ export class BundleExecutor {
             }
         };
     }
+    /**
+     * 捆绑买到毕业（签名版本）
+     *
+     * 自动计算剩余毕业容量，将钱包分为内盘和外盘组，生成签名的交易列表
+     */
+    async bundleGraduateBuy(params) {
+        const { tokenAddress, privateKeys, payerPrivateKey, amountMode, totalBuyAmount, minAmount, maxAmount, walletAmounts, enableDexBuy = false, config = {} } = params;
+        const aaManager = this.getAAManager();
+        const provider = aaManager.getProvider();
+        // 1. 获取代币状态，计算剩余毕业容量
+        const tokenState = await this.portalQuery.getTokenV5(tokenAddress);
+        const poolReserveOkb = ethers.formatEther(tokenState.reserve);
+        const graduateCapacity = 73.38; // 毕业阈值
+        const remainingToGraduate = Math.max(0, graduateCapacity - parseFloat(poolReserveOkb));
+        const remainingToGraduateWei = ethers.parseEther(remainingToGraduate.toFixed(18));
+        console.log(`[GraduateBuy] Pool Reserve: ${poolReserveOkb} OKB, Remaining: ${remainingToGraduate} OKB`);
+        // 2. 准备钱包
+        const sharedProvider = this.aaManager.getProvider();
+        const wallets = privateKeys.map(pk => new Wallet(pk, sharedProvider));
+        const payerWallet = new Wallet(payerPrivateKey, sharedProvider);
+        const payerAccount = await aaManager.getAccountInfo(payerWallet.address);
+        const nonceMap = new AANonceMap();
+        nonceMap.init(payerAccount.sender, payerAccount.nonce);
+        // 3. 计算每个钱包的金额
+        let finalAmounts = [];
+        if (amountMode === 'average') {
+            const avg = (totalBuyAmount || 0) / wallets.length;
+            finalAmounts = wallets.map(() => avg);
+        }
+        else if (amountMode === 'random') {
+            let total = 0;
+            finalAmounts = wallets.map(() => {
+                const amt = (minAmount || 0) + Math.random() * ((maxAmount || 0) - (minAmount || 0));
+                total += amt;
+                return amt;
+            });
+        }
+        else if (amountMode === 'custom') {
+            finalAmounts = wallets.map(w => walletAmounts?.[w.address] || 0);
+        }
+        // 4. 钱包分组
+        const curveBuyers = [];
+        const dexBuyers = [];
+        let currentCurveTotal = 0n;
+        for (let i = 0; i < wallets.length; i++) {
+            const wallet = wallets[i];
+            const amountWei = ethers.parseEther(finalAmounts[i].toFixed(18));
+            if (currentCurveTotal < remainingToGraduateWei) {
+                const needed = remainingToGraduateWei - currentCurveTotal;
+                if (amountWei <= needed) {
+                    curveBuyers.push({ wallet, amount: amountWei });
+                    currentCurveTotal += amountWei;
+                }
+                else {
+                    // 当前钱包金额超过了剩余容量，将其限制为 needed
+                    curveBuyers.push({ wallet, amount: needed });
+                    currentCurveTotal = remainingToGraduateWei;
+                    // 超出部分暂不处理（遵循单钱包单属性逻辑）
+                }
+            }
+            else if (enableDexBuy) {
+                dexBuyers.push({ wallet, amount: amountWei });
+            }
+        }
+        // 5. 构建 UserOps
+        const effConfig = { ...(this.config ?? {}), ...(config ?? {}) };
+        const signedTransactions = [];
+        const ops1 = [];
+        // --- 内盘 Ops ---
+        const curveBuyerInfos = await mapWithConcurrency(curveBuyers.map(b => b.wallet), 5, async (w) => {
+            const info = await aaManager.getAccountInfo(w.address);
+            nonceMap.init(info.sender, info.nonce);
+            return info;
+        });
+        const signedCurveBuyOps = await mapWithConcurrency(curveBuyers, 5, async (data, i) => {
+            const { wallet, amount } = data;
+            const info = curveBuyerInfos[i];
+            const buyData = encodeBuyCall(tokenAddress, amount, 0n);
+            const buyCallData = encodeExecute(FLAP_PORTAL, amount, buyData);
+            const buyOpRes = await aaManager.buildUserOpWithFixedGas({
+                ownerWallet: wallet,
+                sender: info.sender,
+                callData: buyCallData,
+                nonce: nonceMap.next(info.sender),
+                initCode: info.deployed ? '0x' : (await aaManager.generateInitCode(wallet.address)),
+                deployed: info.deployed,
+                fixedGas: { callGasLimit: 8000000n } // 毕业买入给高 Gas
+            });
+            const signedBuyOp = await aaManager.signUserOp(buyOpRes.userOp, wallet);
+            return signedBuyOp.userOp;
+        });
+        ops1.push(...signedCurveBuyOps);
+        // 签名第一个 handleOps (内盘)
+        const startNonce = params.payerStartNonce ?? (await provider.getTransactionCount(payerWallet.address, 'pending'));
+        const signedMainTx = await this.signHandleOpsTx({
+            ops: ops1,
+            payerWallet: payerWallet,
+            beneficiary: params.beneficiary ?? payerWallet.address,
+            nonce: startNonce,
+            gasLimit: effConfig.gasLimit,
+            gasPrice: effConfig.minGasPriceGwei ? ethers.parseUnits(effConfig.minGasPriceGwei.toString(), 'gwei') : undefined
+        });
+        signedTransactions.push(signedMainTx);
+        // --- 外盘 Ops ---
+        let totalDexBuyWei = 0n;
+        if (enableDexBuy && dexBuyers.length > 0) {
+            const dexBuyerInfos = await mapWithConcurrency(dexBuyers.map(b => b.wallet), 5, async (w) => {
+                const info = await aaManager.getAccountInfo(w.address);
+                nonceMap.init(info.sender, info.nonce);
+                return info;
+            });
+            const ops2 = [];
+            const deadline = Math.floor(Date.now() / 1000) + 1200;
+            const signedDexBuyOps = await mapWithConcurrency(dexBuyers, 5, async (data, i) => {
+                const { wallet, amount } = data;
+                const info = dexBuyerInfos[i];
+                totalDexBuyWei += amount;
+                const approveData = encodeApproveCall(POTATOSWAP_V2_ROUTER);
+                const swapData = encodeSwapExactETHForTokensSupportingFee(0n, [WOKB, tokenAddress], info.sender, deadline);
+                const batchCallData = encodeExecuteBatch([tokenAddress, POTATOSWAP_V2_ROUTER], [0n, amount], [approveData, swapData]);
+                const dexBuyOpRes = await aaManager.buildUserOpWithFixedGas({
+                    ownerWallet: wallet,
+                    sender: info.sender,
+                    callData: batchCallData,
+                    nonce: nonceMap.next(info.sender),
+                    initCode: info.deployed ? '0x' : (await aaManager.generateInitCode(wallet.address)),
+                    deployed: info.deployed,
+                    fixedGas: { callGasLimit: 600000n }
+                });
+                const signedDexBuyOp = await aaManager.signUserOp(dexBuyOpRes.userOp, wallet);
+                return signedDexBuyOp.userOp;
+            });
+            ops2.push(...signedDexBuyOps);
+            const signedDexTx = await this.signHandleOpsTx({
+                ops: ops2,
+                payerWallet: payerWallet,
+                beneficiary: params.beneficiary ?? payerWallet.address,
+                nonce: startNonce + 1,
+                gasLimit: effConfig.gasLimit,
+                gasPrice: effConfig.minGasPriceGwei ? ethers.parseUnits(effConfig.minGasPriceGwei.toString(), 'gwei') : undefined
+            });
+            signedTransactions.push(signedDexTx);
+        }
+        return {
+            signedTransactions,
+            metadata: {
+                curveCount: curveBuyers.length,
+                dexCount: dexBuyers.length,
+                curveTotalAmount: ethers.formatEther(currentCurveTotal),
+                dexTotalAmount: ethers.formatEther(totalDexBuyWei),
+                tokenAddress
+            }
+        };
+    }
     // ============================================================================
     // 预授权 API（一键授权，提升交易速度）
     // ============================================================================
@@ -1832,12 +1887,19 @@ export async function bundleCreateBuySign(params) {
     return executor.bundleCreateBuySign(params);
 }
 /**
- * 快速一键发射到外盘（仅签名，AA 模式）
+ * 快速捆绑发射到外盘（仅签名，AA 模式）
  */
 export async function bundleCreateToDexSign(params) {
     const executor = createBundleExecutor(params.config);
     return executor.bundleCreateToDexSign(params);
 }
+/**
+ * 快速买到毕业（仅签名，AA 模式）
+ */
+export async function bundleGraduateBuy(params) {
+    const executor = createBundleExecutor(params.config);
+    return executor.bundleGraduateBuy(params);
+}
 /**
  * 快速预授权
  *

package/dist/xlayer/index.d.ts

@@ -62,7 +62,7 @@ import type { BundleSwapSignParams, BundleSwapSignResult, BundleBatchSwapSignPar
 export { BundlerClient, createBundlerClient, type BundlerConfig, type BundlerReceipt, } from './bundler.js';
 export { AAAccountManager, createAAAccountManager, predictSender, createWallet, encodeExecute, encodeExecuteBatch, generateAAWallets, generateAAWalletsFromMnemonic, predictSendersFromPrivateKeys, type GeneratedAAWallet, type GenerateAAWalletsParams, type GenerateAAWalletsResult, } from './aa-account.js';
 export { encodeBuyCall, encodeSellCall, encodeApproveCall, encodeTransferCall, PortalQuery, createPortalQuery, applySlippage, formatOkb, parseOkb, formatTokenAmount, parseTokenAmount, type PortalQueryConfig, } from './portal-ops.js';
-export { BundleExecutor, createBundleExecutor, bundleBuy, bundleSell, bundleBuySell, bundleCreateBuySign, bundleCreateToDexSign, bundlePreApprove, checkApprovalStatus, } from './bundle.js';
+export { BundleExecutor, createBundleExecutor, bundleBuy, bundleSell, bundleBuySell, bundleCreateBuySign, bundleCreateToDexSign, bundleGraduateBuy, bundlePreApprove, checkApprovalStatus, } from './bundle.js';
 export { DexBundleExecutor, createDexBundleExecutor, dexBundleBuySell, type DexBundleConfig, type DexBundleBuySellParams, } from './dex-bundle.js';
 export { AAPortalSwapExecutor, } from './portal-bundle-swap.js';
 export { AADexSwapExecutor, } from './dex-bundle-swap.js';
@@ -90,6 +90,7 @@ export declare const xlayer: {
     bundleBuySell: (params: import("./types.js").BundleBuySellParams) => Promise<import("./types.js").BundleBuySellResult>;
     bundleCreateBuySign: (params: import("./types.js").BundleCreateBuySignParams) => Promise<import("./types.js").BundleCreateBuySignResult>;
     bundleCreateToDexSign: (params: import("./types.js").BundleCreateToDexSignParams) => Promise<import("./types.js").BundleCreateToDexSignResult>;
+    bundleGraduateBuy: (params: import("./types.js").BundleGraduateBuyParams) => Promise<import("./types.js").BundleGraduateBuyResult>;
     bundleSwapSign: (params: BundleSwapSignParams & {
         skipApprovalCheck?: boolean;
     }) => Promise<BundleSwapSignResult>;

package/dist/xlayer/index.js

@@ -81,7 +81,7 @@ export { encodeBuyCall, encodeSellCall, encodeApproveCall, encodeTransferCall, P
 // ============================================================================
 // 捆绑交易
 // ============================================================================
-export { BundleExecutor, createBundleExecutor, bundleBuy, bundleSell, bundleBuySell, bundleCreateBuySign, bundleCreateToDexSign, 
+export { BundleExecutor, createBundleExecutor, bundleBuy, bundleSell, bundleBuySell, bundleCreateBuySign, bundleCreateToDexSign, bundleGraduateBuy, 
 // 预授权（一键授权）
 bundlePreApprove, checkApprovalStatus, } from './bundle.js';
 // ============================================================================
@@ -165,6 +165,10 @@ export const xlayer = {
         const { bundleCreateToDexSign } = await import('./bundle.js');
         return bundleCreateToDexSign(...args);
     },
+    bundleGraduateBuy: async (...args) => {
+        const { bundleGraduateBuy } = await import('./bundle.js');
+        return bundleGraduateBuy(...args);
+    },
     // 捆绑换手（AA）：仅签名（raw signed tx）
     bundleSwapSign: async (...args) => bundleSwapSign(...args),
     bundleBatchSwapSign: async (...args) => bundleBatchSwapSign(...args),

package/dist/xlayer/types.d.ts

@@ -835,3 +835,46 @@ export declare class AANonceMap {
  * 必需的配置字段
  */
 export type RequiredConfig = Required<Pick<XLayerConfig, 'rpcUrl' | 'bundlerUrl' | 'chainId' | 'entryPoint' | 'factory'>>;
+/**
+ * 捆绑买到毕业签名参数
+ */
+export interface BundleGraduateBuyParams {
+    /** 代位地址 */
+    tokenAddress: string;
+    /** 买入钱包私钥数组 */
+    privateKeys: string[];
+    /** AA Payer 私钥 */
+    payerPrivateKey: string;
+    /** 分配模式 */
+    amountMode: 'average' | 'random' | 'custom';
+    /** 平均模式：总买入金额 */
+    totalBuyAmount?: number;
+    /** 随机模式：最小金额 / 最大金额 */
+    minAmount?: number;
+    maxAmount?: number;
+    /** 自定义模式：地址 -> 金额 */
+    walletAmounts?: Record<string, number>;
+    /** 是否启用外盘买入（默认 false） */
+    enableDexBuy?: boolean;
+    /** 配置覆盖 */
+    config?: Partial<XLayerConfig>;
+    /** Payer 起始 nonce */
+    payerStartNonce?: number;
+    /** beneficiary（默认 payer 地址） */
+    beneficiary?: string;
+}
+/**
+ * 捆绑买到毕业签名结果
+ */
+export interface BundleGraduateBuyResult {
+    /** raw signed tx 列表 */
+    signedTransactions: string[];
+    /** 元数据 */
+    metadata: {
+        curveCount: number;
+        dexCount: number;
+        curveTotalAmount: string;
+        dexTotalAmount: string;
+        tokenAddress: string;
+    };
+}

package/package.json

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