hufi-cli 1.0.1 → 1.0.3

package/LICENSE

@@ -0,0 +1,13 @@
+DO WHAT THE F*** YOU WANT TO PUBLIC LICENSE
+Version 2, December 2004
+
+Copyright (C) 2024 hu-fi
+
+Everyone is permitted to copy and distribute verbatim or modified
+copies of this license document, and changing it is allowed as long
+as the name is changed.
+
+DO WHAT THE F*** YOU WANT TO PUBLIC LICENSE
+TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+0. You just DO WHAT THE F*** YOU WANT TO.

package/README.md

@@ -1,6 +1,8 @@
 # hufi-cli
 
-CLI tool for the [hu.fi](https://hu.finance) DeFi platform.
+[![License: WTFPL](https://img.shields.io/badge/License-WTFPL-brightgreen.svg)](http://www.wtfpl.net/about/)
+
+CLI tool for the [hu.fi](https://hu.finance) platform.
 
 ## Install
 
@@ -14,19 +16,19 @@ Or run without installing:
 bunx hufi-cli <command>
 ```
 
-All examples below assume global install. Otherwise replace `hufi` with `bunx hufi-cli`.
+All examples below assume global install. Otherwise replace `hufi-cli` with `bunx hufi-cli`.
 
 ## Quick Start
 
 ```bash
 # Generate a wallet
-hufi auth generate
+hufi-cli auth generate
 
 # Login with saved key
-hufi auth login
+hufi-cli auth login
 
 # Browse campaigns
-hufi campaign list
+hufi-cli campaign list
 ```
 
 ## Commands
@@ -40,9 +42,9 @@ hufi campaign list
 | `auth status` | Show current auth status |
 
 ```bash
-hufi auth generate --json
-hufi auth login --private-key <key>
-hufi auth status
+hufi-cli auth generate --json
+hufi-cli auth login --private-key <key>
+hufi-cli auth status
 ```
 
 ### campaign
@@ -59,15 +61,15 @@ hufi auth status
 | `campaign create` | Create a new campaign (launch escrow on-chain) |
 
 ```bash
-hufi campaign list                                          # list active campaigns
-hufi campaign list --status completed --chain-id 1          # completed on Ethereum
-hufi campaign get --chain-id 137 --address 0x...            # campaign details
-hufi campaign join --address 0x...                          # join (chain-id defaults to 137)
-hufi campaign status --address 0x...                        # check status
-hufi campaign progress --address 0x...                      # your progress
-hufi campaign progress --address 0x... --watch              # live updates (polling)
-hufi campaign progress --address 0x... --watch --interval 3000
-hufi campaign leaderboard --address 0x...                   # leaderboard
+hufi-cli campaign list                                          # list active campaigns
+hufi-cli campaign list --status completed --chain-id 1          # completed on Ethereum
+hufi-cli campaign get --chain-id 137 --address 0x...            # campaign details
+hufi-cli campaign join --address 0x...                          # join (chain-id defaults to 137)
+hufi-cli campaign status --address 0x...                        # check status
+hufi-cli campaign progress --address 0x...                      # your progress
+hufi-cli campaign progress --address 0x... --watch              # live updates (polling)
+hufi-cli campaign progress --address 0x... --watch --interval 3000
+hufi-cli campaign leaderboard --address 0x...                   # leaderboard
 ```
 
 `campaign list` and `campaign get` print exact campaign timestamps and round token balances for human-readable text output.
@@ -76,23 +78,25 @@ hufi campaign leaderboard --address 0x...                   # leaderboard
 
 Requires staked HMT, gas, and fund tokens (USDT/USDC). Creates an escrow contract on-chain.
 
+Before broadcasting, the CLI validates the campaign type-specific target, checks the 6-hour to 100-day duration window, verifies your minimum HMT stake when possible, inspects fund token balance, and estimates gas for approval plus creation.
+
 ```bash
 # Market Making
-hufi campaign create \
+hufi-cli campaign create \
   --type market_making --exchange mexc --symbol HMT/USDT \
   --start-date 2026-04-01 --end-date 2026-05-01 \
   --fund-token USDT --fund-amount 10000 \
   --daily-volume-target 50000
 
 # Holding
-hufi campaign create \
+hufi-cli campaign create \
   --type holding --exchange mexc --symbol HMT \
   --start-date 2026-04-01 --end-date 2026-05-01 \
   --fund-token USDT --fund-amount 5000 \
   --daily-balance-target 1000
 
 # Threshold
-hufi campaign create \
+hufi-cli campaign create \
   --type threshold --exchange mexc --symbol HMT \
   --start-date 2026-04-01 --end-date 2026-05-01 \
   --fund-token USDT --fund-amount 5000 \
@@ -111,12 +115,17 @@ Running `campaign status/join/progress/leaderboard` without `-a` shows help.
 | `exchange revalidate` | Revalidate an exchange API key |
 
 ```bash
-hufi exchange register --name mexc --api-key <key> --secret-key <secret>
-hufi exchange list
-hufi exchange revalidate --name mexc
-hufi exchange delete --name mexc
+hufi-cli exchange register --name mexc --api-key <key> --secret-key <secret>
+hufi-cli exchange register --name bitmart --api-key <key> --secret-key <secret> --bitmart-memo <memo>
+hufi-cli exchange list
+hufi-cli exchange revalidate mexc
+hufi-cli exchange delete mexc
 ```
 
+`exchange register` expects the CCXT exchange name in `--name` and accepts `--bitmart-memo` for Bitmart accounts that require an extra memo value.
+
+You must run `hufi-cli auth login` before `exchange register`, `exchange list`, `exchange delete`, or `exchange revalidate`.
+
 ### staking
 
 | Command | Description |
@@ -128,12 +137,12 @@ hufi exchange delete --name mexc
 | `staking withdraw` | Withdraw unlocked tokens after lock period |
 
 ```bash
-hufi staking deposit                                   # show address QR code
-hufi staking status                                    # check your staking
-hufi staking status --address 0x...                    # check another address
-hufi staking stake -a 1000                             # stake 1000 HMT
-hufi staking unstake -a 500                            # unstake 500 HMT
-hufi staking withdraw                                  # withdraw unlocked tokens
+hufi-cli staking deposit                                   # show address QR code
+hufi-cli staking status                                    # check your staking
+hufi-cli staking status --address 0x...                    # check another address
+hufi-cli staking stake 1000                                # stake 1000 HMT
+hufi-cli staking unstake 500                               # unstake 500 HMT
+hufi-cli staking withdraw                                  # withdraw unlocked tokens
 ```
 
 Supports Polygon (chain 137) and Ethereum (chain 1). Staking contract: `0x01D1...07F1D` on Polygon.
@@ -143,10 +152,10 @@ Supports Polygon (chain 137) and Ethereum (chain 1). Staking contract: `0x01D1..
 Portfolio overview — staking, active campaigns, and progress in one view.
 
 ```bash
-hufi dashboard              # full overview
-hufi dashboard --json       # machine output
-hufi dashboard --export csv # export active campaign rows as CSV
-hufi dashboard --export json
+hufi-cli dashboard              # full overview
+hufi-cli dashboard --json       # machine output
+hufi-cli dashboard --export csv # export active campaign rows as CSV
+hufi-cli dashboard --export json
 ```
 
 ## Global Options
@@ -158,7 +167,7 @@ hufi dashboard --export json
 | `-V, --version` | Show version |
 | `-h, --help` | Show help |
 
-All commands support `--json` for machine-readable output.
+Most command actions support `--json` for machine-readable output. Help output remains text, and commands that intentionally show help when required arguments are missing do not emit a JSON error envelope.
 
 ## Configuration
 
@@ -181,6 +190,7 @@ bun install              # install deps
 bun run dev -- --help    # run from source
 bun run build            # build to dist/cli.js
 bun test                 # unit tests
+./test-cli.sh            # full CLI integration coverage
 bun run test:cli         # integration tests
 bun run typecheck        # type check
 ```
@@ -191,3 +201,7 @@ bun run typecheck        # type check
 |---------|-----|
 | Recording Oracle | https://ro.hu.finance |
 | Campaign Launcher | https://cl.hu.finance |
+
+## License
+
+This project is released under the [DO WHAT THE F*** YOU WANT TO PUBLIC LICENSE v2](http://www.wtfpl.net/about/). Do whatever you want with it.

package/dist/cli.js

@@ -22901,6 +22901,20 @@ function validateConfig(config) {
   if (config.address !== undefined && !isEvmAddress(config.address)) {
     issues.push("address must be a valid 0x-prefixed EVM address");
   }
+  if (config.rpcUrls !== undefined) {
+    if (typeof config.rpcUrls !== "object" || config.rpcUrls === null || Array.isArray(config.rpcUrls)) {
+      issues.push("rpcUrls must be an object mapping chain IDs to RPC URLs");
+    } else {
+      for (const [chainId, url] of Object.entries(config.rpcUrls)) {
+        if (!/^\d+$/.test(chainId)) {
+          issues.push(`rpcUrls key '${chainId}' must be a numeric chain ID`);
+        }
+        if (typeof url !== "string" || !isHttpUrl(url)) {
+          issues.push(`rpcUrls.${chainId} must be a valid http/https URL`);
+        }
+      }
+    }
+  }
   return {
     valid: issues.length === 0,
     issues
@@ -22928,7 +22942,7 @@ function createAuthCommand() {
   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");
+      printText("No private key provided. Run: hufi-cli auth login -k <key> or hufi-cli auth generate");
       process.exit(1);
     }
     const config = loadConfig();
@@ -22945,7 +22959,8 @@ function createAuthCommand() {
         printJson({ address: result.address, accessToken: result.accessToken });
       } else {
         printText(`Authenticated as ${result.address}`);
-        printText(`Token saved to ${getConfigPath()}`);
+        printText(`Private key loaded from ${getKeyPath()}`);
+        printText(`Tokens saved to ${getConfigPath()}`);
       }
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
@@ -22994,7 +23009,7 @@ function createAuthCommand() {
         printText(`Authenticated as ${status.address}`);
         printText(`API: ${status.apiUrl}`);
       } else {
-        printText("Not authenticated. Run: hufi auth login --private-key <key>");
+        printText("Not authenticated. Run: hufi-cli auth login -k <key>");
       }
     }
   });
@@ -23063,9 +23078,33 @@ function requireAuthAddress() {
 }
 
 // src/commands/exchange.ts
+var authHintByAction = {
+  register: "Run: hufi auth login --private-key <key> before registering exchange API keys.",
+  list: "Run: hufi auth login --private-key <key> before listing exchange API keys.",
+  delete: "Run: hufi auth login --private-key <key> before deleting exchange API keys.",
+  revalidate: "Run: hufi auth login --private-key <key> before revalidating exchange API keys."
+};
+function isUnauthorizedError(err) {
+  return err instanceof ApiError && err.status === 401;
+}
+function formatExchangeCommandErrorMessage(action, err) {
+  const message = err instanceof Error ? err.message : String(err);
+  const commandTarget = action === "list" ? "exchange API keys" : "exchange API key";
+  if (isUnauthorizedError(err)) {
+    return `Failed to ${action} ${commandTarget}: ${message}. ${authHintByAction[action]}`;
+  }
+  return `Failed to ${action} ${commandTarget}: ${message}`;
+}
+function formatRevalidateText(exchangeName, result) {
+  const lines = [`${exchangeName}: ${result.is_valid ? "valid" : "invalid"}`];
+  if ((result.missing_permissions?.length ?? 0) > 0) {
+    lines.push(`Missing permissions: ${result.missing_permissions?.join(", ")}`);
+  }
+  return lines;
+}
 function createExchangeCommand() {
   const exchange = new Command("exchange").description("Exchange API key management");
-  exchange.command("register").description("Register a read-only exchange API key").requiredOption("-n, --name <name>", "Exchange name (e.g. binance, mexc)").requiredOption("--api-key <key>", "Read-only API key").requiredOption("--secret-key <key>", "Read-only API secret").option("--bitmart-memo <memo>", "Bitmart memo (only for bitmart)").option("--json", "Output as JSON").action(async (opts) => {
+  exchange.command("register").description("Register a read-only exchange API key").requiredOption("-n, --name <name>", "CCXT exchange name (e.g. binance, mexc)").requiredOption("--api-key <key>", "Read-only API key").requiredOption("--secret-key <key>", "Read-only API secret").option("--bitmart-memo <memo>", "Bitmart memo (only for bitmart)").option("--json", "Output as JSON").action(async (opts) => {
     const { baseUrl, accessToken } = requireAuthToken();
     try {
       const result = await registerExchangeApiKey(baseUrl, accessToken, opts.name, opts.apiKey, opts.secretKey, opts.bitmartMemo);
@@ -23078,8 +23117,7 @@ function createExchangeCommand() {
         }
       }
     } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      printText(`Failed to register exchange API key: ${message}`);
+      printText(formatExchangeCommandErrorMessage("register", err));
       process.exitCode = 1;
     }
   });
@@ -23100,42 +23138,49 @@ function createExchangeCommand() {
         }
       }
     } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      printText(`Failed to list exchange API keys: ${message}`);
+      printText(formatExchangeCommandErrorMessage("list", err));
       process.exitCode = 1;
     }
   });
