four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-quote.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Flap BuyFirst 报价/资金/余额 helper（从 swap-buy-first-helpers.ts 抽取）
+ */
+import { ethers, Contract, Wallet } from 'ethers';
+import type { BuyerFundsResult, QuoteResult, SellerInfo } from './swap-buy-first-types.js';
+/**
+ * 获取 ERC20 代币 → 原生代币的报价
+ * @param provider - Provider 实例
+ * @param tokenAddress - ERC20 代币地址
+ * @param tokenAmount - 代币数量（wei）
+ * @param chainId - 链 ID（56=BSC, 143=Monad）
+ * @returns 等值的原生代币数量（wei），失败返回 0n
+ */
+export declare function getTokenToNativeQuote(provider: ethers.JsonRpcProvider, tokenAddress: string, tokenAmount: bigint, chainId: number): Promise<bigint>;
+type CalculateBuyerFundsParams = {
+    buyer: Wallet;
+    buyerFunds?: string;
+    buyerFundsPercentage?: number;
+    reserveGasEth?: number;
+    nativeToken: string;
+    useNativeToken?: boolean;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    provider?: ethers.JsonRpcProvider;
+};
+export declare function calculateBuyerFunds({ buyer, buyerFunds, buyerFundsPercentage, reserveGasEth, nativeToken, useNativeToken, quoteToken, quoteTokenDecimals, provider, }: CalculateBuyerFundsParams): Promise<BuyerFundsResult>;
+type QuoteBuyerOutputParams = {
+    portalAddress: string;
+    tokenAddress: string;
+    buyerFundsWei: bigint;
+    provider: ethers.JsonRpcProvider;
+    skipQuoteOnError?: boolean;
+    inputToken?: string;
+};
+export declare function quoteBuyerOutput({ portalAddress, tokenAddress, buyerFundsWei, provider, skipQuoteOnError, inputToken, }: QuoteBuyerOutputParams): Promise<QuoteResult>;
+type EnsureSellerBalanceParams = {
+    tokenAddress: string;
+    provider: ethers.JsonRpcProvider;
+    seller: Wallet;
+    sellAmountWei: bigint;
+    skipBalanceCheck: boolean;
+};
+export declare function ensureSellerBalance({ tokenAddress, provider, seller, sellAmountWei, skipBalanceCheck, }: EnsureSellerBalanceParams): Promise<SellerInfo>;
+export declare function estimateSellFunds(portal: Contract, tokenAddress: string, sellAmountWei: bigint, outputToken?: string): Promise<any>;
+/**
+ * 计算多笔交易的利润金额
+ * @param expectedFunds - 预期收益
+ * @param rateBps - 利润比例（基点）
+ */
+export declare function calculateMultiProfitAmount(expectedFunds: bigint, rateBps: number): bigint;
+export {};

package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-quote.js

