@net-protocol/cli 0.2.0 → 0.2.1

package/dist/cli/index.mjs

@@ -22,7 +22,7 @@ import { BazaarClient } from '@net-protocol/bazaar';
 import * as os from 'os';
 import { homedir } from 'os';
 import * as readline from 'readline';
-import { discoverTokenPool, PURE_ALPHA_STRATEGY, UNIV234_POOLS_STRATEGY, encodePoolKey, DYNAMIC_SPLIT_STRATEGY, getTokenScoreKey, UPVOTE_PRICE_ETH, UPVOTE_APP, ScoreClient, ALL_STRATEGY_ADDRESSES, NULL_ADDRESS as NULL_ADDRESS$1, UserUpvoteClient, calculateUpvoteCost, USER_UPVOTE_CONTRACT } from '@net-protocol/score';
+import { discoverTokenPool, PURE_ALPHA_STRATEGY, UNIV234_POOLS_STRATEGY, encodePoolKey, DYNAMIC_SPLIT_STRATEGY, getTokenScoreKey, UPVOTE_PRICE_ETH, UPVOTE_APP, ScoreClient, ALL_STRATEGY_ADDRESSES, NULL_ADDRESS as NULL_ADDRESS$1, UserUpvoteClient, calculateUpvoteCost, USER_UPVOTE_CONTRACT, getTokenRankings } from '@net-protocol/score';
 import { RELAY_ACCESS_KEY, generateAgentChatTopic, AgentClient, isAgentChatTopic, parseAgentAddressFromTopic, buildSessionTypedData, NET_API_URL, exchangeSessionSignature, buildConversationAuthTypedData, NET_TESTNET_API_URL } from '@net-protocol/agents';
 
 var DEFAULT_CHAIN_ID = 8453;
@@ -8280,6 +8280,155 @@ function registerGetUserUpvotesCommand(parent, commandName = "user-info") {
     await executeGetUserUpvotes(options);
   });
 }
