@net-protocol/score 0.1.8 → 0.1.10

package/README.md

@@ -25,6 +25,7 @@ Net Score is a decentralized on-chain scoring system built on Net Protocol. It a
 - **Decode upvote messages** from Net protocol (legacy and strategy formats)
 - **Decode strategy metadata** to inspect vote weight details
 - **Select strategies** automatically based on pool key availability
+- **Compute token leaderboards** with `getTokenRankings()` — the same time-decayed ranking that powers the website's `/token/<chain>/trending` page (`trending` / `recent` / `top` sorts)
 
 This package provides both React hooks (for UI) and a client class (for non-React code).
 
@@ -128,6 +129,29 @@ const appCounts = await client.getAppKeyScores({
 });
 ```
 
+### Token Rankings
+
+`getTokenRankings()` returns the same leaderboard that powers the website's
+`/token/<chain>/trending` page — read live from chain with no off-chain index.
+
+```typescript
+import { getTokenRankings } from "@net-protocol/score";
+
+const tokens = await getTokenRankings({
+  chainId: 8453,
+  sort: "trending", // "trending" | "recent" | "top"
+  maxTokens: 50,
+});
+
+for (const t of tokens) {
+  console.log(t.symbol, t.upvotes, t.fdv, t.priceInUsdc);
+}
+```
+
+Each call performs ~8 RPC reads. Production callers should cache via HTTP
+`Cache-Control` headers or an edge cache. Only Base (chainId 8453) is
+supported today; other chains throw synchronously.
+
 ## API Reference
 
 ### ScoreClient
@@ -139,6 +163,12 @@ const appCounts = await client.getAppKeyScores({
 | `getStrategyKeyScores(opts)` | Get scores for keys from a specific strategy |
 | `getAppKeyScores(opts)` | Get scores for keys from a specific app |
 
+### Token Rankings
+
+| Function | Description |
+|----------|-------------|
+| `getTokenRankings(opts)` | Compute a token leaderboard ranked by upvote activity (`trending` / `recent` / `top`). Mirrors the website's `/token/<chain>/trending` page. |
+
 ### React Hooks
 
 | Hook | Description |

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { S as ScoreClientOptions, G as GetUpvotesOptions, a as GetUpvotesForItemsOptions, b as GetStrategyKeyScoresOptions, c as GetAppKeyScoresOptions, D as DecodedStrategyMetadata, P as PoolKey, d as PoolDiscoveryPair, e as PoolDiscoveryResult } from './scoreKeyUtils-BjMpyhyX.mjs';
-export { f as DecodedUpvoteBlob, F as FeedMessage, g as PoolStrategyMetadata, h as PureAlphaMetadata, i as ScoreItem, U as UseTokenUpvotesOptions, j as UseUpvotePriceOptions, k as UseUpvoteUserOptions, l as UseUpvotesBatchOptions, m as UseUpvotesOptions, n as UseUserUpvotesGivenOptions, o as UseUserUpvotesGivenPerTokenBatchOptions, p as UseUserUpvotesReceivedOptions, q as UseUserUpvotesReceivedPerTokenBatchOptions, r as extractTokenAddressFromScoreKey, s as getFeedContentKey, t as getScoreKey, u as getStorageScoreKey, v as getStorageUpvoteContext, w as getTokenScoreKey, x as isTokenScoreKey } from './scoreKeyUtils-BjMpyhyX.mjs';
+import { S as ScoreClientOptions, G as GetUpvotesOptions, a as GetUpvotesForItemsOptions, b as GetStrategyKeyScoresOptions, c as GetAppKeyScoresOptions, P as PoolDiscoveryPair, d as PoolDiscoveryResult, D as DecodedStrategyMetadata, e as PoolKey } from './scoreKeyUtils-BQl5oCSc.mjs';
+export { f as DecodedUpvoteBlob, F as FeedMessage, g as PoolStrategyMetadata, h as PureAlphaMetadata, i as ScoreItem, U as UseTokenUpvotesOptions, j as UseUpvotePriceOptions, k as UseUpvoteUserOptions, l as UseUpvotesBatchOptions, m as UseUpvotesOptions, n as UseUserUpvotesGivenOptions, o as UseUserUpvotesGivenPerTokenBatchOptions, p as UseUserUpvotesReceivedOptions, q as UseUserUpvotesReceivedPerTokenBatchOptions, r as extractTokenAddressFromScoreKey, s as getFeedContentKey, t as getScoreKey, u as getStorageScoreKey, v as getStorageUpvoteContext, w as getTokenScoreKey, x as isTokenScoreKey } from './scoreKeyUtils-BQl5oCSc.mjs';
 import { Address, WalletClient, PublicClient, Abi } from 'viem';
 
 /**
@@ -149,6 +149,106 @@ declare class UserUpvoteClient {
     }): Promise<`0x${string}`>;
 }
 
+/**
+ * Calculate price from sqrtPriceX96 for Uniswap V3/V4 pools.
+ */
+declare function calculatePriceFromSqrtPriceX96(sqrtPriceX96: bigint, token0Decimals: number, token1Decimals: number, isToken0: boolean): number;
+/**
+ * Discover the best Uniswap pools for multiple token pairs.
+ * Makes two on-chain calls: pool discovery + pool info retrieval.
+ */
+declare function discoverPools({ publicClient, pairs, chainId, }: {
+    publicClient: PublicClient;
+    pairs: PoolDiscoveryPair[];
+    /** Chain ID used to resolve the WETH address. Defaults to Base (8453). */
+    chainId?: number;
+}): Promise<PoolDiscoveryResult[]>;
+/**
+ * Discover the best WETH pool for a single token.
+ * Convenience wrapper around discoverPools.
+ */
+declare function discoverTokenPool({ publicClient, tokenAddress, chainId, }: {
+    publicClient: PublicClient;
+    tokenAddress: string;
+    /** Chain ID used to resolve the WETH address. Defaults to Base (8453). */
+    chainId?: number;
+}): Promise<PoolDiscoveryResult | null>;
+
+/**
+ * How to rank tokens by upvote activity.
+ *
+ * - `trending`: time-decayed score, recent upvotes weighted higher.
+ *   Matches the website's "Hot" / default tab on /token/<chain>/trending.
+ * - `recent`: latest upvote timestamp
+ * - `top`: aggregate upvote count (via UpvoteApp.getUpvotesWithLegacy)
+ */
+type RankingSort = "trending" | "recent" | "top";
+interface RankedToken {
+    address: Address;
+    name?: string;
+    symbol?: string;
+    decimals?: number;
+    /** Fully Diluted Valuation in USDC, when price + supply are available */
+    fdv?: number;
+    /** Token price in USDC, derived from the best token/WETH pool and WETH/USDC */
+    priceInUsdc?: number;
+    /** Aggregate upvote count from UpvoteApp.getUpvotesWithLegacy across all strategies */
+    upvotes: number;
+    /** Unix timestamp (seconds) of the most recent upvote event seen in the scan window */
+    latestUpvoteTimestamp: number;
+}
+interface GetTokenRankingsOptions {
+    chainId: number;
+    /**
+     * Maximum number of tokens to return. The function fetches and ranks more
+     * tokens than this internally to account for filtering. Default: 50 (matches
+     * the website's /token/<chain>/trending page).
+     */
+    maxTokens?: number;
+    /** Default: "trending" */
+    sort?: RankingSort;
+    /**
+     * Number of recent messages to scan per contract (legacy + 3 strategies).
+     * Larger = more historical coverage, more RPC cost. Default: 150.
+     */
+    messageScanWindow?: number;
+    /**
+     * Two-tier filtering thresholds, copied from the website defaults. Tokens
+     * that meet at least one of these qualify for the top slots; others fill
+     * remaining slots up to `maxTokens`.
+     */
+    thresholds?: {
+        /** Minimum aggregate upvotes to qualify for the top slots. Default: 500 */
+        minUpvotes?: number;
+        /** Minimum FDV (USDC) to qualify for the top slots. Default: 40_000 */
+        minMarketCap?: number;
+        /**
+         * Tokens below `minMarketCap` are dropped entirely if they have no
+         * upvotes within this many hours. Default: 48
+         */
+        recencyHours?: number;
+    };
+    /** Optional RPC URL override. If omitted, uses the package's defaults for the chain. */
+    rpcUrl?: string | string[];
+}
+
+/**
+ * Compute a token leaderboard ranked by upvote activity, mirroring the
+ * /token/<chain>/trending page on netprotocol.app.
+ *
+ * Reads recent Net Protocol upvote messages for the legacy upvote contract
+ * and the three strategy contracts, aggregates them into per-token events,
+ * scores them by the chosen sort, then enriches the top results with ERC20
+ * metadata, Uniswap pool pricing, and aggregate upvote counts.
+ *
+ * All reads are live from chain — no off-chain index. Callers should cache
+ * results (e.g. HTTP `Cache-Control`) since each call performs ~8 RPC reads.
+ *
+ * Currently supports only chains in SUPPORTED_SCORE_CHAINS (Base mainnet).
+ * Throws synchronously for any other chain.
+ */
+declare function getTokenRankings(options: GetTokenRankingsOptions): Promise<RankedToken[]>;
+
 /**
  * Convert token address to bytes32 upvote key.
  */
@@ -268,31 +368,6 @@ declare function decodeUpvoteMessage(msg: {
  */
 declare const encodePoolKey: (poolKey?: PoolKey | null) => `0x${string}`;
 
-/**
- * Calculate price from sqrtPriceX96 for Uniswap V3/V4 pools.
- */
-declare function calculatePriceFromSqrtPriceX96(sqrtPriceX96: bigint, token0Decimals: number, token1Decimals: number, isToken0: boolean): number;
-/**
- * Discover the best Uniswap pools for multiple token pairs.
- * Makes two on-chain calls: pool discovery + pool info retrieval.
- */
-declare function discoverPools({ publicClient, pairs, chainId, }: {
-    publicClient: PublicClient;
-    pairs: PoolDiscoveryPair[];
-    /** Chain ID used to resolve the WETH address. Defaults to Base (8453). */
-    chainId?: number;
-}): Promise<PoolDiscoveryResult[]>;
-/**
- * Discover the best WETH pool for a single token.
- * Convenience wrapper around discoverPools.
- */
-declare function discoverTokenPool({ publicClient, tokenAddress, chainId, }: {
-    publicClient: PublicClient;
-    tokenAddress: string;
-    /** Chain ID used to resolve the WETH address. Defaults to Base (8453). */
-    chainId?: number;
-}): Promise<PoolDiscoveryResult | null>;
-
 declare const SCORE_CONTRACT: {
     readonly address: Address;
     readonly abi: Abi;
@@ -339,6 +414,10 @@ declare const USER_UPVOTE_CONTRACT: {
     readonly address: Address;
     readonly abi: Abi;
 };
+declare const ERC20_BULK_INFO_HELPER_CONTRACT: {
+    readonly address: Address;
+    readonly abi: Abi;
+};
 
 /**
  * Parse a Net protocol message from the user upvote contract.
@@ -400,4 +479,4 @@ declare function buildUserUpvoteReceived(parsed: ParsedUserUpvoteMessage, upvote
     decimals: number;
 }): UserUpvoteReceived;
 
-export { ALL_STRATEGY_ADDRESSES, DYNAMIC_SPLIT_STRATEGY, DecodedStrategyMetadata, GetAppKeyScoresOptions, GetStrategyKeyScoresOptions, GetUpvotesForItemsOptions, GetUpvotesOptions, LEGACY_UPVOTE_V1_ADDRESS, LEGACY_UPVOTE_V2_ADDRESS, MULTI_VERSION_UNISWAP_BULK_POOL_FINDER, MULTI_VERSION_UNISWAP_POOL_INFO_RETRIEVER, NULL_ADDRESS, PURE_ALPHA_STRATEGY, type ParsedUserUpvoteMessage, PoolDiscoveryPair, PoolDiscoveryResult, PoolKey, SCORE_CONTRACT, SUPPORTED_SCORE_CHAINS, ScoreClient, ScoreClientOptions, type TokenAddressExtraction, UNIV234_POOLS_STRATEGY, UPVOTE_APP, UPVOTE_PRICE_ETH, UPVOTE_STORAGE_APP, USER_UPVOTE_CONTRACT, type UserUpvote, UserUpvoteClient, type UserUpvoteClientOptions, type UserUpvoteNetMessage, type UserUpvoteReceived, buildUserUpvote, buildUserUpvoteReceived, calculatePriceFromSqrtPriceX96, calculatePriceInUsdc, calculateUpvoteCost, calculateUserTokenBalance, decodeStrategyMetadata, decodeUpvoteMessage, decodeUpvoteStorageBlob, discoverPools, discoverTokenPool, encodePoolKey, encodeUpvoteKey, extractStrategyAddress, extractTokenAddressesFromMessages, getWethAddress, isDynamicSplitStrategy, isPureAlphaStrategy, isStrategyMessage, isUniv234PoolsStrategy, isUserUpvoteMessage, parseUserUpvoteMessage, selectStrategy, tokenAddressToUpvoteKeyString, validateUpvoteParams, validateUserUpvoteMessage };
+export { ALL_STRATEGY_ADDRESSES, DYNAMIC_SPLIT_STRATEGY, DecodedStrategyMetadata, ERC20_BULK_INFO_HELPER_CONTRACT, GetAppKeyScoresOptions, GetStrategyKeyScoresOptions, type GetTokenRankingsOptions, GetUpvotesForItemsOptions, GetUpvotesOptions, LEGACY_UPVOTE_V1_ADDRESS, LEGACY_UPVOTE_V2_ADDRESS, MULTI_VERSION_UNISWAP_BULK_POOL_FINDER, MULTI_VERSION_UNISWAP_POOL_INFO_RETRIEVER, NULL_ADDRESS, PURE_ALPHA_STRATEGY, type ParsedUserUpvoteMessage, PoolDiscoveryPair, PoolDiscoveryResult, PoolKey, type RankedToken, type RankingSort, SCORE_CONTRACT, SUPPORTED_SCORE_CHAINS, ScoreClient, ScoreClientOptions, type TokenAddressExtraction, UNIV234_POOLS_STRATEGY, UPVOTE_APP, UPVOTE_PRICE_ETH, UPVOTE_STORAGE_APP, USER_UPVOTE_CONTRACT, type UserUpvote, UserUpvoteClient, type UserUpvoteClientOptions, type UserUpvoteNetMessage, type UserUpvoteReceived, buildUserUpvote, buildUserUpvoteReceived, calculatePriceFromSqrtPriceX96, calculatePriceInUsdc, calculateUpvoteCost, calculateUserTokenBalance, decodeStrategyMetadata, decodeUpvoteMessage, decodeUpvoteStorageBlob, discoverPools, discoverTokenPool, encodePoolKey, encodeUpvoteKey, extractStrategyAddress, extractTokenAddressesFromMessages, getTokenRankings, getWethAddress, isDynamicSplitStrategy, isPureAlphaStrategy, isStrategyMessage, isUniv234PoolsStrategy, isUserUpvoteMessage, parseUserUpvoteMessage, selectStrategy, tokenAddressToUpvoteKeyString, validateUpvoteParams, validateUserUpvoteMessage };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as ScoreClientOptions, G as GetUpvotesOptions, a as GetUpvotesForItemsOptions, b as GetStrategyKeyScoresOptions, c as GetAppKeyScoresOptions, D as DecodedStrategyMetadata, P as PoolKey, d as PoolDiscoveryPair, e as PoolDiscoveryResult } from './scoreKeyUtils-BjMpyhyX.js';
-export { f as DecodedUpvoteBlob, F as FeedMessage, g as PoolStrategyMetadata, h as PureAlphaMetadata, i as ScoreItem, U as UseTokenUpvotesOptions, j as UseUpvotePriceOptions, k as UseUpvoteUserOptions, l as UseUpvotesBatchOptions, m as UseUpvotesOptions, n as UseUserUpvotesGivenOptions, o as UseUserUpvotesGivenPerTokenBatchOptions, p as UseUserUpvotesReceivedOptions, q as UseUserUpvotesReceivedPerTokenBatchOptions, r as extractTokenAddressFromScoreKey, s as getFeedContentKey, t as getScoreKey, u as getStorageScoreKey, v as getStorageUpvoteContext, w as getTokenScoreKey, x as isTokenScoreKey } from './scoreKeyUtils-BjMpyhyX.js';
+import { S as ScoreClientOptions, G as GetUpvotesOptions, a as GetUpvotesForItemsOptions, b as GetStrategyKeyScoresOptions, c as GetAppKeyScoresOptions, P as PoolDiscoveryPair, d as PoolDiscoveryResult, D as DecodedStrategyMetadata, e as PoolKey } from './scoreKeyUtils-BQl5oCSc.js';
+export { f as DecodedUpvoteBlob, F as FeedMessage, g as PoolStrategyMetadata, h as PureAlphaMetadata, i as ScoreItem, U as UseTokenUpvotesOptions, j as UseUpvotePriceOptions, k as UseUpvoteUserOptions, l as UseUpvotesBatchOptions, m as UseUpvotesOptions, n as UseUserUpvotesGivenOptions, o as UseUserUpvotesGivenPerTokenBatchOptions, p as UseUserUpvotesReceivedOptions, q as UseUserUpvotesReceivedPerTokenBatchOptions, r as extractTokenAddressFromScoreKey, s as getFeedContentKey, t as getScoreKey, u as getStorageScoreKey, v as getStorageUpvoteContext, w as getTokenScoreKey, x as isTokenScoreKey } from './scoreKeyUtils-BQl5oCSc.js';
 import { Address, WalletClient, PublicClient, Abi } from 'viem';
 
 /**
@@ -149,6 +149,106 @@ declare class UserUpvoteClient {
     }): Promise<`0x${string}`>;
 }
 
+/**
+ * Calculate price from sqrtPriceX96 for Uniswap V3/V4 pools.
+ */
+declare function calculatePriceFromSqrtPriceX96(sqrtPriceX96: bigint, token0Decimals: number, token1Decimals: number, isToken0: boolean): number;
+/**
+ * Discover the best Uniswap pools for multiple token pairs.
+ * Makes two on-chain calls: pool discovery + pool info retrieval.
+ */
+declare function discoverPools({ publicClient, pairs, chainId, }: {
+    publicClient: PublicClient;
+    pairs: PoolDiscoveryPair[];
+    /** Chain ID used to resolve the WETH address. Defaults to Base (8453). */
+    chainId?: number;
+}): Promise<PoolDiscoveryResult[]>;
+/**
+ * Discover the best WETH pool for a single token.
+ * Convenience wrapper around discoverPools.
+ */
+declare function discoverTokenPool({ publicClient, tokenAddress, chainId, }: {
+    publicClient: PublicClient;
+    tokenAddress: string;
+    /** Chain ID used to resolve the WETH address. Defaults to Base (8453). */
+    chainId?: number;
+}): Promise<PoolDiscoveryResult | null>;
+
+/**
+ * How to rank tokens by upvote activity.
+ *
+ * - `trending`: time-decayed score, recent upvotes weighted higher.
+ *   Matches the website's "Hot" / default tab on /token/<chain>/trending.
+ * - `recent`: latest upvote timestamp
+ * - `top`: aggregate upvote count (via UpvoteApp.getUpvotesWithLegacy)
+ */
+type RankingSort = "trending" | "recent" | "top";
+interface RankedToken {
+    address: Address;
+    name?: string;
+    symbol?: string;
+    decimals?: number;
+    /** Fully Diluted Valuation in USDC, when price + supply are available */
+    fdv?: number;
+    /** Token price in USDC, derived from the best token/WETH pool and WETH/USDC */
+    priceInUsdc?: number;
+    /** Aggregate upvote count from UpvoteApp.getUpvotesWithLegacy across all strategies */
+    upvotes: number;
+    /** Unix timestamp (seconds) of the most recent upvote event seen in the scan window */
+    latestUpvoteTimestamp: number;
+}
+interface GetTokenRankingsOptions {
+    chainId: number;
+    /**
+     * Maximum number of tokens to return. The function fetches and ranks more
+     * tokens than this internally to account for filtering. Default: 50 (matches
+     * the website's /token/<chain>/trending page).
+     */
+    maxTokens?: number;
+    /** Default: "trending" */
+    sort?: RankingSort;
+    /**
+     * Number of recent messages to scan per contract (legacy + 3 strategies).
+     * Larger = more historical coverage, more RPC cost. Default: 150.
+     */
+    messageScanWindow?: number;
+    /**
+     * Two-tier filtering thresholds, copied from the website defaults. Tokens
+     * that meet at least one of these qualify for the top slots; others fill
+     * remaining slots up to `maxTokens`.
+     */
+    thresholds?: {
+        /** Minimum aggregate upvotes to qualify for the top slots. Default: 500 */
+        minUpvotes?: number;
+        /** Minimum FDV (USDC) to qualify for the top slots. Default: 40_000 */
+        minMarketCap?: number;
+        /**
+         * Tokens below `minMarketCap` are dropped entirely if they have no
+         * upvotes within this many hours. Default: 48
+         */
+        recencyHours?: number;
+    };
+    /** Optional RPC URL override. If omitted, uses the package's defaults for the chain. */
+    rpcUrl?: string | string[];
+}
+
+/**
+ * Compute a token leaderboard ranked by upvote activity, mirroring the
+ * /token/<chain>/trending page on netprotocol.app.
+ *
+ * Reads recent Net Protocol upvote messages for the legacy upvote contract
+ * and the three strategy contracts, aggregates them into per-token events,
+ * scores them by the chosen sort, then enriches the top results with ERC20
+ * metadata, Uniswap pool pricing, and aggregate upvote counts.
+ *
+ * All reads are live from chain — no off-chain index. Callers should cache
+ * results (e.g. HTTP `Cache-Control`) since each call performs ~8 RPC reads.
+ *
+ * Currently supports only chains in SUPPORTED_SCORE_CHAINS (Base mainnet).
+ * Throws synchronously for any other chain.
+ */
+declare function getTokenRankings(options: GetTokenRankingsOptions): Promise<RankedToken[]>;
+
 /**
  * Convert token address to bytes32 upvote key.
  */
@@ -268,31 +368,6 @@ declare function decodeUpvoteMessage(msg: {
  */
 declare const encodePoolKey: (poolKey?: PoolKey | null) => `0x${string}`;
 
-/**
- * Calculate price from sqrtPriceX96 for Uniswap V3/V4 pools.
- */
-declare function calculatePriceFromSqrtPriceX96(sqrtPriceX96: bigint, token0Decimals: number, token1Decimals: number, isToken0: boolean): number;
-/**
- * Discover the best Uniswap pools for multiple token pairs.
- * Makes two on-chain calls: pool discovery + pool info retrieval.
- */
-declare function discoverPools({ publicClient, pairs, chainId, }: {
-    publicClient: PublicClient;
-    pairs: PoolDiscoveryPair[];
-    /** Chain ID used to resolve the WETH address. Defaults to Base (8453). */
-    chainId?: number;
-}): Promise<PoolDiscoveryResult[]>;
-/**
- * Discover the best WETH pool for a single token.
- * Convenience wrapper around discoverPools.
- */
-declare function discoverTokenPool({ publicClient, tokenAddress, chainId, }: {
-    publicClient: PublicClient;
-    tokenAddress: string;
-    /** Chain ID used to resolve the WETH address. Defaults to Base (8453). */
-    chainId?: number;
-}): Promise<PoolDiscoveryResult | null>;
-
 declare const SCORE_CONTRACT: {
     readonly address: Address;
     readonly abi: Abi;
@@ -339,6 +414,10 @@ declare const USER_UPVOTE_CONTRACT: {
     readonly address: Address;
     readonly abi: Abi;
 };
+declare const ERC20_BULK_INFO_HELPER_CONTRACT: {
+    readonly address: Address;
+    readonly abi: Abi;
+};
 
 /**
  * Parse a Net protocol message from the user upvote contract.
@@ -400,4 +479,4 @@ declare function buildUserUpvoteReceived(parsed: ParsedUserUpvoteMessage, upvote
     decimals: number;
 }): UserUpvoteReceived;
 
-export { ALL_STRATEGY_ADDRESSES, DYNAMIC_SPLIT_STRATEGY, DecodedStrategyMetadata, GetAppKeyScoresOptions, GetStrategyKeyScoresOptions, GetUpvotesForItemsOptions, GetUpvotesOptions, LEGACY_UPVOTE_V1_ADDRESS, LEGACY_UPVOTE_V2_ADDRESS, MULTI_VERSION_UNISWAP_BULK_POOL_FINDER, MULTI_VERSION_UNISWAP_POOL_INFO_RETRIEVER, NULL_ADDRESS, PURE_ALPHA_STRATEGY, type ParsedUserUpvoteMessage, PoolDiscoveryPair, PoolDiscoveryResult, PoolKey, SCORE_CONTRACT, SUPPORTED_SCORE_CHAINS, ScoreClient, ScoreClientOptions, type TokenAddressExtraction, UNIV234_POOLS_STRATEGY, UPVOTE_APP, UPVOTE_PRICE_ETH, UPVOTE_STORAGE_APP, USER_UPVOTE_CONTRACT, type UserUpvote, UserUpvoteClient, type UserUpvoteClientOptions, type UserUpvoteNetMessage, type UserUpvoteReceived, buildUserUpvote, buildUserUpvoteReceived, calculatePriceFromSqrtPriceX96, calculatePriceInUsdc, calculateUpvoteCost, calculateUserTokenBalance, decodeStrategyMetadata, decodeUpvoteMessage, decodeUpvoteStorageBlob, discoverPools, discoverTokenPool, encodePoolKey, encodeUpvoteKey, extractStrategyAddress, extractTokenAddressesFromMessages, getWethAddress, isDynamicSplitStrategy, isPureAlphaStrategy, isStrategyMessage, isUniv234PoolsStrategy, isUserUpvoteMessage, parseUserUpvoteMessage, selectStrategy, tokenAddressToUpvoteKeyString, validateUpvoteParams, validateUserUpvoteMessage };
+export { ALL_STRATEGY_ADDRESSES, DYNAMIC_SPLIT_STRATEGY, DecodedStrategyMetadata, ERC20_BULK_INFO_HELPER_CONTRACT, GetAppKeyScoresOptions, GetStrategyKeyScoresOptions, type GetTokenRankingsOptions, GetUpvotesForItemsOptions, GetUpvotesOptions, LEGACY_UPVOTE_V1_ADDRESS, LEGACY_UPVOTE_V2_ADDRESS, MULTI_VERSION_UNISWAP_BULK_POOL_FINDER, MULTI_VERSION_UNISWAP_POOL_INFO_RETRIEVER, NULL_ADDRESS, PURE_ALPHA_STRATEGY, type ParsedUserUpvoteMessage, PoolDiscoveryPair, PoolDiscoveryResult, PoolKey, type RankedToken, type RankingSort, SCORE_CONTRACT, SUPPORTED_SCORE_CHAINS, ScoreClient, ScoreClientOptions, type TokenAddressExtraction, UNIV234_POOLS_STRATEGY, UPVOTE_APP, UPVOTE_PRICE_ETH, UPVOTE_STORAGE_APP, USER_UPVOTE_CONTRACT, type UserUpvote, UserUpvoteClient, type UserUpvoteClientOptions, type UserUpvoteNetMessage, type UserUpvoteReceived, buildUserUpvote, buildUserUpvoteReceived, calculatePriceFromSqrtPriceX96, calculatePriceInUsdc, calculateUpvoteCost, calculateUserTokenBalance, decodeStrategyMetadata, decodeUpvoteMessage, decodeUpvoteStorageBlob, discoverPools, discoverTokenPool, encodePoolKey, encodeUpvoteKey, extractStrategyAddress, extractTokenAddressesFromMessages, getTokenRankings, getWethAddress, isDynamicSplitStrategy, isPureAlphaStrategy, isStrategyMessage, isUniv234PoolsStrategy, isUserUpvoteMessage, parseUserUpvoteMessage, selectStrategy, tokenAddressToUpvoteKeyString, validateUpvoteParams, validateUserUpvoteMessage };