four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/domains/flap/portal-bundle-merkle/curve-to-dex/main.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Flap 内盘买到外盘 — 主流程（flapBundleCurveToDex）
+ */
+import type { FlapCurveToDexParams, FlapCurveToDexResult } from './types.js';
+/**
+ * Flap 内盘买到外盘捆绑交易
+ *
+ * 交易顺序：
+ * 1. 贿赂交易（BlockRazor）
+ * 2. 内盘买入（多个钱包在 Bonding Curve 买入）
+ * 3. 毕业触发（最后一个买家买入触发上 DEX）
+ * 4. 外盘买入（多个钱包在 PancakeSwap 买入）
+ * 5. 利润多跳转账
+ */
+export declare function flapBundleCurveToDex(params: FlapCurveToDexParams): Promise<FlapCurveToDexResult>;

package/dist/domains/flap/portal-bundle-merkle/curve-to-dex/main.js

@@ -0,0 +1,339 @@
+/**
+ * Flap 内盘买到外盘 — 主流程（flapBundleCurveToDex）
+ */
+import { getGasLimit } from '../../../../core/gas/bundle-gas.js';
+import { ethers, Contract, Wallet } from 'ethers';
+import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../../../utils/bundle-helpers.js';
+import { FLAP_PORTAL_ADDRESSES } from '../../constants.js';
+import { ZERO_ADDRESS, GAS_LIMITS } from '../../../../core/constants/index.js';
+import { getGasPriceConfig, getTxType, getProfitRecipient, getProfitRateBps, getBribeAmount, BLOCKRAZOR_BUILDER_EOA, PORTAL_ABI, } from '../config.js';
+import { createSignProvider } from '../../../../bundle/sign-context-helpers.js';
+import { splitAmountByWeight as splitAmount } from '../../../../core/amount/split-by-weight.js';
+import { PANCAKE_V3_ROUTER_ABI, getCurveToDexChainConfig } from './constants.js';
+// ==================== 主函数 ====================
+/**
+ * Flap 内盘买到外盘捆绑交易
+ *
+ * 交易顺序：
+ * 1. 贿赂交易（BlockRazor）
+ * 2. 内盘买入（多个钱包在 Bonding Curve 买入）
+ * 3. 毕业触发（最后一个买家买入触发上 DEX）
+ * 4. 外盘买入（多个钱包在 PancakeSwap 买入）
+ * 5. 利润多跳转账
+ */
+export async function flapBundleCurveToDex(params) {
+    const { chain, tokenAddress, quoteToken, quoteTokenDecimals = 18, curveBuyers, curveTotalBuyAmount, triggerGraduate = true, graduateWallet, dexBuyers = [], dexTotalBuyAmount, dexPoolType = 'v3', v3Fee = 2500, config, } = params;
+    // 验证参数
+    if (curveBuyers.length === 0) {
+        throw new Error('至少需要一个内盘买入钱包');
+    }
+    // 判断是否使用原生代币
+    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+    const inputToken = useNativeToken ? ZERO_ADDRESS : quoteToken;
+    // ✅ 获取链配置
+    const chainConfig = getCurveToDexChainConfig(chain);
+    const chainId = chainConfig.chainId;
+    // 创建 Provider
+    const provider = createSignProvider(config.rpcUrl, chainId, chain.toUpperCase());
+    const portalAddress = FLAP_PORTAL_ADDRESSES[chain.toUpperCase()];
+    const nonceManager = new NonceManager(provider);
+    // 创建钱包实例
+    const curveWallets = curveBuyers.map((b) => ({
+        wallet: new Wallet(b.privateKey, provider),
+        buyAmount: b.buyAmount,
+    }));
+    const graduateWalletInfo = graduateWallet
+        ? {
+            wallet: new Wallet(graduateWallet.privateKey, provider),
+            buyAmount: graduateWallet.buyAmount,
+        }
+        : null;
+    const dexWallets = dexBuyers.map((b) => ({
+        wallet: new Wallet(b.privateKey, provider),
+        buyAmount: b.buyAmount,
+    }));
+    // 使用第一个内盘买家作为主钱包（支付贿赂和利润）
+    const mainWallet = curveWallets[0].wallet;
+    // ✅ 第一批并行：获取 gasPrice + 所有钱包 nonces
+    const allWallets = [
+        ...curveWallets.map((c) => c.wallet),
+        ...(graduateWalletInfo ? [graduateWalletInfo.wallet] : []),
+        ...dexWallets.map((d) => d.wallet),
+    ];
+    const uniqueWallets = allWallets.filter((w, i) => {
+        const addr = w.address.toLowerCase();
+        return allWallets.findIndex((x) => x.address.toLowerCase() === addr) === i;
+    });
+    const [gasPrice, noncesArray] = await Promise.all([
+        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+        nonceManager.getNextNoncesForWallets(uniqueWallets),
+    ]);
+    // 构建 nonces Map
+    const noncesMap = new Map();
+    uniqueWallets.forEach((wallet, i) => {
+        noncesMap.set(wallet.address.toLowerCase(), noncesArray[i]);
+    });
+    const finalGasLimit = getGasLimit(config, 800000);
+    const txType = getTxType(config);
+    const priorityFee = gasPrice / 10n === 0n ? 1n : gasPrice / 10n;
+    const bribeAmount = getBribeAmount(config);
+    const needBribeTx = bribeAmount > 0n;
+    // ✅ 计算内盘买入金额
+    let curveBuyAmounts;
+    if (curveTotalBuyAmount) {
+        const total = useNativeToken
+            ? ethers.parseEther(curveTotalBuyAmount)
+            : ethers.parseUnits(curveTotalBuyAmount, quoteTokenDecimals);
+        curveBuyAmounts = splitAmount(total, curveBuyers.length);
+    }
+    else {
+        // 使用各自指定的金额
+        curveBuyAmounts = curveBuyers.map((b) => {
+            if (!b.buyAmount)
+                throw new Error('未指定 curveTotalBuyAmount 时，每个钱包必须指定 buyAmount');
+            return useNativeToken ? ethers.parseEther(b.buyAmount) : ethers.parseUnits(b.buyAmount, quoteTokenDecimals);
+        });
+    }
+    // ✅ 计算毕业买入金额
+    let graduateBuyAmount = 0n;
+    if (triggerGraduate && graduateWalletInfo) {
+        if (graduateWalletInfo.buyAmount) {
+            graduateBuyAmount = useNativeToken
+                ? ethers.parseEther(graduateWalletInfo.buyAmount)
+                : ethers.parseUnits(graduateWalletInfo.buyAmount, quoteTokenDecimals);
+        }
+        else {
+            throw new Error('触发毕业时必须指定 graduateWallet.buyAmount');
+        }
+    }
+    // ✅ 计算外盘买入金额
+    let dexBuyAmounts = [];
+    if (dexBuyers.length > 0) {
+        if (dexTotalBuyAmount) {
+            const total = useNativeToken
+                ? ethers.parseEther(dexTotalBuyAmount)
+                : ethers.parseUnits(dexTotalBuyAmount, quoteTokenDecimals);
+            dexBuyAmounts = splitAmount(total, dexBuyers.length);
+        }
+        else {
+            dexBuyAmounts = dexBuyers.map((b) => {
+                if (!b.buyAmount)
+                    throw new Error('未指定 dexTotalBuyAmount 时，每个钱包必须指定 buyAmount');
+                return useNativeToken ? ethers.parseEther(b.buyAmount) : ethers.parseUnits(b.buyAmount, quoteTokenDecimals);
+            });
+        }
+    }
+    // ✅ 计算利润
+    const totalBuyAmount = curveBuyAmounts.reduce((a, b) => a + b, 0n) + graduateBuyAmount + dexBuyAmounts.reduce((a, b) => a + b, 0n);
+    const profitAmount = (totalBuyAmount * BigInt(getProfitRateBps())) / 10000n;
+    // ==================== 构建交易 ====================
+    const allTransactions = [];
+    // 1. 贿赂交易
+    if (needBribeTx) {
+        const mainAddr = mainWallet.address.toLowerCase();
+        const bribeNonce = noncesMap.get(mainAddr);
+        noncesMap.set(mainAddr, bribeNonce + 1);
+        const bribeTx = await mainWallet.signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: bribeNonce,
+            gasPrice,
+            gasLimit: GAS_LIMITS.BRIBE,
+            chainId,
+            type: txType,
+        });
+        allTransactions.push(bribeTx);
+    }
+    // 2. 内盘买入交易
+    const curveBuyTxPromises = curveWallets.map(async ({ wallet }, i) => {
+        const addr = wallet.address.toLowerCase();
+        const nonce = noncesMap.get(addr);
+        noncesMap.set(addr, nonce + 1);
+        const portal = new Contract(portalAddress, PORTAL_ABI, wallet);
+        const unsigned = await portal.swapExactInput.populateTransaction({
+            inputToken,
+            outputToken: tokenAddress,
+            inputAmount: curveBuyAmounts[i],
+            minOutputAmount: 0n,
+            permitData: '0x',
+        }, useNativeToken ? { value: curveBuyAmounts[i] } : {});
+        const tx = {
+            ...unsigned,
+            from: wallet.address,
+            nonce,
+            gasLimit: finalGasLimit,
+            chainId,
+            type: txType,
+            value: useNativeToken ? curveBuyAmounts[i] : 0n,
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = priorityFee;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        return wallet.signTransaction(tx);
+    });
+    const signedCurveBuys = await Promise.all(curveBuyTxPromises);
+    allTransactions.push(...signedCurveBuys);
+    // 3. 毕业触发交易
+    if (triggerGraduate && graduateWalletInfo && graduateBuyAmount > 0n) {
+        const { wallet } = graduateWalletInfo;
+        const addr = wallet.address.toLowerCase();
+        const nonce = noncesMap.get(addr);
+        noncesMap.set(addr, nonce + 1);
+        const portal = new Contract(portalAddress, PORTAL_ABI, wallet);
+        const unsigned = await portal.swapExactInput.populateTransaction({
+            inputToken,
+            outputToken: tokenAddress,
+            inputAmount: graduateBuyAmount,
+            minOutputAmount: 0n,
+            permitData: '0x',
+        }, useNativeToken ? { value: graduateBuyAmount } : {});
+        const tx = {
+            ...unsigned,
+            from: wallet.address,
+            nonce,
+            gasLimit: BigInt(1_500_000), // 毕业交易需要更多 gas
+            chainId,
+            type: txType,
+            value: useNativeToken ? graduateBuyAmount : 0n,
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = priorityFee;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        const graduateTx = await wallet.signTransaction(tx);
+        allTransactions.push(graduateTx);
+    }
+    // 4. 外盘买入交易（PancakeSwap）
+    if (dexWallets.length > 0) {
+        const dexBuyTxPromises = dexWallets.map(async ({ wallet }, i) => {
+            const addr = wallet.address.toLowerCase();
+            const nonce = noncesMap.get(addr);
+            noncesMap.set(addr, nonce + 1);
+            const buyAmount = dexBuyAmounts[i];
+            // ✅ 使用链配置中的 SmartRouter 和 WrappedNative（支持 BSC/Base）
+            const smartRouter = chainConfig.smartRouter;
+            const wrappedNative = chainConfig.wrappedNative;
+            let calldata;
+            let value;
+            if (dexPoolType === 'v3') {
+                // V3: exactInputSingle
+                if (useNativeToken) {
+                    const params = {
+                        tokenIn: wrappedNative,
+                        tokenOut: tokenAddress,
+                        fee: v3Fee,
+                        recipient: wallet.address,
+                        amountIn: buyAmount,
+                        amountOutMinimum: 0n,
+                        sqrtPriceLimitX96: 0n,
+                    };
+                    const exactInputSingleData = new ethers.Interface(PANCAKE_V3_ROUTER_ABI).encodeFunctionData('exactInputSingle', [params]);
+                    calldata = new ethers.Interface(PANCAKE_V3_ROUTER_ABI).encodeFunctionData('multicall', [
+                        [exactInputSingleData],
+                    ]);
+                    value = buyAmount;
+                }
+                else {
+                    // ERC20 需要先 approve，这里简化处理（假设已授权）
+                    const params = {
+                        tokenIn: quoteToken,
+                        tokenOut: tokenAddress,
+                        fee: v3Fee,
+                        recipient: wallet.address,
+                        amountIn: buyAmount,
+                        amountOutMinimum: 0n,
+                        sqrtPriceLimitX96: 0n,
+                    };
+                    const exactInputSingleData = new ethers.Interface(PANCAKE_V3_ROUTER_ABI).encodeFunctionData('exactInputSingle', [params]);
+                    calldata = new ethers.Interface(PANCAKE_V3_ROUTER_ABI).encodeFunctionData('multicall', [
+                        [exactInputSingleData],
+                    ]);
+                    value = 0n;
+                }
+            }
+            else {
+                // V2: swapExactTokensForTokens
+                if (useNativeToken) {
+                    const swapData = new ethers.Interface(PANCAKE_V3_ROUTER_ABI).encodeFunctionData('swapExactTokensForTokens', [
+                        buyAmount,
+                        0n,
+                        [wrappedNative, tokenAddress],
+                        wallet.address,
+                    ]);
+                    calldata = new ethers.Interface(PANCAKE_V3_ROUTER_ABI).encodeFunctionData('multicall', [[swapData]]);
+                    value = buyAmount;
+                }
+                else {
+                    const swapData = new ethers.Interface(PANCAKE_V3_ROUTER_ABI).encodeFunctionData('swapExactTokensForTokens', [
+                        buyAmount,
+                        0n,
+                        [quoteToken, tokenAddress],
+                        wallet.address,
+                    ]);
+                    calldata = new ethers.Interface(PANCAKE_V3_ROUTER_ABI).encodeFunctionData('multicall', [[swapData]]);
+                    value = 0n;
+                }
+            }
+            const tx = {
+                to: smartRouter,
+                data: calldata,
+                from: wallet.address,
+                nonce,
+                gasLimit: BigInt(500_000),
+                chainId,
+                type: txType,
+                value,
+            };
+            if (txType === 2) {
+                tx.maxFeePerGas = gasPrice;
+                tx.maxPriorityFeePerGas = priorityFee;
+            }
+            else {
+                tx.gasPrice = gasPrice;
+            }
+            return wallet.signTransaction(tx);
+        });
+        const signedDexBuys = await Promise.all(dexBuyTxPromises);
+        allTransactions.push(...signedDexBuys);
+    }
+    // 5. 利润多跳转账
+    let profitHopWallets;
+    if (profitAmount > 0n) {
+        const mainAddr = mainWallet.address.toLowerCase();
+        const profitNonce = noncesMap.get(mainAddr);
+        const profitResult = await buildProfitHopTransactions({
+            provider,
+            payerWallet: mainWallet,
+            profitAmount,
+            profitRecipient: getProfitRecipient(),
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId,
+            txType,
+            startNonce: profitNonce,
+        });
+        allTransactions.push(...profitResult.signedTransactions);
+        profitHopWallets = profitResult.hopWallets;
+    }
+    nonceManager.clearTemp();
+    // 返回结果
+    return {
+        signedTransactions: allTransactions,
+        profitHopWallets,
+        metadata: {
+            curveBuyerCount: curveBuyers.length,
+            curveTotalBuy: ethers.formatEther(curveBuyAmounts.reduce((a, b) => a + b, 0n)),
+            graduated: triggerGraduate,
+            dexBuyerCount: dexBuyers.length,
+            dexTotalBuy: ethers.formatEther(dexBuyAmounts.reduce((a, b) => a + b, 0n)),
+            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
+        },
+    };
+}

package/dist/domains/flap/portal-bundle-merkle/curve-to-dex/types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Flap 内盘买到外盘 — 类型定义
+ */
+import type { FlapSignConfig } from '../config.js';
+import type { MerkleSignedResult } from '../types.js';
+export type CurveToDexChain = 'bsc' | 'base';
+export type DexPoolType = 'v2' | 'v3';
+/** 签名配置 */
+export interface CurveToDexSignConfig extends FlapSignConfig {
+    reserveGasETH?: number;
+    skipQuoteOnError?: boolean;
+}
+/** 内盘买入钱包配置 */
+export interface CurveBuyerConfig {
+    privateKey: string;
+    /** 买入金额（BNB 或 USD1），为空则自动分配 */
+    buyAmount?: string;
+}
+/** 外盘买入钱包配置 */
+export interface DexBuyerConfig {
+    privateKey: string;
+    /** 买入金额（BNB 或 USD1），为空则自动分配 */
+    buyAmount?: string;
+}
+/** 内盘买到外盘参数 */
+export interface FlapCurveToDexParams {
+    chain: CurveToDexChain;
+    /** 代币地址（已存在的代币） */
+    tokenAddress: string;
+    /** 报价代币（BNB 或 USD1），不传默认 BNB */
+    quoteToken?: string;
+    /** 报价代币精度，默认 18 */
+    quoteTokenDecimals?: number;
+    /** 内盘买入钱包（这些钱包会在 Bonding Curve 上买入） */
+    curveBuyers: CurveBuyerConfig[];
+    /** 内盘总买入金额（用于自动分配） */
+    curveTotalBuyAmount?: string;
+    /** 是否触发毕业（上 DEX） */
+    triggerGraduate?: boolean;
+    /** 毕业触发者（内盘最后一个买家，如果不提供则使用 curveBuyers 的最后一个） */
+    graduateWallet?: {
+        privateKey: string;
+        buyAmount?: string;
+    };
+    /** 外盘买入钱包（这些钱包会在 PancakeSwap 上买入） */
+    dexBuyers?: DexBuyerConfig[];
+    /** 外盘总买入金额（用于自动分配） */
+    dexTotalBuyAmount?: string;
+    /** 外盘池类型（V2 或 V3），默认 V3 */
+    dexPoolType?: DexPoolType;
+    /** V3 费率（100/500/2500/10000），默认 2500 */
+    v3Fee?: number;
+    /** 配置 */
+    config: CurveToDexSignConfig;
+}
+/** 结果类型 */
+export interface FlapCurveToDexResult extends MerkleSignedResult {
+    metadata?: {
+        /** 内盘买入钱包数 */
+        curveBuyerCount: number;
+        /** 内盘总买入金额 */
+        curveTotalBuy: string;
+        /** 是否触发毕业 */
+        graduated: boolean;
+        /** 外盘买入钱包数 */
+        dexBuyerCount: number;
+        /** 外盘总买入金额 */
+        dexTotalBuy: string;
+        /** 利润金额 */
+        profitAmount?: string;
+    };
+}

package/dist/domains/flap/portal-bundle-merkle/curve-to-dex/types.js

@@ -0,0 +1,4 @@
+/**
+ * Flap 内盘买到外盘 — 类型定义
+ */
+export {};

package/dist/domains/flap/portal-bundle-merkle/curve-to-dex.d.ts

@@ -1,88 +1,7 @@
 /**
- * Flap Protocol 内盘买到外盘捆绑交易
+ * Flap 内盘买到外盘（Curve → DEX）
  *
- * 功能：在一个 Bundle 中完成：
- * 1. 多个钱包在 Bonding Curve（内盘）买入代币
- * 2. 最后一个买家触发毕业（代币上 DEX）
- * 3. 多个钱包在 PancakeSwap（外盘）继续买入
+ * 原超长文件按职责拆分为 curve-to-dex/ 目录下的多个子文件，
+ * 对外 export 符号与路径保持不变（见 curve-to-dex/index.ts）。
  */
-import { FlapSignConfig } from './config.js';
-import type { MerkleSignedResult } from './types.js';
-export type CurveToDexChain = 'bsc' | 'base';
-export type DexPoolType = 'v2' | 'v3';
-/** 签名配置 */
-export interface CurveToDexSignConfig extends FlapSignConfig {
-    reserveGasETH?: number;
-    skipQuoteOnError?: boolean;
-}
-/** 内盘买入钱包配置 */
-export interface CurveBuyerConfig {
-    privateKey: string;
-    /** 买入金额（BNB 或 USD1），为空则自动分配 */
-    buyAmount?: string;
-}
-/** 外盘买入钱包配置 */
-export interface DexBuyerConfig {
-    privateKey: string;
-    /** 买入金额（BNB 或 USD1），为空则自动分配 */
-    buyAmount?: string;
-}
-/** 内盘买到外盘参数 */
-export interface FlapCurveToDexParams {
-    chain: CurveToDexChain;
-    /** 代币地址（已存在的代币） */
-    tokenAddress: string;
-    /** 报价代币（BNB 或 USD1），不传默认 BNB */
-    quoteToken?: string;
-    /** 报价代币精度，默认 18 */
-    quoteTokenDecimals?: number;
-    /** 内盘买入钱包（这些钱包会在 Bonding Curve 上买入） */
-    curveBuyers: CurveBuyerConfig[];
-    /** 内盘总买入金额（用于自动分配） */
-    curveTotalBuyAmount?: string;
-    /** 是否触发毕业（上 DEX） */
-    triggerGraduate?: boolean;
-    /** 毕业触发者（内盘最后一个买家，如果不提供则使用 curveBuyers 的最后一个） */
-    graduateWallet?: {
-        privateKey: string;
-        buyAmount?: string;
-    };
-    /** 外盘买入钱包（这些钱包会在 PancakeSwap 上买入） */
-    dexBuyers?: DexBuyerConfig[];
-    /** 外盘总买入金额（用于自动分配） */
-    dexTotalBuyAmount?: string;
-    /** 外盘池类型（V2 或 V3），默认 V3 */
-    dexPoolType?: DexPoolType;
-    /** V3 费率（100/500/2500/10000），默认 2500 */
-    v3Fee?: number;
-    /** 配置 */
-    config: CurveToDexSignConfig;
-}
-/** 结果类型 */
-export interface FlapCurveToDexResult extends MerkleSignedResult {
-    metadata?: {
-        /** 内盘买入钱包数 */
-        curveBuyerCount: number;
-        /** 内盘总买入金额 */
-        curveTotalBuy: string;
-        /** 是否触发毕业 */
-        graduated: boolean;
-        /** 外盘买入钱包数 */
-        dexBuyerCount: number;
-        /** 外盘总买入金额 */
-        dexTotalBuy: string;
-        /** 利润金额 */
-        profitAmount?: string;
-    };
-}
-/**
- * Flap 内盘买到外盘捆绑交易
- *
- * 交易顺序：
- * 1. 贿赂交易（BlockRazor）
- * 2. 内盘买入（多个钱包在 Bonding Curve 买入）
- * 3. 毕业触发（最后一个买家买入触发上 DEX）
- * 4. 外盘买入（多个钱包在 PancakeSwap 买入）
- * 5. 利润多跳转账
- */
-export declare function flapBundleCurveToDex(params: FlapCurveToDexParams): Promise<FlapCurveToDexResult>;
+export * from './curve-to-dex/index.js';