four-flap-meme-sdk 1.5.33 → 1.5.34

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

@@ -0,0 +1,404 @@
+/**
+ * XLayer AA Buy-First（外盘 / PotatoSwap V2）
+ *
+ * 对齐 BSC buy-first 思路：
+ * - 买方先买入（OKB -> token）
+ * - 卖方再卖出等值 token（token -> OKB，卖方需要预持仓）
+ * - ✅ 利润：在卖出后归集阶段刮取
+ */
+import { Contract, Interface, Wallet, ethers } from 'ethers';
+import { AANonceMap } from './types.js';
+import { ENTRYPOINT_ABI, DEFAULT_WITHDRAW_RESERVE, POTATOSWAP_V2_ROUTER, WOKB, } from './constants.js';
+import { AAAccountManager, encodeExecute, encodeExecuteBatch } from './aa-account.js';
+import { DexQuery, encodeSwapExactETHForTokensSupportingFee, encodeSwapExactTokensForETHSupportingFee } from './dex.js';
+import { PortalQuery, encodeApproveCall, parseOkb } from './portal-ops.js';
+import { mapWithConcurrency } from '../utils/concurrency.js';
+import { PROFIT_CONFIG } from '../utils/constants.js';
+// 固定 gas（用于减少 RPC 与提高可控性）
+const DEFAULT_CALL_GAS_LIMIT_BUY = 450000n;
+const DEFAULT_CALL_GAS_LIMIT_SELL = 450000n;
+const DEFAULT_CALL_GAS_LIMIT_APPROVE = 200000n;
+const DEFAULT_CALL_GAS_LIMIT_WITHDRAW = 120000n;
+function getDexDeadline(minutes = 20) {
+    return Math.floor(Date.now() / 1000) + minutes * 60;
+}
+function resolveProfitSettings(config) {
+    const extractProfit = config?.extractProfit !== false; // 默认 true
+    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;
+    return { extractProfit, profitBps, profitRecipient };
+}
+function calculateProfitWei(amountWei, profitBps) {
+    if (amountWei <= 0n)
+        return 0n;
+    if (!Number.isFinite(profitBps) || profitBps <= 0)
+        return 0n;
+    return (amountWei * BigInt(profitBps)) / 10000n;
+}
+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;
+}
+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)); // [0.5,1.5)
+        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 class AADexBuyFirstExecutor {
+    constructor(config = {}) {
+        this.config = config;
+        this.aaManager = new AAAccountManager(config);
+        this.portalQuery = new PortalQuery({ rpcUrl: config.rpcUrl, chainId: config.chainId });
+        this.dexQuery = new DexQuery({ rpcUrl: config.rpcUrl, chainId: config.chainId });
+    }
+    getEffectiveRouter(params) {
+        if (params.routerAddress)
+            return params.routerAddress;
+        if (params.dexKey === 'DYORSWAP') {
+            return '0xfb001fbbace32f09cb6d3c449b935183de53ee96';
+        }
+        return POTATOSWAP_V2_ROUTER;
+    }
+    async runHandleOps(label, ops, bundlerSigner, beneficiary) {
+        const provider = this.aaManager.getProvider();
+        const entryPointAddress = this.aaManager.getEntryPointAddress();
+        const feeData = await provider.getFeeData();
+        console.log(`\n[${label}] 发送 handleOps，ops=${ops.length} ...`);
+        const entryPointWithSigner = new Contract(entryPointAddress, ENTRYPOINT_ABI, bundlerSigner);
+        const tx = await entryPointWithSigner.handleOps(ops, beneficiary, { gasPrice: feeData.gasPrice ?? 100000000n });
+        console.log(`[${label}] txHash:`, tx.hash);
+        const receipt = await tx.wait();
+        console.log(`[${label}] mined block=${receipt.blockNumber} status=${receipt.status}`);
+        const epIface = new Interface(ENTRYPOINT_ABI);
+        const userOpEvents = [];
+        for (const log of receipt.logs) {
+            try {
+                const parsed = epIface.parseLog(log);
+                if (parsed?.name === 'UserOperationEvent') {
+                    const e = parsed.args;
+                    userOpEvents.push({
+                        userOpHash: e.userOpHash,
+                        sender: e.sender,
+                        paymaster: e.paymaster,
+                        success: e.success,
+                        actualGasCost: e.actualGasCost,
+                        actualGasUsed: e.actualGasUsed,
+                    });
+                }
+            }
+            catch { }
+        }
+        return { txHash: tx.hash, blockNumber: receipt.blockNumber, status: receipt.status, userOpEvents };
+    }
+    pickWallets(privateKeys, n) {
+        const provider = this.aaManager.getProvider();
+        const wallets = privateKeys.map((pk) => new Wallet(pk, provider));
+        if (!n || n <= 0 || n >= wallets.length)
+            return wallets;
+        return wallets.slice(0, n);
+    }
+    async buildWithdrawUserOp(params) {
+        const senderBalance = params.senderBalance;
+        if (senderBalance <= params.reserveWei)
+            return null;
+        const effConfig = { ...(this.config ?? {}), ...(params.configOverride ?? {}) };
+        const gasPolicyRaw = effConfig.gasPolicy ?? 'bundlerEstimate';
+        const gasPolicy = gasPolicyRaw === 'bundlerEstimate' ? 'fixed' : gasPolicyRaw;
+        const tempCallData = encodeExecute(params.ownerWallet.address, 0n, '0x');
+        const { prefundWei } = gasPolicy === 'fixed'
+            ? await this.aaManager.buildUserOpWithFixedGas({
+                ownerWallet: params.ownerWallet,
+                sender: params.sender,
+                callData: tempCallData,
+                nonce: params.nonce,
+                initCode: params.initCode,
+                deployed: params.initCode === '0x',
+                fixedGas: {
+                    ...(effConfig.fixedGas ?? {}),
+                    callGasLimit: effConfig.fixedGas?.callGasLimit ?? DEFAULT_CALL_GAS_LIMIT_WITHDRAW,
+                },
+            })
+            : await this.aaManager.buildUserOpWithLocalEstimate({
+                ownerWallet: params.ownerWallet,
+                sender: params.sender,
+                callData: tempCallData,
+                nonce: params.nonce,
+                initCode: params.initCode,
+            });
+        const withdrawAmount = senderBalance > prefundWei + params.reserveWei
+            ? senderBalance - prefundWei - params.reserveWei
+            : 0n;
+        if (withdrawAmount <= 0n)
+            return null;
+        const { extractProfit, profitBps, profitRecipient } = resolveProfitSettings(effConfig);
+        const profitWei = extractProfit ? calculateProfitWei(withdrawAmount, profitBps) : 0n;
+        const toOwnerWei = withdrawAmount - profitWei;
+        const callData = extractProfit && profitWei > 0n
+            ? encodeExecuteBatch([profitRecipient, params.ownerWallet.address], [profitWei, toOwnerWei], ['0x', '0x'])
+            : encodeExecute(params.ownerWallet.address, withdrawAmount, '0x');
+        const { userOp } = gasPolicy === 'fixed'
+            ? await this.aaManager.buildUserOpWithFixedGas({
+                ownerWallet: params.ownerWallet,
+                sender: params.sender,
+                callData,
+                nonce: params.nonce,
+                initCode: params.initCode,
+                deployed: params.initCode === '0x',
+                fixedGas: {
+                    ...(effConfig.fixedGas ?? {}),
+                    callGasLimit: effConfig.fixedGas?.callGasLimit ?? DEFAULT_CALL_GAS_LIMIT_WITHDRAW,
+                },
+            })
+            : await this.aaManager.buildUserOpWithLocalEstimate({
+                ownerWallet: params.ownerWallet,
+                sender: params.sender,
+                callData,
+                nonce: params.nonce,
+                initCode: params.initCode,
+            });
+        return { userOp, prefundWei, profitWei };
+    }
+    async safeQuoteBuy(tokenAddress, okbAmount) {
+        if (okbAmount <= 0n)
+            return 0n;
+        try {
+            return await this.dexQuery.quoteOkbToToken(okbAmount, tokenAddress);
+        }
+        catch {
+            return 0n;
+        }
+    }
+    async execute(params) {
+        const { tradeType = 'V2', dexKey, routerAddress, deadlineMinutes = 20, tokenAddress, buyerPrivateKeys, sellerPrivateKeys, buyerFunds, buyCount, sellCount, slippageBps = 0, withdrawToOwner = true, withdrawReserve = DEFAULT_WITHDRAW_RESERVE, config, } = params;
+        if (tradeType !== 'V2') {
+            throw new Error('AADexBuyFirstExecutor 仅支持 tradeType=V2（外盘）');
+        }
+        const effectiveRouter = this.getEffectiveRouter({ dexKey, routerAddress });
+        const deadline = getDexDeadline(deadlineMinutes);
+        const buyers = this.pickWallets(buyerPrivateKeys, buyCount);
+        const sellers = this.pickWallets(sellerPrivateKeys, sellCount);
+        if (buyers.length === 0)
+            throw new Error('buyCount=0 或 buyerPrivateKeys 为空');
+        if (sellers.length === 0)
+            throw new Error('sellCount=0 或 sellerPrivateKeys 为空');
+        const effConfig = { ...(this.config ?? {}), ...(config ?? {}) };
+        const profitSettings = resolveProfitSettings(effConfig);
+        const totalBuyWei = parseOkb(String(buyerFunds));
+        if (totalBuyWei <= 0n)
+            throw new Error('buyerFunds 需要 > 0');
+        const buyAmountsWei = splitAmount(totalBuyWei, buyers.length);
+        const quotedPerBuy = await mapWithConcurrency(buyAmountsWei, 6, async (amt) => this.safeQuoteBuy(tokenAddress, amt));
+        const quotedTotalTokenOut = quotedPerBuy.reduce((a, b) => a + (b ?? 0n), 0n);
+        const estimatedTokenOutWei = (quotedTotalTokenOut * BigInt(10000 - Math.max(0, Math.min(10000, slippageBps)))) / 10000n;
+        if (estimatedTokenOutWei <= 0n) {
+            throw new Error('买入报价为 0，无法规划 sellAmount（可能无流动性）');
+        }
+        const sellAmountsWei = splitAmount(estimatedTokenOutWei, sellers.length);
+        // account infos
+        const buyerAis = await this.aaManager.getMultipleAccountInfo(buyers.map((w) => w.address));
+        const sellerAis = await this.aaManager.getMultipleAccountInfo(sellers.map((w) => w.address));
+        const nonceMap = new AANonceMap();
+        for (const ai of buyerAis)
+            nonceMap.init(ai.sender, ai.nonce);
+        for (const ai of sellerAis)
+            nonceMap.init(ai.sender, ai.nonce);
+        // initCode：确保同一 sender 只在第一笔 op 携带
+        const initCodeBySenderLower = new Map();
+        const initIfNeeded = (sender, deployed, ownerAddress) => {
+            const k = sender.toLowerCase();
+            if (initCodeBySenderLower.has(k))
+                return;
+            initCodeBySenderLower.set(k, deployed ? '0x' : this.aaManager.generateInitCode(ownerAddress));
+        };
+        const consumeInitCode = (sender) => {
+            const k = sender.toLowerCase();
+            const cur = initCodeBySenderLower.get(k);
+            if (cur === undefined)
+                throw new Error(`initCode not initialized for sender: ${sender}`);
+            if (cur !== '0x')
+                initCodeBySenderLower.set(k, '0x');
+            return cur;
+        };
+        for (let i = 0; i < buyers.length; i++)
+            initIfNeeded(buyerAis[i].sender, buyerAis[i].deployed, buyers[i].address);
+        for (let i = 0; i < sellers.length; i++)
+            initIfNeeded(sellerAis[i].sender, sellerAis[i].deployed, sellers[i].address);
+        // 卖方预持仓检查
+        const sellerSenders = sellerAis.map((ai) => ai.sender);
+        const sellerTokenBalances = await this.portalQuery.getMultipleTokenBalances(tokenAddress, sellerSenders);
+        for (let i = 0; i < sellers.length; i++) {
+            const sender = sellerSenders[i];
+            const needSell = sellAmountsWei[i] ?? 0n;
+            const bal = sellerTokenBalances.get(sender) ?? 0n;
+            if (needSell > bal) {
+                throw new Error(`卖方预持仓不足: sender=${sender} need=${needSell.toString()} bal=${bal.toString()}`);
+            }
+        }
+        // allowance（spender=router）
+        const sellerAllowances = await this.portalQuery.getMultipleAllowances(tokenAddress, sellerSenders, effectiveRouter);
+        const ops = [];
+        // buy ops
+        for (let i = 0; i < buyers.length; i++) {
+            const w = buyers[i];
+            const ai = buyerAis[i];
+            const sender = ai.sender;
+            const buyWei = buyAmountsWei[i] ?? 0n;
+            if (buyWei <= 0n)
+                continue;
+            const swapData = encodeSwapExactETHForTokensSupportingFee(0n, [WOKB, tokenAddress], sender, deadline);
+            const callData = encodeExecute(effectiveRouter, buyWei, swapData);
+            const { userOp, prefundWei } = await this.aaManager.buildUserOpWithFixedGas({
+                ownerWallet: w,
+                sender,
+                nonce: nonceMap.next(sender),
+                initCode: consumeInitCode(sender),
+                callData,
+                deployed: ai.deployed,
+                fixedGas: {
+                    ...(effConfig.fixedGas ?? {}),
+                    callGasLimit: effConfig.fixedGas?.callGasLimit ?? DEFAULT_CALL_GAS_LIMIT_BUY,
+                },
+            });
+            await this.aaManager.ensureSenderBalance(w, sender, buyWei + prefundWei + parseOkb('0.0001'), `buyFirstDex/buyer${i + 1}/fund`);
+            const signed = await this.aaManager.signUserOp(userOp, w);
+            ops.push(signed.userOp);
+        }
+        // seller approve + sell ops
+        for (let i = 0; i < sellers.length; i++) {
+            const w = sellers[i];
+            const ai = sellerAis[i];
+            const sender = ai.sender;
+            const sellWei = sellAmountsWei[i] ?? 0n;
+            if (sellWei <= 0n)
+                continue;
+            const allowance = sellerAllowances.get(sender) ?? 0n;
+            if (allowance < sellWei) {
+                const approveCallData = encodeExecute(tokenAddress, 0n, encodeApproveCall(effectiveRouter, ethers.MaxUint256));
+                const { userOp: approveOp, prefundWei } = await this.aaManager.buildUserOpWithFixedGas({
+                    ownerWallet: w,
+                    sender,
+                    nonce: nonceMap.next(sender),
+                    initCode: consumeInitCode(sender),
+                    callData: approveCallData,
+                    deployed: ai.deployed,
+                    fixedGas: {
+                        ...(effConfig.fixedGas ?? {}),
+                        callGasLimit: effConfig.fixedGas?.callGasLimit ?? DEFAULT_CALL_GAS_LIMIT_APPROVE,
+                    },
+                });
+                await this.aaManager.ensureSenderBalance(w, sender, prefundWei + parseOkb('0.0001'), `buyFirstDex/seller${i + 1}/approve-fund`);
+                const signedApprove = await this.aaManager.signUserOp(approveOp, w);
+                ops.push(signedApprove.userOp);
+            }
+            const sellSwapData = encodeSwapExactTokensForETHSupportingFee(sellWei, 0n, [tokenAddress, WOKB], sender, deadline);
+            const sellCallData = encodeExecute(effectiveRouter, 0n, sellSwapData);
+            const { userOp: sellOp, prefundWei: sellPrefund } = await this.aaManager.buildUserOpWithFixedGas({
+                ownerWallet: w,
+                sender,
+                nonce: nonceMap.next(sender),
+                initCode: consumeInitCode(sender),
+                callData: sellCallData,
+                deployed: ai.deployed,
+                fixedGas: {
+                    ...(effConfig.fixedGas ?? {}),
+                    callGasLimit: effConfig.fixedGas?.callGasLimit ?? DEFAULT_CALL_GAS_LIMIT_SELL,
+                },
+            });
+            await this.aaManager.ensureSenderBalance(w, sender, sellPrefund + parseOkb('0.0001'), `buyFirstDex/seller${i + 1}/sell-fund`);
+            const signedSell = await this.aaManager.signUserOp(sellOp, w);
+            ops.push(signedSell.userOp);
+        }
+        if (ops.length === 0)
+            throw new Error('本轮没有生成任何 UserOp');
+        const payerWallet = buyers[0];
+        const beneficiary = payerWallet.address;
+        const buySellResult = await this.runHandleOps('aa-buy-first/dex', ops, payerWallet, beneficiary);
+        let withdrawResult;
+        let finalSellerBalances;
+        let totalProfitWei = 0n;
+        if (withdrawToOwner) {
+            const reserveWei = parseOkb(withdrawReserve);
+            const sellerOkbBalances = await this.portalQuery.getMultipleOkbBalances(sellerSenders);
+            const withdrawOps = [];
+            const builtOps = await mapWithConcurrency(sellers, 3, async (w, i) => {
+                const sender = sellerAis[i].sender;
+                const senderBalance = sellerOkbBalances.get(sender) ?? 0n;
+                const usedNonce = nonceMap.peek(sender);
+                const built = await this.buildWithdrawUserOp({
+                    ownerWallet: w,
+                    sender,
+                    nonce: usedNonce,
+                    initCode: '0x',
+                    senderBalance,
+                    reserveWei,
+                    configOverride: config,
+                });
+                if (!built)
+                    return null;
+                nonceMap.commit(sender, usedNonce);
+                totalProfitWei += built.profitWei;
+                const signed = await this.aaManager.signUserOp(built.userOp, w);
+                return signed.userOp;
+            });
+            for (const op of builtOps)
+                if (op)
+                    withdrawOps.push(op);
+            if (withdrawOps.length > 0) {
+                withdrawResult = await this.runHandleOps('aa-buy-first/dex-withdraw', withdrawOps, payerWallet, beneficiary);
+            }
+            finalSellerBalances = await this.portalQuery.getMultipleOkbBalances(sellerSenders);
+        }
+        return {
+            buySellResult,
+            withdrawResult,
+            finalSellerBalances,
+            profit: withdrawToOwner
+                ? {
+                    extractProfit: profitSettings.extractProfit,
+                    profitBps: profitSettings.profitBps,
+                    profitRecipient: profitSettings.profitRecipient,
+                    totalProfitWei: totalProfitWei.toString(),
+                }
+                : undefined,
+            metadata: {
+                tradeType: 'V2',
+                tokenAddress,
+                buyerOwners: buyers.map((w) => w.address),
+                buyerSenders: buyerAis.map((ai) => ai.sender),
+                sellerOwners: sellers.map((w) => w.address),
+                sellerSenders,
+                buyAmountsWei: buyAmountsWei.map((x) => x.toString()),
+                sellAmountsWei: sellAmountsWei.map((x) => x.toString()),
+                totalBuyWei: totalBuyWei.toString(),
+                estimatedTokenOutWei: estimatedTokenOutWei.toString(),
+                slippageBps,
+            },
+        };
+    }
+}
+export function createAADexBuyFirstExecutor(config) {
+    return new AADexBuyFirstExecutor(config);
+}

