four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/domains/flap/portal-bundle-merkle/core-helpers.js

@@ -1,7 +1,13 @@
-import { Contract } from 'ethers';
-import { ADDRESSES } from '../../../core/constants/index.js';
-import { CHAINS } from '../../../core/constants/index.js';
-import { V2_ROUTER_QUOTE_ABI } from '../../../core/shared-abis/common.js';
+import { ethers, Contract, Wallet, Interface, } from 'ethers';
+import { ADDRESSES, CHAINS, } from '../../../core/constants/index.js';
+import { MULTICALL3_ABI, V2_ROUTER_QUOTE_ABI, } from '../../../core/shared-abis/common.js';
+import { getGasLimit, } from '../../../core/gas/bundle-gas.js';
+import { getOptimizedGasPrice, } from '../../../utils/bundle-helpers.js';
+import { CHAIN_ID_MAP, PORTAL_ABI, getTxType, getGasPriceConfig, calculateProfit, getProfitRecipient, } from './config.js';
+import { normalizeTaxLaunchConfig, } from '../portal-create-token.js';
+import { MigratorType } from '../portal.js';
+import { SdkError } from '../../../utils/errors.js';
+import { SdkErrorCode } from '../../../core/legacy-types/errors.js';
 // ✅ 常量
 export const MULTICALL3_ADDRESS = ADDRESSES.BSC.Multicall3;
 // ==================== ERC20 → 原生代币报价 ====================
@@ -59,25 +65,258 @@ export async function getTokenToNativeQuote(provider, tokenAddress, tokenAmount,
         return 0n;
     }
 }
+// ==================== 内部辅助函数（从 core.ts 抽取）====================
+export function validateQuoteTokenDecimals(decimals, source) {
+    if (decimals === undefined)
+        return undefined;
+    if (!Number.isInteger(decimals) || decimals < 0 || decimals > 18) {
+        throw new SdkError(SdkErrorCode.INVALID_AMOUNT, `${source}: quoteTokenDecimals 必须是 0-18 的整数，收到 ${String(decimals)}`);
+    }
+    return decimals;
+}
+export function resolveCreateTokenLaunchFlags(params) {
+    const normalizedTax = normalizeTaxLaunchConfig(params.taxV2Config, params.taxRate);
+    const isTaxLaunch = !!normalizedTax || (params.taxRate ?? 0) > 0;
+    const hasVault = !!normalizedTax?.vaultConfig && normalizedTax.vaultConfig.vaultType !== 'none';
+    const useV7Portal = !isTaxLaunch &&
+        !hasVault &&
+        (params.lpFeeProfile !== undefined ||
+            params.dexId !== undefined ||
+            params.migratorType === MigratorType.PCS_INFINITY_CL_MIGRATOR);
+    return { normalizedTax, isTaxLaunch, hasVault, useV7Portal };
+}
+/**
+ * 无捆绑钱包、仅 Dev 自跟买、原生报价 → Flap 文档方式 A（create 内 quoteAmt + msg.value）
+ */
+export function canUseLaunchMethodA(privateKeys, buyAmounts, devAddress, useNativeToken) {
+    if (!useNativeToken || buyAmounts.length !== 1 || privateKeys.length !== 2) {
+        return false;
+    }
+    try {
+        const buyerAddr = new Wallet(privateKeys[1]).address;
+        return buyerAddr.toLowerCase() === devAddress.toLowerCase();
+    }
+    catch {
+        return false;
+    }
+}
+// ✅ Provider 缓存（复用连接，减少初始化开销）
+const providerCache = new Map();
+const PROVIDER_CACHE_TTL_MS = 60 * 1000; // 60秒缓存
+export function createChainContext(chain, rpcUrl) {
+    const chainId = CHAIN_ID_MAP[chain];
+    const cacheKey = `${chain}-${rpcUrl}`;
+    const now = Date.now();
+    // ✅ 检查缓存
+    const cached = providerCache.get(cacheKey);
+    if (cached && cached.expireAt > now) {
+        return { chainId, provider: cached.provider };
+    }
+    // ✅ 创建新 Provider 并缓存
+    const provider = new ethers.JsonRpcProvider(rpcUrl, { chainId, name: chain });
+    providerCache.set(cacheKey, { provider, expireAt: now + PROVIDER_CACHE_TTL_MS });
+    return { chainId, provider };
+}
+export async function resolveGasPrice(provider, config) {
+    if ('gasPrice' in config && config.gasPrice !== undefined) {
+        return config.gasPrice;
+    }
+    return await getOptimizedGasPrice(provider, getGasPriceConfig(config));
+}
+export function createWallets(privateKeys, provider) {
+    return privateKeys.map((key) => new Wallet(key, provider));
+}
+export function analyzeBuyFunds(buyAmounts, config, extractProfit) {
+    const result = {
+        fundsList: [],
+        originalAmounts: [],
+        totalBuyAmount: 0n,
+        totalProfit: 0n,
+    };
+    buyAmounts.forEach((amount) => {
+        const originalAmount = ethers.parseEther(amount);
+        result.originalAmounts.push(originalAmount);
+        result.totalBuyAmount += originalAmount;
+        if (extractProfit) {
+            const { remaining, profit } = calculateProfit(originalAmount);
+            result.totalProfit += profit;
+            result.fundsList.push(remaining);
+        }
+        else {
+            result.fundsList.push(originalAmount);
+        }
+    });
+    return result;
+}
+export function findMaxIndex(values) {
+    if (values.length === 0) {
+        return -1;
+    }
+    let maxIndex = 0;
+    let maxValue = values[0];
+    for (let i = 1; i < values.length; i++) {
+        if (values[i] > maxValue) {
+            maxValue = values[i];
+            maxIndex = i;
+        }
+    }
+    return maxIndex;
+}
+/**
+ * ✅ 支持 quoteToken 的买入交易构建
+ * 当 inputToken 为非零地址（如 USDC）时，value 为 0
+ */
+export async function populateBuyTransactionsWithQuote(buyers, portalAddr, tokenAddress, fundsList, inputToken, useNativeToken) {
+    const portals = buyers.map((wallet) => new ethers.Contract(portalAddr, PORTAL_ABI, wallet));
+    return await Promise.all(portals.map((portal, i) => portal.swapExactInput.populateTransaction({
+        inputToken,
+        outputToken: tokenAddress,
+        inputAmount: fundsList[i],
+        minOutputAmount: 0n,
+        permitData: '0x',
+    }, 
+    // ✅ 如果使用原生代币，value 为购买金额；否则为 0
+    useNativeToken ? { value: fundsList[i] } : {})));
+}
+export function buildGasLimitList(length, config) {
+    const gasLimit = getGasLimit(config, 800000);
+    return new Array(length).fill(gasLimit);
+}
 /**
- * 获取 Gas Limit
- * 优先使用 config.gasLimit，否则使用默认值 * multiplier
+ * ✅ 修复：不再调整其他钱包的 nonce
  *
- * ✅ ethers v6 最佳实践：直接使用 bigint 类型
+ * 之前的错误逻辑：如果钱包 B 的 nonce 与利润交易的 nonce 数值相同，就 +1
+ * 这是错误的！因为不同钱包的 nonce 是独立的，即使数值相同也不会冲突！
+ *
+ * 正确逻辑：直接返回原始 nonces，不做任何调整
+ * - 每个钱包使用自己的 nonce 发送买入交易
+ * - 利润交易使用 maxIndex 钱包的 nonce + 1（在构建利润交易时处理）
+ */
+export function adjustNoncesForProfit(presetNonces) {
+    // ✅ 直接返回原始 nonces，不做任何调整
+    // 不同钱包的 nonce 是独立的，不会冲突
+    return presetNonces;
+}
+/**
+ * ✅ 修复：明确分配 nonces，避免隐式状态依赖
  */
