solana-defi

name	solana-defi
description	Trade tokens on Solana via Jupiter and PumpPortal with an auto-provisioned wallet. Use when the user mentions Solana, DeFi, swaps, Jupiter, pump.fun, memecoins, SPL tokens, or Solana portfolio. ALWAYS use ~/scripts/ — never improvise.

Solana DeFi Trading

name: solana-defi
version: 1.0.0
updated: 2026-03-04
author: InstaClaw
phase: 1  # SKILL.md + wallet provisioning. Phase 2: Solana MCP server
triggers:
  keywords: [solana, defi, swap, jupiter, pump.fun, snipe, trade, token, spl, raydium, pumpportal, dexscreener, memecoin, bonk, wif, jup, sol]
  phrases: ["buy some", "sell some", "swap tokens", "snipe new launches", "check my balance", "what's in my wallet", "portfolio", "watch for new tokens", "pump.fun", "trade on solana", "buy memecoin", "token price", "new token launch"]
  NOT: [polymarket, kalshi, prediction market, stock market, base chain, ethereum]

MANDATORY RULES — Read Before Anything Else

These rules override everything else in this skill file. Violating them causes real financial harm. A real user's agent destroyed its own session by looping on failed trades 69 times until it couldn't respond. These rules prevent that.

Rule 0 — ALWAYS USE SCRIPTS: When a user mentions Solana trading, swaps, sniping, portfolio, or any related topic, IMMEDIATELY use the scripts in ~/scripts/. Do NOT improvise. Do NOT write ad-hoc Python or Node.js code for trading operations. Do NOT raw-dog curl calls to Jupiter or PumpPortal. You already have everything you need — scripts are pre-installed. Run the script first, show the output, then discuss. If unsure whether things are set up, run:

python3 ~/scripts/solana-balance.py check --json

Rule 1 — Maximum 3 Retries Per Operation: If a trade, API call, or script fails 3 times in a row:

• STOP immediately
• Tell the user exactly what failed and why
• Ask if they want you to try a different approach
• Do NOT retry a 4th time under any circumstances

Rule 2 — Context Budget: Never dump raw transaction data, full error stack traces, or complete API responses into the conversation. Always summarize:

• GOOD: "Bought 0.05 SOL of BONK at $0.00003 — tx: 4xK7m..."
• BAD: [pasting 200 lines of transaction JSON] Keep total trading-related context under 50KB per session.

Rule 3 — Error Classification:

TRANSIENT (retry with backoff 5s → 15s → 45s → STOP):

• HTTP 429 (rate limit)
• Network timeout
• RPC node congestion
• "blockhash not found" (retry with fresh blockhash)

PERMANENT (do NOT retry, tell user immediately):

• Insufficient funds / balance
• Invalid mint address
• Wallet not found
• Signature verification failed
• "Program failed to complete" (bad instruction)

DANGEROUS (stop ALL trading, alert user):

• 3+ consecutive empty responses
• Session file exceeding 200KB
• Process killed by SIGKILL (out of memory)
• Same error message appearing 5+ times

Rule 4 — Position Sizing:

• Check user's configured max trade size (default: 0.1 SOL)
• Check user's daily loss limit (default: 0.5 SOL)
• NEVER exceed these limits
• If no limits configured, use defaults and inform user
• Read limits from: python3 ~/scripts/solana-trade.py limits --json

Rule 5 — Confirmation Before Execution:

• ALWAYS tell the user what you're about to do before doing it
• Example: "I'm going to swap 0.1 SOL for BONK on Jupiter with 1% slippage. Estimated output: 3,450,000 BONK. Proceed?"
• Only skip confirmation if user has explicitly enabled auto-trade mode

Custody Modes: On-Box vs Secure Off-Box (READ THIS)

Your wallet is in ONE of two modes. The scripts detect which and route automatically; you never choose, and you must never try to override it.

Secure off-box mode (governed): your wallet's key lives in a secure signer OFF this box. There is NO private key on this box, and you must NEVER create one. Trades are sized in USD and go through the secure signer, which authorizes and price-bounds every swap so your funds are protected.

• Buy: python3 ~/scripts/solana-trade.py buy --mint <MINT> --amount-usd 10 --json
• Sell: python3 ~/scripts/solana-trade.py sell --mint <MINT> --amount-usd 10 --json
• A refusal is FINAL. The secure signer may decline a trade. There is no on-box key to fall back to. You must NEVER run setup-solana-wallet.py generate, write a key into .env, hand-build a raw swap, or improvise any other way to move funds around a refusal. Tell the user the reason (the script returns a message), and retry ONLY ONCE later, and only if the script says "retryable": true.
• Refusal meanings: unpriceable_input (no reliable price; suggest a more liquid token; do NOT retry), price_impact_too_high (thin liquidity; suggest a smaller size; do NOT retry), price_divergence / price_stale (prices unstable; retry once shortly), a budget / session / kill reason (an account limit; tell the user, do NOT retry). Direct pump.fun sniping is NOT available off-box; use standard buy/sell, which routes through the secure signer.

On-box mode (legacy): a key is in ~/.openclaw/.env and trades are sized in SOL (--amount). This is today's behavior and is unchanged. Never display the key.

