four-flap-meme-sdk 2.2.19 → 2.2.20

package/dist/shared/flap/portal-bundle-merkle/swap-cross.js

@@ -0,0 +1,139 @@
+/**
+ * swap-cross - 交叉换手（多卖多买，循环执行）
+ */
+import { Wallet } from 'ethers';
+import { NonceManager } from '../../../utils/bundle-helpers.js';
+import { ZERO_ADDRESS } from '../../../shared/constants/index.js';
+import { getBribeAmount } from './config.js';
+import { createChainContext } from './swap-planning.js';
+import { flapQuickBatchSwapMerkle } from './swap-quick-batch.js';
+/**
+ * Flap 交叉换手（多卖多买，循环执行）
+ * - 每个卖方单独卖出，买入金额由卖出所得等分分配给当轮买方
+ * - 利润刮取、转账多跳逻辑继承 flapQuickBatchSwapMerkle
+ * - 结果按顺序拼接 signedTransactions（可交由前端/后端顺序广播）
+ * - ✅ 正确处理 nonce：同一钱包在多轮中使用时 nonce 自动递增
+ */
+export async function flapCrossSwapMerkle(params) {
+    const { chain, sellerPrivateKeys, sellAmounts, buyerPrivateKeys, tokenAddress, config, quoteToken, quoteTokenDecimals = 18, buyersPerSell, disperseHopCount = 0, } = params;
+    if (sellerPrivateKeys.length === 0) {
+        throw new Error('至少需要一个卖方');
+    }
+    if (sellerPrivateKeys.length !== sellAmounts.length) {
+        throw new Error(`sellAmounts 长度 (${sellAmounts.length}) 必须与卖方数量 (${sellerPrivateKeys.length}) 一致`);
+    }
+    if (buyerPrivateKeys.length === 0) {
+        throw new Error('至少需要一个买方');
+    }
+    // ✅ 创建 Provider 和 NonceManager
+    const chainContext = createChainContext(chain, config);
+    const nonceManager = new NonceManager(chainContext.provider);
+    // ✅ 预先获取所有钱包的初始 nonce
+    const allSellerWallets = sellerPrivateKeys.map((pk) => new Wallet(pk, chainContext.provider));
+    const allBuyerWallets = buyerPrivateKeys.map((pk) => new Wallet(pk, chainContext.provider));
+    // 使用 Map 去重（同一私钥可能出现多次）
+    const addressToNonce = new Map();
+    // 获取所有卖方 nonce
+    for (const wallet of allSellerWallets) {
+        if (!addressToNonce.has(wallet.address)) {
+            const nonce = await nonceManager.getNextNonce(wallet);
+            addressToNonce.set(wallet.address, nonce);
+        }
+    }
+    // 获取所有买方 nonce
+    for (const wallet of allBuyerWallets) {
+        if (!addressToNonce.has(wallet.address)) {
+            const nonce = await nonceManager.getNextNonce(wallet);
+            addressToNonce.set(wallet.address, nonce);
+        }
+    }
+    const allSigned = [];
+    const allDisperse = [];
+    const allProfit = [];
+    const rounds = [];
+    // 轮流分配买方：每轮取 buyersPerSell 个（默认所有买方），不足则从头继续
+    let buyerCursor = 0;
+    const buyerBatchSize = Math.max(1, buyersPerSell ?? buyerPrivateKeys.length);
+    for (let i = 0; i < sellerPrivateKeys.length; i++) {
+        const sellerPk = sellerPrivateKeys[i];
+        const sellAmount = sellAmounts[i];
+        const sellerWallet = allSellerWallets[i];
+        // 选取本轮买方私钥和钱包
+        const roundBuyerPks = [];
+        const roundBuyerWallets = [];
+        for (let k = 0; k < buyerBatchSize; k++) {
+            const idx = buyerCursor % buyerPrivateKeys.length;
+            roundBuyerPks.push(buyerPrivateKeys[idx]);
+            roundBuyerWallets.push(allBuyerWallets[idx]);
+            buyerCursor++;
+        }
+        // ✅ 获取卖方当前 nonce
+        const sellerNonce = addressToNonce.get(sellerWallet.address);
+        // ✅ 获取并更新买方 nonces（每个买方本轮需要 1 个 nonce）
+        const roundBuyerNonces = roundBuyerWallets.map((w) => {
+            const nonce = addressToNonce.get(w.address);
+            addressToNonce.set(w.address, nonce + 1); // 每个买方用 1 个 nonce
+            return nonce;
+        });
+        // 平分买入金额（使用比例模式，避免固定金额超出可分配金额）
+        const ratio = 1 / roundBuyerPks.length;
+        const buyerRatios = roundBuyerPks.map(() => ratio);
+        // ✅ 构建 startNonces: [sellerNonce, buyer1Nonce, buyer2Nonce, ...]
+        const startNonces = [sellerNonce, ...roundBuyerNonces];
+        // ✅ 预先计算卖方 nonce 消耗（精确计算）
+        // 卖方 nonce 消耗 = 贿赂(0/1) + 卖出(1) + 转账(N 或 N*2) + 利润(1)
+        const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+        const hasBribe = getBribeAmount(config) > 0n;
+        const hasProfit = true; // 默认有利润刮取
+        let sellerNonceConsumed = 0;
+        if (hasBribe)
+            sellerNonceConsumed += 1; // 贿赂
+        sellerNonceConsumed += 1; // 卖出
+        if (disperseHopCount === 0) {
+            sellerNonceConsumed += roundBuyerPks.length; // 直接转账
+        }
+        else if (useNativeToken) {
+            sellerNonceConsumed += roundBuyerPks.length; // 原生多跳：seller→hop1
+        }
+        else {
+            sellerNonceConsumed += roundBuyerPks.length * 2; // ERC20 多跳：BNB + ERC20 两批
+        }
+        if (hasProfit)
+            sellerNonceConsumed += 1; // 利润
+        // 调用单卖多买的签名函数
+        const res = await flapQuickBatchSwapMerkle({
+            chain,
+            sellerPrivateKey: sellerPk,
+            sellAmount,
+            buyerPrivateKeys: roundBuyerPks,
+            buyerRatios,
+            tokenAddress,
+            config,
+            quoteToken,
+            quoteTokenDecimals,
+            disperseHopCount,
+            startNonces, // ✅ 传入预计算的 nonces
+        });
+        // ✅ 更新卖方 nonce（使用精确计算的值）
+        addressToNonce.set(sellerWallet.address, sellerNonce + sellerNonceConsumed);
+        // 累积签名与中间钱包
+        allSigned.push(...res.signedTransactions);
+        if (res.disperseHopWallets)
+            allDisperse.push(...res.disperseHopWallets);
+        if (res.profitHopWallets)
+            allProfit.push(...res.profitHopWallets);
+        rounds.push({
+            sellerAddress: res.metadata?.sellerAddress || '',
+            buyerAddresses: res.metadata?.buyerAddresses || roundBuyerPks.map(() => ''),
+            sellAmount,
+            bundleHash: undefined,
+        });
+    }
+    nonceManager.clearTemp();
+    return {
+        signedTransactions: allSigned,
+        rounds,
+        disperseHopWallets: allDisperse.length > 0 ? allDisperse : undefined,
+        profitHopWallets: allProfit.length > 0 ? allProfit : undefined,
+    };
+}

