@net-protocol/cli 0.2.0 → 0.2.2

package/README.md

@@ -365,6 +365,59 @@ netp token info \
   --json
 ```
 
+#### Upvote Command
+
+Upvote-related operations for Net Protocol. Run `netp upvote --help` for the
+full list of subcommands (`token`, `info`, `user`, `user-info`, `rankings`).
+
+##### Upvote Rankings
+
+List the top tokens ranked by upvote activity — the same leaderboard that
+powers the website's `/token/<chain>/trending` page. All reads are live from
+chain; no off-chain index. Callers should cache via HTTP headers.
+
+```bash
+netp upvote rankings \
+  [--sort <trending|recent|top>] \
+  [--limit <n>] \
+  [--scan-window <n>] \
+  [--min-upvotes <n>] \
+  [--min-market-cap <n>] \
+  [--recency-hours <n>] \
+  [--chain-id <8453>] \
+  [--rpc-url <custom-rpc>] \
+  [--json]
+```
+
+**Arguments:**
+
+- `--sort` (optional): Ranking strategy. `trending` (time-decayed score, recent upvotes weighted higher), `recent` (latest upvote timestamp), `top` (aggregate upvote count). Default: `trending`.
+- `--limit` (optional): Number of tokens to return, 1-100. Default: 50.
+- `--scan-window` (optional): Messages to scan per contract (legacy + 3 strategies). Default: 150.
+- `--min-upvotes` (optional): Two-tier filter floor — tokens with at least this many aggregate upvotes get top slots. Default: 500.
+- `--min-market-cap` (optional): FDV floor in USDC for the top slots. Default: 40000.
+- `--recency-hours` (optional): Drop below-floor tokens with no upvote within N hours. Default: 48.
+- `--chain-id` (optional): Chain ID. Base (8453) is currently the only supported chain.
+- `--rpc-url` (optional): Custom RPC URL.
+- `--json` (optional): Output JSON.
+
+**Example:**
+
+```bash
+netp upvote rankings --sort top --limit 5 --chain-id 8453
+```
+
+Output:
+
+```
+Top 5 tokens by top on chain 8453:
+# 1  ALPHA      2238158 upvotes    FDV 402.75K    $0.000004    0x3d01fe5a...
+# 2  BNKR       133462 upvotes     FDV 53.03M     $0.000530    0x22af33fe...
+# 3  DICKBUTT   33364 upvotes      FDV 388.94K    $0.000004    0x2d57c47b...
+# 4  AEGON      33335 upvotes      FDV 285.30K    $0.000285    0x78a5d1de...
+# 5  DRB        31460 upvotes      FDV 4.23M      $0.000042    0x3ec2156d...
+```
+
 #### Profile Command
 
 Profile operations for managing your Net Protocol profile.
@@ -797,7 +850,7 @@ src/
 │   ├── feed/             # Feed command module
 │   ├── message/          # Message command module
 │   ├── token/            # Token command module
-│   ├── bazaar/           # NFT Bazaar command module
+│   ├── bazaar/           # Bazaar command module (NFT + ERC-20)
 │   ├── agent/            # Onchain agent command module
 │   ├── relay/            # Relay fund/balance command module
 │   ├── upvote/           # Token/user upvoting command module
@@ -1077,10 +1130,11 @@ netp relay balance --chain-id 8453 --json
 
 #### Bazaar Command
 
-NFT Bazaar operations — list, buy, sell, and trade NFTs via Seaport.
+Bazaar operations — list, buy, sell, and trade NFTs and ERC-20 tokens via Seaport. NFT bazaar is supported on Base (8453) and Ethereum (1); ERC-20 bazaar is supported on Base (8453) and HyperEVM (999).
 
 **Available Subcommands:**
 
+NFT:
 - `bazaar list-listings` - List active NFT listings
 - `bazaar list-offers` - List active collection offers
 - `bazaar list-sales` - List recent sales
@@ -1091,6 +1145,20 @@ NFT Bazaar operations — list, buy, sell, and trade NFTs via Seaport.
 - `bazaar submit-offer` - Submit a signed offer
 - `bazaar buy-listing` - Buy an NFT listing
 - `bazaar accept-offer` - Accept a collection offer
+- `bazaar cancel-listing` - Cancel an NFT listing you created
+- `bazaar cancel-offer` - Cancel a collection offer you created
+
+ERC-20:
+- `bazaar list-erc20-listings` - List active ERC-20 token listings
+- `bazaar list-erc20-offers` - List active ERC-20 token offers
+- `bazaar create-erc20-listing` - Create an ERC-20 token listing
+- `bazaar create-erc20-offer` - Create an ERC-20 token offer
+- `bazaar submit-erc20-listing` - Submit a signed ERC-20 listing
+- `bazaar submit-erc20-offer` - Submit a signed ERC-20 offer
+- `bazaar buy-erc20-listing` - Buy an ERC-20 listing
+- `bazaar accept-erc20-offer` - Accept an ERC-20 offer
+- `bazaar cancel-erc20-listing` - Cancel an ERC-20 listing you created
+- `bazaar cancel-erc20-offer` - Cancel an ERC-20 offer you created
 
 ##### Read Commands
 
@@ -1106,6 +1174,12 @@ netp bazaar list-sales --nft-address <address> --chain-id 8453 [--json]
 
 # Check NFTs owned by an address
 netp bazaar owned-nfts --nft-address <address> --owner <address> --chain-id 8453 [--json]
+
+# List active ERC-20 listings (sorted by price-per-token ascending)
+netp bazaar list-erc20-listings --token-address <address> --chain-id 8453 [--json]
+
+# List active ERC-20 offers (sorted by price-per-token descending, balance-validated)
+netp bazaar list-erc20-offers --token-address <address> --chain-id 8453 [--json]
 ```
 
 ##### Create Commands (Dual Mode)
