@rareprotocol/rare-cli 0.1.0 → 0.1.1

package/README.md

@@ -28,6 +28,8 @@ Import an existing private key:
 rare configure --chain sepolia --private-key 0xYourPrivateKeyHere
 ```
 
+> **Security note:** Your private key is stored in plaintext at `~/.rare/config.json`. Keep this file secure and never commit it to version control.
+
 Or generate a new wallet:
 
 ```bash
@@ -68,9 +70,9 @@ Private keys are masked in the output.
 
 All commands accept `--chain` to select a network. Defaults to `sepolia`.
 
-Supported chains: `mainnet`, `sepolia`, `base`, `base-sepolia`, `arbitrum`, `arbitrum-sepolia`, `optimism`, `optimism-sepolia`, `zora`, `zora-sepolia`
+Supported chains: `mainnet`, `sepolia`, `base`, `base-sepolia`
 
-> **Note:** RARE Protocol contracts (deploy, auction) are currently deployed on `mainnet` and `sepolia` only. Other chains support wallet, search, and status operations.
+> **Note:** RARE Protocol deploy and auction commands are currently available on `mainnet` and `sepolia` only.
 
 ### Deploy an NFT Collection
 
@@ -214,7 +216,7 @@ rare configure --show
 
 - **Use sepolia for testing.** Default to sepolia and only switch to mainnet when you're ready.
 - **Set a reliable RPC endpoint.** Public endpoints throttle and drop requests. Services like Alchemy or Infura provide free tiers.
-- **Don't share your private key.** The config file at `~/.rare/config.json` contains your key in plaintext. Keep it secure and never commit it to version control.
+- **Don't share your private key.** Keep `~/.rare/config.json` secure and never commit it to version control.
 - **Check status before transacting.** Use `rare status` and `rare auction status` to inspect on-chain state before sending transactions.
 - **Back up your wallet.** If you lose your private key, you lose access to your assets. Store a copy somewhere safe.
 

package/dist/index.js

@@ -12,54 +12,30 @@ import path from "path";
 import os from "os";
 
 // src/contracts/addresses.ts
