@moonpay/cli 1.44.1 → 1.46.0

package/skills/moonpay-missions/SKILL.md

@@ -1,154 +1,274 @@
 ---
 name: moonpay-missions
-description: A series of missions that walk through every MoonPay CLI capability. Use when the user is new or says "get started", "show me what you can do", or "run the missions".
-tags: [setup]
+description: A guided walkthrough showing every MoonPay CLI capability end-to-end, in the order a real user would touch them — fund with USDC (zero-fee stablecoins), swap into a private-company prestock, build an index fund, bridge cross-chain, settle a Kalshi prediction-market position, and check out from a Shopify store. Use when the user is new or says "get started", "show me what you can do", or "run the missions".
+tags: [setup, demo]
 ---
 
 # MoonPay Missions
 
-Walk the user through a series of missions. Complete each one before moving to the next. After each mission, give a brief summary of what they just did and what's next.
+Guided walkthrough that exercises every MoonPay CLI capability against the user's real wallet. Each mission proposes one thing, executes when the user agrees, gives a 1-2 sentence take, then proposes the next.
 
-## Mission 1: Identity
+This is the **showcase** — when someone says "what can you do?", run this. Skip with "skip"; jump ahead with "next" or "go".
 
-**Goal:** Verify who you are and what wallets you have.
+## Conduct rules
+
+- **Be concise.** Short responses. No walls of text.
+- **No preamble.** Don't say "Let me do X" — just do it. Action first, brief summary after.
+- **Handle errors gracefully.** If something fails, say "Let's skip ahead" and propose the next mission.
+- **Don't ask for confirmation** before running `moonpay` commands — just execute. Exception: anything that costs real money the user hasn't already agreed to.
+- **Show and explain.** Before each `moonpay` command, say in one short sentence what you're about to run and why. After it runs, point out the one or two key fields in the output.
+- **Cheat codes allowed.** Pre-verified token addresses and market IDs are in this file. Still *run* the discovery command — but use the known values when picking from results, don't stall comparing options.
+
+## Wallet to use
+
+Default to the **funded-sol** wallet for everything unless the user says otherwise.
+
+| | |
+|---|---|
+| Wallet name | `funded-sol` |
+| Solana | `GmmrYv28CQhKjJsPcpHZuspfJSKcDwGdECeYdiDLfW12` |
+
+Other addresses are visible via `mp wallet retrieve --wallet funded-sol`.
+
+## Pre-flight (silent — run before Mission 1)
 
 ```bash
 mp user retrieve
 mp wallet list
 ```
 
-If no wallets exist, create one:
+Confirm the user is authed and `funded-sol` exists. If not, fall back to whatever wallet the user has. If they have none, run `mp wallet create --name "main"` and use that. Don't narrate this step — just do it and roll into Mission 1.
+
+---
+
+## Mission 1 — Fund the wallet with USDC (zero-fee stablecoins)
+
+**Propose:** "Want me to top up your wallet with some USDC? Heads-up — MoonPay just made stablecoin onramps zero-fee, so $50 fiat in is $50 USDC out. No spread, no card fee."
+
+**Why this is the lead:** the zero-fee stablecoin pitch is the strongest thing MoonPay ships right now. Everything downstream (swap, prediction markets, commerce) works against the USDC we just funded.
+
+**On yes:**
 
 ```bash
-mp wallet create --name "main"
+mp buy --token usdc --amount 50 --wallet GmmrYv28CQhKjJsPcpHZuspfJSKcDwGdECeYdiDLfW12 --email <user-email>
 ```
 
-Tell the user their email, all wallet addresses (Solana, Ethereum, Bitcoin, Tron), and that keys are encrypted locally with a random key in the OS keychain.
+This returns a checkout URL. Open it (the desktop app intercepts the click; in CLI use `open "<url>"`).
+
+**Summary:** "Checkout's open — fiat → USDC, zero-fee onramp. Once the order settles, $50 USDC lands on Solana." Mention that the user can check `mp token balance list --wallet funded-sol --chain solana` after the checkout completes to confirm.
+
+**Next:** "Now that you've got USDC, want me to put some of it into Anthropic? It's trading as a prestock on Solana right now."
+
+---
 
-## Mission 2: Recon
+## Mission 2 — PreStock: Swap USDC → ANTHRP
 
-**Goal:** See what's trending and research a token.
+**On yes:**
+
+Step 1 — Discover:
 
 ```bash
-mp token trending list --chain solana --limit 5 --page 1
+mp token search --query "anthropic" --chain solana
 ```
 
