@moonpay/cli 0.5.2 → 0.6.1

package/skills/moonpay-block-explorer/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: moonpay-block-explorer
+description: Open transactions, wallets, and tokens in the correct block explorer. Use after swaps, bridges, or transfers to view results in the browser.
+tags: [explorer]
+---
+
+# Block explorer
+
+## Goal
+
+After any swap, bridge, or transfer, open the result in the correct block explorer. Also useful for viewing wallet addresses and token contract pages.
+
+## Explorer URLs
+
+| Chain | Transaction | Wallet | Token |
+|-------|------------|--------|-------|
+| solana | `https://solscan.io/tx/{sig}` | `https://solscan.io/account/{addr}` | `https://solscan.io/token/{addr}` |
+| ethereum | `https://etherscan.io/tx/{hash}` | `https://etherscan.io/address/{addr}` | `https://etherscan.io/token/{addr}` |
+| base | `https://basescan.org/tx/{hash}` | `https://basescan.org/address/{addr}` | `https://basescan.org/token/{addr}` |
+| polygon | `https://polygonscan.com/tx/{hash}` | `https://polygonscan.com/address/{addr}` | `https://polygonscan.com/token/{addr}` |
+| arbitrum | `https://arbiscan.io/tx/{hash}` | `https://arbiscan.io/address/{addr}` | `https://arbiscan.io/token/{addr}` |
+| optimism | `https://optimistic.etherscan.io/tx/{hash}` | `https://optimistic.etherscan.io/address/{addr}` | `https://optimistic.etherscan.io/token/{addr}` |
+| bnb | `https://bscscan.com/tx/{hash}` | `https://bscscan.com/address/{addr}` | `https://bscscan.com/token/{addr}` |
+| avalanche | `https://snowscan.xyz/tx/{hash}` | `https://snowscan.xyz/address/{addr}` | `https://snowscan.xyz/token/{addr}` |
+| bitcoin | `https://mempool.space/tx/{txid}` | `https://mempool.space/address/{addr}` | — |
+
+## Open a transaction
+
+After a swap or bridge, extract the chain and tx hash, then open:
+
+```bash
+# macOS
+open "https://solscan.io/tx/5rQ52JVb6q7H..."
+
+# Linux
+xdg-open "https://etherscan.io/tx/0xabcd..."
+```
+
+### From swap/bridge output
+
+`mp token swap` and `mp token bridge` return a result with the transaction signature. Use the chain to pick the correct explorer.
+
+```bash
+RESULT=$(mp -f compact token swap --wallet main --chain solana \
+  --from-token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --from-amount 1 \
+  --to-token So11111111111111111111111111111111111111111)
+
+# Open in browser
+SIG=$(echo "$RESULT" | jq -r '.signature')
+open "https://solscan.io/tx/$SIG"
+```
+
+### From transaction list
+
+`mp transaction list` returns transactions with `from.txHash` and `to.txHash`. Use the chain field to pick the explorer:
+
+```bash
+# View most recent transaction
+TX=$(mp -f compact transaction list --wallet <addr> | jq -r '.items[0].from.txHash')
+CHAIN=$(mp -f compact transaction list --wallet <addr> | jq -r '.items[0].from.chain')
+# Build URL from chain → explorer table above
+```
+
+## Open a wallet
+
+View all on-chain activity for a wallet address:
+
+```bash
+# Solana wallet
+open "https://solscan.io/account/N39jn2g1tA7dmdyyoHt9yiQegQoVhnfQzq1ZzuZRF9e"
+
+# EVM wallet (same address works on any EVM explorer)
+open "https://etherscan.io/address/0xf9e39F70d7636902e57a89C18B1BE39EBb5b9589"
+```
+
+Get wallet addresses from: `mp wallet list` or `mp wallet retrieve --wallet <name>`
+
+## Open a token page
+
+View token contract, holders, and market data on the explorer:
+
+```bash
+# USDC on Solana
+open "https://solscan.io/token/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
+
+# USDC on Ethereum
+open "https://etherscan.io/token/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
+```
+
+Get token addresses from: `mp token search --query "USDC" --chain solana`
+
+## Open a checkout URL
+
+`mp buy` returns a checkout URL. Open it directly:
+
+```bash
+URL=$(mp -f compact buy --token sol --amount 1 --wallet <addr> --email <email> | jq -r '.url')
+open "$URL"
+```
+
+## Platform detection
+
+```bash
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  open "$URL"
+else
+  xdg-open "$URL"
+fi
+```
+
+## Tips
+
+- After any swap, bridge, or transfer, offer to open the result in the explorer
+- EVM wallets share one address across all EVM chains — the same address works on etherscan, basescan, polygonscan, etc.
+- Bitcoin uses `mempool.space` — no token pages, just transactions and addresses
+- Solana signatures are base58 strings, EVM tx hashes start with `0x`
+
+## Related skills
+
+- **moonpay-swap-tokens** — Swap and bridge commands that produce transaction signatures
+- **moonpay-buy-crypto** — Buy commands that return checkout URLs
+- **moonpay-check-wallet** — Get wallet addresses to view on explorers

