Solana Defi Agent

Solana DeFi Agent Skill

DeFi toolkit for AI agents on Solana — swaps, lending, staking, and more

New here? → Start with QUICKSTART.md for a 10-minute setup guide.

What This Does

Solana Blinks (Blockchain Links) let you execute DeFi operations—swaps, deposits, staking—through simple URLs. This skill gives you:

• CLI for quick operations: blinks execute <url> --amount=100
• SDK for building automations
• Registry access to 900+ trusted protocol endpoints

# Example: Deposit USDC to Kamino yield vault
blinks execute "https://kamino.dial.to/api/v0/lend/usdc-prime/deposit" --amount=100

⚠️ Before You Start

Required

• Solana wallet keypair file (see QUICKSTART.md)
• SOL for transaction fees (~0.01 SOL / $2 minimum)
• Node.js 18+

Environment Variables

# .env file
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
SOLANA_WALLET_PATH=~/.config/solana/my-wallet.json

🔒 Security

• Never commit keypairs to git - use .env and .gitignore
• Test with small amounts first - mistakes happen
• Verify hosts are trusted - CLI warns about untrusted hosts
• Use a dedicated wallet - not your main holdings

Protocol Status (Updated 2026-02-02)

✅ Working (7 protocols)

🔑 Needs API Key

⚠️ Web-Only (Cloudflare blocked)

Token & Market Discovery (NEW)

Find Any Token

# List 25+ common tokens with mint addresses
blinks tokens list

# Resolve symbol to mint
blinks tokens resolve BONK
# → DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263

# Search all verified tokens (network call)
blinks tokens search "dog"
# → WIF, MYRO, etc.

Available Vaults

# Kamino lending vaults
blinks vaults kamino
# → usdc-prime, sol-main, jitosol-main, etc.

Build URLs for Any Token

# Swap SOL → any token (Jupiter)
blinks build swap --from SOL --to WIF
blinks build swap --from SOL --to BONK --amount 1

# Swap with Raydium (requires amount)
blinks build swap --from SOL --to JUP --amount 0.5 --protocol raydium

# Kamino deposit/withdraw
blinks build deposit --vault usdc-prime --amount 100
blinks build withdraw --vault sol-main

# Jito staking
blinks build stake --amount 2

# NFT purchases
blinks build nft-buy --mint <nft-mint-address>
blinks build nft-buy --mint madlads --protocol tensor

Common Token Mints

Use blinks tokens list for the full list of 25+ tokens.

Quick Reference

Inspect Before Executing

Always preview what a blink does:

blinks inspect <url>

Shows metadata, available actions, and trust status.

Execute Transactions

# Dry run first (simulates without sending)
blinks execute <url> --amount=100 --dry-run

# Execute for real
blinks execute <url> --amount=100

Protocol-Specific Commands

# Kamino
blinks kamino deposit --vault=usdc-prime --amount=100
blinks kamino withdraw --vault=usdc-prime --amount=50

# Jito
blinks jito stake --amount=1

# Generic (any blink URL)
blinks execute "https://..." --amount=X

SDK Usage

Basic Execution

import {
  ActionsClient,
  BlinksExecutor,
  Wallet,
  getConnection,
  isHostTrusted,
} from '@openclaw/solana-defi-agent-skill';

// Initialize
const connection = getConnection();
const wallet = Wallet.fromEnv();
const actions = new ActionsClient();
const executor = new BlinksExecutor(connection);

// 1. Check if host is trusted
const trusted = await isHostTrusted('https://kamino.dial.to');
if (!trusted) throw new Error('Untrusted host!');

// 2. Get action metadata
const metadata = await actions.getAction(
  'https://kamino.dial.to/api/v0/lend/usdc-prime/deposit'
);
console.log('Available actions:', metadata.links.actions);

// 3. Get transaction
const tx = await actions.postAction(
  'https://kamino.dial.to/api/v0/lend/usdc-prime/deposit?amount=100',
  wallet.address
);

// 4. Simulate first
const sim = await executor.simulate(tx);
if (!sim.success) {
  throw new Error(`Simulation failed: ${sim.error}`);
}

// 5. Execute
const signature = await executor.signAndSend(tx, wallet.getSigner());
console.log('Success:', `https://solscan.io/tx/${signature}`);

Token Discovery & URL Building

import {
  // Token discovery
  COMMON_TOKENS,
  resolveTokenMint,
  searchToken,
  getJupiterTokenList,
  
  // Vault discovery
  getKaminoLendVaults,
  
  // URL builders (any token support)
  buildJupiterSwapUrl,
  buildRaydiumSwapUrl,
  buildKaminoDepositUrl,
  buildMagicEdenBuyUrl,
} from '@openclaw/solana-defi-agent-skill';

// Get mint address for any token
const bonkMint = COMMON_TOKENS.BONK;  // Known tokens
const anyMint = resolveTokenMint('JUP');  // Resolve symbol → mint

// Search for tokens
const dogTokens = await searchToken('dog');  // WIF, MYRO, etc.

// Build swap URL for any token pair
const swapUrl = buildJupiterSwapUrl('SOL', 'BONK', 1);
// → https://worker.jup.ag/blinks/swap/So111.../DezXA.../1

// Works with symbols OR mint addresses
const swapUrl2 = buildJupiterSwapUrl(
  'So11111111111111111111111111111111111111112',
  'DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263',
  0.5
);

// Get available vaults
const vaults = getKaminoLendVaults();
// → [{ slug: 'usdc-prime', name: 'USDC Prime', token: 'USDC' }, ...]

// Build NFT buy URL
const nftUrl = buildMagicEdenBuyUrl('GtQJmmYe...');

How Blinks Work

1. GET request to action URL → Returns metadata + available actions
2. POST request with wallet address → Returns transaction to sign
3. Sign transaction locally and submit to Solana

User → GET blink URL → Protocol returns actions
User → POST with wallet → Protocol returns transaction
User → Sign & submit → Transaction confirmed

The skill handles all of this. You just provide the URL and amount.

Troubleshooting

Blink URL Formats

The CLI accepts multiple formats:

# Direct URL (recommended)
blinks inspect "https://kamino.dial.to/api/v0/lend/usdc/deposit"

# Solana Action protocol
blinks inspect "solana-action:https://kamino.dial.to/..."

# dial.to interstitial
blinks inspect "https://dial.to/?action=solana-action:https://..."

RPC Recommendations

Public works for testing but will hit rate limits in production.

Files

solana-defi-agent-skill/
├── SKILL.md           # This file
├── QUICKSTART.md      # Beginner setup guide
├── README.md          # Package readme
├── .env.example       # Environment template
├── src/               # Source code
├── dist/              # Built CLI + SDK
├── docs/              # Protocol status, specs
└── tests/             # Protocol endpoint tests

Links

• QUICKSTART.md - Get started in 10 minutes
• Solana Actions Spec
• Dialect Registry - 900+ trusted hosts
• Blinks Inspector - Visual blink tester