@steerprotocol/sdk 1.18.4 → 1.19.1

package/dist/esm/utils/PoolQueryAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PoolQueryAdapter.js","sourceRoot":"","sources":["../../../src/utils/PoolQueryAdapter.ts"],"names":[],"mappings":"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"}

package/dist/types/base/PoolClient.d.ts

@@ -0,0 +1,257 @@
+import type { PublicClient, WalletClient } from 'viem';
+import { PoolData, SteerResponse } from '../types';
+import { SubgraphClient } from './SubgraphClient';
+import { Protocol } from '../const/chain';
+/**
+ * GraphQL token data interface representing token information from subgraph responses
+ * @interface GraphQLTokenData
+ */
+export interface GraphQLTokenData {
+    /** Token symbol (e.g., "ETH", "USDC") */
+    symbol: string;
+    /** Token contract address */
+    id: string;
+    /** Number of decimal places for the token */
+    decimals: string;
+    /** Human-readable token name */
+    name: string;
+}
+/**
+ * GraphQL pool data interface representing pool information from subgraph responses
+ * @interface GraphQLPoolData
+ */
+export interface GraphQLPoolData {
+    /** Pool contract address */
+    id: string;
+    /** First token in the pool */
+    token0: GraphQLTokenData;
+    /** Second token in the pool */
+    token1: GraphQLTokenData;
+    /** 24-hour trading volume in USD */
+    volumeUSD: string;
+    /** Current tick of the pool */
+    tick: string;
+    /** Total liquidity in the pool */
+    liquidity: string;
+    /** Fee tier for the pool (optional) */
+    feeTier?: string;
+    /** 24-hour volume of token0 (optional) */
+    volumeToken0?: string;
+    /** 24-hour volume of token1 (optional) */
+    volumeToken1?: string;
+    /** Total value locked in ETH (optional) */
+    totalValueLockedETH?: string;
+    /** Alternative field name for volume USD (optional) */
+    volumeUsd?: string;
+    /** Alternative field name for TVL in ETH (optional) */
+    totalValueLockedEth?: string;
+}
+/**
+ * Filter criteria for querying pools
+ * @interface PoolFilter
+ */
+export interface PoolFilter {
+    /** Chain ID to filter pools by */
+    chainId?: number;
+    /** Protocol to filter pools by */
+    protocol?: Protocol;
+    /** Minimum volume in USD to filter pools */
+    minVolumeUSD?: number;
+    /** Token address to find pools containing this token */
+    tokenAddress?: string;
+    /** Maximum number of pools to return */
+    limit?: number;
+}
+/**
+ * Client for fetching pool data from various DEX protocol subgraphs
+ *
+ * @example
+ * ```typescript
+ * import { createPublicClient, createWalletClient, http } from 'viem';
+ * import { mainnet } from 'viem/chains';
+ * import { PoolClient } from '@steerprotocol/sdk';
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http()
+ * }) as PublicClient & WalletClient;
+ *
+ * const poolClient = new PoolClient(client, 'your-subgraph-studio-key');
+ *
+ * // Fetch top pools
+ * const topPools = await poolClient.getTopPools(100, Protocol.UniswapV3, 1);
+ * ```
+ *
+ * @extends SubgraphClient
+ * @group Pool
+ */
+export declare class PoolClient extends SubgraphClient {
+    /** Public client for blockchain interactions */
+    protected readonly publicClient: PublicClient;
+    /** Default timeout for GraphQL queries in milliseconds */
+    private readonly defaultTimeout;
+    /** Counter for tracking API call metrics */
+    private apiCallCount;
+    /** Subgraph Studio API key for rate limiting */
+    private readonly subgraphStudioKey;
+    /**
+     * Creates a new PoolClient instance
+     *
+     * @param client - Combined public and wallet client for blockchain interactions
+     * @param subgraphStudioKey - Optional Subgraph Studio API key for higher rate limits
+     *
+     * @example
+     * ```typescript
+     * const poolClient = new PoolClient(client, 'your-api-key');
+     * ```
+     */
+    constructor(client: PublicClient & WalletClient, subgraphStudioKey?: string);
+    /**
+     * Resets the API call counter for metrics tracking
+     *
+     * @example
+     * ```typescript
+     * poolClient.resetMetrics();
+     * ```
+     */
+    resetMetrics(): void;
+    /**
+     * Gets current metrics for monitoring API usage
+     *
+     * @returns Object containing current metrics
+     *
+     * @example
+     * ```typescript
+     * const metrics = poolClient.getMetrics();
+     * console.log(`API calls made: ${metrics.apiCallCount}`);
+     * ```
+     */
+    getMetrics(): {
+        apiCallCount: number;
+    };
+    /**
+     * Fetches data from GraphQL endpoint with retry logic for rate limits
+     *
+     * @param query - GraphQL query string
+     * @param variables - Variables for the GraphQL query
+     * @param protocol - Protocol to query
+     * @param chainId - Chain ID to query
+     * @returns Promise containing the response data
+     *
+     * @throws {Error} When subgraph endpoint is not available
+     * @throws {Error} When rate limit is exceeded after max retries
+     * @throws {Error} When GraphQL query times out
+     *
+     * @internal
+     */
+    private fetchFromGraph;
+    /**
+     * Fetches the top pools for a specific protocol by trading volume
+     *
+     * @param count - Number of pools to fetch (default: 500)
+     * @param protocol - Protocol to fetch pools from
+     * @param chainId - Chain ID to fetch pools from
+     * @returns Promise containing an array of top pools
+     *
+     * @example
+     * ```typescript
+     * // Get top 100 Uniswap V3 pools on Ethereum
+     * const topPools = await poolClient.getTopPools(100, Protocol.UniswapV3, 1);
+     * if (topPools.success) {
+     *   console.log(`Found ${topPools.data.length} pools`);
+     * }
+     * ```
+     *
+     * @throws {Error} When failed to fetch pools from subgraph
+     */
+    getTopPools(count: number | undefined, protocol: Protocol, chainId: number): Promise<SteerResponse<GraphQLPoolData[]>>;
+    /**
+     * Fetches detailed information for a specific pool by its ID
+     *
+     * @param poolId - Pool contract address to fetch
+     * @param protocol - Protocol the pool belongs to
+     * @param chainId - Chain ID where the pool exists
+     * @returns Promise containing pool details or null if not found
+     *
+     * @example
+     * ```typescript
+     * // Get specific pool details
+     * const poolDetails = await poolClient.getPoolById(
+     *   '0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640',
+     *   Protocol.UniswapV3,
+     *   1
+     * );
+     * if (poolDetails.success && poolDetails.data) {
+     *   console.log(`Pool: ${poolDetails.data.token0.symbol}/${poolDetails.data.token1.symbol}`);
+     * }
+     * ```
+     *
+     * @throws {Error} When failed to fetch pool from subgraph
+     */
+    getPoolById(poolId: string, protocol: Protocol, chainId: number): Promise<SteerResponse<GraphQLPoolData | null>>;
+    /**
+     * Fetches pools containing multiple tokens in batches for better performance
+     *
+     * @param tokenAddresses - Array of token contract addresses
+     * @param protocol - Protocol to fetch pools from
+     * @param chainId - Chain ID to fetch pools from
+     * @param batchSize - Number of tokens to process in each batch (default: 10)
+     * @returns Promise containing all pools found for the tokens
+     *
+     * @example
+     * ```typescript
+     * // Get pools for multiple tokens
+     * const tokenAddresses = [
+     *   '0xa0b86a33e6f8b07b71c3a39ef77a6b6e8f1b7b7e', // USDC
+     *   '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'  // WETH
+     * ];
+     * const pools = await poolClient.fetchPoolsForTokensBatch(
+     *   tokenAddresses,
+     *   Protocol.UniswapV3,
+     *   1,
+     *   5
+     * );
+     * ```
+     *
+     * @throws {Error} When batch processing fails
+     */
+    fetchPoolsForTokensBatch(tokenAddresses: string[], protocol: Protocol, chainId: number, batchSize?: number): Promise<SteerResponse<GraphQLPoolData[]>>;
+    /**
+     * Fetches all pools containing a specific token
+     *
+     * @param tokenAddress - Token contract address
+     * @param protocol - Protocol to fetch pools from
+     * @param chainId - Chain ID to fetch pools from
+     * @returns Promise containing pools that include the specified token
+     *
+     * @example
+     * ```typescript
+     * // Get all USDC pools on Uniswap V3
+     * const usdcPools = await poolClient.fetchPoolsForToken(
+     *   '0xa0b86a33e6f8b07b71c3a39ef77a6b6e8f1b7b7e',
+     *   Protocol.UniswapV3,
+     *   1
+     * );
+     * if (usdcPools.success) {
+     *   console.log(`Found ${usdcPools.data.length} USDC pools`);
+     * }
+     * ```
+     *
+     * @throws {Error} When failed to fetch pools for token
+     */
+    fetchPoolsForToken(tokenAddress: string, protocol: Protocol, chainId: number): Promise<SteerResponse<GraphQLPoolData[]>>;
+    /**
+     * Filters pools based on validity criteria such as tick range and liquidity
+     *
+     * @param pools - Array of pools to filter
+     * @returns Array of valid pools that meet the criteria
+     *
+     * @example
+     * ```typescript
+     * const validPools = poolClient.filterValidPools(allPools);
+     * console.log(`Filtered down to ${validPools.length} valid pools`);
+     * ```
+     */
+    filterValidPools(pools: PoolData[]): PoolData[];
+}
+//# sourceMappingURL=PoolClient.d.ts.map

