Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Swap tokens on Solana via Jupiter aggregator and check wallet balances. Use when user wants to swap tokens, check SOL/token balance, or get swap quotes.
Swap tokens on Solana via Jupiter aggregator and check wallet balances. Use when user wants to swap tokens, check SOL/token balance, or get swap quotes.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Manage your Solana wallet: check balances and swap tokens using the Jupiter aggregator.
These environment variables are pre-configured and available for use: VariableDescriptionSOLANA_KEYPAIR_PATHPath to wallet keypair JSON fileJUPITER_API_KEYJupiter API key for authenticated requests (avoids platform fees, required for Token2022/pump.fun tokens) Note: These are already set in the skill config. Just use $SOLANA_KEYPAIR_PATH and $JUPITER_API_KEY directly in commands.
# Check wallet address solana address --keypair "$SOLANA_KEYPAIR_PATH" # Check Solana CLI config solana config get
solana balance --keypair "$SOLANA_KEYPAIR_PATH"
spl-token accounts --owner $(solana address --keypair "$SOLANA_KEYPAIR_PATH")
spl-token balance <TOKEN_MINT_ADDRESS> --owner $(solana address --keypair "$SOLANA_KEYPAIR_PATH")
TokenSymbolMint AddressDecimalsWrapped SOLSOLSo111111111111111111111111111111111111111129USD CoinUSDCEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v6TetherUSDTEs9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB6BonkBONKDezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB2635JupiterJUPJUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN6RaydiumRAY4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R6
CRITICAL: Always display swap details and wait for explicit user confirmation before executing any swap.
Convert human-readable amounts to raw units: SOL: multiply by 1,000,000,000 (10^9) USDC/USDT: multiply by 1,000,000 (10^6) BONK: multiply by 100,000 (10^5) # Example: Get quote for swapping 1 SOL to USDC INPUT_MINT="So11111111111111111111111111111111111111112" OUTPUT_MINT="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" AMOUNT="1000000000" # 1 SOL in lamports SLIPPAGE_BPS="50" # 0.5% slippage # Get quote with API key authentication curl -s -H "x-api-key: $JUPITER_API_KEY" \ "https://api.jup.ag/swap/v1/quote?inputMint=${INPUT_MINT}&outputMint=${OUTPUT_MINT}&amount=${AMOUNT}&slippageBps=${SLIPPAGE_BPS}" | jq .
Parse the quote response and display to user: Input: amount and token name Output: expected amount and token name Price impact percentage Slippage tolerance Minimum received (otherAmountThreshold) IMPORTANT: Ask user "Do you want to proceed with this swap?" and wait for explicit confirmation ("yes", "proceed", "confirm") before continuing.
After user confirms, request the swap transaction: USER_PUBKEY=$(solana address --keypair "$SOLANA_KEYPAIR_PATH") # Save quote response to file QUOTE_FILE="/tmp/jupiter_quote.json" curl -s -H "x-api-key: $JUPITER_API_KEY" \ "https://api.jup.ag/swap/v1/quote?inputMint=${INPUT_MINT}&outputMint=${OUTPUT_MINT}&amount=${AMOUNT}&slippageBps=${SLIPPAGE_BPS}" > "$QUOTE_FILE" # Request swap transaction curl -s -X POST \ -H "x-api-key: $JUPITER_API_KEY" \ -H "Content-Type: application/json" \ "https://api.jup.ag/swap/v1/swap" \ -d "{ \"quoteResponse\": $(cat $QUOTE_FILE), \"userPublicKey\": \"${USER_PUBKEY}\", \"dynamicComputeUnitLimit\": true, \"prioritizationFeeLamports\": { \"priorityLevelWithMaxLamports\": { \"maxLamports\": 5000000, \"priorityLevel\": \"high\" } } }" > /tmp/jupiter_swap.json # Extract the swap transaction SWAP_TX=$(cat /tmp/jupiter_swap.json | jq -r '.swapTransaction')
Use the jupiter-swap.mjs script to sign and submit: node "$(dirname "$0")/scripts/jupiter-swap.mjs" \ --keypair "$SOLANA_KEYPAIR_PATH" \ --transaction "$SWAP_TX" The script will output the transaction signature and a Solscan link.
ALWAYS display swap details and wait for user confirmation before executing NEVER execute swaps automatically without explicit approval ALWAYS check balance before attempting swaps to ensure sufficient funds WARN users if price impact exceeds 1% WARN users if slippage is set above 1% (100 bps) NEVER log, display, or transmit private key contents
ErrorCauseSolution"Insufficient balance"Not enough input tokensCheck balance, reduce swap amount"Slippage tolerance exceeded"Price moved during swapGet fresh quote, consider higher slippage"Transaction expired"Blockhash too oldGet fresh quote and retry immediately"Account not found"Missing token accountToken account will be created automatically"Route not found"No liquidity for pairTry smaller amount or different token"Platform fee not supported"Token2022 tokens block platform feesUse authenticated API with $JUPITER_API_KEY header
If a swap fails due to network issues: Wait 2-3 seconds Get a fresh quote (prices may have changed) Re-confirm with user showing new quote Retry the swap
User: "What's my SOL balance?" Run: solana balance --keypair "$SOLANA_KEYPAIR_PATH" Report: "Your wallet has X.XXX SOL"
User: "Swap 0.5 SOL for USDC" Get wallet address Fetch Jupiter quote for 0.5 SOL (500000000 lamports) -> USDC Display quote details: From: 0.5 SOL To: ~XX.XX USDC (estimated) Price Impact: X.XX% Minimum Received: XX.XX USDC Ask: "Do you want to proceed with this swap?" Wait for confirmation On "yes": Execute swap, report transaction link On "no": Acknowledge cancellation
User: "Show me all my tokens" Run: spl-token accounts --owner $(solana address --keypair "$SOLANA_KEYPAIR_PATH") Format and display token list with balances
Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.
Largest current source with strong distribution and engagement signals.