@steerprotocol/sdk 1.30.8-test-algebra-plugins.2 → 1.31.0

package/dist/cjs/base/PoolClient.js

@@ -76,6 +76,64 @@ class PoolClient extends SubgraphClient_js_1.SubgraphClient {
             apiCallCount: this.apiCallCount,
         };
     }
+    normalizeAddress(value) {
+        return value?.toLowerCase() || '';
+    }
+    normalizeSymbol(value) {
+        return value?.trim().toLowerCase() || '';
+    }
+    dedupePools(pools) {
+        const seen = new Set();
+        const deduped = [];
+        pools.forEach((pool) => {
+            const key = this.normalizeAddress(pool.id);
+            if (!key || seen.has(key)) {
+                return;
+            }
+            seen.add(key);
+            deduped.push(pool);
+        });
+        return deduped;
+    }
+    filterPoolsBySymbols(pools, symbols) {
+        if (symbols.length === 0) {
+            return pools;
+        }
+        const normalizedSymbols = new Set(symbols.map((symbol) => this.normalizeSymbol(symbol)).filter(Boolean));
+        return pools.filter((pool) => {
+            const token0Symbol = this.normalizeSymbol(pool.token0?.symbol);
+            const token1Symbol = this.normalizeSymbol(pool.token1?.symbol);
+            return normalizedSymbols.has(token0Symbol) || normalizedSymbols.has(token1Symbol);
+        });
+    }
+    applyPoolSearchResultFilters(pools, filter) {
+        let filteredPools = this.dedupePools(pools);
+        if (typeof filter.minVolumeUSD === 'number') {
+            filteredPools = filteredPools.filter((pool) => {
+                const volumeUSD = parseFloat(pool.volumeUSD || pool.volumeUsd || '0');
+                return !Number.isNaN(volumeUSD) && volumeUSD >= filter.minVolumeUSD;
+            });
+        }
+        if (typeof filter.limit === 'number' && filter.limit >= 0) {
+            filteredPools = filteredPools.slice(0, filter.limit);
+        }
+        return filteredPools;
+    }
+    async searchPoolsBySymbols(filter, symbols) {
+        // Symbol relation filtering is not portable across all supported AMM subgraphs.
+        // Use bounded top-pools fetch plus local symbol filtering as the baseline path.
+        const boundedLimit = Math.min(Math.max(filter.limit ?? 200, 1), 500);
+        const topPools = await this.getTopPools(boundedLimit, filter.protocol, filter.chainId);
+        if (!topPools.success || !topPools.data) {
+            return topPools;
+        }
+        const symbolMatches = this.filterPoolsBySymbols(topPools.data, symbols);
+        return {
+            data: this.applyPoolSearchResultFilters(symbolMatches, filter),
+            status: 200,
+            success: true,
+        };
+    }
     /**
      * Fetches data from GraphQL endpoint with retry logic for rate limits
      *
@@ -450,6 +508,85 @@ class PoolClient extends SubgraphClient_js_1.SubgraphClient {
             return true;
         });
     }
+    /**
+     * Searches pools using exact-address lookups where supported and local symbol
+     * filtering as a portable fallback.
+     *
+     * Symbol-based matching is best-effort because not every downstream AMM
+     * subgraph exposes portable nested token-symbol filters.
+     */
+    async searchPools(filter) {
+        const { chainId, protocol } = filter;
+        if (!chainId || !protocol) {
+            return {
+                data: null,
+                status: 400,
+                success: false,
+                error: 'searchPools requires both chainId and protocol',
+            };
+        }
+        const normalizedPoolAddress = this.normalizeAddress(filter.poolAddress);
+        const normalizedTokenAddress = this.normalizeAddress(filter.tokenAddress);
+        const normalizedTokenAddresses = (filter.tokenAddresses || [])
+            .map((address) => this.normalizeAddress(address))
+            .filter(Boolean);
+        const tokenSymbols = [
+            ...(filter.tokenSymbol ? [filter.tokenSymbol] : []),
+            ...(filter.tokenSymbols || []),
+        ].filter(Boolean);
+        if (!normalizedPoolAddress &&
+            !normalizedTokenAddress &&
+            normalizedTokenAddresses.length === 0 &&
+            tokenSymbols.length === 0) {
+            return {
+                data: null,
+                status: 400,
+                success: false,
+                error: 'searchPools requires at least one of poolAddress, tokenAddress, tokenAddresses, tokenSymbol, or tokenSymbols',
+            };
+        }
+        const collectedPools = [];
+        if (normalizedPoolAddress) {
+            const exactPool = await this.getPoolById(normalizedPoolAddress, protocol, chainId);
+            if (!exactPool.success) {
+                return {
+                    data: null,
+                    status: exactPool.status,
+                    success: false,
+                    error: exactPool.error,
+                };
+            }
+            if (exactPool.data) {
+                collectedPools.push(exactPool.data);
+            }
+        }
+        if (normalizedTokenAddress) {
+            const tokenPools = await this.fetchPoolsForToken(normalizedTokenAddress, protocol, chainId);
+            if (!tokenPools.success) {
+                return tokenPools;
+            }
+            collectedPools.push(...(tokenPools.data || []));
+        }
+        if (normalizedTokenAddresses.length > 0) {
+            const batchPools = await this.fetchPoolsForTokensBatch(normalizedTokenAddresses, protocol, chainId);
+            if (!batchPools.success) {
+                return batchPools;
+            }
+            collectedPools.push(...(batchPools.data || []));
+        }
+        if (tokenSymbols.length > 0) {
+            const symbolPools = await this.searchPoolsBySymbols({ ...filter, chainId, protocol }, tokenSymbols);
+            if (!symbolPools.success) {
+                return symbolPools;
+            }
+            collectedPools.push(...(symbolPools.data || []));
+        }
+        return {
+            data: this.applyPoolSearchResultFilters(collectedPools, filter),
+            status: 200,
+            success: true,
+        };
+    }
 }
 exports.PoolClient = PoolClient;
 //# sourceMappingURL=PoolClient.js.map

