four-flap-meme-sdk 2.2.2 → 2.2.3

package/dist/shared/foundation/nonce/nonce-manager.js

@@ -0,0 +1,183 @@
+import '../tx/wallet-sign-patch.js';
+import { CHAINS } from '../../constants/index.js';
+function asBatchSendProvider(provider) {
+    return provider;
+}
+const GLOBAL_NONCE_TTL_MS = 60 * 1000;
+const globalNonceCursorByChain = new Map();
+function isFlakyNonceChain(chainId) {
+    return Number(chainId) === CHAINS.XLAYER.chainId;
+}
+function getCursorMap(chainId) {
+    let m = globalNonceCursorByChain.get(chainId);
+    if (!m) {
+        m = new Map();
+        globalNonceCursorByChain.set(chainId, m);
+    }
+    return m;
+}
+function getGlobalNextNonce(chainId, addrLower) {
+    const m = globalNonceCursorByChain.get(chainId);
+    if (!m)
+        return undefined;
+    const e = m.get(addrLower);
+    if (!e)
+        return undefined;
+    if (Date.now() - e.updatedAt > GLOBAL_NONCE_TTL_MS) {
+        m.delete(addrLower);
+        return undefined;
+    }
+    return e.nextNonce;
+}
+function setGlobalNextNonce(chainId, addrLower, nextNonce) {
+    const m = getCursorMap(chainId);
+    const cur = m.get(addrLower);
+    const next = Number(nextNonce);
+    if (!Number.isFinite(next) || next < 0)
+        return;
+    if (!cur || next > cur.nextNonce || Date.now() - cur.updatedAt > GLOBAL_NONCE_TTL_MS) {
+        m.set(addrLower, { nextNonce: next, updatedAt: Date.now() });
+    }
+    else {
+        cur.updatedAt = Date.now();
+    }
+}
+/**
+ * Nonce 管理器 — bundle 交易中管理多钱包 nonce
+ */
+export class NonceManager {
+    provider;
+    tempNonceCache = new Map();
+    chainIdPromise;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    async getChainId() {
+        if (!this.chainIdPromise) {
+            this.chainIdPromise = this.provider
+                .getNetwork()
+                .then((n) => Number(n.chainId))
+                .catch(() => 0);
+        }
+        return this.chainIdPromise;
+    }
+    async getNextNonce(wallet) {
+        const address = typeof wallet === 'string' ? wallet : wallet.address;
+        const key = address.toLowerCase();
+        const chainId = await this.getChainId();
+        const flaky = isFlakyNonceChain(chainId);
+        if (this.tempNonceCache.has(key)) {
+            const cachedNonce = this.tempNonceCache.get(key);
+            this.tempNonceCache.set(key, cachedNonce + 1);
+            if (flaky)
+                setGlobalNextNonce(chainId, key, cachedNonce + 1);
+            return cachedNonce;
+        }
+        const onchainNonce = await this.provider.getTransactionCount(address, 'pending');
+        let effectiveNonce = onchainNonce;
+        if (flaky) {
+            const globalNext = getGlobalNextNonce(chainId, key);
+            if (globalNext !== undefined) {
+                const delta = globalNext - onchainNonce;
+                if (delta > 0 && delta <= 10) {
+                    effectiveNonce = globalNext;
+                }
+            }
+            setGlobalNextNonce(chainId, key, effectiveNonce + 1);
+        }
+        this.tempNonceCache.set(key, effectiveNonce + 1);
+        return effectiveNonce;
+    }
+    async getNextNonceBatch(wallet, count) {
+        const address = typeof wallet === 'string' ? wallet : wallet.address;
+        const key = address.toLowerCase();
+        const chainId = await this.getChainId();
+        const flaky = isFlakyNonceChain(chainId);
+        let startNonce;
+        if (this.tempNonceCache.has(key)) {
+            startNonce = this.tempNonceCache.get(key);
+        }
+        else {
+            startNonce = await this.provider.getTransactionCount(address, 'pending');
+        }
+        if (flaky) {
+            const globalNext = getGlobalNextNonce(chainId, key);
+            if (globalNext !== undefined) {
+                const delta = globalNext - startNonce;
+                if (delta > 0 && delta <= 10)
+                    startNonce = globalNext;
+            }
+        }
+        this.tempNonceCache.set(key, startNonce + count);
+        if (flaky)
+            setGlobalNextNonce(chainId, key, startNonce + count);
+        return Array.from({ length: count }, (_, i) => startNonce + i);
+    }
+    clearTemp() {
+        this.tempNonceCache.clear();
+    }
+    getTempCachedNonce(address) {
+        return this.tempNonceCache.get(address.toLowerCase());
+    }
+    async getNextNoncesForWallets(wallets) {
+        const addresses = wallets.map((w) => (typeof w === 'string' ? w : w.address));
+        const keys = addresses.map((a) => a.toLowerCase());
+        const chainId = await this.getChainId();
+        const flaky = isFlakyNonceChain(chainId);
+        const needQuery = [];
+        const results = new Array(wallets.length);
+        for (let i = 0; i < keys.length; i++) {
+            const key = keys[i];
+            if (this.tempNonceCache.has(key)) {
+                const cachedNonce = this.tempNonceCache.get(key);
+                results[i] = cachedNonce;
+                this.tempNonceCache.set(key, cachedNonce + 1);
+                if (flaky)
+                    setGlobalNextNonce(chainId, key, cachedNonce + 1);
+            }
+            else {
+                needQuery.push({ index: i, address: addresses[i] });
+            }
+        }
+        if (needQuery.length > 0) {
+            let queryResults;
+            try {
+                const batchRequests = needQuery.map(({ address }, idx) => ({
+                    method: 'eth_getTransactionCount',
+                    params: [address, 'pending'],
+                    id: idx + 1,
+                    jsonrpc: '2.0',
+                }));
+                const rawResults = await asBatchSendProvider(this.provider)._send(batchRequests);
+                queryResults = rawResults.map((r) => {
+                    if (r.result) {
+                        return parseInt(r.result, 16);
+                    }
+                    return 0;
+                });
+            }
+            catch {
+                const queryPromises = needQuery.map(({ address }) => this.provider.getTransactionCount(address, 'pending'));
+                queryResults = await Promise.all(queryPromises);
+            }
+            for (let i = 0; i < needQuery.length; i++) {
+                const { index, address } = needQuery[i];
+                const key = address.toLowerCase();
+                const onchainNonce = queryResults[i];
+                let effectiveNonce = onchainNonce;
+                if (flaky) {
+                    const globalNext = getGlobalNextNonce(chainId, key);
+                    if (globalNext !== undefined) {
+                        const delta = globalNext - onchainNonce;
+                        if (delta > 0 && delta <= 10)
+                            effectiveNonce = globalNext;
+                    }
+                    setGlobalNextNonce(chainId, key, effectiveNonce + 1);
+                }
+                results[index] = effectiveNonce;
+                this.tempNonceCache.set(key, effectiveNonce + 1);
+            }
+        }
+        return results;
+    }
+}