@@ -0,0 +1,149 @@
+/**
+ * Flap BuyFirst 报价/资金/余额 helper（从 swap-buy-first-helpers.ts 抽取）
+ */
+import { ethers, Contract } from 'ethers';
+import { CHAINS, ZERO_ADDRESS } from '../../../core/constants/index.js';
+import { ERC20_BALANCE_ABI } from '../../../core/shared-abis/common.js';
+import { getErrorMessageFromUnknown } from '../../../core/index.js';
+import { PORTAL_ABI } from './config.js';
+import { BSC_PANCAKE_V2_ROUTER, BSC_WBNB, MONAD_PANCAKE_V2_ROUTER, MONAD_WMON, ROUTER_ABI, } from './swap-buy-first-constants.js';
+/**
+ * 获取 ERC20 代币 → 原生代币的报价
+ * @param provider - Provider 实例
+ * @param tokenAddress - ERC20 代币地址
+ * @param tokenAmount - 代币数量（wei）
+ * @param chainId - 链 ID（56=BSC, 143=Monad）
+ * @returns 等值的原生代币数量（wei），失败返回 0n
+ */
+export async function getTokenToNativeQuote(provider, tokenAddress, tokenAmount, chainId) {
+    if (tokenAmount <= 0n)
+        return 0n;
+    try {
+        if (chainId === CHAINS.BSC.chainId) {
+            // BSC: 使用 PancakeSwap V2 Router
+            const router = new Contract(BSC_PANCAKE_V2_ROUTER, ROUTER_ABI, provider);
+            const amounts = await router.getAmountsOut(tokenAmount, [tokenAddress, BSC_WBNB]);
+            return amounts[1];
+        }
+        if (chainId === CHAINS.MONAD.chainId) {
+            // ✅ Monad: 使用 PancakeSwap V2 Router
+            const router = new Contract(MONAD_PANCAKE_V2_ROUTER, ROUTER_ABI, provider);
+            const amounts = await router.getAmountsOut(tokenAmount, [tokenAddress, MONAD_WMON]);
+            return amounts[1];
+        }
+        // ✅ Base (8453) / XLayer (196) 等链暂不支持 V2 报价，返回 0
+        return 0n;
+    }
+    catch {
+        // 报价失败返回 0（可能是流动性不足或路径不存在）
+        return 0n;
+    }
+}
+// ✅ 使用公共模块中的 ERC20_BALANCE_ABI
+const ERC20_BALANCE_OF_ABI = ERC20_BALANCE_ABI;
+export async function calculateBuyerFunds({ buyer, buyerFunds, buyerFundsPercentage, reserveGasEth, nativeToken, useNativeToken = true, quoteToken, quoteTokenDecimals = 18, provider, }) {
+    const reserveGas = ethers.parseEther((reserveGasEth || 0.0005).toString());
+    // ✅ 根据是否使用原生代币获取不同的余额
+    let buyerBalance;
+    if (useNativeToken) {
+        buyerBalance = await buyer.provider.getBalance(buyer.address);
+    }
+    else {
+        // ERC20 代币余额
+        const erc20 = new Contract(quoteToken, ERC20_BALANCE_OF_ABI, provider || buyer.provider);
+        buyerBalance = await erc20.balanceOf(buyer.address);
+    }
+    let buyerFundsWei;
+    if (buyerFunds !== undefined) {
+        // ✅ 根据代币精度解析金额
+        buyerFundsWei = useNativeToken
+            ? ethers.parseEther(String(buyerFunds))
+            : ethers.parseUnits(String(buyerFunds), quoteTokenDecimals);
+    }
+    else if (buyerFundsPercentage !== undefined) {
+        const pct = Math.max(0, Math.min(100, buyerFundsPercentage));
+        // ✅ 原生代币需要预留 Gas，ERC20 不需要
+        const spendable = useNativeToken ? (buyerBalance > reserveGas ? buyerBalance - reserveGas : 0n) : buyerBalance;
+        buyerFundsWei = (spendable * BigInt(Math.floor(pct * 100))) / 10000n;
+    }
+    else {
+        throw new Error('必须提供 buyerFunds 或 buyerFundsPercentage');
+    }
+    if (buyerFundsWei <= 0n) {
+        throw new Error('buyerFunds 需要大于 0');
+    }
+    // ✅ 余额检查
+    if (useNativeToken) {
+        if (buyerBalance < buyerFundsWei + reserveGas) {
+            throw new Error(`买方余额不足: 需要 ${ethers.formatEther(buyerFundsWei + reserveGas)} ${nativeToken}，实际 ${ethers.formatEther(buyerBalance)} ${nativeToken}`);
+        }
+    }
+    else {
+        // ERC20 购买：检查代币余额
+        if (buyerBalance < buyerFundsWei) {
+            throw new Error(`买方代币余额不足: 需要 ${ethers.formatUnits(buyerFundsWei, quoteTokenDecimals)}，实际 ${ethers.formatUnits(buyerBalance, quoteTokenDecimals)}`);
+        }
+        // ✅ ERC20 购买时，还需要检查买方是否有足够 BNB 支付 Gas
+        const buyerBnbBalance = await buyer.provider.getBalance(buyer.address);
+        if (buyerBnbBalance < reserveGas) {
+            throw new Error(`买方 BNB 余额不足 (用于支付 Gas): 需要 ${ethers.formatEther(reserveGas)} ${nativeToken}，实际 ${ethers.formatEther(buyerBnbBalance)} ${nativeToken}`);
+        }
+    }
+    return { buyerFundsWei, buyerBalance };
+}
+export async function quoteBuyerOutput({ portalAddress, tokenAddress, buyerFundsWei, provider, skipQuoteOnError, inputToken = ZERO_ADDRESS, // ✅ 默认使用原生代币
+ }) {
+    let quotedToken;
+    const portal = new Contract(portalAddress, PORTAL_ABI, provider);
+    try {
+        quotedToken = await portal.quoteExactInput.staticCall({
+            inputToken, // ✅ 使用动态输入代币
+            outputToken: tokenAddress,
+            inputAmount: buyerFundsWei,
+        });
+    }
+    catch (error) {
+        if (skipQuoteOnError ?? true) {
+            quotedToken = 0n;
+        }
+        else {
+            throw new Error(`买入报价失败: ${getErrorMessageFromUnknown(error)}`, { cause: error });
+        }
+    }
+    const sellAmountWei = quotedToken;
+    if (sellAmountWei <= 0n) {
+        throw new Error('卖方卖出数量为 0：报价失败');
+    }
+    return { quotedToken, sellAmountWei };
+}
+export async function ensureSellerBalance({ tokenAddress, provider, seller, sellAmountWei, skipBalanceCheck, }) {
+    const erc20 = new Contract(tokenAddress, ERC20_BALANCE_ABI, provider);
+    const [sellerTokenBal, decimals] = await Promise.all([erc20.balanceOf(seller.address), erc20.decimals()]);
+    if (!skipBalanceCheck && sellerTokenBal < sellAmountWei) {
+        throw new Error(`卖方代币余额不足: 需要 ${ethers.formatUnits(sellAmountWei, decimals)}，实际 ${ethers.formatUnits(sellerTokenBal, decimals)}`);
+    }
+    return { decimals };
+}
+export async function estimateSellFunds(portal, tokenAddress, sellAmountWei, outputToken = ZERO_ADDRESS) {
+    try {
+        return await portal.quoteExactInput.staticCall({
+            inputToken: tokenAddress,
+            outputToken, // ✅ 使用动态输出代币
+            inputAmount: sellAmountWei,
+        });
+    }
+    catch {
+        return 0n;
+    }
+}
+/**
+ * 计算多笔交易的利润金额
+ * @param expectedFunds - 预期收益
+ * @param rateBps - 利润比例（基点）
+ */
+export function calculateMultiProfitAmount(expectedFunds, rateBps) {
+    if (expectedFunds <= 0n || rateBps <= 0) {
+        return 0n;
+    }
+    return (expectedFunds * BigInt(rateBps)) / 10000n;
+}

