@clawdvault/cli 0.1.1 → 0.1.3

package/README.md

@@ -1,5 +1,8 @@
 # @clawdvault/cli
 
+[![npm version](https://img.shields.io/npm/v/@clawdvault/cli.svg)](https://www.npmjs.com/package/@clawdvault/cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 Command-line interface for [ClawdVault](https://clawdvault.com) - a pump.fun-style token launchpad on Solana.
 
 ## Installation
@@ -16,7 +19,7 @@ npx @clawdvault/cli tokens list
 
 ## Quick Start
 
-### Setup Wallet
+### 1. Setup Wallet
 
 ```bash
 # Generate a new wallet
@@ -26,7 +29,7 @@ clawdvault wallet init
 export CLAWDVAULT_WALLET=~/.config/solana/id.json
 ```
 
-### Read Operations (No Wallet Required)
+### 2. Read Operations (No Wallet Required)
 
 ```bash
 # List featured tokens
@@ -42,7 +45,7 @@ clawdvault trade quote -m TOKEN_MINT_ADDRESS -t buy -a 0.1
 clawdvault wallet sol-price
 ```
 
-### Write Operations (Wallet Required)
+### 3. Write Operations (Wallet Required)
 
 ```bash
 # Create a new token
@@ -56,28 +59,185 @@ clawdvault trade sell --mint TOKEN_MINT_ADDRESS --amount 1000000
 
 # Sell by percentage
 clawdvault trade sell --mint TOKEN_MINT_ADDRESS --percent 50
+```
+
+## Commands Reference
 
-# Native SOL transfer
-clawdvault wallet transfer --to RECIPIENT_ADDRESS --sol 0.5
+### `clawdvault tokens`
+
+List and filter tokens.
+
+```bash
+clawdvault tokens list [options]
+
+Options:
+  -s, --sort <field>     Sort by: created_at, market_cap, volume, price
+  -p, --page <number>    Page number (default: 1)
+  -l, --limit <number>   Items per page (default: 20)
+  --graduated            Show only graduated tokens
+  --not-graduated        Show only non-graduated tokens
+  --json                 Output as JSON
+
+Examples:
+  clawdvault tokens list --sort market_cap --limit 10
+  clawdvault tokens list --graduated --json
 ```
 
-### Wallet Operations
+### `clawdvault token`
+
+Token details and creation.
 
 ```bash
-# Show wallet info
-clawdvault wallet info
+# Get token details
+clawdvault token get <mint> [--json]
+
+# Create a new token
+clawdvault token create [options]
+  -n, --name <name>           Token name (required)
+  -s, --symbol <symbol>       Token symbol (required)
+  -d, --description <desc>    Description
+  -i, --image <path>          Image file path (png, jpg, gif)
+  --initial-buy <sol>         Initial buy amount in SOL
+  --twitter <url>             Twitter URL
+  --telegram <url>            Telegram URL
+  --website <url>             Website URL
+  -w, --wallet <path>         Wallet file path
+
+# Get on-chain stats
+clawdvault token stats <mint> [--json]
+
+# Get top holders
+clawdvault token holders <mint> [--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 trade`
+
+Buy, sell, and get quotes.
+
+```bash
+# Buy tokens
+clawdvault trade buy [options]
+  -m, --mint <address>     Token mint address (required)
+  -a, --sol <amount>       SOL amount to spend (required)
+  -s, --slippage <percent> Slippage tolerance (default: 1)
+  -w, --wallet <path>      Wallet file path
+  --simulate               Simulate only, don't execute
+
+# Sell tokens
+clawdvault trade sell [options]
+  -m, --mint <address>     Token mint address (required)
+  -a, --amount <tokens>    Token amount to sell
+  -p, --percent <percent>  Percentage of holdings to sell
+  -s, --slippage <percent> Slippage tolerance (default: 1)
+  -w, --wallet <path>      Wallet file path
+  --simulate               Simulate only, don't execute
+
+Note: Use either --amount or --percent, not both.
+
+# Get price quote
+clawdvault trade quote [options]
+  -m, --mint <address>     Token mint address (required)
+  -t, --type <type>        Quote type: buy or sell (required)
+  -a, --amount <amount>    Amount (SOL for buy, tokens for sell)
+  --json                   Output as JSON
+
+# View trade history
+clawdvault trade history [options]
+  -m, --mint <address>     Token mint address (required)
+  -l, --limit <number>     Number of trades (default: 20)
+  --json                   Output as JSON
+
+Examples:
+  clawdvault trade buy -m TOKEN_MINT -a 0.1
+  clawdvault trade buy -m TOKEN_MINT -a 0.5 -s 2 --simulate
+  clawdvault trade sell -m TOKEN_MINT -p 50
+  clawdvault trade sell -m TOKEN_MINT -a 1000000
+  clawdvault trade quote -m TOKEN_MINT -t buy -a 0.1
+```
+
+### `clawdvault stream`
+
+Real-time data streaming (live trades, prices, chat).
 
-# Check SOL balance
-clawdvault wallet sol-balance
+```bash
+# Stream live trades
+clawdvault stream trades [options]
+  -m, --mint <address>     Token mint address (required)
+  --json                   Output as JSON (one object per line)
+  --append                 Append mode (simple log format)
+
+# Stream token price updates
+clawdvault stream token [options]
+  -m, --mint <address>     Token mint address (required)
+  --json                   Output as JSON
+
+# Stream chat messages
+clawdvault stream chat [options]
+  -m, --mint <address>     Token mint address (required)
+  --json                   Output as JSON
+
+Examples:
+  # Watch trades in real-time (table mode)
+  clawdvault stream trades -m TOKEN_MINT
+
+  # Watch trades for scripting (JSON output)
+  clawdvault stream trades -m TOKEN_MINT --json
+
+  # Log trades to file
+  clawdvault stream trades -m TOKEN_MINT --append >> trades.log
+
+  # Monitor price changes
+  clawdvault stream token -m TOKEN_MINT
+
+  # Watch chat
+  clawdvault stream chat -m TOKEN_MINT
+
+  # Pipe to jq for filtering
+  clawdvault stream trades -m TOKEN_MINT --json | jq 'select(.type == "buy")'
+```
+
+**Features:**
+- Auto-reconnect on connection loss
+- Graceful shutdown with Ctrl+C
+- Multiple output modes: table (default), append, JSON
+- Table mode clears and updates in-place
+- JSON mode outputs one object per line (great for piping)
+
+### `clawdvault wallet`
+
+Wallet management and info.
+
+```bash
+# Show wallet info (address, SOL balance)
+clawdvault wallet info [-w, --wallet <path>]
+
+# Generate new wallet
+clawdvault wallet init [-o, --output <path>] [--force]
+  Default output: ~/.clawdvault/wallet.json
+
+# Get wallet address only
+clawdvault wallet address [-w, --wallet <path>]
 
 # Check token balance
-clawdvault wallet balance -m TOKEN_MINT_ADDRESS
+clawdvault wallet balance -m, --mint <address> [-w, --wallet <path>]
 
-# Get deposit address
-clawdvault wallet address
+# Network status
+clawdvault wallet network [--json]
+
+# Current SOL/USD price
+clawdvault wallet sol-price [--json]
 
-# Request devnet SOL (devnet only)
-clawdvault wallet airdrop --sol 1
+Examples:
+  clawdvault wallet init
+  clawdvault wallet init -o ~/my-wallet.json
+  clawdvault wallet info
+  clawdvault wallet balance -m TOKEN_MINT
+  clawdvault wallet address
 ```
 
 ## Configuration
@@ -85,24 +245,34 @@ clawdvault wallet airdrop --sol 1
 ### Environment Variables
 
 ```bash
-# Wallet path
+# Wallet path (overrides default locations)
 export CLAWDVAULT_WALLET=~/.config/solana/id.json
 
 # Custom API endpoint
 export CLAWDVAULT_API_URL=https://clawdvault.com/api
 
-# Solana RPC (default: mainnet)
+# Solana RPC endpoint (default: mainnet)
+export SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
+# For devnet testing:
 export SOLANA_RPC_URL=https://api.devnet.solana.com
 ```
 
+### Wallet Lookup Order
+
+1. `--wallet` / `-w` flag
+2. `CLAWDVAULT_WALLET` environment variable
+3. `~/.clawdvault/wallet.json`
+4. `~/.config/solana/id.json` (Solana CLI default)
+
 ### Global Options
 
 All commands support:
 
 ```bash
--w, --wallet <path>    # Specify wallet file
---rpc <url>            # Specify RPC endpoint
---json                 # Output as JSON
+-w, --wallet <path>    Specify wallet file
+--rpc <url>            Specify RPC endpoint  
+--json                 Output as JSON (where applicable)
+-h, --help             Show help
 ```
 
 ## Examples
@@ -113,34 +283,129 @@ All commands support:
 # 1. Generate wallet (first time only)
 clawdvault wallet init
 
-# 2. Check your address
+# 2. Check your address and fund with SOL
 clawdvault wallet address
+# Send SOL to this address from an exchange or another wallet
 
-# 3. Fund with SOL (or use airdrop on devnet)
-clawdvault wallet airdrop --sol 2
+# 3. Verify SOL balance
+clawdvault wallet info
 
-# 4. Create token
+# 4. Create your token
 clawdvault token create \
   --name "Moon Shot" \
   --symbol "MOON" \
-  --description "To the moon!" \
+  --description "To the moon! 🚀" \
   --image ./moon.png \
-  --twitter @moonshot \
-  --website https://moonshot.io
+  --twitter https://twitter.com/moonshot \
+  --website https://moonshot.io \
+  --initial-buy 0.1
 
-# 5. Check your token
+# 5. Check your new token
 clawdvault token get YOUR_TOKEN_MINT
 
-# 6. Buy more (optional)
-clawdvault trade buy --mint YOUR_TOKEN_MINT --sol 0.5
+# 6. View it on ClawdVault
+echo "https://clawdvault.com/token/YOUR_TOKEN_MINT"
+```
+
+### Trading Workflow
+
+```bash
+# Get a quote first
+clawdvault trade quote -m TOKEN_MINT -t buy -a 0.5
+
+# Simulate the trade (dry run)
+clawdvault trade buy -m TOKEN_MINT -a 0.5 --simulate
+
+# Execute the trade
+clawdvault trade buy -m TOKEN_MINT -a 0.5
+
+# Check your balance
+clawdvault wallet balance -m TOKEN_MINT
+
+# Take profits - sell 25%
+clawdvault trade sell -m TOKEN_MINT -p 25
+
+# Or sell specific amount
+clawdvault trade sell -m TOKEN_MINT -a 500000
+```
+
+### Monitoring
+
+```bash
+# Check token stats
+clawdvault token stats TOKEN_MINT --json
+
+# View recent trades
+clawdvault trade history -m TOKEN_MINT -l 50
+
+# Check top holders
+clawdvault token holders TOKEN_MINT
 ```
 
 ## Network Support
 
-- **Mainnet**: Production trading with real SOL
-- **Devnet**: Free testing with faucet SOL
+| Network | RPC URL | Notes |
+|---------|---------|-------|
+| Mainnet | `https://api.mainnet-beta.solana.com` | Production (default) |
+| Devnet | `https://api.devnet.solana.com` | Free testing |
+
+```bash
+# Use devnet for testing
+export SOLANA_RPC_URL=https://api.devnet.solana.com
+clawdvault tokens list
+```
+
+## Troubleshooting
+
+### "Error: Wallet not found"
+```bash
+# Generate a new wallet
+clawdvault wallet init
+
+# Or set path to existing wallet
+export CLAWDVAULT_WALLET=~/.config/solana/id.json
+```
+
+### "Error: Insufficient SOL balance"
+Your wallet needs SOL for transaction fees:
+```bash
+clawdvault wallet info  # Check balance
+# Fund your wallet address with SOL
+```
+
+### "Error: Slippage exceeded"
+Price moved during transaction. Increase slippage:
+```bash
+clawdvault trade buy -m MINT -a 0.1 -s 5  # 5% slippage
+```
+
+### "Error: Token not found"
+- Verify the mint address is correct
+- Token may not be indexed yet (wait a few seconds after creation)
+
+### Transaction stuck/pending
+- Solana network may be congested
+- Check transaction on [Solscan](https://solscan.io)
+- Try again with higher priority fee (coming soon)
+
+### Debug mode
+Add `DEBUG=clawdvault:*` for verbose logging:
+```bash
+DEBUG=clawdvault:* clawdvault trade buy -m MINT -a 0.1
+```
+
+## Programmatic Usage
+
+You can also use the CLI from Node.js scripts:
+
+```typescript
+import { execSync } from 'child_process';
+
+const result = execSync('clawdvault tokens list --json', { encoding: 'utf-8' });
+const tokens = JSON.parse(result);
+```
 
-Use `--rpc https://api.devnet.solana.com` or set `SOLANA_RPC_URL` for devnet.
+For more control, use the [@clawdvault/sdk](https://www.npmjs.com/package/@clawdvault/sdk) package directly.
 
 ## License
 

package/dist/index.js

@@ -24,8 +24,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/index.ts
-var import_commander5 = require("commander");
-var import_chalk6 = __toESM(require("chalk"));
+var import_commander6 = require("commander");
+var import_chalk7 = __toESM(require("chalk"));
 
 // src/commands/tokens.ts
 var import_commander = require("commander");
@@ -223,6 +223,7 @@ var import_commander2 = require("commander");
 var import_chalk3 = __toESM(require("chalk"));
 var import_cli_table32 = __toESM(require("cli-table3"));
 var fs2 = __toESM(require("fs"));
+var import_sdk3 = require("@clawdvault/sdk");
 var tokenCommand = new import_commander2.Command("token").description("Token operations");
 tokenCommand.command("get <mint>").description("Get token details").option("--json", "Output as JSON").action(async (mint, options) => {
   const spin = spinner("Fetching token...").start();
@@ -411,11 +412,86 @@ tokenCommand.command("holders <mint>").description("Get top token holders").opti
     handleError(err);
   }
 });
+tokenCommand.command("watch <mint>").description("Watch token price in real-time").option("--json", "Output as JSON").action(async (mint, options) => {
+  const baseUrl = process.env.CLAWDVAULT_API_URL || "https://clawdvault.com/api";
+  console.log(import_chalk3.default.bold(`
+\u{1F4C8} Watching ${shortenAddress(mint)}
+`));
+  info(`Connecting to ${baseUrl}...`);
+  console.log(import_chalk3.default.dim("Press Ctrl+C to stop\n"));
+  const streaming = (0, import_sdk3.createStreaming)(baseUrl);
+  const conn = streaming.streamToken(mint);
+  const client = createReadOnlyClient();
+  let solPrice = 0;
+  try {
+    const { price } = await client.getSolPrice();
+    solPrice = price;
+  } catch {
+  }
+  let tokenInfo = {};
+  let lastUpdate = null;
+  const displayUpdate = (update) => {
+    if (options.json) {
+      console.log(JSON.stringify({ ...update, ...tokenInfo }));
+      return;
+    }
+    console.clear();
+    console.log(import_chalk3.default.bold(`
+\u{1F4C8} ${tokenInfo.name || "Token"} (${tokenInfo.symbol || shortenAddress(mint)})
+`));
+    const table = new import_cli_table32.default({
+      style: { head: [], border: [] }
+    });
+    const priceUsd = solPrice > 0 ? formatUsd(update.price_sol * solPrice) : "-";
+    const mcapUsd = solPrice > 0 ? formatUsd(update.market_cap_sol * solPrice) : "-";
+    table.push(
+      { [import_chalk3.default.cyan("Price (SOL)")]: formatSol(update.price_sol) },
+      { [import_chalk3.default.cyan("Price (USD)")]: priceUsd },
+      { [import_chalk3.default.cyan("Market Cap (SOL)")]: formatSol(update.market_cap_sol) },
+      { [import_chalk3.default.cyan("Market Cap (USD)")]: mcapUsd },
+      { [import_chalk3.default.cyan("Bonding Curve SOL")]: formatSol(update.real_sol_reserves) },
+      { [import_chalk3.default.cyan("Status")]: update.graduated ? import_chalk3.default.green("\u2713 Graduated") : import_chalk3.default.yellow("Bonding Curve") }
+    );
+    console.log(table.toString());
+    if (lastUpdate && lastUpdate.price_sol !== update.price_sol) {
+      const change = (update.price_sol - lastUpdate.price_sol) / lastUpdate.price_sol * 100;
+      const changeStr = change >= 0 ? import_chalk3.default.green(`+${change.toFixed(2)}%`) : import_chalk3.default.red(`${change.toFixed(2)}%`);
+      console.log(`
+${import_chalk3.default.dim("Last change:")} ${changeStr}`);
+    }
+    console.log(import_chalk3.default.dim("\nLast update: " + new Date(update.timestamp).toLocaleTimeString()));
+    console.log(import_chalk3.default.dim("Press Ctrl+C to stop"));
+    lastUpdate = update;
+  };
+  conn.onConnect(() => success("Connected to stream"));
+  conn.onDisconnect(() => warn("Disconnected - reconnecting..."));
+  conn.on("connected", (data) => {
+    tokenInfo = { name: data.name, symbol: data.symbol };
+    displayUpdate(data);
+  });
+  conn.on("update", displayUpdate);
+  conn.on("trade", (trade) => {
+    if (lastUpdate) {
+      lastUpdate.price_sol = trade.price_sol;
+      displayUpdate(lastUpdate);
+    }
+  });
+  conn.connect();
+  process.on("SIGINT", () => {
+    console.log("\n");
+    info("Disconnecting...");
+    streaming.disconnectAll();
+    process.exit(0);
+  });
+  await new Promise(() => {
+  });
+});
 
 // src/commands/trade.ts
 var import_commander3 = require("commander");
 var import_chalk4 = __toESM(require("chalk"));
 var import_cli_table33 = __toESM(require("cli-table3"));
+var import_sdk4 = require("@clawdvault/sdk");
 var tradeCommand = new import_commander3.Command("trade").description("Trading operations");
 tradeCommand.command("buy").description("Buy tokens").requiredOption("-m, --mint <address>", "Token mint address").requiredOption("-a, --sol <amount>", "Amount of SOL to spend").option("-s, --slippage <percent>", "Slippage tolerance (default: 1%)", "1").option("-w, --wallet <path>", "Wallet file path").option("--simulate", "Only simulate, don't execute").action(async (options) => {
   const { client, signer, walletAddress } = createClientWithWallet(options.wallet);
@@ -630,6 +706,78 @@ tradeCommand.command("history").description("Get trade history for a token").req
     handleError(err);
   }
 });
+tradeCommand.command("stream").description("Stream trades in real-time").requiredOption("-m, --mint <address>", "Token mint address").option("--json", "Output as JSON (one object per line)").option("--append", "Append mode (simple log format)").action(async (options) => {
+  const baseUrl = process.env.CLAWDVAULT_API_URL || "https://clawdvault.com/api";
+  console.log(import_chalk4.default.bold(`
+\u{1F4E1} Streaming trades for ${shortenAddress(options.mint)}
+`));
+  info(`Connecting to ${baseUrl}...`);
+  console.log(import_chalk4.default.dim("Press Ctrl+C to stop\n"));
+  const streaming = (0, import_sdk4.createStreaming)(baseUrl);
+  const conn = streaming.streamTrades(options.mint);
+  const trades = [];
+  const MAX_DISPLAY = 20;
+  conn.onConnect(() => {
+    success("Connected to stream");
+    console.log();
+  });
+  conn.onDisconnect(() => warn("Disconnected - reconnecting..."));
+  conn.on("trade", (trade) => {
+    if (options.json) {
+      console.log(JSON.stringify(trade));
+      return;
+    }
+    if (options.append) {
+      const typeStr = trade.type === "buy" ? import_chalk4.default.green("BUY ") : import_chalk4.default.red("SELL");
+      const time = new Date(trade.created_at).toLocaleTimeString();
+      console.log(
+        `${import_chalk4.default.dim(time)} ${typeStr} ${formatSol(trade.sol_amount).padEnd(15)} ${formatTokens(trade.token_amount).padEnd(12)} @ ${formatSol(trade.price_sol).padEnd(18)} ${import_chalk4.default.dim(shortenAddress(trade.trader))}`
+      );
+      return;
+    }
+    trades.unshift(trade);
+    if (trades.length > MAX_DISPLAY) {
+      trades.pop();
+    }
+    console.clear();
+    console.log(import_chalk4.default.bold(`
+\u{1F4E1} Live Trades - ${shortenAddress(options.mint)}
+`));
+    const table = new import_cli_table33.default({
+      head: [
+        import_chalk4.default.cyan("Type"),
+        import_chalk4.default.cyan("SOL"),
+        import_chalk4.default.cyan("Tokens"),
+        import_chalk4.default.cyan("Price"),
+        import_chalk4.default.cyan("Trader"),
+        import_chalk4.default.cyan("Time")
+      ],
+      style: { head: [], border: [] }
+    });
+    for (const t of trades) {
+      const typeStr = t.type === "buy" ? import_chalk4.default.green("BUY") : import_chalk4.default.red("SELL");
+      table.push([
+        typeStr,
+        formatSol(t.sol_amount),
+        formatTokens(t.token_amount),
+        formatSol(t.price_sol),
+        shortenAddress(t.trader),
+        new Date(t.created_at).toLocaleTimeString()
+      ]);
+    }
+    console.log(table.toString());
+    console.log(import_chalk4.default.dim("\nPress Ctrl+C to stop"));
+  });
+  conn.connect();
+  process.on("SIGINT", () => {
+    console.log("\n");
+    info("Disconnecting...");
+    streaming.disconnectAll();
+    process.exit(0);
+  });
+  await new Promise(() => {
+  });
+});
 
 // src/commands/wallet.ts
 var import_commander4 = require("commander");
@@ -1007,18 +1155,228 @@ walletCommand.command("airdrop").description("Request SOL from devnet faucet (de
   }
 });
 
