keyring-agent-core 0.2.1 → 0.2.2

package/dist/services/MoralisService.d.ts

@@ -1,1328 +0,0 @@
-/**
- * MoralisService — Moralis Web3 API + Cortex AI proxy.
- *
- * Adapted from keyring-chatbot-agent-sdk moralis service.
- * Uses native fetch — no SDK dependencies.
- */
-export interface MoralisServiceConfig {
-    /** Base URL for Moralis proxy (default: https://nft.keyring.app) */
-    baseUrl?: string;
-    /** Base URL for DeFi APIs — uses /api/moralis-v1/proxy route (default:  https://nft-demo.keyring.app) */
-    v1BaseUrl?: string;
-    /** Pantograph API base URL for price enrichment */
-    pantographUrl?: string;
-}
-export interface TokenBalance {
-    token_address: string;
-    symbol: string;
-    name: string;
-    logo?: string;
-    thumbnail?: string;
-    decimals: number;
-    balance: string;
-    possible_spam: boolean;
-    verified_contract: boolean;
-    total_supply?: string;
-    total_supply_formatted?: string;
-    percentage_relative_to_total_supply?: number;
-    balance_formatted: string;
-    usd_price?: number;
-    usd_price_24hr_percent_change?: number;
-    usd_price_24hr_usd_change?: number;
-    usd_value?: number;
-    usd_value_24hr_usd_change?: number;
-    native_token: boolean;
-    portfolio_percentage?: number;
-}
-export interface TokenMetadata {
-    token_address: string;
-    address?: string;
-    name: string;
-    symbol: string;
-    decimals: number;
-    logo?: string;
-    thumbnail?: string;
-    icon_image?: string;
-    logoURI?: string;
-    usd_price?: number;
-    usd_price_24hr_percent_change?: number;
-    usd_price_24hr_usd_change?: number;
-    auditGoplus?: Record<string, unknown>;
-    holder_count?: string;
-    holders?: unknown[];
-    coinGeckoId?: string;
-    position?: number;
-    isActive?: boolean;
-    updatedAt?: string;
-    price_change_24h?: number;
-    telegram_channel_identifier?: string;
-    subreddit_url?: string;
-    facebook_username?: string;
-    twitter_screen_name?: string;
-    homepage?: string[];
-    announcement_url?: string[];
-    categories?: string[];
-    chat_url?: string[];
-    market_cap_rank?: number;
-    max_supply?: number | null;
-    total_supply?: number | string;
-    circulating_supply?: number;
-    fully_diluted_valuation?: number;
-    market_cap?: number;
-    total_volume?: number;
-}
-export interface NFTItem {
-    token_address: string;
-    token_id: string;
-    amount: string;
-    owner_of: string;
-    token_hash: string;
-    block_number_minted: string;
-    block_number: string;
-    contract_type: 'ERC721' | 'ERC1155';
-    name: string;
-    symbol: string;
-    token_uri?: string;
-    metadata?: string;
-    normalized_metadata?: {
-        name?: string;
-        description?: string;
-        image?: string;
-        animation_url?: string;
-        attributes?: Array<{
-            trait_type: string;
-            value: string;
-        }>;
-    };
-    possible_spam: boolean;
-    verified_collection: boolean;
-    media?: {
-        mimetype?: string;
-        parent_hash?: string;
-        status?: string;
-        updated_at?: string;
-        media_collection?: {
-            low?: {
-                url: string;
-                width: number;
-                height: number;
-            };
-            medium?: {
-                url: string;
-                width: number;
-                height: number;
-            };
-            high?: {
-                url: string;
-                width: number;
-                height: number;
-            };
-        };
-        original_media_url?: string;
-    };
-    collection_logo?: string;
-    collection_banner_image?: string;
-}
-export type NFTContractMetadata = {
-    token_address: string;
-    name: string;
-    symbol: string;
-    contract_type: 'ERC721' | 'ERC1155' | string;
-    possible_spam: 'true' | 'false';
-    verified_collection: 'true' | 'false';
-    synced_at: string | null;
-    collection_logo: string;
-    collection_banner_image: string;
-    collection_category: string;
-    project_url: string;
-    wiki_url: string;
-    discord_url: string;
-    telegram_url: string;
-    twitter_username: string;
-    instagram_username: string;
-    floor_price: string;
-    floor_price_usd: string;
-    floor_price_currency: string;
-    last_sale: NFTLastSale | null;
-};
-export type NFTLastSale = {
-    transaction_hash: string;
-    block_timestamp: string;
-    buyer_address: string;
-    seller_address: string;
-    price: string;
-    price_formatted: string;
-    payment_token: PaymentToken;
-    usd_price_at_sale: string;
-    current_usd_value: string;
-    token_address: string;
-    token_id: string;
-};
-export type PaymentToken = {
-    token_name: string;
-    token_symbol: string;
-    token_logo: string;
-    token_decimals: string;
-    token_address: string;
-};
-/**
- * Response shape for `GET /nft/{address}/{token_id}` — a single NFT's full
- * metadata. Superset of {@link NFTItem}: adds market (floor price), rarity,
- * collection social links and sync timestamps not returned by the wallet-NFTs
- * endpoint.
- */
-export interface NFTMetadata extends NFTItem {
-    minter_address?: string;
-    last_metadata_sync?: string;
-    last_token_uri_sync?: string;
-    floor_price?: string;
-    floor_price_usd?: string;
-    floor_price_currency?: string;
-    rarity_rank?: number;
-    rarity_percentage?: number;
-    rarity_label?: string;
-    collection_category?: string;
-    project_url?: string;
-    wiki_url?: string;
-    discord_url?: string;
-    telegram_url?: string;
-    twitter_username?: string;
-    instagram_username?: string;
-}
-/**
- * Transaction category as labelled by the Moralis /wallets/{address}/history
- * endpoint. Values come directly from Moralis's decoder.
- */
-export type WalletHistoryCategory = 'send' | 'receive' | 'token send' | 'token receive' | 'nft send' | 'nft receive' | 'token swap' | 'deposit' | 'withdraw' | 'nft purchase' | 'nft sale' | 'airdrop' | 'mint' | 'burn' | 'borrow' | 'contract interaction';
-export interface WalletHistoryNativeTransfer {
-    from_address: string;
-    to_address: string;
-    value: string;
-    value_formatted: string;
-    direction: 'send' | 'receive';
-    internal_transaction: boolean;
-    token_symbol?: string;
-    token_logo?: string;
-}
-export interface WalletHistoryErc20Transfer {
-    token_name?: string;
-    token_symbol?: string;
-    token_logo?: string;
-    token_decimals?: string;
-    address: string;
-    from_address: string;
-    to_address: string;
-    value: string;
-    value_formatted: string;
-    direction: 'send' | 'receive';
-    possible_spam: boolean;
-    verified_contract: boolean;
-}
-export interface WalletHistoryNftTransfer {
-    token_address: string;
-    token_id: string;
-    from_address: string;
-    to_address: string;
-    value: string;
-    amount: string;
-    contract_type: 'ERC721' | 'ERC1155';
-    transaction_type?: string;
-    direction: 'send' | 'receive';
-    normalized_metadata?: {
-        name?: string;
-        description?: string;
-        image?: string;
-        attributes?: Array<{
-            trait_type: string;
-            value: string;
-        }>;
-    };
-    collection_logo?: string;
-    collection_banner_image?: string;
-    possible_spam?: boolean;
-    verified_collection?: boolean;
-}
-export interface WalletHistoryContractInteraction {
-    approvals?: Array<{
-        token?: {
-            address: string;
-            name?: string;
-            symbol?: string;
-            logo?: string;
-            decimals?: string;
-            possible_spam?: boolean;
-            verified_contract?: boolean;
-        };
-        spender?: {
-            address: string;
-            address_label?: string;
-            entity?: string;
-            entity_logo?: string;
-        };
-        value?: string;
-        value_formatted?: string;
-    }>;
-    revokes?: WalletHistoryContractInteraction['approvals'];
-    setApprovalForAll?: Array<{
-        token?: {
-            address: string;
-            name?: string;
-            symbol?: string;
-        };
-        operator?: {
-            address: string;
-            address_label?: string;
-        };
-        approved_all?: boolean;
-    }>;
-}
-export interface WalletHistoryItem {
-    hash: string;
-    nonce?: string;
-    transaction_index?: string;
-    from_address: string;
-    from_address_label?: string;
-    to_address?: string;
-    to_address_label?: string;
-    value: string;
-    gas?: string;
-    gas_price?: string;
-    receipt_cumulative_gas_used?: string;
-    receipt_gas_used?: string;
-    receipt_status?: string;
-    receipt_contract_address?: string | null;
-    block_timestamp: string;
-    block_number: string;
-    block_hash?: string;
-    transaction_fee?: string;
-    method_label?: string;
-    /** Decoded category. See `WalletHistoryCategory`. */
-    category: WalletHistoryCategory | string;
-    /** Human-readable one-line summary. */
-    summary?: string;
-    possible_spam?: boolean;
-    native_transfers?: WalletHistoryNativeTransfer[];
-    erc20_transfers?: WalletHistoryErc20Transfer[];
-    nft_transfers?: WalletHistoryNftTransfer[];
-    contract_interactions?: WalletHistoryContractInteraction;
-    internal_transactions?: Array<{
-        from: string;
-        to: string;
-        value: string;
-        gas?: string;
-        type?: string;
-        input?: string;
-        output?: string;
-    }>;
-}
-export interface WalletHistoryResponse {
-    cursor?: string | null;
-    page?: number;
-    page_size?: number;
-    limit?: number;
-    result: WalletHistoryItem[];
-}
-export interface CortexResponse {
-    text: string;
-}
-export interface WalletNetWorthChainBreakdown {
-    chain: string;
-    native_balance: string;
-    native_balance_formatted: string;
-    native_balance_usd: string;
-    token_balance_usd: string;
-    networth_usd: string;
-}
-export interface WalletNetWorthUnavailableChain {
-    chain_id: string;
-}
-export interface WalletNetWorthResponse {
-    total_networth_usd: string;
-    chains: WalletNetWorthChainBreakdown[];
-    unsupported_chain_ids?: string[];
-    unavailable_chains?: WalletNetWorthUnavailableChain[];
-}
-export type WalletPnlDaysWindow = 'all' | '7' | '30' | '60' | '90';
-export interface WalletPnlSummaryResponse {
-    total_count_of_trades: number;
-    total_trade_volume: string;
-    total_realized_profit_usd: string;
-    total_realized_profit_percentage: number;
-    total_buys: number;
-    total_sells: number;
-    total_sold_volume_usd: string;
-    total_bought_volume_usd: string;
-}
-export interface WalletPnlTokenItem {
-    token_address: string;
-    avg_buy_price_usd: string;
-    avg_sell_price_usd: string;
-    total_usd_invested: string;
-    total_tokens_sold: string;
-    total_tokens_bought: string;
-    total_sold_usd: string;
-    avg_cost_of_quantity_sold: string;
-    count_of_trades: number;
-    realized_profit_usd: string;
-    realized_profit_percentage: number;
-    total_buys: number;
-    total_sells: number;
-    name: string;
-    symbol: string;
-    decimals: string;
-    logo?: string;
-    possible_spam: boolean;
-}
-export interface WalletPnlResponse {
-    result: WalletPnlTokenItem[];
-}
-export interface MoralisApiResponse<T> {
-    success: boolean;
-    data?: T;
-    error?: string;
-}
-export interface DecodedParam {
-    name: string;
-    value: string;
-    type: string;
-}
-export interface DecodedCall {
-    signature: string;
-    label: string;
-    type: 'function';
-    params: DecodedParam[];
-}
-export interface DecodedEvent {
-    signature: string;
-    label: string;
-    type: 'event';
-    params: DecodedParam[];
-}
-export interface TransactionLog {
-    log_index: string;
-    transaction_hash: string;
-    transaction_index: string;
-    transaction_value: string;
-    address: string;
-    data: string;
-    topic0: string;
-    topic1?: string | null;
-    topic2?: string | null;
-    topic3?: string | null;
-    block_timestamp: string;
-    block_number: string;
-    block_hash: string;
-    decoded_event: DecodedEvent | null;
-}
-export interface TransactionByHashResponse {
-    hash: string;
-    nonce: string;
-    transaction_index: string;
-    from_address: string;
-    from_address_label?: string;
-    from_address_entity?: string;
-    from_address_entity_logo?: string;
-    to_address?: string;
-    to_address_label?: string;
-    to_address_entity?: string;
-    to_address_entity_logo?: string;
-    value: string;
-    gas: string;
-    gas_price: string;
-    input: string;
-    receipt_cumulative_gas_used: string;
-    receipt_gas_used: string;
-    receipt_status: string;
-    receipt_contract_address?: string | null;
-    receipt_root?: string | null;
-    transaction_fee: string;
-    block_timestamp: string;
-    block_number: string;
-    block_hash: string;
-    logs: TransactionLog[];
-    decoded_call: DecodedCall | null;
-}
-export interface WalletTokenTransferItem {
-    transaction_hash: string;
-    block_number: string;
-    block_timestamp: string;
-    block_hash?: string;
-    transaction_index?: number;
-    log_index?: number;
-    /** ERC-20 contract address */
-    address: string;
-    token_name?: string;
-    token_symbol?: string;
-    token_logo?: string;
-    token_decimals?: string;
-    from_address: string;
-    from_address_label?: string;
-    from_address_entity?: string;
-    from_address_entity_logo?: string;
-    to_address: string;
-    to_address_label?: string;
-    to_address_entity?: string;
-    to_address_entity_logo?: string;
-    /** Raw amount (no decimals applied) */
-    value: string;
-    /** Human-readable amount (decimals applied) */
-    value_decimal?: string;
-    possible_spam: boolean;
-    verified_contract: boolean;
-}
-export interface WalletTokenTransfersResponse {
-    cursor?: string | null;
-    page?: number;
-    page_size?: number;
-    result: WalletTokenTransferItem[];
-}
-export interface NftTransferLastSale {
-    transaction_hash?: string;
-    block_timestamp?: string;
-    buyer_address?: string;
-    seller_address?: string;
-    price?: string;
-    price_formatted?: string;
-    usd_price_at_sale?: string;
-    payment_token?: {
-        token_name?: string;
-        token_symbol?: string;
-        token_address?: string;
-        value?: string;
-        value_formatted?: string;
-    };
-}
-export interface WalletNftTransferItem {
-    transaction_hash: string;
-    block_number: string;
-    block_timestamp: string;
-    block_hash?: string;
-    transaction_index?: number;
-    log_index?: number;
-    token_address: string;
-    token_id: string;
-    token_name?: string;
-    token_symbol?: string;
-    contract_type: string;
-    /** Only present for ERC-1155 transfers */
-    operator?: string;
-    from_address: string;
-    from_address_label?: string;
-    from_address_entity?: string;
-    from_address_entity_logo?: string;
-    to_address: string;
-    to_address_label?: string;
-    to_address_entity?: string;
-    to_address_entity_logo?: string;
-    /** Native value sent with the transfer (e.g. for NFT purchases) */
-    value?: string;
-    /** Number of tokens transferred (relevant for ERC-1155) */
-    amount?: string;
-    transaction_type?: string;
-    possible_spam?: boolean;
-    verified_collection?: boolean;
-    last_sale?: NftTransferLastSale;
-}
-export interface WalletNftTransfersResponse {
-    cursor?: string | null;
-    page?: number;
-    page_size?: number;
-    result: WalletNftTransferItem[];
-}
-export interface HolderChangePeriod {
-    change: number;
-    changePercent: number;
-}
-export interface HolderSupplyTier {
-    supply: string;
-    supplyPercent: number;
-}
-export interface TokenHoldersResponse {
-    totalHolders: number;
-    holdersByAcquisition: {
-        swap: number;
-        transfer: number;
-        airdrop: number;
-    };
-    holderChange: {
-        '5min': HolderChangePeriod;
-        '1h': HolderChangePeriod;
-        '6h': HolderChangePeriod;
-        '24h': HolderChangePeriod;
-        '3d': HolderChangePeriod;
-        '7d': HolderChangePeriod;
-        '30d': HolderChangePeriod;
-    };
-    holderSupply: {
-        top10: HolderSupplyTier;
-        top25: HolderSupplyTier;
-        top50: HolderSupplyTier;
-        top100: HolderSupplyTier;
-        top250: HolderSupplyTier;
-        top500: HolderSupplyTier;
-    };
-    holderDistribution: {
-        whales: number;
-        sharks: number;
-        dolphins: number;
-        fish: number;
-        octopus: number;
-        crabs: number;
-        shrimps: number;
-    };
-}
-/**
- * Token descriptor attached to an approval row. Describes *what* was
- * approved, along with current balance / price info so the caller can
- * compute actual USD at-risk.
- */
-export interface TokenApprovalToken {
-    address: string;
-    address_label?: string | null;
-    name?: string | null;
-    symbol?: string | null;
-    logo?: string | null;
-    possible_spam?: boolean;
-    verified_contract?: boolean;
-    current_balance?: string | null;
-    current_balance_formatted?: string | null;
-    usd_price?: string | null;
-    usd_at_risk?: string | null;
-}
-/**
- * Spender descriptor attached to an approval row. Describes *who* was
- * approved to spend the token (typically a DEX router, bridge, marketplace, …).
- */
-export interface TokenApprovalSpender {
-    address: string;
-    address_label?: string | null;
-    entity?: string | null;
-    entity_logo?: string | null;
-}
-/**
- * One active ERC-20 approval held by the wallet. `value` / `value_formatted`
- * is the remaining approved amount — commonly `unlimited`
- * (2^256-1 ≈ 1.15e77) when a dApp was granted max allowance.
- */
-export interface TokenApproval {
-    block_number: string;
-    block_timestamp?: string | null;
-    transaction_hash?: string | null;
-    value: string;
-    value_formatted?: string | null;
-    token: TokenApprovalToken;
-    spender: TokenApprovalSpender;
-}
-export interface WalletApprovalsResponse {
-    page?: number;
-    page_size?: number;
-    cursor?: string | null;
-    result: TokenApproval[];
-}
-/**
- * Per-protocol row returned by the DeFi summary endpoint. Each entry groups
- * all of a wallet's positions inside a single protocol.
- */
-export interface DefiProtocolSummary {
-    protocol_name?: string;
-    protocol_id?: string;
-    protocol_url?: string;
-    protocol_logo?: string;
-    /** USD value of all positions held inside this protocol */
-    total_usd_value: number;
-    /** USD value of unclaimed rewards / fees inside this protocol */
-    total_unclaimed_usd_value: number;
-    /** Number of distinct positions the wallet holds in this protocol */
-    positions: number;
-    /** Account-level health factor (Aave etc.), when applicable */
-    account_health_factor?: number | null;
-}
-export interface WalletDefiSummaryResponse {
-    active_protocols: number;
-    total_positions: number;
-    total_usd_value: number;
-    total_unclaimed_usd_value: number;
-    protocols: DefiProtocolSummary[];
-}
-/**
- * A single token line inside a DeFi position (supplied, borrowed, reward, …).
- * Mirrors Moralis's `defiPositionToken` shape.
- */
-export interface DefiPositionToken {
-    token_type: string;
-    name: string;
-    symbol: string;
-    contract_address: string;
-    decimals: number;
-    logo?: string;
-    thumbnail?: string;
-    balance: string;
-    balance_formatted: string;
-    usd_price?: number;
-    usd_value?: number;
-}
-/**
- * Position-specific details block. Moralis returns a superset of optional
- * fields depending on the protocol (LP, lending, staking, perps, …). We keep
- * it permissive with index signature since the set is non-exhaustive.
- */
-export interface DefiPositionDetails {
-    reserve0?: string;
-    reserve1?: string;
-    factory?: string;
-    pair?: string;
-    lp_amount?: string;
-    lp_amount_formatted?: string;
-    is_v4?: boolean;
-    fee_tier?: number;
-    liquidity?: string;
-    nft_manager?: string;
-    position_key?: string;
-    position_id?: string;
-    price_lower?: string;
-    price_upper?: string;
-    current_price?: string;
-    price_label?: string;
-    reserves?: string[];
-    share_of_pool?: number;
-    apy?: number;
-    is_variable_debt?: boolean;
-    is_stable_debt?: boolean;
-    health_factor?: number;
-    [key: string]: unknown;
-}
-export interface DefiPosition {
-    label: string;
-    tokens: DefiPositionToken[];
-    address?: string;
-    balance_usd: number;
-    total_unclaimed_usd_value: number;
-    position_details?: DefiPositionDetails;
-}
-/**
- * One row of the `GET /wallets/{address}/defi/positions` response: a position
- * enriched with its owning protocol's identity.
- */
-export interface WalletDefiPositionSummary {
-    protocol_name: string;
-    protocol_id: string;
-    protocol_url: string;
-    protocol_logo: string;
-    position: DefiPosition;
-    account_data?: {
-        health_factor?: number;
-        [key: string]: unknown;
-    };
-}
-/** Raw item shape returned by the v1 /defi/positions endpoint */
-export interface WalletDefiPositionsV1Response {
-    meta: {
-        syncedAt?: Record<string, number | string>;
-        unsupportedChains?: string[];
-        failedChains?: string[];
-    };
-    result: Array<{
-        chainId: string;
-        protocolId: string;
-        protocolName: string;
-        protocolUrl?: string;
-        protocolLogo?: string;
-        position: {
-            label: string;
-            address?: string;
-            balanceUsd?: number;
-            unclaimedUsd?: number;
-            tokens: Array<{
-                tokenType: string;
-                address: string;
-                name?: string;
-                symbol?: string;
-                decimals?: number;
-                logo?: string;
-                balance?: string;
-                balanceFormatted?: string;
-                usdPrice?: number;
-                usdValue?: number;
-            }>;
-            details?: {
-                type?: string;
-                isDebt?: boolean;
-                lending?: {
-                    healthFactor?: number;
-                };
-                liquidity?: {
-                    poolAddress?: string;
-                };
-                [key: string]: unknown;
-            };
-        };
-    }>;
-    cursor?: string;
-}
-/**
- * Response from `GET /wallets/{address}/defi/{protocol}/positions` — all
- * positions the wallet holds inside a single protocol, with totals.
- */
-export interface WalletDefiProtocolPositionsResponse {
-    protocol_name: string;
-    protocol_id: string;
-    protocol_url: string;
-    protocol_logo: string;
-    total_usd_value: number;
-    total_unclaimed_usd_value: number | null;
-    positions: DefiPosition[];
-    account_data?: {
-        health_factor?: number;
-        [key: string]: unknown;
-    };
-}
-/** Raw response from v1 GET /wallets/{address}/defi/{protocol}/positions */
-export interface WalletDefiProtocolPositionsV1Response {
-    meta: {
-        syncedAt?: Record<string, number | string>;
-        unsupportedChains?: string[];
-        failedChains?: string[];
-    };
-    cursor?: string;
-    result: {
-        protocolId: string;
-        protocolName: string;
-        chainId: string;
-        totalUsd?: number;
-        totalUnclaimedUsd?: number;
-        protocolUrl?: string;
-        protocolLogo?: string;
-        positions: Array<{
-            label: string;
-            address?: string;
-            balanceUsd?: number;
-            unclaimedUsd?: number;
-            tokens: Array<{
-                tokenType: string;
-                address: string;
-                name?: string;
-                symbol?: string;
-                decimals?: number;
-                logo?: string;
-                balance?: string;
-                balanceFormatted?: string;
-                usdPrice?: number;
-                usdValue?: number;
-            }>;
-            details?: {
-                type?: string;
-                isDebt?: boolean;
-                lending?: {
-                    healthFactor?: number;
-                };
-                liquidity?: {
-                    poolAddress?: string;
-                };
-                [key: string]: unknown;
-            };
-        }>;
-    };
-}
-/**
- * Multi-timeframe numeric breakdown returned by the trending-tokens endpoint.
- * Moralis exposes the same four buckets (1h / 4h / 12h / 24h) for every
- * activity metric (volume, transactions, buyers/sellers, price change, …).
- */
-export interface TrendingTokenTimeframeBuckets {
-    '1h'?: number | null;
-    '4h'?: number | null;
-    '12h'?: number | null;
-    '24h'?: number | null;
-}
-export interface TrendingToken {
-    chainId: string;
-    tokenAddress: string;
-    name?: string | null;
-    symbol?: string | null;
-    uniqueName?: string | null;
-    decimals?: number | null;
-    logo?: string | null;
-    usdPrice?: number | null;
-    /** Unix timestamp (seconds) of the token's creation / first observation. */
-    createdAt?: number | null;
-    marketCap?: number | null;
-    liquidityUsd?: number | null;
-    holders?: number | null;
-    pricePercentChange?: TrendingTokenTimeframeBuckets;
-    totalVolume?: TrendingTokenTimeframeBuckets;
-    transactions?: TrendingTokenTimeframeBuckets;
-    buyTransactions?: TrendingTokenTimeframeBuckets;
-    sellTransactions?: TrendingTokenTimeframeBuckets;
-    buyers?: TrendingTokenTimeframeBuckets;
-    sellers?: TrendingTokenTimeframeBuckets;
-}
-export type TopGainersTimeFrame = '1h' | '1d' | '1w' | '1M';
-/**
- * Multi-timeframe numeric breakdown returned by the top-gainers discovery
- * endpoint. Unlike trending tokens, the buckets are 1h / 1d / 1w / 1M.
- */
-export interface TopGainerTimeFrames {
-    '1h'?: number | null;
-    '1d'?: number | null;
-    '1w'?: number | null;
-    '1M'?: number | null;
-}
-export interface TopGainerToken {
-    chain_id: string;
-    token_address: string;
-    token_name?: string | null;
-    token_symbol?: string | null;
-    token_logo?: string | null;
-    price_usd?: number | null;
-    token_age_in_days?: number | null;
-    on_chain_strength_index?: number | null;
-    /** Security rating from 0 (risky) to 100 (safe). */
-    security_score?: number | null;
-    market_cap?: number | null;
-    fully_diluted_valuation?: number | null;
-    twitter_followers?: number | null;
-    holders_change?: TopGainerTimeFrames;
-    liquidity_change_usd?: TopGainerTimeFrames;
-    experienced_net_buyers_change?: TopGainerTimeFrames;
-    volume_change_usd?: TopGainerTimeFrames;
-    net_volume_change_usd?: TopGainerTimeFrames;
-    price_percent_change_usd?: TopGainerTimeFrames;
-}
-/**
- * Buckets exposed by the token-analytics endpoint. Every activity metric
- * (volume, buyers, sellers, transactions, price change, …) is broken down
- * across 5min / 1h / 6h / 24h windows.
- */
-export interface TokenAnalyticsTimeframeBuckets {
-    '5m'?: number | null;
-    '1h'?: number | null;
-    '6h'?: number | null;
-    '24h'?: number | null;
-}
-export interface TokenAnalyticsResponse {
-    chainId?: string;
-    categoryId?: string | null;
-    totalBuyVolume?: TokenAnalyticsTimeframeBuckets;
-    totalSellVolume?: TokenAnalyticsTimeframeBuckets;
-    totalBuyers?: TokenAnalyticsTimeframeBuckets;
-    totalSellers?: TokenAnalyticsTimeframeBuckets;
-    totalBuys?: TokenAnalyticsTimeframeBuckets;
-    totalSells?: TokenAnalyticsTimeframeBuckets;
-    uniqueWallets?: TokenAnalyticsTimeframeBuckets;
-    pricePercentChange?: TokenAnalyticsTimeframeBuckets;
-    /** Current USD price. Returned as a string by Moralis. */
-    usdPrice?: string | number | null;
-    /** Total paired-pool liquidity in USD. Returned as a string by Moralis. */
-    totalLiquidity?: string | number | null;
-    /** Fully-diluted valuation in USD. Returned as a string by Moralis. */
-    totalFullyDilutedValuation?: string | number | null;
-}
-/**
- * Buckets exposed by the token-score endpoint for volume and transaction
- * counts. Covers 10m / 30m / 1h / 4h / 12h / 1d / 7d / 30d windows.
- */
-export interface TokenScoreTimeframeBuckets {
-    '10m'?: number | null;
-    '30m'?: number | null;
-    '1h'?: number | null;
-    '4h'?: number | null;
-    '12h'?: number | null;
-    '1d'?: number | null;
-    '7d'?: number | null;
-    '30d'?: number | null;
-}
-export interface TokenScoreSupply {
-    /** Total supply as a raw number (decimals already applied upstream). */
-    total?: number | null;
-    /** Percent of total supply held by the top 10 holders (0–100). */
-    top10Percent?: number | null;
-}
-export interface TokenScoreMetrics {
-    usdPrice?: number | null;
-    liquidityUsd?: number | null;
-    volumeUsd?: TokenScoreTimeframeBuckets;
-    transactions?: TokenScoreTimeframeBuckets;
-    supply?: TokenScoreSupply;
-}
-export interface TokenScoreResponse {
-    tokenAddress?: string;
-    chainId?: string;
-    /** Integer 0–100 composite score. Higher = safer / healthier. */
-    score?: number | null;
-    /** ISO-8601 timestamp of the score's last refresh. */
-    updatedAt?: string | null;
-    metrics?: TokenScoreMetrics;
-}
-export declare class MoralisService {
-    private baseUrl;
-    private v1BaseUrl;
-    private pantograph;
-    constructor(config?: MoralisServiceConfig);
-    /**
-     * Get token balances for a wallet.
-     * Automatically enriches prices via Pantograph and filters dust.
-     */
-    getWalletTokenBalances(params: {
-        address: string;
-        chain?: string;
-        tokenAddresses?: string[];
-        excludeSpam?: boolean;
-        excludeUnverifiedContracts?: boolean;
-    }): Promise<MoralisApiResponse<{
-        result: TokenBalance[];
-    }>>;
-    /**
-     * Get metadata + price for a single token by contract address.
-     */
-    getTokenMetadata(params: {
-        address: string;
-        chain?: string;
-    }): Promise<MoralisApiResponse<TokenMetadata>>;
-    /**
-     * Get NFTs owned by a wallet.
-     */
-    getWalletNFTs(params: {
-        address: string;
-        chain?: string;
-        limit?: number;
-        excludeSpam?: boolean;
-        cursor?: string;
-        tokenAddresses?: string[];
-        includePrices?: boolean;
-        format?: 'decimal' | 'hex';
-    }): Promise<MoralisApiResponse<{
-        result: NFTItem[];
-        cursor?: string;
-        page?: number;
-        page_size?: number;
-    }>>;
-    /**
-     * Get the full metadata for a single NFT identified by its contract address
-     * and token id via the Moralis `GET /nft/{address}/{token_id}` endpoint.
-     *
-     * Returns normalized metadata (name, description, image, attributes),
-     * media variants, floor-price, rarity, collection socials and sync
-     * timestamps. Only supported on EVM chains.
-     *
-     * Moralis docs: https://docs.moralis.com/data-api/evm/nft/metadata/nft-metadata
-     */
-    getNftMetadata(params: {
-        address: string;
-        tokenId: string;
-        chain?: string;
-        format?: 'decimal' | 'hex';
-        normalizeMetadata?: boolean;
-        mediaItems?: boolean;
-        include?: 'last_token_uri_sync' | 'last_metadata_sync';
-    }): Promise<MoralisApiResponse<NFTMetadata>>;
-    /**
-     * Get metadata for an NFT contract (name, symbol, contract_type).
-     *
-     * For EVM addresses, queries the Moralis REST proxy directly.
-     * For non-EVM addresses, delegates to Cortex AI.
-     */
-    getNftContractMetadata(params: {
-        address: string;
-        chain?: string;
-    }): Promise<MoralisApiResponse<NFTContractMetadata>>;
-    /**
-     * Get a wallet's decoded on-chain transaction history via the Moralis
-     * `GET /wallets/{address}/history` endpoint.
-     *
-     * Moralis returns each transaction already categorised (send, token swap,
-     * nft purchase, airdrop, mint, contract interaction, …) with a human-readable
-     * summary and decoded native / ERC-20 / NFT transfer arrays attached.
-     *
-     * Pagination is supported via `cursor`. Pass the cursor from a previous
-     * response back in to fetch the next page.
-     *
-     * Non-EVM chains are not supported by this REST endpoint. Only EVM addresses are
-     * accepted.
-     */
-    getWalletHistory(params: {
-        address: string;
-        chain?: string;
-        limit?: number;
-        fromDate?: string;
-        toDate?: string;
-        fromBlock?: number;
-        toBlock?: number;
-        cursor?: string;
-        order?: 'ASC' | 'DESC';
-        includeInternalTransactions?: boolean;
-        nftMetadata?: boolean;
-    }): Promise<MoralisApiResponse<WalletHistoryResponse>>;
-    /**
-     * Get every ERC-20 transfer involving a wallet, optionally filtered by one
-     * or more token contract addresses.
-     *
-     * Use this to answer questions like:
-     *   - "When did I last send USDC and to whom?"
-     *   - "Who have I sent token 0x… to?"
-     *   - "Who sent me USDC?"
-     *   - "Show all USDT transfers for my wallet"
-     */
-    getWalletTokenTransfers(params: {
-        address: string;
-        chain?: string;
-        contractAddresses?: string[];
-        limit?: number;
-        fromDate?: string;
-        toDate?: string;
-        fromBlock?: number;
-        toBlock?: number;
-        cursor?: string;
-        order?: 'ASC' | 'DESC';
-    }): Promise<MoralisApiResponse<WalletTokenTransfersResponse>>;
-    /**
-     * Get every NFT transfer involving a wallet, optionally filtered by one
-     * or more NFT contract addresses.
-     *
-     * Use this to answer questions like:
-     *   - "Which NFTs did I sell?"
-     *   - "Who did I send my NFTs to?"
-     *   - "Who sent me NFTs from collection 0x…?"
-     *   - "Show all NFT transfers with last sale price"
-     */
-    getWalletNftTransfers(params: {
-        address: string;
-        chain?: string;
-        contractAddresses?: string[];
-        limit?: number;
-        fromDate?: string;
-        toDate?: string;
-        fromBlock?: number;
-        toBlock?: number;
-        cursor?: string;
-        order?: 'ASC' | 'DESC';
-        includePrices?: boolean;
-        format?: 'decimal' | 'hex';
-    }): Promise<MoralisApiResponse<WalletNftTransfersResponse>>;
-    /**
-     * Get the paginated list of holders for an ERC-20 token.
-     *
-     * URL: GET /api/moralis/proxy/erc20/{contractAddress}/holders
-     *
-     * Use to answer questions like:
-     *   - "Who holds USDC?"
-     *   - "Show top holders of 0x…"
-     *   - "How many wallets hold this token?"
-     *   - "What % does the biggest holder control?"
-     */
-    getTokenHolders(params: {
-        address: string;
-        chain?: string;
-    }): Promise<MoralisApiResponse<TokenHoldersResponse>>;
-    /**
-     * Get a wallet's total net worth in USD, broken down per chain.
-     *
-     * URL: GET /api/moralis/proxy/wallets/{address}/net-worth
-     *
-     * Use to answer questions like:
-     *   - "What's my total wallet value?"
-     *   - "How much is my portfolio worth on each chain?"
-     */
-    getWalletNetWorth(params: {
-        address: string;
-        chains?: string[];
-        excludeSpam?: boolean;
-        excludeUnverifiedContracts?: boolean;
-        maxTokenInactivity?: number;
-        minPairSideLiquidityUsd?: number;
-    }): Promise<MoralisApiResponse<WalletNetWorthResponse>>;
-    /**
-     * Get aggregate profit-and-loss summary for a wallet.
-     *
-     * URL: GET /api/moralis/proxy/wallets/{address}/profitability/summary
-     *
-     * Mainnet only. Moralis supports: Ethereum (0x1), Base (0x2105), Polygon (0x89).
-     */
-    getWalletPnlSummary(params: {
-        address: string;
-        chain?: string;
-        days?: WalletPnlDaysWindow;
-    }): Promise<MoralisApiResponse<WalletPnlSummaryResponse>>;
-    /**
-     * Get per-token profit-and-loss breakdown for a wallet.
-     *
-     * URL: GET /api/moralis/proxy/wallets/{address}/profitability
-     *
-     * Mainnet only. Moralis supports: Ethereum (0x1), Base (0x2105), Polygon (0x89).
-     * tokenAddresses supports up to 25 addresses.
-     */
-    getWalletPnl(params: {
-        address: string;
-        chain?: string;
-        days?: WalletPnlDaysWindow;
-        tokenAddresses?: string[];
-    }): Promise<MoralisApiResponse<WalletPnlResponse>>;
-    /**
-     * Get a decoded transaction by its hash.
-     *
-     * URL: GET /api/moralis/proxy/transaction/{transactionHash}?chain=…&decode=true
-     *
-     * Returns full transaction details including decoded function call and
-     * decoded event logs, along with address labels and entity names.
-     */
-    getTransactionByHash(params: {
-        transactionHash: string;
-        chain?: string;
-    }): Promise<MoralisApiResponse<TransactionByHashResponse>>;
-    /**
-     * List every active ERC-20 token approval granted by a wallet, paginated.
-     *
-     * URL: GET /api/moralis/proxy/wallets/{address}/approvals?chain=…&limit=…&cursor=…
-     *
-     * Moralis docs: https://docs.moralis.com/data-api/evm/wallet/approvals
-     *
-     * Mainnet EVM only. Each row includes the approved token (with current
-     * balance, USD price, `usd_at_risk`) and the spender (address, label,
-     * entity).
-     */
-    getWalletApprovals(params: {
-        address: string;
-        chain?: string;
-        limit?: number;
-        cursor?: string;
-    }): Promise<MoralisApiResponse<WalletApprovalsResponse>>;
-    /**
-     * Get a DeFi summary for a wallet: aggregate USD value, unclaimed rewards
-     * and a per-protocol breakdown of where the wallet has positions.
-     *
-     * URL: GET /api/moralis/proxy/wallets/{address}/defi/summary?chain=…
-     *
-     * Moralis docs: https://docs.moralis.com/data-api/evm/wallet/wallet-protocols
-     *
-     * Mainnet EVM only.
-     */
-    getWalletDefiSummary(params: {
-        address: string;
-        chain?: string;
-    }): Promise<MoralisApiResponse<WalletDefiSummaryResponse>>;
-    /**
-     * Get every DeFi position a wallet holds across all supported protocols,
-     * each enriched with the owning protocol's identity.
-     *
-     * URL: GET /api/moralis/proxy/wallets/{address}/defi/positions?chain=…
-     *
-     * Moralis docs: https://docs.moralis.com/data-api/evm/wallet/wallet-positions
-     */
-    getWalletDefiPositions(params: {
-        address: string;
-        chain?: string;
-    }): Promise<MoralisApiResponse<WalletDefiPositionSummary[]>>;
-    /**
-     * Get detailed positions a wallet holds inside a specific protocol
-     * (e.g. `uniswap-v3`, `aave-v3`, `lido`).
-     *
-     * URL: GET /api/moralis/proxy/wallets/{address}/defi/{protocol}/positions?chain=…
-     *
-     * Moralis docs: https://docs.moralis.com/data-api/evm/wallet/detailed-positions
-     */
-    getWalletDefiProtocolPositions(params: {
-        address: string;
-        protocol: string;
-        chain?: string;
-    }): Promise<MoralisApiResponse<WalletDefiProtocolPositionsResponse>>;
-    /** Search for tokens by symbol or name keyword on a specific chain. */
-    searchTokensByKey(params: {
-        key: string;
-        chain?: string;
-    }): Promise<MoralisApiResponse<TokenMetadata[]>>;
-    /**
-     * Detailed trading analytics for a single token: buy/sell volume, unique
-     * buyers/sellers, transaction counts, unique wallets, price change,
-     * current USD price, total liquidity and FDV — all broken down across
-     * 5min / 1h / 6h / 24h windows.
-     *
-     * URL: GET /api/moralis/proxy/tokens/{tokenAddress}/analytics
-     * Upstream: GET https://deep-index.moralis.io/api/v2.2/tokens/{tokenAddress}/analytics
-     *
-     * Use to answer questions like:
-     *   - "How is PEPE trading today?"
-     *   - "What's the 24h buy vs sell volume for USDC?"
-     *   - "How many unique wallets interacted with this token in the last hour?"
-     *   - "Is buying or selling pressure stronger for this token?"
-     */
-    getTokenAnalytics(params: {
-        address: string;
-        chain?: string;
-    }): Promise<MoralisApiResponse<TokenAnalyticsResponse>>;
-    /**
-     * Composite 0–100 health/safety score for a single token, plus the
-     * underlying metrics Moralis uses to compute it: current USD price, paired
-     * liquidity, multi-timeframe volume and transaction counts (10m / 30m /
-     * 1h / 4h / 12h / 1d / 7d / 30d), and supply concentration (total + % held
-     * by the top 10 wallets).
-     *
-     * URL: GET /api/moralis/proxy/tokens/{tokenAddress}/score
-     * Upstream: GET https://deep-index.moralis.io/api/v2.2/tokens/{tokenAddress}/score
-     *
-     * Use to answer questions like:
-     *   - "Is PEPE a safe token?" (→ score)
-     *   - "What's the health score of this token?"
-     *   - "How concentrated is X's supply among top holders?" (→ metrics.supply.top10Percent)
-     *   - "How much volume did this token do over the last 7 days?" (→ metrics.volumeUsd.7d)
-     */
-    getTokenScore(params: {
-        address: string;
-        chain?: string;
-    }): Promise<MoralisApiResponse<TokenScoreResponse>>;
-    /**
-     * List tokens trending on-chain based on trading activity, volume, liquidity
-     * and holder growth. Moralis returns cross-chain results by default; pass a
-     * `chain` to scope to a single network.
-     *
-     * URL: GET /api/moralis/proxy/tokens/trending
-     * Upstream: GET https://deep-index.moralis.io/api/v2.2/tokens/trending
-     *
-     * Use to answer questions like:
-     *   - "What tokens are trending right now?"
-     *   - "Show me the hottest tokens on Base"
-     *   - "Which tokens have the most trading activity today?"
-     */
-    getTrendingTokens(params?: {
-        chain?: string;
-        limit?: number;
-    }): Promise<MoralisApiResponse<TrendingToken[]>>;
-    /**
-     * List tokens with the highest USD price increase over a given timeframe.
-     * Supports optional filters for minimum market cap and security score.
-     *
-     * URL: GET /api/moralis/proxy/discovery/tokens/top-gainers
-     * Upstream: GET https://deep-index.moralis.io/api/v2.2/discovery/tokens/top-gainers
-     *
-     * Use to answer questions like:
-     *   - "What are today's top gainers?"
-     *   - "Which tokens pumped the most this week on Arbitrum?"
-     *   - "Show me safe tokens (security score ≥ 80) that gained in the last hour"
-     */
-    getTopGainers(params?: {
-        chain?: string;
-        timeFrame?: TopGainersTimeFrame;
-        minMarketCap?: number;
-        securityScore?: number;
-    }): Promise<MoralisApiResponse<TopGainerToken[]>>;
-    /**
-     * List tokens with the largest USD price decrease over a given timeframe.
-     * Same filter set as top-gainers (min market cap, security score) and
-     * identical response shape — only the ranking direction differs.
-     *
-     * URL: GET /api/moralis/proxy/discovery/tokens/top-losers
-     * Upstream: GET https://deep-index.moralis.io/api/v2.2/discovery/tokens/top-losers
-     *
-     * Use to answer questions like:
-     *   - "What are today's biggest losers?"
-     *   - "Which tokens dumped the most this week on BSC?"
-     *   - "Worst performers in the last 24h with market cap over $50M"
-     */
-    getTopLosers(params?: {
-        chain?: string;
-        timeFrame?: TopGainersTimeFrame;
-        minMarketCap?: number;
-        securityScore?: number;
-    }): Promise<MoralisApiResponse<TopGainerToken[]>>;
-    /** Enrich token balances with price/logo data. Delegates to PantographService. */
-    private enrichTokenPrices;
-}
-//# sourceMappingURL=MoralisService.d.ts.map