Commands

Balance & Wallet

Action	Command
Check balance	python3 ~/scripts/solana-balance.py check --json
SOL balance only	python3 ~/scripts/solana-balance.py sol --json
Token balances	python3 ~/scripts/solana-balance.py tokens --json
Wallet address	python3 ~/scripts/setup-solana-wallet.py address
Wallet status	python3 ~/scripts/setup-solana-wallet.py status --json

Trading (Jupiter V6)

Action	Command
Get quote	python3 ~/scripts/solana-trade.py quote --input SOL --output <MINT> --amount 0.1 --json
Buy token	python3 ~/scripts/solana-trade.py buy --mint <MINT> --amount 0.1 --slippage 100 --json
Sell token	python3 ~/scripts/solana-trade.py sell --mint <MINT> --amount ALL --slippage 100 --json
Check limits	python3 ~/scripts/solana-trade.py limits --json

Sniping (PumpPortal)

Action	Command
Buy on pump.fun	python3 ~/scripts/solana-snipe.py buy --mint <MINT> --amount 0.05 --slippage 2500 --json
Sell on pump.fun	python3 ~/scripts/solana-snipe.py sell --mint <MINT> --amount ALL --slippage 2500 --json
Watch launches	python3 ~/scripts/solana-snipe.py watch --min-sol 5 --max-age 60 --json

Portfolio & Positions

Action	Command
Portfolio summary	python3 ~/scripts/solana-positions.py summary --json
Position details	python3 ~/scripts/solana-positions.py detail --mint <MINT> --json
P&L report	python3 ~/scripts/solana-positions.py pnl --json
Trade history	python3 ~/scripts/solana-positions.py history --limit 20 --json

Price Data (DexScreener)

Action	Command
Token price	python3 ~/scripts/solana-balance.py price --mint <MINT> --json
Search token	python3 ~/scripts/solana-balance.py search --query "bonk" --json

Wallet Management

Check Wallet Status

Before any trading operation, verify wallet setup:

1. Run python3 ~/scripts/setup-solana-wallet.py status --json
2. If wallet exists: check SOL balance, report to user
3. If no wallet: tell user "You don't have a wallet set up yet. Enable Solana DeFi Trading in your dashboard at instaclaw.io/dashboard."

NEVER display or log the private key

On a secure off-box wallet there is NO private key on this box to display, retrieve, or regenerate; if asked, say the key is held by the secure signer off the machine and is never exposed, and never run any command to create one. On a legacy on-box wallet the key is in ~/.openclaw/.env; still never display it (say it is stored securely on the VM and you cannot show it).

Common Token Mint Addresses

Token	Mint Address
SOL (native)	So11111111111111111111111111111111111111112
USDC	EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
USDT	Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB
BONK	DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
WIF	EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm
JUP	JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN

Output Formatting

Trade Executed

✅ [BUY/SELL] [amount] [token] at $[price]
   tx: [first 8 chars]... | confirmed in [X]s
   Wallet balance: [remaining SOL] SOL

Trade Failed

❌ [action] failed: [1-line reason]
   Attempt [X/3]. [Next action: retrying in Xs / stopping / asking you]

Portfolio Summary

📊 Your Portfolio (as of [time])
   SOL: [balance] ($[usd])
   [TOKEN1]: [balance] ($[usd]) [+/-X%]
   [TOKEN2]: [balance] ($[usd]) [+/-X%]
   Total: ~$[total_usd]

Tiered Capabilities

Tier 1 — Read Only (Default)

• Check wallet balance
• View token prices
• Search tokens
• View portfolio
• No trading, no risk

Tier 2 — Manual Trading (Requires user confirmation per trade)

• Swap tokens via Jupiter
• Buy/sell on pump.fun via PumpPortal
• All trades require explicit user confirmation
• Position sizing enforced

Tier 3 — Autonomous Monitoring (Requires auto_trade=true)

• Watch for new pump.fun launches
• Auto-buy within configured limits
• Monitor and auto-sell based on rules
• Stop after 3 failed trades or daily loss limit hit
• Report all activity to user

Cross-Skill Integration

Prediction Markets + Trading

• Use Polymarket/Kalshi odds to inform token trades
• "Polymarket shows 85% chance of [event]. Buy [related token]?"

Web Search + Trading

Before buying unknown tokens:

• Search for token contract address, creator history
• Check X/Twitter for sentiment
• Verify project exists and isn't a known scam

File Paths

Path	Purpose
~/.openclaw/skills/solana-defi/SKILL.md	This file
~/.openclaw/skills/solana-defi/references/	API reference docs
~/scripts/setup-solana-wallet.py	Wallet generation/status
~/scripts/solana-trade.py	Jupiter V6 trading
~/scripts/solana-balance.py	Balance + price checks
~/scripts/solana-positions.py	Portfolio + P&L
~/scripts/solana-snipe.py	PumpPortal sniping
~/.openclaw/.env	On-box wallet key, LEGACY mode only (NEVER display); absent on secure off-box wallets
~/.openclaw/solana-defi/OFFBOX_CUSTODY	Present on secure off-box wallets; marks governed mode + the wallet address