-import { sepolia, mainnet, base, baseSepolia, arbitrum, arbitrumSepolia, optimism, optimismSepolia, zora, zoraSepolia } from "viem/chains";
+import { sepolia, mainnet, base, baseSepolia } from "viem/chains";
 var supportedChains = [
   "mainnet",
   "sepolia",
   "base",
-  "base-sepolia",
-  "arbitrum",
-  "arbitrum-sepolia",
-  "optimism",
-  "optimism-sepolia",
-  "zora",
-  "zora-sepolia"
+  "base-sepolia"
 ];
 var viemChains = {
   mainnet,
   sepolia,
   base,
-  "base-sepolia": baseSepolia,
-  arbitrum,
-  "arbitrum-sepolia": arbitrumSepolia,
-  optimism,
-  "optimism-sepolia": optimismSepolia,
-  zora,
-  "zora-sepolia": zoraSepolia
+  "base-sepolia": baseSepolia
 };
 var chainIds = {
   mainnet: 1,
   sepolia: 11155111,
   base: 8453,
-  "base-sepolia": 84532,
-  arbitrum: 42161,
-  "arbitrum-sepolia": 421614,
-  optimism: 10,
-  "optimism-sepolia": 11155420,
-  zora: 7777777,
-  "zora-sepolia": 999999999
+  "base-sepolia": 84532
 };
 var defaultRpcUrls = {
   mainnet: "https://eth.llamarpc.com",
   sepolia: "https://rpc.sepolia.org",
   base: "https://mainnet.base.org",
-  "base-sepolia": "https://sepolia.base.org",
-  arbitrum: "https://arb1.arbitrum.io/rpc",
-  "arbitrum-sepolia": "https://sepolia-rollup.arbitrum.io/rpc",
-  optimism: "https://mainnet.optimism.io",
-  "optimism-sepolia": "https://sepolia.optimism.io",
-  zora: "https://rpc.zora.energy",
-  "zora-sepolia": "https://sepolia.rpc.zora.energy"
+  "base-sepolia": "https://sepolia.base.org"
 };
 var contractAddresses = {
   sepolia: {
@@ -74,9 +50,9 @@ var contractAddresses = {
 function getContractAddresses(chain) {
   const addresses = contractAddresses[chain];
   if (!addresses) {
-    console.error(`Error: RARE Protocol contracts are not deployed on "${chain}".`);
-    console.error(`Supported chains: ${Object.keys(contractAddresses).join(", ")}`);
-    process.exit(1);
+    throw new Error(
+      `RARE Protocol contracts are not deployed on "${chain}". Supported chains: ${Object.keys(contractAddresses).join(", ")}`
+    );
   }
   return addresses;
 }
@@ -119,8 +95,9 @@ function getChainConfig(chain) {
 // src/commands/configure.ts
 function configureCommand() {
   const cmd = new Command("configure");
+  const supportedChainsText = supportedChains.join(", ");
   cmd.description("Set or view configuration");
-  cmd.option("--chain <chain>", "chain to configure (sepolia or mainnet)").option("--private-key <key>", "private key for the specified chain").option("--rpc-url <url>", "custom RPC URL for the specified chain").option("--default-chain <chain>", "set the default chain").option("--show", "display current configuration").action((opts) => {
+  cmd.option("--chain <chain>", `chain to configure (${supportedChainsText})`).option("--private-key <key>", "private key for the specified chain").option("--rpc-url <url>", "custom RPC URL for the specified chain").option("--default-chain <chain>", "set the default chain").option("--show", "display current configuration").action((opts) => {
     const config = readConfig();
     if (opts.show) {
       const display = {
@@ -139,8 +116,8 @@ function configureCommand() {
       return;
     }
     if (opts.defaultChain) {
-      if (opts.defaultChain !== "sepolia" && opts.defaultChain !== "mainnet") {
-        console.error('Error: --default-chain must be "sepolia" or "mainnet"');
+      if (!isSupportedChain(opts.defaultChain)) {
+        console.error(`Error: --default-chain must be one of: ${supportedChainsText}`);
         process.exit(1);
       }
       config.defaultChain = opts.defaultChain;
@@ -148,11 +125,11 @@ function configureCommand() {
       console.log(`Default chain set to: ${opts.defaultChain}`);
     }
     if (opts.chain) {
-      const chain = opts.chain;
-      if (chain !== "sepolia" && chain !== "mainnet") {
-        console.error('Error: --chain must be "sepolia" or "mainnet"');
+      if (!isSupportedChain(opts.chain)) {
+        console.error(`Error: --chain must be one of: ${supportedChainsText}`);
         process.exit(1);
       }
+      const chain = opts.chain;
       if (!config.chains[chain]) {
         config.chains[chain] = {};
       }
@@ -402,7 +379,7 @@ var factoryAbi = [
 function deployErc721Command() {
   const cmd = new Command2("erc721");
   cmd.description("Deploy a new ERC-721 NFT contract via the RARE factory");
-  cmd.argument("<name>", "name of the NFT collection").argument("<symbol>", "symbol of the NFT collection").option("--max-tokens <number>", "maximum number of tokens (optional)").option("--chain <chain>", "chain to use (sepolia or mainnet)").action(async (name, symbol, opts) => {
+  cmd.argument("<name>", "name of the NFT collection").argument("<symbol>", "symbol of the NFT collection").option("--max-tokens <number>", "maximum number of tokens (optional)").option("--chain <chain>", "chain to use (mainnet, sepolia, base, base-sepolia)").action(async (name, symbol, opts) => {
     const chain = getActiveChain(opts.chain);
     const { client, account } = getWalletClient(chain);
     const publicClient = getPublicClient(chain);
@@ -1396,7 +1373,7 @@ function parseAttribute(raw) {
 function mintCommand() {
   const cmd = new Command3("mint");
   cmd.description("Mint a new NFT on a deployed token contract");
-  cmd.requiredOption("--contract <address>", "token contract address").option("--token-uri <uri>", "token metadata URI (skip upload if provided)").option("--name <name>", "NFT name").option("--description <description>", "NFT description").option("--image <path>", "path to image file").option("--video <path>", "path to video file").option("--tag <tag>", "tag (repeatable)", (val, acc) => [...acc, val], []).option("--attribute <attr>", 'attribute as "trait=value" or JSON (repeatable)', (val, acc) => [...acc, val], []).option("--to <address>", "recipient address (defaults to caller)").option("--royalty-receiver <address>", "royalty receiver address (defaults to caller)").option("--chain <chain>", "chain to use (sepolia or mainnet)").action(async (opts) => {
+  cmd.requiredOption("--contract <address>", "token contract address").option("--token-uri <uri>", "token metadata URI (skip upload if provided)").option("--name <name>", "NFT name").option("--description <description>", "NFT description").option("--image <path>", "path to image file").option("--video <path>", "path to video file").option("--tag <tag>", "tag (repeatable)", (val, acc) => [...acc, val], []).option("--attribute <attr>", 'attribute as "trait=value" or JSON (repeatable)', (val, acc) => [...acc, val], []).option("--to <address>", "recipient address (defaults to caller)").option("--royalty-receiver <address>", "royalty receiver address (defaults to caller)").option("--chain <chain>", "chain to use (mainnet, sepolia, base, base-sepolia)").action(async (opts) => {
     let tokenUri;
     if (opts.tokenUri) {
       tokenUri = opts.tokenUri;
@@ -3102,7 +3079,7 @@ var approvalAbi = [
 function auctionCommand() {
   const cmd = new Command4("auction");
   cmd.description("Auction subcommands (create, bid, settle, cancel, status)");
-  cmd.command("create").description("Configure and start an auction").requiredOption("--contract <address>", "NFT contract address").requiredOption("--token-id <id>", "token ID to auction").requiredOption("--starting-price <amount>", "starting price in ETH (or token units)").requiredOption("--duration <seconds>", "auction duration in seconds").option("--currency <address>", "ERC20 currency address (defaults to ETH)").option("--chain <chain>", "chain to use (sepolia or mainnet)").action(async (opts) => {
+  cmd.command("create").description("Configure and start an auction").requiredOption("--contract <address>", "NFT contract address").requiredOption("--token-id <id>", "token ID to auction").requiredOption("--starting-price <amount>", "starting price in ETH (or token units)").requiredOption("--duration <seconds>", "auction duration in seconds").option("--currency <address>", "ERC20 currency address (defaults to ETH)").option("--chain <chain>", "chain to use (mainnet, sepolia, base, base-sepolia)").action(async (opts) => {
     const chain = getActiveChain(opts.chain);
     const { client, account } = getWalletClient(chain);
     const publicClient = getPublicClient(chain);
@@ -3181,7 +3158,7 @@ Transaction sent: ${txHash}`);
     const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
     console.log(`Auction created! Block: ${receipt.blockNumber}`);
   });
-  cmd.command("bid").description("Place a bid on an auction").requiredOption("--contract <address>", "NFT contract address").requiredOption("--token-id <id>", "token ID").requiredOption("--amount <amount>", "bid amount in ETH (or token units)").option("--currency <address>", "ERC20 currency address (defaults to ETH)").option("--chain <chain>", "chain to use (sepolia or mainnet)").action(async (opts) => {
+  cmd.command("bid").description("Place a bid on an auction").requiredOption("--contract <address>", "NFT contract address").requiredOption("--token-id <id>", "token ID").requiredOption("--amount <amount>", "bid amount in ETH (or token units)").option("--currency <address>", "ERC20 currency address (defaults to ETH)").option("--chain <chain>", "chain to use (mainnet, sepolia, base, base-sepolia)").action(async (opts) => {
     const chain = getActiveChain(opts.chain);
     const { client, account } = getWalletClient(chain);
     const publicClient = getPublicClient(chain);
@@ -3213,7 +3190,7 @@ Transaction sent: ${txHash}`);
     const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
     console.log(`Bid placed! Block: ${receipt.blockNumber}`);
   });
-  cmd.command("settle").description("Settle a completed auction").requiredOption("--contract <address>", "NFT contract address").requiredOption("--token-id <id>", "token ID").option("--chain <chain>", "chain to use (sepolia or mainnet)").action(async (opts) => {
+  cmd.command("settle").description("Settle a completed auction").requiredOption("--contract <address>", "NFT contract address").requiredOption("--token-id <id>", "token ID").option("--chain <chain>", "chain to use (mainnet, sepolia, base, base-sepolia)").action(async (opts) => {
     const chain = getActiveChain(opts.chain);
     const { client, account } = getWalletClient(chain);
     const publicClient = getPublicClient(chain);
@@ -3231,7 +3208,7 @@ Transaction sent: ${txHash}`);
     const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
     console.log(`Auction settled! Block: ${receipt.blockNumber}`);
   });
-  cmd.command("cancel").description("Cancel an auction").requiredOption("--contract <address>", "NFT contract address").requiredOption("--token-id <id>", "token ID").option("--chain <chain>", "chain to use (sepolia or mainnet)").action(async (opts) => {
+  cmd.command("cancel").description("Cancel an auction").requiredOption("--contract <address>", "NFT contract address").requiredOption("--token-id <id>", "token ID").option("--chain <chain>", "chain to use (mainnet, sepolia, base, base-sepolia)").action(async (opts) => {
     const chain = getActiveChain(opts.chain);
     const { client, account } = getWalletClient(chain);
     const publicClient = getPublicClient(chain);
@@ -3249,7 +3226,7 @@ Transaction sent: ${txHash}`);
     const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
     console.log(`Auction cancelled! Block: ${receipt.blockNumber}`);
   });
-  cmd.command("status").description("Get auction details (read-only)").requiredOption("--contract <address>", "NFT contract address").requiredOption("--token-id <id>", "token ID").option("--chain <chain>", "chain to use (sepolia or mainnet)").action(async (opts) => {
+  cmd.command("status").description("Get auction details (read-only)").requiredOption("--contract <address>", "NFT contract address").requiredOption("--token-id <id>", "token ID").option("--chain <chain>", "chain to use (mainnet, sepolia, base, base-sepolia)").action(async (opts) => {
     const chain = getActiveChain(opts.chain);
     const publicClient = getPublicClient(chain);
     const auctionAddress = getContractAddresses(chain).auction;
@@ -3278,7 +3255,7 @@ import { Command as Command5 } from "commander";
 function statusCommand() {
   const cmd = new Command5("status");
   cmd.description("Query token contract information (read-only)");
-  cmd.requiredOption("--contract <address>", "token contract address").option("--token-id <id>", "token ID to query (optional)").option("--chain <chain>", "chain to use (sepolia or mainnet)").action(async (opts) => {
+  cmd.requiredOption("--contract <address>", "token contract address").option("--token-id <id>", "token ID to query (optional)").option("--chain <chain>", "chain to use (mainnet, sepolia, base, base-sepolia)").action(async (opts) => {
     const chain = getActiveChain(opts.chain);
     const publicClient = getPublicClient(chain);
     const contractAddress = opts.contract;
@@ -3340,8 +3317,9 @@ import { Command as Command6 } from "commander";
 import { generatePrivateKey as generatePrivateKey2, privateKeyToAccount as privateKeyToAccount2 } from "viem/accounts";
 function walletCommand() {
   const cmd = new Command6("wallet");
+  const supportedChainsText = supportedChains.join(", ");
   cmd.description("Wallet management");
-  cmd.command("generate").description("Generate a new Ethereum wallet and optionally save it to config").option("--chain <chain>", "chain to save the key to (sepolia or mainnet)").option("--save", "save the generated key to config for the specified chain").action((opts) => {
+  cmd.command("generate").description("Generate a new Ethereum wallet and optionally save it to config").option("--chain <chain>", `chain to save the key to (${supportedChainsText})`).option("--save", "save the generated key to config for the specified chain").action((opts) => {
     const privateKey = generatePrivateKey2();
     const account = privateKeyToAccount2(privateKey);
     console.log("Generated new wallet:");
@@ -3350,11 +3328,12 @@ function walletCommand() {
     console.log("");
     console.log("\u26A0 Store your private key securely. It will not be shown again.");
     if (opts.save) {
-      const chain = opts.chain ?? "sepolia";
-      if (chain !== "sepolia" && chain !== "mainnet") {
-        console.error('Error: --chain must be "sepolia" or "mainnet"');
+      const selectedChain = opts.chain ?? "sepolia";
+      if (!isSupportedChain(selectedChain)) {
+        console.error(`Error: --chain must be one of: ${supportedChainsText}`);
         process.exit(1);
       }
+      const chain = selectedChain;
       const config = readConfig();
       if (!config.chains[chain]) {
         config.chains[chain] = {};
@@ -3365,7 +3344,7 @@ function walletCommand() {
 Private key saved to config for chain: ${chain}`);
     }
   });
-  cmd.command("address").description("Show the Ethereum address of the configured wallet").option("--chain <chain>", "chain to use (sepolia or mainnet)").action((opts) => {
+  cmd.command("address").description("Show the Ethereum address of the configured wallet").option("--chain <chain>", `chain to use (${supportedChainsText})`).action((opts) => {
     const chain = getActiveChain(opts.chain);
     const { account } = getWalletClient(chain);
     console.log(account.address);
@@ -3452,7 +3431,7 @@ function getWalletAddress(chain) {
 function searchCommand() {
   const cmd = new Command7("search");
   cmd.description("Search NFTs and collections via the RARE Protocol API");
-  cmd.command("tokens").description("Search NFTs").option("--chain <chain>", "chain to use (sepolia or mainnet)").option("--query <text>", "text search query", "").option("--owner <address>", "filter by owner address").option("--mine", "filter by your configured wallet address").option("--take <n>", "number of results per page", "24").option("--cursor <n>", "pagination cursor", "0").action(async (opts) => {
+  cmd.command("tokens").description("Search NFTs").option("--chain <chain>", "chain to use (mainnet, sepolia, base, base-sepolia)").option("--query <text>", "text search query", "").option("--owner <address>", "filter by owner address").option("--mine", "filter by your configured wallet address").option("--take <n>", "number of results per page", "24").option("--cursor <n>", "pagination cursor", "0").action(async (opts) => {
     const chain = getActiveChain(opts.chain);
     const ownerAddresses = opts.mine ? [getWalletAddress(chain)] : opts.owner ? [opts.owner] : [];
     const label = opts.mine ? `NFTs owned by ${ownerAddresses[0]}` : opts.owner ? `NFTs owned by ${opts.owner}` : "NFTs";
@@ -3466,7 +3445,7 @@ function searchCommand() {
     });
     printPage(label, page.items, page.total, page.hasNextPage, formatNftRow);
   });
-  cmd.command("auctions").description("List NFTs with active or configured auctions").option("--chain <chain>", "chain to use (sepolia or mainnet)").option("--state <states...>", "auction states to filter (PENDING, RUNNING, SETTLED, UNSETTLED)", ["PENDING", "RUNNING"]).option("--owner <address>", "filter by owner address (optional)").option("--query <text>", "text search query", "").option("--take <n>", "number of results per page", "24").option("--cursor <n>", "pagination cursor", "0").action(async (opts) => {
+  cmd.command("auctions").description("List NFTs with active or configured auctions").option("--chain <chain>", "chain to use (mainnet, sepolia, base, base-sepolia)").option("--state <states...>", "auction states to filter (PENDING, RUNNING, SETTLED, UNSETTLED)", ["PENDING", "RUNNING"]).option("--owner <address>", "filter by owner address (optional)").option("--query <text>", "text search query", "").option("--take <n>", "number of results per page", "24").option("--cursor <n>", "pagination cursor", "0").action(async (opts) => {
     const chain = getActiveChain(opts.chain);
     console.log(`Searching auctions (${opts.state.join(", ")}) on ${chain}...`);
     const page = await searchNfts({
@@ -3479,7 +3458,7 @@ function searchCommand() {
     });
     printPage(`Auctions (${opts.state.join(", ")})`, page.items, page.total, page.hasNextPage, formatNftRow);
   });
-  cmd.command("collections").description("List collections owned by your wallet").option("--chain <chain>", "chain to use (sepolia or mainnet)").option("--query <text>", "text search query", "").option("--take <n>", "number of results per page", "24").option("--cursor <n>", "pagination cursor", "0").action(async (opts) => {
+  cmd.command("collections").description("List collections owned by your wallet").option("--chain <chain>", "chain to use (mainnet, sepolia, base, base-sepolia)").option("--query <text>", "text search query", "").option("--take <n>", "number of results per page", "24").option("--cursor <n>", "pagination cursor", "0").action(async (opts) => {
     const chain = getActiveChain(opts.chain);
     const address = getWalletAddress(chain);
     console.log(`Searching collections owned by ${address}...`);
@@ -3502,7 +3481,7 @@ function getWalletAddress2(chain) {
 }
 function listCollectionsCommand() {
   const cmd = new Command8("list-collections");
-  cmd.description("List all collections owned by your wallet").option("--chain <chain>", "chain to use (sepolia or mainnet)").option("--query <text>", "text search filter", "").action(async (opts) => {
+  cmd.description("List all collections owned by your wallet").option("--chain <chain>", "chain to use (mainnet, sepolia, base, base-sepolia)").option("--query <text>", "text search filter", "").action(async (opts) => {
     const chain = getActiveChain(opts.chain);
     const address = getWalletAddress2(chain);
     console.log(`Fetching collections for ${address} on ${chain}...

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rareprotocol/rare-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CLI tool for interacting with the RARE protocol smart contracts",
   "type": "module",
   "license": "MIT",