@net-protocol/cli 0.2.1 → 0.2.3

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

@@ -8891,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);