package/dist/shared/foundation/normalize-unknown.d.ts

@@ -0,0 +1,9 @@
+/**
+ * SDK 统一的 unknown / Error 收口（审计：catch 宜用 unknown + normalize）
+ */
+export interface NormalizedErrorShape {
+    message: string;
+    cause?: unknown;
+}
+export declare function getErrorMessageFromUnknown(error: unknown): string;
+export declare function normalizeUnknownError(error: unknown): NormalizedErrorShape;

package/dist/shared/foundation/normalize-unknown.js

@@ -0,0 +1,29 @@
+/**
+ * SDK 统一的 unknown / Error 收口（审计：catch 宜用 unknown + normalize）
+ */
+export function getErrorMessageFromUnknown(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === 'string')
+        return error;
+    if (error !== null && typeof error === 'object') {
+        const o = error;
+        const m = o.message;
+        if (typeof m === 'string')
+            return m;
+        const reason = o.reason;
+        if (typeof reason === 'string')
+            return reason;
+    }
+    try {
+        return String(error);
+    }
+    catch {
+        return 'Unknown error';
+    }
+}
+export function normalizeUnknownError(error) {
+    const message = getErrorMessageFromUnknown(error);
+    const cause = error instanceof Error && error.cause !== undefined ? error.cause : error instanceof Error ? undefined : error;
+    return { message, ...(cause !== undefined ? { cause } : {}) };
+}

package/dist/shared/foundation/sdk-logger.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SDK 可选日志门面（默认静默）；业务侧可传入以替代 console.*
+ */
+export interface SdkLogger {
+    debug?: (msg: string, ...args: unknown[]) => void;
+    info?: (msg: string, ...args: unknown[]) => void;
+    warn?: (msg: string, ...args: unknown[]) => void;
+    error?: (msg: string, ...args: unknown[]) => void;
+}
+/** 不输出日志（库的推荐默认）。 */
+export declare const noopSdkLogger: SdkLogger;
+/** 直接使用 console（仅调试/过渡期）。 */
+export declare const consoleSdkLogger: SdkLogger;

