@net-protocol/score 0.1.0

package/dist/react.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/abis/upvote-app.json","../src/constants.ts","../src/hooks/useUpvotes.ts","../src/utils/strategyUtils.ts","../src/utils/scoreKeyUtils.ts","../src/hooks/useUpvotesBatch.ts","../src/hooks/useTokenUpvotes.ts"],"names":["useReadContract","useMemo"],"mappings":"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","file":"react.mjs","sourcesContent":["[\n  { \"type\": \"constructor\", \"inputs\": [], \"stateMutability\": \"nonpayable\" },\n  {\n    \"type\": \"function\",\n    \"name\": \"CORE_CONTRACT\",\n    \"inputs\": [],\n    \"outputs\": [\n      { \"name\": \"\", \"type\": \"address\", \"internalType\": \"contract Score\" }\n    ],\n    \"stateMutability\": \"view\"\n  },\n  {\n    \"type\": \"function\",\n    \"name\": \"LEGACY_CONTRACT\",\n    \"inputs\": [],\n    \"outputs\": [\n      {\n        \"name\": \"\",\n        \"type\": \"address\",\n        \"internalType\": \"contract ILegacyUpvoteContract\"\n      }\n    ],\n    \"stateMutability\": \"view\"\n  },\n  {\n    \"type\": \"function\",\n    \"name\": \"getUpvotesWithLegacy\",\n    \"inputs\": [\n      {\n        \"name\": \"upvoteKeys\",\n        \"type\": \"bytes32[]\",\n        \"internalType\": \"bytes32[]\"\n      },\n      {\n        \"name\": \"strategies\",\n        \"type\": \"address[]\",\n        \"internalType\": \"address[]\"\n      }\n    ],\n    \"outputs\": [\n      { \"name\": \"counts\", \"type\": \"uint256[]\", \"internalType\": \"uint256[]\" }\n    ],\n    \"stateMutability\": \"view\"\n  },\n  {\n    \"type\": \"function\",\n    \"name\": \"name\",\n    \"inputs\": [],\n    \"outputs\": [{ \"name\": \"\", \"type\": \"string\", \"internalType\": \"string\" }],\n    \"stateMutability\": \"pure\"\n  },\n  {\n    \"type\": \"function\",\n    \"name\": \"owner\",\n    \"inputs\": [],\n    \"outputs\": [{ \"name\": \"\", \"type\": \"address\", \"internalType\": \"address\" }],\n    \"stateMutability\": \"view\"\n  },\n  {\n    \"type\": \"function\",\n    \"name\": \"renounceOwnership\",\n    \"inputs\": [],\n    \"outputs\": [],\n    \"stateMutability\": \"nonpayable\"\n  },\n  {\n    \"type\": \"function\",\n    \"name\": \"transferOwnership\",\n    \"inputs\": [\n      { \"name\": \"newOwner\", \"type\": \"address\", \"internalType\": \"address\" }\n    ],\n    \"outputs\": [],\n    \"stateMutability\": \"nonpayable\"\n  },\n  {\n    \"type\": \"function\",\n    \"name\": \"upvote\",\n    \"inputs\": [\n      {\n        \"name\": \"strategy\",\n        \"type\": \"address\",\n        \"internalType\": \"contract IScoreStrategy\"\n      },\n      { \"name\": \"scoreKey\", \"type\": \"bytes32\", \"internalType\": \"bytes32\" },\n      { \"name\": \"scoreDelta\", \"type\": \"uint256\", \"internalType\": \"uint256\" },\n      {\n        \"name\": \"scoreStoredContext\",\n        \"type\": \"bytes\",\n        \"internalType\": \"bytes\"\n      },\n      {\n        \"name\": \"scoreUnstoredContext\",\n        \"type\": \"bytes\",\n        \"internalType\": \"bytes\"\n      }\n    ],\n    \"outputs\": [],\n    \"stateMutability\": \"payable\"\n  },\n  {\n    \"type\": \"function\",\n    \"name\": \"withdrawETH\",\n    \"inputs\": [{ \"name\": \"to\", \"type\": \"address\", \"internalType\": \"address\" }],\n    \"outputs\": [],\n    \"stateMutability\": \"nonpayable\"\n  },\n  {\n    \"type\": \"function\",\n    \"name\": \"withdrawErc20\",\n    \"inputs\": [\n      { \"name\": \"to\", \"type\": \"address\", \"internalType\": \"address\" },\n      { \"name\": \"token\", \"type\": \"address\", \"internalType\": \"address\" },\n      { \"name\": \"amount\", \"type\": \"uint256\", \"internalType\": \"uint256\" }\n    ],\n    \"outputs\": [],\n    \"stateMutability\": \"nonpayable\"\n  },\n  {\n    \"type\": \"event\",\n    \"name\": \"OwnershipTransferred\",\n    \"inputs\": [\n      {\n        \"name\": \"previousOwner\",\n        \"type\": \"address\",\n        \"indexed\": true,\n        \"internalType\": \"address\"\n      },\n      {\n        \"name\": \"newOwner\",\n        \"type\": \"address\",\n        \"indexed\": true,\n        \"internalType\": \"address\"\n      }\n    ],\n    \"anonymous\": false\n  },\n  {\n    \"type\": \"error\",\n    \"name\": \"OwnableInvalidOwner\",\n    \"inputs\": [\n      { \"name\": \"owner\", \"type\": \"address\", \"internalType\": \"address\" }\n    ]\n  },\n  {\n    \"type\": \"error\",\n    \"name\": \"OwnableUnauthorizedAccount\",\n    \"inputs\": [\n      { \"name\": \"account\", \"type\": \"address\", \"internalType\": \"address\" }\n    ]\n  },\n  { \"type\": \"error\", \"name\": \"WithdrawFailed\", \"inputs\": [] }\n]\n","import type { Abi, Address } from \"viem\";\nimport scoreAbi from \"./abis/score.json\";\nimport upvoteAppAbi from \"./abis/upvote-app.json\";\nimport upvoteStorageAppAbi from \"./abis/upvote-storage-app.json\";\nimport pureAlphaStrategyAbi from \"./abis/pure-alpha-strategy.json\";\nimport univ234PoolsStrategyAbi from \"./abis/univ234-pools-strategy.json\";\nimport dynamicSplitStrategyAbi from \"./abis/dynamic-split-strategy.json\";\n\n// Score core contract (v2 strategy)\nexport const SCORE_CONTRACT = {\n  address: \"0x0000000fa09b022e5616e5a173b4b67fa2fbcf28\" as Address,\n  abi: scoreAbi as Abi,\n} as const;\n\n// UpvoteApp contract\nexport const UPVOTE_APP = {\n  address: \"0x00000001f0b8173316a016a5067ad74e8cea47bf\" as Address,\n  abi: upvoteAppAbi as Abi,\n} as const;\n\n// UpvoteStorageApp contract\nexport const UPVOTE_STORAGE_APP = {\n  address: \"0x000000060CEB69D023227DF64CfB75eC37c75B62\" as Address,\n  abi: upvoteStorageAppAbi as Abi,\n} as const;\n\n// UpvotePureAlphaStrategy contract\nexport const PURE_ALPHA_STRATEGY = {\n  address: \"0x00000001b1bcdeddeafd5296aaf4f3f3e21ae876\" as Address,\n  abi: pureAlphaStrategyAbi as Abi,\n} as const;\n\n// UpvoteUniv234PoolsStrategy (handles Uniswap V2, V3, V4 pools)\nexport const UNIV234_POOLS_STRATEGY = {\n  address: \"0x000000063f84e07a3e7a7ee578b42704ee6d22c9\" as Address,\n  abi: univ234PoolsStrategyAbi as Abi,\n} as const;\n\n// UpvoteDynamicSplitUniv234PoolsStrategy (configurable token/alpha split for Uni V2/V3/V4 pools)\nexport const DYNAMIC_SPLIT_STRATEGY = {\n  address: \"0x0000000869160f0b2a213adefb46a7ea7e62ac7a\" as Address,\n  abi: dynamicSplitStrategyAbi as Abi,\n} as const;\n\n// All strategy addresses for batch queries\nexport const ALL_STRATEGY_ADDRESSES: Address[] = [\n  UNIV234_POOLS_STRATEGY.address,\n  PURE_ALPHA_STRATEGY.address,\n  DYNAMIC_SPLIT_STRATEGY.address,\n];\n\n// Legacy upvote contract addresses (v1 and v2, before Score system)\nexport const LEGACY_UPVOTE_V1_ADDRESS =\n  \"0x0ada882dbbdc12388a1f9ca85d2d847088f747df\" as Address;\n\nexport const LEGACY_UPVOTE_V2_ADDRESS =\n  \"0x9027dcad0a3dca5835895e14fbc022a1e5ea909b\" as Address;\n\n// Chains where the Score system is deployed\nexport const SUPPORTED_SCORE_CHAINS = [8453] as const;\n","import { useReadContract } from \"wagmi\";\nimport { UPVOTE_APP, ALL_STRATEGY_ADDRESSES } from \"../constants\";\nimport type { UseUpvotesOptions } from \"../types\";\n\n/**\n * React hook for fetching the upvote count for a single score key.\n * Uses UpvoteApp.getUpvotesWithLegacy, which aggregates across legacy contracts and strategies.\n *\n * @param options - Upvote query options\n * @param options.chainId - Chain ID to query\n * @param options.scoreKey - The bytes32 score key to look up\n * @param options.strategies - Strategy addresses to include (default: all strategies)\n * @param options.enabled - Whether the query is enabled (default: true)\n * @returns Object with upvotes count, isLoading, error, and refetch\n *\n * @example\n * ```tsx\n * const { upvotes, isLoading } = useUpvotes({\n *   chainId: 8453,\n *   scoreKey: getTokenScoreKey(tokenAddress),\n * });\n * ```\n */\nexport function useUpvotes({\n  chainId,\n  scoreKey,\n  strategies = ALL_STRATEGY_ADDRESSES,\n  enabled = true,\n}: UseUpvotesOptions) {\n  const { data, isLoading, error, refetch } = useReadContract({\n    address: UPVOTE_APP.address,\n    abi: UPVOTE_APP.abi,\n    functionName: \"getUpvotesWithLegacy\",\n    args: [[scoreKey], strategies],\n    chainId,\n    query: { enabled },\n  });\n\n  return {\n    upvotes: Array.isArray(data) && data.length > 0 ? Number(data[0]) : 0,\n    isLoading,\n    error,\n    refetch,\n  };\n}\n","import { decodeAbiParameters, type Address } from \"viem\";\nimport {\n  PURE_ALPHA_STRATEGY,\n  UNIV234_POOLS_STRATEGY,\n  DYNAMIC_SPLIT_STRATEGY,\n} from \"../constants\";\nimport type {\n  PureAlphaMetadata,\n  PoolStrategyMetadata,\n  DecodedStrategyMetadata,\n  PoolKey,\n} from \"../types\";\n\n/**\n * Convert token address to bytes32 upvote key.\n */\nexport const encodeUpvoteKey = (tokenAddress: string): `0x${string}` => {\n  return `0x${BigInt(`0x${tokenAddress.slice(2)}`)\n    .toString(16)\n    .padStart(64, \"0\")}`;\n};\n\n/**\n * Convert token address to upvote key string format.\n * Strips leading zeros to match Solidity's Strings.toHexString(uint256(scoreKey)).\n */\nexport function tokenAddressToUpvoteKeyString(tokenAddress: string): string {\n  const lower = tokenAddress.toLowerCase();\n  const withoutPrefix = lower.slice(2);\n  const stripped = withoutPrefix.replace(/^0+/, \"\") || \"0\";\n  return \"0x\" + stripped;\n}\n\n/**\n * Check if a topic string represents a strategy message.\n */\nexport function isStrategyMessage(topic: string): boolean {\n  return topic.startsWith(\"s\") && topic.length > 43;\n}\n\n/**\n * Check if a topic string represents a user upvote message.\n */\nexport function isUserUpvoteMessage(topic: string): boolean {\n  return topic.startsWith(\"t\");\n}\n\n/**\n * Extracts strategy address from topic string.\n * Handles both new format and legacy format.\n */\nexport function extractStrategyAddress(topic: string): string {\n  try {\n    if (topic.startsWith(\"t\")) {\n      return topic.slice(1);\n    }\n\n    if (topic.startsWith(\"s\")) {\n      return topic.slice(1, 43);\n    }\n\n    if (topic.startsWith(\"t-\")) {\n      return topic.slice(2);\n    }\n\n    const parts = topic.split(\"-\");\n    if (parts.length >= 2) {\n      return parts[0];\n    }\n\n    return \"\";\n  } catch {\n    return \"\";\n  }\n}\n\nexport function isPureAlphaStrategy(strategyAddress: string): boolean {\n  return (\n    strategyAddress.toLowerCase() ===\n    PURE_ALPHA_STRATEGY.address.toLowerCase()\n  );\n}\n\nexport function isUniv234PoolsStrategy(strategyAddress: string): boolean {\n  return (\n    strategyAddress.toLowerCase() ===\n    UNIV234_POOLS_STRATEGY.address.toLowerCase()\n  );\n}\n\nexport function isDynamicSplitStrategy(strategyAddress: string): boolean {\n  return (\n    strategyAddress.toLowerCase() ===\n    DYNAMIC_SPLIT_STRATEGY.address.toLowerCase()\n  );\n}\n\n/**\n * Decode strategy-specific metadata from ABI-encoded bytes.\n */\nexport const decodeStrategyMetadata = (\n  metadata: `0x${string}`,\n  strategyAddress: string\n): DecodedStrategyMetadata => {\n  try {\n    if (isPureAlphaStrategy(strategyAddress)) {\n      const [alphaAmount, alphaWethPrice, wethUsdcPrice, userAlphaBalance] =\n        decodeAbiParameters(\n          [\n            { type: \"uint256\" },\n            { type: \"uint256\" },\n            { type: \"uint256\" },\n            { type: \"uint256\" },\n          ],\n          metadata\n        );\n      return {\n        alphaAmount,\n        alphaWethPrice,\n        wethUsdcPrice,\n        userAlphaBalance,\n      } as PureAlphaMetadata;\n    } else if (\n      isUniv234PoolsStrategy(strategyAddress) ||\n      isDynamicSplitStrategy(strategyAddress)\n    ) {\n      const [\n        tokenAmount,\n        tokenWethPrice,\n        wethUsdcPrice,\n        alphaWethPrice,\n        userTokenBalance,\n      ] = decodeAbiParameters(\n        [\n          { type: \"uint256\" },\n          { type: \"uint256\" },\n          { type: \"uint256\" },\n          { type: \"uint256\" },\n          { type: \"uint256\" },\n        ],\n        metadata\n      );\n      return {\n        tokenAmount,\n        tokenWethPrice,\n        wethUsdcPrice,\n        alphaWethPrice,\n        userTokenBalance,\n      } as PoolStrategyMetadata;\n    } else {\n      return null;\n    }\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Decode the full Score storage blob.\n */\nexport const decodeUpvoteStorageBlob = (value: `0x${string}`) => {\n  try {\n    const [\n      scoreKey,\n      scoreDelta,\n      originalSender,\n      appAddress,\n      strategyAddress,\n      timestamp,\n      scoreStoredContext,\n      scoreUnstoredContext,\n      metadata,\n    ] = decodeAbiParameters(\n      [\n        { type: \"bytes32\" },\n        { type: \"int256\" },\n        { type: \"address\" },\n        { type: \"address\" },\n        { type: \"address\" },\n        { type: \"uint256\" },\n        { type: \"bytes\" },\n        { type: \"bytes\" },\n        { type: \"bytes\" },\n      ],\n      value\n    );\n\n    const decodedMetadata = decodeStrategyMetadata(\n      metadata as `0x${string}`,\n      strategyAddress as string\n    );\n\n    return {\n      scoreKey: scoreKey as `0x${string}`,\n      scoreDelta: Number(scoreDelta),\n      originalSender: originalSender as Address,\n      appAddress: appAddress as Address,\n      strategyAddress: strategyAddress as Address,\n      timestamp: Number(timestamp),\n      scoreStoredContext: scoreStoredContext as `0x${string}`,\n      scoreUnstoredContext: scoreUnstoredContext as `0x${string}`,\n      decodedMetadata,\n    };\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Select the appropriate strategy based on pool key validity.\n * Returns PURE_ALPHA if no valid pool key; DYNAMIC_SPLIT otherwise.\n */\nexport const selectStrategy = (poolKey?: PoolKey | null): Address => {\n  if (!poolKey || !isValidPoolKey(poolKey)) {\n    return PURE_ALPHA_STRATEGY.address;\n  }\n  return DYNAMIC_SPLIT_STRATEGY.address;\n};\n\nfunction isValidPoolKey(poolKey: PoolKey): boolean {\n  return (\n    poolKey.fee !== undefined ||\n    poolKey.tickSpacing !== undefined ||\n    poolKey.currency0 !== undefined\n  );\n}\n\n/**\n * Decode an upvote message from Net protocol into a consistent format.\n * Handles both legacy and strategy message formats.\n */\nexport function decodeUpvoteMessage(msg: {\n  topic: string;\n  data: `0x${string}`;\n  text: string;\n}) {\n  try {\n    if (msg.topic === \"t\") {\n      if (!msg.data || msg.data === \"0x\" || msg.data.length < 32) {\n        return null;\n      }\n\n      try {\n        const [\n          numUpvotesDecoded,\n          tokenWethPrice,\n          wethUsdcPrice,\n          alphaWethPrice,\n          userTokenBalance,\n        ] = decodeAbiParameters(\n          [\n            { type: \"uint256\" },\n            { type: \"uint256\" },\n            { type: \"uint256\" },\n            { type: \"uint256\" },\n            { type: \"uint256\" },\n          ],\n          msg.data\n        );\n\n        return {\n          scoreDelta: Number(numUpvotesDecoded),\n          tokenWethPrice: Number(tokenWethPrice),\n          wethUsdcPrice: Number(wethUsdcPrice),\n          alphaWethPrice: Number(alphaWethPrice),\n          userTokenBalance: Number(userTokenBalance),\n          tokenAddress: msg.text,\n          messageType: \"legacy\" as const,\n        };\n      } catch {\n        return null;\n      }\n    } else if (\n      (msg.topic.startsWith(\"0x\") && msg.topic.length === 42) ||\n      msg.topic.startsWith(\"p-\")\n    ) {\n      const [\n        numUpvotesDecoded,\n        tokenWethPrice,\n        wethUsdcPrice,\n        alphaWethPrice,\n        userTokenBalance,\n      ] = decodeAbiParameters(\n        [\n          { type: \"uint256\" },\n          { type: \"uint256\" },\n          { type: \"uint256\" },\n          { type: \"uint256\" },\n          { type: \"uint256\" },\n        ],\n        msg.data\n      );\n\n      return {\n        scoreDelta: Number(numUpvotesDecoded),\n        tokenWethPrice: Number(tokenWethPrice),\n        wethUsdcPrice: Number(wethUsdcPrice),\n        alphaWethPrice: Number(alphaWethPrice),\n        userTokenBalance: Number(userTokenBalance),\n        tokenAddress: msg.topic,\n        messageType: \"legacy\" as const,\n      };\n    } else if (msg.topic.startsWith(\"app-\") && msg.topic.endsWith(\"-first\")) {\n      const topicParts = msg.topic.split(\"-\");\n\n      if (topicParts.length === 3) {\n        // \"app-{addr}-first\"\n        return {\n          appAddress: topicParts[1],\n          messageType: \"app-first\" as const,\n        };\n      } else if (topicParts.length === 5 && topicParts[2] === \"strategy\") {\n        // \"app-{addr}-strategy-{strat}-first\"\n        return {\n          appAddress: topicParts[1],\n          strategyAddress: topicParts[3],\n          messageType: \"app-strategy-first\" as const,\n        };\n      } else if (topicParts.length === 5 && topicParts[2] === \"user\") {\n        // \"app-{addr}-user-{user}-first\"\n        return {\n          appAddress: topicParts[1],\n          userAddress: topicParts[3],\n          tokenAddress: msg.text,\n          messageType: \"app-user-first\" as const,\n        };\n      } else if (\n        topicParts.length === 7 &&\n        topicParts[2] === \"strategy\" &&\n        topicParts[4] === \"user\"\n      ) {\n        // \"app-{addr}-strategy-{strat}-user-{user}-first\"\n        return {\n          appAddress: topicParts[1],\n          strategyAddress: topicParts[3],\n          userAddress: topicParts[5],\n          tokenAddress: msg.text,\n          messageType: \"app-strategy-user-first\" as const,\n        };\n      }\n    }\n\n    return null;\n  } catch {\n    return null;\n  }\n}\n","import {\n  type Address,\n  encodeAbiParameters,\n  keccak256,\n  encodePacked,\n  getAddress,\n} from \"viem\";\nimport { getStorageKeyBytes } from \"@net-protocol/storage\";\nimport { encodeUpvoteKey } from \"./strategyUtils\";\nimport type { ScoreItem, FeedMessage } from \"../types\";\n\n/**\n * Generate score key for token upvotes.\n * Pads the token address into a bytes32 value.\n */\nexport const getTokenScoreKey = (tokenAddress: string): `0x${string}` => {\n  return encodeUpvoteKey(tokenAddress);\n};\n\n/**\n * Generate score key for storage upvotes.\n * keccak256(encodePacked(storageKeyBytes32, operatorAddress))\n */\nexport const getStorageScoreKey = (\n  operatorAddress: string,\n  storageKey: string\n): `0x${string}` => {\n  const bytes32Key = getStorageKeyBytes(storageKey) as `0x${string}`;\n  return keccak256(\n    encodePacked(\n      [\"bytes32\", \"address\"],\n      [bytes32Key, operatorAddress as Address]\n    )\n  );\n};\n\n/**\n * Generate content-based key for feed posts.\n * Uses all message content to create a unique identifier that's\n * independent of query filter (works regardless of how messages are fetched).\n *\n * Two messages with identical content will share the same key (and upvotes),\n * which is semantically correct - they are the same content.\n */\nexport const getFeedContentKey = (message: FeedMessage): `0x${string}` => {\n  return keccak256(\n    encodePacked(\n      [\"address\", \"string\", \"address\", \"uint256\", \"string\", \"bytes\"],\n      [\n        message.app,\n        message.topic,\n        message.sender,\n        message.timestamp,\n        message.text,\n        message.data,\n      ]\n    )\n  );\n};\n\n/**\n * Get score key for any ScoreItem type.\n */\nexport const getScoreKey = (item: ScoreItem): `0x${string}` => {\n  switch (item.type) {\n    case \"token\":\n      return getTokenScoreKey(item.tokenAddress);\n    case \"storage\":\n      return getStorageScoreKey(item.operatorAddress, item.storageKey);\n    case \"feed\": {\n      const contentKey = getFeedContentKey(item.message);\n      return getStorageScoreKey(\n        item.message.sender,\n        contentKey\n      );\n    }\n  }\n};\n\n/**\n * Check if a score key represents a token upvote (zero-padded address)\n * vs a hash-based key (storage/feed).\n */\nexport const isTokenScoreKey = (scoreKey: string): boolean => {\n  return scoreKey.startsWith(\"0x000000000000000000000000\");\n};\n\n/**\n * Extract and validate token address from a token score key.\n * Returns the checksummed address or null if invalid.\n */\nexport const extractTokenAddressFromScoreKey = (\n  scoreKey: string\n): string | null => {\n  if (!isTokenScoreKey(scoreKey)) {\n    return null;\n  }\n\n  const tokenAddress = `0x${scoreKey.slice(26)}`;\n\n  if (tokenAddress.startsWith(\"0x\") && tokenAddress.length === 42) {\n    try {\n      return getAddress(tokenAddress);\n    } catch {\n      return null;\n    }\n  }\n\n  return null;\n};\n\n/**\n * Generate upvote stored context for storage upvotes.\n * ABI-encodes (bytes32 storageKeyBytes, address operatorAddress).\n */\nexport const getStorageUpvoteContext = (\n  operatorAddress: string,\n  storageKey: string\n): `0x${string}` => {\n  const bytes32Key = getStorageKeyBytes(storageKey) as `0x${string}`;\n  return encodeAbiParameters(\n    [{ type: \"bytes32\" }, { type: \"address\" }],\n    [bytes32Key, operatorAddress as Address]\n  );\n};\n","import { useMemo } from \"react\";\nimport { useReadContract } from \"wagmi\";\nimport { UPVOTE_APP, ALL_STRATEGY_ADDRESSES } from \"../constants\";\nimport { getScoreKey } from \"../utils/scoreKeyUtils\";\nimport type { UseUpvotesBatchOptions } from \"../types\";\n\n/**\n * React hook for fetching upvote counts for multiple ScoreItems in a single contract call.\n * Uses UpvoteApp.getUpvotesWithLegacy with batched score keys.\n *\n * @param options - Batch upvote query options\n * @param options.chainId - Chain ID to query\n * @param options.items - Array of ScoreItems (token, storage, or feed) to get counts for\n * @param options.strategies - Strategy addresses to include (default: all strategies)\n * @param options.enabled - Whether the query is enabled (default: true)\n * @returns Object with upvoteCounts array, isLoading, error, and refetch\n *\n * @example\n * ```tsx\n * const { upvoteCounts, isLoading } = useUpvotesBatch({\n *   chainId: 8453,\n *   items: [\n *     { type: \"token\", tokenAddress: \"0x...\" },\n *     { type: \"storage\", operatorAddress: \"0x...\", storageKey: \"my-key\" },\n *   ],\n * });\n * ```\n */\nexport function useUpvotesBatch({\n  chainId,\n  items,\n  strategies = ALL_STRATEGY_ADDRESSES,\n  enabled = true,\n}: UseUpvotesBatchOptions) {\n  const scoreKeys = useMemo(\n    () => items.map((item) => getScoreKey(item)),\n    [items]\n  );\n\n  const { data, isLoading, error, refetch } = useReadContract({\n    address: UPVOTE_APP.address,\n    abi: UPVOTE_APP.abi,\n    functionName: \"getUpvotesWithLegacy\",\n    args: [scoreKeys, strategies],\n    chainId,\n    query: { enabled: enabled && scoreKeys.length > 0 },\n  });\n\n  return {\n    upvoteCounts: Array.isArray(data) ? (data as bigint[]).map(Number) : [],\n    isLoading,\n    error,\n    refetch,\n  };\n}\n","import { useMemo } from \"react\";\nimport { useUpvotes } from \"./useUpvotes\";\nimport { getTokenScoreKey } from \"../utils/scoreKeyUtils\";\nimport type { UseTokenUpvotesOptions } from \"../types\";\n\n/**\n * Convenience React hook for fetching upvotes for a single token address.\n * Wraps useUpvotes with automatic token score key generation.\n *\n * @param options - Token upvote query options\n * @param options.chainId - Chain ID to query\n * @param options.tokenAddress - The token contract address\n * @param options.enabled - Whether the query is enabled (default: true)\n * @returns Object with upvotes count, isLoading, error, and refetch\n *\n * @example\n * ```tsx\n * const { upvotes, isLoading } = useTokenUpvotes({\n *   chainId: 8453,\n *   tokenAddress: \"0x...\",\n * });\n * ```\n */\nexport function useTokenUpvotes({\n  chainId,\n  tokenAddress,\n  enabled = true,\n}: UseTokenUpvotesOptions) {\n  const scoreKey = useMemo(\n    () => getTokenScoreKey(tokenAddress),\n    [tokenAddress]\n  );\n\n  return useUpvotes({ chainId, scoreKey, enabled });\n}\n"]}