-Present the top trending tokens. Then ask the user to pick one to research:
+Confirm `Anthropic PreStocks` (symbol `ANTHRP`) at `Pren1FvFX6J3E4kXhJuCiAD5aDmGEb7qJRncwA8Lkhw`. Add ONE sentence on what a prestock is — tokenized exposure to a private company pre-IPO, tradable 24/7 on Solana.
+
+Step 2 — Swap USDC → ANTHRP:
 
 ```bash
-mp token search --query "<token>" --chain solana
-mp token retrieve --token <address-from-search> --chain solana
+mp token swap \
+  --wallet funded-sol --chain solana \
+  --from-token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --to-token Pren1FvFX6J3E4kXhJuCiAD5aDmGEb7qJRncwA8Lkhw \
+  --from-amount 5
 ```
 
-Present: name, symbol, price, market cap, liquidity, volume.
+(`EPjFWdd5...` = USDC on Solana.)
+
+**Summary:** "Just bought Anthropic pre-IPO from the terminal — one search, one swap, fractional private-company exposure on Solana. The CLI built the route, signed locally (key never left this machine), and broadcast."
+
+**Next:** "If one prestock is cool, a whole basket is cooler — want me to build you the Elon Musk index fund?"
+
+---
+
+## Mission 3 — The Elon Musk Index Fund
 
-## Mission 3: Portfolio Check
+**Trigger:** The user might also kick this off verbatim ("hey claude build the elon musk index fund"). When they do, just build it — $5 each into SpaceX, Neuralink, and TSLA. Don't stall on amount or composition.
 
-**Goal:** See what's in the wallet across chains.
+**Propose (if not user-triggered):** "Want me to build you the Elon Musk index fund? SpaceX and Neuralink prestocks plus Tesla xStock — $5 into each, $15 total. Two private companies pre-IPO, one public stock, all on Solana."
+
+**On yes:**
+
+Step 1 — Discover (run all three in parallel):
 
 ```bash
-mp token balance list --wallet <solana-address> --chain solana
-mp token balance list --wallet <eth-address> --chain ethereum
-mp bitcoin balance retrieve --wallet <btc-address>
+mp token search --query "spacex" --chain solana
+mp token search --query "neuralink" --chain solana
+mp token search --query "tesla" --chain solana
 ```
 
-Present holdings as a multi-chain portfolio report with USD values and total.
+Step 2 — Identify from results (cheat codes for picking):
 
-## Mission 4: Swap
+| Asset | Symbol | Mint |
+|---|---|---|
+| SpaceX PreStock | SPACEX | `PreANxuXjsy2pvisWWMNB6YaJNzr7681wJJr2rHsfTh` |
+| Neuralink PreStocks | NEURALINK | `PrekqLJvJ3qVdXmBGDiexvwUTF4rLFDa6HWS4HJbw9S` |
+| Tesla xStock | TSLAx | `XsDoVfqeBukxuZHWhdvWHBhgEHjGNst4MLodqsJHzoB` |
 
-**Goal:** Execute a swap end-to-end.
-
-Pick a small swap based on what the wallet holds:
+Step 3 — Swap $5 USDC into each (run all three in parallel):
 
 ```bash
-mp token swap \
-  --wallet main --chain solana \
-  --from-token So11111111111111111111111111111111111111111 \
-  --from-amount 0.01 \
-  --to-token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
+mp token swap --wallet funded-sol --chain solana \
+  --from-token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --to-token PreANxuXjsy2pvisWWMNB6YaJNzr7681wJJr2rHsfTh --from-amount 5
+```
+```bash
+mp token swap --wallet funded-sol --chain solana \
+  --from-token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --to-token PrekqLJvJ3qVdXmBGDiexvwUTF4rLFDa6HWS4HJbw9S --from-amount 5
+```
+```bash
+mp token swap --wallet funded-sol --chain solana \
+  --from-token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --to-token XsDoVfqeBukxuZHWhdvWHBhgEHjGNst4MLodqsJHzoB --from-amount 5
 ```
 
-This builds, signs locally, and broadcasts in one step. Show the result and explain: the transaction was built on the server, signed locally (key never left the machine), and submitted on-chain.
+**Summary:** "Elon Musk index fund is live — $15 AUM, three holdings, one prompt. Two private companies pre-IPO and a public stock, all settled on Solana. Vanguard could never."
+
+**Next:** "Want to move some money cross-chain? I can bridge USDC from Solana to TON in one command."
 