package/dist/xlayer/index.d.ts

@@ -66,6 +66,9 @@ export { BundleExecutor, createBundleExecutor, bundleBuy, bundleSell, bundleBuyS
 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';
+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';
 /**
  * XLayer AA 换手签名 (卖 -> 买)
  */

package/dist/xlayer/index.js

@@ -91,6 +91,12 @@ export { DexBundleExecutor, createDexBundleExecutor, dexBundleBuySell, } from '.
 // ============================================================================
 export { AAPortalSwapExecutor, } from './portal-bundle-swap.js';
 export { AADexSwapExecutor, } from './dex-bundle-swap.js';
+// ============================================================================
+// AA Buy-First（刷量专用）
+// ============================================================================
+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';
 /**
  * XLayer AA 换手签名 (卖 -> 买)
  */

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

@@ -0,0 +1,30 @@
+/**
+ * XLayer AA Buy-First（内盘 / Flap Portal）
+ *
+ * 对齐 BSC buy-first 思路：
+ * - 买方先买入（多钱包随机拆分资金）
+ * - 卖方再卖出“等值 token”（卖方需要预持仓）
+ * - ✅ 利润：在“卖出后归集 OKB”阶段刮取（executeBatch 拆分给 profitRecipient + owner）
+ *
+ * 说明：
+ * - buy + sell 会放在同一笔 handleOps 内，保持“buy-first 原子”语义
+ * - withdraw 需要知道 sell 后的余额，因此单独再发一笔 handleOps
+ */
+import type { XLayerConfig } from './types.js';
+import type { BuyFirstParams, BuyFirstResult } from './types.js';
+export declare class AAPortalBuyFirstExecutor {
+    private aaManager;
+    private portalQuery;
+    private config;
+    constructor(config?: XLayerConfig);
+    private runHandleOps;
+    private pickWallets;
+    private getAccountInfos;
+    private safePreviewBuy;
+    private buildWithdrawUserOp;
+    /**
+     * 执行一轮 buy-first（内盘）
+     */
+    execute(params: BuyFirstParams): Promise<BuyFirstResult>;
+}
+export declare function createAAPortalBuyFirstExecutor(config?: XLayerConfig): AAPortalBuyFirstExecutor;