Skill metadata
Reference: full SKILL.md
The following is the complete skill definition that Mibyan loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.
Solana Blockchain Skill
Query Solana on-chain data enriched with USD pricing via CoinGecko. 8 commands: wallet portfolio, token info, transactions, activity, NFTs, whale detection, network stats, and price lookup. No API key needed. Uses only Python standard library (urllib, json, argparse).When to Use
- User asks for a Solana wallet balance, token holdings, or portfolio value
- User wants to inspect a specific transaction by signature
- User wants SPL token metadata, price, supply, or top holders
- User wants recent transaction history for an address
- User wants NFTs owned by a wallet
- User wants to find large SOL transfers (whale detection)
- User wants Solana network health, TPS, epoch, or SOL price
- User asks “what’s the price of BONK/JUP/SOL?”
Prerequisites
The helper script uses only Python standard library (urllib, json, argparse). No external packages required. Pricing data comes from CoinGecko’s free API (no key needed, rate-limited to ~10-30 requests/minute). For faster lookups, use--no-prices flag.
Quick Reference
RPC endpoint (default): https://api.mainnet-beta.solana.com Override: export SOLANA_RPC_URL=https://your-private-rpc.com Helper script path: ~/.mibyan/skills/blockchain/solana/scripts/solana_client.pyProcedure
0. Setup Check
1. Wallet Portfolio
Get SOL balance, SPL token holdings with USD values, NFT count, and portfolio total. Tokens sorted by value, dust filtered, known tokens labeled by name (BONK, JUP, USDC, etc.).--limit N— show top N tokens (default: 20)--all— show all tokens, no dust filter, no limit--no-prices— skip CoinGecko price lookups (faster, RPC-only)
2. Transaction Details
Inspect a full transaction by its base58 signature. Shows balance changes in both SOL and USD.3. Token Info
Get SPL token metadata, current price, market cap, supply, decimals, mint/freeze authorities, and top 5 holders.4. Recent Activity
List recent transactions for an address (default: last 10, max: 25).5. NFT Portfolio
List NFTs owned by a wallet (heuristic: SPL tokens with amount=1, decimals=0).6. Whale Detector
Scan the most recent block for large SOL transfers with USD values.7. Network Stats
Live Solana network health: current slot, epoch, TPS, supply, validator version, SOL price, and market cap.8. Price Lookup
Quick price check for any token by mint address or known symbol.Pitfalls
- CoinGecko rate-limits — free tier allows ~10-30 requests/minute.
Price lookups use 1 request per token. Wallets with many tokens may
not get prices for all of them. Use
--no-pricesfor speed. - Public RPC rate-limits — Solana mainnet public RPC limits requests. For production use, set SOLANA_RPC_URL to a private endpoint (Helius, QuickNode, Triton).
- NFT detection is heuristic — amount=1 + decimals=0. Compressed NFTs (cNFTs) and Token-2022 NFTs won’t appear.
- Whale detector scans latest block only — not historical. Results vary by the moment you query.
- Transaction history — public RPC keeps ~2 days. Older transactions may not be available.
- Token names — ~25 well-known tokens are labeled by name. Others
show abbreviated mint addresses. Use the
tokencommand for full info. - Retry on 429 — both RPC and CoinGecko calls retry up to 2 times with exponential backoff on rate-limit errors.