package/dist/shared/foundation/sdk-logger.js

@@ -0,0 +1,12 @@
+/**
+ * SDK 可选日志门面（默认静默）；业务侧可传入以替代 console.*
+ */
+/** 不输出日志（库的推荐默认）。 */
+export const noopSdkLogger = {};
+/** 直接使用 console（仅调试/过渡期）。 */
+export const consoleSdkLogger = {
+    debug: (msg, ...args) => console.debug(msg, ...args),
+    info: (msg, ...args) => console.info(msg, ...args),
+    warn: (msg, ...args) => console.warn(msg, ...args),
+    error: (msg, ...args) => console.error(msg, ...args),
+};

package/dist/shared/foundation/tx/build-request.d.ts

@@ -0,0 +1,17 @@
+import type { TransactionLike, TransactionRequest } from 'ethers';
+/** 构建签名用 TransactionRequest 的公共参数 */
+export type BuildTxRequestParams = {
+    from: string;
+    nonce: number;
+    gasLimit: bigint;
+    gasPrice: bigint;
+    priorityFee: bigint;
+    chainId: number;
+    txType: number;
+    value?: bigint;
+};
+/**
+ * 将 populateTransaction 结果与 gas/nonce 字段合并为可签名交易。
+ * type 0 (Legacy) 使用 gasPrice；type 2 (EIP-1559) 使用 maxFeePerGas + maxPriorityFeePerGas。
+ */
+export declare function buildTransactionRequest(unsigned: TransactionLike, { from, nonce, gasLimit, gasPrice, priorityFee, chainId, txType, value }: BuildTxRequestParams): TransactionRequest;

package/dist/shared/foundation/tx/build-request.js

@@ -0,0 +1,25 @@
+/**
+ * 将 populateTransaction 结果与 gas/nonce 字段合并为可签名交易。
+ * type 0 (Legacy) 使用 gasPrice；type 2 (EIP-1559) 使用 maxFeePerGas + maxPriorityFeePerGas。
+ */
+export function buildTransactionRequest(unsigned, { from, nonce, gasLimit, gasPrice, priorityFee, chainId, txType, value }) {
+    const tx = {
+        ...unsigned,
+        from,
+        nonce,
+        gasLimit,
+        chainId,
+        type: txType,
+    };
+    if (value !== undefined) {
+        tx.value = value;
+    }
+    if (txType === 2) {
+        tx.maxFeePerGas = gasPrice;
+        tx.maxPriorityFeePerGas = priorityFee;
+    }
+    else {
+        tx.gasPrice = gasPrice;
+    }
+    return tx;
+}

package/dist/shared/foundation/tx/sign-batch.d.ts

@@ -0,0 +1,5 @@
+import { JsonRpcProvider, Wallet, type TransactionRequest } from 'ethers';
+export declare function getChainId(provider: JsonRpcProvider, configChainId?: number): Promise<number>;
+export declare function signTransactionsBatch(wallet: Wallet, transactions: TransactionRequest[]): Promise<string[]>;
+export declare function signTransactionsBatchMultiWallet(wallets: Wallet[], transactions: TransactionRequest[]): Promise<string[]>;
+export declare function validateSignedTransactions(signedTxs: string[]): boolean;

package/dist/shared/foundation/tx/sign-batch.js

@@ -0,0 +1,26 @@
+export async function getChainId(provider, configChainId) {
+    if (configChainId !== undefined)
+        return configChainId;
+    const network = await provider.getNetwork();
+    return Number(network.chainId);
+}
+export async function signTransactionsBatch(wallet, transactions) {
+    return Promise.all(transactions.map((tx) => wallet.signTransaction(tx)));
+}
+export async function signTransactionsBatchMultiWallet(wallets, transactions) {
+    if (wallets.length !== transactions.length) {
+        throw new Error(`Wallet count (${wallets.length}) must match transaction count (${transactions.length})`);
+    }
+    return Promise.all(transactions.map((tx, i) => wallets[i].signTransaction(tx)));
+}
+export function validateSignedTransactions(signedTxs) {
+    if (!signedTxs || signedTxs.length === 0) {
+        return false;
+    }
+    for (const tx of signedTxs) {
+        if (typeof tx !== 'string' || !tx.startsWith('0x')) {
+            return false;
+        }
+    }
+    return true;
+}