+// src/commands/stream.ts
+var import_commander5 = require("commander");
+var import_chalk6 = __toESM(require("chalk"));
+var import_cli_table35 = __toESM(require("cli-table3"));
+var import_sdk5 = require("@clawdvault/sdk");
+function getBaseUrl2() {
+  return process.env.CLAWDVAULT_API_URL || "https://clawdvault.com/api";
+}
+var streamCommand = new import_commander5.Command("stream").description("Real-time streaming commands");
+streamCommand.command("trades").description("Stream real-time trades for a token").requiredOption("-m, --mint <address>", "Token mint address").option("--json", "Output as JSON (one object per line)").option("--append", "Append mode instead of table (good for logging)").action(async (options) => {
+  const baseUrl = getBaseUrl2();
+  console.log(import_chalk6.default.bold(`
+\u{1F4E1} Streaming trades for ${shortenAddress(options.mint)}
+`));
+  info(`Connecting to ${baseUrl}...`);
+  console.log(import_chalk6.default.dim("Press Ctrl+C to stop\n"));
+  const streaming = (0, import_sdk5.createStreaming)(baseUrl, {
+    autoReconnect: true,
+    reconnectDelay: 3e3
+  });
+  const conn = streaming.streamTrades(options.mint);
+  const trades = [];
+  const MAX_DISPLAY = 20;
+  conn.onConnect(() => {
+    success("Connected to stream");
+    console.log();
+  });
+  conn.onDisconnect(() => {
+    warn("Disconnected - reconnecting...");
+  });
+  conn.onError((err) => {
+    if (!err.message.includes("Max reconnect")) {
+    } else {
+      console.error(import_chalk6.default.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+  conn.on("trade", (trade) => {
+    if (options.json) {
+      console.log(JSON.stringify(trade));
+      return;
+    }
+    if (options.append) {
+      const typeStr = trade.type === "buy" ? import_chalk6.default.green("BUY ") : import_chalk6.default.red("SELL");
+      const time = new Date(trade.created_at).toLocaleTimeString();
+      console.log(
+        `${import_chalk6.default.dim(time)} ${typeStr} ${formatSol(trade.sol_amount).padEnd(15)} ${formatTokens(trade.token_amount).padEnd(12)} @ ${formatSol(trade.price_sol).padEnd(18)} ${import_chalk6.default.dim(shortenAddress(trade.trader))}`
+      );
+      return;
+    }
+    trades.unshift(trade);
+    if (trades.length > MAX_DISPLAY) {
+      trades.pop();
+    }
+    console.clear();
+    console.log(import_chalk6.default.bold(`
+\u{1F4E1} Live Trades - ${shortenAddress(options.mint)}
+`));
+    const table = new import_cli_table35.default({
+      head: [
+        import_chalk6.default.cyan("Type"),
+        import_chalk6.default.cyan("SOL"),
+        import_chalk6.default.cyan("Tokens"),
+        import_chalk6.default.cyan("Price"),
+        import_chalk6.default.cyan("Trader"),
+        import_chalk6.default.cyan("Time")
+      ],
+      style: { head: [], border: [] }
+    });
+    for (const t of trades) {
+      const typeStr = t.type === "buy" ? import_chalk6.default.green("BUY") : import_chalk6.default.red("SELL");
+      table.push([
+        typeStr,
+        formatSol(t.sol_amount),
+        formatTokens(t.token_amount),
+        formatSol(t.price_sol),
+        shortenAddress(t.trader),
+        new Date(t.created_at).toLocaleTimeString()
+      ]);
+    }
+    console.log(table.toString());
+    console.log(import_chalk6.default.dim("\nPress Ctrl+C to stop"));
+  });
+  conn.connect();
+  process.on("SIGINT", () => {
+    console.log("\n");
+    info("Disconnecting...");
+    streaming.disconnectAll();
+    process.exit(0);
+  });
+  await new Promise(() => {
+  });
+});
+streamCommand.command("token").description("Stream real-time token updates (price, market cap)").requiredOption("-m, --mint <address>", "Token mint address").option("--json", "Output as JSON (one object per line)").action(async (options) => {
+  const baseUrl = getBaseUrl2();
+  console.log(import_chalk6.default.bold(`
+\u{1F4C8} Watching token ${shortenAddress(options.mint)}
+`));
+  info(`Connecting to ${baseUrl}...`);
+  console.log(import_chalk6.default.dim("Press Ctrl+C to stop\n"));
+  const streaming = (0, import_sdk5.createStreaming)(baseUrl);
+  const conn = streaming.streamToken(options.mint);
+  const client = createReadOnlyClient();
+  let solPrice = 0;
+  try {
+    const { price } = await client.getSolPrice();
+    solPrice = price;
+  } catch {
+  }
+  let tokenInfo = {};
+  let lastUpdate = null;
+  const displayUpdate = (update) => {
+    if (options.json) {
+      console.log(JSON.stringify({ ...update, ...tokenInfo }));
+      return;
+    }
+    console.clear();
+    console.log(import_chalk6.default.bold(`
+\u{1F4C8} ${tokenInfo.name || "Token"} (${tokenInfo.symbol || shortenAddress(options.mint)})
+`));
+    const table = new import_cli_table35.default({
+      style: { head: [], border: [] }
+    });
+    const priceUsd = solPrice > 0 ? formatUsd(update.price_sol * solPrice) : "-";
+    const mcapUsd = solPrice > 0 ? formatUsd(update.market_cap_sol * solPrice) : "-";
+    table.push(
+      { [import_chalk6.default.cyan("Price (SOL)")]: formatSol(update.price_sol) },
+      { [import_chalk6.default.cyan("Price (USD)")]: priceUsd },
+      { [import_chalk6.default.cyan("Market Cap (SOL)")]: formatSol(update.market_cap_sol) },
+      { [import_chalk6.default.cyan("Market Cap (USD)")]: mcapUsd },
+      { [import_chalk6.default.cyan("Bonding Curve SOL")]: formatSol(update.real_sol_reserves) },
+      { [import_chalk6.default.cyan("Status")]: update.graduated ? import_chalk6.default.green("\u2713 Graduated") : import_chalk6.default.yellow("Bonding Curve") }
+    );
+    console.log(table.toString());
+    if (lastUpdate && lastUpdate.price_sol !== update.price_sol) {
+      const change = (update.price_sol - lastUpdate.price_sol) / lastUpdate.price_sol * 100;
+      const changeStr = change >= 0 ? import_chalk6.default.green(`+${change.toFixed(2)}%`) : import_chalk6.default.red(`${change.toFixed(2)}%`);
+      console.log(`
+${import_chalk6.default.dim("Last change:")} ${changeStr}`);
+    }
+    console.log(import_chalk6.default.dim("\nLast update: " + new Date(update.timestamp).toLocaleTimeString()));
+    console.log(import_chalk6.default.dim("Press Ctrl+C to stop"));
+    lastUpdate = update;
+  };
+  conn.onConnect(() => {
+    success("Connected to stream");
+  });
+  conn.onDisconnect(() => {
+    warn("Disconnected - reconnecting...");
+  });
+  conn.on("connected", (data) => {
+    tokenInfo = { name: data.name, symbol: data.symbol };
+    displayUpdate(data);
+  });
+  conn.on("update", displayUpdate);
+  conn.on("trade", (trade) => {
+    if (lastUpdate) {
+      lastUpdate.price_sol = trade.price_sol;
+      displayUpdate(lastUpdate);
+    }
+  });
+  conn.connect();
+  process.on("SIGINT", () => {
+    console.log("\n");
+    info("Disconnecting...");
+    streaming.disconnectAll();
+    process.exit(0);
+  });
+  await new Promise(() => {
+  });
+});
+streamCommand.command("chat").description("Stream real-time chat messages for a token").requiredOption("-m, --mint <address>", "Token mint address").option("--json", "Output as JSON (one object per line)").action(async (options) => {
+  const baseUrl = getBaseUrl2();
+  console.log(import_chalk6.default.bold(`
+\u{1F4AC} Streaming chat for ${shortenAddress(options.mint)}
+`));
+  info(`Connecting to ${baseUrl}...`);
+  console.log(import_chalk6.default.dim("Press Ctrl+C to stop\n"));
+  const streaming = (0, import_sdk5.createStreaming)(baseUrl);
+  const conn = streaming.streamChat(options.mint);
+  conn.onConnect(() => {
+    success("Connected to stream");
+    console.log();
+  });
+  conn.onDisconnect(() => {
+    warn("Disconnected - reconnecting...");
+  });
+  conn.on("message", (msg) => {
+    if (options.json) {
+      console.log(JSON.stringify(msg));
+      return;
+    }
+    const time = new Date(msg.created_at).toLocaleTimeString();
+    const sender = msg.username || shortenAddress(msg.wallet);
+    console.log(
+      `${import_chalk6.default.dim(time)} ${import_chalk6.default.cyan(sender)}: ${msg.message}`
+    );
+  });
+  conn.connect();
+  process.on("SIGINT", () => {
+    console.log("\n");
+    info("Disconnecting...");
+    streaming.disconnectAll();
+    process.exit(0);
+  });
+  await new Promise(() => {
+  });
+});
+
 // src/index.ts
-var program = new import_commander5.Command();
+var program = new import_commander6.Command();
 program.name("clawdvault").description("CLI for ClawdVault - Solana token launchpad").version("0.1.0");
 program.addCommand(tokensCommand);
 program.addCommand(tokenCommand);
 program.addCommand(tradeCommand);
 program.addCommand(walletCommand);
+program.addCommand(streamCommand);
 program.hook("preAction", () => {
 });
 program.configureOutput({
   outputError: (str, write) => {
-    write(import_chalk6.default.red(str));
+    write(import_chalk7.default.red(str));
   }
 });
 program.parse();

package/package.json

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