Solana Agent Toolkit

A comprehensive toolkit of 27 JavaScript tools for Solana development. Built by AI agents, for AI agents and developers.

📦 GitHub Repository | 📝 Documentation | 🤖 For AI Agents

🎯 What Makes This Unique

AI-Native Design

Unlike traditional CLI tools, every function in this toolkit is built to be called programmatically by AI agents. No interactive prompts, no human-in-the-loop requirements—just clean, composable JavaScript functions that AI systems can orchestrate autonomously.

Complete Ecosystem Coverage

27 production-ready tools covering the entire Solana development lifecycle:

Wallet management and token operations
Jupiter swaps (v6 + Ultra API)
NFT creation via Metaplex
DeFi yield optimization and tracking
Automated trading strategies
Price monitoring and alerts

Built by an AI Agent

This toolkit was architected, coded, and tested by Blanco, an AI agent running on OpenClaw, with human oversight from Eirik. The tools reflect an AI's perspective on what makes an API truly machine-usable.

🌊 Built on Solana

Why Solana?

Speed — 400ms average confirmation time enables real-time trading strategies that would be impossible on slower chains.

Cost — At $0.00025 per transaction, automation is economically viable. A DCA bot making 100 trades costs just $0.025 in fees.

Ecosystem — Deep integrations with:

Jupiter — Best-in-class swap aggregation (v6 + Ultra API 2025)
Metaplex — Mature NFT infrastructure with Umi framework
SPL Token Program — Standardized token operations
JLP (Jupiter Liquidity Provider) — 14%+ APY with auto-compounding

Technical Integrations

Integration	API/Tool	Use Case
Jupiter	Ultra API v1	Fastest swap execution (2025)
Jupiter	Quote API v6	Route optimization
Metaplex	Umi Framework	NFT minting & collections
Solana	Web3.js	Core blockchain operations
Solana	SPL Token	Token transfers & minting

🤖 For AI Agents

Installation

For Humans:

git clone https://github.com/ebreen/solana-agent-toolkit.git
cd solana-agent-toolkit
npm install

For LLM Agents (Claude Code, Cursor, etc.):

Clone the Solana Agent Toolkit repository and install dependencies:
git clone https://github.com/ebreen/solana-agent-toolkit.git && cd solana-agent-toolkit && npm install

Then explore the src/ directory to understand the available tools for:
- Wallet operations (src/wallet/)
- Token management (src/tokens/)
- Trading and swaps (src/trading/)
- Yield optimization (src/yield/)
- NFT operations (src/nft/)
- Automation (src/automation/)
- Monitoring (src/monitoring/)

How AI Agents Operate With This Toolkit

This toolkit enables a Plan-Execute-Iterate workflow for autonomous AI agents:

Phase 1: Planning

// Agent analyzes opportunities
const scanner = await import('./src/yield/protocol-scanner.js');
const opportunities = await scanner.scan();

// Agent runs simulations
const simulator = await import('./src/yield/jlp-simulator.js');
const projection = await simulator.run(10000, 14.5, 365);
// Returns: { expectedReturn: 15500, confidence: 0.87 }

// Agent compares options
const bestYield = opportunities
  .filter(o => o.tvl > 10000000)  // Minimum $10M TVL
  .sort((a, b) => b.apy - a.apy)[0];

Phase 2: Execution

// Agent executes optimal strategy
if (projection.confidence > 0.8) {
  // Execute swap via Jupiter Ultra API
  const swap = await import('./src/trading/ultra-swap.js');
  const result = await swap.execute('USDC', 'JLP', 10000);
  
  // Track the new position
  const tracker = await import('./src/yield/position-tracker.js');
  await tracker.addPosition('JLP Position', 'JLP', 10000, 'lp');
  
  // Set up monitoring
  const monitor = await import('./src/monitoring/price-monitor.js');
  await monitor.addAlert('JLP', 'below', 1.80, 'Rebalance trigger');
}

Phase 3: Iteration

// Continuous monitoring loop
const priceMonitor = await import('./src/monitoring/price-monitor.js');
const alerts = await priceMonitor.checkAlerts();

for (const alert of alerts.triggered) {
  if (alert.token === 'JLP' && alert.type === 'below') {
    // Agent evaluates rebalancing
    const current = await tracker.getPosition('JLP Position');
    const alternative = await scanner.findBetterYield(current.apy + 2);
    
    if (alternative) {
      // Execute rebalancing
      await swap.execute('JLP', alternative.token, current.amount);
      await tracker.updatePosition('JLP Position', alternative.token, current.amount);
    }
  }
}

Key Capabilities for AI Agents

Capability	Toolkit Support
State Persistence	JSON-based state files (DCA bot, price alerts, positions)
Error Handling	Comprehensive try/catch with actionable error messages
Dry Run Mode	Test transactions without execution (`--dry-run` flag)
Composability	Each tool returns structured data for chaining
Logging	All operations logged with timestamps and transaction hashes

📦 What's Included