package/dist/types/base/PoolClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PoolClient.d.ts","sourceRoot":"","sources":["../../../src/base/PoolClient.ts"],"names":[],"mappings":"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"}

package/dist/types/client.d.ts

@@ -2,16 +2,17 @@ import { SteerConfig, SteerResponse } from './types';
 import { SubgraphClient } from './base/SubgraphClient';
 import { VaultClient } from './base/VaultClient';
 import { SmartRewardsClient } from './base/SmartRewardClient';
+import { PoolClient } from './base/PoolClient';
 import { StakingClient } from './base/StakingClient';
 /**
  * The main client for interacting with the Steer Protocol.
- * This client provides access to vault operations and smart rewards functionality.
+ * This client provides access to vault operations, smart rewards functionality, pool data, and staking.
  *
  * @example
  * ```typescript
  * import { createPublicClient, createWalletClient, http } from 'viem';
  * import { mainnet } from 'viem/chains';
- * import { SteerClient } from '@steerprotocol/sdk';
+ * import { SteerClient, Protocol } from '@steerprotocol/sdk';
  *
  * // Create viem clients
  * const publicClient = createPublicClient({
@@ -28,7 +29,8 @@ import { StakingClient } from './base/StakingClient';
  * const steerClient = new SteerClient({
  *   environment: 'production',
  *   client: publicClient,
- *   walletClient: walletClient
+ *   walletClient: walletClient,
+ *   subgraphStudioKey: 'your-subgraph-studio-key' // Optional
  * });
  *
  * // Use vault operations
@@ -37,6 +39,13 @@ import { StakingClient } from './base/StakingClient';
  * // Use rewards functionality
  * const campaigns = await steerClient.rewards.getCampaigns(1);
  * const summary = await steerClient.rewards.getRewardSummary(userAddress, chainId);
+ *
+ * // Use pool data functionality
+ * const topPools = await steerClient.pools.getTopPools(100, Protocol.UniswapV3, 1);
+ * const poolDetails = await steerClient.pools.getPoolById(poolId, Protocol.UniswapV3, 1);
+ *
+ * // Use staking functionality
+ * const stakingPools = await steerClient.staking.getStakingPools(1);
  * ```
  *
  * @group Client
@@ -50,9 +59,26 @@ export declare class SteerClient extends SubgraphClient {
     readonly rewards: SmartRewardsClient;
     /** The staking client instance for interacting with staking pools */
     readonly staking: StakingClient;
