cross-prediction

cross-prediction

A Claude Code skill that drives the CROSS Prediction Market at prediction.crossdefi.io on CROSS Chain (chain id 612055). Lists active events, fetches event/market details with live orderbook prices, shows BILL + CROSS wallet balance + CTF Share holdings, reads settled market results, and places BILL-denominated YES/NO Share buy/sell through any of three interchangeable signing strategies.

• Stack: Node 20+, viem, Playwright (optional)
• Payment token: BILL (ERC-20 on CROSS Chain)
• Outcome representation: Conditional Token Framework (CTF) Shares
• Subcommands: list-events, get-event, get-results, balance, buy, sell
• Trading strategies: A (local PK + viem) · B (Playwright UI + PIN) · C (CROSSx gateway + PIN)
• Distribution: standalone Claude skill and Claude Code plugin

⚠️ This skill submits real EIP-712 orders that lock BILL collateral against outcome shares. Trades are DRY-RUN by default; use --live to actually submit. Always set MAX_TRADE_BILL in .env. Read skills/cross-prediction/SKILL.md and the relevant signer module before using.

---

Install — Recommended (via Marketplace)

/plugin marketplace add github.com/to-nexus/cross-skills-suite
/plugin install cross-prediction@cross-skills-suite

Part of the CROSS Skills Suite — installs alongside cross-dex-trade and other CROSS Chain ecosystem skills.

---

Install — Standalone

Option 1 — Plain skill (one user, fastest)

git clone https://github.com/to-nexus/skill-cross-prediction /tmp/skill-cross-prediction
bash /tmp/skill-cross-prediction/install.sh        # symlinks into ~/.claude/skills/

Option 2 — Claude Code plugin (marketplace-installable)

If you maintain a marketplace, add an entry pointing at this repo:

{
  "name": "cross-prediction",
  "source": { "source": "github", "repo": "to-nexus/skill-cross-prediction" },
  "category": "blockchain"
}

End users then run /plugin marketplace add <your-marketplace> then /plugin install cross-prediction.

---

Configuration

Copy the template and fill in the strategy-specific vars:

cp skills/cross-prediction/.env.example skills/cross-prediction/.env
chmod 600 skills/cross-prediction/.env

Required for all strategies:

Variable	Description
WALLET_ADDRESS	Your CROSS Chain EOA / embedded wallet address (0x + 40 hex)
MAX_TRADE_BILL	Per-trade BILL notional cap. Default 100; recommend 10 for new users

Strategy-specific:

Strategy	Vars	One-time setup
A — local viem	PRIVATE_KEY=0x… (64 hex)	none
B — Playwright UI	PIN=123456 (6 digit)	node scripts/_login-capture.mjs (writes .auth/state.json)
C — CROSSx gateway	PIN=123456 (6 digit)	node scripts/_recon-gateway.mjs (writes .session/gateway.json)

Optional: STRATEGY=A|B|C|auto to force a specific path. Default auto prefers A → B → C.

The skill resolves .env from (in order): cwd → ~/.claude/skills/cross-prediction/ → asks once.

---

Usage

Inside Claude Code, just describe in plain language:

• "list active prediction events"
• "BTC 1분 예측 이벤트 찾아줘"
• "show my BILL balance and active shares"
• "buy 10 YES shares of at max 0.55 BILL/share"
• "sell all my YES shares of "
• "show settled results for event "

Direct CLI (skipping Claude):

cd ~/.claude/skills/cross-prediction

# Read-only (works without any signer credentials)
node scripts/list-events.mjs --status ACTIVE --query "BTC"
node scripts/get-event.mjs <eventId>
node scripts/balance.mjs --with-shares
node scripts/get-results.mjs <eventId> --only-mine

# Trading — DRY-RUN by default
node scripts/buy.mjs  <marketId> UP 1
node scripts/sell.mjs <marketId> UP 1

# Trading — LIVE (auto-pick strategy from env)
node scripts/buy.mjs  <marketId> UP 1 --live
node scripts/buy.mjs  <marketId> UP 1 --live --strategy A   # force a specific strategy

All commands emit a single JSON object on stdout (txHash, status, explorer URL, chosen strategy and reason).

---

Layout