hufi-cli 0.3.1 → 0.5.2

package/README.md

@@ -12,31 +12,31 @@ bun install
 
 ```bash
 # Show help
-bun src/cli.ts --help
+bunx hufi-cli --help
 
-# Authenticate
-bun src/cli.ts auth login --private-key 0x...
+# Generate a new wallet (key saved to ~/.hufi-cli/key.json)
+bunx hufi-cli auth generate
 
-# Generate a new wallet
-bun src/cli.ts auth generate
+# Authenticate (uses saved key by default)
+bunx hufi-cli auth login
 
 # Check auth status
-bun src/cli.ts auth status
+bunx hufi-cli auth status
 
 # Register exchange API key
-bun src/cli.ts exchange register --name mexc --api-key xxx --secret-key yyy
+bunx hufi-cli exchange register --name mexc --api-key xxx --secret-key yyy
 
 # List exchange API keys
-bun src/cli.ts exchange list
+bunx hufi-cli exchange list
 
 # Check campaign join status
-bun src/cli.ts campaign status --chain-id 137 --address 0x...
+bunx hufi-cli campaign status --chain-id 137 --address 0x...
 
 # Join a campaign
-bun src/cli.ts campaign join --chain-id 137 --address 0x...
+bunx hufi-cli campaign join --chain-id 137 --address 0x...
 
 # List joined campaigns
-bun src/cli.ts campaign list --limit 20
+bunx hufi-cli campaign list --limit 20
 ```
 
 ## Global Options
@@ -47,6 +47,22 @@ bun src/cli.ts campaign list --limit 20
 
 Configuration is stored at `~/.hufi-cli/config.json`.
 
+## Capabilities
+
+### What This CLI Can Do
+
+| Module | Commands | Description |
+|--------|----------|-------------|
+| **auth** | login, generate, status | Authentication & wallet management |
+| **exchange** | register, list | Exchange API key management |
+| **campaign** | list, get, joined, join, status, progress, leaderboard | Campaign browsing, joining, and monitoring |
+
+### What This CLI Cannot Do
+
+- ❌ Execute on-chain transactions
+- ❌ Configure trading strategies
+- ❌ Multi-signature or voting operations
+
 ## API Endpoints
 
 - Recording Oracle: `https://ro.hu.finance`
