# Send Solana Swaps to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "solana-swaps",
    "name": "Solana Swaps",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/imthatcarlos/solana-swaps",
    "canonicalUrl": "https://clawhub.ai/imthatcarlos/solana-swaps",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/solana-swaps",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=solana-swaps",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "solana-swaps",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T07:05:33.029Z",
      "expiresAt": "2026-05-08T07:05:33.029Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=solana-swaps",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=solana-swaps",
        "contentDisposition": "attachment; filename=\"solana-swaps-0.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "solana-swaps"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/solana-swaps"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/solana-swaps",
    "downloadUrl": "https://openagent3.xyz/downloads/solana-swaps",
    "agentUrl": "https://openagent3.xyz/skills/solana-swaps/agent",
    "manifestUrl": "https://openagent3.xyz/skills/solana-swaps/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/solana-swaps/agent.md"
  }
}
```
## Documentation

### Solana Swaps

Manage your Solana wallet: check balances and swap tokens using the Jupiter aggregator.

### Environment Variables

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.

### Verify Setup

# Check wallet address
solana address --keypair "$SOLANA_KEYPAIR_PATH"

# Check Solana CLI config
solana config get

### Check SOL Balance

solana balance --keypair "$SOLANA_KEYPAIR_PATH"

### List All Token Accounts

spl-token accounts --owner $(solana address --keypair "$SOLANA_KEYPAIR_PATH")

### Check Specific Token Balance

spl-token balance <TOKEN_MINT_ADDRESS> --owner $(solana address --keypair "$SOLANA_KEYPAIR_PATH")

### Common Token Mint Addresses

TokenSymbolMint AddressDecimalsWrapped SOLSOLSo111111111111111111111111111111111111111129USD CoinUSDCEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v6TetherUSDTEs9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB6BonkBONKDezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB2635JupiterJUPJUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN6RaydiumRAY4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R6

### Token Swaps via Jupiter

CRITICAL: Always display swap details and wait for explicit user confirmation before executing any swap.

### Step 1: Get Quote

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 .

### Step 2: Display Quote and Request Confirmation

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.

### Step 3: Build Swap Transaction

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')

### Step 4: Sign and Submit Transaction

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.

### Safety Rules

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

### Error Handling

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

### Retry Logic

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

### Check Balance

User: "What's my SOL balance?"

Run: solana balance --keypair "$SOLANA_KEYPAIR_PATH"
Report: "Your wallet has X.XXX SOL"

### Swap Tokens

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

### List All Tokens

User: "Show me all my tokens"

Run: spl-token accounts --owner $(solana address --keypair "$SOLANA_KEYPAIR_PATH")
Format and display token list with balances
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: imthatcarlos
- Version: 0.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T07:05:33.029Z
- Expires at: 2026-05-08T07:05:33.029Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/solana-swaps)
- [Send to Agent page](https://openagent3.xyz/skills/solana-swaps/agent)
- [JSON manifest](https://openagent3.xyz/skills/solana-swaps/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/solana-swaps/agent.md)
- [Download page](https://openagent3.xyz/downloads/solana-swaps)