@moonpay/cli 0.3.1 → 0.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moonpay/cli",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "publishConfig": {
     "access": "public"
   },

package/skills/moonpay-missions/SKILL.md

@@ -0,0 +1,124 @@
+---
+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]
+---
+
+# MoonPay Orientation
+
+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.
+
+## Mission 1: Identity
+
+**Goal:** Verify who you are and what wallets you have.
+
+```bash
+mp user retrieve
+mp wallet list
+```
+
+If no wallets exist, create one:
+
+```bash
+mp wallet create --name "my-wallet"
+```
+
+Tell the user their email, wallet address, and that this wallet's private key lives locally on their machine.
+
+## Mission 2: Recon
+
+**Goal:** Search for a token and pull up its intel.
+
+Ask the user to pick a token (or default to SOL). Then:
+
+```bash
+mp token search --query "<token>" --chain solana
+mp token retrieve --token <address-from-search> --chain solana
+```
+
+Present: name, symbol, price, 24h change, market cap, liquidity, volume, and trading activity. Flag anything interesting (high volume, thin liquidity, etc).
+
+## Mission 3: Portfolio Check
+
+**Goal:** See what's in the wallet.
+
+```bash
+mp token balance list --wallet <address> --chain solana
+```
+
+Present holdings as a mini portfolio report: each token, amount, USD value, and % allocation. Give the total portfolio value.
+
+## Mission 4: Swap
+
+**Goal:** Build a swap transaction, sign it locally, and show the quote.
+
+Pick a small swap based on what the wallet holds (e.g. 0.01 USDC → SOL). If the wallet has no USDC, pick any token pair that makes sense.
+
+```bash
+mp token swap build --input <input-mint> --output <output-mint> --amount <small-amount> --wallet <address>
+```
+
+Show the quote from the `message` field. Ask the user: **"Want to execute this swap?"**
+
+If yes:
+
+```bash
+mp transaction sign --transaction <tx> --wallet <address>
+mp token swap execute --transaction <signed-tx> --requestId <id>
+```
+
+If no, move on. Either way, explain what just happened: the transaction was built on the server, signed locally (key never left the machine), and submitted on-chain.
+
+## Mission 5: Buy with Fiat
+
+**Goal:** Generate a fiat checkout link.
+
+```bash
+mp buy --token sol --amount 1 --wallet <address> --email <email-from-mission-1>
+```
+
+Present the checkout URL. Explain: this opens MoonPay's fiat gateway where they can pay with a card or bank transfer. Tokens get sent to their wallet.
+
+## Mission 6: Message Signing
+
+**Goal:** Sign a message to prove wallet ownership.
+
+```bash
+mp message sign --wallet <address> --message "I own this wallet"
+```
+
+Present the signature. Explain: this is used for wallet verification (e.g. registering with virtual accounts, proving ownership to dApps).
+
+## Mission 7: Virtual Account (optional)
+
+**Goal:** Check if the user has a virtual account for fiat on/off-ramp.
+
+```bash
+mp virtual-account retrieve
+```
+
+If they have one, show the status and next step. If not, explain what a virtual account is (KYC-verified fiat bridge) and that they can set one up with `mp virtual-account create`.
+
+## Mission 8: Skills
+
+**Goal:** Show the user what skills are available.
+
+```bash
+mp skill list
+```
+
+Explain: skills are guides that teach agents how to use the CLI. They can install them for Claude Code with `mp skill install`.
+
+## Debrief
+
+Summarize everything the user just did:
+- Authenticated and set up a wallet
+- Searched and analyzed tokens
+- Checked portfolio
+- Built and signed a swap (and maybe executed it)
+- Generated a fiat buy link
+- Signed a message
+- Explored virtual accounts
+- Discovered skills
+
+End with: "You're oriented. Run `mp --help` to see all commands, or ask me anything."