package/skills/moonpay-buy-crypto/SKILL.md

@@ -22,7 +22,7 @@ mp buy \
 
 ## Supported tokens
 
-`sol`, `usdc_sol`, `eth`, `usdc`, `usdc_base`, `usdc_arbitrum`, `usdc_optimism`, `usdc_polygon`, `eth_polygon`, `eth_optimism`, `eth_base`, `eth_arbitrum`
+`btc`, `sol`, `eth`, `trx`, `pol_polygon`, `usdc`, `usdc_sol`, `usdc_base`, `usdc_arbitrum`, `usdc_optimism`, `usdc_polygon`, `usdt_trx`, `eth_polygon`, `eth_optimism`, `eth_base`, `eth_arbitrum`
 
 ## Example flow
 

package/skills/moonpay-export-data/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: moonpay-export-data
+description: Export portfolio balances and transaction history to CSV or JSON files. Use for spreadsheets, tax reporting, or record-keeping.
+tags: [portfolio, export]
+---
+
+# Export data
+
+## Goal
+
+Save portfolio snapshots and transaction history to CSV or JSON files using `mp` output piped through `jq`. Useful for spreadsheets, tax reporting, and record-keeping.
+
+## Prerequisites
+
+- `jq` installed: `which jq`
+- Default output directory: `~/Documents/moonpay/` (create if needed)
+
+## Portfolio to CSV
+
+Export all token balances for a wallet on a specific chain:
+
+```bash
+mkdir -p ~/Documents/moonpay
+
+# Header + data
+echo "symbol,name,amount,usd_value,price" > ~/Documents/moonpay/portfolio-$(date +%Y%m%d).csv
+
+mp -f compact token balance list --wallet <address> --chain solana \
+  | jq -r '.items[] | [.symbol, .name, .balance.amount, .balance.value, .balance.price] | @csv' \
+  >> ~/Documents/moonpay/portfolio-$(date +%Y%m%d).csv
+```
+
+### Multi-chain portfolio
+
+Loop over chains and append to one file:
+
+```bash
+FILE=~/Documents/moonpay/portfolio-$(date +%Y%m%d).csv
+echo "chain,symbol,name,amount,usd_value,price" > "$FILE"
+
+for CHAIN in solana ethereum base polygon arbitrum; do
+  mp -f compact token balance list --wallet <address> --chain "$CHAIN" \
+    | jq -r --arg chain "$CHAIN" '.items[] | [$chain, .symbol, .name, .balance.amount, .balance.value, .balance.price] | @csv' \
+    >> "$FILE" 2>/dev/null
+done
+```
+
+Note: EVM wallets share one address across all EVM chains. Solana uses a different address.
+
+## Transaction history to CSV
+
+Export swap and bridge history. These are transactions executed via the CLI and registered with swaps.xyz — not all on-chain activity.
+
+```bash
+echo "date,type,from_chain,from_token,from_amount,to_chain,to_token,to_amount,usd,status" \
+  > ~/Documents/moonpay/transactions-$(date +%Y%m%d).csv
+
+mp -f compact transaction list --wallet <address> \
+  | jq -r '.items[] | [
+      .transactionId,
+      .type,
+      .from.chain, .from.token, .from.amount,
+      .to.chain, .to.token, .to.amount,
+      .usd,
+      .status
+    ] | @csv' \
+  >> ~/Documents/moonpay/transactions-$(date +%Y%m%d).csv
+```
+
+### Filter by chain
+
+```bash
+mp -f compact transaction list --wallet <address> --chain solana \
+  | jq -r '.items[] | ...' >> transactions.csv
+```
+
+## Portfolio to JSON
+
+For structured data or programmatic use:
+
+```bash
+mp -f compact token balance list --wallet <address> --chain solana \
+  | jq '.items | map({symbol, amount: .balance.amount, usd: .balance.value})' \
+  > ~/Documents/moonpay/portfolio-$(date +%Y%m%d).json
+```
+
+## Open exported file
+
+After writing the file, open it in the default app:
+
+```bash
+# macOS — opens in Numbers/Excel
+open ~/Documents/moonpay/portfolio-$(date +%Y%m%d).csv
+
+# Linux
+xdg-open ~/Documents/moonpay/portfolio-$(date +%Y%m%d).csv
+```
+
+## Tips
+
+- `jq @csv` handles proper CSV escaping (quotes, commas in values)
+- Date-stamp filenames to keep a history: `portfolio-20260222.csv`
+- `mp transaction list` only includes CLI-executed swaps/bridges registered via swaps.xyz, not all on-chain transactions
+- For a quick summary without exporting, use `mp token balance list --wallet <addr> --chain <chain>` directly
+- EVM address is the same across ethereum, base, polygon, arbitrum, optimism, bnb, avalanche
+
+## Related skills
+
+- **moonpay-check-wallet** — View balances interactively
+- **moonpay-block-explorer** — Open exported transactions in block explorers
+- **moonpay-trading-automation** — Combine with scheduled exports for daily snapshots