-  exchange.command("delete").description("Delete API keys for an exchange").requiredOption("-n, --name <name>", "Exchange name (e.g. mexc, bybit)").option("--json", "Output as JSON").action(async (opts) => {
+  exchange.command("delete [name]").description("Delete API keys for an exchange").usage("[name] [options]").option("-n, --name <name>", "Exchange name (e.g. mexc, bybit)").option("--json", "Output as JSON").action(async (nameArg, opts) => {
+    const exchangeName = nameArg ?? opts.name;
+    if (!exchangeName) {
+      printText("Exchange name is required. Usage: hufi exchange delete <name>");
+      process.exitCode = 1;
+      return;
+    }
     const { baseUrl, accessToken } = requireAuthToken();
     try {
-      await deleteExchangeApiKey(baseUrl, accessToken, opts.name);
+      await deleteExchangeApiKey(baseUrl, accessToken, exchangeName);
       if (opts.json) {
-        printJson({ deleted: true, exchange_name: opts.name });
+        printJson({ deleted: true, exchange_name: exchangeName });
       } else {
-        printText(`Deleted API keys for ${opts.name}.`);
+        printText(`Deleted API keys for ${exchangeName}.`);
       }
     } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      printText(`Failed to delete exchange API keys: ${message}`);
+      printText(formatExchangeCommandErrorMessage("delete", err));
       process.exitCode = 1;
     }
   });
-  exchange.command("revalidate").description("Revalidate exchange API key").requiredOption("-n, --name <name>", "Exchange name (e.g. mexc, bybit)").option("--json", "Output as JSON").action(async (opts) => {
+  exchange.command("revalidate [name]").description("Revalidate exchange API key").usage("[name] [options]").option("-n, --name <name>", "Exchange name (e.g. mexc, bybit)").option("--json", "Output as JSON").action(async (nameArg, opts) => {
+    const exchangeName = nameArg ?? opts.name;
+    if (!exchangeName) {
+      printText("Exchange name is required. Usage: hufi exchange revalidate <name>");
+      process.exitCode = 1;
+      return;
+    }
     const { baseUrl, accessToken } = requireAuthToken();
     try {
-      const result = await revalidateExchangeApiKey(baseUrl, accessToken, opts.name);
+      const result = await revalidateExchangeApiKey(baseUrl, accessToken, exchangeName);
       if (opts.json) {
         printJson(result);
       } else {
-        const status = result.is_valid ? "valid" : "invalid";
-        printText(`${opts.name}: ${status}`);
-        if (result.missing_permissions.length > 0) {
-          printText(`Missing permissions: ${result.missing_permissions.join(", ")}`);
+        for (const line of formatRevalidateText(exchangeName, result)) {
+          printText(line);
         }
       }
     } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      printText(`Failed to revalidate exchange API key: ${message}`);
+      printText(formatExchangeCommandErrorMessage("revalidate", err));
       process.exitCode = 1;
     }
   });
@@ -24711,6 +24756,14 @@ function getContracts(chainId) {
   return c;
 }
 function getRpc(chainId) {
+  const override = process.env[`HUFI_RPC_${chainId}`];
+  if (override) {
+    return override;
+  }
+  const configOverride = loadConfig().rpcUrls?.[String(chainId)];
+  if (configOverride) {
+    return configOverride;
+  }
   const rpcs = RPC_URLS[chainId];
   if (!rpcs) {
     throw new Error(`No RPC URLs for chain ${chainId}`);
@@ -24971,6 +25024,56 @@ function formatCampaignTimestamp(value) {
     return "-";
   return value.replace("T", " ").replace(/\.\d+Z$/, "").replace(/Z$/, "");
 }
+function formatUtcTimestamp(value) {
+  if (typeof value !== "string")
+    return "-";
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime()))
+    return String(value);
+  return date.toISOString().replace("T", " ").replace(/\.\d+Z$/, " UTC");
+}
+function formatMetricValue(value) {
+  if (value === null || value === undefined)
+    return "-";
+  if (typeof value === "number") {
+    return Number.isInteger(value) ? String(value) : value.toFixed(4).replace(/\.0+$/, "").replace(/(\.\d*?)0+$/, "$1");
+  }
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (trimmed && /^-?\d+(\.\d+)?$/.test(trimmed)) {
+      const num = Number(trimmed);
+      if (!Number.isNaN(num)) {
+        return formatMetricValue(num);
+      }
+    }
+    return value;
+  }
+  return JSON.stringify(value);
+}
+function printAlignedMetric(label, value, labelWidth = 14) {
+  printText(`  ${label.padEnd(labelWidth)}  ${formatMetricValue(value)}`);
+}
+function printCampaignProgressCard(result) {
+  const myMeta = result.my_meta && typeof result.my_meta === "object" ? result.my_meta : {};
+  const totalMeta = result.total_meta && typeof result.total_meta === "object" ? result.total_meta : {};
+  const myScore = Number(result.my_score ?? 0);
+  const totalScore = Number(totalMeta.total_score ?? 0);
+  const scoreShare = totalScore > 0 && Number.isFinite(myScore) ? `${(myScore / totalScore * 100).toFixed(2)}%` : "-";
+  printText("Campaign Progress");
+  printText("-----------------");
+  printText("[Window]");
+  printAlignedMetric("From", formatUtcTimestamp(result.from));
+  printAlignedMetric("To", formatUtcTimestamp(result.to));
+  printText("");
+  printText("[Mine]");
+  printAlignedMetric("Score", result.my_score);
+  printAlignedMetric("Token balance", myMeta.token_balance);
+  printAlignedMetric("Score share", scoreShare);
+  printText("");
+  printText("[Totals]");
+  printAlignedMetric("Total score", totalMeta.total_score);
+  printAlignedMetric("Total balance", totalMeta.total_balance);
+}
 function formatTokenAmount(value, decimals, displayDecimals = 2) {
   const amount = new bignumber_default(value).dividedBy(new bignumber_default(10).pow(decimals));
   const rounded = amount.decimalPlaces(displayDecimals, bignumber_default.ROUND_HALF_UP);
@@ -24986,6 +25089,34 @@ function getLauncherUrl() {
   const config = loadConfig();
   return (config.launcherApiUrl ?? "https://cl.hu.finance").replace(/\/+$/, "");
 }
+function printCampaignSummary(campaign, options = {}) {
+  const indent = options.indent ?? "";
+  const joinedTag = options.joinedTag ?? "";
+  const showLauncher = options.showLauncher ?? true;
+  const exchange = String(campaign.exchange_name ?? "?");
+  const symbol = String(campaign.symbol ?? "?");
+  const type = String(campaign.type ?? "?");
+  const chainId = String(campaign.chain_id ?? "-");
+  const address = String(campaign.address ?? campaign.escrow_address ?? "-");
+  const status = String(campaign.status ?? "-");
+  const startDate = typeof campaign.start_date === "string" ? campaign.start_date : undefined;
+  const endDate = typeof campaign.end_date === "string" ? campaign.end_date : undefined;
+  const launcher = typeof campaign.launcher === "string" ? campaign.launcher : undefined;
+  const decimals = Number(campaign.fund_token_decimals ?? 0);
+  const fundAmount = new bignumber_default(String(campaign.fund_amount ?? 0));
+  const balanceNum = new bignumber_default(String(campaign.balance ?? 0));
+  const pct = fundAmount.gt(0) ? balanceNum.dividedBy(fundAmount).times(100).toFixed(1) : "0.0";
+  const fundTokenSymbol = String(campaign.fund_token_symbol ?? campaign.fund_token ?? "-");
+  printText(`${indent}${exchange} ${symbol} (${type})${joinedTag}`);
+  printText(`${indent}  chain:      ${chainId}`);
+  printText(`${indent}  address:    ${address}`);
+  printText(`${indent}  status:     ${status}`);
+  printText(`${indent}  duration:   ${formatCampaignTimestamp(startDate)} ~ ${formatCampaignTimestamp(endDate)}`);
+  printText(`${indent}  funded:     ${formatTokenAmount(String(campaign.fund_amount ?? 0), decimals)} ${fundTokenSymbol}  paid: ${formatTokenAmount(String(campaign.amount_paid ?? 0), decimals)}  balance: ${formatTokenAmount(String(campaign.balance ?? 0), decimals)} (${pct}%)`);
+  if (showLauncher && launcher) {
+    printText(`${indent}  launcher:   ${launcher}`);
+  }
+}
 function createCampaignCommand() {
   const campaign = new Command("campaign").description("Campaign management commands");
   campaign.command("list").description("List available campaigns").option("-c, --chain-id <id>", "Chain ID (default: from config)", Number, getDefaultChainId()).option("-s, --status <status>", "Filter by status (active, completed, cancelled, to_cancel)", "active").option("--page <n>", "Page number", Number, 1).option("--page-size <n>", "Items per page", Number, 20).option("-l, --limit <n>", "Max results", Number, 20).option("--json", "Output as JSON").action(async (opts) => {
@@ -25017,16 +25148,10 @@ 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 fundAmount = new bignumber_default(c.fund_amount);
-            const balanceNum = new bignumber_default(c.balance);
-            const pct = fundAmount.gt(0) ? balanceNum.dividedBy(fundAmount).times(100).toFixed(1) : "0.0";
-            printText(`  ${c.exchange_name} ${c.symbol} (${c.type})${tag}`);
-            printText(`    chain:      ${c.chain_id}`);
-            printText(`    address:    ${c.address}`);
-            printText(`    status:     ${c.status}`);
-            printText(`    duration:   ${formatCampaignTimestamp(c.start_date)} ~ ${formatCampaignTimestamp(c.end_date)}`);
-            printText(`    funded:     ${formatTokenAmount(c.fund_amount, decimals)} ${c.fund_token_symbol}  paid: ${formatTokenAmount(c.amount_paid, decimals)}  balance: ${formatTokenAmount(c.balance, decimals)} (${pct}%)`);
+            printCampaignSummary(c, {
+              indent: "  ",
+              joinedTag: tag
+            });
             printText("");
           }
           if (opts.status === "active") {
@@ -25078,10 +25203,24 @@ function createCampaignCommand() {
         if (campaigns.length === 0) {
           printText("No joined campaigns found.");
         } else {
-          printText(`Joined campaigns (${campaigns.length}):`);
+          printText(`Joined campaigns (${campaigns.length}):
+`);
           for (const c of campaigns) {
-            const label = c.campaign_name ?? c.name ?? c.id;
-            printText(`  - ${label}`);
+            const record = c;
+            const hasListMetadata = Boolean(record.exchange_name ?? record.symbol ?? record.type ?? record.address ?? record.escrow_address);
+            if (hasListMetadata) {
+              printCampaignSummary(record, {
+                indent: "  ",
+                showLauncher: typeof record.launcher === "string"
+              });
+            } else {
+              const exchange = String(record.exchange_name ?? "").trim();
+              const symbol = String(record.symbol ?? "").trim();
+              const exchangeSymbol = [exchange, symbol].filter(Boolean).join(" ");
+              const label = record.campaign_name ?? record.name ?? (exchangeSymbol || undefined) ?? record.address ?? record.escrow_address ?? c.id ?? "(unnamed campaign)";
+              printText(`  - ${label}`);
+            }
+            printText("");
           }
         }
       }
@@ -25171,9 +25310,12 @@ function createCampaignCommand() {
           const r = result;
           if (r.message) {
             printText(String(r.message));
+          } else if ("from" in r || "to" in r || "my_score" in r || "my_meta" in r || "total_meta" in r) {
+            printCampaignProgressCard(r);
           } else {
             for (const [key, value] of Object.entries(r)) {
-              printText(`  ${key}: ${value}`);
+              const displayValue = value !== null && typeof value === "object" ? JSON.stringify(value) : String(value);
+              printText(`  ${key}: ${displayValue}`);
             }
           }
         }
@@ -25406,11 +25548,17 @@ function createStakingCommand() {
       process.exitCode = 1;
     }
   });
-  staking.command("stake").description("Stake HMT tokens").requiredOption("-a, --amount <amount>", "Amount of HMT to stake").option("-c, --chain-id <id>", "Chain ID (default: from config)", Number, getDefaultChainId()).option("--json", "Output as JSON").action(async (opts) => {
+  staking.command("stake [amount]").description("Stake HMT tokens").usage("[amount] [options]").option("-a, --amount <amount>", "Amount of HMT to stake").option("-c, --chain-id <id>", "Chain ID (default: from config)", Number, getDefaultChainId()).option("--json", "Output as JSON").action(async (amountArg, opts) => {
+    const amount = amountArg ?? opts.amount;
+    if (!amount) {
+      printText("Amount is required. Usage: hufi staking stake <amount>");
+      process.exitCode = 1;
+      return;
+    }
     const privateKey = requireKey();
     try {
-      printText(`Staking ${opts.amount} HMT on chain ${opts.chainId}...`);
-      const hash2 = await stakeHMT(privateKey, opts.amount, opts.chainId);
+      printText(`Staking ${amount} HMT on chain ${opts.chainId}...`);
+      const hash2 = await stakeHMT(privateKey, amount, opts.chainId);
       if (opts.json) {
         printJson({ txHash: hash2 });
       } else {
@@ -25423,11 +25571,17 @@ function createStakingCommand() {
       process.exitCode = 1;
     }
   });
-  staking.command("unstake").description("Initiate unstaking (tokens will be locked for the lock period)").requiredOption("-a, --amount <amount>", "Amount of HMT to unstake").option("-c, --chain-id <id>", "Chain ID (default: from config)", Number, getDefaultChainId()).option("--json", "Output as JSON").action(async (opts) => {
+  staking.command("unstake [amount]").description("Initiate unstaking (tokens will be locked for the lock period)").usage("[amount] [options]").option("-a, --amount <amount>", "Amount of HMT to unstake").option("-c, --chain-id <id>", "Chain ID (default: from config)", Number, getDefaultChainId()).option("--json", "Output as JSON").action(async (amountArg, opts) => {
+    const amount = amountArg ?? opts.amount;
+    if (!amount) {
+      printText("Amount is required. Usage: hufi staking unstake <amount>");
+      process.exitCode = 1;
+      return;
+    }
     const privateKey = requireKey();
     try {
-      printText(`Unstaking ${opts.amount} HMT on chain ${opts.chainId}...`);
-      const hash2 = await unstakeHMT(privateKey, opts.amount, opts.chainId);
+      printText(`Unstaking ${amount} HMT on chain ${opts.chainId}...`);
+      const hash2 = await unstakeHMT(privateKey, amount, opts.chainId);
       if (opts.json) {
         printJson({ txHash: hash2 });
       } else {
@@ -25600,7 +25754,7 @@ function createDashboardCommand() {
 
 // src/cli.ts
 var program2 = new Command;
-program2.name("hufi").description("CLI tool for hu.fi DeFi platform").version("1.0.1").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) => {
+program2.name("hufi").description("CLI tool for Hu.fi platform").version("1.0.3").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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hufi-cli",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "type": "module",
   "bin": {
     "hufi": "./dist/cli.js"