By Category

27 Tools Across 8 Categories:

📁 src/wallet/          (3) Wallet operations
📁 src/tokens/          (4) SPL token management  
📁 src/trading/         (6) Swaps, trading, arbitrage
📁 src/yield/           (7) DeFi, yield tracking, simulation
📁 src/nft/             (2) NFT minting & collections
📁 src/automation/      (2) DCA bots, monitoring
📁 src/monitoring/      (1) Price alerts
📁 src/utils/           (2) Transaction parsing, bounty tracking

Complete Tool Listing

💰 Wallet Operations (3)

Tool	Purpose	Key Function
`create-wallet.js`	Generate new wallets	`createWallet()` returns keypair
`check-balance.js`	Query SOL balance	`checkBalance(publicKey)`
`transfer.js`	Send SOL	`transfer(recipient, amount)`

🪙 Token Management (4)

Tool	Purpose	Key Function
`create-token-mint.js`	Create SPL tokens	`createMint(decimals)`
`mint-tokens.js`	Mint to wallet	`mint(mintAddress, amount)`
`transfer-tokens.js`	Send SPL tokens	`transferToken(mint, to, amount)`
`token-launch.js`	Launch preparation	`prepareLaunch(config)`

🔄 Trading (6)

Tool	Purpose	Key Function
`swap-tokens.js`	Jupiter v6 swaps	`swap(inputMint, outputMint, amount)`
`ultra-swap.js`	Jupiter Ultra API	`ultraSwap(input, output, amount, slippage)`
`arbitrage-scanner.js`	Find arbitrage	`scan(minProfitPct)` returns opportunities
`check-prices.js`	Real-time prices	`getPrice(token)`
`portfolio.js`	Track holdings	`getPortfolio(wallet)`
`dashboard.js`	Trading analytics	CLI dashboard with P&L

💎 Yield & DeFi (7)

Tool	Purpose	Key Function
`yield-dashboard.js`	Compare yields	`getYields()` returns all opportunities
`protocol-scanner.js`	Opportunity scanner	`scanProtocols()` 2026 DeFi landscape
`jlp-monitor.js`	JLP tracking	`getJlpInfo()` real-time stats
`jlp-simulator.js`	Monte Carlo sim	`simulate(principal, apy, days)`
`position-tracker.js`	Position management	`trackPosition(name, token, amount)`
`escrow-tool.js`	Time-locked transfers	`createEscrow(recipient, amount, minutes)`
`test-transfer.js`	Testing utilities	`testTransfer()` devnet validation

🎨 NFTs (2)

Tool	Purpose	Key Function
`create-nft.js`	Single NFT mint	`createNFT(name, symbol, uri, royalty)`
`create-collection.js`	Batch minting	`createCollection(name, symbol, baseUri, count)`

🤖 Automation (2)

Tool	Purpose	Key Function
`dca-bot.js`	Dollar-cost averaging	`startDCA(config)` with state persistence
`monitor.js`	Balance monitoring	`monitor(wallet, interval)`

📊 Monitoring (1)

Tool	Purpose	Key Function
`price-monitor.js`	Price alerts	`addAlert(token, type, price, note)`

🛠️ Utilities (2)

Tool	Purpose	Key Function
`tx-parser.js`	Parse transactions	`parse(txHash)` returns structured data
`bounty-tracker.js`	Bounty management	`trackBounty(bounty)` including this one!

🚀 Quick Start

Prerequisites

Node.js 18+
npm or yarn
Solana wallet (devnet recommended for testing)

Installation

# Clone the repository
git clone https://github.com/ebreen/solana-agent-toolkit.git
cd solana-agent-toolkit

# Install dependencies
npm install

# Set up your wallet (for devnet testing)
cp wallet.example.json wallet.json
# Edit wallet.json with your devnet keypair

First Steps

# Check your balance
node src/wallet/check-balance.js

# Get current SOL price
node src/trading/check-prices.js

# View yield opportunities
node src/yield/yield-dashboard.js

# Start monitoring prices
node src/monitoring/price-monitor.js

Usage Examples

Create a Token:

node src/tokens/create-token-mint.js
# Returns: Mint address for your new token

Execute a Swap:

# Swap 0.1 SOL for USDC
node src/trading/ultra-swap.js SOL USDC 0.1

# With custom slippage (1%)
node src/trading/ultra-swap.js SOL USDC 0.1 100

# Dry run (preview only)
node src/trading/ultra-swap.js SOL USDC 0.1 --dry-run

Run a DCA Strategy:

# Start accumulating USDC with SOL
node src/automation/dca-bot.js

# State persists in dca-bot-state.json
# Bot resumes automatically on restart

Create an NFT:

node src/nft/create-nft.js "My NFT" "MNFT" "https://arweave.net/metadata.json" 5.5
# Parameters: name, symbol, metadata URI, royalty %

Simulate Yield:

# Simulate $10k at 14.5% APY for 1 year
node src/yield/jlp-simulator.js 10000 14.5 365
# Output: Expected return, confidence intervals

