@zoralabs/cli 0.2.4 → 0.3.1

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.tsx
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 import { ExitPromptError } from "@inquirer/core";
 import "fs";
 import { setApiBaseUrl } from "@zoralabs/coins-sdk";
@@ -18,6 +18,56 @@ import {
   chmodSync
 } from "fs";
 import { join } from "path";
+
+// src/lib/errors.ts
+import { BaseError as ViemBaseError, InsufficientFundsError } from "viem";
+function formatError(err) {
+  if (!(err instanceof Error)) return String(err);
+  const msg = err.message;
+  return msg.length > 120 ? msg.slice(0, 120) + "..." : msg;
+}
+function tradeErrorMessage(err) {
+  if (!(err instanceof Error)) return String(err);
+  if (err instanceof ViemBaseError) {
+    const insufficient = err.walk((e) => e instanceof InsufficientFundsError);
+    if (insufficient)
+      return "Not enough funds. Try a lower amount or run 'zora balance spendable' to check your balance.";
+    return err.shortMessage;
+  }
+  return apiErrorMessage(err);
+}
+function apiErrorMessage(err) {
+  if (!(err instanceof Error)) return String(err);
+  const code = err.code;
+  if (code === "ECONNREFUSED" || code === "ENOTFOUND")
+    return "Can't connect. Check your internet connection.";
+  if (code === "ETIMEDOUT" || code === "UND_ERR_CONNECT_TIMEOUT")
+    return "Request timed out. Try again.";
+  const status = err.status;
+  if (status === 429)
+    return "Rate limited. Wait a moment or run 'zora auth configure' for higher limits.";
+  if (status === 401 || status === 403)
+    return "Auth failed. Run 'zora auth configure' to update your API key.";
+  if (typeof status === "number" && status >= 500)
+    return "Zora is temporarily unavailable. Try again later.";
+  return formatError(err);
+}
+function bannedCoinMessage(address) {
+  return `The coin at ${address} is unavailable because it violates the Zora terms of service.`;
+}
+function bannedCoinBuyMessage(address) {
+  return `Unable to buy ${address} because it violates the Zora terms of service. Already own this coin? Run zora sell ${address} --all to exit your position.`;
+}
+function fsErrorMessage(err, path) {
+  if (!(err instanceof Error)) return String(err);
+  const code = err.code;
+  if (code === "EACCES") return `Permission denied accessing ${path}.`;
+  if (code === "EISDIR")
+    return `Expected a file but found a directory at ${path}.`;
+  return formatError(err);
+}
+
+// src/lib/config.ts
 import { homedir, platform } from "os";
 function getConfigDir() {
   if (platform() === "win32") {
@@ -55,7 +105,7 @@ function readConfig() {
     parsed = JSON.parse(readFileSync(CONFIG_FILE, "utf-8"));
   } catch (err) {
     console.error(
-      `Warning: could not parse ${CONFIG_FILE}: ${err.message}. Run 'zora auth configure' to fix.`
+      `Warning: could not parse ${CONFIG_FILE}: ${formatError(err)}. Run 'zora auth configure' to fix.`
     );
     configReadOnly = true;
     return { version: CONFIG_VERSION };
@@ -64,7 +114,7 @@ function readConfig() {
     assertVersion(parsed, CONFIG_VERSION, CONFIG_FILE);
   } catch (err) {
     console.error(
-      `Warning: ${err.message}. Delete ${CONFIG_FILE} or run 'zora auth configure' to reset.`
+      `Warning: ${formatError(err)}. Delete ${CONFIG_FILE} or run 'zora auth configure' to reset.`
     );
     configReadOnly = true;
     return { version: CONFIG_VERSION };
@@ -155,18 +205,29 @@ function maskKey(key) {
 }
 
 // src/lib/output.ts
-var VALID_OUTPUT_MODES = ["table", "json", "live"];
 var getOutputMode = (cmd, defaultMode) => {
-  const raw = cmd.optsWithGlobals().output;
-  if (!raw) return defaultMode;
-  if (VALID_OUTPUT_MODES.includes(raw)) return raw;
-  return outputErrorAndExit(
-    false,
-    `Invalid --output value: ${raw}.`,
-    `Supported: ${VALID_OUTPUT_MODES.join(", ")}`
-  );
+  const globals = cmd.optsWithGlobals();
+  const json = globals.json ?? false;
+  const live = globals.live ?? false;
+  const static_ = globals.static ?? false;
+  const set = [
+    json && "--json",
+    live && "--live",
+    static_ && "--static"
+  ].filter(Boolean);
+  if (set.length > 1) {
+    return outputErrorAndExit(
+      false,
+      `${set.join(", ")} cannot be used together.`,
+      "Choose one: --json, --live, or --static"
+    );
+  }
+  if (json) return "json";
+  if (live) return "live";
+  if (static_) return "static";
+  return defaultMode;
 };
-var getJson = (cmd) => getOutputMode(cmd, "table") === "json";
+var getJson = (cmd) => cmd.optsWithGlobals().json ?? false;
 var getYes = (cmd) => cmd.optsWithGlobals().yes ?? false;
 var outputJson = (data) => {
   console.log(JSON.stringify(data, null, 2));
@@ -188,14 +249,18 @@ var outputData = (json, opts) => {
   if (json) {
     outputJson(opts.json);
   } else {
-    opts.table();
+    opts.render();
   }
 };
-var getLiveConfig = (cmd, defaultMode) => {
-  const mode = getOutputMode(cmd, defaultMode);
+var getLiveConfig = (cmd, mode) => {
   const live = mode === "live";
-  const intervalRaw = parseInt(cmd.optsWithGlobals().interval, 10);
+  const intervalRaw = parseInt(cmd.opts().refresh, 10);
   const intervalSeconds = isNaN(intervalRaw) || intervalRaw < 5 ? 30 : intervalRaw;
+  if (!live && cmd.getOptionValueSource("refresh") === "cli") {
+    console.warn(
+      "\x1B[33mWarning:\x1B[0m --refresh has no effect without --live"
+    );
+  }
   return { live, intervalSeconds };
 };
 
@@ -282,9 +347,7 @@ var resolveAccount = (json = false) => {
   try {
     return privateKeyToAccount(normalizeKey(key));
   } catch (err) {
-    console.error(
-      `\u2717 Invalid private key: ${err instanceof Error ? err.message : String(err)}`
-    );
+    console.error(`\u2717 Invalid private key: ${formatError(err)}`);
     console.error("  Run 'zora setup --force' to replace it.");
     return process.exit(1);
   }
@@ -374,7 +437,7 @@ var getClient = () => {
   return client;
 };
 var commonProperties = () => ({
-  cli_version: true ? "0.2.4" : "development",
+  cli_version: true ? "0.3.1" : "development",
   os: process.platform,
   arch: process.arch,
   node_version: process.version
@@ -447,7 +510,7 @@ authCommand.command("configure").description("Set your Zora API key").option("--
         status: "env_override",
         message: "API key is set via ZORA_API_KEY environment variable."
       },
-      table: () => console.log(
+      render: () => console.log(
         "API key is set via ZORA_API_KEY environment variable. Unset it to configure manually."
       )
     });
@@ -475,7 +538,7 @@ authCommand.command("configure").description("Set your Zora API key").option("--
     saveApiKey(trimmed);
     outputData(json, {
       json: { saved: true, path: getConfigPath() },
-      table: () => console.log(`API key saved to ${getConfigPath()}`)
+      render: () => console.log(`API key saved to ${getConfigPath()}`)
     });
     track("cli_auth_configure", {
       output_format: json ? "json" : "text"
@@ -483,7 +546,7 @@ authCommand.command("configure").description("Set your Zora API key").option("--
   } catch (err) {
     outputErrorAndExit(
       json,
-      `Failed to save API key: ${err.message}`
+      `Failed to save API key: ${fsErrorMessage(err, getConfigPath())}`
     );
   }
 });
@@ -493,7 +556,7 @@ authCommand.command("status").description("Check authentication status").action(
   if (!apiKey) {
     outputData(json, {
       json: { authenticated: false },
-      table: () => {
+      render: () => {
         console.log(
           "No API key configured. The CLI works without one, but requests are rate-limited."
         );
@@ -512,7 +575,7 @@ authCommand.command("status").description("Check authentication status").action(
   const source = getEnvApiKey() ? "env (ZORA_API_KEY)" : getConfigPath();
   outputData(json, {
     json: { authenticated: true, key: maskKey(apiKey), source },
-    table: () => {
+    render: () => {
       console.log(`Authenticated: ${maskKey(apiKey)}`);
       console.log(`Source: ${source}`);
     }
@@ -577,7 +640,8 @@ var Table = ({
   title,
   subtitle,
   fullWidth = true,
-  footer
+  footer,
+  selectedRow
 }) => {
   const widths = computeColumnWidths(columns, fullWidth);
   return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", paddingTop: 1, paddingBottom: 1, children: [
@@ -589,26 +653,31 @@ var Table = ({
       ] })
     ] }),
     /* @__PURE__ */ jsx(Box, { paddingLeft: PADDING_LEFT, children: columns.map((col, i) => /* @__PURE__ */ jsx(Box, { width: widths[i], children: /* @__PURE__ */ jsx(Text, { bold: true, dimColor: true, wrap: "truncate", children: col.header }) }, col.header)) }),
-    data.map((row, i) => /* @__PURE__ */ jsx(Box, { paddingLeft: PADDING_LEFT, children: columns.map((col, colIdx) => {
-      const colWidth = widths[colIdx];
-      const value = col.noTruncate ? col.accessor(row) : truncate(col.accessor(row), colWidth - 2);
-      const colorName = col.color?.(row);
-      return /* @__PURE__ */ jsx(Box, { width: colWidth, children: /* @__PURE__ */ jsx(
-        Text,
-        {
-          color: colorName,
-          wrap: col.noTruncate ? "wrap" : "truncate",
-          children: value
-        }
-      ) }, col.header);
-    }) }, i)),
+    data.map((row, i) => {
+      const isSelected = selectedRow === i;
+      return /* @__PURE__ */ jsx(Box, { paddingLeft: PADDING_LEFT, children: columns.map((col, colIdx) => {
+        const colWidth = widths[colIdx];
+        const value = col.noTruncate ? col.accessor(row) : truncate(col.accessor(row), colWidth - 2);
+        const colorName = col.color?.(row);
+        return /* @__PURE__ */ jsx(Box, { width: colWidth, children: /* @__PURE__ */ jsx(
+          Text,
+          {
+            color: colorName,
+            bold: isSelected,
+            inverse: isSelected,
+            wrap: col.noTruncate ? "wrap" : "truncate",
+            children: value
+          }
+        ) }, col.header);
+      }) }, i);
+    }),
     footer && /* @__PURE__ */ jsx(Box, { paddingLeft: PADDING_LEFT, marginTop: 1, children: /* @__PURE__ */ jsx(Text, { dimColor: true, wrap: "wrap", children: footer }) })
   ] });
 };
 
 // src/lib/format.ts
 import { format, formatDistanceStrict } from "date-fns";
-import { formatEther } from "viem";
+import { formatUnits } from "viem";
 function formatCompactUsd(value) {
   if (!value || Number(value) === 0) return "$0";
   return new Intl.NumberFormat("en-US", {
@@ -657,16 +726,28 @@ function formatCreatedAt(isoDate, now) {
   if (isNaN(date.getTime())) return "-";
   return `${formatRelativeTime(date, now)} (${formatAbsoluteTime(date)})`;
 }
-var formatEthDisplay = (wei) => {
-  const eth = formatEther(wei);
-  const parts = eth.split(".");
-  if (!parts[1]) return eth;
-  const trimmed = parts[1].replace(/0+$/, "") || "0";
-  return `${parts[0]}.${trimmed}`;
+var formatAmountDisplay = (amount, decimals) => {
+  const formatted = formatUnits(amount, decimals);
+  const parts = formatted.split(".");
+  if (!parts[1]) {
+    return new Intl.NumberFormat("en-US", {
+      maximumFractionDigits: 2
+    }).format(Number(formatted));
+  }
+  const twoDecimal = `${parts[0]}.${parts[1].slice(0, 2)}`;
+  if (Number(twoDecimal) === 0 && amount > 0n) {
+    const sigIndex = parts[1].search(/[1-9]/);
+    const maxDecimals = sigIndex === -1 ? 6 : Math.min(sigIndex + 4, parts[1].length);
+    const truncated = `${parts[0]}.${parts[1].slice(0, maxDecimals)}`;
+    return new Intl.NumberFormat("en-US", {
+      maximumFractionDigits: maxDecimals
+    }).format(Number(truncated));
+  }
+  return new Intl.NumberFormat("en-US", {
+    maximumFractionDigits: 2
+  }).format(Number(formatted));
 };
-var formatCoinsDisplay = (coinsOut) => new Intl.NumberFormat("en-US", {
-  maximumFractionDigits: 2
-}).format(Number(coinsOut));
+var truncateAddress = (address) => `${address.slice(0, 6)}\u2026${address.slice(-4)}`;
 
 // src/lib/balance-format.ts
 var COIN_DECIMALS = 18;
@@ -800,6 +881,7 @@ var BalanceView = ({
   fetchData,
   sort,
   mode = "full",
+  initialCursor,
   autoRefresh = false,
   intervalSeconds = 30
 }) => {
@@ -808,37 +890,64 @@ var BalanceView = ({
   const [isRefreshing, setIsRefreshing] = useState2(false);
   const [error, setError] = useState2(null);
   const [data, setData] = useState2(null);
+  const paginated = mode === "coins";
+  const [page, setPage] = useState2(1);
+  const [cursorHistory, setCursorHistory] = useState2(
+    []
+  );
+  const [currentCursor, setCurrentCursor] = useState2(
+    initialCursor
+  );
   const { refreshCount, secondsUntilRefresh, triggerManualRefresh } = useAutoRefresh(intervalSeconds, autoRefresh);
   const [manualRefreshCount, setManualRefreshCount] = useState2(0);
   const hasLoadedOnce = useRef(false);
-  const load = useCallback2(async () => {
-    if (hasLoadedOnce.current) {
-      setIsRefreshing(true);
-    } else {
-      setLoading(true);
-    }
-    setError(null);
-    try {
-      const result = await fetchData();
-      setData(result);
-      hasLoadedOnce.current = true;
-    } catch (err) {
-      setError(err instanceof Error ? err.message : String(err));
-    }
-    setLoading(false);
-    setIsRefreshing(false);
-  }, [fetchData]);
+  const load = useCallback2(
+    async (cursor) => {
+      if (hasLoadedOnce.current) {
+        setIsRefreshing(true);
+      } else {
+        setLoading(true);
+      }
+      setError(null);
+      try {
+        const result = await fetchData(cursor);
+        setData(result);
+        hasLoadedOnce.current = true;
+      } catch (err) {
+        setError(err instanceof Error ? err.message : String(err));
+      }
+      setLoading(false);
+      setIsRefreshing(false);
+    },
+    [fetchData]
+  );
   useEffect2(() => {
-    load();
-  }, [refreshCount, manualRefreshCount]);
+    load(currentCursor);
+  }, [load, refreshCount, manualRefreshCount, currentCursor]);
   useInput((input, key) => {
     if (input === "q" || key.escape) {
       exit();
       return;
     }
-    if (input === "r" && !loading) {
+    if (loading) return;
+    if (input === "r") {
       triggerManualRefresh();
       setManualRefreshCount((c) => c + 1);
+      return;
+    }
+    if (!paginated) return;
+    const canGoNext = data?.pageInfo?.hasNextPage && data.pageInfo.endCursor;
+    const canGoPrev = cursorHistory.length > 0;
+    if ((input === "n" || key.rightArrow) && canGoNext) {
+      setCursorHistory((prev) => [...prev, currentCursor]);
+      setCurrentCursor(data.pageInfo.endCursor);
+      setPage((p) => p + 1);
+    }
+    if ((input === "p" || key.leftArrow) && canGoPrev) {
+      const prev = cursorHistory[cursorHistory.length - 1];
+      setCursorHistory((h) => h.slice(0, -1));
+      setCurrentCursor(prev);
+      setPage((p) => p - 1);
     }
   });
   if (error && !data) {
@@ -866,8 +975,10 @@ var BalanceView = ({
     ] }) });
   }
   if (!data) return null;
-  const hints = ["r refresh"];
-  if (autoRefresh) hints.push(`auto: ${secondsUntilRefresh}s`);
+  const hints = [];
+  if (paginated && cursorHistory.length > 0) hints.push("\u2190 prev");
+  if (paginated && data?.pageInfo?.hasNextPage) hints.push("\u2192 next");
+  hints.push(autoRefresh ? `r refresh (${secondsUntilRefresh}s)` : "r refresh");
   hints.push("q quit");
   const footer = hints.join("  \xB7  ");
   const showWallet = mode === "full" || mode === "wallet";
@@ -910,7 +1021,7 @@ var BalanceView = ({
         columns: balanceColumns,
         data: data.rankedBalances,
         title: `Coins \xB7 sorted by ${SORT_LABELS[sort]}`,
-        subtitle: `${data.rankedBalances.length} of ${data.total}`
+        subtitle: paginated ? `Page ${page} \xB7 ${data.rankedBalances.length} result${data.rankedBalances.length !== 1 ? "s" : ""}` : `${data.rankedBalances.length} of ${data.total}`
       }
     ) : null,
     /* @__PURE__ */ jsx2(Box2, { paddingLeft: 1, paddingBottom: 1, children: /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: footer }) })
@@ -922,7 +1033,7 @@ import { getTokenInfo } from "@zoralabs/coins-sdk";
 import {
   createPublicClient as createPublicClient2,
   erc20Abi,
-  formatUnits,
+  formatUnits as formatUnits2,
   http
 } from "viem";
 import { base as base2 } from "viem/chains";
@@ -957,7 +1068,7 @@ var fetchTokenPriceUsd = async (address, chainId = BASE_CHAIN_ID) => {
     return res.data?.erc20Token?.currency?.priceUsd ? Number(res.data.erc20Token.currency.priceUsd) : null;
   } catch (err) {
     console.warn(
-      `Warning: failed to fetch price for ${address}: ${err instanceof Error ? err.message : String(err)}`
+      `Warning: failed to fetch price for ${address}: ${formatError(err)}`
     );
     return null;
   }
@@ -1007,7 +1118,7 @@ var fetchWalletBalances = async (walletAddress) => {
   });
   const visible = resolved.filter((r) => r.balance > 0n || r.token.isNative);
   const intermediate = visible.map(({ token, balance, priceUsd }) => {
-    const human = formatUnits(balance, token.decimals);
+    const human = formatUnits2(balance, token.decimals);
     const usdValue = priceUsd !== null ? Number(human) * priceUsd : null;
     return { token, human, priceUsd, usdValue };
   });
@@ -1094,7 +1205,7 @@ function resolveContext(json) {
 function renderWallet(json, walletResult) {
   outputData(json, {
     json: { wallet: walletResult.walletBalancesJson },
-    table: () => {
+    render: () => {
       renderOnce(
         /* @__PURE__ */ jsx3(
           Table,
@@ -1108,7 +1219,7 @@ function renderWallet(json, walletResult) {
     }
   });
 }
-function renderCoins(json, balances, total, sort) {
+function renderCoins(json, balances, total, sort, limit, pageInfo) {
   const rankedBalances = balances.map((balance, index) => ({
     ...balance,
     rank: index + 1
@@ -1117,14 +1228,16 @@ function renderCoins(json, balances, total, sort) {
     json: {
       coins: rankedBalances.map(
         (balance) => formatBalanceJson(balance, balance.rank)
-      )
+      ),
+      pageInfo: pageInfo ?? null
     },
-    table: () => {
+    render: () => {
       if (balances.length === 0) {
         console.log("\n No coin balances found.\n");
         console.log(" Buy coins to see them here:");
         console.log("   zora buy <address> --eth 0.001\n");
       } else {
+        const footer = pageInfo?.hasNextPage && pageInfo.endCursor ? `Next page: zora balance coins --sort ${sort} --limit ${limit} --after ${pageInfo.endCursor}` : void 0;
         renderOnce(
           /* @__PURE__ */ jsx3(
             Table,
@@ -1132,7 +1245,8 @@ function renderCoins(json, balances, total, sort) {
               columns: balanceColumns,
               data: rankedBalances,
               title: `Coins \xB7 sorted by ${SORT_LABELS[sort]}`,
-              subtitle: `${balances.length} of ${total}`
+              subtitle: `${balances.length} of ${total}`,
+              footer
             }
           )
         );
@@ -1140,19 +1254,17 @@ function renderCoins(json, balances, total, sort) {
     }
   });
 }
-async function fetchCoins(json, address, sort, limit) {
+async function fetchCoins(json, address, sort, limit, after) {
   let response;
   try {
     response = await getProfileBalances({
       identifier: address,
       count: limit,
-      sortOption: SORT_MAP[sort]
+      sortOption: SORT_MAP[sort],
+      after
     });
   } catch (err) {
-    outputErrorAndExit(
-      json,
-      `Request failed: ${err instanceof Error ? err.message : String(err)}`
-    );
+    outputErrorAndExit(json, `Request failed: ${apiErrorMessage(err)}`);
   }
   if (response.error) {
     outputErrorAndExit(
@@ -1165,7 +1277,8 @@ async function fetchCoins(json, address, sort, limit) {
     (e) => e.node
   );
   const total = response.data?.profile?.coinBalances?.count ?? balances.length;
-  return { balances, total };
+  const pageInfo = response.data?.profile?.coinBalances?.pageInfo;
+  return { balances, total, pageInfo };
 }
 function validateCoinOpts(json, sort, limitStr) {
   if (!SORT_MAP[sort]) {
@@ -1184,11 +1297,15 @@ function validateCoinOpts(json, sort, limitStr) {
   }
   return { sort, limit };
 }
-var balanceCommand = new Command2("balance").description("Show balances in your wallet").action(async function() {
+var balanceCommand = new Command2("balance").description("Show balances in your wallet").option("--live", "Interactive live-updating display (default)").option("--static", "Static snapshot").option(
+  "--refresh <seconds>",
+  "Auto-refresh interval in seconds, requires --live (min 5)",
+  "30"
+).action(async function() {
   const output = getOutputMode(this, "live");
   const json = output === "json";
   const account = resolveContext(json);
-  const { live, intervalSeconds } = getLiveConfig(this, "live");
+  const { live, intervalSeconds } = getLiveConfig(this, output);
   const sort = "usd-value";
   const limit = 10;
   const fetchBalanceData = async () => {
@@ -1198,7 +1315,7 @@ var balanceCommand = new Command2("balance").description("Show balances in your
     ]);
     if (walletResult.status === "rejected" || coinsResult.status === "rejected") {
       const err = walletResult.status === "rejected" ? walletResult.reason : coinsResult.reason;
-      throw new Error(err instanceof Error ? err.message : String(err));
+      throw err instanceof Error ? err : new Error(String(err));
     }
     const rankedBalances = coinsResult.value.balances.map(
       (balance, index) => ({
@@ -1215,10 +1332,7 @@ var balanceCommand = new Command2("balance").description("Show balances in your
   };
   if (json) {
     const data = await fetchBalanceData().catch(
-      (err) => outputErrorAndExit(
-        json,
-        `Request failed: ${err instanceof Error ? err.message : String(err)}`
-      )
+      (err) => outputErrorAndExit(json, `Request failed: ${apiErrorMessage(err)}`)
     );
     outputData(json, {
       json: {
@@ -1227,7 +1341,7 @@ var balanceCommand = new Command2("balance").description("Show balances in your
           (balance) => formatBalanceJson(balance, balance.rank)
         )
       },
-      table: () => {
+      render: () => {
       }
     });
     track("cli_balances", {
@@ -1260,10 +1374,7 @@ var balanceCommand = new Command2("balance").description("Show balances in your
     });
   } else {
     const data = await fetchBalanceData().catch(
-      (err) => outputErrorAndExit(
-        json,
-        `Request failed: ${err instanceof Error ? err.message : String(err)}`
-      )
+      (err) => outputErrorAndExit(json, `Request failed: ${apiErrorMessage(err)}`)
     );
     renderOnce(
       /* @__PURE__ */ jsxs3(Box3, { flexDirection: "column", children: [
@@ -1311,15 +1422,19 @@ var balanceCommand = new Command2("balance").description("Show balances in your
       live: false,
       result_count: data.rankedBalances.length,
       total_count: data.total,
-      output_format: "text"
+      output_format: "static"
     });
   }
 });
-balanceCommand.command("spendable").description("Show wallet token balances (ETH, USDC, ZORA)").action(async function() {
+balanceCommand.command("spendable").description("Show wallet token balances (ETH, USDC, ZORA)").option("--live", "Interactive live-updating display (default)").option("--static", "Static snapshot").option(
+  "--refresh <seconds>",
+  "Auto-refresh interval in seconds, requires --live (min 5)",
+  "30"
+).action(async function() {
   const output = getOutputMode(this, "live");
   const json = output === "json";
   const account = resolveContext(json);
-  const { live, intervalSeconds } = getLiveConfig(this, "live");
+  const { live, intervalSeconds } = getLiveConfig(this, output);
   const fetchSpendableData = async () => {
     const walletResult = await fetchWalletBalances(account.address);
     return {
@@ -1331,14 +1446,11 @@ balanceCommand.command("spendable").description("Show wallet token balances (ETH
   };
   if (json) {
     const data = await fetchSpendableData().catch(
-      (err) => outputErrorAndExit(
-        json,
-        `Request failed: ${err instanceof Error ? err.message : String(err)}`
-      )
+      (err) => outputErrorAndExit(json, `Request failed: ${apiErrorMessage(err)}`)
     );
     outputData(json, {
       json: { wallet: data.walletBalancesJson },
-      table: () => {
+      render: () => {
       }
     });
   } else if (live) {
@@ -1356,26 +1468,29 @@ balanceCommand.command("spendable").description("Show wallet token balances (ETH
     );
   } else {
     const walletResult = await fetchWalletBalances(account.address).catch(
-      (err) => outputErrorAndExit(
-        json,
-        `Request failed: ${err instanceof Error ? err.message : String(err)}`
-      )
+      (err) => outputErrorAndExit(json, `Request failed: ${apiErrorMessage(err)}`)
     );
     renderWallet(json, walletResult);
   }
 });
-balanceCommand.command("coins").description("Show coin positions").option("--sort <sort>", `Sort by: ${SORT_OPTIONS}`, "usd-value").option("--limit <n>", "Number of results (max 20)", "10").action(async function(opts) {
+balanceCommand.command("coins").description("Show coin positions").option("--sort <sort>", `Sort by: ${SORT_OPTIONS}`, "usd-value").option("--limit <n>", "Number of results (max 20)", "10").option("--live", "Interactive live-updating display (default)").option("--static", "Static snapshot").option(
+  "--refresh <seconds>",
+  "Auto-refresh interval in seconds, requires --live (min 5)",
+  "30"
+).option("--after <cursor>", "Pagination cursor from a previous result").action(async function(opts) {
   const output = getOutputMode(this, "live");
   const json = output === "json";
   const { sort, limit } = validateCoinOpts(json, opts.sort, opts.limit);
+  const after = opts.after;
   const account = resolveContext(json);
-  const { live, intervalSeconds } = getLiveConfig(this, "live");
-  const fetchCoinsData = async () => {
-    const { balances, total } = await fetchCoins(
+  const { live, intervalSeconds } = getLiveConfig(this, output);
+  const fetchCoinsPage = async (cursor) => {
+    const { balances, total, pageInfo } = await fetchCoins(
       json,
       account.address,
       sort,
-      limit
+      limit,
+      cursor
     );
     const rankedBalances = balances.map((balance, index) => ({
       ...balance,
@@ -1385,43 +1500,53 @@ balanceCommand.command("coins").description("Show coin positions").option("--sor
       walletBalances: [],
       walletBalancesJson: [],
       rankedBalances,
-      total
+      total,
+      pageInfo
     };
   };
   if (json) {
-    const data = await fetchCoinsData();
-    renderCoins(json, data.rankedBalances, data.total, sort);
+    const data = await fetchCoinsPage(after);
+    renderCoins(
+      json,
+      data.rankedBalances,
+      data.total,
+      sort,
+      limit,
+      data.pageInfo
+    );
   } else if (live) {
     await renderLive(
       /* @__PURE__ */ jsx3(
         BalanceView,
         {
-          fetchData: fetchCoinsData,
+          fetchData: fetchCoinsPage,
           sort,
           mode: "coins",
+          initialCursor: after,
           autoRefresh: live,
           intervalSeconds
         }
       )
     );
   } else {
-    const { balances, total } = await fetchCoins(
+    const { balances, total, pageInfo } = await fetchCoins(
       json,
       account.address,
       sort,
-      limit
+      limit,
+      after
     );
-    renderCoins(json, balances, total, sort);
+    renderCoins(json, balances, total, sort, limit, pageInfo);
   }
 });
 
 // src/commands/buy.ts
 import { Command as Command3 } from "commander";
 import confirm2 from "@inquirer/confirm";
-import { parseUnits, formatUnits as formatUnits3, isAddress } from "viem";
+import { parseUnits, formatUnits as formatUnits4, isAddress } from "viem";
 import {
   setApiKey as setApiKey2,
-  getCoin,
+  getCoin as getCoin2,
   tradeCoin,
   createTradeCall
 } from "@zoralabs/coins-sdk";
@@ -1429,7 +1554,7 @@ import {
 // src/lib/trade-helpers.ts
 import {
   parseEther,
-  formatUnits as formatUnits2,
+  formatUnits as formatUnits3,
   isAddressEqual,
   parseEventLogs,
   erc20Abi as erc20Abi2
@@ -1462,25 +1587,6 @@ var parsePercentageLikeValue = (value) => {
   const parsed = Number(value);
   return Number.isFinite(parsed) ? parsed : void 0;
 };
-var formatAmountDisplay = (amount, decimals) => {
-  const formatted = formatUnits2(amount, decimals);
-  const parts = formatted.split(".");
-  if (!parts[1]) {
-    return new Intl.NumberFormat("en-US", {
-      maximumFractionDigits: 2
-    }).format(Number(formatted));
-  }
-  const twoDecimal = `${parts[0]}.${parts[1].slice(0, 2)}`;
-  let maxDecimals = 2;
-  if (Number(twoDecimal) === 0 && amount > 0n) {
-    const sigIndex = parts[1].search(/[1-9]/);
-    maxDecimals = sigIndex === -1 ? 6 : Math.min(sigIndex + 4, parts[1].length);
-  }
-  const truncated = `${parts[0]}.${parts[1].slice(0, maxDecimals)}`;
-  return new Intl.NumberFormat("en-US", {
-    maximumFractionDigits: maxDecimals
-  }).format(Number(truncated));
-};
 var getReceivedAmountFromReceipt = ({
   receipt,
   tokenAddress,
@@ -1546,12 +1652,12 @@ var printQuote = (json, info) => {
       coin: info.coinSymbol,
       address: info.address,
       spend: {
-        amount: formatUnits2(info.amountIn, info.inputTokenDecimals),
+        amount: formatUnits3(info.amountIn, info.inputTokenDecimals),
         raw: info.amountIn.toString(),
         symbol: info.inputTokenSymbol
       },
       estimated: {
-        amount: formatUnits2(BigInt(info.amountOut), 18),
+        amount: formatUnits3(BigInt(info.amountOut), 18),
         raw: info.amountOut,
         symbol: info.coinSymbol
       },
@@ -1559,29 +1665,33 @@ var printQuote = (json, info) => {
     });
     return;
   }
+  const spendFormatted = formatAmountDisplay(
+    info.amountIn,
+    info.inputTokenDecimals
+  );
+  const coinsFormatted = formatAmountDisplay(BigInt(info.amountOut), 18);
   console.log(`
- Buy ${info.coinName} (${info.coinSymbol})
+ Buy \x1B[1m${info.coinName}\x1B[0m`);
+  console.log(` ${info.coinType} \xB7 ${info.address}
 `);
-  console.log(`   Amount       ${info.spendAmount}`);
-  console.log(`   You get      ~${info.coinsFormatted} ${info.coinSymbol}`);
+  console.log(`   Amount       ${spendFormatted} ${info.inputTokenSymbol}`);
+  console.log(`   You get      ~${coinsFormatted} ${info.coinSymbol}`);
   console.log(`   Slippage     ${info.slippagePct}%
 `);
 };
 var printTradeResult = (json, info) => {
-  const receivedAmount = formatUnits2(info.receivedAmountOut, 18);
-  const receivedFormatted = formatCoinsDisplay(receivedAmount);
   if (json) {
     outputJson({
       action: "buy",
       coin: info.coinSymbol,
       address: info.address,
       spent: {
-        amount: formatUnits2(info.amountIn, info.inputTokenDecimals),
+        amount: formatUnits3(info.amountIn, info.inputTokenDecimals),
         raw: info.amountIn.toString(),
         symbol: info.inputTokenSymbol
       },
       received: {
-        amount: receivedAmount,
+        amount: formatUnits3(info.receivedAmountOut, 18),
         raw: info.receivedAmountOut.toString(),
         symbol: info.coinSymbol
       },
@@ -1589,65 +1699,274 @@ var printTradeResult = (json, info) => {
     });
     return;
   }
+  const spentFormatted = formatAmountDisplay(
+    info.amountIn,
+    info.inputTokenDecimals
+  );
+  const receivedFormatted = formatAmountDisplay(info.receivedAmountOut, 18);
   console.log(`
- Bought ${info.coinName}
+ Bought \x1B[1m${info.coinName}\x1B[0m`);
+  console.log(` ${info.coinType} \xB7 ${info.address}
 `);
-  console.log(`   Spent        ${info.spendAmount} ${info.inputTokenSymbol}`);
+  console.log(`   Spent        ${spentFormatted} ${info.inputTokenSymbol}`);
   console.log(`   Received     ${receivedFormatted} ${info.coinSymbol}`);
   console.log(`   Tx           ${info.txHash}
 `);
 };
 
+// src/lib/coin-ref.ts
+import { getCoin, getProfile, getTrend } from "@zoralabs/coins-sdk";
+var TYPE_KEYWORDS = /* @__PURE__ */ new Set(["creator-coin", "trend"]);
+var CoinArgError = class extends Error {
+  suggestion;
+  constructor(message, suggestion) {
+    super(message);
+    this.suggestion = suggestion;
+  }
+};
+function parsePositionalCoinArgs(firstArg, secondArg) {
+  if (TYPE_KEYWORDS.has(firstArg)) {
+    if (!secondArg) {
+      throw new CoinArgError(
+        `Missing identifier after "${firstArg}".`,
+        `Usage: zora <command> ${firstArg} <name>`
+      );
+    }
+    return { kind: "typed", type: firstArg, identifier: secondArg };
+  }
+  if (firstArg.startsWith("0x")) {
+    return { kind: "address", address: firstArg };
+  }
+  return { kind: "ambiguous-name", name: firstArg };
+}
+function coinArgsToRef(parsed) {
+  switch (parsed.kind) {
+    case "typed":
+      return { kind: "prefixed", type: parsed.type, name: parsed.identifier };
+    case "address":
+      return { kind: "address", address: parsed.address };
+    case "ambiguous-name":
+      return { kind: "ambiguous", name: parsed.name };
+  }
+}
+async function resolveAmbiguousName(name) {
+  const [creatorResult, trendResult] = await Promise.all([
+    resolveByCreatorName(name),
+    resolveByTrendTicker(name)
+  ]);
+  const creatorFound = creatorResult.kind === "found" ? creatorResult.coin : null;
+  const trendFound = trendResult.kind === "found" ? trendResult.coin : null;
+  if (creatorFound && trendFound) {
+    return { kind: "ambiguous", creator: creatorFound, trend: trendFound };
+  }
+  if (creatorFound) {
+    return { kind: "found", coin: creatorFound };
+  }
+  if (trendFound) {
+    return { kind: "found", coin: trendFound };
+  }
+  return {
+    kind: "not-found",
+    message: `No coin found matching "${name}".`
+  };
+}
+function formatAmbiguousError(name, creator, trend, command) {
+  const creatorMcap = formatCompactUsd(creator.marketCap);
+  const trendMcap = formatCompactUsd(trend.marketCap);
+  return {
+    message: [
+      `Multiple coins match "${name}":`,
+      `  creator-coin  ${creator.name}  ${creatorMcap} mcap`,
+      `  trend         ${trend.name}  ${trendMcap} mcap`
+    ].join("\n"),
+    suggestion: `Use: zora ${command} creator-coin ${name}  or  zora ${command} trend ${name}`
+  };
+}
+var COIN_TYPE_MAP = {
+  CONTENT: "post",
+  CREATOR: "creator-coin",
+  TREND: "trend"
+};
+function mapCoinType(raw) {
+  if (!raw) return "unknown";
+  return COIN_TYPE_MAP[raw] ?? "unknown";
+}
+function coinFromToken(token) {
+  return {
+    name: token.name ?? "Unknown",
+    address: token.address ?? "",
+    coinType: mapCoinType(token.coinType),
+    marketCap: token.marketCap ?? "0",
+    marketCapDelta24h: token.marketCapDelta24h ?? "0",
+    volume24h: token.volume24h ?? "0",
+    uniqueHolders: token.uniqueHolders ?? 0,
+    createdAt: token.createdAt,
+    creatorAddress: token.creatorAddress,
+    creatorHandle: token.creatorProfile?.handle,
+    platformBlocked: token.platformBlocked ?? false
+  };
+}
+async function resolveByAddress(address) {
+  const response = await getCoin({ address });
+  if (response.error || !response.data?.zora20Token) {
+    return {
+      kind: "not-found",
+      message: `No coin found at address ${address}`
+    };
+  }
+  return { kind: "found", coin: coinFromToken(response.data.zora20Token) };
+}
+async function resolveByTrendTicker(ticker) {
+  const response = await getTrend({ ticker });
+  if (response.error || !response.data?.trendCoin) {
+    return {
+      kind: "not-found",
+      message: `No trend coin found with ticker "${ticker}"`
+    };
+  }
+  return { kind: "found", coin: coinFromToken(response.data.trendCoin) };
+}
+async function resolveByCreatorName(name) {
+  const response = await getProfile({ identifier: name });
+  if (response.error || !response.data?.profile) {
+    return {
+      kind: "not-found",
+      message: `No creator found with name "${name}"`
+    };
+  }
+  const profile = response.data.profile;
+  if (!profile.creatorCoin) {
+    return {
+      kind: "not-found",
+      message: `"${name}" does not have a creator coin`
+    };
+  }
+  return resolveByAddress(profile.creatorCoin.address);
+}
+async function resolveCoin(ref) {
+  switch (ref.kind) {
+    case "address":
+      return resolveByAddress(ref.address);
+    case "prefixed":
+      if (ref.type === "trend") {
+        return resolveByTrendTicker(ref.name);
+      }
+      return resolveByCreatorName(ref.name);
+    case "ambiguous":
+      return resolveByCreatorName(ref.name);
+  }
+}
+
 // src/commands/buy.ts
-var buyCommand = new Command3("buy").description("Buy a coin").argument("<address>", "Coin contract address (0x\u2026)").option("--eth <value>", "Buy with ETH amount").option("--usd <value>", "Buy with USD equivalent (use with --token)").option("--token <asset>", "Token to spend: eth, usdc, zora", "eth").option("--percent <value>", "Buy with percentage of ETH balance").option("--all", "Swap all ETH for coin").option("--quote", "Print quote and exit without trading").option("--yes", "Skip confirmation and execute directly").option("--slippage <pct>", "Slippage tolerance percent", "1").option("--debug", "Print full quote request/response JSON").action(async function(coinAddress, opts) {
+var buyCommand = new Command3("buy").description("Buy a coin").argument(
+  "[typeOrId]",
+  "Type prefix (creator-coin, trend) or coin address/name"
+).argument("[identifier]", "Coin name (when type prefix is given)").option("--eth <value>", "Buy with ETH amount").option("--usd <value>", "Buy with USD equivalent (use with --token)").option("--token <asset>", "Token to spend: eth, usdc, zora", "eth").option("--percent <value>", "Buy with percentage of ETH balance").option("--all", "Swap all ETH for coin").option("--quote", "Print quote and exit without trading").option("--yes", "Skip confirmation and execute directly").option("--slippage <pct>", "Slippage tolerance percent", "1").option("--debug", "Print full quote request/response JSON").action(async function(typeOrId, identifier, opts) {
   const json = getJson(this);
   const debug = opts.debug === true;
-  if (!isAddress(coinAddress)) {
-    outputErrorAndExit(json, `Invalid address: ${coinAddress}`);
-  }
-  const tokenKey = opts.token.toLowerCase();
-  if (!(tokenKey in BASE_TRADE_TOKENS)) {
-    outputErrorAndExit(
-      json,
-      `Invalid --token value: ${opts.token}. Use: eth, usdc, zora`
-    );
-  }
-  const inputToken = BASE_TRADE_TOKENS[tokenKey];
-  const amountMode = getAmountMode(
-    json,
-    opts,
-    BUY_AMOUNT_CHECKS,
-    "--eth, --usd, --percent, or --all"
-  );
-  const slippagePct = parsePercentageLikeValue(opts.slippage);
-  if (slippagePct === void 0 || slippagePct < 0 || slippagePct > 99) {
-    outputErrorAndExit(
-      json,
-      "Invalid --slippage value. Must be between 0 and 99."
-    );
+  let parsed;
+  try {
+    parsed = parsePositionalCoinArgs(typeOrId, identifier);
+  } catch (err) {
+    if (err instanceof CoinArgError) {
+      outputErrorAndExit(json, err.message, err.suggestion);
+    }
+    throw err;
   }
-  const slippage = slippagePct / 100;
   const apiKey = getApiKey();
   if (apiKey) {
     setApiKey2(apiKey);
   }
-  const account = resolveAccount(json);
-  const { publicClient, walletClient } = createClients(account);
-  let token;
-  try {
-    const response = await getCoin({ address: coinAddress });
-    token = response.data?.zora20Token;
-  } catch (err) {
+  let coinAddress;
+  if (parsed.kind === "address") {
+    if (!isAddress(parsed.address)) {
+      outputErrorAndExit(json, `Invalid address: ${parsed.address}`);
+      return;
+    }
+    coinAddress = parsed.address;
+  } else if (parsed.kind === "ambiguous-name") {
+    let ambResult;
+    try {
+      ambResult = await resolveAmbiguousName(parsed.name);
+    } catch (err) {
+      outputErrorAndExit(
+        json,
+        `Request failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+      return;
+    }
+    if (ambResult.kind === "not-found") {
+      outputErrorAndExit(json, ambResult.message);
+      return;
+    }
+    if (ambResult.kind === "ambiguous") {
+      const { message, suggestion } = formatAmbiguousError(
+        parsed.name,
+        ambResult.creator,
+        ambResult.trend,
+        "buy"
+      );
+      outputErrorAndExit(json, message, suggestion);
+      return;
+    }
+    coinAddress = ambResult.coin.address;
+  } else {
+    const ref = coinArgsToRef(parsed);
+    try {
+      const result = await resolveCoin(ref);
+      if (result.kind === "not-found") {
+        outputErrorAndExit(json, result.message, result.suggestion);
+        return;
+      }
+      coinAddress = result.coin.address;
+    } catch (err) {
+      outputErrorAndExit(
+        json,
+        `Request failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+      return;
+    }
+  }
+  const tokenKey = opts.token.toLowerCase();
+  if (!(tokenKey in BASE_TRADE_TOKENS)) {
+    outputErrorAndExit(
+      json,
+      `Invalid --token value: ${opts.token}. Use: eth, usdc, zora`
+    );
+  }
+  const inputToken = BASE_TRADE_TOKENS[tokenKey];
+  const amountMode = getAmountMode(
+    json,
+    opts,
+    BUY_AMOUNT_CHECKS,
+    "--eth, --usd, --percent, or --all"
+  );
+  const slippagePct = parsePercentageLikeValue(opts.slippage);
+  if (slippagePct === void 0 || slippagePct < 0 || slippagePct > 99) {
     outputErrorAndExit(
       json,
-      `Failed to fetch coin: ${err instanceof Error ? err.message : String(err)}`
+      "Invalid --slippage value. Must be between 0 and 99."
     );
   }
+  const slippage = slippagePct / 100;
+  const account = resolveAccount(json);
+  const { publicClient, walletClient } = createClients(account);
+  let token;
+  try {
+    const response = await getCoin2({ address: coinAddress });
+    token = response.data?.zora20Token;
+  } catch (err) {
+    outputErrorAndExit(json, `Failed to fetch coin: ${apiErrorMessage(err)}`);
+  }
   if (!token) {
     outputErrorAndExit(json, `Coin not found: ${coinAddress}`);
   }
+  if (token.platformBlocked) {
+    outputErrorAndExit(json, bannedCoinBuyMessage(coinAddress));
+  }
   const coinName = token.name;
   const coinSymbol = token.symbol;
+  const coinType = mapCoinType(token.coinType);
   let amountIn;
   if (amountMode === "usd") {
     const usdVal = parsePercentageLikeValue(opts.usd);
@@ -1682,7 +2001,7 @@ var buyCommand = new Command3("buy").description("Buy a coin").argument("<addres
     }
     if (debug) {
       console.error(
-        `[debug] $${usdVal} USD = ${formatUnits3(amountIn, inputToken.decimals)} ${inputToken.symbol} (price: $${priceUsd})`
+        `[debug] $${usdVal} USD = ${formatUnits4(amountIn, inputToken.decimals)} ${inputToken.symbol} (price: $${priceUsd})`
       );
     }
   } else if (amountMode === "eth") {
@@ -1735,7 +2054,7 @@ var buyCommand = new Command3("buy").description("Buy a coin").argument("<addres
     if (isEth && balance <= gasReserve) {
       outputErrorAndExit(
         json,
-        `Balance too low (${formatEthDisplay(balance)} ETH). Need >${formatEthDisplay(GAS_RESERVE)} ETH for gas.`
+        `Balance too low (${formatAmountDisplay(balance, 18)} ETH). Need >${formatAmountDisplay(GAS_RESERVE, 18)} ETH for gas.`
       );
     }
     const spendableBalance = balance - gasReserve;
@@ -1765,7 +2084,7 @@ var buyCommand = new Command3("buy").description("Buy a coin").argument("<addres
     const priceUsd = inputToken.fixedPriceUsd ?? await fetchTokenPriceUsd(inputToken.priceAddress);
     if (priceUsd != null) {
       swapAmountUsd = Number(
-        (Number(formatUnits3(amountIn, inputToken.decimals)) * priceUsd).toFixed(2)
+        (Number(formatUnits4(amountIn, inputToken.decimals)) * priceUsd).toFixed(2)
       );
     }
   }
@@ -1816,29 +2135,23 @@ ${err instanceof Error ? err.stack || err.message : String(err)}
     }
     outputErrorAndExit(
       json,
-      `Quote failed: ${msg}`,
+      `Quote failed: ${apiErrorMessage(err)}`,
       "Check the coin address is valid and try again. Use --debug for full error details."
     );
   }
-  const spendAmount = formatUnits3(amountIn, inputToken.decimals);
-  const spendFormatted = new Intl.NumberFormat("en-US", {
-    maximumFractionDigits: 6
-  }).format(Number(spendAmount));
-  const coinsOut = formatUnits3(BigInt(amountOut), 18);
-  const coinsFormatted = formatCoinsDisplay(coinsOut);
+  const quoteInfo = {
+    coinName,
+    coinSymbol,
+    coinType,
+    address: coinAddress,
+    amountIn,
+    inputTokenSymbol: inputToken.symbol,
+    inputTokenDecimals: inputToken.decimals,
+    amountOut,
+    slippagePct
+  };
   if (opts.quote) {
-    printQuote(json, {
-      coinName,
-      coinSymbol,
-      address: coinAddress,
-      spendAmount: `${spendFormatted} ${inputToken.symbol}`,
-      amountIn,
-      inputTokenSymbol: inputToken.symbol,
-      inputTokenDecimals: inputToken.decimals,
-      coinsFormatted,
-      amountOut,
-      slippagePct
-    });
+    printQuote(json, quoteInfo);
     track("cli_buy", {
       action: "quote",
       coin_address: coinAddress,
@@ -1849,23 +2162,12 @@ ${err instanceof Error ? err.stack || err.message : String(err)}
       valueUsd: swapAmountUsd,
       swapCoinType: token.coinType ?? null,
       slippage: slippagePct,
-      output_format: json ? "json" : "table"
+      output_format: json ? "json" : "static"
     });
     return;
   }
   if (!opts.yes) {
-    printQuote(false, {
-      coinName,
-      coinSymbol,
-      address: coinAddress,
-      spendAmount: `${spendFormatted} ${inputToken.symbol}`,
-      amountIn,
-      inputTokenSymbol: inputToken.symbol,
-      inputTokenDecimals: inputToken.decimals,
-      coinsFormatted,
-      amountOut,
-      slippagePct
-    });
+    printQuote(false, quoteInfo);
     const ok = await confirm2({
       message: "Confirm?",
       default: false
@@ -1897,15 +2199,12 @@ ${err instanceof Error ? err.stack || err.message : String(err)}
       valueUsd: swapAmountUsd,
       swapCoinType,
       slippage: slippagePct,
-      output_format: json ? "json" : "table",
+      output_format: json ? "json" : "static",
       success: false,
       error_type: err instanceof Error ? err.constructor.name : "unknown"
     });
     await shutdownAnalytics();
-    outputErrorAndExit(
-      json,
-      `Transaction failed: ${err instanceof Error ? err.message : String(err)}`
-    );
+    outputErrorAndExit(json, tradeErrorMessage(err));
   }
   txHash = receipt.transactionHash;
   try {
@@ -1925,8 +2224,8 @@ ${err instanceof Error ? err.stack || err.message : String(err)}
   printTradeResult(json, {
     coinName,
     coinSymbol,
+    coinType,
     address: coinAddress,
-    spendAmount,
     amountIn,
     inputTokenSymbol: inputToken.symbol,
     inputTokenDecimals: inputToken.decimals,
@@ -1947,7 +2246,7 @@ ${err instanceof Error ? err.stack || err.message : String(err)}
     transactionHash: txHash,
     logIndex: swapLogIndex,
     slippage: slippagePct,
-    output_format: json ? "json" : "table",
+    output_format: json ? "json" : "static",
     success: true,
     tx_hash: txHash
   });
@@ -1960,9 +2259,6 @@ import {
   getCoinsTopVolume24h,
   getCoinsMostValuable,
   getCoinsNew,
-  getCoinsTopGainers,
-  getCoinsLastTraded,
-  getCoinsLastTradedUnique,
   getExploreTopVolumeAll24h,
   getExploreTopVolumeCreators24h,
   getExploreNewAll,
@@ -1985,9 +2281,6 @@ var SORT_LABELS2 = {
   mcap: "Top by Market Cap",
   volume: "Top by 24h Volume",
   new: "New",
-  gainers: "Top Gainers (24h)",
-  "last-traded": "Last Traded",
-  "last-traded-unique": "Last Traded (Unique)",
   trending: "Trending",
   featured: "Featured"
 };
@@ -2007,11 +2300,47 @@ var COIN_TYPE_DISPLAY = {
 import { useState as useState3, useEffect as useEffect3, useCallback as useCallback3, useRef as useRef2 } from "react";
 import { Box as Box4, Text as Text4, useInput as useInput2, useApp as useApp2 } from "ink";
 import Spinner2 from "ink-spinner";
+
+// src/lib/clipboard.ts
+import { execFileSync } from "child_process";
+import { platform as platform2 } from "os";
+var copyToClipboard = (text) => {
+  const os = platform2();
+  try {
+    if (os === "darwin") {
+      execFileSync("pbcopy", {
+        input: text,
+        stdio: ["pipe", "ignore", "ignore"]
+      });
+    } else if (os === "linux") {
+      execFileSync("xclip", ["-selection", "clipboard"], {
+        input: text,
+        stdio: ["pipe", "ignore", "ignore"]
+      });
+    } else if (os === "win32") {
+      execFileSync("clip", {
+        input: text,
+        stdio: ["pipe", "ignore", "ignore"]
+      });
+    } else {
+      return false;
+    }
+    return true;
+  } catch {
+    return false;
+  }
+};
+
+// src/components/ExploreView.tsx
 import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 var COLUMNS = [
   { header: "#", width: 4, accessor: (c) => String(c.rank) },
   { header: "Name", width: 20, accessor: (c) => c.name ?? "Unknown" },
-  { header: "Address", width: 44, accessor: (c) => c.address ?? "" },
+  {
+    header: "Address",
+    width: 14,
+    accessor: (c) => c.address ? truncateAddress(c.address) : ""
+  },
   {
     header: "Type",
     width: 14,
@@ -2061,6 +2390,11 @@ var ExploreView = ({
   const cache = useRef2(/* @__PURE__ */ new Map());
   const { refreshCount, secondsUntilRefresh, triggerManualRefresh } = useAutoRefresh(intervalSeconds, autoRefresh);
   const [manualRefreshCount, setManualRefreshCount] = useState3(0);
+  const [selectedRow, setSelectedRow] = useState3(0);
+  const [copyFeedback, setCopyFeedback] = useState3(null);
+  useEffect3(() => {
+    setSelectedRow((r) => Math.min(r, Math.max(0, coins.length - 1)));
+  }, [coins.length]);
   const loadPage = useCallback3(
     async (cursor) => {
       const cacheKey = cursor ?? CACHE_KEY_FIRST;
@@ -2101,24 +2435,44 @@ var ExploreView = ({
       return;
     }
     if (loading) return;
+    if (key.upArrow || input === "k") {
+      setSelectedRow((r) => Math.max(0, r - 1));
+      return;
+    }
+    if (key.downArrow || input === "j") {
+      setSelectedRow((r) => Math.min(coins.length - 1, r + 1));
+      return;
+    }
+    if (input === "c") {
+      const coin = coins[selectedRow];
+      if (coin?.address) {
+        const ok = copyToClipboard(coin.address);
+        setCopyFeedback(ok ? "Copied!" : "Copy failed");
+        setTimeout(() => setCopyFeedback(null), 1500);
+      }
+      return;
+    }
     const canGoNext = pageInfo?.hasNextPage && pageInfo.endCursor;
     const canGoPrev = cursorHistory.length > 0;
     if ((input === "n" || key.rightArrow) && canGoNext) {
       setCursorHistory((prev) => [...prev, currentCursor]);
       setCurrentCursor(pageInfo.endCursor);
       setPage((p) => p + 1);
+      setSelectedRow(0);
     }
     if ((input === "p" || key.leftArrow) && canGoPrev) {
       const prev = cursorHistory[cursorHistory.length - 1];
       setCursorHistory((h) => h.slice(0, -1));
       setCurrentCursor(prev);
       setPage((p) => p - 1);
+      setSelectedRow(0);
     }
     if (input === "r") {
       const cacheKey = currentCursor ?? CACHE_KEY_FIRST;
       cache.current.delete(cacheKey);
       triggerManualRefresh();
       setManualRefreshCount((c) => c + 1);
+      setSelectedRow(0);
     }
   });
   if (error) {
@@ -2172,12 +2526,13 @@ var ExploreView = ({
     rank: (page - 1) * limit + i + 1
   }));
   const hints = [];
+  hints.push("\u2191\u2193 select");
+  hints.push("c copy address");
   if (cursorHistory.length > 0) hints.push("\u2190 prev");
   if (pageInfo?.hasNextPage) hints.push("\u2192 next");
-  hints.push("r refresh");
-  if (autoRefresh) hints.push(`auto: ${secondsUntilRefresh}s`);
+  hints.push(autoRefresh ? `r refresh (${secondsUntilRefresh}s)` : "r refresh");
   hints.push("q quit");
-  const footer = hints.join("  \xB7  ");
+  const footer = hints.join("  \xB7  ") + (copyFeedback ? `  ${copyFeedback}` : "");
   return /* @__PURE__ */ jsx4(
     Table,
     {
@@ -2185,7 +2540,8 @@ var ExploreView = ({
       columns: COLUMNS,
       title,
       subtitle,
-      footer
+      footer,
+      selectedRow
     }
   );
 };
@@ -2211,15 +2567,6 @@ var QUERY_MAP = {
     "creator-coin": getCreatorCoins,
     post: getCoinsNew
   },
-  gainers: {
-    post: getCoinsTopGainers
-  },
-  "last-traded": {
-    post: getCoinsLastTraded
-  },
-  "last-traded-unique": {
-    post: getCoinsLastTradedUnique
-  },
   trending: {
     all: getTrendingAll,
     trend: getTrendingTrends,
@@ -2231,12 +2578,42 @@ var QUERY_MAP = {
     post: getExploreFeaturedVideos
   }
 };
+var STATIC_COLUMNS = [
+  { header: "#", width: 4, accessor: (c) => String(c.rank) },
+  { header: "Name", width: 20, accessor: (c) => c.name ?? "Unknown" },
+  { header: "Address", width: 48, accessor: (c) => c.address ?? "" },
+  {
+    header: "Type",
+    width: 14,
+    accessor: (c) => COIN_TYPE_DISPLAY[c.coinType ?? ""] ?? c.coinType ?? ""
+  },
+  {
+    header: "Market Cap",
+    width: 12,
+    accessor: (c) => formatCompactUsd(c.marketCap)
+  },
+  {
+    header: "24h Vol",
+    width: 12,
+    accessor: (c) => formatCompactUsd(c.volume24h)
+  },
+  {
+    header: "24h Change",
+    width: 11,
+    accessor: (c) => formatMcapChange(c.marketCap, c.marketCapDelta24h).text,
+    color: (c) => formatMcapChange(c.marketCap, c.marketCapDelta24h).color
+  }
+];
 var SORT_OPTIONS2 = Object.keys(SORT_LABELS2).join(", ");
 var exploreCommand = new Command4("explore").description("Browse top, new, and highest volume coins").option("--sort <sort>", `Sort by: ${SORT_OPTIONS2}`, "mcap").option(
   "--type <type>",
   "Filter by type: all, trend, creator-coin, post (availability varies by sort)",
-  "post"
-).option("--limit <n>", "Number of results (max 20)", "10").option("--after <cursor>", "Pagination cursor from a previous result").action(async function(opts) {
+  "creator-coin"
+).option("--limit <n>", "Number of results (max 20)", "10").option("--after <cursor>", "Pagination cursor from a previous result").option("--live", "Interactive live-updating display (default)").option("--static", "Static snapshot").option(
+  "--refresh <seconds>",
+  "Auto-refresh interval in seconds, requires --live (min 5)",
+  "30"
+).action(async function(opts) {
   const output = getOutputMode(this, "live");
   const json = output === "json";
   const sort = opts.sort;
@@ -2275,10 +2652,7 @@ var exploreCommand = new Command4("explore").description("Browse top, new, and h
     try {
       response = await queryFn({ count: limit, after });
     } catch (err) {
-      outputErrorAndExit(
-        json,
-        `Request failed: ${err instanceof Error ? err.message : String(err)}`
-      );
+      outputErrorAndExit(json, `Request failed: ${apiErrorMessage(err)}`);
     }
     if (response.error) {
       const msg = typeof response.error === "object" && response.error.error ? response.error.error : JSON.stringify(response.error);
@@ -2298,7 +2672,7 @@ var exploreCommand = new Command4("explore").description("Browse top, new, and h
       output_format: "json"
     });
   } else {
-    const { live, intervalSeconds } = getLiveConfig(this, "live");
+    const { live, intervalSeconds } = getLiveConfig(this, output);
     const fetchPage = async (cursor) => {
       const response = await queryFn({ count: limit, after: cursor });
       if (response.error) {
@@ -2310,29 +2684,55 @@ var exploreCommand = new Command4("explore").description("Browse top, new, and h
       const pageInfo = response.data?.exploreList?.pageInfo;
       return { coins, pageInfo };
     };
-    await renderLive(
-      /* @__PURE__ */ jsx5(
-        ExploreView,
-        {
-          fetchPage,
-          sort,
-          type,
-          limit,
-          initialCursor: after,
-          autoRefresh: live,
-          intervalSeconds
-        }
-      )
-    );
-    track("cli_explore", {
-      sort,
-      type,
-      limit,
-      live,
-      interval: intervalSeconds,
-      paginated: after !== void 0,
-      output_format: "text"
-    });
+    if (live) {
+      await renderLive(
+        /* @__PURE__ */ jsx5(
+          ExploreView,
+          {
+            fetchPage,
+            sort,
+            type,
+            limit,
+            initialCursor: after,
+            autoRefresh: live,
+            intervalSeconds
+          }
+        )
+      );
+      track("cli_explore", {
+        sort,
+        type,
+        limit,
+        live,
+        interval: intervalSeconds,
+        paginated: after !== void 0,
+        output_format: "live"
+      });
+    } else {
+      const { coins } = await fetchPage(after).catch(
+        (err) => outputErrorAndExit(
+          false,
+          `Request failed: ${err instanceof Error ? err.message : String(err)}`
+        )
+      );
+      const title = type !== "all" ? `${SORT_LABELS2[sort]} \xB7 ${TYPE_LABELS[type]}` : SORT_LABELS2[sort];
+      const rankedCoins = coins.map((c, i) => ({
+        ...c,
+        rank: i + 1
+      }));
+      renderOnce(
+        /* @__PURE__ */ jsx5(Table, { columns: STATIC_COLUMNS, data: rankedCoins, title })
+      );
+      track("cli_explore", {
+        sort,
+        type,
+        limit,
+        live: false,
+        paginated: after !== void 0,
+        result_count: coins.length,
+        output_format: "static"
+      });
+    }
   }
 });
 
@@ -2340,94 +2740,6 @@ var exploreCommand = new Command4("explore").description("Browse top, new, and h
 import { Command as Command5 } from "commander";
 import { setApiKey as setApiKey4 } from "@zoralabs/coins-sdk";
 
-// src/lib/coin-ref.ts
-import { getCoin as getCoin2, getProfile, getTrend } from "@zoralabs/coins-sdk";
-var COIN_TYPE_MAP = {
-  CONTENT: "post",
-  CREATOR: "creator-coin",
-  TREND: "trend"
-};
-function mapCoinType(raw) {
-  if (!raw) return "unknown";
-  return COIN_TYPE_MAP[raw] ?? "unknown";
-}
-function coinFromToken(token) {
-  return {
-    name: token.name ?? "Unknown",
-    address: token.address ?? "",
-    coinType: mapCoinType(token.coinType),
-    marketCap: token.marketCap ?? "0",
-    marketCapDelta24h: token.marketCapDelta24h ?? "0",
-    volume24h: token.volume24h ?? "0",
-    uniqueHolders: token.uniqueHolders ?? 0,
-    createdAt: token.createdAt,
-    creatorAddress: token.creatorAddress,
-    creatorHandle: token.creatorProfile?.handle
-  };
-}
-function parseCoinRef(identifier, type) {
-  if (identifier.startsWith("0x")) {
-    return { kind: "address", address: identifier };
-  }
-  if (type === "creator-coin") {
-    return { kind: "prefixed", type: "creator-coin", name: identifier };
-  }
-  if (type === "trend") {
-    return { kind: "prefixed", type: "trend", name: identifier };
-  }
-  return { kind: "ambiguous", name: identifier };
-}
-async function resolveByAddress(address) {
-  const response = await getCoin2({ address });
-  if (response.error || !response.data?.zora20Token) {
-    return {
-      kind: "not-found",
-      message: `No coin found at address ${address}`
-    };
-  }
-  return { kind: "found", coin: coinFromToken(response.data.zora20Token) };
-}
-async function resolveByTrendTicker(ticker) {
-  const response = await getTrend({ ticker });
-  if (response.error || !response.data?.trendCoin) {
-    return {
-      kind: "not-found",
-      message: `No trend coin found with ticker "${ticker}"`
-    };
-  }
-  return { kind: "found", coin: coinFromToken(response.data.trendCoin) };
-}
-async function resolveByCreatorName(name) {
-  const response = await getProfile({ identifier: name });
-  if (response.error || !response.data?.profile) {
-    return {
-      kind: "not-found",
-      message: `No creator found with name "${name}"`
-    };
-  }
-  const profile = response.data.profile;
-  if (!profile.creatorCoin) {
-    return {
-      kind: "not-found",
-      message: `"${name}" does not have a creator coin`
-    };
-  }
-  return resolveByAddress(profile.creatorCoin.address);
-}
-async function resolveCoin(ref) {
-  switch (ref.kind) {
-    case "address":
-      return resolveByAddress(ref.address);
-    case "prefixed":
-      if (ref.type === "trend") {
-        return resolveByTrendTicker(ref.name);
-      }
-      return resolveByCreatorName(ref.name);
-    case "ambiguous":
-      return resolveByCreatorName(ref.name);
-  }
-}
-
 // src/components/CoinDetail.tsx
 import { Box as Box5, Text as Text5 } from "ink";
 import { jsx as jsx6, jsxs as jsxs5 } from "react/jsx-runtime";
@@ -2482,62 +2794,108 @@ function formatCoinJson(coin) {
     creatorHandle: coin.creatorHandle ?? null
   };
 }
-var VALID_TYPES = ["creator-coin", "post", "trend"];
-var getCommand = new Command5("get").description("Look up a coin by address or name").argument("<identifier>", "Coin address (0x...) or creator name").option("--type <type>", "Coin type: creator-coin, post, trend").action(async function(identifier, opts) {
+function outputCoin(json, coin) {
+  outputData(json, {
+    json: formatCoinJson(coin),
+    render: () => {
+      renderOnce(/* @__PURE__ */ jsx7(CoinDetail, { coin }));
+    }
+  });
+}
+var getCommand = new Command5("get").description("Look up a coin by address or name").argument("[typeOrId]", "Type prefix (creator-coin, trend) or identifier").argument(
+  "[identifier]",
+  "Coin address (0x...) or name (when type prefix is given)"
+).action(async function(typeOrId, identifier) {
   const json = getJson(this);
-  if (opts.type !== void 0 && !VALID_TYPES.includes(opts.type)) {
-    outputErrorAndExit(
-      json,
-      `Invalid --type value: ${opts.type}.`,
-      `Supported: ${VALID_TYPES.join(", ")}`
-    );
+  let parsed;
+  try {
+    parsed = parsePositionalCoinArgs(typeOrId, identifier);
+  } catch (err) {
+    if (err instanceof CoinArgError) {
+      outputErrorAndExit(json, err.message, err.suggestion);
+    }
+    throw err;
   }
-  const type = opts.type;
-  if (type === "post" && !identifier.startsWith("0x")) {
-    outputErrorAndExit(
-      json,
-      "Posts can only be looked up by address.",
-      "Use: zora get 0x..."
-    );
-  }
-  const ref = parseCoinRef(identifier, opts.type);
   const apiKey = getApiKey();
   if (apiKey) {
     setApiKey4(apiKey);
   }
+  if (parsed.kind === "ambiguous-name") {
+    let ambResult;
+    try {
+      ambResult = await resolveAmbiguousName(parsed.name);
+    } catch (err) {
+      outputErrorAndExit(
+        json,
+        `Request failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+      return;
+    }
+    if (ambResult.kind === "not-found") {
+      outputErrorAndExit(json, ambResult.message);
+      return;
+    }
+    if (ambResult.kind === "ambiguous") {
+      if (json) {
+        outputData(json, {
+          json: {
+            matches: [
+              { type: "creator-coin", ...formatCoinJson(ambResult.creator) },
+              { type: "trend", ...formatCoinJson(ambResult.trend) }
+            ],
+            hint: `Use: zora get creator-coin ${parsed.name}  or  zora get trend ${parsed.name}`
+          },
+          render: () => {
+          }
+        });
+      } else {
+        outputCoin(false, ambResult.creator);
+        console.log("");
+        outputCoin(false, ambResult.trend);
+        console.log(
+          `
+\x1B[2mUse \`zora get creator-coin ${parsed.name}\` or \`zora get trend ${parsed.name}\` for a specific type.\x1B[0m`
+        );
+      }
+      track("cli_get", {
+        lookup_type: "name",
+        found: true,
+        ambiguous: true,
+        output_format: json ? "json" : "text"
+      });
+      return;
+    }
+    outputCoin(json, ambResult.coin);
+    track("cli_get", {
+      lookup_type: "name",
+      found: true,
+      coin_type: ambResult.coin.coinType,
+      output_format: json ? "json" : "text"
+    });
+    return;
+  }
+  const ref = coinArgsToRef(parsed);
   let result;
   try {
     result = await resolveCoin(ref);
   } catch (err) {
-    outputErrorAndExit(
-      json,
-      `Request failed: ${err instanceof Error ? err.message : String(err)}`
-    );
-    return;
-  }
-  if (type && result.kind === "found" && result.coin.coinType !== type) {
-    outputErrorAndExit(
-      json,
-      `Coin at ${result.coin.address} is a ${result.coin.coinType}, not a ${type}.`,
-      `Use: zora get ${result.coin.address} --type ${result.coin.coinType}`
-    );
+    outputErrorAndExit(json, `Request failed: ${apiErrorMessage(err)}`);
     return;
   }
   if (result.kind === "not-found") {
     outputErrorAndExit(json, result.message);
     return;
   }
-  outputData(json, {
-    json: formatCoinJson(result.coin),
-    table: () => {
-      renderOnce(/* @__PURE__ */ jsx7(CoinDetail, { coin: result.coin }));
-    }
-  });
+  if (result.coin.platformBlocked) {
+    outputErrorAndExit(json, bannedCoinMessage(result.coin.address));
+    return;
+  }
+  outputCoin(json, result.coin);
   track("cli_get", {
-    lookup_type: identifier.startsWith("0x") ? "address" : "name",
-    coin_type_filter: type ?? null,
-    found: result.kind === "found",
-    coin_type: result.kind === "found" ? result.coin.coinType : null,
+    lookup_type: typeOrId.startsWith("0x") ? "address" : "name",
+    coin_type_filter: parsed.kind === "typed" ? parsed.type : null,
+    found: true,
+    coin_type: result.coin.coinType,
     output_format: json ? "json" : "text"
   });
 });
@@ -2610,7 +2968,6 @@ var downsample = (values, maxWidth) => {
 
 // src/commands/price-history.tsx
 import { jsx as jsx9 } from "react/jsx-runtime";
-var VALID_TYPES2 = ["creator-coin", "post", "trend"];
 var VALID_INTERVALS = ["1h", "24h", "1w", "1m", "ALL"];
 var INTERVAL_TO_API_FIELD = {
   "1h": "oneHour",
@@ -2651,54 +3008,7 @@ var fetchPriceHistory = async (address, interval) => {
     price: Number(p.closePrice)
   }));
 };
-var priceHistoryCommand = new Command6("price-history").description("Display price history for a coin").argument("<identifier>", "Coin address (0x...) or name").option("--type <type>", "Coin type: creator-coin, post, trend").option(
-  "--interval <interval>",
-  `Time range: ${VALID_INTERVALS.join(", ")}`,
-  "1w"
-).action(async function(identifier, opts) {
-  const json = getJson(this);
-  const interval = opts.interval ?? "1w";
-  if (!VALID_INTERVALS.includes(interval)) {
-    outputErrorAndExit(
-      json,
-      `Invalid --interval value: ${interval}.`,
-      `Supported: ${VALID_INTERVALS.join(", ")}`
-    );
-  }
-  if (opts.type !== void 0 && !VALID_TYPES2.includes(opts.type)) {
-    outputErrorAndExit(
-      json,
-      `Invalid --type value: ${opts.type}.`,
-      `Supported: ${VALID_TYPES2.join(", ")}`
-    );
-  }
-  if (opts.type === "post" && !identifier.startsWith("0x")) {
-    outputErrorAndExit(
-      json,
-      "Posts can only be looked up by address.",
-      "Use: zora price-history 0x..."
-    );
-  }
-  const ref = parseCoinRef(identifier, opts.type);
-  const apiKey = getApiKey();
-  if (apiKey) {
-    setApiKey5(apiKey);
-  }
-  let result;
-  try {
-    result = await resolveCoin(ref);
-  } catch (err) {
-    outputErrorAndExit(
-      json,
-      `Request failed: ${err instanceof Error ? err.message : String(err)}`
-    );
-    return;
-  }
-  if (result.kind === "not-found") {
-    outputErrorAndExit(json, result.message, result.suggestion);
-    return;
-  }
-  const { coin } = result;
+async function showPriceHistory(json, coin, interval) {
   let prices;
   try {
     prices = await fetchPriceHistory(coin.address, interval);
@@ -2724,9 +3034,7 @@ var priceHistoryCommand = new Command6("price-history").description("Display pri
     priceValues[0],
     priceValues[priceValues.length - 1]
   );
-  const sparklineText = sparkline(
-    downsample(priceValues, MAX_SPARKLINE_WIDTH)
-  );
+  const sparklineText = sparkline(downsample(priceValues, MAX_SPARKLINE_WIDTH));
   outputData(json, {
     json: {
       coin: coin.name,
@@ -2740,7 +3048,7 @@ var priceHistoryCommand = new Command6("price-history").description("Display pri
         price: p.price
       }))
     },
-    table: () => {
+    render: () => {
       renderOnce(
         /* @__PURE__ */ jsx9(
           PriceHistory,
@@ -2757,11 +3065,139 @@ var priceHistoryCommand = new Command6("price-history").description("Display pri
       );
     }
   });
+  return prices.length;
+}
+var priceHistoryCommand = new Command6("price-history").description("Display price history for a coin").argument("[typeOrId]", "Type prefix (creator-coin, trend) or identifier").argument(
+  "[identifier]",
+  "Coin address (0x...) or name (when type prefix is given)"
+).option(
+  "--interval <interval>",
+  `Time range: ${VALID_INTERVALS.join(", ")}`,
+  "1w"
+).action(async function(typeOrId, identifier, opts) {
+  const json = getJson(this);
+  const interval = opts.interval ?? "1w";
+  if (!VALID_INTERVALS.includes(interval)) {
+    outputErrorAndExit(
+      json,
+      `Invalid --interval value: ${interval}.`,
+      `Supported: ${VALID_INTERVALS.join(", ")}`
+    );
+  }
+  let parsed;
+  try {
+    parsed = parsePositionalCoinArgs(typeOrId, identifier);
+  } catch (err) {
+    if (err instanceof CoinArgError) {
+      outputErrorAndExit(json, err.message, err.suggestion);
+    }
+    throw err;
+  }
+  const apiKey = getApiKey();
+  if (apiKey) {
+    setApiKey5(apiKey);
+  }
+  if (parsed.kind === "ambiguous-name") {
+    let ambResult;
+    try {
+      ambResult = await resolveAmbiguousName(parsed.name);
+    } catch (err) {
+      outputErrorAndExit(
+        json,
+        `Request failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+      return;
+    }
+    if (ambResult.kind === "not-found") {
+      outputErrorAndExit(json, ambResult.message);
+      return;
+    }
+    if (ambResult.kind === "ambiguous") {
+      if (json) {
+        const [creatorPrices, trendPrices] = await Promise.all([
+          fetchPriceHistory(ambResult.creator.address, interval),
+          fetchPriceHistory(ambResult.trend.address, interval)
+        ]);
+        outputData(json, {
+          json: {
+            matches: [
+              {
+                type: "creator-coin",
+                coin: ambResult.creator.name,
+                prices: creatorPrices
+              },
+              {
+                type: "trend",
+                coin: ambResult.trend.name,
+                prices: trendPrices
+              }
+            ],
+            hint: `Use: zora price-history creator-coin ${parsed.name}  or  zora price-history trend ${parsed.name}`
+          },
+          render: () => {
+          }
+        });
+      } else {
+        await showPriceHistory(
+          false,
+          ambResult.creator,
+          interval
+        );
+        console.log("");
+        await showPriceHistory(false, ambResult.trend, interval);
+        console.log(
+          `
+\x1B[2mUse \`zora price-history creator-coin ${parsed.name}\` or \`zora price-history trend ${parsed.name}\` for a specific type.\x1B[0m`
+        );
+      }
+      track("cli_price_history", {
+        lookup_type: "name",
+        ambiguous: true,
+        interval,
+        output_format: json ? "json" : "text"
+      });
+      return;
+    }
+    const dataPoints2 = await showPriceHistory(
+      json,
+      ambResult.coin,
+      interval
+    );
+    track("cli_price_history", {
+      lookup_type: "name",
+      coin_type: ambResult.coin.coinType,
+      interval,
+      data_points: dataPoints2,
+      output_format: json ? "json" : "text"
+    });
+    return;
+  }
+  const ref = coinArgsToRef(parsed);
+  let result;
+  try {
+    result = await resolveCoin(ref);
+  } catch (err) {
+    outputErrorAndExit(
+      json,
+      `Request failed: ${err instanceof Error ? err.message : String(err)}`
+    );
+    return;
+  }
+  if (result.kind === "not-found") {
+    outputErrorAndExit(json, result.message, result.suggestion);
+    return;
+  }
+  if (result.coin.platformBlocked) {
+    outputErrorAndExit(json, bannedCoinMessage(result.coin.address));
+    return;
+  }
+  const { coin } = result;
+  const dataPoints = await showPriceHistory(json, coin, interval);
   track("cli_price_history", {
-    lookup_type: identifier.startsWith("0x") ? "address" : "name",
+    lookup_type: typeOrId.startsWith("0x") ? "address" : "name",
     coin_type: coin.coinType,
     interval,
-    data_points: prices.length,
+    data_points: dataPoints,
     output_format: json ? "json" : "text"
   });
 });
@@ -2771,7 +3207,7 @@ import { Command as Command7 } from "commander";
 import confirm3 from "@inquirer/confirm";
 import {
   erc20Abi as erc20Abi3,
-  formatUnits as formatUnits4,
+  formatUnits as formatUnits5,
   isAddress as isAddress2,
   parseUnits as parseUnits2
 } from "viem";
@@ -2788,12 +3224,12 @@ function printSellQuote(output, info) {
       coin: info.coinSymbol,
       address: info.address,
       sell: {
-        amount: formatUnits4(info.amountIn, info.coinDecimals),
+        amount: formatUnits5(info.amountIn, info.coinDecimals),
         raw: info.amountIn.toString(),
         symbol: info.coinSymbol
       },
       estimated: {
-        amount: formatUnits4(BigInt(info.quoteAmountOut), info.outputDecimals),
+        amount: formatUnits5(BigInt(info.quoteAmountOut), info.outputDecimals),
         raw: info.quoteAmountOut,
         symbol: info.outputSymbol
       },
@@ -2802,7 +3238,8 @@ function printSellQuote(output, info) {
     return;
   }
   console.log(`
- Sell ${info.coinName} (${info.coinSymbol})
+ Sell \x1B[1m${info.coinName}\x1B[0m`);
+  console.log(` ${info.coinType} \xB7 ${info.address}
 `);
   console.log(`   Amount       ${info.soldFormatted} ${info.coinSymbol}`);
   console.log(
@@ -2812,7 +3249,7 @@ function printSellQuote(output, info) {
 `);
 }
 function printSellResult(output, info) {
-  const receivedAmount = formatUnits4(
+  const receivedAmount = formatUnits5(
     info.receivedAmountOut,
     info.outputDecimals
   );
@@ -2826,7 +3263,7 @@ function printSellResult(output, info) {
       coin: info.coinSymbol,
       address: info.address,
       sold: {
-        amount: formatUnits4(info.amountIn, info.coinDecimals),
+        amount: formatUnits5(info.amountIn, info.coinDecimals),
         raw: info.amountIn.toString(),
         symbol: info.coinSymbol
       },
@@ -2841,7 +3278,8 @@ function printSellResult(output, info) {
     return;
   }
   console.log(`
- Sold ${info.coinName}
+ Sold \x1B[1m${info.coinName}\x1B[0m`);
+  console.log(` ${info.coinType} \xB7 ${info.address}
 `);
   console.log(`   Sold         ${info.soldFormatted} ${info.coinSymbol}`);
   console.log(
@@ -2853,13 +3291,76 @@ function printSellResult(output, info) {
   console.log(`   Tx           ${info.txHash}
 `);
 }
-var sellCommand = new Command7("sell").description("Sell a coin").argument("<address>", "Coin contract address (0x\u2026)").option("--amount <value>", "Sell specific number of coins").option("--usd <value>", "Sell USD equivalent worth of coins").option("--percent <value>", "Sell percentage of coin balance").option("--all", "Sell entire coin balance").option("--to <asset>", "Receive asset: eth, usdc, zora", "eth").option("--token <asset>", "Receive asset: eth, usdc, zora (alias for --to)").option("--quote", "Print quote and exit without trading").option("--yes", "Skip confirmation and execute directly").option("--slippage <pct>", "Slippage tolerance percent", "1").option("--debug", "Print full quote request/response JSON").action(async function(coinAddress, opts) {
+var sellCommand = new Command7("sell").description("Sell a coin").argument(
+  "[typeOrId]",
+  "Type prefix (creator-coin, trend) or coin address/name"
+).argument("[identifier]", "Coin name (when type prefix is given)").option("--amount <value>", "Sell specific number of coins").option("--usd <value>", "Sell USD equivalent worth of coins").option("--percent <value>", "Sell percentage of coin balance").option("--all", "Sell entire coin balance").option("--to <asset>", "Receive asset: eth, usdc, zora", "eth").option("--token <asset>", "Receive asset: eth, usdc, zora (alias for --to)").option("--quote", "Print quote and exit without trading").option("--yes", "Skip confirmation and execute directly").option("--slippage <pct>", "Slippage tolerance percent", "1").option("--debug", "Print full quote request/response JSON").action(async function(typeOrId, identifier, opts) {
   const json = getJson(this);
   const debug = opts.debug === true;
-  if (!isAddress2(coinAddress)) {
-    outputErrorAndExit(json, `Invalid address: ${coinAddress}`);
+  let parsed;
+  try {
+    parsed = parsePositionalCoinArgs(typeOrId, identifier);
+  } catch (err) {
+    if (err instanceof CoinArgError) {
+      outputErrorAndExit(json, err.message, err.suggestion);
+    }
+    throw err;
+  }
+  const apiKey = getApiKey();
+  if (apiKey) {
+    setApiKey6(apiKey);
   }
-  const output = json ? "json" : "table";
+  let coinAddress;
+  if (parsed.kind === "address") {
+    if (!isAddress2(parsed.address)) {
+      outputErrorAndExit(json, `Invalid address: ${parsed.address}`);
+      return;
+    }
+    coinAddress = parsed.address;
+  } else if (parsed.kind === "ambiguous-name") {
+    let ambResult;
+    try {
+      ambResult = await resolveAmbiguousName(parsed.name);
+    } catch (err) {
+      outputErrorAndExit(
+        json,
+        `Request failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+      return;
+    }
+    if (ambResult.kind === "not-found") {
+      outputErrorAndExit(json, ambResult.message);
+      return;
+    }
+    if (ambResult.kind === "ambiguous") {
+      const { message, suggestion } = formatAmbiguousError(
+        parsed.name,
+        ambResult.creator,
+        ambResult.trend,
+        "sell"
+      );
+      outputErrorAndExit(json, message, suggestion);
+      return;
+    }
+    coinAddress = ambResult.coin.address;
+  } else {
+    const ref = coinArgsToRef(parsed);
+    try {
+      const result = await resolveCoin(ref);
+      if (result.kind === "not-found") {
+        outputErrorAndExit(json, result.message, result.suggestion);
+        return;
+      }
+      coinAddress = result.coin.address;
+    } catch (err) {
+      outputErrorAndExit(
+        json,
+        `Request failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+      return;
+    }
+  }
+  const output = json ? "json" : "static";
   const outputAsset = opts.token ? opts.token.toLowerCase() : opts.to;
   if (!(outputAsset in BASE_TRADE_TOKENS)) {
     outputErrorAndExit(
@@ -2882,10 +3383,6 @@ var sellCommand = new Command7("sell").description("Sell a coin").argument("<add
     );
   }
   const slippage = slippagePct / 100;
-  const apiKey = getApiKey();
-  if (apiKey) {
-    setApiKey6(apiKey);
-  }
   const account = resolveAccount(json);
   const { publicClient, walletClient } = createClients(account);
   let token;
@@ -2893,16 +3390,14 @@ var sellCommand = new Command7("sell").description("Sell a coin").argument("<add
     const response = await getCoin3({ address: coinAddress });
     token = response.data?.zora20Token;
   } catch (err) {
-    outputErrorAndExit(
-      json,
-      `Failed to fetch coin: ${err instanceof Error ? err.message : String(err)}`
-    );
+    outputErrorAndExit(json, `Failed to fetch coin: ${apiErrorMessage(err)}`);
   }
   if (!token) {
     outputErrorAndExit(json, `Coin not found: ${coinAddress}`);
   }
   const coinName = token.name;
   const coinSymbol = token.symbol;
+  const coinType = mapCoinType(token.coinType);
   const coinDecimals = Number(token.decimals ?? 18);
   let amountIn;
   if (amountMode === "usd") {
@@ -2929,7 +3424,7 @@ var sellCommand = new Command7("sell").description("Sell a coin").argument("<add
     }
     if (debug) {
       console.error(
-        `[debug] $${usdVal} USD = ${formatUnits4(amountIn, coinDecimals)} ${coinSymbol} (coin price: $${coinPriceUsd})`
+        `[debug] $${usdVal} USD = ${formatUnits5(amountIn, coinDecimals)} ${coinSymbol} (coin price: $${coinPriceUsd})`
       );
     }
   } else if (amountMode === "amount") {
@@ -2984,7 +3479,7 @@ var sellCommand = new Command7("sell").description("Sell a coin").argument("<add
     const coinPriceUsd = await fetchTokenPriceUsd(coinAddress);
     if (coinPriceUsd !== null && coinPriceUsd > 0) {
       swapAmountUsd = Number(
-        (Number(formatUnits4(amountIn, coinDecimals)) * coinPriceUsd).toFixed(
+        (Number(formatUnits5(amountIn, coinDecimals)) * coinPriceUsd).toFixed(
           2
         )
       );
@@ -3037,7 +3532,7 @@ ${err instanceof Error ? err.stack || err.message : String(err)}
     }
     outputErrorAndExit(
       json,
-      `Quote failed: ${msg}`,
+      `Quote failed: ${apiErrorMessage(err)}`,
       "Check the coin address and amount, then try again. Use --debug for full error details."
     );
   }
@@ -3050,6 +3545,7 @@ ${err instanceof Error ? err.stack || err.message : String(err)}
     printSellQuote(output, {
       coinName,
       coinSymbol,
+      coinType,
       address: coinAddress,
       soldFormatted,
       amountIn,
@@ -3076,9 +3572,10 @@ ${err instanceof Error ? err.stack || err.message : String(err)}
     return;
   }
   if (!opts.yes) {
-    printSellQuote("table", {
+    printSellQuote("static", {
       coinName,
       coinSymbol,
+      coinType,
       address: coinAddress,
       soldFormatted,
       amountIn,
@@ -3098,103 +3595,497 @@ ${err instanceof Error ? err.stack || err.message : String(err)}
       process.exit(0);
     }
   }
-  let receipt;
-  let txHash;
-  let receivedAmountOut = BigInt(quoteAmountOut);
-  let receivedSource = "quote";
-  let swapLogIndex = null;
-  const swapCoinType = token.coinType ?? null;
-  try {
-    receipt = await tradeCoin2({
-      tradeParameters,
-      walletClient,
-      publicClient,
-      account
-    });
-  } catch (err) {
-    track("cli_sell", {
-      action: "trade",
-      coin_address: coinAddress,
-      coin_name: coinName,
-      coin_symbol: coinSymbol,
-      amount_mode: amountMode,
-      swap_amount_usd: swapAmountUsd,
-      valueUsd: swapAmountUsd,
-      swapCoinType,
-      output_asset: outputAsset,
-      slippage: slippagePct,
-      output_format: output,
-      success: false,
-      error_type: err instanceof Error ? err.constructor.name : "unknown"
-    });
-    await shutdownAnalytics();
+  let receipt;
+  let txHash;
+  let receivedAmountOut = BigInt(quoteAmountOut);
+  let receivedSource = "quote";
+  let swapLogIndex = null;
+  const swapCoinType = token.coinType ?? null;
+  try {
+    receipt = await tradeCoin2({
+      tradeParameters,
+      walletClient,
+      publicClient,
+      account
+    });
+  } catch (err) {
+    track("cli_sell", {
+      action: "trade",
+      coin_address: coinAddress,
+      coin_name: coinName,
+      coin_symbol: coinSymbol,
+      amount_mode: amountMode,
+      swap_amount_usd: swapAmountUsd,
+      valueUsd: swapAmountUsd,
+      swapCoinType,
+      output_asset: outputAsset,
+      slippage: slippagePct,
+      output_format: output,
+      success: false,
+      error_type: err instanceof Error ? err.constructor.name : "unknown"
+    });
+    await shutdownAnalytics();
+    outputErrorAndExit(json, tradeErrorMessage(err));
+  }
+  txHash = receipt.transactionHash;
+  if (outputToken.trade.type === "erc20") {
+    try {
+      const result = getReceivedAmountFromReceipt({
+        receipt,
+        tokenAddress: outputToken.trade.address,
+        recipient: account.address
+      });
+      receivedAmountOut = result.amount;
+      swapLogIndex = result.logIndex;
+      receivedSource = "receipt";
+    } catch {
+    }
+  }
+  printSellResult(output, {
+    coinName,
+    coinSymbol,
+    coinType,
+    address: coinAddress,
+    amountIn,
+    coinDecimals,
+    soldFormatted,
+    receivedAmountOut,
+    outputSymbol: outputToken.symbol,
+    outputDecimals: outputToken.decimals,
+    receivedSource,
+    txHash
+  });
+  track("cli_sell", {
+    action: "trade",
+    coin_address: coinAddress,
+    coin_name: coinName,
+    coin_symbol: coinSymbol,
+    amount_mode: amountMode,
+    swap_amount_usd: swapAmountUsd,
+    valueUsd: swapAmountUsd,
+    swapCoinType,
+    transactionHash: txHash,
+    logIndex: swapLogIndex,
+    output_asset: outputAsset,
+    slippage: slippagePct,
+    output_format: output,
+    success: true,
+    tx_hash: txHash
+  });
+});
+
+// src/commands/profile.tsx
+import { Command as Command8 } from "commander";
+import { Box as Box8, Text as Text8 } from "ink";
+import {
+  getProfileCoins,
+  getProfileBalances as getProfileBalances2,
+  setApiKey as setApiKey7
+} from "@zoralabs/coins-sdk";
+import { privateKeyToAccount as privateKeyToAccount3 } from "viem/accounts";
+
+// src/components/ProfileView.tsx
+import { useState as useState4, useEffect as useEffect4, useCallback as useCallback4, useRef as useRef3 } from "react";
+import { Box as Box7, Text as Text7, useInput as useInput3, useApp as useApp3 } from "ink";
+import Spinner3 from "ink-spinner";
+import { jsx as jsx10, jsxs as jsxs7 } from "react/jsx-runtime";
+var TAB_NAMES = ["Posts", "Holdings"];
+var postColumns = [
+  { header: "#", width: 4, accessor: (c) => String(c.rank) },
+  { header: "Name", width: 20, accessor: (c) => c.name ?? "Unknown" },
+  {
+    header: "Type",
+    width: 14,
+    accessor: (c) => COIN_TYPE_DISPLAY[c.coinType ?? ""] ?? c.coinType ?? ""
+  },
+  {
+    header: "Market Cap",
+    width: 12,
+    accessor: (c) => formatCompactUsd(c.marketCap)
+  },
+  {
+    header: "24h Vol",
+    width: 12,
+    accessor: (c) => formatCompactUsd(c.volume24h)
+  },
+  {
+    header: "24h Change",
+    width: 11,
+    accessor: (c) => formatMcapChange(c.marketCap, c.marketCapDelta24h).text,
+    color: (c) => formatMcapChange(c.marketCap, c.marketCapDelta24h).color
+  },
+  {
+    header: "Created",
+    width: 16,
+    accessor: (c) => {
+      if (!c.createdAt) return "-";
+      const date = new Date(c.createdAt);
+      if (isNaN(date.getTime())) return "-";
+      return formatRelativeTime(date);
+    }
+  }
+];
+var ProfileView = ({
+  fetchData,
+  identifier,
+  autoRefresh = false,
+  intervalSeconds = 30
+}) => {
+  const { exit } = useApp3();
+  const [activeTab, setActiveTab] = useState4(0);
+  const [loading, setLoading] = useState4(true);
+  const [isRefreshing, setIsRefreshing] = useState4(false);
+  const [error, setError] = useState4(null);
+  const [data, setData] = useState4(null);
+  const { refreshCount, secondsUntilRefresh, triggerManualRefresh } = useAutoRefresh(intervalSeconds, autoRefresh);
+  const [manualRefreshCount, setManualRefreshCount] = useState4(0);
+  const hasLoadedOnce = useRef3(false);
+  const load = useCallback4(async () => {
+    if (hasLoadedOnce.current) {
+      setIsRefreshing(true);
+    } else {
+      setLoading(true);
+    }
+    setError(null);
+    try {
+      const result = await fetchData();
+      setData(result);
+      hasLoadedOnce.current = true;
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err));
+    }
+    setLoading(false);
+    setIsRefreshing(false);
+  }, [fetchData]);
+  useEffect4(() => {
+    load();
+  }, [load, refreshCount, manualRefreshCount]);
+  useInput3((input, key) => {
+    if (input === "q" || key.escape) {
+      exit();
+      return;
+    }
+    if (input === "r" && !loading) {
+      triggerManualRefresh();
+      setManualRefreshCount((c) => c + 1);
+    }
+    if (key.leftArrow || input === "1") {
+      setActiveTab(0);
+    }
+    if (key.rightArrow || input === "2") {
+      setActiveTab(1);
+    }
+  });
+  if (error && !data) {
+    return /* @__PURE__ */ jsxs7(
+      Box7,
+      {
+        flexDirection: "column",
+        paddingLeft: 1,
+        paddingTop: 1,
+        paddingBottom: 1,
+        children: [
+          /* @__PURE__ */ jsxs7(Text7, { color: "red", children: [
+            "Error: ",
+            error
+          ] }),
+          /* @__PURE__ */ jsx10(Box7, { marginTop: 1, children: /* @__PURE__ */ jsx10(Text7, { dimColor: true, children: "Press q to exit" }) })
+        ]
+      }
+    );
+  }
+  if (loading && !data) {
+    return /* @__PURE__ */ jsx10(Box7, { paddingLeft: 1, paddingTop: 1, children: /* @__PURE__ */ jsxs7(Text7, { children: [
+      /* @__PURE__ */ jsx10(Spinner3, { type: "dots" }),
+      " Loading profile\u2026"
+    ] }) });
+  }
+  if (!data) return null;
+  const hints = [
+    "\u2190 \u2192 switch tab",
+    autoRefresh ? `r refresh (${secondsUntilRefresh}s)` : "r refresh"
+  ];
+  hints.push("q quit");
+  const footer = hints.join("  \xB7  ");
+  const rankedPosts = data.posts.map((p, i) => ({ ...p, rank: i + 1 }));
+  return /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", children: [
+    isRefreshing && /* @__PURE__ */ jsx10(Box7, { paddingLeft: 1, children: /* @__PURE__ */ jsxs7(Text7, { dimColor: true, children: [
+      /* @__PURE__ */ jsx10(Spinner3, { type: "dots" }),
+      " Refreshing\u2026"
+    ] }) }),
+    /* @__PURE__ */ jsxs7(Box7, { paddingLeft: 1, paddingTop: 1, gap: 2, children: [
+      TAB_NAMES.map((name, i) => /* @__PURE__ */ jsx10(Text7, { bold: activeTab === i, dimColor: activeTab !== i, children: activeTab === i ? `[${name}]` : name }, name)),
+      /* @__PURE__ */ jsxs7(Text7, { dimColor: true, children: [
+        " ",
+        identifier
+      ] })
+    ] }),
+    activeTab === 0 ? rankedPosts.length === 0 ? /* @__PURE__ */ jsx10(
+      Box7,
+      {
+        flexDirection: "column",
+        paddingLeft: 1,
+        paddingTop: 1,
+        paddingBottom: 1,
+        children: /* @__PURE__ */ jsx10(Text7, { children: "No posts found for this profile." })
+      }
+    ) : /* @__PURE__ */ jsx10(
+      Table,
+      {
+        columns: postColumns,
+        data: rankedPosts,
+        title: "Posts",
+        subtitle: `${rankedPosts.length} of ${data.postsCount}`
+      }
+    ) : data.holdings.length === 0 ? /* @__PURE__ */ jsx10(
+      Box7,
+      {
+        flexDirection: "column",
+        paddingLeft: 1,
+        paddingTop: 1,
+        paddingBottom: 1,
+        children: /* @__PURE__ */ jsx10(Text7, { children: "No holdings found for this profile." })
+      }
+    ) : /* @__PURE__ */ jsx10(
+      Table,
+      {
+        columns: balanceColumns,
+        data: data.holdings,
+        title: "Holdings",
+        subtitle: `${data.holdings.length} of ${data.holdingsCount}`
+      }
+    ),
+    /* @__PURE__ */ jsx10(Box7, { paddingLeft: 1, paddingBottom: 1, children: /* @__PURE__ */ jsx10(Text7, { dimColor: true, children: footer }) })
+  ] });
+};
+
+// src/commands/profile.tsx
+import { jsx as jsx11, jsxs as jsxs8 } from "react/jsx-runtime";
+var extractErrorMessage2 = (error) => {
+  if (typeof error === "object" && error !== null && "error" in error) {
+    return String(error.error);
+  }
+  return JSON.stringify(error);
+};
+var resolveApiKey = (json) => {
+  const apiKey = getApiKey();
+  if (!apiKey) {
     outputErrorAndExit(
       json,
-      `Transaction failed: ${err instanceof Error ? err.message : String(err)}`
+      "Not authenticated. Run 'zora auth configure' to set your API key."
     );
   }
-  txHash = receipt.transactionHash;
-  if (outputToken.trade.type === "erc20") {
+  setApiKey7(apiKey);
+};
+var formatPostJson = (post, rank) => ({
+  rank,
+  name: post.name,
+  symbol: post.symbol,
+  coinType: COIN_TYPE_DISPLAY[post.coinType] ?? post.coinType,
+  address: post.address,
+  marketCap: post.marketCap ?? null,
+  marketCapDelta24h: post.marketCapDelta24h ?? null,
+  volume24h: post.volume24h ?? null,
+  createdAt: post.createdAt ?? null
+});
+var formatHoldingJson = (balance) => {
+  const priceUsd = balance.coin?.tokenPrice?.priceInUsdc ? Number(balance.coin.tokenPrice.priceInUsdc) : null;
+  const usdValue = priceUsd !== null ? Number((parseRawBalance(balance.balance) * priceUsd).toFixed(6)) : null;
+  return {
+    rank: balance.rank,
+    name: balance.coin?.name ?? null,
+    symbol: balance.coin?.symbol ?? null,
+    coinType: balance.coin?.coinType ?? null,
+    address: balance.coin?.address ?? null,
+    balance: normalizeTokenAmount(balance.balance),
+    usdValue,
+    priceUsd,
+    marketCap: balance.coin?.marketCap ? Number(balance.coin.marketCap) : null
+  };
+};
+var fetchProfileData = async (identifier) => {
+  const [postsResult, holdingsResult] = await Promise.allSettled([
+    getProfileCoins({ identifier, count: 20 }),
+    getProfileBalances2({ identifier, count: 20, sortOption: "USD_VALUE" })
+  ]);
+  if (postsResult.status === "rejected") {
+    throw new Error(
+      postsResult.reason instanceof Error ? postsResult.reason.message : String(postsResult.reason)
+    );
+  }
+  if (holdingsResult.status === "rejected") {
+    throw new Error(
+      holdingsResult.reason instanceof Error ? holdingsResult.reason.message : String(holdingsResult.reason)
+    );
+  }
+  if (postsResult.value.error) {
+    throw new Error(
+      `API error (posts): ${extractErrorMessage2(postsResult.value.error)}`
+    );
+  }
+  if (holdingsResult.value.error) {
+    throw new Error(
+      `API error (holdings): ${extractErrorMessage2(holdingsResult.value.error)}`
+    );
+  }
+  const postEdges = postsResult.value.data?.profile?.createdCoins?.edges ?? [];
+  const posts = postEdges.map((e) => e.node);
+  const postsCount = postsResult.value.data?.profile?.createdCoins?.count ?? posts.length;
+  const holdingEdges = holdingsResult.value.data?.profile?.coinBalances?.edges ?? [];
+  const holdings = holdingEdges.map(
+    (e, i) => ({
+      ...e.node,
+      rank: i + 1
+    })
+  );
+  const holdingsCount = holdingsResult.value.data?.profile?.coinBalances?.count ?? holdings.length;
+  return { posts, postsCount, holdings, holdingsCount };
+};
+var profileCommand = new Command8("profile").description("View profile activity (posts and holdings)").argument(
+  "[identifier]",
+  "Wallet address or profile handle (defaults to your wallet)"
+).option("--live", "Interactive live-updating display (default)").option("--static", "Static snapshot").option(
+  "--refresh <seconds>",
+  "Auto-refresh interval in seconds, requires --live (min 5)",
+  "30"
+).action(async function(identifierArg) {
+  const output = getOutputMode(this, "live");
+  const json = output === "json";
+  resolveApiKey(json);
+  const { live, intervalSeconds } = getLiveConfig(this, output);
+  let identifier = identifierArg;
+  if (!identifier) {
+    const envKey = process.env.ZORA_PRIVATE_KEY;
+    const key = envKey || getPrivateKey();
+    if (!key) {
+      outputErrorAndExit(
+        json,
+        "No identifier provided and no wallet configured.",
+        "Pass an address or handle, or run 'zora setup' first."
+      );
+    }
     try {
-      const result = getReceivedAmountFromReceipt({
-        receipt,
-        tokenAddress: outputToken.trade.address,
-        recipient: account.address
-      });
-      receivedAmountOut = result.amount;
-      swapLogIndex = result.logIndex;
-      receivedSource = "receipt";
+      identifier = privateKeyToAccount3(normalizeKey(key)).address;
     } catch {
+      outputErrorAndExit(
+        json,
+        "Invalid wallet key. Run 'zora setup --force' to replace it."
+      );
     }
   }
-  printSellResult(output, {
-    coinName,
-    coinSymbol,
-    address: coinAddress,
-    amountIn,
-    coinDecimals,
-    soldFormatted,
-    receivedAmountOut,
-    outputSymbol: outputToken.symbol,
-    outputDecimals: outputToken.decimals,
-    receivedSource,
-    txHash
-  });
-  track("cli_sell", {
-    action: "trade",
-    coin_address: coinAddress,
-    coin_name: coinName,
-    coin_symbol: coinSymbol,
-    amount_mode: amountMode,
-    swap_amount_usd: swapAmountUsd,
-    valueUsd: swapAmountUsd,
-    swapCoinType,
-    transactionHash: txHash,
-    logIndex: swapLogIndex,
-    output_asset: outputAsset,
-    slippage: slippagePct,
-    output_format: output,
-    success: true,
-    tx_hash: txHash
-  });
+  if (json) {
+    const data = await fetchProfileData(identifier).catch(
+      (err) => outputErrorAndExit(
+        json,
+        `Request failed: ${err instanceof Error ? err.message : String(err)}`
+      )
+    );
+    outputData(json, {
+      json: {
+        posts: data.posts.map((p, i) => formatPostJson(p, i + 1)),
+        holdings: data.holdings.map(formatHoldingJson)
+      },
+      render: () => {
+      }
+    });
+    track("cli_profile", {
+      identifier,
+      output_format: "json",
+      posts_count: data.postsCount,
+      holdings_count: data.holdingsCount
+    });
+  } else if (live) {
+    const fetchData = () => fetchProfileData(identifier);
+    await renderLive(
+      /* @__PURE__ */ jsx11(
+        ProfileView,
+        {
+          fetchData,
+          identifier,
+          autoRefresh: live,
+          intervalSeconds
+        }
+      )
+    );
+    track("cli_profile", {
+      identifier,
+      output_format: "live",
+      live,
+      interval: intervalSeconds
+    });
+  } else {
+    const data = await fetchProfileData(identifier).catch(
+      (err) => outputErrorAndExit(
+        json,
+        `Request failed: ${err instanceof Error ? err.message : String(err)}`
+      )
+    );
+    const rankedPosts = data.posts.map((p, i) => ({ ...p, rank: i + 1 }));
+    renderOnce(
+      /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", children: [
+        rankedPosts.length === 0 ? /* @__PURE__ */ jsx11(
+          Box8,
+          {
+            flexDirection: "column",
+            paddingLeft: 1,
+            paddingTop: 1,
+            paddingBottom: 1,
+            children: /* @__PURE__ */ jsx11(Box8, { children: /* @__PURE__ */ jsx11(Text8, { children: "No posts found for this profile." }) })
+          }
+        ) : /* @__PURE__ */ jsx11(
+          Table,
+          {
+            columns: postColumns,
+            data: rankedPosts,
+            title: "Posts",
+            subtitle: `${rankedPosts.length} of ${data.postsCount}`
+          }
+        ),
+        data.holdings.length === 0 ? /* @__PURE__ */ jsx11(
+          Box8,
+          {
+            flexDirection: "column",
+            paddingLeft: 1,
+            paddingTop: 1,
+            paddingBottom: 1,
+            children: /* @__PURE__ */ jsx11(Box8, { children: /* @__PURE__ */ jsx11(Text8, { children: "No holdings found for this profile." }) })
+          }
+        ) : /* @__PURE__ */ jsx11(
+          Table,
+          {
+            columns: balanceColumns,
+            data: data.holdings,
+            title: "Holdings",
+            subtitle: `${data.holdings.length} of ${data.holdingsCount}`
+          }
+        )
+      ] })
+    );
+    track("cli_profile", {
+      identifier,
+      output_format: "static",
+      posts_count: data.postsCount,
+      holdings_count: data.holdingsCount
+    });
+  }
 });
 
 // src/commands/send.ts
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 import confirm4 from "@inquirer/confirm";
 import {
   erc20Abi as erc20Abi4,
-  formatUnits as formatUnits5,
+  formatUnits as formatUnits6,
   isAddress as isAddress3,
   parseUnits as parseUnits3
 } from "viem";
-import { setApiKey as setApiKey7 } from "@zoralabs/coins-sdk";
+import { setApiKey as setApiKey8 } from "@zoralabs/coins-sdk";
 var SEND_AMOUNT_CHECKS = {
   amount: (opts) => opts.amount !== void 0,
   percent: (opts) => opts.percent !== void 0,
   all: (opts) => opts.all === true
 };
-var VALID_TYPES3 = ["creator-coin", "post", "trend"];
+var KNOWN_TOKEN_NAMES = /* @__PURE__ */ new Set(["eth", "usdc", "zora"]);
 function printSendPreview(info) {
   const usdStr = info.amountUsd != null ? ` ($${info.amountUsd.toFixed(2)})` : "";
   console.log(`
@@ -3215,7 +4106,7 @@ function printSendResult(json, info) {
       coin: info.symbol,
       address: info.address,
       sent: {
-        amount: formatUnits5(info.amount, info.decimals),
+        amount: formatUnits6(info.amount, info.decimals),
         raw: info.amount.toString(),
         symbol: info.symbol,
         amountUsd: info.amountUsd
@@ -3236,34 +4127,35 @@ function printSendResult(json, info) {
   console.log(`   Tx           ${info.txHash}
 `);
 }
-var sendCommand = new Command8("send").description("Send coins or ETH to an address").argument("<identifier>", "Coin address, name, or token (eth, usdc, zora)").requiredOption("--to <address>", "Recipient address (0x...)").option("--type <type>", "Coin type: creator-coin, post, trend").option("--amount <value>", "Send specific amount").option("--percent <value>", "Send percentage of balance (1-100)").option("--all", "Send entire balance").option("--yes", "Skip confirmation").action(async function(identifier, opts) {
+var sendCommand = new Command9("send").description("Send coins or ETH to an address").argument(
+  "[typeOrId]",
+  "Token (eth, usdc, zora), type prefix (creator-coin, trend), or coin address/name"
+).argument("[identifier]", "Coin name (when type prefix is given)").option("--to <address>", "Recipient address (0x...)").option("--amount <value>", "Send specific amount").option("--percent <value>", "Send percentage of balance (1-100)").option("--all", "Send entire balance").option("--yes", "Skip confirmation").action(async function(firstArg, secondArg, opts) {
   const json = getJson(this);
-  if (!isAddress3(opts.to)) {
+  if (!opts.to) {
     outputErrorAndExit(
       json,
-      `Invalid recipient address: ${opts.to}`,
-      "Must be a valid 0x address."
+      "Missing --to flag.",
+      "Usage: zora send <identifier> --to <address>"
     );
   }
-  const recipient = opts.to;
-  if (opts.type !== void 0 && !VALID_TYPES3.includes(opts.type)) {
+  if (!isAddress3(opts.to)) {
     outputErrorAndExit(
       json,
-      `Invalid --type value: ${opts.type}.`,
-      `Supported: ${VALID_TYPES3.join(", ")}`
+      `Invalid recipient address: ${opts.to}`,
+      "Must be a valid 0x address."
     );
   }
+  const recipient = opts.to;
   const amountMode = getAmountMode(
     json,
     opts,
     SEND_AMOUNT_CHECKS,
     "--amount, --percent, or --all"
   );
-  const isEth = identifier.toLowerCase() === "eth";
+  const isKnownToken = KNOWN_TOKEN_NAMES.has(firstArg.toLowerCase());
+  const isEth = firstArg.toLowerCase() === "eth";
   if (isEth) {
-    if (opts.type) {
-      outputErrorAndExit(json, "--type is not valid when sending ETH.");
-    }
     const account = resolveAccount(json);
     const { publicClient, walletClient } = createClients(account);
     const balance = await publicClient.getBalance({
@@ -3301,14 +4193,14 @@ var sendCommand = new Command8("send").description("Send coins or ETH to an addr
       if (amount + GAS_RESERVE > balance) {
         outputErrorAndExit(
           json,
-          `Insufficient balance. Have ${formatEthDisplay(balance)} ETH (need to reserve ~${formatEthDisplay(GAS_RESERVE)} ETH for gas).`
+          `Insufficient balance. Have ${formatAmountDisplay(balance, 18)} ETH (need to reserve ~${formatAmountDisplay(GAS_RESERVE, 18)} ETH for gas).`
         );
       }
     } else {
       if (balance <= GAS_RESERVE) {
         outputErrorAndExit(
           json,
-          `Balance too low (${formatEthDisplay(balance)} ETH). Need >${formatEthDisplay(GAS_RESERVE)} ETH for gas.`
+          `Balance too low (${formatAmountDisplay(balance, 18)} ETH). Need >${formatAmountDisplay(GAS_RESERVE, 18)} ETH for gas.`
         );
       }
       const spendable = balance - GAS_RESERVE;
@@ -3331,12 +4223,12 @@ var sendCommand = new Command8("send").description("Send coins or ETH to an addr
         }
       }
     }
-    const amountFormatted = formatEthDisplay(amount);
+    const amountFormatted = formatAmountDisplay(amount, 18);
     let amountUsd = null;
     const ethPriceUsd = await fetchTokenPriceUsd(WETH_ADDRESS);
     if (ethPriceUsd != null) {
       amountUsd = Number(
-        (Number(formatUnits5(amount, 18)) * ethPriceUsd).toFixed(2)
+        (Number(formatUnits6(amount, 18)) * ethPriceUsd).toFixed(2)
       );
     }
     if (!opts.yes) {
@@ -3362,7 +4254,7 @@ var sendCommand = new Command8("send").description("Send coins or ETH to an addr
     } catch (err) {
       track("cli_send", {
         asset: "eth",
-        output_format: json ? "json" : "table",
+        output_format: json ? "json" : "static",
         success: false,
         error_type: err instanceof Error ? err.constructor.name : "unknown"
       });
@@ -3391,19 +4283,13 @@ var sendCommand = new Command8("send").description("Send coins or ETH to an addr
       amount_mode: amountMode,
       amount_usd: amountUsd,
       transactionHash: txHash,
-      output_format: json ? "json" : "table",
+      output_format: json ? "json" : "static",
       success: true,
       tx_hash: txHash
     });
   } else {
-    const knownTokenKey = identifier.toLowerCase();
-    const knownToken = knownTokenKey !== "eth" && knownTokenKey in BASE_TRADE_TOKENS ? BASE_TRADE_TOKENS[knownTokenKey] : void 0;
-    if (knownToken && opts.type) {
-      outputErrorAndExit(
-        json,
-        `--type is not valid when sending ${knownToken.symbol}.`
-      );
-    }
+    const knownTokenKey = firstArg.toLowerCase();
+    const knownToken = isKnownToken && knownTokenKey !== "eth" && knownTokenKey in BASE_TRADE_TOKENS ? BASE_TRADE_TOKENS[knownTokenKey] : void 0;
     let tokenAddress;
     let tokenName;
     if (knownToken) {
@@ -3413,23 +4299,62 @@ var sendCommand = new Command8("send").description("Send coins or ETH to an addr
     } else {
       const apiKey = getApiKey();
       if (apiKey) {
-        setApiKey7(apiKey);
+        setApiKey8(apiKey);
       }
-      const ref = parseCoinRef(identifier, opts.type);
-      let result;
+      let parsed;
       try {
-        result = await resolveCoin(ref);
+        parsed = parsePositionalCoinArgs(firstArg, secondArg);
       } catch (err) {
-        outputErrorAndExit(
-          json,
-          `Request failed: ${err instanceof Error ? err.message : String(err)}`
-        );
+        if (err instanceof CoinArgError) {
+          outputErrorAndExit(json, err.message, err.suggestion);
+        }
+        throw err;
       }
-      if (result.kind === "not-found") {
-        outputErrorAndExit(json, result.message, result.suggestion);
+      if (parsed.kind === "ambiguous-name") {
+        let ambResult;
+        try {
+          ambResult = await resolveAmbiguousName(parsed.name);
+        } catch (err) {
+          outputErrorAndExit(
+            json,
+            `Request failed: ${err instanceof Error ? err.message : String(err)}`
+          );
+          return;
+        }
+        if (ambResult.kind === "not-found") {
+          outputErrorAndExit(json, ambResult.message);
+          return;
+        }
+        if (ambResult.kind === "ambiguous") {
+          const { message, suggestion } = formatAmbiguousError(
+            parsed.name,
+            ambResult.creator,
+            ambResult.trend,
+            "send"
+          );
+          outputErrorAndExit(json, message, suggestion);
+          return;
+        }
+        tokenAddress = ambResult.coin.address;
+        tokenName = ambResult.coin.name;
+      } else {
+        const ref = coinArgsToRef(parsed);
+        try {
+          const result = await resolveCoin(ref);
+          if (result.kind === "not-found") {
+            outputErrorAndExit(json, result.message, result.suggestion);
+            return;
+          }
+          tokenAddress = result.coin.address;
+          tokenName = result.coin.name;
+        } catch (err) {
+          outputErrorAndExit(
+            json,
+            `Request failed: ${err instanceof Error ? err.message : String(err)}`
+          );
+          return;
+        }
       }
-      tokenAddress = result.coin.address;
-      tokenName = result.coin.name;
     }
     const account = resolveAccount(json);
     const { publicClient, walletClient } = createClients(account);
@@ -3527,7 +4452,7 @@ var sendCommand = new Command8("send").description("Send coins or ETH to an addr
     const priceUsd = knownToken?.fixedPriceUsd ?? await fetchTokenPriceUsd(priceAddress);
     if (priceUsd != null) {
       amountUsd = Number(
-        (Number(formatUnits5(amount, decimals)) * priceUsd).toFixed(2)
+        (Number(formatUnits6(amount, decimals)) * priceUsd).toFixed(2)
       );
     }
     if (!opts.yes) {
@@ -3558,7 +4483,7 @@ var sendCommand = new Command8("send").description("Send coins or ETH to an addr
         coin_address: tokenAddress,
         coin_name: tokenName,
         coin_symbol: symbol,
-        output_format: json ? "json" : "table",
+        output_format: json ? "json" : "static",
         success: false,
         error_type: err instanceof Error ? err.constructor.name : "unknown"
       });
@@ -3588,7 +4513,7 @@ var sendCommand = new Command8("send").description("Send coins or ETH to an addr
       amount_mode: amountMode,
       amount_usd: amountUsd,
       transactionHash: txHash,
-      output_format: json ? "json" : "table",
+      output_format: json ? "json" : "static",
       success: true,
       tx_hash: txHash
     });
@@ -3596,8 +4521,8 @@ var sendCommand = new Command8("send").description("Send coins or ETH to an addr
 });
 
 // src/commands/setup.ts
-import { Command as Command9 } from "commander";
-import { generatePrivateKey, privateKeyToAccount as privateKeyToAccount3 } from "viem/accounts";
+import { Command as Command10 } from "commander";
+import { generatePrivateKey, privateKeyToAccount as privateKeyToAccount4 } from "viem/accounts";
 
 // src/lib/strings.ts
 var DEPOSIT_INSTRUCTIONS = "Deposit ETH or USDC to this address on Base to start trading.\n\n  You can do this from:\n  - Coinbase \u2014 withdraw directly to Base\n  - Another wallet (MetaMask, Rainbow, etc.) \u2014 send on Base network\n  - Bridge from other chains \u2014 use https://superbridge.app/base";
@@ -3610,7 +4535,7 @@ var BACKUP_WARNING = "Back up this file \u2014 it's the only copy of your key.";
 var isValidPrivateKey = (key) => /^(0x)?[0-9a-fA-F]{64}$/.test(key);
 var toAccount = (json, key, errorPrefix) => {
   try {
-    return privateKeyToAccount3(normalizeKey(key));
+    return privateKeyToAccount4(normalizeKey(key));
   } catch {
     outputErrorAndExit(
       json,
@@ -3618,7 +4543,7 @@ var toAccount = (json, key, errorPrefix) => {
     );
   }
 };
-var setupCommand = new Command9("setup").description("Set up your Zora wallet").option("--create", "Create a new wallet without prompting").option("--force", "Overwrite existing wallet without prompting").option("--yes", "Skip interactive prompt and execute directly").action(async function(options) {
+var setupCommand = new Command10("setup").description("Set up your Zora wallet").option("--create", "Create a new wallet without prompting").option("--force", "Overwrite existing wallet without prompting").option("--yes", "Skip interactive prompt and execute directly").action(async function(options) {
   const json = getJson(this);
   const nonInteractive = getYes(this);
   const envKey = process.env.ZORA_PRIVATE_KEY;
@@ -3633,7 +4558,7 @@ var setupCommand = new Command9("setup").description("Set up your Zora wallet").
     const account = toAccount(json, envKey, "ZORA_PRIVATE_KEY");
     outputData(json, {
       json: { source: "env", address: account.address },
-      table: () => {
+      render: () => {
         console.log("  Using wallet from ZORA_PRIVATE_KEY.\n");
         console.log(`  Address: ${account.address}
 `);
@@ -3654,14 +4579,14 @@ var setupCommand = new Command9("setup").description("Set up your Zora wallet").
     } catch (err) {
       outputErrorAndExit(
         json,
-        `\u2717 Could not read wallet: ${err.message}`,
+        `\u2717 Could not read wallet: ${formatError(err)}`,
         "Run 'zora setup --force' to overwrite it."
       );
     }
   }
   if (existing) {
     const account = toAccount(json, existing, "Stored private key");
-    const truncated = `${account.address.slice(0, 6)}\u2026${account.address.slice(-4)}`;
+    const truncated = truncateAddress(account.address);
     console.log(`  Wallet already configured: ${truncated}
 `);
     if (!options.force) {
@@ -3723,7 +4648,7 @@ var setupCommand = new Command9("setup").description("Set up your Zora wallet").
         address: account.address,
         path: getWalletPath()
       },
-      table: () => {
+      render: () => {
         console.log("\n\u2713 Wallet imported\n");
         console.log(`  Address:     ${account.address}`);
         console.log(`  Private key: saved to ${getWalletPath()}
@@ -3758,7 +4683,7 @@ var setupCommand = new Command9("setup").description("Set up your Zora wallet").
         address: account.address,
         path: getWalletPath()
       },
-      table: () => {
+      render: () => {
         console.log("\n\u2713 Wallet created\n");
         console.log(`  Address:     ${account.address}`);
         console.log(`  Private key: saved to ${getWalletPath()}
@@ -3777,8 +4702,8 @@ var setupCommand = new Command9("setup").description("Set up your Zora wallet").
 });
 
 // src/commands/wallet.ts
-import { Command as Command10 } from "commander";
-import { privateKeyToAccount as privateKeyToAccount4 } from "viem/accounts";
+import { Command as Command11 } from "commander";
+import { privateKeyToAccount as privateKeyToAccount5 } from "viem/accounts";
 var resolvePrivateKey = () => {
   const envKey = process.env.ZORA_PRIVATE_KEY;
   if (envKey) {
@@ -3790,7 +4715,7 @@ var resolvePrivateKey = () => {
   }
   return void 0;
 };
-var walletCommand = new Command10("wallet").description(
+var walletCommand = new Command11("wallet").description(
   "Manage your Zora wallet"
 );
 walletCommand.command("info").description("Show wallet address and storage location").action(function() {
@@ -3801,7 +4726,7 @@ walletCommand.command("info").description("Show wallet address and storage locat
   }
   let account;
   try {
-    account = privateKeyToAccount4(normalizeKey(resolved.key));
+    account = privateKeyToAccount5(normalizeKey(resolved.key));
   } catch {
     const msg = resolved.source === "env" ? "ZORA_PRIVATE_KEY is not a valid private key." : "Stored private key is invalid.";
     const suggestion = resolved.source === "env" ? void 0 : "Run 'zora setup --force' to replace it.";
@@ -3810,7 +4735,7 @@ walletCommand.command("info").description("Show wallet address and storage locat
   const source = resolved.source === "env" ? "env (ZORA_PRIVATE_KEY)" : getWalletPath();
   outputData(json, {
     json: { address: account.address, source },
-    table: () => {
+    render: () => {
       console.log(`  Address: ${account.address}`);
       console.log(`  Source:  ${source}`);
     }
@@ -3849,8 +4774,103 @@ walletCommand.command("export").description("Print the raw private key to stdout
   });
 });
 
+// src/components/StyledHelp.tsx
+import { Text as Text10, Box as Box10 } from "ink";
+
+// src/components/KeyValueTable.tsx
+import { Text as Text9, Box as Box9 } from "ink";
+import { jsx as jsx12, jsxs as jsxs9 } from "react/jsx-runtime";
+function KeyValueTable({
+  rows,
+  labelWidth
+}) {
+  const pad = labelWidth ?? Math.max(0, ...rows.map((r) => r.label.length)) + 2;
+  return /* @__PURE__ */ jsx12(Box9, { flexDirection: "column", children: rows.map((row, i) => /* @__PURE__ */ jsxs9(Text9, { children: [
+    /* @__PURE__ */ jsx12(Text9, { bold: true, children: row.label.padEnd(pad) }),
+    /* @__PURE__ */ jsx12(Text9, { dimColor: true, children: row.value })
+  ] }, i)) });
+}
+
+// src/lib/parse-help.ts
+var DEFAULT_DESC_COLUMN = 38;
+var TWO_COLUMN_REGEX = /^(.+\S)([ \t]{2,})(\S.*)/m;
+function getDescriptionColumnOffset(sections) {
+  for (const section of sections) {
+    const match = section.content.match(TWO_COLUMN_REGEX);
+    if (match) {
+      return match[1].length + match[2].length;
+    }
+  }
+  return DEFAULT_DESC_COLUMN;
+}
+function parseHelpSections(text) {
+  const sections = [];
+  let currentTitle = "";
+  let currentLines = [];
+  for (const line of text.split("\n")) {
+    const match = line.match(/^([A-Z]\w+):(.*)/);
+    if (match) {
+      if (currentTitle) {
+        const content = currentLines.join("\n").replace(/^\n+|\n+$/g, "");
+        sections.push({ title: currentTitle, content });
+      }
+      currentTitle = match[1];
+      currentLines = match[2].trim() ? [match[2].trim()] : [];
+    } else if (currentTitle) {
+      currentLines.push(line.startsWith("  ") ? line.slice(2) : line);
+    }
+  }
+  if (currentTitle) {
+    const content = currentLines.join("\n").replace(/^\n+|\n+$/g, "");
+    sections.push({ title: currentTitle, content });
+  }
+  return sections.filter((s) => s.content);
+}
+
+// src/components/StyledHelp.tsx
+import { jsx as jsx13, jsxs as jsxs10 } from "react/jsx-runtime";
+function StyledHelp({
+  sections,
+  header
+}) {
+  const descriptionColumnOffset = getDescriptionColumnOffset(sections);
+  return /* @__PURE__ */ jsxs10(Box10, { flexDirection: "column", gap: 1, children: [
+    header,
+    sections.map((section, i) => {
+      const hasTwoColumns = TWO_COLUMN_REGEX.test(section.content);
+      const rows = hasTwoColumns ? section.content.split("\n").map((line) => {
+        const m = line.match(TWO_COLUMN_REGEX);
+        if (m)
+          return {
+            label: m[1],
+            value: m[3][0].toUpperCase() + m[3].slice(1)
+          };
+        return { label: "", value: line.trimStart() };
+      }) : null;
+      return /* @__PURE__ */ jsxs10(
+        Box10,
+        {
+          flexDirection: "column",
+          borderStyle: "single",
+          borderDimColor: true,
+          paddingX: 1,
+          paddingY: 1,
+          children: [
+            /* @__PURE__ */ jsx13(Text10, { bold: true, children: section.title }),
+            rows ? /* @__PURE__ */ jsx13(KeyValueTable, { rows, labelWidth: descriptionColumnOffset }) : /* @__PURE__ */ jsx13(Text10, { children: section.content })
+          ]
+        },
+        i
+      );
+    })
+  ] });
+}
+
+// src/components/StyledHelpHeader.tsx
+import { Text as Text12, Box as Box12 } from "ink";
+
 // src/components/Zorb.tsx
-import { Text as Text7, Box as Box7 } from "ink";
+import { Text as Text11, Box as Box11 } from "ink";
 
 // src/lib/zorb-pixels.ts
 function supportsTruecolor() {
@@ -3995,7 +5015,7 @@ function generateZorbPixels(size) {
 }
 
 // src/components/Zorb.tsx
-import { jsx as jsx10, jsxs as jsxs7 } from "react/jsx-runtime";
+import { jsx as jsx14, jsxs as jsxs11 } from "react/jsx-runtime";
 var LOWER_HALF_BLOCK = "\u2584";
 var UPPER_HALF_BLOCK = "\u2580";
 function rgbString([r, g, b]) {
@@ -4018,19 +5038,19 @@ function Zorb({ size = 20 }) {
       const topIsBlack = isBlack(top);
       const bottomIsBlack = isBlack(bottom);
       if (topIsBlack && bottomIsBlack) {
-        cells.push(/* @__PURE__ */ jsx10(Text7, { children: " " }, x));
+        cells.push(/* @__PURE__ */ jsx14(Text11, { children: " " }, x));
       } else if (topIsBlack) {
         cells.push(
-          /* @__PURE__ */ jsx10(Text7, { color: rgbString(bottom), children: LOWER_HALF_BLOCK }, x)
+          /* @__PURE__ */ jsx14(Text11, { color: rgbString(bottom), children: LOWER_HALF_BLOCK }, x)
         );
       } else if (bottomIsBlack) {
         cells.push(
-          /* @__PURE__ */ jsx10(Text7, { color: rgbString(top), children: UPPER_HALF_BLOCK }, x)
+          /* @__PURE__ */ jsx14(Text11, { color: rgbString(top), children: UPPER_HALF_BLOCK }, x)
         );
       } else {
         cells.push(
-          /* @__PURE__ */ jsx10(
-            Text7,
+          /* @__PURE__ */ jsx14(
+            Text11,
             {
               backgroundColor: rgbString(top),
               color: rgbString(bottom),
@@ -4041,50 +5061,96 @@ function Zorb({ size = 20 }) {
         );
       }
     }
-    rows.push(/* @__PURE__ */ jsx10(Text7, { children: cells }, y));
+    rows.push(/* @__PURE__ */ jsx14(Text11, { children: cells }, y));
   }
-  return /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsx10(Text7, { children: " " }),
+  return /* @__PURE__ */ jsxs11(Box11, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx14(Text11, { children: " " }),
     rows,
-    /* @__PURE__ */ jsx10(Text7, { children: " " })
+    /* @__PURE__ */ jsx14(Text11, { children: " " })
   ] });
 }
 
+// src/components/StyledHelpHeader.tsx
+import { jsx as jsx15, jsxs as jsxs12 } from "react/jsx-runtime";
+function StyledHelpHeader({
+  sections
+}) {
+  const descriptionColumnOffset = getDescriptionColumnOffset(sections);
+  return /* @__PURE__ */ jsxs12(
+    Box12,
+    {
+      flexDirection: "row",
+      borderStyle: "single",
+      borderDimColor: true,
+      paddingX: 1,
+      paddingY: 1,
+      children: [
+        /* @__PURE__ */ jsx15(Box12, { flexShrink: 0, width: descriptionColumnOffset, children: /* @__PURE__ */ jsx15(Zorb, { size: 20 }) }),
+        /* @__PURE__ */ jsx15(Box12, { flexDirection: "column", flexGrow: 1, justifyContent: "center", children: /* @__PURE__ */ jsx15(Text12, { bold: true, children: "Zora CLI" }) })
+      ]
+    }
+  );
+}
+
 // src/index.tsx
-import { jsx as jsx11 } from "react/jsx-runtime";
+import { jsx as jsx16 } from "react/jsx-runtime";
 if (process.env.ZORA_API_TARGET) {
   setApiBaseUrl(process.env.ZORA_API_TARGET);
 }
-var version = true ? "0.2.4" : JSON.parse(
+var version = true ? "0.3.1" : JSON.parse(
   readFileSync2(new URL("../package.json", import.meta.url), "utf-8")
 ).version;
+function styledHelpWriteOut(showHeader) {
+  return (str) => {
+    if (supportsTruecolor()) {
+      const sections = parseHelpSections(str);
+      if (sections.length > 0) {
+        const header = showHeader ? /* @__PURE__ */ jsx16(StyledHelpHeader, { sections }) : void 0;
+        renderOnce(/* @__PURE__ */ jsx16(StyledHelp, { sections, header }));
+        return;
+      }
+    }
+    process.stdout.write(str);
+  };
+}
 var buildProgram = () => {
-  const program2 = new Command11().name("zora").description("Zora CLI").version(version).option(
-    "--output <format>",
-    "Output format: table, json, live (default varies by command)"
-  ).option(
-    "--interval <seconds>",
-    "Auto-refresh interval in seconds (min 5)",
-    "30"
-  );
+  const program2 = new Command12().name("zora").description("A developer CLI for the Zora platform").version(version).option("--json", "Output as JSON (for scripts and automation)", false);
+  const helpWidth = (process.stdout.columns || 80) - 4;
+  program2.configureHelp({ helpWidth });
+  program2.configureOutput({ writeOut: styledHelpWriteOut(true) });
+  program2.action(() => {
+    program2.outputHelp();
+  });
   program2.addCommand(authCommand);
   program2.addCommand(balanceCommand);
   program2.addCommand(buyCommand);
   program2.addCommand(exploreCommand);
   program2.addCommand(getCommand);
   program2.addCommand(priceHistoryCommand);
+  program2.addCommand(profileCommand);
   program2.addCommand(setupCommand);
   program2.addCommand(walletCommand);
   program2.addCommand(sellCommand);
   program2.addCommand(sendCommand);
+  const applyToSubcommands = (parent) => {
+    for (const cmd of parent.commands) {
+      cmd.configureHelp({ helpWidth });
+      cmd.configureOutput({ writeOut: styledHelpWriteOut(false) });
+      applyToSubcommands(cmd);
+    }
+  };
+  applyToSubcommands(program2);
+  program2.hook("preAction", (_thisCommand, actionCommand) => {
+    const expected = actionCommand.registeredArguments.length;
+    if (expected > 0 && actionCommand.args.length === 0) {
+      actionCommand.outputHelp();
+      process.exit(1);
+    }
+  });
   return program2;
 };
 var program = buildProgram();
 if (!process.env.VITEST) {
-  const showingHelp = process.argv.length <= 2 || process.argv.includes("--help") || process.argv.includes("-h");
-  if (showingHelp && !process.argv.includes("--output") && supportsTruecolor()) {
-    renderOnce(/* @__PURE__ */ jsx11(Zorb, { size: 20 }));
-  }
   console.warn(
     "\x1B[33m\u26A0 Beta:\x1B[0m This CLI is in beta and should be used with caution."
   );