@net-protocol/score 0.1.9 → 0.1.11

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

@@ -409,6 +409,15 @@ declare const MULTI_VERSION_UNISWAP_POOL_INFO_RETRIEVER: {
  */
 declare function getWethAddress(chainId: number): Address;
 declare const NULL_ADDRESS: Address;
+type UniswapFactories = {
+    v2Factory: Address;
+    v3Factory: Address;
+    v4PoolManager: Address;
+};
+/**
+ * Get the Uniswap factory / pool-manager addresses for a given chain.
+ */
+declare function getUniswapFactories(chainId: number): UniswapFactories;
 declare const UPVOTE_PRICE_ETH = 0.000025;
 declare const USER_UPVOTE_CONTRACT: {
     readonly address: Address;
@@ -479,4 +488,4 @@ declare function buildUserUpvoteReceived(parsed: ParsedUserUpvoteMessage, upvote
     decimals: number;
 }): UserUpvoteReceived;
 
-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 };
+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, getUniswapFactories, getWethAddress, isDynamicSplitStrategy, isPureAlphaStrategy, isStrategyMessage, isUniv234PoolsStrategy, isUserUpvoteMessage, parseUserUpvoteMessage, selectStrategy, tokenAddressToUpvoteKeyString, validateUpvoteParams, validateUserUpvoteMessage };

package/dist/index.d.ts

@@ -409,6 +409,15 @@ declare const MULTI_VERSION_UNISWAP_POOL_INFO_RETRIEVER: {
  */
 declare function getWethAddress(chainId: number): Address;
 declare const NULL_ADDRESS: Address;
+type UniswapFactories = {
+    v2Factory: Address;
+    v3Factory: Address;
+    v4PoolManager: Address;
+};
+/**
+ * Get the Uniswap factory / pool-manager addresses for a given chain.
+ */
+declare function getUniswapFactories(chainId: number): UniswapFactories;
 declare const UPVOTE_PRICE_ETH = 0.000025;
 declare const USER_UPVOTE_CONTRACT: {
     readonly address: Address;
@@ -479,4 +488,4 @@ declare function buildUserUpvoteReceived(parsed: ParsedUserUpvoteMessage, upvote
     decimals: number;
 }): UserUpvoteReceived;
 
-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 };
+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, getUniswapFactories, getWethAddress, isDynamicSplitStrategy, isPureAlphaStrategy, isStrategyMessage, isUniv234PoolsStrategy, isUserUpvoteMessage, parseUserUpvoteMessage, selectStrategy, tokenAddressToUpvoteKeyString, validateUpvoteParams, validateUserUpvoteMessage };

package/dist/index.js

@@ -1659,27 +1659,6 @@ var dynamic_split_strategy_default = [
 
 // src/abis/multi-version-uniswap-bulk-pool-finder.json
 var multi_version_uniswap_bulk_pool_finder_default = [
-  {
-    type: "function",
-    name: "V2_FACTORY",
-    inputs: [],
-    outputs: [{ name: "", type: "address", internalType: "address" }],
-    stateMutability: "view"
-  },
-  {
-    type: "function",
-    name: "V3_FACTORY",
-    inputs: [],
-    outputs: [{ name: "", type: "address", internalType: "address" }],
-    stateMutability: "view"
-  },
-  {
-    type: "function",
-    name: "V4_POOL_MANAGER",
-    inputs: [],
-    outputs: [{ name: "", type: "address", internalType: "address" }],
-    stateMutability: "view"
-  },
   {
     type: "function",
     name: "_checkV4PoolExternal",
@@ -1699,17 +1678,36 @@ var multi_version_uniswap_bulk_pool_finder_default = [
             type: "address",
             internalType: "Currency"
           },
-          { name: "fee", type: "uint24", internalType: "uint24" },
-          { name: "tickSpacing", type: "int24", internalType: "int24" },
+          {
+            name: "fee",
+            type: "uint24",
+            internalType: "uint24"
+          },
+          {
+            name: "tickSpacing",
+            type: "int24",
+            internalType: "int24"
+          },
           {
             name: "hooks",
             type: "address",
             internalType: "contract IHooks"
           }
         ]
+      },
+      {
+        name: "poolManager",
+        type: "address",
+        internalType: "address"
+      }
+    ],
+    outputs: [
+      {
+        name: "exists",
+        type: "bool",
+        internalType: "bool"
       }
     ],