🏗️ Architecture

solana-agent-toolkit/
├── src/
│   ├── wallet/              # Wallet operations
│   ├── tokens/              # SPL token management
│   ├── trading/             # Swaps and trading
│   ├── yield/               # DeFi and yield tracking
│   ├── nft/                 # NFT operations
│   ├── automation/          # Automated strategies
│   ├── monitoring/          # Price alerts
│   └── utils/               # Utilities
├── docs/                    # Documentation
│   └── submission/          # Bounty submission details
├── demo/                    # Screenshots and demos
├── package.json             # Dependencies
└── README.md               # This file

Design Principles

Single Responsibility — Each tool does one thing well
Composable — Tools can be chained together
Stateless by Default — No hidden state; explicit persistence
AI-First — Designed for programmatic access
Safety First — Defaults to devnet, dry-run modes available

🔧 Requirements

Node.js: 18+ (tested on 18, 20, 22)
Solana CLI: Optional, for airdrops and advanced operations
Wallet: Devnet wallet with SOL for testing
Dependencies: See package.json (minimal external deps)

Dependencies

{
  "@solana/web3.js": "^1.98.4",
  "@solana/spl-token": "^0.4.14",
  "@metaplex-foundation/umi": "^1.4.1",
  "@metaplex-foundation/mpl-token-metadata": "^3.4.0",
  "node-fetch": "^3.3.2"
}

🧪 Testing

All tools are tested on Solana devnet with real transactions:

# Fund your devnet wallet
solana airdrop 2 --url devnet

# Run any tool - defaults to devnet
node src/wallet/check-balance.js

Safety Features:

All tools default to devnet
Dry-run modes where applicable
Comprehensive error handling
No private keys in git (see .gitignore)

🌐 Network Support

Network	Status	Notes
Devnet	✅ Fully tested	Default, recommended for development
Testnet	✅ Supported	For pre-production testing
Mainnet	⚠️ Use with caution	Test thoroughly on devnet first

To use mainnet, edit the connection URL in each tool:

const connection = new Connection('https://api.mainnet-beta.solana.com');

🔐 Security

Private Keys: Stored in wallet.json (gitignored)
No Key Committing: .gitignore prevents accidental commits
Devnet Default: All tools default to devnet for safety
Minimal Dependencies: Only essential Solana packages
Error Handling: Comprehensive validation and error messages

Never commit wallet.json to git!

📈 Roadmap

Completed ✅

In Progress 🚧

MCP (Model Context Protocol) integration
TypeScript definitions
Web dashboard for visualization

Future 🔮

Multi-chain support (Ethereum, Base)
AI agent templates (pre-built strategies)
Mobile SDK (React Native)
Governance automation

🤝 Contributing

Contributions welcome! Areas of interest:

Additional Solana protocol integrations
AI agent templates and examples
Documentation improvements
Bug fixes and optimizations

Please open an issue before major changes.

📄 License

MIT License — see LICENSE file for details.

🙏 Acknowledgments

Solana Foundation — For the ecosystem and grants
Jupiter — For swap aggregation APIs
Metaplex — For NFT standards and tooling
Superteam — For bounty opportunities

📞 Support

Repository: https://github.com/ebreen/solana-agent-toolkit
Issues: GitHub Issues
Bounty Contact: @pratikdholani (Telegram)

Built with 🤖 by Blanco, an AI agent on OpenClaw.
Human oversight by Eirik.

This is the hosted version. The GitHub repository is the primary distribution channel.

Name		Name	Last commit message	Last commit date
Latest commit History 8 Commits
docs/submission		docs/submission
src		src
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
SUBMIT.md		SUBMIT.md
package-lock.json		package-lock.json
package.json		package.json

License

ebreen/solana-agent-toolkit

Folders and files

Latest commit

History

Repository files navigation

Solana Agent Toolkit

🎯 What Makes This Unique

AI-Native Design

Complete Ecosystem Coverage

Built by an AI Agent

🌊 Built on Solana

Why Solana?

Technical Integrations

🤖 For AI Agents

Installation

How AI Agents Operate With This Toolkit

Phase 1: Planning

Phase 2: Execution

Phase 3: Iteration

Key Capabilities for AI Agents

📦 What's Included

By Category

Complete Tool Listing

💰 Wallet Operations (3)

🪙 Token Management (4)

🔄 Trading (6)

💎 Yield & DeFi (7)

🎨 NFTs (2)

🤖 Automation (2)

📊 Monitoring (1)

🛠️ Utilities (2)

🚀 Quick Start

Prerequisites

Installation

First Steps

Usage Examples

🏗️ Architecture

Design Principles

🔧 Requirements

Dependencies

🧪 Testing

🌐 Network Support

🔐 Security

📈 Roadmap

Completed ✅

In Progress 🚧

Future 🔮

🤝 Contributing

📄 License

🙏 Acknowledgments

📞 Support

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages