@covalenthq/goldrush-cli 3.0.0 → 3.0.2

package/README.md

@@ -15,7 +15,7 @@ goldrush auth
 goldrush balances eth-mainnet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
 
 # Stream new DEX pairs
-goldrush newpairs eth-mainnet
+goldrush new_pairs eth-mainnet
 
 # Launch proxy server (for MCP bridge)
 goldrush proxy
@@ -32,7 +32,7 @@ goldrush install
 | `goldrush auth`                        | Set up API key (OS keychain)         |
 | `goldrush balances <chain> <address>`  | Token balances with rich table       |
 | `goldrush transfers <chain> <address>` | Transfer history                     |
-| `goldrush newpairs <chain>`            | Stream new DEX pairs                 |
+| `goldrush new_pairs <chain>`           | Stream new DEX pairs                 |
 | `goldrush ohlcv <chain>`               | OHLCV pairs stream                   |
 | `goldrush search <query>`              | Token search                         |
 | `goldrush traders <chain>`             | Top traders                          |

package/dist/index.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@covalenthq/goldrush-cli",
-  version: "3.0.0",
+  version: "3.0.2",
   description: "Terminal-first blockchain data & algorithmic trading CLI powered by GoldRush API",
   type: "module",
   bin: {
@@ -45,8 +45,8 @@ var package_default = {
   homepage: "https://goldrush.dev/docs/",
   repository: {
     type: "git",
-    url: "https://github.com/covalenthq/covalent-api-sdk-ts.git",
-    directory: "services/mcp-server"
+    url: "https://github.com/covalenthq/goldrush-services-monorepo.git",
+    directory: "services/goldrush-cli"
   },
   dependencies: {
     "@covalenthq/client-sdk": "workspace:^",
@@ -100,6 +100,9 @@ async function getKeytar() {
     return null;
   }
 }
+async function isKeychainAvailable() {
+  return await getKeytar() !== null;
+}
 async function getApiKey() {
   const keytar = await getKeytar();
   if (keytar) {
@@ -186,13 +189,19 @@ import { GoldRushClient } from "@covalenthq/client-sdk";
 async function validateApiKey(key) {
   try {
     const client = new GoldRushClient(key);
-    const response = await client.BalanceService.getTokenBalancesForWalletAddress(
-      "eth-mainnet",
-      "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
-    );
-    return !response.error;
-  } catch {
-    return false;
+    const response = await client.BaseService.getAllChains();
+    if (response.error) {
+      return {
+        valid: false,
+        error_message: response.error_message
+      };
+    }
+    return { valid: true };
+  } catch (error) {
+    return {
+      valid: false,
+      error_message: error?.message || "The API key could not be validated.\nGet a key at https://goldrush.dev/platform/apikey/"
+    };
   }
 }
 async function getMaskedApiKey() {
@@ -233,6 +242,14 @@ function infoBox(title, message) {
     borderStyle: "round"
   });
 }
+function warningBox(title, message) {
+  return boxen(message, {
+    title: chalk.hex("#FFE66D").bold(title),
+    borderColor: "yellow",
+    padding: 1,
+    borderStyle: "round"
+  });
+}
 
 // src/ui/spinner.ts
 import ora from "ora";
@@ -287,23 +304,43 @@ var authCommand = new Command("auth").description("Set up your GoldRush API key"
   }
   const spinner = createSpinner("Validating API key...");
   spinner.start();
-  const isValid = await validateApiKey(apiKey.trim());
-  if (isValid) {
+  const result = await validateApiKey(apiKey.trim());
+  if (result.valid) {
     await setApiKey(apiKey.trim());
+    const keychainAvailable = await isKeychainAvailable();
     spinner.succeed("API key validated and stored securely");
-    console.log(
-      successBox(
-        "Authentication Complete",
-        `API key stored in OS keychain
+    if (keychainAvailable) {
+      console.log(
+        successBox(
+          "Authentication Complete",
+          `API key stored in OS keychain
 Key: ${colors.gold(apiKey.trim().slice(0, 6) + "..." + apiKey.trim().slice(-4))}`
-      )
-    );
+        )
+      );
+    } else {
+      console.log(
+        successBox(
+          "Authentication Complete",
+          `Key: ${colors.gold(apiKey.trim().slice(0, 6) + "..." + apiKey.trim().slice(-4))}`
+        )
+      );
+      console.log(
+        warningBox(
+          "Plaintext Storage Warning",
+          `The OS keychain (keytar) is not available on this system.
+Your API key is stored in plaintext in the local config file.
+
+To use secure storage, install the keytar native module or set
+the ${colors.accent("GOLDRUSH_API_KEY")} environment variable instead.`
+        )
+      );
+    }
   } else {
     spinner.fail("Invalid API key");
     console.log(
       errorBox(
         "Authentication Failed",
-        "The API key could not be validated.\nGet a key at https://goldrush.dev/platform/apikey/"
+        result.error_message || "The API key could not be validated.\nGet a key at https://goldrush.dev/platform/apikey/"
       )
     );
   }
@@ -4816,7 +4853,7 @@ var configCommand = new Command4("config").description("View or update GoldRush
   console.log(
     infoBox(
       "Current Settings",
-      `Port:           ${colors.gold(String(config2.port))}
+      `Proxy Port:     ${colors.gold(String(config2.port))}
 Default Chain:  ${colors.accent(config2.defaultChain)}
 Quote Currency: ${colors.gold(config2.quoteCurrency)}`
     )
@@ -4824,7 +4861,7 @@ Quote Currency: ${colors.gold(config2.quoteCurrency)}`
   const action = await select({
     message: "What would you like to update?",
     choices: [
-      { name: `Port (${config2.port})`, value: "port" },
+      { name: `Proxy Port (${config2.port})`, value: "port" },
       {
         name: `Default Chain (${config2.defaultChain})`,
         value: "chain"
@@ -4952,9 +4989,15 @@ var gasCommand = new Command5("gas").description("Get real-time gas price estima
   if (!eventType) {
     console.log(
       errorBox(
-        "Invalid Type",
-        `Unknown transaction type: ${options.type}
-Valid types: erc20, native, swap`
+        "Invalid Transaction Type",
+        `"${colors.accent(options.type)}" is not a valid transaction type.
+
+Valid values:
+  ${colors.gold("erc20")}   \u2014 ERC-20 token transfer gas estimates
+  ${colors.gold("native")}  \u2014 Native token transfer gas estimates
+  ${colors.gold("swap")}    \u2014 Uniswap v3 swap gas estimates
+
+Example: ${colors.accent(`goldrush gas eth-mainnet --type swap`)}`
       )
     );
     return;
@@ -5571,7 +5614,6 @@ async function subscribeToWalletActivity(chainName, walletAddresses, callback) {
     },
     {
       next: (events) => {
-        infoBox(JSON.stringify(events, null, 2), "Wallet Activity");
         for (const event of events) {
           const decodedType = parseDecodedType(event.decoded_type);
           const { summary, quoteUsd, tokenSymbol } = buildDetailsSummary(decodedType, event.decoded_details);
@@ -5606,9 +5648,39 @@ async function subscribeToWalletActivity(chainName, walletAddresses, callback) {
   return unsubscribe;
 }
 
+// src/utils/clipboard.ts
+import { execSync } from "child_process";
+function copyToClipboard(text) {
+  const platform = process.platform;
+  try {
+    if (platform === "darwin") {
+      execSync("pbcopy", { input: text });
+      return true;
+    }
+    if (platform === "win32") {
+      execSync(
+        `powershell -NoProfile -Command "$input | Set-Clipboard"`,
+        { input: text }
+      );
+      return true;
+    }
+    if (platform === "linux") {
+      try {
+        execSync("xclip -selection clipboard", { input: text });
+        return true;
+      } catch {
+        execSync("xsel --clipboard --input", { input: text });
+        return true;
+      }
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+
 // src/commands/newpairs.ts
 import { Command as Command9 } from "commander";
-import { execSync } from "child_process";
 var newpairsCommand = new Command9("new_pairs").description("Fetch the latest new DEX liquidity pairs").argument("[chain]", "Blockchain name (e.g. eth-mainnet)").argument(
   "[protocols...]",
   "Filter by DEX protocol(s) (e.g. uniswap-v2 raydium-amm)"
@@ -5706,14 +5778,6 @@ Supported protocols:
     function getPairsArray() {
       return [...pairMap.values()].reverse().slice(0, limit);
     }
-    function copyToClipboard(text) {
-      try {
-        execSync("pbcopy", { input: text });
-        return true;
-      } catch {
-        return false;
-      }
-    }
     function rerender() {
       const pairs = getPairsArray();
       if (selectedRow >= pairs.length) {
@@ -6175,12 +6239,19 @@ var asciiArt = [
   "  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550 Terminal-first blockchain data & trading \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550",
   "                  \u2550\u2550\u2550\u2550\u2550\u2550 powered by Covalent \u2550\u2550\u2550\u2550\u2550\u2550"
 ];
-function printLogo() {
+function printLogo(version) {
   console.log();
   for (let i = 0; i < asciiArt.length; i++) {
     const colorIdx = Math.min(i, gradientStops.length - 1);
     console.log(chalk5.hex(gradientStops[colorIdx])(asciiArt[i]));
   }
+  if (version) {
+    console.log(
+      chalk5.hex(gradientStops[gradientStops.length - 1])(
+        `                              v${version}`
+      )
+    );
+  }
   console.log();
 }
 
@@ -6404,8 +6475,11 @@ async function startProxyServer(port) {
     );
     process.exit(1);
   }
-  const sessionToken = crypto.randomBytes(32).toString("hex");
-  await setSessionToken(sessionToken);
+  let sessionToken = await getSessionToken();
+  if (!sessionToken) {
+    sessionToken = crypto.randomBytes(32).toString("hex");
+    await setSessionToken(sessionToken);
+  }
   const app = express();
   app.use(express.json());
   app.use(bodySizeLimit);
@@ -6415,7 +6489,7 @@ async function startProxyServer(port) {
   app.get("/tools", toolsHandler);
   app.post("/call", callHandler);
   const server = app.listen(serverPort, () => {
-    printLogo();
+    printLogo(package_default.version);
     console.log(
       successBox(
         "Proxy Server Running",
@@ -6452,11 +6526,19 @@ var proxyCommand = new Command11("proxy").description("Launch the GoldRush proxy
 });
 
 // src/api/search.ts
+var SearchTimeoutError = class extends Error {
+  constructor() {
+    super(
+      "Search request timed out. The streaming service did not respond within 15 seconds."
+    );
+    this.name = "SearchTimeoutError";
+  }
+};
 var SEARCH_TOKEN_QUERY = `
 query SearchToken($query: String!) {
   searchToken(query: $query) {
     pair_address
-    chain
+    chain_name
     quote_rate
     quote_rate_usd
     volume
@@ -6484,11 +6566,11 @@ async function searchTokens(query) {
       { query },
       {
         next: (data) => {
-          const items = data?.searchToken ?? data ?? [];
+          const items = data?.data?.searchToken ?? data?.searchToken ?? data;
           const list = Array.isArray(items) ? items : [];
           results = list.map((item) => ({
             pairAddress: item.pair_address ?? "",
-            chain: item.chain ?? "",
+            chain: item.chain_name ?? item.chain ?? "",
             quoteRate: item.quote_rate ?? 0,
             quoteRateUsd: item.quote_rate_usd ?? 0,
             volume: item.volume ?? 0,
@@ -6515,7 +6597,13 @@ async function searchTokens(query) {
         }
       }
     );
-    setTimeout(() => resolve2(results), 15e3);
+    setTimeout(() => {
+      if (results.length === 0) {
+        reject(new SearchTimeoutError());
+      } else {
+        resolve2(results);
+      }
+    }, 15e3);
   });
 }
 
@@ -6564,8 +6652,21 @@ Results: ${colors.gold(String(results.length))} (sorted by volume)`
     );
     renderSearchResultsTable(results);
   } catch (err) {
-    spinner.fail("Search failed");
-    console.log(errorBox("Error", err.message));
+    if (err instanceof SearchTimeoutError) {
+      spinner.warn("Request timed out");
+      console.log(
+        warningBox(
+          "Search Timed Out",
+          `No response from the streaming service within 15 seconds.
+
+Try again or check your connection.
+Run ${colors.accent("goldrush status")} to verify your API key.`
+        )
+      );
+    } else {
+      spinner.fail("Search failed");
+      console.log(errorBox("Error", err.message));
+    }
   }
 });
 
@@ -6592,11 +6693,13 @@ Proxy Port: ${colors.accent(String(port))}`
   } else {
     const spinner = createSpinner("Validating API key...");
     spinner.start();
-    const valid = await validateApiKey(apiKey);
-    if (valid) {
+    const result = await validateApiKey(apiKey);
+    if (result.valid) {
       spinner.succeed("API key is valid");
     } else {
-      spinner.fail("API key is invalid or expired");
+      spinner.fail(
+        `API key is invalid or expired${result.error_message ? `: ${result.error_message}` : ""}`
+      );
     }
   }
   const proxySpinner = createSpinner(
@@ -6615,12 +6718,20 @@ Proxy Port: ${colors.accent(String(port))}`
     }
   } catch {
     proxySpinner.warn(
-      `Proxy server not reachable on port ${port}. Run \`goldrush start\` to launch it.`
+      `Proxy server not reachable on port ${port}. Run \`goldrush proxy\` to launch it.`
     );
   }
 });
 
 // src/api/traders.ts
+var TradersTimeoutError = class extends Error {
+  constructor() {
+    super(
+      "Traders request timed out. The streaming service did not respond within 15 seconds."
+    );
+    this.name = "TradersTimeoutError";
+  }
+};
 var UPNL_FOR_TOKEN_QUERY = `
 query UpnlForToken($chain_name: ChainName!, $token_address: String!) {
   upnlForToken(chain_name: $chain_name, token_address: $token_address) {
@@ -6680,7 +6791,13 @@ async function getTopTraders(chainName, tokenAddress) {
         }
       }
     );
-    setTimeout(() => resolve2(results), 15e3);
+    setTimeout(() => {
+      if (results.length === 0) {
+        reject(new TradersTimeoutError());
+      } else {
+        resolve2(results);
+      }
+    }, 15e3);
   });
 }
 
@@ -6747,8 +6864,21 @@ Traders: ${colors.gold(String(traders.length))}`
       );
       renderTopTradersTable(traders);
     } catch (err) {
-      spinner.fail("Failed to fetch top traders");
-      console.log(errorBox("Error", err.message));
+      if (err instanceof TradersTimeoutError) {
+        spinner.warn("Request timed out");
+        console.log(
+          warningBox(
+            "Traders Query Timed Out",
+            `No response from the streaming service within 15 seconds.
+
+Make sure the token address is on a supported streaming chain.
+Run ${colors.accent("goldrush status")} to verify your API key.`
+          )
+        );
+      } else {
+        spinner.fail("Failed to fetch top traders");
+        console.log(errorBox("Error", err.message));
+      }
     }
   }
 );
@@ -6850,7 +6980,6 @@ Showing: ${colors.gold(String(transfers.length))} most recent`
 // src/commands/watch.ts
 import { input as input7 } from "@inquirer/prompts";
 import { Command as Command16 } from "commander";
-import { execSync as execSync2 } from "child_process";
 var watchCommand = new Command16("watch").description("Stream live wallet activity (transactions, transfers, swaps)").argument("[address]", "Wallet address to watch").argument("[chain]", "Blockchain name (e.g. eth-mainnet)").option("-l, --limit <number>", "Max rows to display", "20").action(
   async (address, chain, opts) => {
     if (!await isAuthenticated()) {
@@ -6865,8 +6994,17 @@ var watchCommand = new Command16("watch").description("Stream live wallet activi
     let walletAddress = address;
     if (!walletAddress) {
       walletAddress = await input7({
-        message: colors.primary("Wallet address to watch:"),
-        validate: (val) => /^0x[a-fA-F0-9]{40}$/.test(val.trim()) ? true : "Enter a valid EVM address (0x...)"
+        message: colors.primary(
+          "Wallet address or ENS name to watch:"
+        ),
+        validate: (val) => {
+          const v = val.trim();
+          if (!v) return "Please enter an address or ENS name.";
+          if (/^0x[a-fA-F0-9]{40}$/.test(v) || /^[a-zA-Z0-9-]+(\.[a-zA-Z0-9-]+)*\.eth$/.test(v)) {
+            return true;
+          }
+          return "Enter a valid EVM address (0x\u202640 hex chars) or ENS name (e.g. vitalik.eth).";
+        }
       });
       walletAddress = walletAddress.trim();
     }
@@ -6931,14 +7069,6 @@ Run ${colors.accent("goldrush chains")} for details.`
     function getDisplayActivities() {
       return activities.slice(0, limit);
     }
-    function copyToClipboard(text) {
-      try {
-        execSync2("pbcopy", { input: text });
-        return true;
-      } catch {
-        return false;
-      }
-    }
     function rerender() {
       const display = getDisplayActivities();
       if (selectedRow >= display.length) {
@@ -7110,7 +7240,7 @@ program.addCommand(mcpCommand);
 program.addCommand(chainsCommand);
 program.addCommand(watchCommand);
 program.action(async () => {
-  printLogo();
+  printLogo(package_default.version);
   const action = await select3({
     message: colors.primary("What would you like to do?"),
     choices: [