@@ -56,7 +72,7 @@ Configuration is stored at `~/.hufi-cli/config.json`.
 
 ```bash
 # Run directly
-bun src/cli.ts --help
+bunx hufi-cli --help
 
 # Run tests
 bun test

package/dist/cli.js

@@ -9339,7 +9339,22 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 var CONFIG_DIR = join(homedir(), ".hufi-cli");
-var CONFIG_FILE = join(CONFIG_DIR, "config.json");
+var DEFAULT_CONFIG_FILE = join(CONFIG_DIR, "config.json");
+var DEFAULT_KEY_FILE = join(CONFIG_DIR, "key.json");
+var customConfigFile = null;
+var customKeyFile = null;
+function setConfigFile(path) {
+  customConfigFile = path;
+}
+function setKeyFile(path) {
+  customKeyFile = path;
+}
+function configFile() {
+  return customConfigFile ?? DEFAULT_CONFIG_FILE;
+}
+function keyFile() {
+  return customKeyFile ?? DEFAULT_KEY_FILE;
+}
 var DEFAULT_CONFIG = {
   recordingApiUrl: "https://ro.hu.finance",
   launcherApiUrl: "https://cl.hu.finance"
@@ -9351,11 +9366,11 @@ function ensureConfigDir() {
 }
 function loadConfig() {
   ensureConfigDir();
-  if (!existsSync(CONFIG_FILE)) {
+  if (!existsSync(configFile())) {
     return { ...DEFAULT_CONFIG };
   }
   try {
-    const raw = readFileSync(CONFIG_FILE, "utf-8");
+    const raw = readFileSync(configFile(), "utf-8");
     const parsed = JSON.parse(raw);
     return { ...DEFAULT_CONFIG, ...parsed };
   } catch {
@@ -9364,7 +9379,7 @@ function loadConfig() {
 }
 function saveConfig(config) {
   ensureConfigDir();
-  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + `
+  writeFileSync(configFile(), JSON.stringify(config, null, 2) + `
 `);
 }
 function updateConfig(partial) {
@@ -9373,6 +9388,30 @@ function updateConfig(partial) {
   saveConfig(merged);
   return merged;
 }
+function getConfigPath() {
+  return configFile();
+}
+function getKeyPath() {
+  return keyFile();
+}
+function keyExists() {
+  return existsSync(keyFile());
+}
+function saveKey(key, address) {
+  ensureConfigDir();
+  writeFileSync(keyFile(), JSON.stringify({ address, privateKey: key }, null, 2) + `
+`);
+}
+function loadKey() {
+  if (!existsSync(keyFile()))
+    return null;
+  try {
+    const raw = readFileSync(keyFile(), "utf-8");
+    return JSON.parse(raw).privateKey ?? null;
+  } catch {
+    return null;
+  }
+}
 
 // src/lib/output.ts
 function printJson(data) {
@@ -9392,11 +9431,16 @@ function maskSecret(value) {
 // src/commands/auth.ts
 function createAuthCommand() {
   const auth = new Command("auth").description("Authentication commands");
-  auth.command("login").description("Authenticate with Recording Oracle using a private key").requiredOption("-k, --private-key <key>", "EVM private key").option("-u, --api-url <url>", "Recording Oracle API URL").option("--json", "Output as JSON").action(async (opts) => {
+  auth.command("login").description("Authenticate with Recording Oracle using a private key").option("-k, --private-key <key>", "EVM private key (uses saved key if not provided)").option("-u, --api-url <url>", "Recording Oracle API URL").option("--json", "Output as JSON").action(async (opts) => {
+    const privateKey = opts.privateKey ?? loadKey();
+    if (!privateKey) {
+      printText("No private key provided. Run: hufi auth login -k <key> or hufi auth generate");
+      process.exit(1);
+    }
     const config = loadConfig();
     const baseUrl = (opts.apiUrl ?? config.recordingApiUrl).replace(/\/+$/, "");
     try {
-      const result = await authenticate(baseUrl, opts.privateKey);
+      const result = await authenticate(baseUrl, privateKey);
       updateConfig({
         recordingApiUrl: baseUrl,
         address: result.address,
@@ -9407,7 +9451,7 @@ function createAuthCommand() {
         printJson({ address: result.address, accessToken: result.accessToken });
       } else {
         printText(`Authenticated as ${result.address}`);
-        printText(`Token saved to ~/.hufi-cli/config.json`);
+        printText(`Token saved to ${getConfigPath()}`);
       }
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
@@ -9415,13 +9459,31 @@ function createAuthCommand() {
       process.exitCode = 1;
     }
   });
-  auth.command("generate").description("Generate a new EVM wallet").option("--json", "Output as JSON").action((opts) => {
+  auth.command("generate").description("Generate a new EVM wallet").option("--json", "Output as JSON").action(async (opts) => {
+    if (keyExists()) {
+      if (!opts.json) {
+        printText(`Key already exists at ${getKeyPath()}. Overwrite? (y/N)`);
+        const answer = await new Promise((resolve) => {
+          process.stdin.resume();
+          process.stdin.once("data", (data) => {
+            process.stdin.pause();
+            resolve(data.toString().trim().toLowerCase());
+          });
+        });
+        if (answer !== "y") {
+          printText("Cancelled.");
+          return;
+        }
+      }
+    }
     const wallet = createWallet();
+    saveKey(wallet.privateKey, wallet.address);
+    const keyPath = getKeyPath();
     if (opts.json) {
-      printJson(wallet);
+      printJson({ address: wallet.address, keyPath });
     } else {
       printText(`Address: ${wallet.address}`);
-      printText(`Private key: ${wallet.privateKey}`);
+      printText(`Private key saved to ${keyPath}`);
     }
   });
   auth.command("status").description("Show current authentication status").option("--json", "Output as JSON").action((opts) => {
@@ -9614,10 +9676,18 @@ function createCampaignCommand() {
             const key = `${c.chain_id}:${c.address}`;
             const joined = joinedKeys.has(key);
             const tag = joined ? " [JOINED]" : "";
+            const decimals = c.fund_token_decimals ?? 0;
+            const div = Math.pow(10, decimals);
+            const fmt = (v) => (Number(v) / div).toLocaleString(undefined, { maximumFractionDigits: decimals });
+            const fundAmount = Number(c.fund_amount);
+            const balanceNum = Number(c.balance);
+            const pct = fundAmount > 0 ? (balanceNum / fundAmount * 100).toFixed(1) : "0.0";
             printText(`  ${c.exchange_name} ${c.symbol} (${c.type})${tag}`);
-            printText(`    address: ${c.address}`);
-            printText(`    status: ${c.status}`);
-            printText(`    funded: ${c.fund_amount} ${c.fund_token_symbol}  balance: ${c.balance}`);
+            printText(`    chain:      ${c.chain_id}`);
+            printText(`    address:    ${c.address}`);
+            printText(`    status:     ${c.status}`);
+            printText(`    duration:   ${c.start_date?.split("T")[0] ?? "-"} ~ ${c.end_date?.split("T")[0] ?? "-"}`);
+            printText(`    funded:     ${fmt(c.fund_amount)} ${c.fund_token_symbol}  paid: ${fmt(c.amount_paid)}  balance: ${fmt(c.balance)} (${pct}%)`);
             printText("");
           }
           if (opts.status === "active") {
@@ -9773,127 +9843,14 @@ function createCampaignCommand() {
 }
 
 // src/cli.ts
-var BASH_COMPLETION = [
-  "_hufi_completions() {",
-  "  local cur prev commands",
-  "  COMPREPLY=()",
-  '  cur="${COMP_WORDS[COMP_CWORD]}"',
-  '  prev="${COMP_WORDS[COMP_CWORD-1]}"',
-  "",
-  '  commands="auth exchange campaign completion help"',
-  "",
-  '  case "$prev" in',
-  "    hufi)",
-  '      COMPREPLY=( $(compgen -W "$commands" -- "$cur") )',
-  "      return 0",
-  "      ;;",
-  "    auth)",
-  '      COMPREPLY=( $(compgen -W "login generate status help" -- "$cur") )',
-  "      return 0",
-  "      ;;",
-  "    exchange)",
-  '      COMPREPLY=( $(compgen -W "register list help" -- "$cur") )',
-  "      return 0",
-  "      ;;",
-  "    campaign)",
-  '      COMPREPLY=( $(compgen -W "list get joined status join progress leaderboard help" -- "$cur") )',
-  "      return 0",
-  "      ;;",
-  "  esac",
-  "",
-  '  COMPREPLY=( $(compgen -W "--help --version --json" -- "$cur") )',
-  "  return 0",
-  "}",
-  "",
-  "complete -F _hufi_completions hufi"
-].join(`
-`);
-var ZSH_COMPLETION = [
-  "#compdef hufi",
-  "",
-  "_hufi() {",
-  "  local -a commands",
-  "  commands=(",
-  "    'auth:Authentication commands'",
-  "    'exchange:Exchange API key management'",
-  "    'campaign:Campaign management'",
-  "    'completion:Generate shell completion script'",
-  "    'help:Display help'",
-  "  )",
-  "",
-  "  _arguments -C \\",
-  "    '1:command:->command' \\",
-  "    '*::arg:->args'",
-  "",
-  "  case $state in",
-  "    command)",
-  "      _describe 'command' commands",
-  "      ;;",
-  "    args)",
-  "      case ${words[1]} in",
-  "        auth)",
-  "          _arguments \\",
-  "            '1:subcommand:(login generate status help)'",
-  "          ;;",
-  "        exchange)",
-  "          _arguments \\",
-  "            '1:subcommand:(register list help)'",
-  "          ;;",
-  "        campaign)",
-  "          _arguments \\",
-  "            '1:subcommand:(list get joined status join progress leaderboard help)'",
-  "          ;;",
-  "      esac",
-  "      ;;",
-  "  esac",
-  "}",
-  "",
-  '_hufi "$@"'
-].join(`
-`);
-var FISH_COMPLETION = [
-  "# hufi completions for fish",
-  "complete -c hufi -f",
-  "",
-  "# Top-level commands",
-  "complete -c hufi -n '__fish_use_subcommand' -a auth -d 'Authentication commands'",
-  "complete -c hufi -n '__fish_use_subcommand' -a exchange -d 'Exchange API key management'",
-  "complete -c hufi -n '__fish_use_subcommand' -a campaign -d 'Campaign management'",
-  "complete -c hufi -n '__fish_use_subcommand' -a completion -d 'Generate shell completion script'",
-  "",
-  "# auth subcommands",
-  "complete -c hufi -n '__fish_seen_subcommand_from auth' -a login -d 'Authenticate with private key'",
-  "complete -c hufi -n '__fish_seen_subcommand_from auth' -a generate -d 'Generate a new wallet'",
-  "complete -c hufi -n '__fish_seen_subcommand_from auth' -a status -d 'Show auth status'",
-  "",
-  "# exchange subcommands",
-  "complete -c hufi -n '__fish_seen_subcommand_from exchange' -a register -d 'Register exchange API key'",
-  "complete -c hufi -n '__fish_seen_subcommand_from exchange' -a list -d 'List exchange API keys'",
-  "",
-  "# campaign subcommands",
-  "complete -c hufi -n '__fish_seen_subcommand_from campaign' -a list -d 'List available campaigns'",
-  "complete -c hufi -n '__fish_seen_subcommand_from campaign' -a get -d 'Get campaign details'",
-  "complete -c hufi -n '__fish_seen_subcommand_from campaign' -a joined -d 'List joined campaigns'",
-  "complete -c hufi -n '__fish_seen_subcommand_from campaign' -a status -d 'Check join status'",
-  "complete -c hufi -n '__fish_seen_subcommand_from campaign' -a join -d 'Join a campaign'",
-  "complete -c hufi -n '__fish_seen_subcommand_from campaign' -a progress -d 'Check your progress'",
-  "complete -c hufi -n '__fish_seen_subcommand_from campaign' -a leaderboard -d 'View leaderboard'",
-  "",
-  "# Global options",
-  "complete -c hufi -l help -d 'Show help'",
-  "complete -c hufi -l version -d 'Show version'",
-  "complete -c hufi -l json -d 'Output as JSON'"
-].join(`
-`);
 var program2 = new Command;
-program2.name("hufi").description("CLI tool for hu.fi DeFi platform").version("0.3.1");
-program2.command("completion").description("Generate shell completion script").option("--bash", "Bash completion (default)").option("--zsh", "Zsh completion").option("--fish", "Fish completion").action((opts) => {
-  if (opts.zsh) {
-    console.log(ZSH_COMPLETION);
-  } else if (opts.fish) {
-    console.log(FISH_COMPLETION);
-  } else {
-    console.log(BASH_COMPLETION);
+program2.name("hufi").description("CLI tool for hu.fi DeFi platform").version("0.5.2").option("--config-file <path>", "Custom config file path (default: ~/.hufi-cli/config.json)").option("--key-file <path>", "Custom key file path (default: ~/.hufi-cli/key.json)").hook("preAction", (thisCommand) => {
+  const opts = thisCommand.opts();
+  if (opts.configFile) {
+    setConfigFile(opts.configFile);
+  }
+  if (opts.keyFile) {
+    setKeyFile(opts.keyFile);
   }
 });
 program2.addCommand(createAuthCommand());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hufi-cli",
-  "version": "0.3.1",
+  "version": "0.5.2",
   "type": "module",
   "bin": {
     "hufi": "./dist/cli.js"
@@ -10,7 +10,8 @@
     "build": "bun build ./src/cli.ts --outfile ./dist/cli.js --target node",
     "prepublishOnly": "bun run build",
     "test": "bun test",
-    "typecheck": "bunx tsc --noEmit"
+    "typecheck": "bunx tsc --noEmit",
+    "test:cli": "./test-cli.sh"
   },
   "dependencies": {
     "commander": "^12.0.0",