package/dist/scoreKeyUtils-DIjbizO-.d.mts

@@ -0,0 +1,135 @@
+import { Address } from 'viem';
+
+type ScoreItem = {
+    type: "token";
+    tokenAddress: string;
+} | {
+    type: "storage";
+    operatorAddress: string;
+    storageKey: string;
+} | {
+    type: "feed";
+    message: FeedMessage;
+};
+type FeedMessage = {
+    app: Address;
+    sender: Address;
+    timestamp: bigint;
+    data: `0x${string}`;
+    text: string;
+    topic: string;
+};
+type PoolKey = {
+    currency0: string;
+    currency1: string;
+    fee: number;
+    tickSpacing: number;
+    hooks: string;
+};
+type PureAlphaMetadata = {
+    alphaAmount: bigint;
+    alphaWethPrice: bigint;
+    wethUsdcPrice: bigint;
+    userAlphaBalance: bigint;
+};
+type PoolStrategyMetadata = {
+    tokenAmount: bigint;
+    tokenWethPrice: bigint;
+    wethUsdcPrice: bigint;
+    alphaWethPrice: bigint;
+    userTokenBalance: bigint;
+};
+type DecodedStrategyMetadata = PureAlphaMetadata | PoolStrategyMetadata | null;
+type DecodedUpvoteBlob = {
+    scoreKey: `0x${string}`;
+    scoreDelta: number;
+    originalSender: Address;
+    appAddress: Address;
+    strategyAddress: Address;
+    timestamp: number;
+    scoreStoredContext: `0x${string}`;
+    scoreUnstoredContext: `0x${string}`;
+    decodedMetadata: DecodedStrategyMetadata;
+} | null;
+type ScoreClientOptions = {
+    chainId: number;
+    overrides?: {
+        scoreAddress?: Address;
+        upvoteAppAddress?: Address;
+        rpcUrls?: string[];
+    };
+};
+type GetUpvotesOptions = {
+    scoreKeys: `0x${string}`[];
+    strategies?: Address[];
+};
+type GetUpvotesForItemsOptions = {
+    items: ScoreItem[];
+    strategies?: Address[];
+};
+type GetStrategyKeyScoresOptions = {
+    strategy: Address;
+    scoreKeys: `0x${string}`[];
+};
+type GetAppKeyScoresOptions = {
+    app: Address;
+    scoreKeys: `0x${string}`[];
+};
+type UseUpvotesOptions = {
+    chainId: number;
+    scoreKey: `0x${string}`;
+    strategies?: Address[];
+    enabled?: boolean;
+};
+type UseUpvotesBatchOptions = {
+    chainId: number;
+    items: ScoreItem[];
+    strategies?: Address[];
+    enabled?: boolean;
+};
+type UseTokenUpvotesOptions = {
+    chainId: number;
+    tokenAddress: string;
+    enabled?: boolean;
+};
+
+/**
+ * Generate score key for token upvotes.
+ * Pads the token address into a bytes32 value.
+ */
+declare const getTokenScoreKey: (tokenAddress: string) => `0x${string}`;
+/**
+ * Generate score key for storage upvotes.
+ * keccak256(encodePacked(storageKeyBytes32, operatorAddress))
+ */
+declare const getStorageScoreKey: (operatorAddress: string, storageKey: string) => `0x${string}`;
+/**
+ * Generate content-based key for feed posts.
+ * Uses all message content to create a unique identifier that's
+ * independent of query filter (works regardless of how messages are fetched).
+ *
+ * Two messages with identical content will share the same key (and upvotes),
+ * which is semantically correct - they are the same content.
+ */
+declare const getFeedContentKey: (message: FeedMessage) => `0x${string}`;
+/**
+ * Get score key for any ScoreItem type.
+ */
+declare const getScoreKey: (item: ScoreItem) => `0x${string}`;
+/**
+ * Check if a score key represents a token upvote (zero-padded address)
+ * vs a hash-based key (storage/feed).
+ */
+declare const isTokenScoreKey: (scoreKey: string) => boolean;
+/**
+ * Extract and validate token address from a token score key.
+ * Returns the checksummed address or null if invalid.
+ */
+declare const extractTokenAddressFromScoreKey: (scoreKey: string) => string | null;
+/**
+ * Generate upvote stored context for storage upvotes.
+ * ABI-encodes (bytes32 storageKeyBytes, address operatorAddress).
+ */
+declare const getStorageUpvoteContext: (operatorAddress: string, storageKey: string) => `0x${string}`;
+
+export { type DecodedStrategyMetadata as D, type FeedMessage as F, type GetUpvotesOptions as G, type PoolKey as P, type ScoreClientOptions as S, type UseUpvotesOptions as U, type GetUpvotesForItemsOptions as a, type GetStrategyKeyScoresOptions as b, type GetAppKeyScoresOptions as c, getStorageScoreKey as d, getFeedContentKey as e, getScoreKey as f, getTokenScoreKey as g, extractTokenAddressFromScoreKey as h, isTokenScoreKey as i, getStorageUpvoteContext as j, type ScoreItem as k, type PureAlphaMetadata as l, type PoolStrategyMetadata as m, type DecodedUpvoteBlob as n, type UseUpvotesBatchOptions as o, type UseTokenUpvotesOptions as p };