+var VALID_SORTS = ["trending", "recent", "top"];
+function formatNumber(n, digits = 2) {
+  if (n == null || !Number.isFinite(n)) return "-";
+  if (n >= 1e9) return `${(n / 1e9).toFixed(digits)}B`;
+  if (n >= 1e6) return `${(n / 1e6).toFixed(digits)}M`;
+  if (n >= 1e3) return `${(n / 1e3).toFixed(digits)}K`;
+  return n.toFixed(digits);
+}
+function formatPrice(price) {
+  if (price == null || !Number.isFinite(price)) return "-";
+  if (price < 1e-6) return price.toExponential(2);
+  if (price < 1) return `$${price.toFixed(6)}`;
+  return `$${price.toFixed(4)}`;
+}
+async function executeRankings(options) {
+  const sort = (options.sort ?? "trending").toLowerCase();
+  if (!VALID_SORTS.includes(sort)) {
+    exitWithError(
+      `Invalid --sort "${options.sort}". Must be one of: ${VALID_SORTS.join(", ")}`
+    );
+    return;
+  }
+  const limit = options.limit ?? 10;
+  if (!Number.isFinite(limit) || limit < 1 || limit > 100) {
+    exitWithError("Invalid --limit. Must be an integer between 1 and 100.");
+    return;
+  }
+  const optionalPositiveInt = (value, name, { allowZero = false } = {}) => {
+    if (value === void 0) return void 0;
+    if (!Number.isFinite(value) || (allowZero ? value < 0 : value < 1)) {
+      exitWithError(
+        `Invalid ${name}. Must be a ${allowZero ? "non-negative" : "positive"} integer.`
+      );
+    }
+    return value;
+  };
+  const scanWindow = optionalPositiveInt(options.scanWindow, "--scan-window");
+  const minUpvotes = optionalPositiveInt(options.minUpvotes, "--min-upvotes", {
+    allowZero: true
+  });
+  const minMarketCap = optionalPositiveInt(
+    options.minMarketCap,
+    "--min-market-cap",
+    { allowZero: true }
+  );
+  const recencyHours = optionalPositiveInt(
+    options.recencyHours,
+    "--recency-hours",
+    { allowZero: true }
+  );
+  if (options.chainId !== void 0 && !Number.isFinite(options.chainId)) {
+    exitWithError("Invalid --chain-id. Must be an integer.");
+    return;
+  }
+  const readOnlyOptions = parseReadOnlyOptionsWithDefault({
+    chainId: options.chainId,
+    rpcUrl: options.rpcUrl
+  });
+  try {
+    const tokens = await getTokenRankings({
+      chainId: readOnlyOptions.chainId,
+      sort,
+      maxTokens: limit,
+      messageScanWindow: scanWindow,
+      thresholds: minUpvotes != null || minMarketCap != null || recencyHours != null ? {
+        minUpvotes,
+        minMarketCap,
+        recencyHours
+      } : void 0,
+      rpcUrl: readOnlyOptions.rpcUrl
+    });
+    if (options.json) {
+      console.log(
+        JSON.stringify(
+          {
+            chainId: readOnlyOptions.chainId,
+            sort,
+            count: tokens.length,
+            tokens: tokens.map((t) => ({
+              ...t,
+              url: tokenUrl(readOnlyOptions.chainId, t.address)
+            }))
+          },
+          null,
+          2
+        )
+      );
+      return;
+    }
+    if (tokens.length === 0) {
+      console.log(chalk4.yellow("No tokens found."));
+      return;
+    }
+    console.log(
+      chalk4.white(
+        `Top ${tokens.length} tokens by ${sort} on chain ${readOnlyOptions.chainId}:`
+      )
+    );
+    console.log();
+    tokens.forEach((t, i) => {
+      const rank = chalk4.dim(`#${(i + 1).toString().padStart(2, " ")}`);
+      const symbol = chalk4.cyan((t.symbol || "?").padEnd(10, " "));
+      const upvotes = chalk4.white(`${t.upvotes} upvotes`.padEnd(18, " "));
+      const fdv = chalk4.dim(`FDV ${formatNumber(t.fdv)}`.padEnd(14, " "));
+      const price = chalk4.dim(`${formatPrice(t.priceInUsdc)}`.padEnd(14, " "));
+      console.log(`${rank}  ${symbol} ${upvotes} ${fdv} ${price} ${t.address}`);
+    });
+  } catch (error) {
+    exitWithError(
+      `Failed to fetch token rankings: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}
+function registerRankingsCommand(parent, commandName = "rankings") {
+  parent.command(commandName).description(
+    "List tokens ranked by upvote activity (trending / recent / top)"
+  ).option(
+    "--sort <sort>",
+    `Ranking strategy: ${VALID_SORTS.join(" | ")} (default: trending)`,
+    "trending"
+  ).option(
+    "--limit <n>",
+    "Number of tokens to return (1-100, default: 50)",
+    (v) => parseInt(v, 10),
+    50
+  ).option(
+    "--scan-window <n>",
+    "Messages to scan per contract (default: 150)",
+    (v) => parseInt(v, 10)
+  ).option(
+    "--min-upvotes <n>",
+    "Floor for two-tier filter (default: 500)",
+    (v) => parseInt(v, 10)
+  ).option(
+    "--min-market-cap <n>",
+    "FDV floor in USDC (default: 40000)",
+    (v) => parseInt(v, 10)
+  ).option(
+    "--recency-hours <n>",
+    "Drop below-floor tokens with no upvote within N hours (default: 48)",
+    (v) => parseInt(v, 10)
+  ).option(
+    "--chain-id <id>",
+    "Chain ID (default: 8453 for Base)",
+    (v) => parseInt(v, 10)
+  ).option("--rpc-url <url>", "Custom RPC URL").option("--json", "Output in JSON format").action(async (options) => {
+    await executeRankings(options);
+  });
+}
 
 // src/commands/upvote/index.ts
 function registerUpvoteCommand(program2) {
@@ -8288,6 +8437,7 @@ function registerUpvoteCommand(program2) {
   registerGetUpvotesCommand(upvoteCommand);
   registerUpvoteUserCommand(upvoteCommand);
   registerGetUserUpvotesCommand(upvoteCommand);
+  registerRankingsCommand(upvoteCommand);
 }
 var VALID_RUN_MODES = ["auto", "feeds", "chats"];
 function addAuthOptions(cmd) {