package/dist/shared/foundation/tx/wallet-sign-patch.d.ts

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

package/dist/shared/foundation/tx/wallet-sign-patch.js

@@ -0,0 +1,18 @@
+/**
+ * EIP-1559 兼容：当 txType=2 但传了 gasPrice 时，自动转换为 maxFeePerGas
+ * 模块加载时 patch Wallet.prototype.signTransaction（全局一次）
+ */
+import { Wallet } from 'ethers';
+const _origWalletSign = Wallet.prototype.signTransaction;
+Wallet.prototype.signTransaction = async function (tx) {
+    const signable = tx;
+    if (signable.type === 2 && signable.gasPrice != null && signable.maxFeePerGas == null) {
+        const { gasPrice: gp, ...rest } = signable;
+        return _origWalletSign.call(this, {
+            ...rest,
+            maxFeePerGas: gp,
+            maxPriorityFeePerGas: rest.maxPriorityFeePerGas ?? 0n,
+        });
+    }
+    return _origWalletSign.call(this, tx);
+};

package/dist/shared/foundation/types/airdrop-sweep.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 空投分散 / 归集（airdrop-sweep）— 类型定义
+ */
+import type { SoulPointSignatureMode, VNormalizationMode } from '../../clients/club48.js';
+export type BundleSubmitResult = {
+    bundleUuid: string;
+    signedTxs: string[];
+};
+export type SignedTransactionsResult = {
+    signedTransactions: string[];
+};
+export type AirdropDisperseParams = {
+    rpcUrl: string;
+    chainId: number;
+    fromPrivateKey: string;
+    recipients: string[];
+    amount?: string;
+    amounts?: string[];
+    tokenAddress?: string;
+    bundleEndpoint?: string;
+    gasPriceGwei?: string;
+    transferGasLimit?: bigint;
+    nativeGasLimit?: bigint;
+    blockOffset?: number;
+    spMode?: SoulPointSignatureMode;
+    spPrivateKey?: string;
+    spVMode?: VNormalizationMode;
+};
+export type AirdropDisperseSignParams = {
+    rpcUrl: string;
+    chainId: number;
+    fromPrivateKey: string;
+    recipients: string[];
+    amount?: string;
+    amounts?: string[];
+    tokenAddress?: string;
+    gasPriceGwei?: string;
+    transferGasLimit?: bigint;
+    nativeGasLimit?: bigint;
+};
+export type AirdropSweepParams = {
+    rpcUrl: string;
+    chainId: number;
+    sourcePrivateKeys: string[];
+    target: string;
+    ratioPct?: number;
+    amount?: string;
+    tokenAddress?: string;
+    bundleEndpoint?: string;
+    gasPriceGwei?: string;
+    transferGasLimit?: bigint;
+    nativeGasLimit?: bigint;
+    blockOffset?: number;
+    skipIfInsufficient?: boolean;
+    spMode?: SoulPointSignatureMode;
+    spPrivateKey?: string;
+    spVMode?: VNormalizationMode;
+};
+export type AirdropSweepSignParams = {
+    rpcUrl: string;
+    chainId: number;
+    sourcePrivateKeys: string[];
+    target: string;
+    ratioPct?: number;
+    amount?: string;
+    tokenAddress?: string;
+    gasPriceGwei?: string;
+    transferGasLimit?: bigint;
+    nativeGasLimit?: bigint;
+    skipIfInsufficient?: boolean;
+};
+/** @deprecated 使用 `AirdropDisperseParams` */
+export type DisperseParams = AirdropDisperseParams;
+/** @deprecated 使用 `AirdropDisperseSignParams` */
+export type DisperseSignParams = AirdropDisperseSignParams;
+/** @deprecated 使用 `AirdropSweepParams` */
+export type SweepParams = AirdropSweepParams;
+/** @deprecated 使用 `AirdropSweepSignParams` */
+export type SweepSignParams = AirdropSweepSignParams;

package/dist/shared/foundation/types/airdrop-sweep.js

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

package/dist/shared/foundation/types/erc20.d.ts