+    /** The pool client instance for fetching pool data from DEX protocols */
+    readonly pools: PoolClient;
     /**
      * Creates a new instance of the SteerClient
+     *
      * @param config - The configuration object for the client
+     * @param config.environment - The environment to use ('production' or 'development')
+     * @param config.client - The viem client for blockchain interactions
+     * @param config.walletClient - Optional wallet client for write operations
+     * @param config.subgraphStudioKey - Optional Subgraph Studio API key for higher rate limits
+     *
+     * @example
+     * ```typescript
+     * const steerClient = new SteerClient({
+     *   environment: 'production',
+     *   client: publicClient,
+     *   walletClient: walletClient,
+     *   subgraphStudioKey: 'your-key'
+     * });
+     * ```
      */
     constructor(config: SteerConfig);
     /**

package/dist/types/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,WAAY,SAAQ,cAAc;IAE7C,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAE3D,kEAAkE;IAClE,SAAgB,MAAM,EAAE,WAAW,CAAC;IAEpC,qEAAqE;IACrE,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAE5C,qEAAqE;IACrE,SAAgB,OAAO,EAAE,aAAa,CAAC;IAEvC;;;OAGG;gBACS,MAAM,EAAE,WAAW;IAqC/B;;;;;;;;;;OAUG;IACU,cAAc,CAAC,CAAC,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;CAa5D"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,qBAAa,WAAY,SAAQ,cAAc;IAE7C,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAE3D,kEAAkE;IAClE,SAAgB,MAAM,EAAE,WAAW,CAAC;IAEpC,qEAAqE;IACrE,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAE5C,qEAAqE;IACrE,SAAgB,OAAO,EAAE,aAAa,CAAC;IAEvC,yEAAyE;IACzE,SAAgB,KAAK,EAAE,UAAU,CAAC;IAElC;;;;;;;;;;;;;;;;;;OAkBG;gBACS,MAAM,EAAE,WAAW;IA6C/B;;;;;;;;;;OAUG;IACU,cAAc,CAAC,CAAC,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;CAa5D"}

package/dist/types/index.d.ts

@@ -4,6 +4,7 @@ export * from './types';
 export * from './base/VaultClient';
 export * from './base/SubgraphClient';
 export * from './base/StakingClient';
+export * from './base/PoolClient';
 export * from './const';
 /**
  * @packageDocumentation

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG"}

package/dist/types/types.d.ts

@@ -1,9 +1,18 @@
 import type { Address, Client, TestClient, WalletClient } from 'viem';
 import { Chain, Protocol } from './const/chain';
+/**
+ * Configuration object for initializing the SteerClient
+ * @interface SteerConfig
+ */
 export interface SteerConfig {
+    /** The environment to use for API calls */
     environment?: 'production' | 'development';
+    /** The viem client for blockchain interactions */
     client: Client | TestClient;
+    /** Optional wallet client for write operations */
     walletClient?: WalletClient;
+    /** Optional Subgraph Studio API key for higher rate limits */
+    subgraphStudioKey?: string;
 }
 export interface SteerResponse<T> {
     data: T | null;
@@ -51,6 +60,13 @@ export interface PoolData {
     chainId: number;
     feeTier: number;
     tickSpacing: number | bigint;
+    tick?: string;
+    liquidity?: string;
+    volumeUSD?: string;
+    volumeToken0?: string;
+    volumeToken1?: string;
+    totalValueLockedETH?: string;
+    totalValueLockedUSD?: string;
 }
 export interface Slot0 {
     price?: bigint;

package/dist/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types/utils/PoolQueryAdapter.d.ts

@@ -0,0 +1,114 @@
+/**
+ * @fileoverview Pool Query Adapter - Provides GraphQL queries for different DEX protocols
+ * @module PoolQueryAdapter
+ */
+import { Protocol } from '../const';
+/**
+ * Returns the appropriate GraphQL query for fetching top pools based on protocol type
+ *
+ * @param protocol - The DEX protocol to fetch pools from
+ * @param isAlgebraPool - Whether the protocol is based on Algebra
+ * @returns GraphQL query string for fetching top pools
+ *
+ * @example
+ * ```typescript
+ * const query = getTopPoolsQuery(Protocol.UniswapV3, false);
+ * // Returns FETCH_TOP_POOLS_UNISWAP query
+ * ```
+ */
+export declare const getTopPoolsQuery: (protocol: Protocol, isAlgebraPool: boolean) => string;
+/**
+ * GraphQL query to fetch pools containing a specific token from Algebra-based protocols
+ * Returns up to 50 pools ordered by volume that contain the specified token
+ * @internal
+ */
+export declare const FETCH_TOKEN_POOLS_ALGEBRA = "\nquery pools($token: String!) {\n\tpools(first: 50, orderBy: volumeUSD, orderDirection: desc, where: {\n    or: [\n      {\n\t\t\t\ttoken0: $token\n      }\n      {\n        token1: $token\n      }\n    ]\n  }, subgraphError: allow){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    tick\n    liquidity\n\t}\n}\n";
+/**
+ * GraphQL query to fetch pools containing a specific token from Ocelex protocol
+ * Returns up to 50 pools that contain the specified token
+ * @internal
+ */
+export declare const FETCH_TOKEN_POOLS_OCELEX = "\nquery pools($token: ID!) {\n\tpools(first: 50, where: {\n    or: [\n      {\n\t\t\t\ttoken0: $token\n      }\n      {\n        token1: $token\n      }\n    ]\n  }){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n    }\n    token1 {\n      id\n      name\n      symbol\n    }\n    tick\n    liquidity\n\t}\n}\n";
+/**
+ * GraphQL query to fetch pools containing a specific token from ArthSwap protocol
+ * Returns up to 50 pools ordered by volume that contain the specified token
+ * @internal
+ */
+export declare const FETCH_TOKEN_POOLS_ARTHSWAP = "\nquery pools($token: String!) {\n\tpools(limit: 50, orderBy: volumeUSD_DESC, where: {\n    OR: [\n      {\n\t\t\t\ttoken0Id_eq: $token\n      }\n      {\n        token1Id_eq: $token\n      }\n    ]\n  }){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    feeTier\n    tick\n    liquidity\n\t}\n}\n";
+/**
+ * GraphQL query to fetch pools containing a specific token from Uniswap V3 protocol
+ * Returns up to 50 pools ordered by volume that contain the specified token
+ * @internal
+ */
+export declare const FETCH_TOKEN_POOLS_UNISWAP = "\nquery pools($token: String!) {\n\tpools(first: 50, orderBy: volumeUSD, orderDirection: desc, where: {\n    or: [\n      {\n\t\t\t\ttoken0: $token\n      }\n      {\n        token1: $token\n      }\n    ]\n  }, subgraphError: allow){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    feeTier\n    volumeToken0\n    volumeToken1\n    tick\n    liquidity\n\t}\n}\n";
+/**
+ * GraphQL query to fetch pools containing a specific token from Shadow protocol
+ * Returns up to 50 CL pools ordered by volume that contain the specified token
+ * @internal
+ */
+export declare const FETCH_TOKEN_POOLS_SHADOW = "\nquery pools($token: String!) {\n\tclPools(first: 50, orderBy: volumeUSD, orderDirection: desc, where: {\n    or: [\n      {\n\t\t\t\ttoken0: $token\n      }\n      {\n        token1: $token\n      }\n    ]\n  }, subgraphError: allow){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    feeTier\n    volumeToken0\n    volumeToken1\n    tick\n    liquidity\n\t}\n}\n";
+/**
+ * GraphQL query to fetch pools containing a specific token from PoolShark protocol
+ * Returns up to 50 limit pools ordered by TVL that contain the specified token
+ * @internal
+ */
+export declare const FETCH_TOKEN_POOLS_POOLSHARK = "\nquery pools($token: String!) {\n\tlimitPools(first: 50, orderBy: totalValueLockedEth, orderDirection: desc, where: {\n    or: [\n      {\n\t\t\t\ttoken0: $token\n      }\n      {\n        token1: $token\n      }\n    ]\n  }, subgraphError: allow){\n\t\tid\n    volumeUsd\n    totalValueLockedEth\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    feeTier {\n      id\n    }\n    volumeToken0\n    volumeToken1\n    tick\n    liquidity\n\t}\n}\n";
+/**
+ * GraphQL query to fetch pools where specified token is token0 from Lynex protocol
+ * Returns up to 50 pools ordered by volume where token is the first token
+ * @internal
+ */
+export declare const FETCH_TOKEN_POOLS_LYNEX_TOKEN0 = "\nquery pools($token: String!) {\n\tpools(first: 50, orderBy: volumeUSD, orderDirection: desc, where: {\n    token0: $token\n  }, subgraphError: allow){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    tick\n    liquidity\n\t}\n}\n";
+/**
+ * GraphQL query to fetch pools where specified token is token1 from Lynex protocol
+ * Returns up to 50 pools ordered by volume where token is the second token
+ * @internal
+ */
+export declare const FETCH_TOKEN_POOLS_LYNEX_TOKEN1 = "\nquery pools($token: String!) {\n\tpools(first: 50, orderBy: volumeUSD, orderDirection: desc, where: {\n    token1: $token\n  }, subgraphError: allow){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    tick\n    liquidity\n\t}\n}\n";
+/**
+ * GraphQL query to fetch pools where specified token is token0 from Thruster protocol
+ * Returns up to 50 pools ordered by TVL where token is the first token
+ * @internal
+ */
+export declare const FETCH_TOKEN_POOLS_THRUSTER_TOKEN0 = "\nquery pools($token: String!) {\n\tpools(first: 50, orderBy: totalValueLockedETH, orderDirection: desc, where: {\n\t\ttoken0: $token\n  }, subgraphError: allow){\n\t\tid\n    volumeUSD\n    totalValueLockedETH\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    feeTier\n    volumeToken0\n    volumeToken1\n    tick\n    liquidity\n\t}\n}\n";
+/**
+ * GraphQL query to fetch pools where specified token is token1 from Thruster protocol
+ * Returns up to 50 pools ordered by TVL where token is the second token
+ * @internal
+ */
+export declare const FETCH_TOKEN_POOLS_THRUSTER_TOKEN1 = "\nquery pools($token: String!) {\n\tpools(first: 50, orderBy: totalValueLockedETH, orderDirection: desc, where: {\n\t\ttoken1: $token\n  }, subgraphError: allow){\n\t\tid\n    volumeUSD\n    totalValueLockedETH\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    feeTier\n    volumeToken0\n    volumeToken1\n    tick\n    liquidity\n\t}\n}\n";
+/**
+ * GraphQL query to fetch pools containing a specific token from Kyo protocol
+ * Returns up to 50 pools ordered by volume that contain the specified token
+ * @internal
+ */
+export declare const FETCH_TOKEN_POOLS_KYO = "\nquery pools($token: String!) {\n\tpools(first: 50, orderBy: volumeUSD, orderDirection: desc, where: {\n    or: [\n      {\n\t\t\t\ttoken0: $token\n      }\n      {\n        token1: $token\n      }\n    ]\n  }, subgraphError: allow){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    fee\n    volumeToken0\n    volumeToken1\n    tick\n    liquidity\n\t}\n}\n";
+/**
+ * Returns the appropriate GraphQL query for fetching pools containing a specific token
+ *
+ * @param isAlgebraPool - Whether the protocol is based on Algebra
+ * @param protocol - The DEX protocol to fetch pools from
+ * @returns GraphQL query string for fetching token pools
+ *
+ * @example
+ * ```typescript
+ * const query = getTokenPoolsQueryByAddress(false, Protocol.UniswapV3);
+ * // Returns FETCH_TOKEN_POOLS_UNISWAP query
+ * ```
+ */
+export declare const getTokenPoolsQueryByAddress: (isAlgebraPool: boolean, protocol: Protocol) => "\nquery pools($token: String!) {\n\tpools(first: 50, orderBy: volumeUSD, orderDirection: desc, where: {\n    or: [\n      {\n\t\t\t\ttoken0: $token\n      }\n      {\n        token1: $token\n      }\n    ]\n  }, subgraphError: allow){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    tick\n    liquidity\n\t}\n}\n" | "\nquery pools($token: ID!) {\n\tpools(first: 50, where: {\n    or: [\n      {\n\t\t\t\ttoken0: $token\n      }\n      {\n        token1: $token\n      }\n    ]\n  }){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n    }\n    token1 {\n      id\n      name\n      symbol\n    }\n    tick\n    liquidity\n\t}\n}\n" | "\nquery pools($token: String!) {\n\tpools(limit: 50, orderBy: volumeUSD_DESC, where: {\n    OR: [\n      {\n\t\t\t\ttoken0Id_eq: $token\n      }\n      {\n        token1Id_eq: $token\n      }\n    ]\n  }){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    feeTier\n    tick\n    liquidity\n\t}\n}\n" | "\nquery pools($token: String!) {\n\tpools(first: 50, orderBy: volumeUSD, orderDirection: desc, where: {\n    or: [\n      {\n\t\t\t\ttoken0: $token\n      }\n      {\n        token1: $token\n      }\n    ]\n  }, subgraphError: allow){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    feeTier\n    volumeToken0\n    volumeToken1\n    tick\n    liquidity\n\t}\n}\n" | "\nquery pools($token: String!) {\n\tclPools(first: 50, orderBy: volumeUSD, orderDirection: desc, where: {\n    or: [\n      {\n\t\t\t\ttoken0: $token\n      }\n      {\n        token1: $token\n      }\n    ]\n  }, subgraphError: allow){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    feeTier\n    volumeToken0\n    volumeToken1\n    tick\n    liquidity\n\t}\n}\n" | "\nquery pools($token: String!) {\n\tlimitPools(first: 50, orderBy: totalValueLockedEth, orderDirection: desc, where: {\n    or: [\n      {\n\t\t\t\ttoken0: $token\n      }\n      {\n        token1: $token\n      }\n    ]\n  }, subgraphError: allow){\n\t\tid\n    volumeUsd\n    totalValueLockedEth\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    feeTier {\n      id\n    }\n    volumeToken0\n    volumeToken1\n    tick\n    liquidity\n\t}\n}\n" | "\nquery pools($token: String!) {\n\tpools(first: 50, orderBy: volumeUSD, orderDirection: desc, where: {\n    or: [\n      {\n\t\t\t\ttoken0: $token\n      }\n      {\n        token1: $token\n      }\n    ]\n  }, subgraphError: allow){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    fee\n    volumeToken0\n    volumeToken1\n    tick\n    liquidity\n\t}\n}\n";
+/**
+ * Returns the appropriate GraphQL query for fetching detailed pool information
+ *
+ * @param isAlgebraPool - Whether the protocol is based on Algebra
+ * @param protocol - The DEX protocol to fetch pool details from (optional)
+ * @returns GraphQL query string for fetching pool details
+ *
+ * @example
+ * ```typescript
+ * const query = getPoolDetailsQuery(false, Protocol.UniswapV3);
+ * // Returns FETCH_POOL_DETAILS_UNISWAP query
+ * ```
+ */
+export declare const getPoolDetailsQuery: (isAlgebraPool: boolean, protocol?: Protocol) => "\nquery pools($pool: String! ) {\n\tpool(id: $pool, subgraphError: allow){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n    }\n    token1 {\n      id\n      name\n      symbol\n    }\n    tick\n    liquidity\n\t}\n}\n" | "\nquery pools($pool: ID!) {\n\tpool(id: $pool){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n    }\n    token1 {\n      id\n      name\n      symbol\n    }\n    tick\n    liquidity\n\t}\n}\n" | "\nquery pools($pool: String! ) {\n\tpool(id: $pool, subgraphError: allow){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n    }\n    token1 {\n      id\n      name\n      symbol\n    }\n    feeTier\n    totalValueLockedETH\n    volumeToken0\n    volumeToken1\n    tick\n    liquidity\n\t}\n}\n" | "\nquery pools($pool: String! ) {\n\tclPool(id: $pool, subgraphError: allow){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n    }\n    token1 {\n      id\n      name\n      symbol\n    }\n    feeTier\n    volumeToken0\n    volumeToken1\n    tick\n    liquidity\n\t}\n}\n" | "\nquery pools($pool: String! ) {\n\tlimitPools(where: {id: $pool}){\n\t\tid\n    volumeUsd\n    token0 {\n      id\n      name\n      symbol\n    }\n    token1 {\n      id\n      name\n      symbol\n    }\n    feeTier {\n      id\n    }\n    tick\n    liquidity\n\t}\n}\n" | "\nquery pools($pool: String! ) {\n\tpools(where: {id_eq: $pool}){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n    }\n    token1 {\n      id\n      name\n      symbol\n    }\n    feeTier\n    tick\n    liquidity\n\t}\n}\n" | "\nquery pools($pool: String! ) {\n\tpool(id: $pool, subgraphError: allow){\n\t\tid\n    volumeUSD\n    token0 {\n      id\n      name\n      symbol\n      decimals\n    }\n    token1 {\n      id\n      name\n      symbol\n      decimals\n    }\n    fee\n    volumeToken0\n    volumeToken1\n    tick\n    liquidity\n\t}\n}\n";
+//# sourceMappingURL=PoolQueryAdapter.d.ts.map

package/dist/types/utils/PoolQueryAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PoolQueryAdapter.d.ts","sourceRoot":"","sources":["../../../src/utils/PoolQueryAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAoB,QAAQ,EAAE,MAAM,UAAU,CAAC;AAkPtD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,aAAc,QAAQ,iBAAiB,OAAO,KAAG,MAkB7E,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,2bA8BrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,uVA4BpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,2aA+BtC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,4eAiCrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,8eAiCpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,uiBAoCvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,yWAuB1C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,yWAuB1C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,6bA2B7C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,6bA2B7C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,weAiCjC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,kBAAmB,OAAO,YAAY,QAAQ,wqGAiBrF,CAAC;AAwMF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,kBAAmB,OAAO,aAAa,QAAQ,26DAgB5E,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerprotocol/sdk",
-  "version": "1.18.4",
+  "version": "1.19.1",
   "description": "Steer Protocol SDK",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -25,7 +25,7 @@
     "lint": "eslint . --ext .ts",
     "format": "prettier --write \"src/**/*.ts\"",
     "prepare": "npm run build",
-    "docs": "typedoc --out docs --entryPoints src/index.ts src/client.ts src/base/SmartRewards.ts src/base/SubgraphClient.ts src/base/VaultClient.ts --name \"Steer Protocol SDK\" --readme README.md --excludePrivate --excludeProtected",
+    "docs": "typedoc --out docs --entryPoints src/index.ts src/client.ts src/base/SmartRewards.ts src/base/SubgraphClient.ts src/base/VaultClient.ts src/base/PoolClient.ts --name \"Steer Protocol SDK\" --readme README.md --excludePrivate --excludeProtected",
     "docs:watch": "typedoc --out docs --entryPoints src/index.ts src/base/SmartRewards.ts src/generated/sdk.ts --name \"Steer Protocol SDK\" --readme README.md --excludePrivate --excludeProtected --plugin none --watch",
     "docs:serve": "npx serve docs",
     "commit": "git-cz",