package/dist/shared/flap/portal-bundle-merkle/swap-helpers.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Flap Protocol 内盘捆绑换手（Merkle Bundle）
+ *
+ * 功能：钱包A卖出代币 → 钱包B买入相同数量 → 原子执行
+ */
+import { ethers, Wallet, JsonRpcProvider } from 'ethers';
+import { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
+import { type GeneratedWallet } from '../../../utils/wallet.js';
+export declare const NATIVE_TRANSFER_GAS_LIMIT: 21055n;
+export declare const ERC20_TRANSFER_GAS_LIMIT_HOP: 65000n;
+export declare const BRIBE_GAS_LIMIT: 21000n;
+/**
+ * 分发多跳路径信息
+ */
+export type DisperseHopPath = {
+    targetAddress: string;
+    hopWallets: Wallet[];
+    hopWalletsInfo: GeneratedWallet[];
+};
+/**
+ * 生成分发多跳路径
+ */
+export declare function generateDisperseHopPaths(targetAddresses: string[], hopCount: number, provider: JsonRpcProvider): DisperseHopPath[];
+/**
+ * 构建原生代币多跳转账链
+ */
+export declare function buildNativeHopChain(payer: Wallet, path: DisperseHopPath, finalAmount: bigint, gasPrice: bigint, chainId: number, txType: number, payerNonce: number): Promise<string[]>;
+/**
+ * 构建 ERC20 多跳转账链
+ */
+export declare function buildERC20HopChain(payer: Wallet, path: DisperseHopPath, erc20Address: string, erc20Amount: bigint, gasPrice: bigint, chainId: number, txType: number, payerNonce: number): Promise<string[]>;
+/**
+ * 构建 BNB 多跳转账链（为 ERC20 中间钱包预留 gas）
+ */
+export declare function buildBNBHopChainForERC20(payer: Wallet, path: DisperseHopPath, finalGasAmount: bigint, gasPrice: bigint, chainId: number, txType: number, payerNonce: number): Promise<string[]>;
+export type UserType = 'v0' | 'v1';
+export interface FlapSwapSignConfig {
+    rpcUrl: string;
+    gasLimit?: number | bigint;
+    gasLimitMultiplier?: number;
+    minGasPriceGwei?: number;
+    maxGasPriceGwei?: number;
+    txType?: 0 | 2;
+    chainId?: number;
+    reserveGasETH?: number;
+    skipQuoteOnError?: boolean;
+    skipApprovalCheck?: boolean;
+    bribeAmount?: number;
+    userType?: UserType;
+}
+/**
+ * 获取 Gas Limit
+ */
+export declare function getGasLimit(config: FlapSwapSignConfig | FlapSwapConfig, defaultGas?: number): bigint;
+export declare const ROUTER_ABI: string[];
+export declare const ERC20_BALANCE_OF_ABI: string[];
+export declare const APPROVE_INTERFACE: ethers.Interface;
+export declare const BSC_PANCAKE_V2_ROUTER: "0x10ED43C718714eb63d5aA57B78B54704E256024E";
+export declare const BSC_WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
+export declare const MONAD_PANCAKE_V2_ROUTER = "0xb1bc24c34e88f7d43d5923034e3a14b24daacff9";
+export declare const MONAD_WMON: "0x3bd359c1119da7da1d913d1c4d2b7c461115433a";
+/**
+ * 获取 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>;
+export type FlapChain = 'bsc' | 'xlayer' | 'base';
+export interface FlapSwapConfig extends CommonBundleConfig {
+    apiKey: string;
+    customRpcUrl?: string;
+    bundleBlockOffset?: number;
+    reserveGasETH?: number;
+    skipQuoteOnError?: boolean;
+    waitForConfirmation?: boolean;
+    waitTimeoutMs?: number;
+    skipApprovalCheck?: boolean;
+}
+export interface FlapBundleSwapSignParams {
+    chain: FlapChain;
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKey: string;
+    tokenAddress: string;
+    config: FlapSwapSignConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    startNonces?: number[];
+}
+export interface FlapBundleSwapParams {
+    chain: FlapChain;
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKey: string;
+    tokenAddress: string;
+    config: FlapSwapConfig;
+}
+/** ✅ Flap Swap 结果（简化版） */
+export type FlapSwapResult = {
+    signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        sellerAddress: string;
+        buyerAddress: string;
+        sellAmount: string;
+        buyAmount: string;
+        hasApproval?: boolean;
+        profitAmount?: string;
+    };
+};
+export type ChainContext = {
+    chainId: number;
+    nativeToken: string;
+    portalAddress: string;
+    provider: ethers.JsonRpcProvider;
+};
+export type QuoteResult = {
+    quotedNative: bigint;
+    minOutNative: bigint;
+};
+export type BuyerNeed = {
+    reserveGas: bigint;
+    buyerBalance: bigint;
+    buyerNeedTotal: bigint;
+    maxBuyerValue: bigint;
+};
+export type NoncePlan = {
+    sellerNonce: number;
+    buyerNonce: number;
+    bribeNonce?: number;
+    profitNonce?: number;
+};
+/**
+ * 获取链ID
+ */
+export declare function getChainId(chain: FlapChain): number;
+/**
+ * 获取原生代币名称
+ */
+export declare function getNativeTokenName(chain: FlapChain): string;
+/**
+ * Flap内盘捆绑换手
+ * ✅ 支持 quoteToken：传入 USDT 等地址时，卖出得到该代币，买入使用该代币
+ */