-Three commands for moving tokens:
-- **`mp token swap`** — same chain, different tokens (e.g. SOL → USDC)
-- **`mp token bridge`** — cross chain (e.g. ETH on Ethereum → USDC on Polygon)
-- **`mp token transfer`** — same chain, same token, different wallet (e.g. send USDC to a friend)
+---
 
-## Mission 5: Buy with Fiat
+## Mission 4 — Cross-chain bridge: Solana → TON
 
-**Goal:** Generate a fiat checkout link.
+**On yes:**
 
 ```bash
-mp buy --token sol --amount 1 --wallet <solana-address> --email <email>
+mp token bridge \
+  --from-wallet funded-sol \
+  --from-chain solana --from-token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --from-amount 2 \
+  --to-chain ton --to-token EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs
 ```
 
-Open the checkout URL. Explain: MoonPay's fiat gateway for buying crypto with card or bank transfer.
+(`EPjFWdd5...` = USDC on Solana. `EQCxE6mU...` = USDT on TON.)
+
+**Summary:** "Solana → TON, signed locally, bridged cross-chain. USDC out, USDT on TON in. The CLI handled the route + the swap on the destination."
+
+**Next:** "NBA playoffs are heating up — want me to check Kalshi for the title?"
+
+---
+
+## Mission 5 — Prediction markets: Kalshi NBA
 
-## Mission 6: Message Signing
+**On yes:**
 
-**Goal:** Sign a message to prove wallet ownership.
+Step 1 — Search:
 
 ```bash
-mp message sign --wallet main --chain solana --message "I own this wallet"
+mp prediction-market market search --provider kalshi --query "NBA"
 ```
 
-Present the signature. Explain: used for wallet verification (e.g. registering with virtual accounts, proving ownership to dApps).
+Step 2 — Look at the `KXNBA-26` series ("Pro Basketball Champion — 2026"). Find sub-markets with `acceptingOrders: true` and real `bestAsk` prices. Pick one with a story — a heavy favorite (OKC, Boston) for clean execution, or a value underdog if the spread looks juicy.
 
-## Mission 7: Virtual Account (optional)
+Step 3 — Quick take on the market — implied probability, whether the price looks fair.
 
-**Goal:** Check if the user has a virtual account for fiat on/off-ramp.
+Step 4 — Then: "Want me to grab some shares?"
 
 ```bash
-mp virtual-account retrieve
+mp prediction-market position buy \
+  --provider kalshi \
+  --tokenId <yes-tokenId> \
+  --price <bestAsk> \
+  --size <shares> \
+  --wallet funded-sol
 ```
 
-If they have one, show the status and next step. If not, explain what it is and that they can set one up with `mp virtual-account create`.
+⚠️ Kalshi settles in USD on Solana — no Polygon gas needed. `size * price` must be ≥ $1.
 
-## Mission 8: Prediction Markets
+**Summary:** "Done — NBA title position placed from the terminal. No browser, no signup form, no second account."
 
-**Goal:** Browse prediction markets and understand how they work.
+**Next:** "One more — want me to buy you something from a Shopify store with crypto?"
+
+---
+
+## Mission 6 — Headless commerce: buy a shirt with USDC
+
+**On yes:**
+
+Step 1 — Search products:
 
 ```bash
-mp prediction-market market trending list --provider polymarket --limit 5
+mp commerce product search --store shop.hel.io --query ""
 ```
 
-Pick an interesting market and get details:
+Step 2 — Find "Helio Classic BLACK" ($0.10), variant ID: `gid://shopify/ProductVariant/55220565016953`.
+
+Step 3 — Add to cart and checkout with funded-sol wallet:
 
 ```bash
-mp prediction-market market event retrieve --provider polymarket --slug <slug-from-trending>
+mp commerce cart add --variantId <variant-id> --quantity 1
+mp commerce checkout --wallet funded-sol
 ```
 
-Explain: prediction markets let you buy shares on outcomes. Price = implied probability. Shares pay $1 if the outcome resolves YES. Supports Polymarket (Polygon/USDC.e) and Kalshi (Solana/USDC).
+**Summary:** "Just bought you a physical shirt for 10 cents with Solana Pay — fully headless, no browser, no checkout page."
 
-## Mission 9: Skills
+**Closing line:** "That's funding with zero-fee USDC, prestocks, an index fund built in parallel, cross-chain bridging, prediction markets, and headless commerce — all one CLI, one AI, natural language."
+
+---
 