package/skills/moonpay-mcp/SKILL.md

@@ -14,7 +14,8 @@ Configure the MoonPay CLI as an MCP server so Claude Desktop, Claude Code, or an
 
 ```bash
 npm i -g @moonpay/cli
-mp login
+mp login --email user@example.com
+mp verify --email user@example.com --code <code>
 ```
 
 ## Claude Code setup
@@ -56,7 +57,7 @@ After setup, ask Claude: "What MoonPay tools do you have?" — it should list al
 
 ## Auth
 
-The MCP server uses the same credentials as the CLI (`~/.config/moonpay/credentials.json`). Run `mp login` to authenticate.
+The MCP server uses the same credentials as the CLI (`~/.config/moonpay/credentials.json`). Run `mp login --email <email>` then `mp verify --email <email> --code <code>` to authenticate.
 
 ## Related skills
 

package/skills/moonpay-polymarket-ready/SKILL.md

@@ -51,7 +51,7 @@ If the wallet already has POL and USDC.e, they're set.
 Buy POL directly with fiat — easiest way to get gas on Polygon:
 
 ```bash
-mp buy --token pol --amount 5 --wallet <eth-address> --email <email>
+mp buy --token pol_polygon --amount 5 --wallet <eth-address> --email <email>
 ```
 
 Alternatively, bridge ETH → POL if the user already has ETH:

package/skills/moonpay-price-alerts/SKILL.md

