@steerprotocol/sdk 1.18.4 → 1.19.1

package/dist/cjs/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/esm/base/PoolClient.js

@@ -0,0 +1,451 @@
+import { SubgraphClient } from './SubgraphClient';
+import { chainIdToName, getProtocolSubgraphURL } from '../const';
+import { isAlgebraProtocol } from '../const/protocol';
+import { getTopPoolsQuery, getTokenPoolsQueryByAddress, getPoolDetailsQuery } from '../utils/PoolQueryAdapter';
+/**
+ * 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 class PoolClient extends SubgraphClient {
+    /**
+     * 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, subgraphStudioKey = '') {
+        super(client);
+        /** Default timeout for GraphQL queries in milliseconds */
+        this.defaultTimeout = 60000;
+        /** Counter for tracking API call metrics */
+        this.apiCallCount = 0;
+        this.publicClient = client;
+        this.subgraphStudioKey = subgraphStudioKey;
+    }
+    /**
+     * Resets the API call counter for metrics tracking
+     *
+     * @example
+     * ```typescript
+     * poolClient.resetMetrics();
+     * ```
+     */
+    resetMetrics() {
+        this.apiCallCount = 0;
+    }
+    /**
+     * 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() {
+        return {
+            apiCallCount: this.apiCallCount,
+        };
+    }
+    /**
+     * 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
+     */
+    async fetchFromGraph(query, variables, protocol, chainId) {
+        try {
+            const chainName = chainIdToName(chainId);
+            const endpoint = getProtocolSubgraphURL(protocol, chainName, this.subgraphStudioKey);
+            if (!endpoint) {
+                throw new Error(`No subgraph endpoint available for protocol ${protocol} on chain ${chainName}`);
+            }
+            const MAX_RETRIES = 3;
+            const RETRY_DELAY_MS = 11000;
+            const fetchWithRetry = async (retries = 0) => {
+                const response = await fetch(endpoint, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify({ query, variables }),
+                });
+                const data = await response.json();
+                if (data.error && typeof data.error === "string" && data.error.includes("surpassed your query allowance")) {
+                    if (retries < MAX_RETRIES) {
+                        console.warn(`Rate limit hit for ${endpoint}, retrying in ${RETRY_DELAY_MS / 1000}s (attempt ${retries + 1})`);
+                        await new Promise(res => setTimeout(res, RETRY_DELAY_MS));
+                        return fetchWithRetry(retries + 1);
+                    }
+                    else {
+                        throw new Error(`Rate limit exceeded after ${MAX_RETRIES} retries: ${data.error}`);
+                    }
+                }
+                if (data.error) {
+                    throw new Error(`GraphQL endpoint error: ${data.error}`);
+                }
+                if (data.errors) {
+                    throw new Error(`GraphQL errors: ${JSON.stringify(data.errors)}`);
+                }
+                return data.data;
+            };
+            this.apiCallCount++;
+            console.log("Total API calls:", this.apiCallCount);
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => reject(new Error("GraphQL query timeout")), this.defaultTimeout);
+            });
+            const data = await Promise.race([fetchWithRetry(), timeoutPromise]);
+            return {
+                data: data,
+                status: 200,
+                success: true,
+            };
+        }
+        catch (error) {
+            return {
+                data: null,
+                status: 500,
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error occurred',
+            };
+        }
+    }
+    /**
+     * 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
+     */
+    async getTopPools(count = 500, protocol, chainId) {
+        try {
+            const isAlgebraPool = isAlgebraProtocol(protocol);
+            const query = getTopPoolsQuery(protocol, isAlgebraPool);
+            console.log(`[Chain ${chainId}] [Protocol ${protocol}] 📊 Fetching top ${count} pools from the subgraph...`);
+            const response = await this.fetchFromGraph(query, { limit: count }, protocol, chainId);
+            if (!response.success || !response.data) {
+                throw new Error(response.error || 'Failed to fetch pools');
+            }
+            const pools = response.data.pools || response.data.limitPools || response.data.clPools || [];
+            console.log(`[Chain ${chainId}] [Protocol ${protocol}] ✅ Received ${pools.length} pools from the subgraph`);
+            // Filter out pools with invalid volumeUSD
+            const validPools = pools.filter(pool => {
+                const volumeUSD = parseFloat(pool.volumeUSD || pool.volumeUsd || "0");
+                return !isNaN(volumeUSD) && volumeUSD > 0;
+            });
+            console.log(`[Chain ${chainId}] [Protocol ${protocol}] ✅ Found ${validPools.length} valid pools with positive volumeUSD`);
+            return {
+                data: validPools,
+                status: 200,
+                success: true,
+            };
+        }
+        catch (error) {
+            console.error(`[Chain ${chainId}] [Protocol ${protocol}] Error in getTopPools:`, error);
+            return {
+                data: null,
+                status: 500,
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error occurred',
+            };
+        }
+    }
+    /**
+     * 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
+     */
+    async getPoolById(poolId, protocol, chainId) {
+        try {
+            const isAlgebraPool = isAlgebraProtocol(protocol);
+            const query = getPoolDetailsQuery(isAlgebraPool, protocol);
+            const response = await this.fetchFromGraph(query, { pool: poolId }, protocol, chainId);
+            if (!response.success || !response.data) {
+                throw new Error(response.error || 'Failed to fetch pool');
+            }
+            const pool = response.data.pool || response.data.clPool || response.data.limitPool || null;
+            return {
+                data: pool,
+                status: 200,
+                success: true,
+            };
+        }
+        catch (error) {
+            console.error(`Error fetching pool ${poolId}:`, error);
+            return {
+                data: null,
+                status: 500,
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error occurred',
+            };
+        }
+    }
+    /**
+     * 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
+     */
+    async fetchPoolsForTokensBatch(tokenAddresses, protocol, chainId, batchSize = 10) {
+        try {
+            if (tokenAddresses.length === 0) {
+                return {
+                    data: [],
+                    status: 200,
+                    success: true,
+                };
+            }
+            console.log(`\n🔍 Batch Pool Fetch Summary:`);
+            console.log(`📥 Total tokens to process: ${tokenAddresses.length}`);
+            const isAlgebraPool = isAlgebraProtocol(protocol);
+            const normalizedAddresses = tokenAddresses.map(addr => addr.toLowerCase());
+            // Split into chunks
+            const chunkSize = batchSize;
+            const addressChunks = [];
+            for (let i = 0; i < normalizedAddresses.length; i += chunkSize) {
+                addressChunks.push(normalizedAddresses.slice(i, i + chunkSize));
+            }
+            console.log(`📦 Processing ${addressChunks.length} chunks of max ${chunkSize} tokens each`);
+            const allPools = [];
+            // Process chunks in parallel
+            const results = await Promise.all(addressChunks.map(async (chunk, chunkIndex) => {
+                console.log(`\n🔄 Processing chunk ${chunkIndex + 1}/${addressChunks.length} with ${chunk.length} tokens`);
+                const chunkResults = await Promise.all(chunk.map(async (token) => {
+                    try {
+                        const query = getTokenPoolsQueryByAddress(isAlgebraPool, protocol);
+                        const queryStartTime = performance.now();
+                        const response = await this.fetchFromGraph(query, { token }, protocol, chainId);
+                        const queryTime = performance.now() - queryStartTime;
+                        console.log(`⏱️ GraphQL query for token ${token.slice(0, 6)}... completed in ${queryTime.toFixed(2)}ms`);
+                        if (!response.success || !response.data) {
+                            console.error(`❌ No pools found for token: ${token} on chainId: ${chainId}`);
+                            return [];
+                        }
+                        // Extract pools from different possible response structures
+                        let pools = [];
+                        if (response.data.pools) {
+                            pools = response.data.pools;
+                        }
+                        else if (response.data.clPools) {
+                            pools = response.data.clPools;
+                        }
+                        else if (response.data.limitPools) {
+                            pools = response.data.limitPools;
+                        }
+                        else if (response.data.tokenPools) {
+                            pools = response.data.tokenPools;
+                        }
+                        if (pools.length === 0) {
+                            console.error(`❌ No pools found for token: ${token} on chainId: ${chainId}`);
+                            return [];
+                        }
+                        return pools;
+                    }
+                    catch (error) {
+                        console.error(`❌ Error fetching pools for token: ${token} on chainId: ${chainId}`, error);
+                        return [];
+                    }
+                }));
+                return chunkResults.flat();
+            }));
+            // Flatten all results
+            allPools.push(...results.flat());
+            return {
+                data: allPools,
+                status: 200,
+                success: true,
+            };
+        }
+        catch (error) {
+            console.error("Error in fetchPoolsForTokensBatch:", error);
+            return {
+                data: null,
+                status: 500,
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error occurred',
+            };
+        }
+    }
+    /**
+     * 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
+     */
+    async fetchPoolsForToken(tokenAddress, protocol, chainId) {
+        try {
+            const isAlgebraPool = isAlgebraProtocol(protocol);
+            const query = getTokenPoolsQueryByAddress(isAlgebraPool, protocol);
+            const response = await this.fetchFromGraph(query, { token: tokenAddress.toLowerCase() }, protocol, chainId);
+            if (!response.success || !response.data) {
+                throw new Error(response.error || 'Failed to fetch pools for token');
+            }
+            // Extract pools from different possible response structures
+            let pools = [];
+            if (response.data.pools) {
+                pools = response.data.pools;
+            }
+            else if (response.data.limitPools) {
+                pools = response.data.limitPools;
+            }
+            else if (response.data.tokenPools) {
+                pools = response.data.tokenPools;
+            }
+            else if (response.data.clPools) {
+                pools = response.data.clPools;
+            }
+            return {
+                data: pools,
+                status: 200,
+                success: true,
+            };
+        }
+        catch (error) {
+            console.error(`Error fetching pools for token ${tokenAddress}:`, error);
+            return {
+                data: null,
+                status: 500,
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error occurred',
+            };
+        }
+    }
+    /**
+     * 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) {
+        return pools.filter(pool => {
+            // Check for required fields
+            if (!pool.id || !pool.tick || !pool.liquidity) {
+                return false;
+            }
+            // Parse values
+            const tick = parseInt(pool.tick);
+            const liquidity = parseFloat(pool.liquidity);
+            // Check for valid tick range and liquidity
+            const TICK_MIN = -887272;
+            const TICK_MAX = 887272;
+            const TICK_EDGE_THRESHOLD = 1;
+            if (isNaN(tick) ||
+                isNaN(liquidity) ||
+                liquidity <= 0 ||
+                tick <= TICK_MIN + TICK_EDGE_THRESHOLD ||
+                tick >= TICK_MAX - TICK_EDGE_THRESHOLD) {
+                return false;
+            }
+            return true;
+        });
+    }
+}
+//# sourceMappingURL=PoolClient.js.map

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

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

package/dist/esm/client.js

@@ -1,16 +1,17 @@
 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({
@@ -27,7 +28,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
@@ -36,6 +38,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
@@ -43,7 +52,22 @@ import { StakingClient } from './base/StakingClient';
 export class SteerClient extends SubgraphClient {
     /**
      * 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) {
         super(config.client);
@@ -51,6 +75,7 @@ export class SteerClient extends SubgraphClient {
         // Initialize clients based on provided configuration
         const publicClient = config.client;
         const walletClient = config.walletClient;
+        const subgraphStudioKey = config.subgraphStudioKey || '';
         // Initialize vault client with both public and wallet clients if available
         this.vaults = new VaultClient(walletClient ?
             { ...publicClient, ...walletClient } :
@@ -59,6 +84,10 @@ export class SteerClient extends SubgraphClient {
         this.staking = new StakingClient(walletClient ?
             { ...publicClient, ...walletClient } :
             publicClient);
+        // Initialize pool client with both public and wallet clients if available
+        this.pools = new PoolClient(walletClient ?
+            { ...publicClient, ...walletClient } :
+            publicClient, subgraphStudioKey);
         // Initialize rewards client with both public and wallet clients if available
         if (walletClient) {
             this.rewards = new SmartRewardsClient(publicClient, walletClient, this.environment === 'production' ? 'production' : 'development');

package/dist/esm/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AACA,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,MAAM,OAAO,WAAY,SAAQ,cAAc;IAc7C;;;OAGG;IACH,YAAY,MAAmB;QAC7B,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,YAAY,CAAC;QAEtD,qDAAqD;QACrD,MAAM,YAAY,GAAG,MAAM,CAAC,MAAsB,CAAC;QACnD,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QAEzC,2EAA2E;QAC3E,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC,YAAY,CAAC,CAAC;YAC1C,EAAE,GAAG,YAAY,EAAE,GAAG,YAAY,EAAiC,CAAC,CAAC;YACrE,YAAsD,CACvD,CAAC;QAEF,6EAA6E;QAC7E,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC;YAC7C,EAAE,GAAG,YAAY,EAAE,GAAG,YAAY,EAAiC,CAAC,CAAC;YACrE,YAAsD,CACvD,CAAC;QAEF,6EAA6E;QAC7E,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,GAAG,IAAI,kBAAkB,CACnC,YAAY,EACZ,YAAY,EACZ,IAAI,CAAC,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CACjE,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,0EAA0E;YAC1E,IAAI,CAAC,OAAO,GAAG,IAAI,kBAAkB,CACnC,YAAY,EACZ,YAAuC,EAAE,qCAAqC;YAC9E,IAAI,CAAC,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CACjE,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACI,KAAK,CAAC,cAAc;QACzB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;QAEhD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO;YACL,IAAI,EAAE,WAA2B;YACjC,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AACA,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,MAAM,OAAO,WAAY,SAAQ,cAAc;IAiB7C;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,MAAmB;QAC7B,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,YAAY,CAAC;QAEtD,qDAAqD;QACrD,MAAM,YAAY,GAAG,MAAM,CAAC,MAAsB,CAAC;QACnD,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACzC,MAAM,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC;QAEzD,2EAA2E;QAC3E,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC,YAAY,CAAC,CAAC;YAC1C,EAAE,GAAG,YAAY,EAAE,GAAG,YAAY,EAAiC,CAAC,CAAC;YACrE,YAAsD,CACvD,CAAC;QAEF,6EAA6E;QAC7E,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC;YAC7C,EAAE,GAAG,YAAY,EAAE,GAAG,YAAY,EAAiC,CAAC,CAAC;YACrE,YAAsD,CACvD,CAAC;QAEF,0EAA0E;QAC1E,IAAI,CAAC,KAAK,GAAG,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;YACxC,EAAE,GAAG,YAAY,EAAE,GAAG,YAAY,EAAiC,CAAC,CAAC;YACrE,YAAsD,EACtD,iBAAiB,CAClB,CAAC;QAEF,6EAA6E;QAC7E,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,GAAG,IAAI,kBAAkB,CACnC,YAAY,EACZ,YAAY,EACZ,IAAI,CAAC,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CACjE,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,0EAA0E;YAC1E,IAAI,CAAC,OAAO,GAAG,IAAI,kBAAkB,CACnC,YAAY,EACZ,YAAuC,EAAE,qCAAqC;YAC9E,IAAI,CAAC,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CACjE,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACI,KAAK,CAAC,cAAc;QACzB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;QAEhD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO;YACL,IAAI,EAAE,WAA2B;YACjC,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/index.js

@@ -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/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","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.js","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"}