hunch-cup 0.2.0 → 0.2.2

package/README.md

@@ -1,17 +1,17 @@
 # hunch-cup
 
 One-line CLI + typed SDK to play the **Hunch Cup** — a risk-free, **paper-trading**
-prediction-market tournament. Claim **10,000 $pHUNCH** (paper money, zero real-funds
+prediction-market tournament. Claim **10,000 $pUSDC** (paper money, zero real-funds
 risk), trade the live Hunch catalog, run a 24/7 agent, and climb a public leaderboard
 scored on realized PnL. The top 50 wallets split a real **$5,000**.
 
-> Everything here is **paper**. $pHUNCH never touches a chain and is never redeemable.
+> Everything here is **paper**. $pUSDC never touches a chain and is never redeemable.
 > The only real money is the prize, paid to the top-50 wallet addresses at the end.
 
 ## CLI
 
 ```bash
-# 1. Generate a wallet and claim 10,000 $pHUNCH (prints a private key — save it!)
+# 1. Generate a wallet and claim 10,000 $pUSDC (prints a private key — save it!)
 npx hunch-cup wallet new
 
 export HUNCH_CUP_PRIVATE_KEY=0x...   # the key it printed
@@ -38,7 +38,7 @@ npx hunch-cup run contrarian 25 --live   # one round, actually place trades
 npx hunch-cup run momentum 25 --live --loop --interval 300
 
 npx hunch-cup positions   # balance + open/realized positions (watch for insolvency)
-npx hunch-cup balance     # just the $pHUNCH number
+npx hunch-cup balance     # just the $pUSDC number
 npx hunch-cup board
 ```
 
@@ -64,7 +64,7 @@ import { CupClient, fromPrivateKey } from "hunch-cup";
 
 const client = new CupClient({ signer: fromPrivateKey(process.env.HUNCH_CUP_PRIVATE_KEY!) });
 
-await client.createWallet();                       // claim 10,000 $pHUNCH (once)
+await client.createWallet();                       // claim 10,000 $pUSDC (once)
 const markets = await client.listMarkets(25, 0);   // paginated: limit, offset
 await client.simulateTrade(markets[0].slug, "yes", 25);   // dry run, no signature
 await client.trade({ slug: markets[0].slug, side: "yes", sizePhunch: 25 }); // signed
@@ -88,7 +88,7 @@ await fleetRun({ defaultStrategy: "momentum", sizePhunch: 25, intervalMs: 300_00
 
 Reads are public. A **real** paper trade is proven with an **EIP-191 signature** over a
 canonical message binding `{ wallet, market, side, size, tradeId, issuedAt }` — so only a
-wallet's owner can spend its $pHUNCH. The SDK/CLI signs for you. A `simulate` trade writes
+wallet's owner can spend its $pUSDC. The SDK/CLI signs for you. A `simulate` trade writes
 nothing and needs no signature.
 
 ## MCP

package/dist/cli.js

@@ -2,13 +2,13 @@
 /**
  * `npx hunch-cup` — one-line Hunch Cup paper-trading agent (S8, scope §8.2.3).
  *
- *   hunch-cup wallet new                generate a FRESH wallet + claim 10,000 $pHUNCH
+ *   hunch-cup wallet new                generate a FRESH wallet + claim 10,000 $pUSDC
  *   hunch-cup markets [n] [offset]      list tradable paper markets
  *   hunch-cup quote <slug> <side> <n>   price a paper trade
  *   hunch-cup trade <slug> <side> <n>   place a REAL signed paper trade
  *   hunch-cup run <strategy> [n] [--live] [--loop] [--interval <sec>]
  *   hunch-cup positions                 your balance + open/realized positions
- *   hunch-cup balance                   just your $pHUNCH balance
+ *   hunch-cup balance                   just your $pUSDC balance
  *   hunch-cup board [n]                  show the leaderboard
  *   hunch-cup fleet new <n>             mint N wallets + claim each (→ ~/.hunch-cup/fleet.json)
  *   hunch-cup fleet run <strategy> [--interval <sec>]   run all fleet wallets 24×7
@@ -57,13 +57,13 @@ async function main(argv) {
         out([
             "hunch-cup — paper-trade the Hunch Cup from your terminal.",
             "",
-            "  wallet new                   generate a FRESH wallet + claim 10,000 $pHUNCH",
+            "  wallet new                   generate a FRESH wallet + claim 10,000 $pUSDC",
             "  markets [n] [offset]         list tradable paper markets",
             "  quote <slug> <side> <n>      price a paper trade",
             "  trade <slug> <side> <n>      place a REAL signed paper trade",
             "  run <strategy> [n] [--live] [--loop] [--interval <sec>]",
             "  positions                    your balance + open/realized positions",
-            "  balance                      just your $pHUNCH balance",
+            "  balance                      just your $pUSDC balance",
             "  board [n]                    show the leaderboard",
             "  fleet new <n>                mint N wallets + claim each",
             "  fleet run <strategy> [--interval <sec>]   run all fleet wallets 24×7",

package/dist/client.d.ts

@@ -69,7 +69,7 @@ export declare class CupClient {
     get address(): string | undefined;
     private json;
     private requireSigner;
-    /** Claim 10,000 $pHUNCH once for the signer's wallet. */
+    /** Claim 10,000 $pUSDC once for the signer's wallet. */
     createWallet(): Promise<{
         walletAddress: string;
         balancePhunch: number;
@@ -90,7 +90,7 @@ export declare class CupClient {
         sizePhunch: number;
         tradeId?: string;
     }): Promise<CupTradeReceipt>;
-    /** Typed wallet summary: balance + realized PnL + positions, all in $pHUNCH. */
+    /** Typed wallet summary: balance + realized PnL + positions, all in $pUSDC. */
     getWallet(address?: string): Promise<CupWalletView>;
     /** @deprecated use {@link getWallet}. Kept for back-compat. */
     getPositions(address?: string): Promise<CupWalletView>;
@@ -101,7 +101,7 @@ export declare class CupClient {
     }): Promise<unknown>;
     /**
      * One round of a built-in strategy WITH bankroll survival — the un-managed
-     * loop in the hosting docs went insolvent in ~20 minutes (250 $pHUNCH/round from
+     * loop in the hosting docs went insolvent in ~20 minutes (250 $pUSDC/round from
      * a finite no-top-up grant). This:
      *   • reads the live balance + open positions first (a `live` run);
      *   • skips markets the wallet is ALREADY positioned in (no re-piling);

package/dist/client.js

@@ -2,7 +2,7 @@
  * Hunch Cup — thin typed SDK client over `/api/cup/v1/*` (S8).
  *
  * Wallet-native + keyless: pass a viem `LocalAccount` (or any `CupSigner`) and
- * the client claims your 10,000 $pHUNCH, lists/quotes paper markets, and — for a
+ * the client claims your 10,000 $pUSDC, lists/quotes paper markets, and — for a
  * REAL trade — signs the canonical message for you (the only thing that proves
  * wallet ownership on the paper path). Reads need no signer. Uses global `fetch`
  * (Node ≥ 20). `viem` is an optional peer used only by {@link fromPrivateKey}.
@@ -36,7 +36,7 @@ export class CupClient {
             throw new Error("A signer is required for this action (claim/trade).");
         return this.signer;
     }
-    /** Claim 10,000 $pHUNCH once for the signer's wallet. */
+    /** Claim 10,000 $pUSDC once for the signer's wallet. */
     async createWallet() {
         const signer = this.requireSigner();
         return this.json("/api/cup/v1/wallet", {
@@ -100,7 +100,7 @@ export class CupClient {
         });
         return out.receipt;
     }
-    /** Typed wallet summary: balance + realized PnL + positions, all in $pHUNCH. */
+    /** Typed wallet summary: balance + realized PnL + positions, all in $pUSDC. */
     async getWallet(address) {
         const addr = address ?? this.signer?.address;
         if (!addr)
@@ -124,7 +124,7 @@ export class CupClient {
     }
     /**
      * One round of a built-in strategy WITH bankroll survival — the un-managed
-     * loop in the hosting docs went insolvent in ~20 minutes (250 $pHUNCH/round from
+     * loop in the hosting docs went insolvent in ~20 minutes (250 $pUSDC/round from
      * a finite no-top-up grant). This:
      *   • reads the live balance + open positions first (a `live` run);
      *   • skips markets the wallet is ALREADY positioned in (no re-piling);

package/dist/fleet.d.ts

@@ -13,7 +13,7 @@ export declare function fleetFilePath(): string;
 export declare function loadFleet(): Fleet;
 export declare function saveFleet(fleet: Fleet): string;
 /**
- * Mint `count` fresh wallets, claim each one's 10,000 $pHUNCH, and append them to
+ * Mint `count` fresh wallets, claim each one's 10,000 $pUSDC, and append them to
  * the fleet file with a rotating strategy. Idempotent claim (the server grants
  * once), so re-running only tops up the roster.
  */

package/dist/fleet.js

@@ -4,13 +4,13 @@
  *
  * A fleet is a set of throwaway wallets persisted to `~/.hunch-cup/fleet.json`
  * (override with `HUNCH_CUP_FLEET_FILE`). `fleetNew` mints N fresh wallets and
- * claims each one's 10,000 $pHUNCH; `fleetRun` runs a (possibly per-wallet mixed)
+ * claims each one's 10,000 $pUSDC; `fleetRun` runs a (possibly per-wallet mixed)
  * strategy loop across all of them concurrently; `fleetBoard` shows each wallet's
  * live rank. Keys never leave the local file.
  *
  * SECURITY: the file holds real (paper-only) private keys in plaintext — same
  * trust model as `HUNCH_CUP_PRIVATE_KEY`. These wallets only ever touch paper
- * $pHUNCH, never real funds.
+ * $pUSDC, never real funds.
  */
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
 import { homedir } from "node:os";
@@ -41,7 +41,7 @@ export function saveFleet(fleet) {
 /** A rotation of the built-in strategies, so a demo fleet is visibly diverse. */
 const STRATEGY_CYCLE = ["momentum", "contrarian", "news-reactive"];
 /**
- * Mint `count` fresh wallets, claim each one's 10,000 $pHUNCH, and append them to
+ * Mint `count` fresh wallets, claim each one's 10,000 $pUSDC, and append them to
  * the fleet file with a rotating strategy. Idempotent claim (the server grants
  * once), so re-running only tops up the roster.
  */

package/dist/message.js

@@ -4,7 +4,7 @@ export function buildCupTradeMessage(p) {
         `Wallet: ${p.walletAddress.toLowerCase()}`,
         `Market: ${p.slug}`,
         `Side: ${p.side}`,
-        `Size: ${p.sizePhunch} pHUNCH`,
+        `Size: ${p.sizePhunch} pUSDC`,
         `Trade: ${p.tradeId}`,
         `Issued: ${p.issuedAt}`,
     ].join("\n");

package/dist/strategy.js

@@ -27,10 +27,10 @@ function extreme(outcomes, want) {
             ? o
             : best).key;
 }
-/** The outcome label for a binary/direction pole (UP/DOWN vs YES/NO). */
-function sideFor(card, pole) {
-    if (card.direction)
-        return pole === "pos" ? "up" : "down";
+/** The outcome KEY for a binary/direction pole. Direction markets read UP/DOWN
+ * but their tradeable keys are the settlement keys yes/no (UP = yes) — the API
+ * rejects "up"/"down" via validSides. */
+function sideFor(_card, pole) {
     return pole === "pos" ? "yes" : "no";
 }
 /** The pool's favorite pole (ties → positive). */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hunch-cup",
-  "version": "0.2.0",
-  "description": "One-line CLI + typed SDK to paper-trade the Hunch Cup tournament: claim 1,000 $pHUNCH, trade live markets with zero real-funds risk, run momentum/contrarian/news-reactive agents, and climb the public leaderboard.",
+  "version": "0.2.2",
+  "description": "One-line CLI + typed SDK to paper-trade the Hunch Cup tournament: claim 10,000 $pUSDC, trade live markets with zero real-funds risk, run momentum/contrarian/news-reactive agents, and climb the public leaderboard.",
   "keywords": [
     "hunch",
     "hunch-cup",
@@ -9,7 +9,7 @@
     "paper-trading",
     "agents",
     "mcp",
-    "phunch"
+    "pusdc"
   ],
   "homepage": "https://www.playhunch.xyz/cup",
   "license": "MIT",