@clawdvault/cli 0.3.3 → 0.4.0

package/README.md

@@ -64,6 +64,37 @@ clawdvault trade sell --mint TOKEN_MINT_ADDRESS --amount 1000000
 clawdvault trade sell --mint TOKEN_MINT_ADDRESS --percent 50
 ```
 
+## USD Price Display
+
+As of v0.4.0, the CLI displays USD prices by default for all price and market cap values:
+
+```bash
+# Token list shows USD price and market cap
+clawdvault tokens list
+# Output: SYMBOL | Name | $0.001234 | $50,000 | ...
+
+# Token details shows USD with SOL in parentheses
+clawdvault token get <mint>
+# Output: Price: $0.001234 (0.00000678 SOL)
+
+# Stats shows USD market cap
+clawdvault token stats <mint>
+# Output: Market Cap: $50,000
+
+# Trade history shows USD prices
+clawdvault trade history -m <mint>
+# Output: Shows price_usd for each trade
+
+# Candles default to USD
+clawdvault token candles <mint>
+# Output: OHLCV values in USD
+
+# Use --currency sol for SOL-denominated candles
+clawdvault token candles <mint> --currency sol
+```
+
+**Breaking Change:** Previous versions displayed SOL values by default. USD is now the default currency for price display.
+
 ## Commands Reference
 
 ### `clawdvault tokens`
@@ -112,10 +143,18 @@ clawdvault token stats <mint> [--json]
 # Get top holders
 clawdvault token holders <mint> [--json]
 
+# Get price candles
+clawdvault token candles <mint> [options]
+  -i, --interval <interval>  Candle interval: 1m, 5m, 15m, 1h, 1d (default: 5m)
+  -l, --limit <count>        Number of candles (default: 100)
+  -c, --currency <currency>  Currency: sol or usd (default: usd)
+  --json                     Output as JSON
+
 Examples:
   clawdvault token get 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
   clawdvault token create -n "Moon Token" -s "MOON" -i ./moon.png
   clawdvault token create --name "Test" --symbol "TEST" --initial-buy 0.5
+  clawdvault token candles <mint> --interval 15m --currency usd
 ```
 
 ### `clawdvault trade`

package/dist/index.js

