@covalenthq/client-sdk 2.2.5 → 2.3.0

package/dist/cjs/src/GoldRushClient.d.ts

@@ -5,8 +5,10 @@ import { BitcoinService } from "./services/BitcoinService";
 import { NftService } from "./services/NftService";
 import { PricingService } from "./services/PricingService";
 import { SecurityService } from "./services/SecurityService";
+import { StreamingService } from "./services/StreamingService";
 import { TransactionService } from "./services/TransactionService";
 import { type GoldRushClientSettings } from "./utils/types/Generic.types";
+import { type StreamingServiceConfig } from "./utils/types/StreamingService.types";
 /**
  * GoldRushClient Class
  */
@@ -19,6 +21,7 @@ export declare class GoldRushClient {
     NftService: NftService;
     PricingService: PricingService;
     SecurityService: SecurityService;
+    StreamingService: StreamingService;
     TransactionService: TransactionService;
-    constructor(apiKey: string, settings?: GoldRushClientSettings);
+    constructor(apiKey: string, settings?: GoldRushClientSettings, streamingConfig?: StreamingServiceConfig);
 }

package/dist/cjs/src/services/PricingService.d.ts

@@ -1,6 +1,6 @@
 import { type Execution } from "../utils/functions/execution";
-import { type Chain, type GoldRushResponse, type Quote } from "../utils/types/Generic.types";
-import { type GetTokenPricesQueryParamOpts, type TokenPricesResponse } from "../utils/types/PricingService.types";
+import type { Chain, GoldRushResponse, Quote } from "../utils/types/Generic.types";
+import type { GetTokenPricesQueryParamOpts, PoolSpotPriceQueryParamsOpts, PoolSpotPricesResponse, TokenPricesResponse } from "../utils/types/PricingService.types";
 /**
  * Pricing API
  *
@@ -22,4 +22,15 @@ export declare class PricingService {
      *
      */
     getTokenPrices(chainName: Chain, quoteCurrency: Quote, contractAddress: string, queryParamOpts?: GetTokenPricesQueryParamOpts): Promise<GoldRushResponse<TokenPricesResponse[]>>;
+    /**
+     *
+     * Get the spot token pair prices for a specified pool contract address. Supports pools on Uniswap V2, V3 and their forks.
+     *
+     * @param {Chain} chainName - The chain name eg: `eth-mainnet` or 1.
+     * @param {string} contractAddress - The pool contract address.
+     * @param {GetTokenPricesQueryParamOpts} queryParamOpts
+     *    - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, `GBP`, `BTC` and `ETH`.
+     *
+     */
+    getPoolSpotPrices(chainName: Chain, contractAddress: string, queryParamOpts?: PoolSpotPriceQueryParamsOpts): Promise<GoldRushResponse<PoolSpotPricesResponse[]>>;
 }

package/dist/cjs/src/services/StreamingService.d.ts