@@ -0,0 +1,65 @@
+import type { ContractTransactionReceipt } from 'ethers';
+import type { NonceManager } from '../nonce/nonce-manager.js';
+export type EnsureAllowanceResult = {
+    /** 是否已经授权 */
+    alreadyApproved: boolean;
+    /** 当前授权额度 */
+    currentAllowance: bigint;
+    /** 需要的授权额度 */
+    requiredAllowance: bigint;
+    /** 授权交易回执（如果发送了新交易） */
+    txReceipt?: ContractTransactionReceipt | null;
+};
+export type EnsureAllowanceBatchItemResult = EnsureAllowanceResult & {
+    owner: string;
+};
+export type ApproveTokenBatchParams = {
+    chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD';
+    platform: 'flap' | 'four' | 'pancake-v2' | 'pancake-v3';
+    rpcUrl: string;
+    privateKeys: string[];
+    tokenAddress: string;
+    amounts: (bigint | 'max')[];
+    signOnly?: boolean;
+    gasPriceGwei?: number;
+    gasLimit?: number;
+    chainId?: number;
+    skipValidation?: boolean;
+};
+export type ApproveTokenBatchRawParams = {
+    rpcUrl: string;
+    privateKeys: string[];
+    tokenAddress: string;
+    spenderAddress: string;
+    amounts: (bigint | 'max')[];
+    signOnly?: boolean;
+    gasPriceGwei?: number;
+    gasLimit?: number;
+    chainId?: number;
+    nonceManager?: NonceManager;
+    skipValidation?: boolean;
+};
+export type ApproveTokenBatchResult = {
+    success: boolean;
+    approvedCount: number;
+    results: Array<{
+        owner: string;
+        alreadyApproved: boolean;
+        currentAllowance: bigint;
+        requiredAllowance: bigint;
+        txHash?: string;
+        error?: string;
+    }>;
+};
+export type ApproveTokenBatchSignResult = {
+    signedTransactions: string[];
+    results: Array<{
+        owner: string;
+        alreadyApproved: boolean;
+        currentAllowance: bigint;
+        requiredAllowance: bigint;
+        signedTx?: string;
+    }>;
+    needApproveCount: number;
+    alreadyApprovedCount: number;
+};

package/dist/shared/foundation/types/erc20.js

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

package/dist/shared/foundation/types/holders-maker.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 刷持有人 - 类型定义
+ */
+import type { GeneratedWallet } from '../../../utils/wallet.js';
+export type HoldersMakerChain = 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
+export type HoldersMakerTradeType = 'four' | 'flap' | 'v2' | 'v3' | 'daoaas';
+export type BaseTokenType = 'native' | 'usdt' | 'usdc';
+export type HoldersMakerConfig = {
+    rpcUrl: string;
+    chain?: HoldersMakerChain;
+    chainId?: number;
+    tradeType?: HoldersMakerTradeType;
+    gasLimit?: number;
+    gasPriceGwei?: number;
+    bribeAmount?: number;
+    txType?: 0 | 2;
+    maxWalletsPerBatch?: number;
+    fourApiUrl?: string;
+    disperseHopCount?: number;
+    v2Path?: string[];
+    v3TokenIn?: string;
+    v3Fee?: number;
+    v3LpAddresses?: string[];
+    v3Tokens?: string[];
+    v2RouterAddress?: string;
+};
+export type HoldersMakerParams = {
+    payerPrivateKey: string;
+    holdersCount: number;
+    buyAmountPerHolder: string;
+    tokenAddress: string;
+    baseToken?: BaseTokenType;
+    baseTokenAddress?: string;
+    baseTokenDecimals?: number;
+    config: HoldersMakerConfig;
+};
+export type TransactionLayer = {
+    name: string;
+    startIndex: number;
+    endIndex: number;
+    count: number;
+};
+export type BatchResult = {
+    batchIndex: number;
+    success: boolean;
+    signedTransactions?: string[];
+    txHashes?: string[];
+    error?: string;
+    walletCount: number;
+    transactionLayers?: TransactionLayer[];
+    disperseHopCount?: number;
+};
+export type HoldersMakerResult = {
+    success: boolean;
+    newWallets: GeneratedWallet[];
+    disperseHopWallets?: GeneratedWallet[];
+    profitHopWallets?: GeneratedWallet[];
+    signedTransactions: string[][];
+    batchResults: BatchResult[];
+    successBatchCount: number;
+    totalBatchCount: number;
+    error?: string;
+    disperseHopCount?: number;
+};

package/dist/shared/foundation/types/holders-maker.js

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

package/dist/shared/foundation/types/index.d.ts