-    outputs: [{ name: "exists", type: "bool", internalType: "bool" }],
     stateMutability: "view"
   },
   {
@@ -1731,7 +1729,11 @@ var multi_version_uniswap_bulk_pool_finder_default = [
             type: "address[]",
             internalType: "address[]"
           },
-          { name: "fees", type: "uint24[]", internalType: "uint24[]" },
+          {
+            name: "fees",
+            type: "uint24[]",
+            internalType: "uint24[]"
+          },
           {
             name: "v4TickSpacings",
             type: "int24[]",
@@ -1741,6 +1743,21 @@ var multi_version_uniswap_bulk_pool_finder_default = [
             name: "v4Hooks",
             type: "address[]",
             internalType: "address[]"
+          },
+          {
+            name: "v2Factory",
+            type: "address",
+            internalType: "address"
+          },
+          {
+            name: "v3Factory",
+            type: "address",
+            internalType: "address"
+          },
+          {
+            name: "v4PoolManager",
+            type: "address",
+            internalType: "address"
           }
         ]
       }
@@ -1756,7 +1773,11 @@ var multi_version_uniswap_bulk_pool_finder_default = [
             type: "uint256",
             internalType: "uint256"
           },
-          { name: "version", type: "uint8", internalType: "uint8" },
+          {
+            name: "version",
+            type: "uint8",
+            internalType: "uint8"
+          },
           {
             name: "poolAddress",
             type: "address",
@@ -1777,7 +1798,11 @@ var multi_version_uniswap_bulk_pool_finder_default = [
                 type: "address",
                 internalType: "Currency"
               },
-              { name: "fee", type: "uint24", internalType: "uint24" },
+              {
+                name: "fee",
+                type: "uint24",
+                internalType: "uint24"
+              },
               {
                 name: "tickSpacing",
                 type: "int24",
@@ -1790,12 +1815,28 @@ var multi_version_uniswap_bulk_pool_finder_default = [
               }
             ]
           },
-          { name: "fee", type: "uint24", internalType: "uint24" },
-          { name: "tickSpacing", type: "int24", internalType: "int24" },
-          { name: "hooks", type: "address", internalType: "address" }
+          {
+            name: "fee",
+            type: "uint24",
+            internalType: "uint24"
+          },
+          {
+            name: "tickSpacing",
+            type: "int24",
+            internalType: "int24"
+          },
+          {
+            name: "hooks",
+            type: "address",
+            internalType: "address"
+          }
         ]
       },
-      { name: "count", type: "uint256", internalType: "uint256" }
+      {
+        name: "count",
+        type: "uint256",
+        internalType: "uint256"
+      }
     ],
     stateMutability: "view"
   }