package/dist/shared/flap/portal-bundle-merkle/swap-helpers.js

@@ -0,0 +1,259 @@
+/**
+ * Flap Protocol 内盘捆绑换手（Merkle Bundle）
+ *
+ * 功能：钱包A卖出代币 → 钱包B买入相同数量 → 原子执行
+ */
+import { ethers, Contract, Wallet } from 'ethers';
+import { ADDRESSES } from '../../../shared/constants/index.js';
+import { V2_ROUTER_QUOTE_ABI, ERC20_BALANCE_ABI, ERC20_ABI } from '../../abis/common.js';
+import { generateWallets } from '../../../utils/wallet.js';
+import { GAS_LIMITS, CHAINS } from '../../constants/index.js';
+// ==================== 多跳转账常量（使用统一常量） ====================
+export const NATIVE_TRANSFER_GAS_LIMIT = GAS_LIMITS.NATIVE_TRANSFER;
+export const ERC20_TRANSFER_GAS_LIMIT_HOP = GAS_LIMITS.ERC20_TRANSFER;
+export const BRIBE_GAS_LIMIT = GAS_LIMITS.BRIBE;
+/**
+ * 生成分发多跳路径
+ */
+export function generateDisperseHopPaths(targetAddresses, hopCount, provider) {
+    if (hopCount <= 0) {
+        return targetAddresses.map((addr) => ({
+            targetAddress: addr,
+            hopWallets: [],
+            hopWalletsInfo: [],
+        }));
+    }
+    return targetAddresses.map((targetAddress) => {
+        const hopWalletsInfo = generateWallets(hopCount);
+        const hopWallets = hopWalletsInfo.map((w) => new Wallet(w.privateKey, provider));
+        return { targetAddress, hopWallets, hopWalletsInfo };
+    });
+}
+/**
+ * 构建原生代币多跳转账链
+ */
+export async function buildNativeHopChain(payer, path, finalAmount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    if (hopCount === 0) {
+        signedTxs.push(await payer.signTransaction({
+            to: path.targetAddress,
+            value: finalAmount,
+            nonce: payerNonce,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            gasPrice,
+            chainId,
+            type: txType,
+        }));
+        return signedTxs;
+    }
+    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
+    // 计算每跳需要的金额
+    const amountsPerHop = [];
+    for (let i = 0; i < hopCount; i++) {
+        const remainingHops = hopCount - i;
+        amountsPerHop.push(finalAmount + hopGasCost * BigInt(remainingHops));
+    }
+    // payer → hop1
+    signedTxs.push(await payer.signTransaction({
+        to: path.hopWallets[0].address,
+        value: amountsPerHop[0],
+        nonce: payerNonce,
+        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+        gasPrice,
+        chainId,
+        type: txType,
+    }));
+    // hop1 → hop2 → ... → target
+    for (let i = 0; i < hopCount; i++) {
+        const fromWallet = path.hopWallets[i];
+        const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
+        const amount = i === hopCount - 1 ? finalAmount : amountsPerHop[i + 1];
+        signedTxs.push(await fromWallet.signTransaction({
+            to: toAddress,
+            value: amount,
+            nonce: 0,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            gasPrice,
+            chainId,
+            type: txType,
+        }));
+    }
+    return signedTxs;
+}
+/**
+ * 构建 ERC20 多跳转账链
+ */
+export async function buildERC20HopChain(payer, path, erc20Address, erc20Amount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    const erc20Interface = new ethers.Interface(ERC20_ABI);
+    if (hopCount === 0) {
+        const data = erc20Interface.encodeFunctionData('transfer', [path.targetAddress, erc20Amount]);
+        signedTxs.push(await payer.signTransaction({
+            to: erc20Address,
+            data,
+            value: 0n,
+            nonce: payerNonce,
+            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+            gasPrice,
+            chainId,
+            type: txType,
+        }));
+        return signedTxs;
+    }
+    // payer → hop1
+    const firstData = erc20Interface.encodeFunctionData('transfer', [path.hopWallets[0].address, erc20Amount]);
+    signedTxs.push(await payer.signTransaction({
+        to: erc20Address,
+        data: firstData,
+        value: 0n,
+        nonce: payerNonce,
+        gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+        gasPrice,
+        chainId,
+        type: txType,
+    }));
+    // hop1 → hop2 → ... → target (nonce=1，nonce=0 用于 BNB 转发)
+    for (let i = 0; i < hopCount; i++) {
+        const fromWallet = path.hopWallets[i];
+        const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
+        const data = erc20Interface.encodeFunctionData('transfer', [toAddress, erc20Amount]);
+        signedTxs.push(await fromWallet.signTransaction({
+            to: erc20Address,
+            data,
+            value: 0n,
+            nonce: 1, // nonce=0 已用于 BNB 转发
+            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+            gasPrice,
+            chainId,
+            type: txType,
+        }));
+    }
+    return signedTxs;
+}
+/**
+ * 构建 BNB 多跳转账链（为 ERC20 中间钱包预留 gas）
+ */
+export async function buildBNBHopChainForERC20(payer, path, finalGasAmount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    if (hopCount === 0) {
+        return signedTxs;
+    }
+    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
+    const erc20GasCost = ERC20_TRANSFER_GAS_LIMIT_HOP * gasPrice;
+    const gasPerHop = hopGasCost + erc20GasCost * 2n;
+    const amountsPerHop = [];
+    for (let i = 0; i < hopCount; i++) {
+        const remainingHops = hopCount - i;
+        amountsPerHop.push(finalGasAmount + gasPerHop * BigInt(remainingHops));
+    }
+    // payer → hop1
+    signedTxs.push(await payer.signTransaction({
+        to: path.hopWallets[0].address,
+        value: amountsPerHop[0],
+        nonce: payerNonce,
+        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+        gasPrice,
+        chainId,
+        type: txType,
+    }));
+    // hop1 → hop2 → ... → target (nonce=0)
+    for (let i = 0; i < hopCount; i++) {
+        const fromWallet = path.hopWallets[i];
+        const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
+        const amount = i === hopCount - 1 ? finalGasAmount : amountsPerHop[i + 1];
+        signedTxs.push(await fromWallet.signTransaction({
+            to: toAddress,
+            value: amount,
+            nonce: 0,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            gasPrice,
+            chainId,
+            type: txType,
+        }));
+    }
+    return signedTxs;
+}
+/**
+ * 获取 Gas Limit
+ */
+export function getGasLimit(config, defaultGas = 500000) {
+    if (config.gasLimit !== undefined) {
+        return typeof config.gasLimit === 'bigint' ? config.gasLimit : BigInt(config.gasLimit);
+    }
+    const multiplier = config.gasLimitMultiplier ?? 1.0;
+    return BigInt(Math.ceil(defaultGas * multiplier));
+}
+// ✅ ABI 别名
+export const ROUTER_ABI = V2_ROUTER_QUOTE_ABI;
+export const ERC20_BALANCE_OF_ABI = ERC20_BALANCE_ABI;
+export const APPROVE_INTERFACE = new ethers.Interface(['function approve(address,uint256) returns (bool)']);
+// ✅ 链常量
+export const BSC_PANCAKE_V2_ROUTER = ADDRESSES.BSC.PancakeV2Router;
+export const BSC_WBNB = ADDRESSES.BSC.WBNB;
+export const MONAD_PANCAKE_V2_ROUTER = '0xb1bc24c34e88f7d43d5923034e3a14b24daacff9';
+export const MONAD_WMON = ADDRESSES.MONAD.WMON;
+/**
+ * 获取 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;
+    }
+}
+/**
+ * 获取链ID
+ */
+export function getChainId(chain) {
+    switch (chain) {
+        case 'bsc':
+            return CHAINS.BSC.chainId;
+        case 'xlayer':
+            return CHAINS.XLAYER.chainId;
+        case 'base':
+            return CHAINS.BASE.chainId;
+    }
+}
+/**
+ * 获取原生代币名称
+ */
+export function getNativeTokenName(chain) {
+    switch (chain) {
+        case 'bsc':
+            return 'BNB';
+        case 'xlayer':
+            return 'OKB';
+        case 'base':
+            return 'ETH';
+    }
+}
+/**
+ * Flap内盘捆绑换手
+ * ✅ 支持 quoteToken：传入 USDT 等地址时，卖出得到该代币，买入使用该代币
+ */

