keyring-agent-core 0.1.0

package/dist/services/MoralisService.d.ts

@@ -0,0 +1,1350 @@
+/**
+ * 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://ed64-113-161-74-234.ngrok-free.app) */
+    v1BaseUrl?: string;
+    /** Pantograph API base URL for price enrichment */
+    pantographUrl?: string;
+    /** Cortex AI model (default: gpt-4.1-mini) */
+    cortexModel?: 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 cortexModel;
+    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 token balances for a Solana wallet address via Moralis Cortex AI.
+     * Since Moralis REST proxy does not natively support Solana token balances,
+     * we leverage Cortex AI to retrieve and structure the data.
+     */
+    getWalletTokenBalancesSolanaAddress(params: {
+        address: string;
+    }): 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 (e.g. Solana), 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.
+     *
+     * Solana is 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>>;
+    /**
+     * Chat with Moralis Cortex AI for blockchain insights.
+     */
+    chatWithCortex(params: {
+        prompt: string;
+        model?: string;
+        systemPrompt?: string;
+        maxRetries?: number;
+    }): Promise<MoralisApiResponse<CortexResponse>>;
+    /** 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