@@ -2556,7 +2597,7 @@ var LEGACY_UPVOTE_V1_ADDRESS = "0x0ada882dbbdc12388a1f9ca85d2d847088f747df";
 var LEGACY_UPVOTE_V2_ADDRESS = "0x9027dcad0a3dca5835895e14fbc022a1e5ea909b";
 var SUPPORTED_SCORE_CHAINS = [8453];
 var MULTI_VERSION_UNISWAP_BULK_POOL_FINDER = {
-  address: "0xbc237dac4c74c170780fc12f353a258bdd31a8cf",
+  address: "0x88A51f8d3B1f222394075E086e33108BC9ceDfB6",
   abi: multi_version_uniswap_bulk_pool_finder_default
 };
 var MULTI_VERSION_UNISWAP_POOL_INFO_RETRIEVER = {
@@ -2566,8 +2607,10 @@ var MULTI_VERSION_UNISWAP_POOL_INFO_RETRIEVER = {
 var WETH_BY_CHAIN = {
   8453: "0x4200000000000000000000000000000000000006",
   // Base (L2 predeploy)
-  1: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
+  1: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
   // Ethereum mainnet
+  4663: "0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73"
+  // Robinhood Chain (non-standard WETH; not the OP predeploy)
 };
 function getWethAddress(chainId) {
   const addr = WETH_BY_CHAIN[chainId];
@@ -2577,6 +2620,33 @@ function getWethAddress(chainId) {
   return addr;
 }
 var NULL_ADDRESS = "0x0000000000000000000000000000000000000000";
+var UNISWAP_FACTORIES_BY_CHAIN = {
+  8453: {
+    // Base
+    v2Factory: "0x8909Dc15e40173Ff4699343b6eB8132c65e18eC6",
+    v3Factory: "0x33128a8fC17869897dcE68Ed026d694621f6FDfD",
+    v4PoolManager: "0x498581fF718922c3f8e6A244956aF099B2652b2b"
+  },
+  1: {
+    // Ethereum mainnet
+    v2Factory: "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f",
+    v3Factory: "0x1F98431c8aD98523631AE4a59f267346ea31F984",
+    v4PoolManager: "0x000000000004444c5dc75cB358380D2e3dE08A90"
+  },
+  4663: {
+    // Robinhood Chain — Uniswap V3 only, at a non-canonical factory address.
+    v2Factory: NULL_ADDRESS,
+    v3Factory: "0x1f7d7550B1b028f7571E69A784071F0205FD2EfA",
+    v4PoolManager: NULL_ADDRESS
+  }
+};
+function getUniswapFactories(chainId) {
+  const factories = UNISWAP_FACTORIES_BY_CHAIN[chainId];
+  if (!factories) {
+    throw new Error(`Score: No Uniswap factories for chain ${chainId}`);
+  }
+  return factories;
+}
 var UPVOTE_PRICE_ETH = 25e-6;
 var USER_UPVOTE_CONTRACT = {
   address: "0xa4bc2c63dd0157692fd5f409389e5032e37d8895",
@@ -3292,13 +3362,16 @@ function normalizeTokenPairs(pairs, wethAddress) {
     };
   });
 }
-function buildDiscoveryArgs(normalizedPairs) {
+function buildDiscoveryArgs(normalizedPairs, factories) {
   return {
     tokenAs: normalizedPairs.map((p) => p.tokenA),
     tokenBs: normalizedPairs.map((p) => p.tokenB),
     fees: V3_V4_FEE_TIERS,
     v4TickSpacings: V4_TICK_SPACINGS,
-    v4Hooks: V4_HOOKS
+    v4Hooks: V4_HOOKS,
+    v2Factory: factories.v2Factory,
+    v3Factory: factories.v3Factory,
+    v4PoolManager: factories.v4PoolManager
   };
 }
 function parsePoolDiscoveries(poolResults, pairs, wethAddress) {
@@ -3512,8 +3585,9 @@ async function discoverPools({
 }) {
   if (pairs.length === 0) return [];
   const wethAddress = getWethAddress(chainId);
+  const factories = getUniswapFactories(chainId);
   const normalizedPairs = normalizeTokenPairs(pairs, wethAddress);
-  const discoveryArgs = buildDiscoveryArgs(normalizedPairs);
+  const discoveryArgs = buildDiscoveryArgs(normalizedPairs, factories);
   const poolResults = await actions.readContract(publicClient, {
     address: MULTI_VERSION_UNISWAP_BULK_POOL_FINDER.address,
     abi: MULTI_VERSION_UNISWAP_BULK_POOL_FINDER.abi,
@@ -4071,6 +4145,7 @@ exports.getStorageScoreKey = getStorageScoreKey;
 exports.getStorageUpvoteContext = getStorageUpvoteContext;
 exports.getTokenRankings = getTokenRankings;
 exports.getTokenScoreKey = getTokenScoreKey;
+exports.getUniswapFactories = getUniswapFactories;
 exports.getWethAddress = getWethAddress;
 exports.isDynamicSplitStrategy = isDynamicSplitStrategy;
 exports.isPureAlphaStrategy = isPureAlphaStrategy;