package/dist/cjs/base/PoolClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"PoolClient.js","sourceRoot":"","sources":["../../../src/base/PoolClient.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PublicClient, WalletClient } from 'viem';\nimport { PoolData, SteerResponse } from '../types.js';\nimport { SubgraphClient } from './SubgraphClient.js';\nimport { \n  Protocol, \n  Chain\n} from '../const/chain.js';\nimport { \n  chainIdToName, \n  getProtocolSubgraphURL\n} from '../const/index.js';\nimport { isAlgebraProtocol } from '../const/protocol.js';\nimport { getTopPoolsQuery, getTokenPoolsQueryByAddress, getPoolDetailsQuery } from '../utils/PoolQueryAdapter.js';\n\n/**\n * GraphQL token data interface representing token information from subgraph responses\n * @interface GraphQLTokenData\n */\nexport interface GraphQLTokenData {\n  /** Token symbol (e.g., \"ETH\", \"USDC\") */\n  symbol: string;\n  /** Token contract address */\n  id: string;\n  /** Number of decimal places for the token */\n  decimals: string;\n  /** Human-readable token name */\n  name: string;\n}\n\n/**\n * GraphQL pool data interface representing pool information from subgraph responses\n * @interface GraphQLPoolData\n */\nexport interface GraphQLPoolData {\n  /** Pool contract address */\n  id: string;\n  /** First token in the pool */\n  token0: GraphQLTokenData;\n  /** Second token in the pool */\n  token1: GraphQLTokenData;\n  /** 24-hour trading volume in USD */\n  volumeUSD: string;\n  /** Current tick of the pool */\n  tick: string;\n  /** Total liquidity in the pool */\n  liquidity: string;\n  /** Fee tier for the pool (optional) */\n  feeTier?: string;\n  /** 24-hour volume of token0 (optional) */\n  volumeToken0?: string;\n  /** 24-hour volume of token1 (optional) */\n  volumeToken1?: string;\n  /** Total value locked in ETH (optional) */\n  totalValueLockedETH?: string;\n  /** Alternative field name for volume USD (optional) */\n  volumeUsd?: string;\n  /** Alternative field name for TVL in ETH (optional) */\n  totalValueLockedEth?: string;\n}\n\n/**\n * Filter criteria for querying pools\n * @interface PoolFilter\n */\nexport interface PoolFilter {\n  /** Chain ID to filter pools by */\n  chainId?: number;\n  /** Protocol to filter pools by */\n  protocol?: Protocol;\n  /** Minimum volume in USD to filter pools */\n  minVolumeUSD?: number;\n  /** Token address to find pools containing this token */\n  tokenAddress?: string;\n  /** Maximum number of pools to return */\n  limit?: number;\n}\n\n// GraphQL response interfaces (currently unused but kept for future use)\n// interface GraphQLResponse<T> {\n//   data: T;\n//   errors?: Array<{ message: string }>;\n// }\n\n/**\n * Response interface for top pools query\n * @interface TopPoolsResponse\n * @internal\n */\ninterface TopPoolsResponse {\n  /** Standard pools array */\n  pools: GraphQLPoolData[];\n  /** Limit pools array (used by some protocols) */\n  limitPools?: GraphQLPoolData[];\n  /** CL pools array (used by some protocols) */\n  clPools?: GraphQLPoolData[];\n}\n\n/**\n * Response interface for pool details query\n * @interface PoolDetailsResponse\n * @internal\n */\ninterface PoolDetailsResponse {\n  /** Single pool data */\n  pool: GraphQLPoolData;\n  /** Single limit pool data (used by some protocols) */\n  limitPool?: GraphQLPoolData;\n  /** Single CL pool data (used by some protocols) */\n  clPool?: GraphQLPoolData;\n}\n\n/**\n * Response interface for pools by token query\n * @interface PoolsByTokenResponse\n * @internal\n */\ninterface PoolsByTokenResponse {\n  /** Standard pools array */\n  pools?: GraphQLPoolData[];\n  /** Limit pools array (used by some protocols) */\n  limitPools?: GraphQLPoolData[];\n  /** Token pools array (used by some protocols) */\n  tokenPools?: GraphQLPoolData[];\n  /** CL pools array (used by some protocols) */\n  clPools?: GraphQLPoolData[];\n}\n\n/**\n * Client for fetching pool data from various DEX protocol subgraphs\n * \n * @example\n * ```typescript\n * import { createPublicClient, createWalletClient, http } from 'viem';\n * import { mainnet } from 'viem/chains';\n * import { PoolClient } from '@steerprotocol/sdk';\n * \n * const client = createPublicClient({\n *   chain: mainnet,\n *   transport: http()\n * }) as PublicClient & WalletClient;\n * \n * const poolClient = new PoolClient(client, 'your-subgraph-studio-key');\n * \n * // Fetch top pools\n * const topPools = await poolClient.getTopPools(100, Protocol.UniswapV3, 1);\n * ```\n * \n * @extends SubgraphClient\n * @group Pool\n */\nexport class PoolClient extends SubgraphClient {\n  /** Public client for blockchain interactions */\n  protected readonly publicClient: PublicClient;\n  /** Default timeout for GraphQL queries in milliseconds */\n  private readonly defaultTimeout: number = 60000;\n  /** Counter for tracking API call metrics */\n  private apiCallCount: number = 0;\n  /** Subgraph Studio API key for rate limiting */\n  private readonly subgraphStudioKey: string;\n\n  /**\n   * Creates a new PoolClient instance\n   * \n   * @param client - Combined public and wallet client for blockchain interactions\n   * @param subgraphStudioKey - Optional Subgraph Studio API key for higher rate limits\n   * \n   * @example\n   * ```typescript\n   * const poolClient = new PoolClient(client, 'your-api-key');\n   * ```\n   */\n  constructor(\n    client: PublicClient & WalletClient,\n    subgraphStudioKey: string = ''\n  ) {\n    super(client);\n    this.publicClient = client;\n    this.subgraphStudioKey = subgraphStudioKey;\n  }\n\n  /**\n   * Resets the API call counter for metrics tracking\n   * \n   * @example\n   * ```typescript\n   * poolClient.resetMetrics();\n   * ```\n   */\n  public resetMetrics(): void {\n    this.apiCallCount = 0;\n  }\n\n  /**\n   * Gets current metrics for monitoring API usage\n   * \n   * @returns Object containing current metrics\n   * \n   * @example\n   * ```typescript\n   * const metrics = poolClient.getMetrics();\n   * console.log(`API calls made: ${metrics.apiCallCount}`);\n   * ```\n   */\n  public getMetrics(): { apiCallCount: number } {\n    return {\n      apiCallCount: this.apiCallCount,\n    };\n  }\n\n  /**\n   * Fetches data from GraphQL endpoint with retry logic for rate limits\n   * \n   * @param query - GraphQL query string\n   * @param variables - Variables for the GraphQL query\n   * @param protocol - Protocol to query\n   * @param chainId - Chain ID to query\n   * @returns Promise containing the response data\n   * \n   * @throws {Error} When subgraph endpoint is not available\n   * @throws {Error} When rate limit is exceeded after max retries\n   * @throws {Error} When GraphQL query times out\n   * \n   * @internal\n   */\n  private async fetchFromGraph<T>(\n    query: string,\n    variables: Record<string, unknown>,\n    protocol: Protocol,\n    chainId: number\n  ): Promise<SteerResponse<T>> {\n    try {\n      const chainName = chainIdToName(chainId);\n      const endpoint = getProtocolSubgraphURL(protocol, chainName as Chain, this.subgraphStudioKey);\n\n      if (!endpoint) {\n        throw new Error(`No subgraph endpoint available for protocol ${protocol} on chain ${chainName}`);\n      }\n\n      const MAX_RETRIES = 3;\n      const RETRY_DELAY_MS = 11000;\n\n      const fetchWithRetry = async (retries = 0): Promise<T> => {\n        const response = await fetch(endpoint, {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n          body: JSON.stringify({ query, variables }),\n        });\n\n        const data = await response.json() as { data: T; error?: string; errors?: Array<{ message: string }> };\n\n        if (data.error && typeof data.error === \"string\" && data.error.includes(\"surpassed your query allowance\")) {\n          if (retries < MAX_RETRIES) {\n            console.warn(`Rate limit hit for ${endpoint}, retrying in ${RETRY_DELAY_MS / 1000}s (attempt ${retries + 1})`);\n            await new Promise(res => setTimeout(res, RETRY_DELAY_MS));\n            return fetchWithRetry(retries + 1);\n          } else {\n            throw new Error(`Rate limit exceeded after ${MAX_RETRIES} retries: ${data.error}`);\n          }\n        }\n\n        if (data.error) {\n          throw new Error(`GraphQL endpoint error: ${data.error}`);\n        }\n\n        if (data.errors) {\n          throw new Error(`GraphQL errors: ${JSON.stringify(data.errors)}`);\n        }\n\n        return data.data;\n      };\n\n      this.apiCallCount++;\n      console.log(\"Total API calls:\", this.apiCallCount);\n\n      const timeoutPromise = new Promise<never>((_, reject) => {\n        setTimeout(\n          () => reject(new Error(\"GraphQL query timeout\")),\n          this.defaultTimeout\n        );\n      });\n\n      const data = await Promise.race([fetchWithRetry(), timeoutPromise]);\n\n      return {\n        data: data as T,\n        status: 200,\n        success: true,\n      };\n    } catch (error) {\n      return {\n        data: null,\n        status: 500,\n        success: false,\n        error: error instanceof Error ? error.message : 'Unknown error occurred',\n      };\n    }\n  }\n\n  /**\n   * Fetches the top pools for a specific protocol by trading volume\n   * \n   * @param count - Number of pools to fetch (default: 500)\n   * @param protocol - Protocol to fetch pools from\n   * @param chainId - Chain ID to fetch pools from\n   * @returns Promise containing an array of top pools\n   * \n   * @example\n   * ```typescript\n   * // Get top 100 Uniswap V3 pools on Ethereum\n   * const topPools = await poolClient.getTopPools(100, Protocol.UniswapV3, 1);\n   * if (topPools.success) {\n   *   console.log(`Found ${topPools.data.length} pools`);\n   * }\n   * ```\n   * \n   * @throws {Error} When failed to fetch pools from subgraph\n   */\n  public async getTopPools(\n    count: number = 500,\n    protocol: Protocol,\n    chainId: number\n  ): Promise<SteerResponse<GraphQLPoolData[]>> {\n    try {\n      const isAlgebraPool = isAlgebraProtocol(protocol);\n      const query = getTopPoolsQuery(protocol, isAlgebraPool);\n\n      console.log(`[Chain ${chainId}] [Protocol ${protocol}] 📊 Fetching top ${count} pools from the subgraph...`);\n\n      const response = await this.fetchFromGraph<TopPoolsResponse>(\n        query,\n        { limit: count },\n        protocol,\n        chainId\n      );\n\n      if (!response.success || !response.data) {\n        throw new Error(response.error || 'Failed to fetch pools');\n      }\n\n      const pools = response.data.pools || response.data.limitPools || response.data.clPools || [];\n      \n      console.log(`[Chain ${chainId}] [Protocol ${protocol}] ✅ Received ${pools.length} pools from the subgraph`);\n\n      // Filter out pools with invalid volumeUSD\n      const validPools = pools.filter(pool => {\n        const volumeUSD = parseFloat(pool.volumeUSD || pool.volumeUsd || \"0\");\n        return !isNaN(volumeUSD) && volumeUSD > 0;\n      });\n\n      console.log(`[Chain ${chainId}] [Protocol ${protocol}] ✅ Found ${validPools.length} valid pools with positive volumeUSD`);\n\n      return {\n        data: validPools,\n        status: 200,\n        success: true,\n      };\n    } catch (error) {\n      console.error(`[Chain ${chainId}] [Protocol ${protocol}] Error in getTopPools:`, error);\n      return {\n        data: null,\n        status: 500,\n        success: false,\n        error: error instanceof Error ? error.message : 'Unknown error occurred',\n      };\n    }\n  }\n\n  /**\n   * Fetches detailed information for a specific pool by its ID\n   * \n   * @param poolId - Pool contract address to fetch\n   * @param protocol - Protocol the pool belongs to\n   * @param chainId - Chain ID where the pool exists\n   * @returns Promise containing pool details or null if not found\n   * \n   * @example\n   * ```typescript\n   * // Get specific pool details\n   * const poolDetails = await poolClient.getPoolById(\n   *   '0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640',\n   *   Protocol.UniswapV3,\n   *   1\n   * );\n   * if (poolDetails.success && poolDetails.data) {\n   *   console.log(`Pool: ${poolDetails.data.token0.symbol}/${poolDetails.data.token1.symbol}`);\n   * }\n   * ```\n   * \n   * @throws {Error} When failed to fetch pool from subgraph\n   */\n  public async getPoolById(\n    poolId: string,\n    protocol: Protocol,\n    chainId: number\n  ): Promise<SteerResponse<GraphQLPoolData | null>> {\n    try {\n\n      const isAlgebraPool = isAlgebraProtocol(protocol);\n      const query = getPoolDetailsQuery(isAlgebraPool, protocol);\n\n    \n      const response = await this.fetchFromGraph<PoolDetailsResponse>(\n        query,\n        { pool: poolId },\n        protocol,\n        chainId\n      );\n\n      if (!response.success || !response.data) {\n        throw new Error(response.error || 'Failed to fetch pool');\n      }\n\n      const pool = response.data.pool || response.data.clPool || response.data.limitPool || null;\n\n\n      return {\n        data: pool,\n        status: 200,\n        success: true,\n      };\n    } catch (error) {\n      console.error(`Error fetching pool ${poolId}:`, error);\n      return {\n        data: null,\n        status: 500,\n        success: false,\n        error: error instanceof Error ? error.message : 'Unknown error occurred',\n      };\n    }\n  }\n\n  /**\n   * Fetches pools containing multiple tokens in batches for better performance\n   * \n   * @param tokenAddresses - Array of token contract addresses\n   * @param protocol - Protocol to fetch pools from\n   * @param chainId - Chain ID to fetch pools from\n   * @param batchSize - Number of tokens to process in each batch (default: 10)\n   * @returns Promise containing all pools found for the tokens\n   * \n   * @example\n   * ```typescript\n   * // Get pools for multiple tokens\n   * const tokenAddresses = [\n   *   '0xa0b86a33e6f8b07b71c3a39ef77a6b6e8f1b7b7e', // USDC\n   *   '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'  // WETH\n   * ];\n   * const pools = await poolClient.fetchPoolsForTokensBatch(\n   *   tokenAddresses,\n   *   Protocol.UniswapV3,\n   *   1,\n   *   5\n   * );\n   * ```\n   * \n   * @throws {Error} When batch processing fails\n   */\n  public async fetchPoolsForTokensBatch(\n    tokenAddresses: string[],\n    protocol: Protocol,\n    chainId: number,\n    batchSize: number = 10\n  ): Promise<SteerResponse<GraphQLPoolData[]>> {\n    try {\n      if (tokenAddresses.length === 0) {\n        return {\n          data: [],\n          status: 200,\n          success: true,\n        };\n      }\n\n      console.log(`\\n🔍 Batch Pool Fetch Summary:`);\n      console.log(`📥 Total tokens to process: ${tokenAddresses.length}`);\n\n      const isAlgebraPool = isAlgebraProtocol(protocol);\n      const normalizedAddresses = tokenAddresses.map(addr => addr.toLowerCase());\n\n      // Split into chunks\n      const chunkSize = batchSize;\n      const addressChunks = [];\n      for (let i = 0; i < normalizedAddresses.length; i += chunkSize) {\n        addressChunks.push(normalizedAddresses.slice(i, i + chunkSize));\n      }\n\n      console.log(`📦 Processing ${addressChunks.length} chunks of max ${chunkSize} tokens each`);\n\n      const allPools: GraphQLPoolData[] = [];\n\n      // Process chunks in parallel\n      const results = await Promise.all(\n        addressChunks.map(async (chunk, chunkIndex) => {\n          console.log(`\\n🔄 Processing chunk ${chunkIndex + 1}/${addressChunks.length} with ${chunk.length} tokens`);\n\n          const chunkResults = await Promise.all(\n            chunk.map(async (token) => {\n              try {\n                const query = getTokenPoolsQueryByAddress(isAlgebraPool, protocol);\n                const queryStartTime = performance.now();\n                \n                const response = await this.fetchFromGraph<PoolsByTokenResponse>(\n                  query,\n                  { token },\n                  protocol,\n                  chainId\n                );\n\n                const queryTime = performance.now() - queryStartTime;\n                console.log(`⏱️ GraphQL query for token ${token.slice(0, 6)}... completed in ${queryTime.toFixed(2)}ms`);\n\n                if (!response.success || !response.data) {\n                  console.error(`❌ No pools found for token: ${token} on chainId: ${chainId}`);\n                  return [];\n                }\n\n                // Extract pools from different possible response structures\n                let pools: GraphQLPoolData[] = [];\n                if (response.data.pools) {\n                  pools = response.data.pools;\n                } else if (response.data.clPools) {\n                  pools = response.data.clPools;\n                } else if (response.data.limitPools) {\n                  pools = response.data.limitPools;\n                } else if (response.data.tokenPools) {\n                  pools = response.data.tokenPools;\n                }\n\n                if (pools.length === 0) {\n                  console.error(`❌ No pools found for token: ${token} on chainId: ${chainId}`);\n                  return [];\n                }\n\n                return pools;\n              } catch (error) {\n                console.error(`❌ Error fetching pools for token: ${token} on chainId: ${chainId}`, error);\n                return [];\n              }\n            })\n          );\n\n          return chunkResults.flat();\n        })\n      );\n\n      // Flatten all results\n      allPools.push(...results.flat());\n\n      return {\n        data: allPools,\n        status: 200,\n        success: true,\n      };\n    } catch (error) {\n      console.error(\"Error in fetchPoolsForTokensBatch:\", error);\n      return {\n        data: null,\n        status: 500,\n        success: false,\n        error: error instanceof Error ? error.message : 'Unknown error occurred',\n      };\n    }\n  }\n\n  /**\n   * Fetches all pools containing a specific token\n   * \n   * @param tokenAddress - Token contract address\n   * @param protocol - Protocol to fetch pools from\n   * @param chainId - Chain ID to fetch pools from\n   * @returns Promise containing pools that include the specified token\n   * \n   * @example\n   * ```typescript\n   * // Get all USDC pools on Uniswap V3\n   * const usdcPools = await poolClient.fetchPoolsForToken(\n   *   '0xa0b86a33e6f8b07b71c3a39ef77a6b6e8f1b7b7e',\n   *   Protocol.UniswapV3,\n   *   1\n   * );\n   * if (usdcPools.success) {\n   *   console.log(`Found ${usdcPools.data.length} USDC pools`);\n   * }\n   * ```\n   * \n   * @throws {Error} When failed to fetch pools for token\n   */\n  public async fetchPoolsForToken(\n    tokenAddress: string,\n    protocol: Protocol,\n    chainId: number\n  ): Promise<SteerResponse<GraphQLPoolData[]>> {\n    try {\n      const isAlgebraPool = isAlgebraProtocol(protocol);\n      const query = getTokenPoolsQueryByAddress(isAlgebraPool, protocol);\n\n      const response = await this.fetchFromGraph<PoolsByTokenResponse>(\n        query,\n        { token: tokenAddress.toLowerCase() },\n        protocol,\n        chainId\n      );\n\n      if (!response.success || !response.data) {\n        throw new Error(response.error || 'Failed to fetch pools for token');\n      }\n\n      // Extract pools from different possible response structures\n      let pools: GraphQLPoolData[] = [];\n      if (response.data.pools) {\n        pools = response.data.pools;\n      } else if (response.data.limitPools) {\n        pools = response.data.limitPools;\n      } else if (response.data.tokenPools) {\n        pools = response.data.tokenPools;\n      } else if (response.data.clPools) {\n        pools = response.data.clPools;\n      }\n\n      return {\n        data: pools,\n        status: 200,\n        success: true,\n      };\n    } catch (error) {\n      console.error(`Error fetching pools for token ${tokenAddress}:`, error);\n      return {\n        data: null,\n        status: 500,\n        success: false,\n        error: error instanceof Error ? error.message : 'Unknown error occurred',\n      };\n    }\n  }\n\n  /**\n   * Filters pools based on validity criteria such as tick range and liquidity\n   * \n   * @param pools - Array of pools to filter\n   * @returns Array of valid pools that meet the criteria\n   * \n   * @example\n   * ```typescript\n   * const validPools = poolClient.filterValidPools(allPools);\n   * console.log(`Filtered down to ${validPools.length} valid pools`);\n   * ```\n   */\n  public filterValidPools(pools: PoolData[]): PoolData[] {\n    return pools.filter(pool => {\n      // Check for required fields\n      if (!pool.id || !pool.tick || !pool.liquidity) {\n        return false;\n      }\n\n      // Parse values\n      const tick = parseInt(pool.tick);\n      const liquidity = parseFloat(pool.liquidity);\n\n      // Check for valid tick range and liquidity\n      const TICK_MIN = -887272;\n      const TICK_MAX = 887272;\n      const TICK_EDGE_THRESHOLD = 1;\n\n      if (\n        isNaN(tick) ||\n        isNaN(liquidity) ||\n        liquidity <= 0 ||\n        tick <= TICK_MIN + TICK_EDGE_THRESHOLD ||\n        tick >= TICK_MAX - TICK_EDGE_THRESHOLD\n      ) {\n        return false;\n      }\n\n      return true;\n    });\n  }\n} "]}
+{"version":3,"file":"PoolClient.js","sourceRoot":"","sources":["../../../src/base/PoolClient.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PublicClient, WalletClient } from 'viem';\nimport { PoolData, SteerResponse } from '../types.js';\nimport { SubgraphClient } from './SubgraphClient.js';\nimport { \n  Protocol, \n  Chain\n} from '../const/chain.js';\nimport { \n  chainIdToName, \n  getProtocolSubgraphURL\n} from '../const/index.js';\nimport { isAlgebraProtocol } from '../const/protocol.js';\nimport { getTopPoolsQuery, getTokenPoolsQueryByAddress, getPoolDetailsQuery } from '../utils/PoolQueryAdapter.js';\n\n/**\n * GraphQL token data interface representing token information from subgraph responses\n * @interface GraphQLTokenData\n */\nexport interface GraphQLTokenData {\n  /** Token symbol (e.g., \"ETH\", \"USDC\") */\n  symbol: string;\n  /** Token contract address */\n  id: string;\n  /** Number of decimal places for the token */\n  decimals: string;\n  /** Human-readable token name */\n  name: string;\n}\n\n/**\n * GraphQL pool data interface representing pool information from subgraph responses\n * @interface GraphQLPoolData\n */\nexport interface GraphQLPoolData {\n  /** Pool contract address */\n  id: string;\n  /** First token in the pool */\n  token0: GraphQLTokenData;\n  /** Second token in the pool */\n  token1: GraphQLTokenData;\n  /** 24-hour trading volume in USD */\n  volumeUSD: string;\n  /** Current tick of the pool */\n  tick: string;\n  /** Total liquidity in the pool */\n  liquidity: string;\n  /** Fee tier for the pool (optional) */\n  feeTier?: string;\n  /** 24-hour volume of token0 (optional) */\n  volumeToken0?: string;\n  /** 24-hour volume of token1 (optional) */\n  volumeToken1?: string;\n  /** Total value locked in ETH (optional) */\n  totalValueLockedETH?: string;\n  /** Alternative field name for volume USD (optional) */\n  volumeUsd?: string;\n  /** Alternative field name for TVL in ETH (optional) */\n  totalValueLockedEth?: string;\n}\n\n/**\n * Filter criteria for querying pools\n * @interface PoolFilter\n */\nexport interface PoolFilter {\n  /** Chain ID to filter pools by */\n  chainId?: number;\n  /** Protocol to filter pools by */\n  protocol?: Protocol;\n  /** Exact pool address/id to look up */\n  poolAddress?: string;\n  /** Minimum volume in USD to filter pools */\n  minVolumeUSD?: number;\n  /** Token address to find pools containing this token */\n  tokenAddress?: string;\n  /** Multiple token addresses to find pools for */\n  tokenAddresses?: string[];\n  /** Token symbol to find pools containing this token */\n  tokenSymbol?: string;\n  /** Multiple token symbols to find pools for */\n  tokenSymbols?: string[];\n  /** Maximum number of pools to return */\n  limit?: number;\n}\n\n// GraphQL response interfaces (currently unused but kept for future use)\n// interface GraphQLResponse<T> {\n//   data: T;\n//   errors?: Array<{ message: string }>;\n// }\n\n/**\n * Response interface for top pools query\n * @interface TopPoolsResponse\n * @internal\n */\ninterface TopPoolsResponse {\n  /** Standard pools array */\n  pools: GraphQLPoolData[];\n  /** Limit pools array (used by some protocols) */\n  limitPools?: GraphQLPoolData[];\n  /** CL pools array (used by some protocols) */\n  clPools?: GraphQLPoolData[];\n}\n\n/**\n * Response interface for pool details query\n * @interface PoolDetailsResponse\n * @internal\n */\ninterface PoolDetailsResponse {\n  /** Single pool data */\n  pool: GraphQLPoolData;\n  /** Single limit pool data (used by some protocols) */\n  limitPool?: GraphQLPoolData;\n  /** Single CL pool data (used by some protocols) */\n  clPool?: GraphQLPoolData;\n}\n\n/**\n * Response interface for pools by token query\n * @interface PoolsByTokenResponse\n * @internal\n */\ninterface PoolsByTokenResponse {\n  /** Standard pools array */\n  pools?: GraphQLPoolData[];\n  /** Limit pools array (used by some protocols) */\n  limitPools?: GraphQLPoolData[];\n  /** Token pools array (used by some protocols) */\n  tokenPools?: GraphQLPoolData[];\n  /** CL pools array (used by some protocols) */\n  clPools?: GraphQLPoolData[];\n}\n\n/**\n * Client for fetching pool data from various DEX protocol subgraphs\n * \n * @example\n * ```typescript\n * import { createPublicClient, createWalletClient, http } from 'viem';\n * import { mainnet } from 'viem/chains';\n * import { PoolClient } from '@steerprotocol/sdk';\n * \n * const client = createPublicClient({\n *   chain: mainnet,\n *   transport: http()\n * }) as PublicClient & WalletClient;\n * \n * const poolClient = new PoolClient(client, 'your-subgraph-studio-key');\n * \n * // Fetch top pools\n * const topPools = await poolClient.getTopPools(100, Protocol.UniswapV3, 1);\n * ```\n * \n * @extends SubgraphClient\n * @group Pool\n */\nexport class PoolClient extends SubgraphClient {\n  /** Public client for blockchain interactions */\n  protected readonly publicClient: PublicClient;\n  /** Default timeout for GraphQL queries in milliseconds */\n  private readonly defaultTimeout: number = 60000;\n  /** Counter for tracking API call metrics */\n  private apiCallCount: number = 0;\n  /** Subgraph Studio API key for rate limiting */\n  private readonly subgraphStudioKey: string;\n\n  /**\n   * Creates a new PoolClient instance\n   * \n   * @param client - Combined public and wallet client for blockchain interactions\n   * @param subgraphStudioKey - Optional Subgraph Studio API key for higher rate limits\n   * \n   * @example\n   * ```typescript\n   * const poolClient = new PoolClient(client, 'your-api-key');\n   * ```\n   */\n  constructor(\n    client: PublicClient & WalletClient,\n    subgraphStudioKey: string = ''\n  ) {\n    super(client);\n    this.publicClient = client;\n    this.subgraphStudioKey = subgraphStudioKey;\n  }\n\n  /**\n   * Resets the API call counter for metrics tracking\n   * \n   * @example\n   * ```typescript\n   * poolClient.resetMetrics();\n   * ```\n   */\n  public resetMetrics(): void {\n    this.apiCallCount = 0;\n  }\n\n  /**\n   * Gets current metrics for monitoring API usage\n   * \n   * @returns Object containing current metrics\n   * \n   * @example\n   * ```typescript\n   * const metrics = poolClient.getMetrics();\n   * console.log(`API calls made: ${metrics.apiCallCount}`);\n   * ```\n   */\n  public getMetrics(): { apiCallCount: number } {\n    return {\n      apiCallCount: this.apiCallCount,\n    };\n  }\n\n  private normalizeAddress(value?: string): string {\n    return value?.toLowerCase() || '';\n  }\n\n  private normalizeSymbol(value?: string): string {\n    return value?.trim().toLowerCase() || '';\n  }\n\n  private dedupePools(pools: GraphQLPoolData[]): GraphQLPoolData[] {\n    const seen = new Set<string>();\n    const deduped: GraphQLPoolData[] = [];\n\n    pools.forEach((pool) => {\n      const key = this.normalizeAddress(pool.id);\n      if (!key || seen.has(key)) {\n        return;\n      }\n\n      seen.add(key);\n      deduped.push(pool);\n    });\n\n    return deduped;\n  }\n\n  private filterPoolsBySymbols(\n    pools: GraphQLPoolData[],\n    symbols: string[],\n  ): GraphQLPoolData[] {\n    if (symbols.length === 0) {\n      return pools;\n    }\n\n    const normalizedSymbols = new Set(\n      symbols.map((symbol) => this.normalizeSymbol(symbol)).filter(Boolean),\n    );\n\n    return pools.filter((pool) => {\n      const token0Symbol = this.normalizeSymbol(pool.token0?.symbol);\n      const token1Symbol = this.normalizeSymbol(pool.token1?.symbol);\n\n      return normalizedSymbols.has(token0Symbol) || normalizedSymbols.has(token1Symbol);\n    });\n  }\n\n  private applyPoolSearchResultFilters(\n    pools: GraphQLPoolData[],\n    filter: PoolFilter,\n  ): GraphQLPoolData[] {\n    let filteredPools = this.dedupePools(pools);\n\n    if (typeof filter.minVolumeUSD === 'number') {\n      filteredPools = filteredPools.filter((pool) => {\n        const volumeUSD = parseFloat(pool.volumeUSD || pool.volumeUsd || '0');\n        return !Number.isNaN(volumeUSD) && volumeUSD >= filter.minVolumeUSD!;\n      });\n    }\n\n    if (typeof filter.limit === 'number' && filter.limit >= 0) {\n      filteredPools = filteredPools.slice(0, filter.limit);\n    }\n\n    return filteredPools;\n  }\n\n  private async searchPoolsBySymbols(\n    filter: Required<Pick<PoolFilter, 'chainId' | 'protocol'>> & PoolFilter,\n    symbols: string[],\n  ): Promise<SteerResponse<GraphQLPoolData[]>> {\n    // Symbol relation filtering is not portable across all supported AMM subgraphs.\n    // Use bounded top-pools fetch plus local symbol filtering as the baseline path.\n    const boundedLimit = Math.min(Math.max(filter.limit ?? 200, 1), 500);\n    const topPools = await this.getTopPools(boundedLimit, filter.protocol, filter.chainId);\n\n    if (!topPools.success || !topPools.data) {\n      return topPools;\n    }\n\n    const symbolMatches = this.filterPoolsBySymbols(topPools.data, symbols);\n\n    return {\n      data: this.applyPoolSearchResultFilters(symbolMatches, filter),\n      status: 200,\n      success: true,\n    };\n  }\n\n  /**\n   * Fetches data from GraphQL endpoint with retry logic for rate limits\n   * \n   * @param query - GraphQL query string\n   * @param variables - Variables for the GraphQL query\n   * @param protocol - Protocol to query\n   * @param chainId - Chain ID to query\n   * @returns Promise containing the response data\n   * \n   * @throws {Error} When subgraph endpoint is not available\n   * @throws {Error} When rate limit is exceeded after max retries\n   * @throws {Error} When GraphQL query times out\n   * \n   * @internal\n   */\n  private async fetchFromGraph<T>(\n    query: string,\n    variables: Record<string, unknown>,\n    protocol: Protocol,\n    chainId: number\n  ): Promise<SteerResponse<T>> {\n    try {\n      const chainName = chainIdToName(chainId);\n      const endpoint = getProtocolSubgraphURL(protocol, chainName as Chain, this.subgraphStudioKey);\n\n      if (!endpoint) {\n        throw new Error(`No subgraph endpoint available for protocol ${protocol} on chain ${chainName}`);\n      }\n\n      const MAX_RETRIES = 3;\n      const RETRY_DELAY_MS = 11000;\n\n      const fetchWithRetry = async (retries = 0): Promise<T> => {\n        const response = await fetch(endpoint, {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n          body: JSON.stringify({ query, variables }),\n        });\n\n        const data = await response.json() as { data: T; error?: string; errors?: Array<{ message: string }> };\n\n        if (data.error && typeof data.error === \"string\" && data.error.includes(\"surpassed your query allowance\")) {\n          if (retries < MAX_RETRIES) {\n            console.warn(`Rate limit hit for ${endpoint}, retrying in ${RETRY_DELAY_MS / 1000}s (attempt ${retries + 1})`);\n            await new Promise(res => setTimeout(res, RETRY_DELAY_MS));\n            return fetchWithRetry(retries + 1);\n          } else {\n            throw new Error(`Rate limit exceeded after ${MAX_RETRIES} retries: ${data.error}`);\n          }\n        }\n\n        if (data.error) {\n          throw new Error(`GraphQL endpoint error: ${data.error}`);\n        }\n\n        if (data.errors) {\n          throw new Error(`GraphQL errors: ${JSON.stringify(data.errors)}`);\n        }\n\n        return data.data;\n      };\n\n      this.apiCallCount++;\n      console.log(\"Total API calls:\", this.apiCallCount);\n\n      const timeoutPromise = new Promise<never>((_, reject) => {\n        setTimeout(\n          () => reject(new Error(\"GraphQL query timeout\")),\n          this.defaultTimeout\n        );\n      });\n\n      const data = await Promise.race([fetchWithRetry(), timeoutPromise]);\n\n      return {\n        data: data as T,\n        status: 200,\n        success: true,\n      };\n    } catch (error) {\n      return {\n        data: null,\n        status: 500,\n        success: false,\n        error: error instanceof Error ? error.message : 'Unknown error occurred',\n      };\n    }\n  }\n\n  /**\n   * Fetches the top pools for a specific protocol by trading volume\n   * \n   * @param count - Number of pools to fetch (default: 500)\n   * @param protocol - Protocol to fetch pools from\n   * @param chainId - Chain ID to fetch pools from\n   * @returns Promise containing an array of top pools\n   * \n   * @example\n   * ```typescript\n   * // Get top 100 Uniswap V3 pools on Ethereum\n   * const topPools = await poolClient.getTopPools(100, Protocol.UniswapV3, 1);\n   * if (topPools.success) {\n   *   console.log(`Found ${topPools.data.length} pools`);\n   * }\n   * ```\n   * \n   * @throws {Error} When failed to fetch pools from subgraph\n   */\n  public async getTopPools(\n    count: number = 500,\n    protocol: Protocol,\n    chainId: number\n  ): Promise<SteerResponse<GraphQLPoolData[]>> {\n    try {\n      const isAlgebraPool = isAlgebraProtocol(protocol);\n      const query = getTopPoolsQuery(protocol, isAlgebraPool);\n\n      console.log(`[Chain ${chainId}] [Protocol ${protocol}] 📊 Fetching top ${count} pools from the subgraph...`);\n\n      const response = await this.fetchFromGraph<TopPoolsResponse>(\n        query,\n        { limit: count },\n        protocol,\n        chainId\n      );\n\n      if (!response.success || !response.data) {\n        throw new Error(response.error || 'Failed to fetch pools');\n      }\n\n      const pools = response.data.pools || response.data.limitPools || response.data.clPools || [];\n      \n      console.log(`[Chain ${chainId}] [Protocol ${protocol}] ✅ Received ${pools.length} pools from the subgraph`);\n\n      // Filter out pools with invalid volumeUSD\n      const validPools = pools.filter(pool => {\n        const volumeUSD = parseFloat(pool.volumeUSD || pool.volumeUsd || \"0\");\n        return !isNaN(volumeUSD) && volumeUSD > 0;\n      });\n\n      console.log(`[Chain ${chainId}] [Protocol ${protocol}] ✅ Found ${validPools.length} valid pools with positive volumeUSD`);\n\n      return {\n        data: validPools,\n        status: 200,\n        success: true,\n      };\n    } catch (error) {\n      console.error(`[Chain ${chainId}] [Protocol ${protocol}] Error in getTopPools:`, error);\n      return {\n        data: null,\n        status: 500,\n        success: false,\n        error: error instanceof Error ? error.message : 'Unknown error occurred',\n      };\n    }\n  }\n\n  /**\n   * Fetches detailed information for a specific pool by its ID\n   * \n   * @param poolId - Pool contract address to fetch\n   * @param protocol - Protocol the pool belongs to\n   * @param chainId - Chain ID where the pool exists\n   * @returns Promise containing pool details or null if not found\n   * \n   * @example\n   * ```typescript\n   * // Get specific pool details\n   * const poolDetails = await poolClient.getPoolById(\n   *   '0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640',\n   *   Protocol.UniswapV3,\n   *   1\n   * );\n   * if (poolDetails.success && poolDetails.data) {\n   *   console.log(`Pool: ${poolDetails.data.token0.symbol}/${poolDetails.data.token1.symbol}`);\n   * }\n   * ```\n   * \n   * @throws {Error} When failed to fetch pool from subgraph\n   */\n  public async getPoolById(\n    poolId: string,\n    protocol: Protocol,\n    chainId: number\n  ): Promise<SteerResponse<GraphQLPoolData | null>> {\n    try {\n\n      const isAlgebraPool = isAlgebraProtocol(protocol);\n      const query = getPoolDetailsQuery(isAlgebraPool, protocol);\n\n    \n      const response = await this.fetchFromGraph<PoolDetailsResponse>(\n        query,\n        { pool: poolId },\n        protocol,\n        chainId\n      );\n\n      if (!response.success || !response.data) {\n        throw new Error(response.error || 'Failed to fetch pool');\n      }\n\n      const pool = response.data.pool || response.data.clPool || response.data.limitPool || null;\n\n\n      return {\n        data: pool,\n        status: 200,\n        success: true,\n      };\n    } catch (error) {\n      console.error(`Error fetching pool ${poolId}:`, error);\n      return {\n        data: null,\n        status: 500,\n        success: false,\n        error: error instanceof Error ? error.message : 'Unknown error occurred',\n      };\n    }\n  }\n\n  /**\n   * Fetches pools containing multiple tokens in batches for better performance\n   * \n   * @param tokenAddresses - Array of token contract addresses\n   * @param protocol - Protocol to fetch pools from\n   * @param chainId - Chain ID to fetch pools from\n   * @param batchSize - Number of tokens to process in each batch (default: 10)\n   * @returns Promise containing all pools found for the tokens\n   * \n   * @example\n   * ```typescript\n   * // Get pools for multiple tokens\n   * const tokenAddresses = [\n   *   '0xa0b86a33e6f8b07b71c3a39ef77a6b6e8f1b7b7e', // USDC\n   *   '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'  // WETH\n   * ];\n   * const pools = await poolClient.fetchPoolsForTokensBatch(\n   *   tokenAddresses,\n   *   Protocol.UniswapV3,\n   *   1,\n   *   5\n   * );\n   * ```\n   * \n   * @throws {Error} When batch processing fails\n   */\n  public async fetchPoolsForTokensBatch(\n    tokenAddresses: string[],\n    protocol: Protocol,\n    chainId: number,\n    batchSize: number = 10\n  ): Promise<SteerResponse<GraphQLPoolData[]>> {\n    try {\n      if (tokenAddresses.length === 0) {\n        return {\n          data: [],\n          status: 200,\n          success: true,\n        };\n      }\n\n      console.log(`\\n🔍 Batch Pool Fetch Summary:`);\n      console.log(`📥 Total tokens to process: ${tokenAddresses.length}`);\n\n      const isAlgebraPool = isAlgebraProtocol(protocol);\n      const normalizedAddresses = tokenAddresses.map(addr => addr.toLowerCase());\n\n      // Split into chunks\n      const chunkSize = batchSize;\n      const addressChunks = [];\n      for (let i = 0; i < normalizedAddresses.length; i += chunkSize) {\n        addressChunks.push(normalizedAddresses.slice(i, i + chunkSize));\n      }\n\n      console.log(`📦 Processing ${addressChunks.length} chunks of max ${chunkSize} tokens each`);\n\n      const allPools: GraphQLPoolData[] = [];\n\n      // Process chunks in parallel\n      const results = await Promise.all(\n        addressChunks.map(async (chunk, chunkIndex) => {\n          console.log(`\\n🔄 Processing chunk ${chunkIndex + 1}/${addressChunks.length} with ${chunk.length} tokens`);\n\n          const chunkResults = await Promise.all(\n            chunk.map(async (token) => {\n              try {\n                const query = getTokenPoolsQueryByAddress(isAlgebraPool, protocol);\n                const queryStartTime = performance.now();\n                \n                const response = await this.fetchFromGraph<PoolsByTokenResponse>(\n                  query,\n                  { token },\n                  protocol,\n                  chainId\n                );\n\n                const queryTime = performance.now() - queryStartTime;\n                console.log(`⏱️ GraphQL query for token ${token.slice(0, 6)}... completed in ${queryTime.toFixed(2)}ms`);\n\n                if (!response.success || !response.data) {\n                  console.error(`❌ No pools found for token: ${token} on chainId: ${chainId}`);\n                  return [];\n                }\n\n                // Extract pools from different possible response structures\n                let pools: GraphQLPoolData[] = [];\n                if (response.data.pools) {\n                  pools = response.data.pools;\n                } else if (response.data.clPools) {\n                  pools = response.data.clPools;\n                } else if (response.data.limitPools) {\n                  pools = response.data.limitPools;\n                } else if (response.data.tokenPools) {\n                  pools = response.data.tokenPools;\n                }\n\n                if (pools.length === 0) {\n                  console.error(`❌ No pools found for token: ${token} on chainId: ${chainId}`);\n                  return [];\n                }\n\n                return pools;\n              } catch (error) {\n                console.error(`❌ Error fetching pools for token: ${token} on chainId: ${chainId}`, error);\n                return [];\n              }\n            })\n          );\n\n          return chunkResults.flat();\n        })\n      );\n\n      // Flatten all results\n      allPools.push(...results.flat());\n\n      return {\n        data: allPools,\n        status: 200,\n        success: true,\n      };\n    } catch (error) {\n      console.error(\"Error in fetchPoolsForTokensBatch:\", error);\n      return {\n        data: null,\n        status: 500,\n        success: false,\n        error: error instanceof Error ? error.message : 'Unknown error occurred',\n      };\n    }\n  }\n\n  /**\n   * Fetches all pools containing a specific token\n   * \n   * @param tokenAddress - Token contract address\n   * @param protocol - Protocol to fetch pools from\n   * @param chainId - Chain ID to fetch pools from\n   * @returns Promise containing pools that include the specified token\n   * \n   * @example\n   * ```typescript\n   * // Get all USDC pools on Uniswap V3\n   * const usdcPools = await poolClient.fetchPoolsForToken(\n   *   '0xa0b86a33e6f8b07b71c3a39ef77a6b6e8f1b7b7e',\n   *   Protocol.UniswapV3,\n   *   1\n   * );\n   * if (usdcPools.success) {\n   *   console.log(`Found ${usdcPools.data.length} USDC pools`);\n   * }\n   * ```\n   * \n   * @throws {Error} When failed to fetch pools for token\n   */\n  public async fetchPoolsForToken(\n    tokenAddress: string,\n    protocol: Protocol,\n    chainId: number\n  ): Promise<SteerResponse<GraphQLPoolData[]>> {\n    try {\n      const isAlgebraPool = isAlgebraProtocol(protocol);\n      const query = getTokenPoolsQueryByAddress(isAlgebraPool, protocol);\n\n      const response = await this.fetchFromGraph<PoolsByTokenResponse>(\n        query,\n        { token: tokenAddress.toLowerCase() },\n        protocol,\n        chainId\n      );\n\n      if (!response.success || !response.data) {\n        throw new Error(response.error || 'Failed to fetch pools for token');\n      }\n\n      // Extract pools from different possible response structures\n      let pools: GraphQLPoolData[] = [];\n      if (response.data.pools) {\n        pools = response.data.pools;\n      } else if (response.data.limitPools) {\n        pools = response.data.limitPools;\n      } else if (response.data.tokenPools) {\n        pools = response.data.tokenPools;\n      } else if (response.data.clPools) {\n        pools = response.data.clPools;\n      }\n\n      return {\n        data: pools,\n        status: 200,\n        success: true,\n      };\n    } catch (error) {\n      console.error(`Error fetching pools for token ${tokenAddress}:`, error);\n      return {\n        data: null,\n        status: 500,\n        success: false,\n        error: error instanceof Error ? error.message : 'Unknown error occurred',\n      };\n    }\n  }\n\n  /**\n   * Filters pools based on validity criteria such as tick range and liquidity\n   * \n   * @param pools - Array of pools to filter\n   * @returns Array of valid pools that meet the criteria\n   * \n   * @example\n   * ```typescript\n   * const validPools = poolClient.filterValidPools(allPools);\n   * console.log(`Filtered down to ${validPools.length} valid pools`);\n   * ```\n   */\n  public filterValidPools(pools: PoolData[]): PoolData[] {\n    return pools.filter(pool => {\n      // Check for required fields\n      if (!pool.id || !pool.tick || !pool.liquidity) {\n        return false;\n      }\n\n      // Parse values\n      const tick = parseInt(pool.tick);\n      const liquidity = parseFloat(pool.liquidity);\n\n      // Check for valid tick range and liquidity\n      const TICK_MIN = -887272;\n      const TICK_MAX = 887272;\n      const TICK_EDGE_THRESHOLD = 1;\n\n      if (\n        isNaN(tick) ||\n        isNaN(liquidity) ||\n        liquidity <= 0 ||\n        tick <= TICK_MIN + TICK_EDGE_THRESHOLD ||\n        tick >= TICK_MAX - TICK_EDGE_THRESHOLD\n      ) {\n        return false;\n      }\n\n      return true;\n    });\n  }\n\n  /**\n   * Searches pools using exact-address lookups where supported and local symbol\n   * filtering as a portable fallback.\n   *\n   * Symbol-based matching is best-effort because not every downstream AMM\n   * subgraph exposes portable nested token-symbol filters.\n   */\n  public async searchPools(\n    filter: PoolFilter,\n  ): Promise<SteerResponse<GraphQLPoolData[]>> {\n    const { chainId, protocol } = filter;\n\n    if (!chainId || !protocol) {\n      return {\n        data: null,\n        status: 400,\n        success: false,\n        error: 'searchPools requires both chainId and protocol',\n      };\n    }\n\n    const normalizedPoolAddress = this.normalizeAddress(filter.poolAddress);\n    const normalizedTokenAddress = this.normalizeAddress(filter.tokenAddress);\n    const normalizedTokenAddresses = (filter.tokenAddresses || [])\n      .map((address) => this.normalizeAddress(address))\n      .filter(Boolean);\n    const tokenSymbols = [\n      ...(filter.tokenSymbol ? [filter.tokenSymbol] : []),\n      ...(filter.tokenSymbols || []),\n    ].filter(Boolean);\n\n    if (\n      !normalizedPoolAddress &&\n      !normalizedTokenAddress &&\n      normalizedTokenAddresses.length === 0 &&\n      tokenSymbols.length === 0\n    ) {\n      return {\n        data: null,\n        status: 400,\n        success: false,\n        error: 'searchPools requires at least one of poolAddress, tokenAddress, tokenAddresses, tokenSymbol, or tokenSymbols',\n      };\n    }\n\n    const collectedPools: GraphQLPoolData[] = [];\n\n    if (normalizedPoolAddress) {\n      const exactPool = await this.getPoolById(normalizedPoolAddress, protocol, chainId);\n      if (!exactPool.success) {\n        return {\n          data: null,\n          status: exactPool.status,\n          success: false,\n          error: exactPool.error,\n        };\n      }\n\n      if (exactPool.data) {\n        collectedPools.push(exactPool.data);\n      }\n    }\n\n    if (normalizedTokenAddress) {\n      const tokenPools = await this.fetchPoolsForToken(normalizedTokenAddress, protocol, chainId);\n      if (!tokenPools.success) {\n        return tokenPools;\n      }\n\n      collectedPools.push(...(tokenPools.data || []));\n    }\n\n    if (normalizedTokenAddresses.length > 0) {\n      const batchPools = await this.fetchPoolsForTokensBatch(\n        normalizedTokenAddresses,\n        protocol,\n        chainId,\n      );\n      if (!batchPools.success) {\n        return batchPools;\n      }\n\n      collectedPools.push(...(batchPools.data || []));\n    }\n\n    if (tokenSymbols.length > 0) {\n      const symbolPools = await this.searchPoolsBySymbols(\n        { ...filter, chainId, protocol },\n        tokenSymbols,\n      );\n      if (!symbolPools.success) {\n        return symbolPools;\n      }\n\n      collectedPools.push(...(symbolPools.data || []));\n    }\n\n    return {\n      data: this.applyPoolSearchResultFilters(collectedPools, filter),\n      status: 200,\n      success: true,\n    };\n  }\n}\n"]}