package/dist/scoreKeyUtils-DIjbizO-.d.ts

@@ -0,0 +1,135 @@
+import { Address } from 'viem';
+
+type ScoreItem = {
+    type: "token";
+    tokenAddress: string;
+} | {
+    type: "storage";
+    operatorAddress: string;
+    storageKey: string;
+} | {
+    type: "feed";
+    message: FeedMessage;
+};
+type FeedMessage = {
+    app: Address;
+    sender: Address;
+    timestamp: bigint;
+    data: `0x${string}`;
+    text: string;
+    topic: string;
+};
+type PoolKey = {
+    currency0: string;
+    currency1: string;
+    fee: number;
+    tickSpacing: number;
+    hooks: string;
+};
+type PureAlphaMetadata = {
+    alphaAmount: bigint;
+    alphaWethPrice: bigint;
+    wethUsdcPrice: bigint;
+    userAlphaBalance: bigint;
+};
+type PoolStrategyMetadata = {
+    tokenAmount: bigint;
+    tokenWethPrice: bigint;
+    wethUsdcPrice: bigint;
+    alphaWethPrice: bigint;
+    userTokenBalance: bigint;
+};
+type DecodedStrategyMetadata = PureAlphaMetadata | PoolStrategyMetadata | null;
+type DecodedUpvoteBlob = {
+    scoreKey: `0x${string}`;
+    scoreDelta: number;
+    originalSender: Address;
+    appAddress: Address;
+    strategyAddress: Address;
+    timestamp: number;
+    scoreStoredContext: `0x${string}`;
+    scoreUnstoredContext: `0x${string}`;
+    decodedMetadata: DecodedStrategyMetadata;
+} | null;
+type ScoreClientOptions = {
+    chainId: number;
+    overrides?: {
+        scoreAddress?: Address;
+        upvoteAppAddress?: Address;
+        rpcUrls?: string[];
+    };
+};
+type GetUpvotesOptions = {
+    scoreKeys: `0x${string}`[];
+    strategies?: Address[];
+};
+type GetUpvotesForItemsOptions = {
+    items: ScoreItem[];
+    strategies?: Address[];
+};
+type GetStrategyKeyScoresOptions = {
+    strategy: Address;
+    scoreKeys: `0x${string}`[];
+};
+type GetAppKeyScoresOptions = {
+    app: Address;
+    scoreKeys: `0x${string}`[];
+};
+type UseUpvotesOptions = {
+    chainId: number;
+    scoreKey: `0x${string}`;
+    strategies?: Address[];
+    enabled?: boolean;
+};
+type UseUpvotesBatchOptions = {
+    chainId: number;
+    items: ScoreItem[];
+    strategies?: Address[];
+    enabled?: boolean;
+};
+type UseTokenUpvotesOptions = {
+    chainId: number;
+    tokenAddress: string;
+    enabled?: boolean;
+};
+
+/**
+ * Generate score key for token upvotes.
+ * Pads the token address into a bytes32 value.
+ */
+declare const getTokenScoreKey: (tokenAddress: string) => `0x${string}`;
+/**
+ * Generate score key for storage upvotes.
+ * keccak256(encodePacked(storageKeyBytes32, operatorAddress))
+ */
+declare const getStorageScoreKey: (operatorAddress: string, storageKey: string) => `0x${string}`;
+/**
+ * Generate content-based key for feed posts.
+ * Uses all message content to create a unique identifier that's
+ * independent of query filter (works regardless of how messages are fetched).
+ *
+ * Two messages with identical content will share the same key (and upvotes),
+ * which is semantically correct - they are the same content.
+ */
+declare const getFeedContentKey: (message: FeedMessage) => `0x${string}`;
+/**
+ * Get score key for any ScoreItem type.
+ */
+declare const getScoreKey: (item: ScoreItem) => `0x${string}`;
+/**
+ * Check if a score key represents a token upvote (zero-padded address)
+ * vs a hash-based key (storage/feed).
+ */
+declare const isTokenScoreKey: (scoreKey: string) => boolean;
+/**
+ * Extract and validate token address from a token score key.
+ * Returns the checksummed address or null if invalid.
+ */
+declare const extractTokenAddressFromScoreKey: (scoreKey: string) => string | null;
+/**
+ * Generate upvote stored context for storage upvotes.
+ * ABI-encodes (bytes32 storageKeyBytes, address operatorAddress).
+ */
+declare const getStorageUpvoteContext: (operatorAddress: string, storageKey: string) => `0x${string}`;
+
+export { type DecodedStrategyMetadata as D, type FeedMessage as F, type GetUpvotesOptions as G, type PoolKey as P, type ScoreClientOptions as S, type UseUpvotesOptions as U, type GetUpvotesForItemsOptions as a, type GetStrategyKeyScoresOptions as b, type GetAppKeyScoresOptions as c, getStorageScoreKey as d, getFeedContentKey as e, getScoreKey as f, getTokenScoreKey as g, extractTokenAddressFromScoreKey as h, isTokenScoreKey as i, getStorageUpvoteContext as j, type ScoreItem as k, type PureAlphaMetadata as l, type PoolStrategyMetadata as m, type DecodedUpvoteBlob as n, type UseUpvotesBatchOptions as o, type UseTokenUpvotesOptions as p };

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "@net-protocol/score",
+  "version": "0.1.0",
+  "description": "Score/upvoting functionality for Net Protocol - on-chain scoring system",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "module": "./dist/index.mjs",
+  "sideEffects": false,
+  "typesVersions": {
+    "*": {
+      "react": [
+        "./dist/react.d.ts"
+      ]
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.mjs",
+      "require": "./dist/react.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "prepack": "../../scripts/prepack-modify-deps.sh",
+    "prepublishOnly": "yarn build",
+    "postpublish": "../../scripts/postpublish-restore-deps.sh",
+    "test": "vitest --run",
+    "test:watch": "vitest --watch",
+    "test:ui": "vitest --ui"
+  },
+  "dependencies": {
+    "@net-protocol/core": "^0.1.8",
+    "@net-protocol/storage": "^0.1.12",
+    "viem": "^2.31.4"
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.0.0",
+    "@testing-library/react": "^14.0.0",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.0.0",
+    "@vitest/ui": "^1.0.0",
+    "jsdom": "^24.0.0",
+    "react-dom": "^18.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0",
+    "wagmi": "^2.15.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0",
+    "wagmi": "^2.15.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "wagmi": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stuckinaboot/net-public.git",
+    "directory": "packages/net-score"
+  },
+  "keywords": [
+    "net",
+    "protocol",
+    "blockchain",
+    "ethereum",
+    "score",
+    "upvote",
+    "voting"
+  ],
+  "license": "MIT"
+}