-**Goal:** Show what skills are available and how to manage them.
+## Optional Mission 7 — Virtual Account: EUR onramp + payment link
+
+Use this if the user wants to see the open-banking side, or if they say "show me the EUR thing" / "fiat onramp."
+
+**On yes:**
+
+Step 1 — Create the EUR onramp:
 
 ```bash
-# List all bundled skills
-mp skill list
+mp virtual-account onramp create \
+  --name "Demo EUR Onramp" \
+  --fiat EUR \
+  --stablecoin EURC \
+  --wallet N39jn2g1tA7dmdyyoHt9yiQegQoVhnfQzq1ZzuZRF9e \
+  --chain solana
+```
 
-# View a specific skill's instructions
-mp skill retrieve --name moonpay-prediction-market
+⚠️ Use uppercase `EUR` and `EURC`. The wallet `N39jn2g1tA7dmdyyoHt9yiQegQoVhnfQzq1ZzuZRF9e` should already be registered on the user's virtual account; if not, run `mp virtual-account wallet add` first.
 
-# Install all skills to Claude Code's skills directory
-mp skill install
+Step 2 — Create a payment link from the onramp ID returned in step 1:
+
+```bash
+mp virtual-account onramp payment create --onrampId <id> --amount 10 --fiat EUR
 ```
 
-Explain: skills are guides that teach agents how to use the CLI for specific tasks. `mp skill list` shows all available skills. `mp skill retrieve --name <skill>` shows the full instructions for a specific skill. `mp skill install` copies all skills to `~/.claude/skills/` so Claude Code loads them automatically.
+Step 3 — Open the `paymentLink` URL.
+
+**Summary:** "Live open-banking payment link — EUR goes in, EURC comes out on Solana."
+
+---
+
+## Recap (after the last mission, or whenever the user says "recap")
+
+You just exercised the full MoonPay surface end-to-end:
+
+- **1. Fund** — fiat → USDC via zero-fee stablecoin onramp
+- **2. Prestock** — Anthropic pre-IPO from one swap
+- **3. Index fund** — three-asset basket built in parallel
+- **4. Bridge** — USDC Solana → USDT TON
+- **5. Prediction markets** — Kalshi NBA position settled in USD
+- **6. Commerce** — headless Shopify checkout with crypto
+
+Plus optional Mission 7: virtual-account EUR onramp + payment link.
+
+One CLI, one chat, one wallet. Real money, real chains.
+
+## Skip / next / start commands
 
-## Debrief
+- **"skip"** → move to the next mission immediately, skip the summary.
+- **"next"** / **"go"** / **"start"** → propose the next mission as if mid-flow.
+- **"recap"** → run the recap above.
 
-Summarize everything:
-- Set up a multi-chain HD wallet (encrypted, OS keychain secured)
-- Searched and analyzed tokens
-- Checked portfolio across Solana, Ethereum, Bitcoin
-- Executed a swap (built, signed locally, broadcast)
-- Generated a fiat buy link
-- Signed a message for verification
-- Explored virtual accounts
-- Browsed prediction markets
-- Discovered and installed skills
+## Tone
 
-End with: "You're all set. Run `mp --help` to see all commands, or ask me anything."
+Casual, confident, like a capable assistant who knows what's available. Not robotic, not overly formal, no slides. The whole point is to feel like a normal day-to-day chat that happens to settle real money on real chains.

package/skills/moonpay-polymarket/SKILL.md