package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-types.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Flap BuyFirst 类型定义（从 swap-buy-first-helpers.ts 抽取）
+ */
+import type { ethers } from 'ethers';
+import type { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
+import type { GeneratedWallet } from '../../../utils/wallet.js';
+import type { FlapSignConfig } from './config.js';
+export type FlapChain = 'bsc' | 'xlayer' | 'base';
+export type UserType = 'v0' | 'v1';
+export interface FlapBuyFirstSignConfig extends FlapSignConfig {
+    reserveGasETH?: number;
+    skipQuoteOnError?: boolean;
+    userType?: UserType;
+}
+export interface FlapBuyFirstConfig extends CommonBundleConfig {
+    apiKey: string;
+    customRpcUrl?: string;
+    bundleBlockOffset?: number;
+    reserveGasETH?: number;
+    skipQuoteOnError?: boolean;
+    waitForConfirmation?: boolean;
+    waitTimeoutMs?: number;
+}
+export interface FlapBundleBuyFirstSignParams {
+    chain: FlapChain;
+    buyerPrivateKey?: string;
+    buyerPrivateKeys?: string[];
+    sellerPrivateKey?: string;
+    sellerPrivateKeys?: string[];
+    tokenAddress: string;
+    buyerFunds?: string;
+    buyerFundsPercentage?: number;
+    config: FlapBuyFirstSignConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    buyCount?: number;
+    sellCount?: number;
+}
+export interface FlapBundleBuyFirstParams {
+    chain: FlapChain;
+    buyerPrivateKey: string;
+    sellerPrivateKey: string;
+    tokenAddress: string;
+    buyerFunds?: string;
+    buyerFundsPercentage?: number;
+    config: FlapBuyFirstConfig;
+}
+/** ✅ Flap BuyFirst 结果（简化版） */
+export type FlapBuyFirstResult = {
+    signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        buyerAddress: string;
+        sellerAddress: string;
+        buyAmount: string;
+        sellAmount: string;
+        profitAmount?: string;
+        buyCount?: number;
+        sellCount?: number;
+        buyAmounts?: string[];
+        sellAmounts?: string[];
+    };
+};
+export type ChainContext = {
+    chainId: number;
+    nativeToken: string;
+    portalAddress: string;
+    provider: ethers.JsonRpcProvider;
+};
+export type BuyerFundsResult = {
+    buyerFundsWei: bigint;
+    buyerBalance: bigint;
+};
+export type QuoteResult = {
+    quotedToken: bigint;
+    sellAmountWei: bigint;
+};
+export type SellerInfo = {
+    decimals: number;
+};
+/** ✅ 多笔买卖 nonce 规划 */
+export type MultiNoncePlan = {
+    buyerNonces: number[];
+    sellerNonces: number[];
+    bribeNonce?: number;
+    profitNonce?: number;
+};

package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-types.js

@@ -0,0 +1 @@
+export {};