-export function getGasLimit(config, defaultGas = 800000) {
-    // 优先使用前端传入的 gasLimit
-    if (config.gasLimit !== undefined) {
-        // 如果已经是 bigint，直接返回；否则转换
-        return typeof config.gasLimit === 'bigint' ? config.gasLimit : BigInt(config.gasLimit);
-    }
-    // 使用默认值 * multiplier
-    const multiplier = config.gasLimitMultiplier ?? 1.0;
-    const calculatedGas = Math.ceil(defaultGas * multiplier);
-    // JavaScript 原生 BigInt 转换（ethers v6 兼容）
-    return BigInt(calculatedGas);
+export async function allocateBuyerNonces(buyers, extractProfit, maxIndex, totalProfit, nonceManager) {
+    const needProfitTx = extractProfit && totalProfit > 0n && maxIndex >= 0 && maxIndex < buyers.length;
+    if (!needProfitTx) {
+        // 不需要利润交易，所有钱包各 1 个 nonce
+        return await nonceManager.getNextNoncesForWallets(buyers);
+    }
+    // 需要利润交易：maxIndex 钱包需要 2 个连续 nonce（买入 + 利润）
+    const maxIndexNonces = await nonceManager.getNextNonceBatch(buyers[maxIndex], 2);
+    // 其他钱包各需要 1 个 nonce
+    const otherBuyers = buyers.filter((_, i) => i !== maxIndex);
+    const otherNonces = otherBuyers.length > 0 ? await nonceManager.getNextNoncesForWallets(otherBuyers) : [];
+    // 组装最终的 nonces 数组（保持原顺序）
+    const nonces = [];
+    let otherIdx = 0;
+    for (let i = 0; i < buyers.length; i++) {
+        if (i === maxIndex) {
+            nonces.push(maxIndexNonces[0]); // 买入交易用第一个 nonce
+        }
+        else {
+            nonces.push(otherNonces[otherIdx++]);
+        }
+    }
+    return nonces;
+}
+export async function signBuyTransactions({ unsignedBuys, buyers, nonces, gasLimits, gasPrice, chainId, config, fundsList, useNativeToken = true, // ✅ 默认使用原生代币
+ }) {
+    return await Promise.all(unsignedBuys.map((unsigned, i) => buyers[i].signTransaction({
+        ...unsigned,
+        from: buyers[i].address,
+        nonce: nonces[i],
+        gasLimit: gasLimits[i],
+        gasPrice,
+        chainId,
+        type: getTxType(config),
+        value: useNativeToken ? fundsList[i] : 0n, // ✅ 非原生代币时 value 为 0
+    })));
+}
+export function buildProfitMetadata(extractProfit, totalBuyAmount, totalProfit, buyerCount) {
+    if (!extractProfit) {
+        return undefined;
+    }
+    return {
+        totalBuyAmount: ethers.formatEther(totalBuyAmount),
+        profitAmount: ethers.formatEther(totalProfit),
+        profitRecipient: getProfitRecipient(),
+        buyerCount,
+    };
 }
 /**
- * Flap Protocol: 创建代币 + 捆绑购买（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
+ * ✅ 使用 Multicall3 批量获取卖出报价（单次 RPC）
+ * 比 Promise.all 更高效，N 个报价只需 1 次网络请求
  */
+export async function quoteSellOutputsWithQuote(portal, tokenAddress, amountsWei, outputToken) {
+    if (amountsWei.length === 0)
+        return [];
+    // 如果只有 1 个，直接调用（避免 multicall 开销）
+    if (amountsWei.length === 1) {
+        try {
+            const result = await portal.quoteExactInput.staticCall({
+                inputToken: tokenAddress,
+                outputToken,
+                inputAmount: amountsWei[0],
+            });
+            return [result];
+        }
+        catch {
+            return [0n];
+        }
+    }
+    const provider = portal.runner;
+    const portalAddress = await portal.getAddress();
+    const portalIface = new Interface(PORTAL_ABI);
+    const multicall = new Contract(MULTICALL3_ADDRESS, MULTICALL3_ABI, provider);
+    // 构建批量调用
+    const calls = amountsWei.map((amount) => ({
+        target: portalAddress,
+        allowFailure: true, // 允许单个失败
+        callData: portalIface.encodeFunctionData('quoteExactInput', [
+            {
+                inputToken: tokenAddress,
+                outputToken,
+                inputAmount: amount,
+            },
+        ]),
+    }));
+    try {
+        const results = await multicall.aggregate3.staticCall(calls);
+        return results.map((r) => {
+            if (r.success && r.returnData && r.returnData !== '0x') {
+                try {
+                    const decoded = portalIface.decodeFunctionResult('quoteExactInput', r.returnData);
+                    return BigInt(decoded[0]);
+                }
+                catch {
+                    return 0n;
+                }
+            }
+            return 0n;
+        });
+    }
+    catch {
+        // Multicall 失败，回退到并行调用
+        return await Promise.all(amountsWei.map(async (amount) => {
+            try {
+                return await portal.quoteExactInput.staticCall({
+                    inputToken: tokenAddress,
+                    outputToken,
+                    inputAmount: amount,
+                });
+            }
+            catch {
+                return 0n;
+            }
+        }));
+    }
+}
+export function resolveMinOutputs(_provided, walletCount, _quotedOutputs) {
+    // ✅ 已移除滑点保护：minOutput 固定为 0
+    return Array(walletCount).fill(0n);
+}

package/dist/domains/flap/portal-bundle-merkle/core.d.ts

@@ -1,14 +1,3 @@
-import { FlapCreateWithBundleBuySignParams, FlapCreateWithBundleBuyMerkleResult, FlapBatchBuySignParams, FlapBatchBuyMerkleResult, FlapBatchSellSignParams, FlapBatchSellMerkleResult } from './types.js';
+import { FlapCreateWithBundleBuySignParams, FlapCreateWithBundleBuyMerkleResult } from './types.js';
+export { batchBuyWithBundleMerkle, batchSellWithBundleMerkle } from './core-batch.js';
 export declare function createTokenWithBundleBuyMerkle(params: FlapCreateWithBundleBuySignParams): Promise<FlapCreateWithBundleBuyMerkleResult>;
-/**
- * Flap Protocol: 批量购买（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 支持 quoteToken：传入 USDC 等地址时使用该代币购买，否则使用原生代币
- */
-export declare function batchBuyWithBundleMerkle(params: FlapBatchBuySignParams): Promise<FlapBatchBuyMerkleResult>;
-/**
- * Flap Protocol: 批量卖出（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 支持 quoteToken：传入 USDC 等地址时卖出为该代币，否则卖出为原生代币
- */
-export declare function batchSellWithBundleMerkle(params: FlapBatchSellSignParams): Promise<FlapBatchSellMerkleResult>;