@@ -0,0 +1,140 @@
+---
+name: moonpay-polymarket
+description: Trade on Polymarket — search markets, buy/sell outcome shares, track positions and PnL. Polymarket runs on Polygon and settles in USDC.e. Use when the user names Polymarket explicitly, or wants politics, crypto, news, or general-events markets (Polymarket's strength).
+tags: [trading, prediction-market, polymarket]
+---
+
+# Polymarket
+
+The largest prediction-market venue. Settles on Polygon in USDC.e. Strong on **politics, news, crypto, and general events**.
+
+## Prerequisites
+
+1. Authenticate: `mp login --email <email>` then `mp verify --email <email> --code <code>`
+2. EVM wallet (any chain): `mp wallet list` (or create with `mp wallet create --name "main"`). The same EVM address works for Polygon.
+3. Register the wallet with Polymarket (one-time):
+
+```bash
+mp prediction-market user create --provider polymarket --wallet <evm-address>
+```
+
+4. Fund the Polygon wallet with USDC.e and a tiny amount of POL for gas. Use **moonpay-fund-polymarket** for the recommended path.
+
+## Browse and research
+
+```bash
+# Search by keyword
+mp prediction-market market search --provider polymarket --query "bitcoin" --limit 10
+
+# Trending (by 24h volume, min $150k)
+mp prediction-market market trending list --provider polymarket --limit 10
+
+# Browse tags / categories
+mp prediction-market market tag list --provider polymarket
+
+# Filter by tag
+mp prediction-market market search --provider polymarket --query "*" --tagIds "crypto,politics"
+
+# Full event details (every market under the event, all outcomes + prices)
+mp prediction-market market event retrieve --provider polymarket --slug <event-slug>
+
+# Live price for a single outcome token
+mp prediction-market market price retrieve --provider polymarket --tokenId <token-id>
+
+# Price history for an outcome
+mp prediction-market market price-history list --provider polymarket --tokenId <token-id> --interval 1w
+```
+
+## Buy / sell
+
+```bash
+# Buy YES shares
+mp prediction-market position buy \
+  --wallet main \
+  --provider polymarket \
+  --tokenId <outcome-token-id> \
+  --price 0.65 \
+  --size 100
+
+# Sell shares
+mp prediction-market position sell \
+  --wallet main \
+  --provider polymarket \
+  --tokenId <outcome-token-id> \
+  --price 0.70 \
+  --size 50
+```
+
+**Concepts:**
+- `tokenId` comes from `outcomeTokens[].tokenId` in market search results.
+- `price` is 0-1 (e.g., 0.65 = 65¢ per share, implies 65% probability).
+- `size` is the share count.
+- Cost = price × size (so 0.65 × 100 = $65 USDC.e).
+- If the outcome resolves YES, each share pays $1 → profit = (1 − price) × size.
+- `negRisk` markets use a different settlement framework — the CLI handles this automatically.
+
+## Track + close positions
+
+```bash
+mp prediction-market position list --provider polymarket --wallet <address>
+mp prediction-market position list --provider polymarket --wallet <address> --status closed
+mp prediction-market pnl retrieve --provider polymarket --wallet <address>
+mp prediction-market trade list --provider polymarket --wallet <address>
+mp prediction-market activity list --provider polymarket --wallet <address>
+
+# Redeem winning shares after a market resolves
+mp prediction-market position redeem --provider polymarket --wallet main --tokenId <token-id>
+```
+
+## Example flow
+
+```bash
+# 1. Find
+mp prediction-market market search --provider polymarket --query "bitcoin 200k"
+
+# 2. Drill into the event
+mp prediction-market market event retrieve --provider polymarket --slug <slug-from-search>
+
+# 3. Sanity-check the chart
+mp prediction-market market price-history list --provider polymarket --tokenId <yes-token-id> --interval 1w
+
+# 4. Buy 50 YES at 40¢
+mp prediction-market position buy --wallet main --provider polymarket --tokenId <yes-token-id> --price 0.40 --size 50
+
+# 5. Confirm
+mp prediction-market position list --provider polymarket --wallet <address>
+
+# 6. Exit later at 60¢
+mp prediction-market position sell --wallet main --provider polymarket --tokenId <yes-token-id> --price 0.60 --size 50
+```
+
+## Price-history intervals
+
+| Interval | Range |
+|---|---|
+| `1hr` | Last hour |
+| `1d` | Last day |
+| `1w` | Last week |
+| `1m` | Last month |
+| `max` | All time |
+
+## Tips
+
+- Use `mp --json prediction-market ...` for programmatic output (the `--json` flag is global, BEFORE the subcommand).
+- Markets with higher volume have tighter spreads — check the `volume24h` field.
+- Verify `acceptingOrders: true` before trading; closed markets reject orders.
+- Polymarket = Polygon = USDC.e. NOT regular USDC. Bridging USDC → USDC.e is a separate step.
+- A few cents of POL is enough for hundreds of trades.
+
+## When to choose Polymarket vs Kalshi
+
+- **Polymarket** — politics, crypto, news, world events. Largest catalog, deepest liquidity.
+- **Kalshi** — sports, economic indicators, US-regulated events. Settles in regular USDC on Solana, no bridging required.
+
+## Related skills
+
+- **moonpay-kalshi** — sports + US-regulated markets on Solana
+- **moonpay-fund-polymarket** — fund USDC.e + POL on Polygon
+- **moonpay-check-wallet** — check Polygon balances
+- **moonpay-swap-tokens** — bridge USDC → USDC.e on Polygon
+- **moonpay-trading-automation** — automate prediction-market strategies