context-markets-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Context
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+<p align="center">
+  <img src="https://mainnet.contextcdn.com/ced823d63df9dff0390d9ad0a4e1ad3905dd199a6c50758c18a5c92a203adbd7" alt="Context" width="100%" />
+</p>
+
+<h1 align="center">Context CLI</h1>
+<p align="center">CLI for trading on <a href="https://context.markets">Context Markets</a> prediction markets. All output is JSON. Designed for AI agents.</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/context-markets-cli"><img src="https://img.shields.io/npm/v/context-markets-cli" alt="npm" /></a>
+  <a href="https://github.com/contextwtf/context-cli/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="License: MIT" /></a>
+  <a href="https://discord.gg/RVmzZsAyM4"><img src="https://img.shields.io/badge/Discord-Join-7289da" alt="Discord" /></a>
+</p>
+
+## Install
+
+```bash
+npx context-markets-cli <command>
+```
+
+Or install globally:
+
+```bash
+npm install -g context-markets-cli
+```
+
+## Setup
+
+```bash
+export CONTEXT_API_KEY="your-api-key"
+export CONTEXT_PRIVATE_KEY="0x..."   # required for trading/account commands
+```
+
+Need an API key? Visit [context.markets](https://context.markets) or join our [Discord](https://discord.gg/RVmzZsAyM4).
+
+## Quick Start
+
+```bash
+# Browse markets
+context markets list --status active --limit 5
+
+# Get quotes for a market
+context markets quotes <market-id>
+
+# Place a limit order
+context orders create --market <id> --outcome yes --side buy --price 45 --size 10
+
+# Check your portfolio
+context portfolio get
+```
+
+## Commands
+
+**Markets** — `markets list` · `markets get` · `markets quotes` · `markets orderbook` · `markets simulate` · `markets price-history` · `markets oracle` · `markets oracle-quotes` · `markets activity` · `markets create` · `markets global-activity`
+
+**Orders** — `orders list` · `orders mine` · `orders get` · `orders recent` · `orders simulate` · `orders create` · `orders market` · `orders cancel` · `orders cancel-replace` · `orders bulk-create` · `orders bulk-cancel` · `orders bulk`
+
+**Portfolio** — `portfolio get` · `portfolio claimable` · `portfolio stats` · `portfolio balance` · `portfolio token-balance`
+
+**Account** — `account status` · `account setup` · `account mint-test-usdc` · `account deposit` · `account withdraw`
+
+**Questions** — `questions submit` · `questions status` · `questions submit-and-wait`
+
+**Gasless** — `setup` · `gasless-approve` · `gasless-deposit`
+
+## Key Concepts
+
+- **Prices** are in cents (1–99). A price of 65 means $0.65 per share.
+- **Outcomes** are `yes` or `no`. Each market is a binary question.
+- **All output is JSON** to stdout. Errors are JSON to stderr with exit code 1.
+- **Read-only commands** only need `CONTEXT_API_KEY`. **Trading commands** also need `CONTEXT_PRIVATE_KEY`.
+
+## Documentation
+
+- **[Command Reference](https://docs.context.markets/agents/cli/commands)** — full list of commands with flags and response shapes
+- **[CLI Guide](https://docs.context.markets/agents/cli)** — setup, authentication, and workflows
+- **[Agent Workflows](https://docs.context.markets/agents/cli/workflows)** — common patterns for AI agent integration
+
+## Ecosystem
+
+| Package | Description |
+|---------|-------------|
+| **[context-markets](https://github.com/contextwtf/context-sdk)** | TypeScript SDK for trading |
+| **[@contextwtf/react](https://github.com/contextwtf/context-react)** | React hooks for market data and trading |
+| **[@contextwtf/mcp](https://github.com/contextwtf/context-mcp)** | MCP server for AI agents |
+| **[context-markets-cli](https://github.com/contextwtf/context-cli)** | CLI for trading from the terminal |
+| **[context-skills](https://github.com/contextwtf/context-skills)** | AI agent skill files |
+| **[context-plugin](https://github.com/contextwtf/context-plugin)** | Claude Code plugin |
+
+## License
+
+MIT — see [LICENSE](./LICENSE) for details.

package/dist/account-DL4WGQCC.js

@@ -0,0 +1,207 @@
+import {
+  formatAddress,
+  formatMoney,
+  truncate
+} from "./chunk-IRVQREUN.js";
+import {
+  tradingClient
+} from "./chunk-BUZKJ7FR.js";
+import {
+  fail,
+  out,
+  requirePositional
+} from "./chunk-QC6BGRUQ.js";
+
+// src/commands/account.ts
+var HELP = `Usage: context account <subcommand> [options]
+
+Subcommands:
+  status                            Check wallet status (balances, approvals)
+  setup                             Approve contracts for gasless trading
+  mint-test-usdc                    Mint test USDC on testnet
+    --amount <n>                      Amount to mint (default: 1000)
+
+  deposit <amount>                  Deposit USDC into the exchange
+  withdraw <amount>                 Withdraw USDC from the exchange
+
+  mint-complete-sets <market-id> <amount>
+                                    Mint complete sets of outcome tokens
+  burn-complete-sets <market-id> <amount>
+                                    Burn complete sets of outcome tokens
+    --credit-internal <true|false>    Credit internal balance (default: true)
+
+  help                              Show this help text
+
+All account commands require a signer (--private-key or CONTEXT_PRIVATE_KEY).
+
+Global options:
+  --api-key <key>                   Context API key (or CONTEXT_API_KEY env)
+  --private-key <key>               Private key for signing (or CONTEXT_PRIVATE_KEY env)`;
+async function handleAccount(parsed) {
+  const { subcommand, positional, flags } = parsed;
+  switch (subcommand) {
+    case "status":
+      return status(flags);
+    case "setup":
+      return setup(flags);
+    case "mint-test-usdc":
+      return mintTestUsdc(flags);
+    case "deposit":
+      return deposit(positional, flags);
+    case "withdraw":
+      return withdraw(positional, flags);
+    case "mint-complete-sets":
+      return mintCompleteSets(positional, flags);
+    case "burn-complete-sets":
+      return burnCompleteSets(positional, flags);
+    case "relay-operator-approval":
+      return fail(
+        "Use `context gasless-approve` for gasless operator approval."
+      );
+    case "relay-deposit":
+      return fail(
+        "Use `context gasless-deposit <amount>` for gasless deposit."
+      );
+    case "help":
+    case void 0:
+      console.log(HELP);
+      return;
+    default:
+      fail(
+        `Unknown account subcommand: "${subcommand}". Run "context account help" for usage.`
+      );
+  }
+}
+async function status(flags) {
+  const ctx = tradingClient(flags);
+  const result = await ctx.account.status();
+  const s = result;
+  out(result, {
+    detail: [
+      ["Address", formatAddress(s.address)],
+      ["ETH Balance", s.ethBalance || "\u2014"],
+      ["USDC Allowance", s.usdcAllowance ? "\u2713 Approved" : "\u2717 None"],
+      ["Operator", s.isOperatorApproved ? "\u2713 Approved" : "\u2717 Not approved"],
+      ["Needs Setup", s.needsApprovals ? "Yes \u2014 run `context setup`" : "No"]
+    ]
+  });
+}
+async function setup(flags) {
+  const ctx = tradingClient(flags);
+  const result = await ctx.account.setup();
+  out(result, {
+    detail: [
+      ["Status", "\u2713 Contracts approved"]
+    ]
+  });
+}
+async function mintTestUsdc(flags) {
+  const amountRaw = flags["amount"];
+  let amount;
+  if (amountRaw) {
+    amount = parseFloat(amountRaw);
+    if (isNaN(amount) || amount <= 0) {
+      fail("--amount must be a positive number", { received: amountRaw });
+    }
+  }
+  const ctx = tradingClient(flags);
+  const result = await ctx.account.mintTestUsdc(amount);
+  const r = result;
+  out(result, {
+    detail: [
+      ["Status", "\u2713 Minted"],
+      ["Amount", formatMoney(r.amount ?? amount)],
+      ["Tx Hash", formatAddress(r.txHash || r.tx_hash)]
+    ]
+  });
+}
+async function deposit(positional, flags) {
+  const raw = requirePositional(
+    positional,
+    0,
+    "amount",
+    "context account deposit <amount>"
+  );
+  const amount = parseFloat(raw);
+  if (isNaN(amount) || amount <= 0) {
+    fail("Deposit amount must be a positive number", { received: raw });
+  }
+  const ctx = tradingClient(flags);
+  const txHash = await ctx.account.deposit(amount);
+  out({ status: "deposited", amount_usdc: amount, tx_hash: txHash }, {
+    detail: [
+      ["Status", "\u2713 Deposited"],
+      ["Amount", formatMoney(amount)],
+      ["Tx Hash", formatAddress(txHash)]
+    ]
+  });
+}
+async function withdraw(positional, flags) {
+  const raw = requirePositional(
+    positional,
+    0,
+    "amount",
+    "context account withdraw <amount>"
+  );
+  const amount = parseFloat(raw);
+  if (isNaN(amount) || amount <= 0) {
+    fail("Withdraw amount must be a positive number", { received: raw });
+  }
+  const ctx = tradingClient(flags);
+  const txHash = await ctx.account.withdraw(amount);
+  out({ status: "withdrawn", amount_usdc: amount, tx_hash: txHash }, {
+    detail: [
+      ["Status", "\u2713 Withdrawn"],
+      ["Amount", formatMoney(amount)],
+      ["Tx Hash", formatAddress(txHash)]
+    ]
+  });
+}
+async function mintCompleteSets(positional, flags) {
+  const usage = "context account mint-complete-sets <market-id> <amount>";
+  const marketId = requirePositional(positional, 0, "market-id", usage);
+  const amountRaw = requirePositional(positional, 1, "amount", usage);
+  const amount = parseFloat(amountRaw);
+  if (isNaN(amount) || amount <= 0) {
+    fail("Amount must be a positive number", { received: amountRaw });
+  }
+  const ctx = tradingClient(flags);
+  const txHash = await ctx.account.mintCompleteSets(marketId, amount);
+  out({ status: "minted", market_id: marketId, amount, tx_hash: txHash }, {
+    detail: [
+      ["Status", "\u2713 Minted complete sets"],
+      ["Market", truncate(marketId, 20)],
+      ["Amount", String(amount)],
+      ["Tx Hash", formatAddress(txHash)]
+    ]
+  });
+}
+async function burnCompleteSets(positional, flags) {
+  const usage = "context account burn-complete-sets <market-id> <amount>";
+  const marketId = requirePositional(positional, 0, "market-id", usage);
+  const amountRaw = requirePositional(positional, 1, "amount", usage);
+  const amount = parseFloat(amountRaw);
+  if (isNaN(amount) || amount <= 0) {
+    fail("Amount must be a positive number", { received: amountRaw });
+  }
+  const creditInternalRaw = flags["credit-internal"];
+  const creditInternal = creditInternalRaw !== "false";
+  const ctx = tradingClient(flags);
+  const txHash = await ctx.account.burnCompleteSets(
+    marketId,
+    amount,
+    creditInternal
+  );
+  out({ status: "burned", market_id: marketId, amount, credit_internal: creditInternal, tx_hash: txHash }, {
+    detail: [
+      ["Status", "\u2713 Burned complete sets"],
+      ["Market", truncate(marketId, 20)],
+      ["Amount", String(amount)],
+      ["Credit Internal", String(creditInternal)],
+      ["Tx Hash", formatAddress(txHash)]
+    ]
+  });
+}
+export {
+  handleAccount as default
+};

package/dist/chunk-BJIFIOK6.js

@@ -0,0 +1,75 @@
+import {
+  getOutputMode
+} from "./chunk-QC6BGRUQ.js";
+
+// src/ui/prompt.ts
+import * as readline from "readline";
+import chalk from "chalk";
+var CancelError = class extends Error {
+  constructor() {
+    super("Cancelled.");
+    this.name = "CancelError";
+  }
+};
+var _shellRl = null;
+function setShellReadline(rl) {
+  _shellRl = rl;
+}
+function confirm(message) {
+  const prompt = chalk.cyan(`  ? ${message} ${chalk.dim("(Y/n)")} `);
+  if (_shellRl) {
+    return new Promise((resolve) => {
+      _shellRl.question(prompt, (answer) => {
+        const trimmed = answer.trim().toLowerCase();
+        resolve(trimmed === "" || trimmed === "y" || trimmed === "yes");
+      });
+    });
+  }
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stderr,
+      terminal: true
+    });
+    rl.question(prompt, (answer) => {
+      rl.close();
+      const trimmed = answer.trim().toLowerCase();
+      resolve(trimmed === "" || trimmed === "y" || trimmed === "yes");
+    });
+  });
+}
+async function confirmOrder(summary, flags) {
+  if (getOutputMode() === "json" || flags["yes"] === "true" || !process.stdout.isTTY) {
+    return;
+  }
+  console.log();
+  console.log(chalk.bold("  Order Summary"));
+  console.log(chalk.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  if (summary.market) console.log(`  Market:  ${summary.market}`);
+  console.log(`  Side:    ${summary.side.toUpperCase()} ${summary.outcome.toUpperCase()}`);
+  if (summary.price) console.log(`  Price:   ${summary.price}`);
+  if (summary.size) console.log(`  Size:    ${summary.size} shares`);
+  if (summary.estimatedCost) console.log(`  Cost:    ~${summary.estimatedCost}`);
+  console.log();
+  const confirmed = await confirm("Place this order?");
+  if (!confirmed) {
+    console.log(chalk.dim("  Cancelled."));
+    throw new CancelError();
+  }
+}
+async function confirmAction(message, flags) {
+  if (getOutputMode() === "json" || flags["yes"] === "true" || !process.stdout.isTTY) {
+    return;
+  }
+  const confirmed = await confirm(message);
+  if (!confirmed) {
+    console.log(chalk.dim("  Cancelled."));
+    throw new CancelError();
+  }
+}
+
+export {
+  setShellReadline,
+  confirmOrder,
+  confirmAction
+};

package/dist/chunk-BUZKJ7FR.js

@@ -0,0 +1,37 @@
+import {
+  fail
+} from "./chunk-QC6BGRUQ.js";
+
+// src/client.ts
+import { ContextClient } from "context-markets";
+function readClient(flags = {}) {
+  const apiKey = flags["api-key"] ?? process.env.CONTEXT_API_KEY;
+  if (!apiKey) fail("Missing CONTEXT_API_KEY env var or --api-key flag");
+  const rpcUrl = flags["rpc-url"] ?? process.env.CONTEXT_RPC_URL;
+  const baseUrl = flags["base-url"] ?? process.env.CONTEXT_BASE_URL;
+  return new ContextClient({ apiKey, rpcUrl, baseUrl });
+}
+function tradingClient(flags = {}) {
+  const apiKey = flags["api-key"] ?? process.env.CONTEXT_API_KEY;
+  if (!apiKey) fail("Missing CONTEXT_API_KEY env var or --api-key flag");
+  const privateKey = flags["private-key"] ?? process.env.CONTEXT_PRIVATE_KEY;
+  if (!privateKey) {
+    fail(
+      "A private key is required for trading operations.",
+      { hint: "Set CONTEXT_PRIVATE_KEY env var or pass --private-key <key>" }
+    );
+  }
+  const rpcUrl = flags["rpc-url"] ?? process.env.CONTEXT_RPC_URL;
+  const baseUrl = flags["base-url"] ?? process.env.CONTEXT_BASE_URL;
+  return new ContextClient({
+    apiKey,
+    rpcUrl,
+    baseUrl,
+    signer: { privateKey }
+  });
+}
+
+export {
+  readClient,
+  tradingClient
+};

package/dist/chunk-IRVQREUN.js

@@ -0,0 +1,55 @@
+// src/ui/format.ts
+var DASH = "\u2014";
+function formatPrice(value) {
+  if (value === null || value === void 0) return DASH;
+  const n = typeof value === "string" ? Number(value) : value;
+  if (n === 0) return DASH;
+  const cents = n / 1e4;
+  return `${cents.toFixed(cents % 1 === 0 ? 0 : 1)}\xA2`;
+}
+function formatMoney(value) {
+  if (value === null || value === void 0) return DASH;
+  const n = typeof value === "string" ? Number(value) : value;
+  if (n >= 1e6) return `$${(n / 1e6).toFixed(1)}M`;
+  if (n >= 1e3) return `$${(n / 1e3).toFixed(1)}K`;
+  return `$${n.toFixed(2)}`;
+}
+function formatVolume(value) {
+  if (value === null || value === void 0) return DASH;
+  const n = typeof value === "string" ? Number(value) : value;
+  const dollars = n / 1e6;
+  if (dollars >= 1e6) return `$${(dollars / 1e6).toFixed(1)}M`;
+  if (dollars >= 1e3) return `$${(dollars / 1e3).toFixed(1)}K`;
+  if (dollars >= 1) return `$${dollars.toFixed(2)}`;
+  if (dollars > 0) return `$${dollars.toFixed(2)}`;
+  return "$0.00";
+}
+function formatAddress(value) {
+  if (value === null || value === void 0) return DASH;
+  if (value.length <= 10) return value;
+  return `${value.slice(0, 6)}...${value.slice(-4)}`;
+}
+function truncate(value, maxLen) {
+  if (value === null || value === void 0) return DASH;
+  if (value.length <= maxLen) return value;
+  return value.slice(0, maxLen - 3) + "...";
+}
+function formatDate(value) {
+  if (value === null || value === void 0) return DASH;
+  const d = new Date(value);
+  return d.toLocaleDateString("en-US", {
+    month: "short",
+    day: "numeric",
+    year: "numeric",
+    timeZone: "UTC"
+  });
+}
+
+export {
+  formatPrice,
+  formatMoney,
+  formatVolume,
+  formatAddress,
+  truncate,
+  formatDate
+};