How it works
The AI agent is powered by theSolanaAgentKit, a flexible framework that connects to the Solana blockchain and executes actions on your behalf. When you interact with the agent, it:
- Understands your intent - Natural language processing identifies what you want to accomplish
- Selects the right plugin - Matches your request to available actions across plugins
- Executes securely - Signs and sends transactions through your connected wallet
- Returns results - Provides clear feedback on transaction status and outcomes
All agent operations require wallet authentication and your explicit approval for transactions.
Architecture
The agent is built with a modular plugin system that makes it easy to extend functionality:Plugin system
Plugins add new capabilities to the agent without modifying core code
Action handlers
Each action has a schema, examples, and handler function for execution
Type-safe
Full TypeScript support with input validation using Zod schemas
Extensible
Add custom plugins for your specific use cases
Core components
The agent architecture consists of several key components:SolanaAgentKit core
SolanaAgentKit core
The main class that manages blockchain connections, wallet integration, and plugin orchestration. It provides:
- Connection management - Maintains RPC connection to Solana
- Wallet integration - Handles transaction signing and sending
- Plugin registry - Tracks loaded plugins and their methods
- Action dispatcher - Routes commands to appropriate handlers
utils/syntoUtils/agent/core/index.ts:43Plugin interface
Plugin interface
Every plugin implements a standard interface:Plugins can access the full agent instance to execute blockchain operations.
Action system
Action system
Actions define how the agent responds to user commands:
- Name - Unique identifier for the action
- Similes - Alternative phrases that trigger the action
- Description - What the action does
- Examples - Input/output examples for AI training
- Schema - Zod validation schema for inputs
- Handler - Async function that executes the action
utils/syntoUtils/agent/types/index.ts:110Agent configuration
You can configure the agent with various options to customize behavior:- Basic setup
- With options
- RPC configuration
Security model
Security features include:- Wallet-based authentication - All transactions require wallet signatures
- Transaction preview - Review operations before signing
- Forbidden actions - Certain high-risk actions are disabled (e.g.,
LAUNCH_PUMPFUN_TOKEN) - Input validation - All inputs validated with Zod schemas before execution
- Sign-only mode - Option to sign transactions without broadcasting
Network support
The agent works across Solana networks:- Mainnet - Production blockchain with real assets
- Devnet - Development network for testing
- Testnet - Public testing environment
What’s next
Explore capabilities
See what the AI agent can do for you
Available plugins
Learn about token and DeFi plugins