hufi-cli 1.0.0 → 1.0.2

package/README.md

@@ -5,16 +5,16 @@ CLI tool for the [hu.fi](https://hu.finance) DeFi platform.
 ## Install
 
 ```bash
-bun install -g hufi-cli
+bun install -g hufi
 ```
 
 Or run without installing:
 
 ```bash
-bunx hufi-cli <command>
+bunx hufi <command>
 ```
 
-All examples below assume global install. Otherwise replace `hufi` with `bunx hufi-cli`.
+All examples below assume global install. Otherwise replace `hufi` with `bunx hufi`.
 
 ## Quick Start
 
@@ -70,10 +70,14 @@ hufi campaign progress --address 0x... --watch --interval 3000
 hufi campaign leaderboard --address 0x...                   # leaderboard
 ```
 
+`campaign list` and `campaign get` print exact campaign timestamps and round token balances for human-readable text output.
+
 #### Campaign Create
 
 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 \
@@ -110,11 +114,16 @@ Running `campaign status/join/progress/leaderboard` without `-a` shows help.
 
 ```bash
 hufi exchange register --name mexc --api-key <key> --secret-key <secret>
+hufi exchange register --name bitmart --api-key <key> --secret-key <secret> --bitmart-memo <memo>
 hufi exchange list
-hufi exchange revalidate --name mexc
-hufi exchange delete --name mexc
+hufi exchange revalidate mexc
+hufi 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 auth login` before `exchange register`, `exchange list`, `exchange delete`, or `exchange revalidate`.
+
 ### staking
 
 | Command | Description |
@@ -129,8 +138,8 @@ hufi exchange delete --name mexc
 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 stake 1000                                # stake 1000 HMT
+hufi staking unstake 500                               # unstake 500 HMT
 hufi staking withdraw                                  # withdraw unlocked tokens
 ```
 
@@ -156,7 +165,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
 
@@ -179,6 +188,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
 ```

package/dist/cli.js

@@ -23063,9 +23063,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 +23102,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 +23123,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;
     }
   });
@@ -24966,6 +24996,66 @@ async function runWatchLoop(fn, options = {}) {
 }
 
 // src/commands/campaign.ts
+function formatCampaignTimestamp(value) {
+  if (!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);
+  return rounded.toFormat().replace(/\.0+$/, "").replace(/(\.\d*?)0+$/, "$1");
+}
 function formatCampaignCreateProgress(confirmations) {
   if (confirmations <= 0) {
     return "Transaction submitted. Waiting for confirmations...";
@@ -24976,6 +25066,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) => {
@@ -25007,20 +25125,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 fmt = (v) => {
-              const bn = new bignumber_default(v).dividedBy(new bignumber_default(10).pow(decimals));
-              return bn.toFormat();
-            };
-            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:   ${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}%)`);
+            printCampaignSummary(c, {
+              indent: "  ",
+              joinedTag: tag
+            });
             printText("");
           }
           if (opts.status === "active") {
@@ -25048,12 +25156,11 @@ function createCampaignCommand() {
         printText(`  chain:      ${c.chain_id}`);
         printText(`  status:     ${c.status}`);
         const showDecimals = c.fund_token_decimals ?? 0;
-        const showFmt = (v) => new bignumber_default(v).dividedBy(new bignumber_default(10).pow(showDecimals)).toFormat();
-        printText(`  funded:     ${showFmt(c.fund_amount)} ${c.fund_token_symbol}`);
-        printText(`  balance:    ${showFmt(c.balance)} ${c.fund_token_symbol}`);
-        printText(`  paid:       ${showFmt(c.amount_paid)} ${c.fund_token_symbol}`);
-        printText(`  start:      ${c.start_date}`);
-        printText(`  end:        ${c.end_date}`);
+        printText(`  funded:     ${formatTokenAmount(c.fund_amount, showDecimals)} ${c.fund_token_symbol}`);
+        printText(`  balance:    ${formatTokenAmount(c.balance, showDecimals)} ${c.fund_token_symbol}`);
+        printText(`  paid:       ${formatTokenAmount(c.amount_paid, showDecimals)} ${c.fund_token_symbol}`);
+        printText(`  start:      ${formatCampaignTimestamp(c.start_date)}`);
+        printText(`  end:        ${formatCampaignTimestamp(c.end_date)}`);
         printText(`  launcher:   ${c.launcher}`);
       }
     } catch (err) {
@@ -25073,10 +25180,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("");
           }
         }
       }
@@ -25166,9 +25287,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}`);
             }
           }
         }
@@ -25401,11 +25525,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 {
@@ -25418,11 +25548,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 {
@@ -25595,7 +25731,7 @@ function createDashboardCommand() {
 
 // src/cli.ts
 var program2 = new Command;
-program2.name("hufi").description("CLI tool for hu.fi DeFi platform").version("1.0.0").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 DeFi platform").version("1.0.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);

package/package.json

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