@@ -0,0 +1,151 @@
+import { type NewPairsStreamParams, type NewPairsStreamResponse, type OHLCVPairsStreamParams, type OHLCVPairsStreamResponse, type OHLCVTokensStreamParams, type OHLCVTokensStreamResponse, type StreamingServiceConfig, type StreamSubscriptionOptions, type TokenBalancesStreamParams, type TokenBalancesStreamResponse, type UnsubscribeFunction, type WalletActivityStreamParams, type WalletActivityStreamResponse } from "../utils/types/StreamingService.types";
+import { type Client } from "graphql-ws";
+/**
+ * Streaming API Service
+ *
+ */
+export declare class StreamingService {
+    private defaultConfig;
+    constructor(apiKey: string, config?: StreamingServiceConfig);
+    /**
+     * Initialize the streaming connection
+     */
+    getClient(): Client;
+    /**
+     * Disconnect from the streaming service
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if the client is connected
+     */
+    get isConnected(): boolean;
+    /**
+     * Subscribe to a custom GraphQL subscription
+     * This allows for advanced usage and future extensibility
+     *
+     * @param query - GraphQL subscription query
+     * @param variables - Query variables
+     * @param callbacks - Subscription callbacks
+     * @returns Unsubscribe function
+     */
+    rawQuery<T = Array<object>>(query: string, variables: Record<string, unknown>, callbacks: StreamSubscriptionOptions<T>): UnsubscribeFunction;
+    /**
+     * Subscribe to OHLCV data for specific pairs
+     *
+     * @param params - Parameters for the OHLCV pairs stream
+     * @param callbacks - Subscription callbacks
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = streamingService.subscribeToOHLCVPairs(
+     *   {
+     *     chain_name: StreamingChain.BASE_MAINNET,
+     *     pair_addresses: ["0x9c087Eb773291e50CF6c6a90ef0F4500e349B903"],
+     *     interval: StreamingInterval.ONE_MINUTE,
+     *     timeframe: StreamingTimeframe.ONE_HOUR
+     *   },
+     *   {
+     *     next: (data) => console.log("OHLCV Data:", data),
+     *     error: (err) => console.error("Error:", err),
+     *     complete: () => console.log("Stream completed")
+     *   }
+     * );
+     * ```
+     */
+    subscribeToOHLCVPairs(params: OHLCVPairsStreamParams, callbacks: StreamSubscriptionOptions<OHLCVPairsStreamResponse[]>): UnsubscribeFunction;
+    /**
+     * Subscribe to OHLCV data for specific tokens
+     *
+     * @param params - Parameters for the OHLCV tokens stream
+     * @param callbacks - Subscription callbacks
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = streamingService.subscribeToOHLCVTokens(
+     *   {
+     *     chain_name: StreamingChain.BASE_MAINNET,
+     *     token_addresses: ["0x4B6104755AfB5Da4581B81C552DA3A25608c73B8"],
+     *     interval: StreamingInterval.ONE_MINUTE,
+     *     timeframe: StreamingTimeframe.ONE_HOUR
+     *   },
+     *   {
+     *     next: (data) => console.log("OHLCV Token Data:", data),
+     *     error: (err) => console.error("Error:", err),
+     *     complete: () => console.log("Stream completed")
+     *   }
+     * );
+     * ```
+     */
+    subscribeToOHLCVTokens(params: OHLCVTokensStreamParams, callbacks: StreamSubscriptionOptions<OHLCVTokensStreamResponse[]>): UnsubscribeFunction;
+    /**
+     * Subscribe to new DEX pairs created on supported decentralized exchanges
+     *
+     * @param params - Parameters for the new pairs stream
+     * @param callbacks - Subscription callbacks
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = streamingService.subscribeToNewPairs(
+     *   {
+     *     chain_name: StreamingChain.BASE_MAINNET,
+     *     protocols: [StreamingProtocol.UNISWAP_V2, StreamingProtocol.UNISWAP_V3]
+     *   },
+     *   {
+     *     next: (data) => console.log("New Pairs:", data),
+     *     error: (err) => console.error("Error:", err),
+     *     complete: () => console.log("Stream completed")
+     *   }
+     * );
+     * ```
+     */
+    subscribeToNewPairs(params: NewPairsStreamParams, callbacks: StreamSubscriptionOptions<NewPairsStreamResponse[]>): UnsubscribeFunction;
+    /**
+     * Subscribe to real-time token balance updates for a specific wallet address
+     *
+     * @param params - Parameters for the token balances stream
+     * @param callbacks - Subscription callbacks
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = streamingService.subscribeToTokenBalances(
+     *   {
+     *     chain_name: StreamingChain.BASE_MAINNET,
+     *     wallet_address: "0x198ef79f1f515f02dfe9e3115ed9fc07183f02fc"
+     *   },
+     *   {
+     *     next: (data) => console.log("Token Balances:", data),
+     *     error: (err) => console.error("Error:", err),
+     *     complete: () => console.log("Stream completed")
+     *   }
+     * );
+     * ```
+     */
+    subscribeToTokenBalances(params: TokenBalancesStreamParams, callbacks: StreamSubscriptionOptions<TokenBalancesStreamResponse>): UnsubscribeFunction;
+    /**
+     * Subscribe to real-time wallet activity including transactions, token transfers, and smart contract interactions
+     *
+     * @param params - Parameters for the wallet activity stream
+     * @param callbacks - Subscription callbacks
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = streamingService.subscribeToWalletActivity(
+     *   {
+     *     chain_name: StreamingChain.BASE_MAINNET,
+     *     wallet_addresses: ["0x198ef79f1f515f02dfe9e3115ed9fc07183f02fc"]
+     *   },
+     *   {
+     *     next: (data) => console.log("Wallet Activity:", data),
+     *     error: (err) => console.error("Error:", err),
+     *     complete: () => console.log("Stream completed")
+     *   }
+     * );
+     * ```
+     */
+    subscribeToWalletActivity(params: WalletActivityStreamParams, callbacks: StreamSubscriptionOptions<WalletActivityStreamResponse[]>): UnsubscribeFunction;
+}