@@ -1127,8 +1201,20 @@ netp bazaar create-listing \
 netp bazaar create-offer \
   --nft-address <address> --price <eth> \
   --chain-id 8453 --private-key 0x...
+
+# ERC-20 listing (sell tokens for the chain's native currency) — same dual mode
+netp bazaar create-erc20-listing \
+  --token-address <address> --token-amount <raw-units> --price <native-amount> \
+  --chain-id 8453 --private-key 0x...
+
+# ERC-20 offer (bid wrapped native currency for tokens) — same dual mode
+netp bazaar create-erc20-offer \
+  --token-address <address> --token-amount <raw-units> --price <wrapped-native-amount> \
+  --chain-id 8453 --private-key 0x...
 ```
 
+`--token-amount` is in **raw token units** (bigint string, e.g. `1000000000000000000` for 1.0 of an 18-decimal token). `--price` is the **total** amount of the chain's native currency for ERC-20 listings (ETH on Base, HYPE on HyperEVM), or the **total** wrapped-native amount for ERC-20 offers (WETH on Base, wrapped HYPE on HyperEVM).
+
 ##### Submit Commands
 
 Follow-up to keyless create commands:
@@ -1141,6 +1227,15 @@ netp bazaar submit-listing \
 netp bazaar submit-offer \
   --order-data <path> --signature <sig> \
   --chain-id 8453 [--private-key 0x... | --encode-only]
+
+# ERC-20 variants
+netp bazaar submit-erc20-listing \
+  --order-data <path> --signature <sig> \
+  --chain-id 8453 [--private-key 0x... | --encode-only]
+
+netp bazaar submit-erc20-offer \
+  --order-data <path> --signature <sig> \
+  --chain-id 8453 [--private-key 0x... | --encode-only]
 ```
 
 ##### Fulfillment Commands
@@ -1151,10 +1246,21 @@ netp bazaar buy-listing \
   --order-hash <hash> --nft-address <address> \
   --chain-id 8453 [--private-key 0x... | --buyer <address> --encode-only]
 
-# Accept an offer (sell your NFT)
+# Accept an offer (sell your NFT). Fulfillment value is 0 — buyer pays in WETH.
 netp bazaar accept-offer \
   --order-hash <hash> --nft-address <address> --token-id <id> \
   --chain-id 8453 [--private-key 0x... | --seller <address> --encode-only]
+
+# Buy an ERC-20 listing (pays in the chain's native currency — ETH on Base, HYPE on HyperEVM)
+netp bazaar buy-erc20-listing \
+  --order-hash <hash> --token-address <address> \
+  --chain-id 8453 [--private-key 0x... | --buyer <address> --encode-only]
+
+# Accept an ERC-20 offer (sell tokens for wrapped native currency — WETH or wrapped HYPE;
+# no --token-id, amount comes from the offer; fulfillment value is 0)
+netp bazaar accept-erc20-offer \
+  --order-hash <hash> --token-address <address> \
+  --chain-id 8453 [--private-key 0x... | --seller <address> --encode-only]
 ```
 
 ##### Encode-Only Mode
@@ -1179,3 +1285,7 @@ Output:
   }
 }
 ```
+
+The `fulfillment.value` is:
+- The listing price in wei (in the chain's native currency) for NFT or ERC-20 **listing buys**.
+- **Zero** for **offer accepts** on both sides (NFT collection offers and ERC-20 offers pay in the wrapped native currency, which the offerer pre-approved).

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) {
@@ -8741,7 +8891,7 @@ async function executeDm(agentAddress, message, options) {
     const usingSessionToken = !!(options.sessionToken || process.env.NET_SESSION_TOKEN);
     if (usingSessionToken && (!options.topic || !options.topicSignature)) {
       exitWithError(
-        "When using --session-token, you must also provide --topic and --topic-signature.\n  Obtain the signature with:\n    netp agent dm-auth-encode --agent-address <addr>  \u2192 produces { typedData, topic }\n    [sign .typedData with your external signer, e.g. Bankr /agent/sign]\n  Then:\n    netp agent dm <addr> <message> --session-token <token> --operator <addr> \\\n      --topic <topic> --topic-signature <sig>"
+        "When using --session-token, you must also provide --topic and --topic-signature.\n  Obtain the signature with:\n    netp agent dm-auth-encode --agent-address <addr>  \u2192 produces { typedData, topic }\n    [sign .typedData with your external signer]\n  Then:\n    netp agent dm <addr> <message> --session-token <token> --operator <addr> \\\n      --topic <topic> --topic-signature <sig>"
       );
     }
     const auth = await resolveAuth(options);