Building Autonomous AI Agents on Solana: A Hands-On Guide with Solana Agent Kit and LangChain

By Kenneth Okenwa ( @symplyKen | GitHub: @anekenonso )

As artificial intelligence shifts from passive conversational assistants to autonomous economic actors, agents require an underlying financial rail. They need to pay for compute APIs, purchase data datasets, rebalance liquidity pools, and tip other agents for micro-tasks.

Traditional payment rails (Stripe, bank wires, credit cards) fail completely for AI agents: they require identity KYC, manual human onboarding, and impose heavy minimum fee floors (e.g., $0.30 + 2.9%), making 5-cent agent-to-agent transactions economically unviable.

Ethereum and high-fee EVM networks also present severe roadblocks: unpredictable gas auction spikes and multi-second block confirmations break high-frequency reasoning loops.

Solana provides the ideal substrate for autonomous AI agents:

In this developer guide, we walk through building an autonomous AI agent capable of reasoning, inspecting on-chain state, and executing live Solana transactions using the Solana Agent Kit and LangChain.

An on-chain AI agent combines a high-level cognitive engine with deterministic blockchain execution tools:

┌──────────────────────────────────────────────────────────────┐ │ Human Operator / Prompt │ │ "Check my SOL balance and swap 0.1 SOL to USDC" │ └──────────────────────────────┬───────────────────────────────┘ │ ▼ ┌──────────────────────────────────────────────────────────────┐ │ Cognitive Layer (LangChain / LLM) │ │ • Evaluates user intent │ │ • Selects appropriate tool from tool registry │ │ • Extracts arguments: { amount: 0.1, output: "USDC" } │ └──────────────────────────────┬───────────────────────────────┘ │ ▼ ┌──────────────────────────────────────────────────────────────┐ │ Solana Agent Kit Bridge │ │ • Formats on-chain instruction │ │ • Fetches optimal swap route via Jupiter API │ │ • Builds and signs serialized VersionedTransaction │ └──────────────────────────────┬───────────────────────────────┘ │ ▼ ┌──────────────────────────────────────────────────────────────┐ │ Solana Network (SVM) │ │ • Atomic execution on Mainnet-Beta / Devnet │ │ • Returns transaction signature to Agent │ └──────────────────────────────────────────────────────────────┘ Enter fullscreen mode Exit fullscreen mode 3. Setting Up the Development Workspace Let's initialize a fresh TypeScript project with the necessary dependencies:

mkdir solana-ai-agent cd solana-ai-agent npm init -y npm install typescript @types/node ts-node --save-dev npx tsc --init Enter fullscreen mode Exit fullscreen mode Install the Solana Agent Kit, Solana Web3 SDK, and LangChain packages:

npm install solana-agent-kit @solana/web3.js @langchain/core @langchain/openai dotenv bs58 Enter fullscreen mode Exit fullscreen mode Create a.env file to configure your credentials:

OPENAI_API_KEY=your_openai_api_key_here SOLANA_PRIVATE_KEY=your_base58_encoded_private_key_here RPC_URL=https://api.mainnet-beta.solana.com Enter fullscreen mode Exit fullscreen mode Security Tip: Never commit.env or raw private keys to source control. For development, use a dedicated keypair funded with Devnet SOL from solana airdrop 1.

Create agent.ts to implement the agent initialization and execution loop:

import { SolanaAgentKit, createSolanaTools } from " solana-agent-kit "; import { ChatOpenAI } from " @langchain/openai "; import { createReactAgent } from " @langchain/langgraph/prebuilt "; import * as dotenv from " dotenv "; dotenv. config (); async function bootstrapSolanaAgent () { console. log ( " ================================================== " ); console. log ( " BOOTSTRAPPING AUTONOMOUS SOLANA AGENT " ); console. log ( " ================================================== " ); const privateKey = process. env. SOLANA_PRIVATE_KEY; const rpcUrl = process. env. RPC_URL || " https://api.devnet.solana.com "; const openAIApiKey = process. env.

OPENAI_API_KEY; if (! privateKey ||! openAIApiKey ) { throw new Error ( " Missing required environment variables in.env " ); } // 1. Initialize SolanaAgentKit instance const agentKit = new SolanaAgentKit ( privateKey, rpcUrl, openAIApiKey ); console. log ( `Agent Wallet Address: ${ agentKit. wallet_address. toBase58 ()} ` ); // 2. Wrap Solana Agent Kit actions into LangChain structured tools const tools = createSolanaTools ( agentKit ); console. log ( `Loaded ${ tools. length } on-chain tools (Jupiter, Pyth, SPL, Transfers)...` ); // 3.

Initialize the Cognitive LLM model const llm = new ChatOpenAI ({ model: " gpt-4o ", temperature: 0.1, // Low temperature for deterministic financial decisions }); // 4. Create the LangGraph ReAct execution agent const agent = createReactAgent ({ llm, tools, }); return agent; } // 5. Interactive Execution Loop async function runAgentTask ( promptText: string ) { const agent = await bootstrapSolanaAgent (); console. log ( `\n[Prompt]: " ${ promptText } "` ); console. log ( " Agent is reasoning and selecting on-chain tools... \n " ); const stream = await agent. stream ( { messages: [{ role: " user ", content: promptText }], }, { streamMode: " values " } ); for await ( const chunk of stream ) { const lastMessage = chunk. messages [ chunk. messages. length - 1 ]; if ( lastMessage. role === " assistant " && lastMessage. content ) { console. log ( `[Agent Response]:\n ${ lastMessage. content } \n` ); } } } // Execute sample task runAgentTask ( " Check my wallet's SOL balance, and tell me current network TPS.

" ); Enter fullscreen mode Exit fullscreen mode 5. What Actions Can the Agent Execute? Thanks to the Solana Agent Kit's modular plugin ecosystem, your agent automatically inherits high-level capabilities without requiring manual instruction encoding:

Giving an autonomous LLM write access to a blockchain keypair requires strict defense-in-depth:

In emerging markets like Nigeria, access to global payment infrastructure has historically been plagued by card limits, FX restrictions, and high cross-border wire friction.

Autonomous on-chain agents on Solana unlock transformative micro-economic utilities:

Autonomous AI agents will be the highest-volume transactors on public blockchains within the next 3 years. Solana's speed, micro-penny transaction costs, and mature developer tooling make it the natural home for this new paradigm.