@@ -0,0 +1,167 @@
+---
+name: moonpay-price-alerts
+description: Set up desktop price alerts that notify you when tokens hit target prices. Observe-only — no trading, just notifications.
+tags: [alerts, research]
+---
+
+# Price alerts
+
+## Goal
+
+Monitor token prices and get desktop notifications when they cross a threshold. Uses `mp token retrieve` for price checks and OS notifications (`osascript`/`notify-send`) for alerts. Observe-only — no funds at risk.
+
+## Prerequisites
+
+- `mp` binary on PATH: `which mp`
+- `jq` installed: `which jq`
+- macOS: `osascript` (built-in) or Linux: `notify-send` (`sudo apt install libnotify-bin`)
+
+## One-shot alert
+
+"Tell me when SOL drops below $80" — checks every 5 minutes, fires once, then disables itself.
+
+### Script: `~/.config/moonpay/scripts/alert-sol-below-80.sh`
+
+```bash
+#!/bin/bash
+set -euo pipefail
+
+MP="$(which mp)"
+LOG="$HOME/.config/moonpay/logs/alerts.log"
+mkdir -p "$(dirname "$LOG")"
+log() { echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] $*" >> "$LOG"; }
+
+# --- Config ---
+TOKEN="So11111111111111111111111111111111111111111"
+CHAIN="solana"
+SYMBOL="SOL"
+TARGET=80
+DIRECTION="below"  # "above" or "below"
+SCRIPT_NAME="alert-sol-below-80"
+
+# --- Check price ---
+PRICE=$("$MP" -f compact token retrieve --token "$TOKEN" --chain "$CHAIN" | jq -r '.marketData.price')
+
+if [ -z "$PRICE" ] || [ "$PRICE" = "null" ]; then
+  log "ALERT $SCRIPT_NAME: price fetch failed, skipping"
+  exit 0
+fi
+
+# --- Compare ---
+TRIGGERED=false
+if [ "$DIRECTION" = "below" ] && (( $(echo "$PRICE < $TARGET" | bc -l) )); then
+  TRIGGERED=true
+elif [ "$DIRECTION" = "above" ] && (( $(echo "$PRICE > $TARGET" | bc -l) )); then
+  TRIGGERED=true
+fi
+
+if [ "$TRIGGERED" = true ]; then
+  MSG="$SYMBOL is $DIRECTION \$$TARGET — currently \$$PRICE"
+  log "ALERT $SCRIPT_NAME: $MSG"
+
+  # Desktop notification
+  if [[ "$OSTYPE" == "darwin"* ]]; then
+    osascript -e "display notification \"$MSG\" with title \"MoonPay Alert\" sound name \"Glass\""
+  else
+    notify-send "MoonPay Alert" "$MSG"
+  fi
+
+  # Self-disable (one-shot)
+  if [[ "$OSTYPE" == "darwin"* ]]; then
+    launchctl unload "$HOME/Library/LaunchAgents/com.moonpay.${SCRIPT_NAME}.plist" 2>/dev/null || true
+  else
+    crontab -l | grep -v "$SCRIPT_NAME" | crontab -
+  fi
+  log "ALERT $SCRIPT_NAME: disabled after trigger"
+else
+  log "ALERT $SCRIPT_NAME: $SYMBOL at \$$PRICE — not triggered ($DIRECTION $TARGET)"
+fi
+```
+
+### Schedule
+
+Check every 5 minutes:
+
+```bash
+# cron (Linux)
+*/5 * * * * ~/.config/moonpay/scripts/alert-sol-below-80.sh # moonpay:alert-sol-below-80
+
+# launchd (macOS) — use StartInterval of 300 seconds in the plist
+```
+
+Launchd plist at `~/Library/LaunchAgents/com.moonpay.alert-sol-below-80.plist`:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.moonpay.alert-sol-below-80</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/bin/bash</string>
+    <string>/Users/USERNAME/.config/moonpay/scripts/alert-sol-below-80.sh</string>
+  </array>
+  <key>StartInterval</key>
+  <integer>300</integer>
+  <key>StandardErrorPath</key>
+  <string>/Users/USERNAME/.config/moonpay/logs/alert-sol-below-80.err</string>
+</dict>
+</plist>
+```
+
+Load: `launchctl load ~/Library/LaunchAgents/com.moonpay.alert-sol-below-80.plist`
+
+**Important:** Replace `USERNAME` with the actual username. Tilde does not expand in plist files.
+
+## Recurring alert
+
+"Alert me every hour while ETH is above $2000" — keeps firing on each check, doesn't self-disable.
+
+Same script as above but remove the self-disable block. The alert fires every time the condition is met, until the user manually removes it.
+
+## Managing alerts
+
+### List active alerts
+
+```bash
+# macOS
+launchctl list | grep moonpay
+
+# Linux
+crontab -l | grep moonpay
+```
+
+### Remove an alert
+
+```bash
+# macOS
+launchctl unload ~/Library/LaunchAgents/com.moonpay.alert-sol-below-80.plist
+rm ~/Library/LaunchAgents/com.moonpay.alert-sol-below-80.plist
+
+# Linux
+crontab -l | grep -v "alert-sol-below-80" | crontab -
+```
+
+### View alert history
+
+```bash
+tail -50 ~/.config/moonpay/logs/alerts.log
+```
+
+## Tips
+
+- Price checks via `mp token retrieve` are free — no gas costs
+- 5-minute intervals are reasonable; don't go below 1 minute
+- Use `mp token search --query "SOL" --chain solana` to resolve token addresses
+- Alerts log to `~/.config/moonpay/logs/alerts.log` — check this to verify they're running
+- The machine must be logged in for notifications and keychain access to work
+- `bc -l` handles decimal comparison; if unavailable, use `awk "BEGIN {exit !($PRICE < $TARGET)}"`
+- This skill is observe-only — for automated buying/selling, see **moonpay-trading-automation**
+
+## Related skills
+
+- **moonpay-trading-automation** — Automated trading (DCA, limit orders, stop losses)
+- **moonpay-discover-tokens** — Research tokens and get current prices
+- **moonpay-check-wallet** — Check portfolio before setting alerts