package/dist/cjs/src/utils/types/PricingService.types.d.ts

@@ -38,3 +38,43 @@ export type GetTokenPricesQueryParamOpts = Nullable<{
     /** * Sort the prices in chronological ascending order. By default, it's set to `false` and returns prices in chronological descending order. */
     pricesAtAsc?: boolean;
 }>;
+export type PoolSpotPriceQueryParamsOpts = Nullable<{
+    /** * The currency to convert. */
+    quoteCurrency: string;
+}>;
+export type PoolSpotPricesResponse = Nullable<{
+    /** * The timestamp when the response was generated. */
+    updated_at: Date;
+    /** * The pool contract address. */
+    pool_address: string;
+    /** * The contract address of token_0 in the token pair making up the pool. */
+    token_0_address: string;
+    /** * The contract name of token_0 in the token pair making up the pool. */
+    token_0_name: string;
+    /** * The contract symbol of token_0 in the token pair making up the pool. */
+    token_0_ticker: string;
+    /** * Price of token_0 in units of token_1. */
+    token_0_price: string;
+    /** * Price of token_0 in units of token_1 as of 24 hours ago. */
+    token_0_price_24h: string;
+    /** * Price of token_0 in the selected quote currency (defaults to USD). */
+    token_0_price_quote: string;
+    /** * Price of token_0 in the selected quote currency (defaults to USD) as of 24 hours ago. */
+    token_0_price_24h_quote: string;
+    /** * The contract address of token_1 in the token pair making up the pool. */
+    token_1_address: string;
+    /** * The contract name of token_1 in the token pair making up the pool. */
+    token_1_name: string;
+    /** * The contract symbol of token_1 in the token pair making up the pool. */
+    token_1_ticker: string;
+    /** * Price of token_1 in units of token_0. */
+    token_1_price: string;
+    /** * Price of token_1 in units of token_0 as of 24 hours ago. */
+    token_1_price_24h: string;
+    /** * Price of token_1 in the selected quote currency (defaults to USD). */
+    token_1_price_quote: string;
+    /** * Price of token_1 in the selected quote currency (defaults to USD) as of 24 hours ago. */
+    token_1_price_24h_quote: string;
+    /** * The currency to convert. */
+    quote_currency: string;
+}>;

package/dist/cjs/src/utils/types/StreamingService.types.d.ts