@@ -163,7 +163,13 @@ function formatTokens(amount) {
   return amount.toFixed(2);
 }
 function formatUsd(amount) {
-  return `$${amount.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+  const absAmount = Math.abs(amount);
+  let maximumFractionDigits = 2;
+  if (absAmount < 1e-6) maximumFractionDigits = 10;
+  else if (absAmount < 1e-4) maximumFractionDigits = 8;
+  else if (absAmount < 0.01) maximumFractionDigits = 6;
+  else if (absAmount < 1) maximumFractionDigits = 4;
+  return `$${amount.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits })}`;
 }
 function formatPercent(value) {
   const formatted = (value * 100).toFixed(2);
@@ -249,8 +255,8 @@ tokensCommand.command("list").description("List all tokens").option("-s, --sort
       table.push([
         import_chalk2.default.bold(token.symbol ?? "???"),
         token.name ?? "Unknown",
-        formatSol(token.price_sol ?? 0),
-        formatSol(token.market_cap_sol ?? 0),
+        formatUsd(token.price_usd ?? 0),
+        formatUsd(token.market_cap_usd ?? 0),
         token.volume_24h ? formatSol(token.volume_24h) : "-",
         status,
         shortenAddress(token.mint ?? "")
@@ -301,8 +307,8 @@ tokenCommand.command("get <mint>").description("Get token details").option("--js
     table.push(
       { [import_chalk3.default.cyan("Mint")]: token.mint ?? "" },
       { [import_chalk3.default.cyan("Creator")]: shortenAddress(token.creator ?? "") },
-      { [import_chalk3.default.cyan("Price")]: formatSol(token.price_sol ?? 0) },
-      { [import_chalk3.default.cyan("Market Cap")]: formatSol(token.market_cap_sol ?? 0) },
+      { [import_chalk3.default.cyan("Price")]: `${formatUsd(token.price_usd ?? 0)} (${formatSol(token.price_sol ?? 0)})` },
+      { [import_chalk3.default.cyan("Market Cap")]: formatUsd(token.market_cap_usd ?? 0) },
       { [import_chalk3.default.cyan("Status")]: token.graduated ? "\u{1F393} Graduated" : "\u{1F4C8} Bonding Curve" }
     );
     if (token.description) {
@@ -327,6 +333,7 @@ tokenCommand.command("get <mint>").description("Get token details").option("--js
           import_chalk3.default.cyan("Type"),
           import_chalk3.default.cyan("SOL"),
           import_chalk3.default.cyan("Tokens"),
+          import_chalk3.default.cyan("Price USD"),
           import_chalk3.default.cyan("Trader"),
           import_chalk3.default.cyan("Time")
         ],
@@ -338,6 +345,7 @@ tokenCommand.command("get <mint>").description("Get token details").option("--js
           typeStr,
           formatSol(trade.sol_amount ?? 0),
           formatTokens(trade.token_amount ?? 0),
+          formatUsd(trade.price_usd ?? 0),
           shortenAddress(trade.trader ?? ""),
           new Date(trade.created_at ?? Date.now()).toLocaleString()
         ]);
@@ -418,12 +426,13 @@ tokenCommand.command("stats <mint>").description("Get on-chain stats").option("-
       style: { head: [], border: [] }
     });
     table.push(
-      { [import_chalk3.default.cyan("Price")]: formatSol(onChain.price ?? 0) },
-      { [import_chalk3.default.cyan("Market Cap")]: formatSol(onChain.marketCap ?? 0) },
+      { [import_chalk3.default.cyan("Price")]: `${formatUsd(onChain.priceUsd ?? 0)} (${formatSol(onChain.price ?? 0)})` },
+      { [import_chalk3.default.cyan("Market Cap")]: formatUsd(onChain.marketCapUsd ?? 0) },
       { [import_chalk3.default.cyan("Total Supply")]: formatTokens(onChain.totalSupply ?? 0) },
       { [import_chalk3.default.cyan("Circulating")]: formatTokens(onChain.circulatingSupply ?? 0) },
       { [import_chalk3.default.cyan("Curve Balance")]: formatTokens(onChain.bondingCurveBalance ?? 0) },
       { [import_chalk3.default.cyan("Curve SOL")]: formatSol(onChain.bondingCurveSol ?? 0) },
+      { [import_chalk3.default.cyan("SOL Price")]: formatUsd(onChain.solPriceUsd ?? 0) },
       { [import_chalk3.default.cyan("Status")]: onChain.graduated ? "\u{1F393} Graduated" : "\u{1F4C8} Bonding" }
     );
     console.log(table.toString());
@@ -472,6 +481,61 @@ tokenCommand.command("holders <mint>").description("Get top token holders").opti
     handleError(err);
   }
 });
+tokenCommand.command("candles <mint>").description("Get price candles").option("-i, --interval <interval>", "Candle interval (1m, 5m, 15m, 1h, 1d)", "5m").option("-l, --limit <count>", "Number of candles to fetch", "100").option("-c, --currency <currency>", "Currency for prices (sol or usd)", "usd").option("--json", "Output as JSON").action(async (mint, options) => {
+  const spin = spinner("Fetching candles...").start();
+  try {
+    const client = createReadOnlyClient();
+    const result = await client.getCandles({
+      mint,
+      interval: options.interval,
+      limit: parseInt(options.limit),
+      currency: options.currency
+    });
+    spin.stop();
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    console.log(import_chalk3.default.bold(`
+\u{1F4CA} Price Candles (${options.currency.toUpperCase()})
+`));
+    const candles = result.candles ?? [];
+    if (candles.length === 0) {
+      console.log(import_chalk3.default.yellow("No candles available"));
+      return;
+    }
+    const table = new import_cli_table32.default({
+      head: [
+        import_chalk3.default.cyan("Time"),
+        import_chalk3.default.cyan("Open"),
+        import_chalk3.default.cyan("High"),
+        import_chalk3.default.cyan("Low"),
+        import_chalk3.default.cyan("Close"),
+        import_chalk3.default.cyan("Volume")
+      ],
+      style: { head: [], border: [] }
+    });
+    const isUsd = options.currency === "usd";
+    const formatPrice = isUsd ? formatUsd : formatSol;
+    candles.slice(-20).forEach((c) => {
+      table.push([
+        new Date(c.time * 1e3).toLocaleString(),
+        formatPrice(c.open),
+        formatPrice(c.high),
+        formatPrice(c.low),
+        formatPrice(c.close),
+        formatTokens(c.volume)
+      ]);
+    });
+    console.log(table.toString());
+    console.log();
+    console.log(import_chalk3.default.gray(`Showing last ${Math.min(20, candles.length)} of ${candles.length} candles`));
+    console.log();
+  } catch (err) {
+    spin.stop();
+    handleError(err);
+  }
+});
 
 // src/commands/trade.ts
 var import_commander3 = require("commander");
@@ -499,7 +563,7 @@ tradeCommand.command("buy").description("Buy tokens").requiredOption("-m, --mint
     table.push(
       { [import_chalk4.default.cyan("Input")]: `${solAmount} SOL` },
       { [import_chalk4.default.cyan("Output")]: `~${formatTokens(quote.output ?? 0)} tokens` },
-      { [import_chalk4.default.cyan("Price")]: formatSol(quote.current_price ?? 0) },
+      { [import_chalk4.default.cyan("Price per Token")]: formatSol(quote.current_price ?? 0) },
       { [import_chalk4.default.cyan("Fee")]: formatSol(quote.fee ?? 0) },
       { [import_chalk4.default.cyan("Price Impact")]: formatPercent(priceImpact) },
       { [import_chalk4.default.cyan("Slippage")]: `${(slippage * 100).toFixed(1)}%` }
@@ -577,7 +641,7 @@ tradeCommand.command("sell").description("Sell tokens").requiredOption("-m, --mi
     table.push(
       { [import_chalk4.default.cyan("Input")]: `${formatTokens(tokenAmount)} tokens` },
       { [import_chalk4.default.cyan("Output")]: `~${formatSol(quote.output ?? 0)}` },
-      { [import_chalk4.default.cyan("Price")]: formatSol(quote.current_price ?? 0) },
+      { [import_chalk4.default.cyan("Price per Token")]: formatSol(quote.current_price ?? 0) },
       { [import_chalk4.default.cyan("Fee")]: formatSol(quote.fee ?? 0) },
       { [import_chalk4.default.cyan("Price Impact")]: formatPercent(-sellPriceImpact) },
       { [import_chalk4.default.cyan("Slippage")]: `${(slippage * 100).toFixed(1)}%` }
@@ -639,7 +703,7 @@ tradeCommand.command("quote").description("Get a price quote without executing")
     table.push(
       { [import_chalk4.default.cyan("Input")]: isBuy ? `${options.amount} SOL` : `${formatTokens(parseFloat(options.amount))} tokens` },
       { [import_chalk4.default.cyan("Output")]: isBuy ? `~${formatTokens(quote.output ?? 0)} tokens` : `~${formatSol(quote.output ?? 0)}` },
-      { [import_chalk4.default.cyan("Price")]: formatSol(quote.current_price ?? 0) },
+      { [import_chalk4.default.cyan("Price per Token")]: formatSol(quote.current_price ?? 0) },
       { [import_chalk4.default.cyan("Fee")]: formatSol(quote.fee ?? 0) },
       { [import_chalk4.default.cyan("Price Impact")]: formatPercent(isBuy ? quotePriceImpact : -quotePriceImpact) }
     );
@@ -671,7 +735,7 @@ tradeCommand.command("history").description("Get trade history for a token").req
         import_chalk4.default.cyan("Type"),
         import_chalk4.default.cyan("SOL"),
         import_chalk4.default.cyan("Tokens"),
-        import_chalk4.default.cyan("Price"),
+        import_chalk4.default.cyan("Price USD"),
         import_chalk4.default.cyan("Trader"),
         import_chalk4.default.cyan("Time")
       ],
@@ -683,7 +747,7 @@ tradeCommand.command("history").description("Get trade history for a token").req
         typeStr,
         formatSol(trade.sol_amount ?? 0),
         formatTokens(trade.token_amount ?? 0),
-        formatSol(trade.price ?? 0),
+        formatUsd(trade.price_usd ?? 0),
         shortenAddress(trade.trader ?? ""),
         new Date(trade.created_at ?? Date.now()).toLocaleString()
       ]);
@@ -1295,7 +1359,7 @@ chatCommand.command("unreact").description("Remove reaction from a message").req
 
 // src/index.ts
 var program = new import_commander6.Command();
-program.name("clawdvault").description("CLI for ClawdVault - Solana token launchpad").version("0.1.0");
+program.name("clawdvault").description("CLI for ClawdVault - Solana token launchpad").version("0.4.0");
 program.addCommand(tokensCommand);
 program.addCommand(tokenCommand);
 program.addCommand(tradeCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawdvault/cli",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "CLI for ClawdVault - Solana token launchpad",
   "main": "dist/index.js",
   "bin": {
@@ -15,7 +15,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@clawdvault/sdk": "^0.3.2",
+    "@clawdvault/sdk": "^0.4.0",
     "@solana/spl-token": "^0.4.0",
     "@solana/web3.js": "^1.91.0",
     "bip39": "^3.1.0",