hufi-cli 0.8.1 → 1.0.0

package/README.md

@@ -65,6 +65,8 @@ 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
 ```
 
@@ -141,6 +143,8 @@ 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
 ```
 
 ## Global Options

package/dist/cli.js

@@ -22697,28 +22697,62 @@ class ApiError extends Error {
 }
 
 // src/lib/http.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isRetryableStatus(status) {
+  return status === 408 || status === 429 || status >= 500;
+}
+function resolveMessage(payload, status) {
+  let message = `HTTP ${status}`;
+  if (payload && typeof payload === "object" && "message" in payload) {
+    message = String(payload.message);
+  } else if (typeof payload === "string" && payload) {
+    message = payload;
+  }
+  return message;
+}
 async function requestJson(url, options = {}) {
-  const response = await fetch(url, {
-    method: options.method ?? "GET",
-    headers: {
-      "Content-Type": "application/json",
-      ...options.headers ?? {}
-    },
-    body: options.body
-  });
-  const contentType = response.headers.get("content-type") ?? "";
-  const isJson = contentType.includes("application/json");
-  const payload = isJson ? await response.json() : await response.text();
-  if (!response.ok) {
-    let message = `HTTP ${response.status}`;
-    if (payload && typeof payload === "object" && "message" in payload) {
-      message = String(payload.message);
-    } else if (typeof payload === "string" && payload) {
-      message = payload;
+  const retries = options.retry?.retries ?? 2;
+  const initialDelayMs = options.retry?.initialDelayMs ?? 250;
+  const maxDelayMs = options.retry?.maxDelayMs ?? 3000;
+  let attempt = 0;
+  while (true) {
+    try {
+      const response = await fetch(url, {
+        method: options.method ?? "GET",
+        headers: {
+          "Content-Type": "application/json",
+          ...options.headers ?? {}
+        },
+        body: options.body
+      });
+      const contentType = response.headers.get("content-type") ?? "";
+      const isJson = contentType.includes("application/json");
+      const payload = isJson ? await response.json() : await response.text();
+      if (!response.ok) {
+        const message = resolveMessage(payload, response.status);
+        if (isRetryableStatus(response.status) && attempt < retries) {
+          const delay = Math.min(initialDelayMs * 2 ** attempt, maxDelayMs);
+          attempt += 1;
+          await sleep(delay);
+          continue;
+        }
+        throw new ApiError(message, response.status, payload);
+      }
+      return payload;
+    } catch (err) {
+      if (err instanceof ApiError) {
+        throw err;
+      }
+      if (attempt >= retries) {
+        throw err;
+      }
+      const delay = Math.min(initialDelayMs * 2 ** attempt, maxDelayMs);
+      attempt += 1;
+      await sleep(delay);
     }
-    throw new ApiError(message, response.status, payload);
   }
-  return payload;
 }
 function authHeaders(accessToken) {
   return { Authorization: `Bearer ${accessToken}` };
@@ -22840,6 +22874,38 @@ function loadKey() {
     return null;
   }
 }
+function isHttpUrl(value) {
+  try {
+    const parsed = new URL(value);
+    return parsed.protocol === "http:" || parsed.protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+function isEvmAddress(value) {
+  return /^0x[a-fA-F0-9]{40}$/.test(value);
+}
+function validateConfig(config) {
+  const issues = [];
+  if (config.recordingApiUrl !== undefined && !isHttpUrl(config.recordingApiUrl)) {
+    issues.push("recordingApiUrl must be a valid http/https URL");
+  }
+  if (config.launcherApiUrl !== undefined && !isHttpUrl(config.launcherApiUrl)) {
+    issues.push("launcherApiUrl must be a valid http/https URL");
+  }
+  if (config.defaultChainId !== undefined) {
+    if (!Number.isInteger(config.defaultChainId) || config.defaultChainId <= 0) {
+      issues.push("defaultChainId must be a positive integer");
+    }
+  }
+  if (config.address !== undefined && !isEvmAddress(config.address)) {
+    issues.push("address must be a valid 0x-prefixed EVM address");
+  }
+  return {
+    valid: issues.length === 0,
+    issues
+  };
+}
 
 // src/lib/output.ts
 function printJson(data) {
@@ -22971,8 +23037,8 @@ async function revalidateExchangeApiKey(baseUrl, accessToken, exchangeName) {
   });
 }
 
-// src/commands/exchange.ts
-function requireAuth() {
+// src/lib/require-auth.ts
+function requireAuthToken() {
   const config = loadConfig();
   if (!config.accessToken) {
     printText("Not authenticated. Run: hufi auth login --private-key <key>");
@@ -22983,10 +23049,24 @@ function requireAuth() {
     accessToken: config.accessToken
   };
 }
+function requireAuthAddress() {
+  const config = loadConfig();
+  if (!config.accessToken || !config.address) {
+    printText("Not authenticated. Run: hufi auth login --private-key <key>");
+    process.exit(1);
+  }
+  return {
+    baseUrl: config.recordingApiUrl.replace(/\/+$/, ""),
+    accessToken: config.accessToken,
+    address: config.address
+  };
+}
+
+// src/commands/exchange.ts
 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) => {
-    const { baseUrl, accessToken } = requireAuth();
+    const { baseUrl, accessToken } = requireAuthToken();
     try {
       const result = await registerExchangeApiKey(baseUrl, accessToken, opts.name, opts.apiKey, opts.secretKey, opts.bitmartMemo);
       if (opts.json) {
@@ -23004,7 +23084,7 @@ function createExchangeCommand() {
     }
   });
   exchange.command("list").description("List registered exchange API keys").option("--json", "Output as JSON").action(async (opts) => {
-    const { baseUrl, accessToken } = requireAuth();
+    const { baseUrl, accessToken } = requireAuthToken();
     try {
       const keys = await listExchangeApiKeys(baseUrl, accessToken);
       if (opts.json) {
@@ -23026,7 +23106,7 @@ function createExchangeCommand() {
     }
   });
   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) => {
-    const { baseUrl, accessToken } = requireAuth();
+    const { baseUrl, accessToken } = requireAuthToken();
     try {
       await deleteExchangeApiKey(baseUrl, accessToken, opts.name);
       if (opts.json) {
@@ -23041,7 +23121,7 @@ function createExchangeCommand() {
     }
   });
   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) => {
-    const { baseUrl, accessToken } = requireAuth();
+    const { baseUrl, accessToken } = requireAuthToken();
     try {
       const result = await revalidateExchangeApiKey(baseUrl, accessToken, opts.name);
       if (opts.json) {
@@ -24540,6 +24620,39 @@ async function getLeaderboard(baseUrl, chainId, campaignAddress, rankBy, limit =
 // src/services/campaign-create.ts
 import { createHash as createHash2 } from "node:crypto";
 
+// src/lib/blockchain.ts
+function sleep2(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function waitForConfirmations(provider, txHash, opts = {}) {
+  const minConfirmations = opts.minConfirmations ?? 1;
+  const pollMs = opts.pollMs ?? 3000;
+  const timeoutMs = opts.timeoutMs ?? 120000;
+  const started = Date.now();
+  while (Date.now() - started <= timeoutMs) {
+    const receipt = await provider.getTransactionReceipt(txHash);
+    if (!receipt) {
+      await sleep2(pollMs);
+      continue;
+    }
+    let confirmations = 0;
+    if (typeof receipt.confirmations === "function") {
+      confirmations = await receipt.confirmations();
+    } else {
+      confirmations = receipt.confirmations ?? 0;
+    }
+    opts.onProgress?.(confirmations);
+    if (confirmations >= minConfirmations) {
+      return receipt;
+    }
+    await sleep2(pollMs);
+  }
+  throw new Error(`Timed out waiting for transaction confirmation: ${txHash}`);
+}
+function estimateGasWithBuffer(estimated, bps = 1200) {
+  return estimated * BigInt(1e4 + bps) / BigInt(1e4);
+}
+
 // src/lib/contracts.ts
 var HUMAN_PROTOCOL_CONTRACTS = {
   137: {
@@ -24617,6 +24730,10 @@ function getFundTokenAddress(chainId, symbol) {
 }
 
 // src/services/campaign-create.ts
+var CHAIN_NATIVE_SYMBOL = {
+  137: "MATIC",
+  1: "ETH"
+};
 function getProvider2(chainId) {
   return new JsonRpcProvider(getRpc(chainId), chainId, { staticNetwork: true, batchMaxCount: 1 });
 }
@@ -24655,7 +24772,51 @@ function buildManifest(params) {
 function hashManifest(manifest) {
   return createHash2("sha1").update(manifest).digest("hex");
 }
-async function createCampaign(privateKey, chainId, params) {
+async function preflightCampaign(privateKey, chainId, params) {
+  const contracts = getContracts(chainId);
+  const provider = getProvider2(chainId);
+  const wallet = new Wallet(privateKey, provider);
+  const tokenAddress = getFundTokenAddress(chainId, params.fundToken);
+  const fundTokenContract = new Contract(tokenAddress, ERC20_ABI, wallet);
+  const [decimals, balance, allowance, nativeBalance, gasPrice] = await Promise.all([
+    fundTokenContract.getFunction("decimals")(),
+    fundTokenContract.getFunction("balanceOf")(wallet.address),
+    fundTokenContract.getFunction("allowance")(wallet.address, contracts.escrowFactory),
+    provider.getBalance(wallet.address),
+    provider.getFeeData().then((d) => d.gasPrice ?? 0n)
+  ]);
+  const fundAmountWei = parseUnits(params.fundAmount, decimals);
+  const needsApproval = allowance < fundAmountWei;
+  const manifest = buildManifest(params);
+  const manifestHash = hashManifest(manifest);
+  const factory = new Contract(contracts.escrowFactory, ESCROW_FACTORY_ABI, wallet);
+  const [approveGasEstimate, createGasEstimate] = await Promise.all([
+    needsApproval ? fundTokenContract.getFunction("approve").estimateGas(contracts.escrowFactory, fundAmountWei) : Promise.resolve(0n),
+    factory.getFunction("createFundAndSetupEscrow").estimateGas(tokenAddress, fundAmountWei, "hufi-campaign-launcher", ORACLES.reputationOracle, ORACLES.recordingOracle, ORACLES.exchangeOracle, manifest, manifestHash)
+  ]);
+  return {
+    needsApproval,
+    fundTokenBalance: balance,
+    fundTokenDecimals: decimals,
+    fundTokenSymbol: params.fundToken.toUpperCase(),
+    approveGasEstimate,
+    createGasEstimate,
+    nativeBalance,
+    gasPrice
+  };
+}
+function estimateTotalGasCost(result, chainId) {
+  const totalGasUnits = (result.needsApproval ? result.approveGasEstimate : 0n) + result.createGasEstimate;
+  const bufferedGasUnits = estimateGasWithBuffer(totalGasUnits);
+  const totalGasWei = bufferedGasUnits * result.gasPrice;
+  const nativeSymbol = CHAIN_NATIVE_SYMBOL[chainId] ?? "ETH";
+  return {
+    totalGasWei,
+    nativeSymbol,
+    insufficientNative: result.nativeBalance < totalGasWei
+  };
+}
+async function createCampaign(privateKey, chainId, params, onConfirmationProgress) {
   const contracts = getContracts(chainId);
   const provider = getProvider2(chainId);
   const wallet = new Wallet(privateKey, provider);
@@ -24665,14 +24826,27 @@ async function createCampaign(privateKey, chainId, params) {
   const fundAmountWei = parseUnits(params.fundAmount, decimals);
   const allowance = await hmtContract.getFunction("allowance")(wallet.address, contracts.escrowFactory);
   if (allowance < fundAmountWei) {
-    const approveTx = await hmtContract.getFunction("approve")(contracts.escrowFactory, fundAmountWei);
-    await approveTx.wait();
+    const approveEstimate = await hmtContract.getFunction("approve").estimateGas(contracts.escrowFactory, fundAmountWei);
+    const approveTx = await hmtContract.getFunction("approve")(contracts.escrowFactory, fundAmountWei, { gasLimit: estimateGasWithBuffer(approveEstimate) });
+    await waitForConfirmations(provider, approveTx.hash, { minConfirmations: 1 });
   }
   const manifest = buildManifest(params);
   const manifestHash = hashManifest(manifest);
   const factory = new Contract(contracts.escrowFactory, ESCROW_FACTORY_ABI, wallet);
-  const tx = await factory.getFunction("createFundAndSetupEscrow")(tokenAddress, fundAmountWei, "hufi-campaign-launcher", ORACLES.reputationOracle, ORACLES.recordingOracle, ORACLES.exchangeOracle, manifest, manifestHash);
-  const receipt = await tx.wait();
+  const createEstimate = await factory.getFunction("createFundAndSetupEscrow").estimateGas(tokenAddress, fundAmountWei, "hufi-campaign-launcher", ORACLES.reputationOracle, ORACLES.recordingOracle, ORACLES.exchangeOracle, manifest, manifestHash);
+  const tx = await factory.getFunction("createFundAndSetupEscrow")(tokenAddress, fundAmountWei, "hufi-campaign-launcher", ORACLES.reputationOracle, ORACLES.recordingOracle, ORACLES.exchangeOracle, manifest, manifestHash, { gasLimit: estimateGasWithBuffer(createEstimate) });
+  const receipt = await waitForConfirmations(provider, tx.hash, {
+    minConfirmations: 1,
+    onProgress: (confirmations2) => {
+      onConfirmationProgress?.(confirmations2);
+    }
+  });
+  let confirmations = 1;
+  if (typeof receipt.confirmations === "function") {
+    confirmations = await receipt.confirmations();
+  } else {
+    confirmations = receipt.confirmations ?? 1;
+  }
   const iface = factory.interface;
   let escrowAddress = "";
   for (const log of receipt.logs) {
@@ -24686,13 +24860,15 @@ async function createCampaign(privateKey, chainId, params) {
   }
   return {
     escrowAddress: escrowAddress || "unknown",
-    txHash: receipt.hash
+    txHash: receipt.hash,
+    status: "confirmed",
+    confirmations
   };
 }
 
 // src/services/launcher/campaign.ts
-async function listLauncherCampaigns(baseUrl, chainId, limit = 20, status = "active") {
-  const url = `${baseUrl}/campaigns?chain_id=${chainId}&status=${status}&limit=${limit}`;
+async function listLauncherCampaigns(baseUrl, chainId, limit = 20, status = "active", page = 1) {
+  const url = `${baseUrl}/campaigns?chain_id=${chainId}&status=${status}&limit=${limit}&page=${page}`;
   return await requestJson(url);
 }
 async function getLauncherCampaign(baseUrl, chainId, campaignAddress) {
@@ -24773,18 +24949,28 @@ async function withdrawHMT(privateKey, chainId) {
   return receipt.hash;
 }
 
+// src/lib/watch.ts
+function sleep3(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function runWatchLoop(fn, options = {}) {
+  const intervalMs = options.intervalMs ?? 1e4;
+  const shouldContinue = options.shouldContinue ?? (() => true);
+  while (shouldContinue()) {
+    await fn();
+    if (!shouldContinue()) {
+      break;
+    }
+    await sleep3(intervalMs);
+  }
+}
+
 // src/commands/campaign.ts
-function requireAuth2() {
-  const config = loadConfig();
-  if (!config.accessToken || !config.address) {
-    printText("Not authenticated. Run: hufi auth login --private-key <key>");
-    process.exit(1);
+function formatCampaignCreateProgress(confirmations) {
+  if (confirmations <= 0) {
+    return "Transaction submitted. Waiting for confirmations...";
   }
-  return {
-    baseUrl: config.recordingApiUrl.replace(/\/+$/, ""),
-    accessToken: config.accessToken,
-    address: config.address
-  };
+  return `Confirmations: ${confirmations}`;
 }
 function getLauncherUrl() {
   const config = loadConfig();
@@ -24792,10 +24978,11 @@ function getLauncherUrl() {
 }
 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("-l, --limit <n>", "Max results", Number, 20).option("--json", "Output as JSON").action(async (opts) => {
+  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) => {
     const config = loadConfig();
     try {
-      const launcherResult = await listLauncherCampaigns(getLauncherUrl(), opts.chainId, opts.limit, opts.status);
+      const pageSize = opts.pageSize ?? opts.limit;
+      const launcherResult = await listLauncherCampaigns(getLauncherUrl(), opts.chainId, pageSize, opts.status, opts.page);
       let joinedKeys = new Set;
       if (config.accessToken) {
         const recordingUrl = config.recordingApiUrl.replace(/\/+$/, "");
@@ -24839,6 +25026,9 @@ function createCampaignCommand() {
           if (opts.status === "active") {
             printText("Tip: use --status completed, --status cancelled, or --status to_cancel to see other campaigns.");
           }
+          if (launcherResult.has_more) {
+            printText(`Tip: more campaigns available, try --page ${opts.page + 1} --page-size ${pageSize}.`);
+          }
         }
       }
     } catch (err) {
@@ -24873,7 +25063,7 @@ function createCampaignCommand() {
     }
   });
   campaign.command("joined").description("List campaigns you have joined").option("-l, --limit <n>", "Max results", Number, 20).option("--json", "Output as JSON").action(async (opts) => {
-    const { baseUrl, accessToken } = requireAuth2();
+    const { baseUrl, accessToken } = requireAuthAddress();
     try {
       const result = await listJoinedCampaigns(baseUrl, accessToken, opts.limit);
       if (opts.json) {
@@ -24901,7 +25091,7 @@ function createCampaignCommand() {
       statusCmd.help();
       return;
     }
-    const { baseUrl, accessToken } = requireAuth2();
+    const { baseUrl, accessToken } = requireAuthAddress();
     try {
       const status = await checkJoinStatus(baseUrl, accessToken, opts.chainId, opts.address);
       if (opts.json) {
@@ -24924,7 +25114,7 @@ function createCampaignCommand() {
       joinCmd.help();
       return;
     }
-    const { baseUrl, accessToken } = requireAuth2();
+    const { baseUrl, accessToken } = requireAuthAddress();
     try {
       const joinStatus = await checkJoinStatus(baseUrl, accessToken, opts.chainId, opts.address);
       if (joinStatus.status === "already_joined") {
@@ -24949,25 +25139,53 @@ function createCampaignCommand() {
       process.exitCode = 1;
     }
   });
-  const progressCmd = campaign.command("progress").description("Check your progress in a campaign").option("-c, --chain-id <id>", "Chain ID (default: from config)", Number, getDefaultChainId()).option("-a, --address <address>", "Campaign escrow address").option("--json", "Output as JSON").action(async (opts) => {
+  const progressCmd = campaign.command("progress").description("Check your progress in a campaign").option("-c, --chain-id <id>", "Chain ID (default: from config)", Number, getDefaultChainId()).option("-a, --address <address>", "Campaign escrow address").option("--watch", "Poll continuously").option("--interval <ms>", "Polling interval in ms", Number, 1e4).option("--json", "Output as JSON").action(async (opts) => {
     if (!opts.address) {
       progressCmd.help();
       return;
     }
-    const { baseUrl, accessToken } = requireAuth2();
+    const { baseUrl, accessToken } = requireAuthAddress();
     try {
-      const result = await getMyProgress(baseUrl, accessToken, opts.chainId, opts.address);
-      if (opts.json) {
-        printJson(result);
-      } else {
-        const r = result;
-        if (r.message) {
-          printText(String(r.message));
+      let running = true;
+      let hasRunOnce = false;
+      let watchStoppedBySignal = false;
+      const stop = () => {
+        running = false;
+        watchStoppedBySignal = true;
+        printText("Stopped watching progress.");
+      };
+      if (opts.watch) {
+        process.once("SIGINT", stop);
+      }
+      await runWatchLoop(async () => {
+        hasRunOnce = true;
+        const result = await getMyProgress(baseUrl, accessToken, opts.chainId, opts.address);
+        if (opts.json) {
+          printJson(result);
         } else {
-          for (const [key, value] of Object.entries(r)) {
-            printText(`  ${key}: ${value}`);
+          const r = result;
+          if (r.message) {
+            printText(String(r.message));
+          } else {
+            for (const [key, value] of Object.entries(r)) {
+              printText(`  ${key}: ${value}`);
+            }
           }
         }
+        if (opts.watch) {
+          printText("---");
+        }
+      }, {
+        intervalMs: opts.interval,
+        shouldContinue: () => opts.watch ? running : !hasRunOnce
+      });
+      if (opts.watch) {
+        process.removeListener("SIGINT", stop);
+        if (watchStoppedBySignal) {
+          process.exitCode = 0;
+        }
+      } else {
+        return;
       }
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
@@ -25053,16 +25271,6 @@ function createCampaignCommand() {
       printText("--minimum-balance-target is required for threshold campaigns.");
       process.exit(1);
     }
-    try {
-      const stakingInfo = await getStakingInfo(address, opts.chainId);
-      if (Number(stakingInfo.stakedTokens) <= 0) {
-        printText("You must stake HMT before creating a campaign.");
-        printText("Run: hufi staking stake -a <amount>");
-        process.exit(1);
-      }
-    } catch {
-      printText("Warning: could not verify staking status.");
-    }
     const params = {
       type: typeMap[type],
       exchange: opts.exchange,
@@ -25076,12 +25284,65 @@ function createCampaignCommand() {
       dailyBalanceTarget: opts.dailyBalanceTarget,
       minimumBalanceTarget: opts.minimumBalanceTarget
     };
+    let minimumStake = "0";
+    try {
+      const stakingInfo = await getStakingInfo(address, opts.chainId);
+      minimumStake = stakingInfo.minimumStake;
+      if (Number(stakingInfo.stakedTokens) < Number(minimumStake)) {
+        printText("Insufficient staked HMT to create a campaign.");
+        printText(`  Required:  ${Number(minimumStake).toLocaleString()} HMT (minimum stake)`);
+        printText(`  Your stake: ${Number(stakingInfo.stakedTokens).toLocaleString()} HMT`);
+        printText("");
+        printText("Stake more HMT with: hufi staking stake -a <amount>");
+        process.exit(1);
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      printText(`Warning: could not verify staking status: ${message}`);
+      printText("Proceeding anyway...");
+    }
+    let preflight;
     try {
-      printText(`Creating ${type} campaign on ${opts.exchange}...`);
-      printText(`  Fund: ${opts.fundAmount} ${opts.fundToken}`);
-      printText(`  Duration: ${opts.startDate} ~ ${opts.endDate}`);
-      printText("");
-      const result = await createCampaign(privateKey, opts.chainId, params);
+      preflight = await preflightCampaign(privateKey, opts.chainId, params);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      printText(`Preflight check failed: ${message}`);
+      process.exitCode = 1;
+      return;
+    }
+    const fundAmountWei = BigInt(Math.floor(Number(opts.fundAmount) * 10 ** preflight.fundTokenDecimals));
+    if (preflight.fundTokenBalance < fundAmountWei) {
+      printText(`Insufficient ${preflight.fundTokenSymbol} balance.`);
+      printText(`  Required: ${opts.fundAmount} ${preflight.fundTokenSymbol}`);
+      printText(`  Balance:  ${formatUnits(preflight.fundTokenBalance, preflight.fundTokenDecimals)} ${preflight.fundTokenSymbol}`);
+      process.exit(1);
+    }
+    const gasCost = estimateTotalGasCost(preflight, opts.chainId);
+    printText("Campaign creation summary:");
+    printText(`  Type:       ${type} on ${opts.exchange}`);
+    printText(`  Symbol:     ${opts.symbol}`);
+    printText(`  Fund:       ${opts.fundAmount} ${preflight.fundTokenSymbol}`);
+    printText(`  Duration:   ${opts.startDate} ~ ${opts.endDate}`);
+    printText(`  Chain:      ${opts.chainId}`);
+    printText("");
+    printText("Estimated gas costs:");
+    if (preflight.needsApproval) {
+      printText(`  Approval:   ~${preflight.approveGasEstimate.toLocaleString()} gas`);
+    }
+    printText(`  Creation:   ~${preflight.createGasEstimate.toLocaleString()} gas`);
+    printText(`  Total:      ~${formatUnits(gasCost.totalGasWei, 18)} ${gasCost.nativeSymbol}`);
+    printText("");
+    if (gasCost.insufficientNative) {
+      printText(`Insufficient ${gasCost.nativeSymbol} for gas.`);
+      printText(`  Balance: ${formatUnits(preflight.nativeBalance, 18)} ${gasCost.nativeSymbol}`);
+      printText(`  Needed:  ~${formatUnits(gasCost.totalGasWei, 18)} ${gasCost.nativeSymbol}`);
+      process.exit(1);
+    }
+    try {
+      printText(formatCampaignCreateProgress(0));
+      const result = await createCampaign(privateKey, opts.chainId, params, (confirmations) => {
+        printText(formatCampaignCreateProgress(confirmations));
+      });
       if (opts.json) {
         printJson(result);
       } else {
@@ -25214,22 +25475,34 @@ Send HMT to this address on Polygon (chain 137) or Ethereum (chain 1).`);
   return staking;
 }
 
-// src/commands/dashboard.ts
-function requireAuth3() {
-  const config = loadConfig();
-  if (!config.accessToken || !config.address) {
-    printText("Not authenticated. Run: hufi auth login --private-key <key>");
-    process.exit(1);
+// src/lib/export.ts
+function toCsvRows(rows) {
+  if (rows.length === 0) {
+    return "";
   }
-  return {
-    baseUrl: config.recordingApiUrl.replace(/\/+$/, ""),
-    accessToken: config.accessToken,
-    address: config.address
-  };
+  const first = rows[0];
+  if (!first) {
+    return "";
+  }
+  const headers = Object.keys(first);
+  const headerLine = headers.join(",");
+  const lines = rows.map((row) => headers.map((key) => {
+    const value = row[key];
+    const raw = value === null || value === undefined ? "" : String(value);
+    if (raw.includes(",") || raw.includes(`
+`) || raw.includes('"')) {
+      return `"${raw.replaceAll('"', '""')}"`;
+    }
+    return raw;
+  }).join(","));
+  return [headerLine, ...lines].join(`
+`);
 }
+
+// src/commands/dashboard.ts
 function createDashboardCommand() {
-  const dashboard = new Command("dashboard").description("Portfolio overview — staking, campaigns, and earnings").option("-c, --chain-id <id>", "Chain ID (default: from config)", Number, getDefaultChainId()).option("--json", "Output as JSON").action(async (opts) => {
-    const { baseUrl, accessToken, address } = requireAuth3();
+  const dashboard = new Command("dashboard").description("Portfolio overview — staking, campaigns, and earnings").option("-c, --chain-id <id>", "Chain ID (default: from config)", Number, getDefaultChainId()).option("--export <format>", "Export format: csv|json").option("--json", "Output as JSON").action(async (opts) => {
+    const { baseUrl, accessToken, address } = requireAuthAddress();
     try {
       const [stakingInfo, campaignsResult] = await Promise.all([
         getStakingInfo(address, opts.chainId).catch(() => null),
@@ -25254,13 +25527,39 @@ function createDashboardCommand() {
         }
       });
       const progressResults = await Promise.all(progressPromises);
+      const summary = {
+        address,
+        chainId: opts.chainId,
+        staking: stakingInfo,
+        activeCampaigns: progressResults
+      };
+      if (opts.export) {
+        const format = String(opts.export).toLowerCase();
+        if (format === "json") {
+          printJson(summary);
+          return;
+        }
+        if (format === "csv") {
+          const rows = progressResults.map(({ campaign, progress }) => {
+            const r = campaign;
+            const p = progress ?? {};
+            return {
+              exchange: String(r.exchange_name ?? ""),
+              symbol: String(r.symbol ?? ""),
+              type: String(r.type ?? ""),
+              campaign_address: String(r.address ?? r.escrow_address ?? ""),
+              my_score: String(p.my_score ?? "")
+            };
+          });
+          printText(toCsvRows(rows));
+          return;
+        }
+        printText("Invalid export format. Use csv or json.");
+        process.exitCode = 1;
+        return;
+      }
       if (opts.json) {
-        printJson({
-          address,
-          chainId: opts.chainId,
-          staking: stakingInfo,
-          activeCampaigns: progressResults
-        });
+        printJson(summary);
         return;
       }
       printText(`Wallet: ${address}  Chain: ${opts.chainId}
@@ -25296,7 +25595,7 @@ function createDashboardCommand() {
 
 // src/cli.ts
 var program2 = new Command;
-program2.name("hufi").description("CLI tool for hu.fi DeFi platform").version("0.8.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 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) => {
   const opts = thisCommand.opts();
   if (opts.configFile) {
     setConfigFile(opts.configFile);
@@ -25304,6 +25603,15 @@ program2.name("hufi").description("CLI tool for hu.fi DeFi platform").version("0
   if (opts.keyFile) {
     setKeyFile(opts.keyFile);
   }
+  const validation = validateConfig(loadConfig());
+  if (!validation.valid) {
+    console.error("Invalid configuration:");
+    for (const issue of validation.issues) {
+      console.error(`- ${issue}`);
+    }
+    console.error("Fix config in ~/.hufi-cli/config.json or pass --config-file.");
+    process.exit(1);
+  }
 });
 program2.addCommand(createAuthCommand());
 program2.addCommand(createExchangeCommand());

package/package.json

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