@@ -0,0 +1,7 @@
+export type { Aggregate3CallResult } from './multicall.js';
+export type { EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult, } from './erc20.js';
+export type { HoldersMakerChain, HoldersMakerTradeType, BaseTokenType, HoldersMakerConfig, HoldersMakerParams, TransactionLayer, BatchResult, HoldersMakerResult, } from './holders-maker.js';
+export type { DexConfig, ChainDexConfig, PoolPairInfo, V3PoolInfo, DexPoolInfo, BestPoolInfo, LPPlatform, LPInfo, InspectOptions, } from './lp-inspect.js';
+export type { BundleSubmitResult, SignedTransactionsResult, AirdropDisperseParams, AirdropDisperseSignParams, AirdropSweepParams, AirdropSweepSignParams, DisperseParams, DisperseSignParams, SweepParams, SweepSignParams, } from './airdrop-sweep.js';
+export type { PrivateSaleSignConfig, PrivateSaleTransferParams, BatchPrivateSaleParams, PrivateSaleResult, } from './private-sale.js';
+export type { SupportedChain, QuoteParams, QuoteResult } from './quote-helpers.js';

package/dist/shared/foundation/types/index.js

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

package/dist/shared/foundation/types/lp-inspect.d.ts

@@ -0,0 +1,102 @@
+/**
+ * LP 查询 - 类型定义
+ */
+import type { FlapChain } from '../../flap/portal.js';
+export interface DexConfig {
+    name: string;
+    v2Factory?: string;
+    v3Factory?: string;
+    v2Router?: string;
+    v3Router?: string;
+    quoterV2?: string;
+    enabled: boolean;
+}
+export interface ChainDexConfig {
+    wrappedNative: string;
+    wrappedNativeSymbol: string;
+    stableCoins: Array<{
+        address: string;
+        symbol: string;
+        decimals: number;
+    }>;
+    dexes: Record<string, DexConfig>;
+}
+export interface PoolPairInfo {
+    quoteToken: string;
+    quoteSymbol: string;
+    quoteDecimals: number;
+    pairAddress: string;
+    reserveToken: string;
+    reserveQuote: string;
+    reserveQuoteRaw?: bigint;
+    reserveTokenRaw?: bigint;
+    poolRatio?: string;
+}
+export interface V3PoolInfo extends PoolPairInfo {
+    fee: number;
+}
+export interface DexPoolInfo {
+    dexName: string;
+    dexKey: string;
+    v2Pairs: PoolPairInfo[];
+    v3Pools: V3PoolInfo[];
+}
+export interface BestPoolInfo {
+    dex: string;
+    dexKey: string;
+    version: 'v2' | 'v3';
+    fee?: number;
+    quoteToken: string;
+    quoteSymbol: string;
+    quoteDecimals: number;
+    pairAddress: string;
+    liquidity: string;
+    liquidityRaw: bigint;
+    reserveToken?: string;
+    reserveTokenRaw?: bigint;
+    poolRatio?: string;
+}
+export type LPPlatform = 'FOUR' | 'FLAP' | 'DAOAAS' | 'PANCAKESWAP_V2' | 'PANCAKESWAP_V3' | 'UNISWAP_V2' | 'UNISWAP_V3' | 'IROSWAP_V2' | 'MULTI_DEX' | 'UNKNOWN';
+export interface LPInfo {
+    platform: LPPlatform;
+    decimals?: number;
+    totalSupply?: string;
+    totalSupplyRaw?: bigint;
+    taxRate?: number;
+    four?: {
+        helper: string;
+        reserveNative?: string;
+        offerTokens?: string;
+        lastPrice?: string;
+    };
+    flap?: {
+        quoteToken?: string;
+        quoteSymbol?: string;
+        quoteDecimals?: number;
+        reserveNative?: string;
+        circulatingSupply?: string;
+        price?: string;
+        taxRate?: number;
+    };
+    daoaas?: {
+        quoteToken?: string;
+        quoteSymbol?: string;
+        quoteDecimals?: number;
+        reserveNative?: string;
+        circulatingSupply?: string;
+        price?: string;
+        status?: number;
+    };
+    allPools: DexPoolInfo[];
+    bestPools: BestPoolInfo[];
+}
+export interface InspectOptions {
+    chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
+    rpcUrl: string;
+    flapChain?: FlapChain;
+    v3FeeTiers?: number[];
+    customDexConfig?: Partial<ChainDexConfig>;
+    multicall3?: string;
+    debug?: boolean;
+    formatBalances?: boolean;
+}