package/dist/cjs/base/VaultClient.js

@@ -208,8 +208,15 @@ class VaultClient extends SubgraphClient_js_1.SubgraphClient {
         if (!filter) {
             return undefined;
         }
-        const { protocol, ...rest } = filter;
-        const apiFilter = { ...rest };
+        const { protocol, poolAddress, chainId, isActive, beaconName } = filter;
+        const apiFilter = {
+            chainId,
+            isActive,
+            beaconName,
+        };
+        if (poolAddress) {
+            apiFilter.pool = poolAddress;
+        }
         if (!apiFilter.beaconName && protocol) {
             const primaryBeaconName = this.getPrimaryProtocolBeaconName(protocol);
             if (primaryBeaconName) {
@@ -249,6 +256,58 @@ class VaultClient extends SubgraphClient_js_1.SubgraphClient {
             edges: filteredEdges
         };
     }
+    normalizeAddress(value) {
+        return value?.toLowerCase() || '';
+    }
+    normalizeSymbol(value) {
+        return value?.trim().toLowerCase() || '';
+    }
+    matchesAnyAddress(candidates, filterValues) {
+        if (filterValues.length === 0) {
+            return true;
+        }
+        const normalizedCandidates = new Set(candidates.map((candidate) => this.normalizeAddress(candidate)).filter(Boolean));
+        return filterValues.some((value) => normalizedCandidates.has(value));
+    }
+    matchesAnySymbol(candidates, filterValues) {
+        if (filterValues.length === 0) {
+            return true;
+        }
+        const normalizedCandidates = new Set(candidates.map((candidate) => this.normalizeSymbol(candidate)).filter(Boolean));
+        return filterValues.some((value) => normalizedCandidates.has(value));
+    }
+    filterVaultNodes(vaults, filter) {
+        const vaultAddress = this.normalizeAddress(filter.vaultAddress);
+        const poolAddress = this.normalizeAddress(filter.poolAddress);
+        const tokenAddressFilters = [
+            ...(filter.tokenAddress ? [filter.tokenAddress] : []),
+            ...(filter.tokenAddresses || []),
+        ]
+            .map((address) => this.normalizeAddress(address))
+            .filter(Boolean);
+        const tokenSymbolFilters = [
+            ...(filter.tokenSymbol ? [filter.tokenSymbol] : []),
+            ...(filter.tokenSymbols || []),
+        ]
+            .map((symbol) => this.normalizeSymbol(symbol))
+            .filter(Boolean);
+        return vaults.filter((vault) => {
+            if (vaultAddress && this.normalizeAddress(vault.vaultAddress) !== vaultAddress) {
+                return false;
+            }
+            if (poolAddress &&
+                !this.matchesAnyAddress([vault.pool.poolAddress, vault.pool.id], [poolAddress])) {
+                return false;
+            }
+            if (!this.matchesAnyAddress([vault.token0.address, vault.token0.id, vault.token1.address, vault.token1.id], tokenAddressFilters)) {
+                return false;
+            }
+            if (!this.matchesAnySymbol([vault.token0.symbol, vault.token1.symbol], tokenSymbolFilters)) {
+                return false;
+            }
+            return true;
+        });
+    }
     /**
      * Gets vaults with pagination support
      * Fetches ALL data from both API (database) and subgraph in parallel, merges without duplicates, then paginates
@@ -1021,6 +1080,56 @@ class VaultClient extends SubgraphClient_js_1.SubgraphClient {
             };
         }
     }
+    /**
+     * Searches vaults by combining verified API-supported filters with local
+     * filtering over the merged vault result set for unsupported server-side fields.
+     */
+    async searchVaults(filter) {
+        const response = await this.getAllVaults(filter);
+        if (!response.success || !response.data) {
+            return response;
+        }
+        return {
+            data: this.filterVaultNodes(response.data, filter || {}),
+            status: 200,
+            success: true,
+        };
+    }
+    async getVaultByAddress(vaultAddress, filter) {
+        const response = await this.searchVaults({
+            ...filter,
+            vaultAddress,
+        });
+        if (!response.success || !response.data) {
+            return {
+                data: null,
+                status: response.status,
+                success: response.success,
+                error: response.error,
+            };
+        }
+        return {
+            data: response.data[0] || null,
+            status: 200,
+            success: true,
+        };
+    }
+    async getVaultsForPool(poolAddress, filter) {
+        return this.searchVaults({
+            ...filter,
+            poolAddress,
+        });
+    }
+    async getVaultsForToken(tokenAddressOrSymbol, filter) {
+        const normalizedValue = tokenAddressOrSymbol.trim();
+        const isAddress = /^0x[a-fA-F0-9]{40}$/.test(normalizedValue);
+        return this.searchVaults({
+            ...filter,
+            ...(isAddress
+                ? { tokenAddress: normalizedValue }
+                : { tokenSymbol: normalizedValue }),
+        });
+    }
     /**
      * Gets APR data for vaults from the Steer Finance API
      * @param filter - Filter containing chainId and protocol