@kashdao/cli 0.1.0

package/dist/trade-IIZSEXEI.js

@@ -0,0 +1,586 @@
+#!/usr/bin/env node
+import {
+  capitalize,
+  colorStatus,
+  createTable,
+  formatDate,
+  formatUsdcDecimal,
+  shortId
+} from "./chunk-BRK7KJ4O.js";
+import {
+  buildClient
+} from "./chunk-QJMF73M5.js";
+import "./chunk-KMBMQIZ7.js";
+import {
+  parseOutcomeIndex,
+  validateUsdcDecimalShape
+} from "./chunk-YHCG2SUC.js";
+import "./chunk-BN2CUM42.js";
+import {
+  parsePositiveInt,
+  readGlobals
+} from "./chunk-LBIRQHX5.js";
+import {
+  isQuiet,
+  log,
+  print,
+  printJson,
+  style,
+  writeNdjson
+} from "./chunk-VIADBYFY.js";
+import "./chunk-MIXOZU2S.js";
+import {
+  CliValidationError,
+  toCliError
+} from "./chunk-UZNSYATZ.js";
+
+// src/commands/trade/index.ts
+import { Command as Command6 } from "commander";
+
+// src/commands/trade/buy.ts
+import { Command } from "commander";
+
+// src/commands/trade/place.ts
+import ora from "ora";
+async function placeTrade({
+  marketId,
+  side,
+  options,
+  globals
+}) {
+  const json = globals.json;
+  const outcomeIndex = parseOutcomeIndex(options.outcome);
+  const amount = options.amount?.trim();
+  if (!amount) {
+    throw new CliValidationError(
+      "--amount is required.",
+      'Use a USDC decimal like "10" or "12.50".'
+    );
+  }
+  validateUsdcDecimalShape(amount, "amount");
+  const timeoutMs = options.timeout ? parsePositiveInt(options.timeout, "timeout") : 6e4;
+  const pollIntervalMs = options.pollInterval ? parsePositiveInt(options.pollInterval, "poll-interval") : 2e3;
+  let resolvedIdempotencyKey = options.idempotencyKey;
+  if (resolvedIdempotencyKey === void 0 && options.autoIdempotencyKey) {
+    resolvedIdempotencyKey = crypto.randomUUID();
+    if (!json) {
+      log.detail("Generated Idempotency-Key", resolvedIdempotencyKey);
+    }
+  }
+  if (options.dryRun === true) {
+    const wouldSend = {
+      marketId,
+      outcomeIndex,
+      amount,
+      side,
+      ...options.clientRequestId === void 0 ? {} : { clientRequestId: options.clientRequestId }
+    };
+    const envelope = {
+      wouldSend,
+      idempotencyKey: resolvedIdempotencyKey ?? null,
+      endpoint: { method: "POST", path: "/v1/trades" }
+    };
+    if (json) {
+      printJson(envelope);
+      return;
+    }
+    print("");
+    print(style.bold("Dry run \u2014 no request sent."));
+    print(`  ${style.dim("Endpoint   ")} POST /v1/trades`);
+    print(`  ${style.dim("Market     ")} ${marketId}`);
+    print(`  ${style.dim("Side       ")} ${side}`);
+    print(`  ${style.dim("Outcome    ")} ${String(outcomeIndex)}`);
+    print(`  ${style.dim("Amount     ")} ${amount} USDC`);
+    if (options.clientRequestId !== void 0) {
+      print(`  ${style.dim("Client req ")} ${options.clientRequestId}`);
+    }
+    if (resolvedIdempotencyKey !== void 0) {
+      print(`  ${style.dim("Idem. key  ")} ${resolvedIdempotencyKey}`);
+    }
+    print("");
+    print(style.dim("Re-run without --dry-run to submit."));
+    return;
+  }
+  let response;
+  try {
+    const { client } = await buildClient({ requireAuth: true, globals });
+    response = await client.trades.create(
+      {
+        marketId,
+        outcomeIndex,
+        amount,
+        side,
+        ...options.clientRequestId === void 0 ? {} : { clientRequestId: options.clientRequestId }
+      },
+      resolvedIdempotencyKey === void 0 ? {} : { idempotencyKey: resolvedIdempotencyKey }
+    );
+    const augment = (payload) => resolvedIdempotencyKey === void 0 ? payload : { ...payload, idempotencyKey: resolvedIdempotencyKey };
+    if (response.confirmation) {
+      if (json) {
+        printJson(augment(response));
+        return;
+      }
+      log.warn(
+        "High-value trade \u2014 server returned 202. Confirm with `kash trade confirm <id> <token>`."
+      );
+      print(`  ${style.dim("Trade id   ")} ${response.id}`);
+      print(`  ${style.dim("Status     ")} ${colorStatus(response.status)}`);
+      print(`  ${style.dim("Token      ")} ${response.confirmation.token}`);
+      print(`  ${style.dim("Expires    ")} ${response.confirmation.expiresAt}`);
+      return;
+    }
+    if (!options.wait) {
+      if (json) {
+        printJson(augment(response));
+        return;
+      }
+      log.success(
+        `${capitalize(side)} accepted${response.idempotent ? " (idempotent replay)" : ""}: ${shortId(response.id)}`
+      );
+      print(`  ${style.dim("Trade id   ")} ${response.id}`);
+      print(`  ${style.dim("Status     ")} ${colorStatus(response.status)}`);
+      print(`  ${style.dim("Amount     ")} ${formatUsdcDecimal(response.amount)}`);
+      log.info("Run 'kash trade status <id> --poll' to follow it to completion.");
+      return;
+    }
+    let completed;
+    try {
+      completed = await waitForCompletion(client, response, {
+        timeoutMs,
+        pollIntervalMs,
+        json
+      });
+    } catch (waitCause) {
+      if (json) {
+        printJson({
+          id: response.id,
+          status: response.status,
+          waited: false,
+          partial: true
+        });
+      } else {
+        log.warn(
+          `Trade created but poll did not reach a terminal state. Resume with: kash trade status ${response.id} --poll`
+        );
+      }
+      throw waitCause;
+    }
+    if (json) {
+      printJson(augment({ ...completed, idempotent: response.idempotent, waited: true }));
+      return;
+    }
+    renderTerminal(completed);
+  } catch (cause) {
+    throw toCliError(cause);
+  }
+}
+async function waitForCompletion(client, initial, opts) {
+  const ac = new AbortController();
+  const onSig = () => ac.abort();
+  process.on("SIGINT", onSig);
+  process.on("SIGTERM", onSig);
+  try {
+    if (opts.json || isQuiet()) {
+      return await client.trades.waitForCompletion(initial.id, {
+        timeoutMs: opts.timeoutMs,
+        pollIntervalMs: opts.pollIntervalMs,
+        signal: ac.signal
+      });
+    }
+    const spinner = ora({
+      text: `Waiting for trade ${shortId(initial.id)}\u2026`,
+      stream: process.stderr
+    }).start();
+    try {
+      const completed = await client.trades.waitForCompletion(initial.id, {
+        timeoutMs: opts.timeoutMs,
+        pollIntervalMs: opts.pollIntervalMs,
+        signal: ac.signal,
+        onStatus: (trade) => {
+          spinner.text = `Trade ${shortId(trade.id)} \u2014 status: ${trade.status}`;
+        }
+      });
+      if (completed.status === "completed") {
+        spinner.succeed(`Trade ${shortId(completed.id)} completed.`);
+      } else {
+        spinner.fail(`Trade ${shortId(completed.id)} ${completed.status}.`);
+      }
+      return completed;
+    } catch (cause) {
+      spinner.fail("Polling stopped.");
+      throw cause;
+    }
+  } finally {
+    process.off("SIGINT", onSig);
+    process.off("SIGTERM", onSig);
+  }
+}
+function renderTerminal(trade) {
+  print("");
+  print(`  ${style.dim("Trade id   ")} ${trade.id}`);
+  print(`  ${style.dim("Status     ")} ${colorStatus(trade.status)}`);
+  print(`  ${style.dim("Amount     ")} ${formatUsdcDecimal(trade.amount)}`);
+  if (trade.txHash !== null) {
+    print(`  ${style.dim("Tx hash    ")} ${trade.txHash}`);
+  }
+  if (trade.tokensOut !== null) {
+    print(`  ${style.dim("Tokens out ")} ${trade.tokensOut}`);
+  }
+  if (trade.errorMessage !== null || trade.errorCode !== null) {
+    print(
+      `  ${style.dim("Error      ")} [${trade.errorCode ?? "UNKNOWN"}] ${trade.errorMessage ?? ""}`
+    );
+    log.info(`Inspect the full timeline: kash trace ${trade.correlationId}`);
+  }
+}
+
+// src/commands/trade/buy.ts
+var buyCommand = new Command("buy").description("Buy outcome tokens for a market.").argument("<marketId>", "market UUID").requiredOption("-o, --outcome <index>", "outcome index (0-based)").requiredOption("-a, --amount <usdc>", "USDC amount as a decimal (max 6 fractional digits)").option("--wait", "block until the trade reaches a terminal state").option(
+  "--wait-timeout-ms, --timeout <ms>",
+  "wait timeout in milliseconds (default 60000) \u2014 distinct from the global --timeout-ms (per-HTTP-request)"
+).option(
+  "--poll-interval-ms, --poll-interval <ms>",
+  "wait poll interval in milliseconds (default 2000)"
+).option("--idempotency-key <key>", "sets the Idempotency-Key HTTP header").option(
+  "--auto-idempotency-key",
+  "auto-generate an Idempotency-Key (UUID v4) and surface it in the response"
+).option("--client-request-id <id>", "sets the body-level clientRequestId for replay safety").option(
+  "--dry-run",
+  "preview the request without sending \u2014 emits the would-be body and resolved headers"
+).addHelpText(
+  "after",
+  `
+Examples:
+  $ kash trade buy 9f0b... --outcome 0 --amount 10
+  $ kash trade buy 9f0b... --outcome 1 --amount 25 --wait
+  $ kash trade buy 9f0b... --outcome 0 --amount 5 --auto-idempotency-key --json --quiet
+  $ kash trade buy 9f0b... --outcome 0 --amount 10 --dry-run --json
+`
+).action(async (marketId, options, cmd) => {
+  const globals = readGlobals(cmd);
+  await placeTrade({ marketId, side: "buy", options, globals });
+});
+
+// src/commands/trade/confirm.ts
+import { Command as Command2 } from "commander";
+var confirmCommand = new Command2("confirm").description("Confirm a high-value trade using its one-time token.").argument("<id>", "trade UUID").argument("[token]", "confirmation token (omit to read from stdin or prompt)").option("--token-stdin", "read the confirmation token from stdin").addHelpText(
+  "after",
+  `
+Examples:
+  # Interactive prompt (no shell history footprint).
+  $ kash trade confirm 9f0b...
+
+  # Pipe from a captured token.
+  $ cat token.txt | kash trade confirm 9f0b... --token-stdin
+
+  # Positional (convenient but shows up in ~/.bash_history).
+  $ kash trade confirm 9f0b... eyJ...
+  $ kash trade confirm 9f0b... eyJ... --json --quiet
+`
+).action(
+  async (id, positional, options, cmd) => {
+    const globals = readGlobals(cmd);
+    const token = await resolveToken(positional, options);
+    let trade;
+    try {
+      const { client } = await buildClient({ requireAuth: true, globals });
+      trade = await client.trades.confirm(id, { token });
+    } catch (cause) {
+      throw toCliError(cause);
+    }
+    if (globals.json) {
+      printJson(trade);
+      return;
+    }
+    log.success(`Trade ${trade.id} confirmed.`);
+    print(`  ${style.dim("Status     ")} ${colorStatus(trade.status)}`);
+    print(`  ${style.dim("Amount     ")} ${formatUsdcDecimal(trade.amount)}`);
+    log.info("Run 'kash trade status <id> --poll' to follow it to completion.");
+  }
+);
+async function resolveToken(positional, options) {
+  if (positional !== void 0 && positional !== "" && options.tokenStdin === true) {
+    throw new CliValidationError(
+      "Pass either the positional [token] OR --token-stdin, not both.",
+      "The positional token would silently win and the piped value would be dropped.",
+      "token"
+    );
+  }
+  if (positional !== void 0 && positional !== "") {
+    return positional;
+  }
+  if (options.tokenStdin === true) {
+    const { readStdinTrimmed } = await import("./stdin-YW2CEQXU.js");
+    return readStdinTrimmed();
+  }
+  if (process.stdin.isTTY) {
+    const { password } = await import("@inquirer/prompts");
+    const answer = await password({
+      message: "Paste the confirmation token:",
+      mask: "*"
+    });
+    return answer.trim();
+  }
+  throw new CliValidationError(
+    "No confirmation token provided.",
+    "Pass the token positionally, use --token-stdin to read it from a pipe, or run interactively for a prompt.",
+    "token"
+  );
+}
+
+// src/commands/trade/list.ts
+import { Command as Command3 } from "commander";
+var listTradesCommand = new Command3("list").description("List your trades.").option(
+  "-s, --status <status...>",
+  "status filter; repeat or comma-separate (e.g. --status pending --status executing | --status pending,executing)"
+).option("-m, --market <id>", "filter by market id").option("-l, --limit <n>", "page size (1-100)", "20").option("-c, --cursor <cursor>", "pagination cursor").option("-a, --all", "walk every page (use with --json for export)").option(
+  "--ndjson",
+  "stream results as newline-delimited JSON (one record per line); implies --all"
+).addHelpText(
+  "after",
+  `
+Examples:
+  $ kash trade list
+  $ kash trade list --status pending,executing --json --quiet
+  $ kash trade list --status pending --status executing --json --quiet
+  $ kash trade list --market 9f0b... --json --quiet | jq '.data[] | select(.status=="completed")'
+  $ kash trade list --all --ndjson | while read -r line; do echo "$line" | jq -r .id; done
+`
+).action(async (options, cmd) => {
+  const globals = readGlobals(cmd);
+  const limit = options.limit === void 0 ? 20 : parsePositiveInt(options.limit, "limit");
+  if (limit < 1 || limit > 100) {
+    throw new CliValidationError("--limit must be between 1 and 100.", void 0, "limit");
+  }
+  const status = normaliseStatus(options.status);
+  let response;
+  try {
+    const { client } = await buildClient({ requireAuth: true, globals });
+    response = await client.trades.list({
+      limit,
+      ...options.cursor === void 0 ? {} : { cursor: options.cursor },
+      ...status === void 0 ? {} : { status },
+      ...options.market === void 0 ? {} : { marketId: options.market }
+    });
+    if (options.ndjson) {
+      for await (const trade of response) {
+        writeNdjson(trade);
+      }
+      return;
+    }
+    if (options.all) {
+      const collected = [];
+      for await (const trade of response) collected.push(trade);
+      if (globals.json) {
+        printJson({
+          data: collected,
+          pagination: { hasMore: false, cursor: null },
+          count: collected.length
+        });
+      } else {
+        renderTable(collected);
+      }
+      return;
+    }
+  } catch (cause) {
+    throw toCliError(cause);
+  }
+  if (globals.json) {
+    printJson({
+      data: response.data,
+      pagination: response.pagination,
+      count: response.data.length
+    });
+    return;
+  }
+  if (response.data.length === 0) {
+    log.info("No trades matched the filter.");
+    return;
+  }
+  renderTable(response.data);
+  if (response.pagination.hasMore && response.pagination.cursor) {
+    log.detail("Next page", `--cursor ${response.pagination.cursor}`);
+  }
+});
+function normaliseStatus(raw) {
+  if (!raw || raw.length === 0) return void 0;
+  const seen = /* @__PURE__ */ new Set();
+  for (const entry of raw) {
+    for (const piece of entry.split(",")) {
+      const trimmed = piece.trim();
+      if (trimmed.length > 0) seen.add(trimmed);
+    }
+  }
+  return seen.size === 0 ? void 0 : [...seen].join(",");
+}
+function renderTable(trades) {
+  const table = createTable(["Trade", "Market", "Side", "Out#", "Amount", "Status", "Tx"]);
+  for (const t of trades) {
+    table.push([
+      shortId(t.id),
+      shortId(t.marketId),
+      t.side,
+      String(t.outcomeIndex),
+      formatUsdcDecimal(t.amount),
+      colorStatus(t.status),
+      t.txHash ? shortId(t.txHash, 10) : "-"
+    ]);
+  }
+  print(table.toString());
+}
+
+// src/commands/trade/sell.ts
+import { Command as Command4 } from "commander";
+var sellCommand = new Command4("sell").description("Sell outcome tokens back to the market (Kash-orchestrated / hosted-API flow).").argument("<marketId>", "market UUID").requiredOption("-o, --outcome <index>", "outcome index (0-based)").requiredOption(
+  "-a, --amount <usdc>",
+  "target USDC to receive (decimal, max 6 fractional digits) \u2014 NOT tokens-in. Use `kash quote sell --tokens <n>` if you have a tokens-in figure and want a USDC quote first."
+).option("--wait", "block until the trade reaches a terminal state").option(
+  "--wait-timeout-ms, --timeout <ms>",
+  "wait timeout in milliseconds (default 60000) \u2014 distinct from the global --timeout-ms (per-HTTP-request)"
+).option(
+  "--poll-interval-ms, --poll-interval <ms>",
+  "wait poll interval in milliseconds (default 2000)"
+).option("--idempotency-key <key>", "sets the Idempotency-Key HTTP header").option(
+  "--auto-idempotency-key",
+  "auto-generate an Idempotency-Key (UUID v4) and surface it in the response"
+).option("--client-request-id <id>", "sets the body-level clientRequestId for replay safety").option(
+  "--dry-run",
+  "preview the request without sending \u2014 emits the would-be body and resolved headers"
+).addHelpText(
+  "after",
+  `
+Examples:
+  $ kash trade sell 9f0b... --outcome 0 --amount 10        # target $10 USDC out
+  $ kash trade sell 9f0b... --outcome 1 --amount 25 --wait
+  $ kash trade sell 9f0b... --outcome 0 --amount 5 --auto-idempotency-key --json --quiet
+  $ kash trade sell 9f0b... --outcome 0 --amount 10 --dry-run --json
+
+Notes:
+  --amount is in USDC for both buy AND sell:
+    BUY  \u2014 USDC you spend (input).
+    SELL \u2014 USDC you target receiving (output).
+  This is the API contract, not a CLI choice \u2014 \`kash quote sell --tokens N\`
+  takes a tokens-in figure if that's the shape you have on hand.
+`
+).action(async (marketId, options, cmd) => {
+  const globals = readGlobals(cmd);
+  await placeTrade({ marketId, side: "sell", options, globals });
+});
+
+// src/commands/trade/status.ts
+import { Command as Command5 } from "commander";
+import ora2 from "ora";
+var statusCommand = new Command5("status").description("Show the status of a trade. Use --poll to block until terminal.").argument("<id>", "trade UUID").addHelpText(
+  "after",
+  `
+Examples:
+  $ kash trade status 9f0b...
+  $ kash trade status 9f0b... --poll
+  $ kash trade status 9f0b... --poll --json --quiet | jq -r '.txHash'
+`
+).option("--poll", "poll until the trade reaches a terminal state").option(
+  "--wait-timeout-ms, --timeout <ms>",
+  "poll timeout in milliseconds (default 60000) \u2014 distinct from the global --timeout-ms (per-HTTP-request)"
+).option(
+  "--poll-interval-ms, --poll-interval <ms>",
+  "poll interval in milliseconds (default 2000)"
+).action(async (id, options, cmd) => {
+  const globals = readGlobals(cmd);
+  let trade;
+  try {
+    const { client } = await buildClient({ requireAuth: true, globals });
+    if (options.poll) {
+      const timeoutMs = options.timeout ? parsePositiveInt(options.timeout, "timeout") : 6e4;
+      const pollIntervalMs = options.pollInterval ? parsePositiveInt(options.pollInterval, "poll-interval") : 2e3;
+      const ac = new AbortController();
+      const onSig = () => ac.abort();
+      process.on("SIGINT", onSig);
+      process.on("SIGTERM", onSig);
+      try {
+        if (globals.json || isQuiet()) {
+          trade = await client.trades.waitForCompletion(id, {
+            timeoutMs,
+            pollIntervalMs,
+            signal: ac.signal
+          });
+        } else {
+          const spinner = ora2({
+            text: `Polling trade ${shortId(id)}\u2026`,
+            stream: process.stderr
+          }).start();
+          try {
+            trade = await client.trades.waitForCompletion(id, {
+              timeoutMs,
+              pollIntervalMs,
+              signal: ac.signal,
+              onStatus: (current) => {
+                spinner.text = `Trade ${shortId(current.id)} \u2014 status: ${current.status}`;
+              }
+            });
+            if (trade.status === "completed") {
+              spinner.succeed(`Trade ${shortId(trade.id)} completed.`);
+            } else {
+              spinner.fail(`Trade ${shortId(trade.id)} ${trade.status}.`);
+            }
+          } catch (cause) {
+            spinner.fail("Polling stopped.");
+            throw cause;
+          }
+        }
+      } finally {
+        process.off("SIGINT", onSig);
+        process.off("SIGTERM", onSig);
+      }
+    } else {
+      trade = await client.trades.get(id);
+    }
+  } catch (cause) {
+    throw toCliError(cause);
+  }
+  if (globals.json) {
+    printJson(trade);
+    return;
+  }
+  print("");
+  print(`  ${style.dim("Trade id    ")} ${trade.id}`);
+  print(`  ${style.dim("Market id   ")} ${trade.marketId}`);
+  print(`  ${style.dim("Side        ")} ${trade.side}`);
+  print(`  ${style.dim("Outcome idx ")} ${String(trade.outcomeIndex)}`);
+  print(`  ${style.dim("Amount      ")} ${formatUsdcDecimal(trade.amount)}`);
+  print(`  ${style.dim("Status      ")} ${colorStatus(trade.status)}`);
+  if (trade.txHash !== null) {
+    print(`  ${style.dim("Tx hash     ")} ${trade.txHash}`);
+  }
+  if (trade.tokensOut !== null) {
+    print(`  ${style.dim("Tokens out  ")} ${trade.tokensOut}`);
+  }
+  if (trade.errorCode !== null || trade.errorMessage !== null) {
+    print(
+      `  ${style.dim("Error       ")} [${trade.errorCode ?? "UNKNOWN"}] ${trade.errorMessage ?? ""}`
+    );
+    log.info(`Inspect the full timeline: kash trace ${trade.correlationId}`);
+  }
+  print(`  ${style.dim("Created     ")} ${formatDate(trade.createdAt)}`);
+  print(`  ${style.dim("Updated     ")} ${formatDate(trade.updatedAt)}`);
+  if (trade.webhookDelivery !== null) {
+    const wh = trade.webhookDelivery;
+    const failure = wh.lastFailureCode === null ? "" : ` (${wh.lastFailureCode})`;
+    const httpStatus = wh.lastStatusCode === null ? "" : ` HTTP ${String(wh.lastStatusCode)}`;
+    print(
+      `  ${style.dim("Webhook     ")} ${colorStatus(wh.status)} attempts=${String(wh.attempts)}${httpStatus}${failure}`
+    );
+    if (wh.lastAttemptedAt !== null) {
+      print(`  ${style.dim("  Last try  ")} ${formatDate(wh.lastAttemptedAt)}`);
+    }
+  }
+  if (trade.status === "pending_confirmation") {
+    log.warn("Trade is awaiting high-value confirmation. Run `kash trade confirm <id> <token>`.");
+  }
+});
+
+// src/commands/trade/index.ts
+var tradeCommand = new Command6("trade").description("Place trades and inspect their status.").addCommand(buyCommand).addCommand(sellCommand).addCommand(statusCommand).addCommand(listTradesCommand).addCommand(confirmCommand);
+export {
+  tradeCommand
+};
+//# sourceMappingURL=trade-IIZSEXEI.js.map