@@ -0,0 +1,201 @@
+import type { ContractMetadata } from "./Generic.types";
+/**
+ * Common enums and types for Streaming API
+ */
+export declare enum StreamingChain {
+    BASE_MAINNET = "BASE_MAINNET",
+    ETH_MAINNET = "ETH_MAINNET",
+    BSC_MAINNET = "BSC_MAINNET"
+}
+export declare enum StreamingInterval {
+    FIFTEEN_SECONDS = "FIFTEEN_SECONDS",
+    THIRTY_SECONDS = "THIRTY_SECONDS",
+    ONE_MINUTE = "ONE_MINUTE",
+    FIVE_MINUTES = "FIVE_MINUTES",
+    FIFTEEN_MINUTES = "FIFTEEN_MINUTES",
+    THIRTY_MINUTES = "THIRTY_MINUTES",
+    ONE_HOUR = "ONE_HOUR",
+    FOUR_HOURS = "FOUR_HOURS",
+    ONE_DAY = "ONE_DAY"
+}
+export declare enum StreamingTimeframe {
+    ONE_MINUTE = "ONE_MINUTE",
+    FIVE_MINUTES = "FIVE_MINUTES",
+    FIFTEEN_MINUTES = "FIFTEEN_MINUTES",
+    THIRTY_MINUTES = "THIRTY_MINUTES",
+    ONE_HOUR = "ONE_HOUR",
+    FOUR_HOURS = "FOUR_HOURS",
+    ONE_DAY = "ONE_DAY",
+    ONE_WEEK = "ONE_WEEK",
+    ONE_MONTH = "ONE_MONTH"
+}
+export declare enum StreamingProtocol {
+    UNISWAP_V2 = "UNISWAP_V2",
+    UNISWAP_V3 = "UNISWAP_V3"
+}
+/**
+ * OHLCV Pairs Stream Types
+ */
+export interface OHLCVPairsStreamParams {
+    chain_name: StreamingChain;
+    pair_addresses: string[];
+    interval: StreamingInterval;
+    timeframe: StreamingTimeframe;
+    limit?: number;
+}
+export interface OHLCVPairsStreamResponse {
+    chain_name: StreamingChain;
+    pair_address: string;
+    interval: StreamingInterval;
+    timeframe: StreamingTimeframe;
+    timestamp: string;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+    price_usd: number;
+    volume_usd: number;
+    base_token: ContractMetadata;
+    quote_token: ContractMetadata;
+}
+/**
+ * OHLCV Tokens Stream Types
+ */
+export interface OHLCVTokensStreamParams {
+    chain_name: StreamingChain;
+    token_addresses: string[];
+    interval: StreamingInterval;
+    timeframe: StreamingTimeframe;
+    limit?: number;
+}
+export interface OHLCVTokensStreamResponse {
+    chain_name: StreamingChain;
+    pair_address: string;
+    interval: StreamingInterval;
+    timeframe: StreamingTimeframe;
+    timestamp: string;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+    volume_usd: number;
+    quote_rate: number;
+    quote_rate_usd: number;
+    base_token: ContractMetadata;
+    quote_token: ContractMetadata;
+}
+/**
+ * New DEX Pairs Stream Types
+ */
+export interface NewPairsStreamParams {
+    chain_name: StreamingChain;
+    protocols: StreamingProtocol[];
+}
+export interface PriceMetrics {
+    last_5m: number;
+    last_1hr: number;
+    last_6hr: number;
+    last_24hr: number;
+}
+export interface SwapMetrics {
+    last_5m: number;
+    last_1hr: number;
+    last_6hr: number;
+    last_24hr: number;
+}
+export interface NewPairsStreamResponse {
+    chain_name: string;
+    protocol: string;
+    protocol_version: string;
+    pair_address: string;
+    deployer_address: string;
+    tx_hash: string;
+    block_signed_at: string;
+    liquidity: number;
+    supply: number;
+    market_cap: number;
+    event_name: string;
+    quote_rate: number;
+    quote_rate_usd: number;
+    base_token_metadata: ContractMetadata;
+    quote_token_metadata: ContractMetadata;
+    pair_metadata: ContractMetadata;
+    prices: PriceMetrics;
+    swaps: SwapMetrics;
+}
+/**
+ * Token Balances Stream Types
+ */
+export interface TokenBalancesStreamParams {
+    chain_name: StreamingChain;
+    wallet_address: string;
+}
+export interface TokenBalanceItem {
+    balance: string;
+    balance_pretty: number;
+    quote_rate_usd: number;
+    quote_usd: number;
+    metadata: ContractMetadata;
+    is_native: boolean;
+}
+export interface TokenBalancesStreamResponse {
+    wallet_address: string;
+    chain_name: string;
+    last_block: number;
+    items: TokenBalanceItem[];
+}
+/**
+ * Wallet Activity Stream Types
+ */
+export interface WalletActivityStreamParams {
+    chain_name: StreamingChain;
+    wallet_addresses: string[];
+}
+export interface WalletActivityLogItem {
+    emitter_address: string;
+    log_offset: number;
+    data: string;
+    topics: string[];
+}
+export interface WalletActivityStreamResponse {
+    tx_hash: string;
+    from_address: string;
+    to_address: string;
+    value: number;
+    chain_name: string;
+    block_signed_at: string;
+    block_height: number;
+    block_hash: string;
+    miner_address: string;
+    gas_used: number;
+    tx_offset: number;
+    successful: boolean;
+    decoded_type: string;
+    decoded_details?: object;
+    logs: WalletActivityLogItem[];
+}
+/**
+ * Streaming service configuration
+ */
+export interface StreamingServiceConfig {
+    shouldRetry?: (retries: number) => boolean;
+    maxReconnectAttempts?: number;
+    onConnecting?: () => void;
+    onOpened?: () => void;
+    onClosed?: () => void;
+    onError?: (error: any) => void;
+}
+/**
+ * Stream subscription options
+ */
+export interface StreamSubscriptionOptions<T = Array<object>> {
+    next: (payload: T) => void;
+    error?: (error: any) => void;
+    complete?: () => void;
+}
+/**
+ * Unsubscribe function type
+ */
+export type UnsubscribeFunction = () => void;

package/dist/esm/index.d.ts

@@ -12,4 +12,5 @@ export * from "./src/utils/types/Generic.types";
 export * from "./src/utils/types/NftService.types";
 export * from "./src/utils/types/PricingService.types";
 export * from "./src/utils/types/SecurityService.types";
+export * from "./src/utils/types/StreamingService.types";
 export * from "./src/utils/types/TransactionService.types";