hufi-cli 0.4.0 → 0.5.2

package/README.md

@@ -14,12 +14,12 @@ bun install
 # Show help
 bunx hufi-cli --help
 
-# Authenticate
-bunx hufi-cli auth login --private-key 0x...
-
-# Generate a new wallet
+# Generate a new wallet (key saved to ~/.hufi-cli/key.json)
 bunx hufi-cli auth generate
 
+# Authenticate (uses saved key by default)
+bunx hufi-cli auth login
+
 # Check auth status
 bunx hufi-cli auth status
 
@@ -47,6 +47,22 @@ bunx hufi-cli 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`

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) => {
@@ -9781,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.4.0");
-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.4.0",
+  "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",