package/dist/shared/flap/portal-bundle-merkle/swap-planning.d.ts

@@ -0,0 +1,70 @@
+import { ethers, Wallet } from 'ethers';
+import { NonceManager } from '../../../utils/bundle-helpers.js';
+import type { GeneratedWallet } from '../../../utils/wallet.js';
+import { type BuyerNeed, type ChainContext, type FlapChain, type FlapSwapSignConfig, type NoncePlan, type QuoteResult, type UserType } from './swap-helpers.js';
+export declare function createChainContext(chain: FlapChain, config: FlapSwapSignConfig): ChainContext;
+type BuildApprovalTxParams = {
+    tokenAddress: string;
+    seller: Wallet;
+    provider: ethers.JsonRpcProvider;
+    decimals: number;
+    portalAddress: string;
+    chainId: number;
+    config: FlapSwapSignConfig;
+};
+export declare function buildApprovalTransaction({ tokenAddress, seller, provider, decimals, portalAddress, chainId, config, }: BuildApprovalTxParams): Promise<string | null>;
+type QuoteSellParams = {
+    portalAddress: string;
+    tokenAddress: string;
+    sellAmountWei: bigint;
+    provider: ethers.JsonRpcProvider;
+    skipQuoteOnError?: boolean;
+    outputToken?: string;
+};
+export declare function quoteSellOutput({ portalAddress, tokenAddress, sellAmountWei, provider, skipQuoteOnError, outputToken, }: QuoteSellParams): Promise<QuoteResult>;
+type BuyerNeedParams = {
+    buyer: Wallet;
+    quotedNative: bigint;
+    reserveGasEth?: number;
+    nativeToken: string;
+    useNativeToken?: boolean;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    provider?: ethers.JsonRpcProvider;
+};
+export declare function calculateBuyerNeed({ buyer, quotedNative, reserveGasEth, nativeToken, useNativeToken, quoteToken, quoteTokenDecimals, provider, }: BuyerNeedParams): Promise<BuyerNeed>;
+type ValidateBalanceArgs = {
+    buyerAddress: string;
+    portalGasCost: bigint;
+    provider: ethers.JsonRpcProvider;
+    chainContext: ChainContext;
+    seller: Wallet;
+    useNativeToken: boolean;
+};
+export declare function validateBalances({ buyerAddress, portalGasCost, provider, chainContext, seller, useNativeToken, }: ValidateBalanceArgs): Promise<void>;
+type PlanNonceArgs = {
+    seller: Wallet;
+    buyer: Wallet;
+    approvalExists: boolean;
+    extractProfit: boolean;
+    needBribeTx: boolean;
+    nonceManager: NonceManager;
+};
+export declare function buildNoncePlan(startNonces: number[], approvalExists: boolean, extractProfit: boolean, needBribeTx: boolean): NoncePlan;
+export declare function planNonces({ seller, buyer, approvalExists, extractProfit, needBribeTx, nonceManager, }: PlanNonceArgs): Promise<NoncePlan>;
+type ProfitTxArgs = {
+    provider: ethers.JsonRpcProvider;
+    seller: Wallet;
+    profitAmount: bigint;
+    profitNonce?: number;
+    gasPrice: bigint;
+    chainId: number;
+    txType: number;
+};
+interface ProfitTxResult {
+    signedTransactions: string[];
+    hopWallets: GeneratedWallet[];
+}
+export declare function buildProfitTransaction({ provider, seller, profitAmount, profitNonce, gasPrice, chainId, txType, }: ProfitTxArgs): Promise<ProfitTxResult | null>;
+export declare function calculateProfitAmount(quotedNative: bigint, userType?: UserType): bigint;
+export {};