@moonpay/cli 0.5.1 → 0.6.0

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-polymarket-ready/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: moonpay-polymarket-ready
+description: Fund a Polygon wallet for Polymarket trading. Buy POL for gas and bridge or buy USDC.e so the wallet is ready to trade.
+tags: [trading, setup]
+---
+
+# Polymarket ready
+
+## Goal
+
+Get a Polygon wallet funded with POL (gas) and USDC.e (trading) so it's ready for Polymarket.
+
+Polymarket runs on Polygon. To trade, the user needs:
+- **POL** — native gas token for transaction fees
+- **USDC.e** (`0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174`) — the token Polymarket uses for bets
+
+## Key addresses
+
+| Token | Chain | Address |
+|-------|-------|---------|
+| POL (native) | Polygon | `0x0000000000000000000000000000000000000000` |
+| USDC.e | Polygon | `0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174` |
+| ETH (native) | Ethereum | `0x0000000000000000000000000000000000000000` |
+
+## Workflow
+
+### 1. Check or create wallet
+
+```bash
+mp wallet list
+```
+
+The user's Polygon address is the same as their Ethereum address (EVM wallets share one address across all EVM chains).
+
+If no wallets exist, create one:
+
+```bash
+mp wallet create --name main
+```
+
+### 2. Check existing Polygon balances
+
+```bash
+mp token balance list --wallet <eth-address> --chain polygon
+```
+
+If the wallet already has POL and USDC.e, they're set.
+
+### 3. Get POL for gas
+
+Buy POL directly with fiat — easiest way to get gas on Polygon:
+
+```bash
+mp buy --token pol_polygon --amount 5 --wallet <eth-address> --email <email>
+```
+
+Alternatively, bridge ETH → POL if the user already has ETH:
+
+```bash
+mp token bridge \
+  --from-wallet <wallet-name> --from-chain ethereum \
+  --from-token 0x0000000000000000000000000000000000000000 \
+  --from-amount 0.001 \
+  --to-chain polygon \
+  --to-token 0x0000000000000000000000000000000000000000
+```
+
+~$2-5 worth of POL covers hundreds of transactions.
+
+### 4. Get USDC.e for trading
+
+Bridge ETH on Ethereum to USDC.e on Polygon in one step:
+
+```bash
+mp token bridge \
+  --from-wallet <wallet-name> --from-chain ethereum \
+  --from-token 0x0000000000000000000000000000000000000000 \
+  --from-amount 0.005 \
+  --to-chain polygon \
+  --to-token 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174
+```
+
+Alternatively, if the user already has USDC on Ethereum, bridge it directly:
+
+```bash
+mp token bridge \
+  --from-wallet <wallet-name> --from-chain ethereum \
+  --from-token 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 \
+  --from-amount 10 \
+  --to-chain polygon \
+  --to-token 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174
+```
+
+### 5. Verify
+
+```bash
+mp token balance list --wallet <eth-address> --chain polygon
+```
+
+Confirm both POL and USDC.e are present.
+
+## Tips
+
+- Bridge times from Ethereum → Polygon are typically 5-20 seconds
+- POL is very cheap for gas — a few dollars covers hundreds of transactions
+- The fiat buy option (`mp buy`) is the fastest path if the user has no crypto yet
+
+## Related skills
+
+- **moonpay-swap-tokens** — Bridge commands and supported chains
+- **moonpay-check-wallet** — Check Polygon balances
+- **moonpay-buy-crypto** — Buy POL or ETH with fiat

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