Skip to content

Commit f591325

Browse files
TopTrenDevTopTrenDev
authored
Update README.md
1 parent 0d32f7a commit f591325

File tree

1 file changed

+132
-210
lines changed

1 file changed

+132
-210
lines changed

‎README.md

+132-210
Original file line numberDiff line numberDiff line change
@@ -1,265 +1,187 @@
1-
<div align="center">
2-
3-
# Solana AI Agent
4-
5-
Solana AI Agent, an innovative solution built on the Solana blockchain that harnesses the power of artificial intelligence to revolutionize digital interactions. Designed to automate complex tasks and optimize decision-making, Solana empowers users with real-time analytics and efficient operations in the DeFi space. With its ability to learn and adapt, Solana aims to provide seamless integration and meaningful insights for both newcomers and experienced crypto enthusiasts. Experience the future of autonomous technology with Solana, where AI meets the dynamic landscape of blockchain.
6-
7-
</div>
8-
9-
# Overview
10-
11-
The Solana AI Agent for connecting AI agents to Solana protocols.
12-
13-
1. **Blockchain Agent Chat Terminal**
14-
- Real-time Streaming Implementation
15-
- Blockchain Integration
16-
- UI Components Design
17-
2. Trading Infrastructure
18-
- Jupiter Exchange swaps
19-
- Launch on Pump via PumpPortal
20-
- Raydium pool creation (CPMM, CLMM, AMMv4)
21-
- Orca Whirlpool integration
22-
- Manifest market creation and limit orders
23-
- Meteora Dynamic AMM, DLMM Pool, and Alpha Vault
24-
- Openbook market creation
25-
- Register and resolve SNS
26-
- Jito Bundles
27-
- Pyth Price feeds for fetching asset prices
28-
- Perpetuals trading with Adrena Protocol
29-
- Drift Vaults, Perps, Lending, and Borrowing
30-
3. Analytics and Automation
31-
- Dashboard for Real-time Market Analytics
32-
- Whale Monitoring
33-
- DeFi Insights
34-
- NFT Management
35-
- NFT Listing Automtaion
36-
- Multichain-bridge to Solana
37-
- Autonomous trading agent powered by Solana AI
38-
4. Expand Cross-Chain Support & Security Features
39-
- Interoperability
40-
- Enhanced Security Tools
41-
- Comprehensive Ecosystem Integration
42-
43-
5. Full Decentralization with Community Governance
44-
- Decentralized Architecture
45-
- Community-Led Decision Making
46-
- Sustainability and Growth
47-
48-
Anyone - whether an SF-based AI researcher or a crypto-native builder - can bring their AI agents trained with any model and seamlessly integrate with Solana.
49-
50-
[![Run on Repl.it](https://replit.com/badge/github/earthzetaorg/solana-ai-agents)](https://replit.com/@earthzetaorg/solana-ai-agents)
51-
52-
## 🔧 Core Blockchain Features
53-
54-
- **Token Operations**
55-
- Deploy SPL tokens by Metaplex
56-
- Transfer assets
57-
- Balance checks
58-
- Stake SOL
59-
- Zk compressed Airdrop by Light Protocol and Helius
60-
- **NFTs on 3.Land**
61-
- Create your own collection
62-
- NFT creation and automatic listing on 3.land
63-
- List your NFT for sale in any SPL token
64-
- **NFT Management via Metaplex**
65-
- Collection deployment
66-
- NFT minting
67-
- Metadata management
68-
- Royalty configuration
69-
70-
- **DeFi Integration**
71-
- Jupiter Exchange swaps
72-
- Launch on Pump via PumpPortal
73-
- Raydium pool creation (CPMM, CLMM, AMMv4)
74-
- Orca Whirlpool integration
75-
- Manifest market creation, and limit orders
76-
- Meteora Dynamic AMM, DLMM Pool, and Alpha Vault
77-
- Openbook market creation
78-
- Register and Resolve SNS
79-
- Jito Bundles
80-
- Pyth Price feeds for fetching Asset Prices
81-
- Register/resolve Alldomains
82-
- Perpetuals Trading with Adrena Protocol
83-
- Drift Vaults, Perps, Lending and Borrowing
84-
85-
- **Solana Blinks**
86-
- Lending by Lulo (Best APR for USDC)
87-
- Send Arcade Games
88-
- JupSOL staking
89-
- Solayer SOL (sSOL)staking
90-
91-
- **Non-Financial Actions**
92-
- Gib Work for registering bounties
93-
94-
## 🤖 AI Integration Features
95-
96-
- **LangChain Integration**
97-
- Ready-to-use LangChain tools for blockchain operations
98-
- Autonomous agent support with React framework
99-
- Memory management for persistent interactions
100-
- Streaming responses for real-time feedback
101-
102-
- **Vercel AI SDK Integration**
103-
- Vercel AI SDK for AI agent integration
104-
- Framework agnostic support
105-
- Quick and easy toolkit setup
106-
107-
- **Autonomous Modes**
108-
- Interactive chat mode for guided operations
109-
- Autonomous mode for independent agent actions
110-
- Configurable action intervals
111-
- Built-in error handling and recovery
112-
113-
- **AI Tools**
114-
- DALL-E integration for NFT artwork generation
115-
- Natural language processing for blockchain commands
116-
- Price feed integration for market analysis
117-
- Automated decision-making capabilities
118-
119-
## Quick Start
1+
# **Solana AI Agent**
1202

121-
```typescript
122-
import { SolanaAIAgent, createSolanaTools } from "solana-ai-agents";
123-
124-
// Initialize with private key and optional RPC URL
125-
const agent = new SolanaAIAgent(
126-
"your-wallet-private-key-as-base58",
127-
"https://api.mainnet-beta.solana.com",
128-
"your-openai-api-key"
129-
);
3+
**An innovative AI-powered solution built on the Solana blockchain.**
1304

131-
// Create LangChain tools
132-
const tools = createSolanaTools(agent);
133-
```
5+
Solana AI Agent revolutionizes digital interactions by integrating **artificial intelligence** with the **Solana blockchain**. Designed for **automating complex tasks** and **optimizing decision-making**, this agent enhances **DeFi operations, trading, analytics, and cross-chain interactions**.
1346

135-
## Usage Examples
7+
With its ability to learn and adapt, Solana AI Agent ensures **seamless integration and actionable insights** for both newcomers and experienced crypto users.
1368

137-
- Deploy a New Token
9+
---
13810

139-
- Create NFT on 3Land
140-
When creating an NFT using 3Land's tool, it automatically goes for sale on 3.land website
11+
## **📌 Overview**
14112

142-
- Create NFT Collection
13+
**Solana AI Agent** enables the connection between AI agents and Solana protocols, offering:
14314

144-
- Swap Tokens
15+
### **1️⃣ Blockchain Agent Chat Terminal**
16+
- **Real-time streaming** implementation
17+
- **Blockchain integration** for AI-driven operations
18+
- **Intuitive UI components** for seamless interaction
14519

146-
- Lend Tokens
20+
### **2️⃣ Trading Infrastructure**
21+
- **Jupiter Exchange swaps**
22+
- **PumpPortal launch support**
23+
- **Raydium pool creation** (CPMM, CLMM, AMMv4)
24+
- **Orca Whirlpool & OpenBook market integration**
25+
- **Pyth price feeds** for real-time asset tracking
26+
- **Drift Vaults, Perps, Lending, and Borrowing**
14727

148-
- Stake SOL
28+
### **3️⃣ Analytics & Automation**
29+
- **Real-time market analytics dashboard**
30+
- **Whale monitoring & DeFi insights**
31+
- **NFT management & automated NFT listing**
32+
- **Multi-chain bridge to Solana**
33+
- **Autonomous trading agent powered by Solana AI**
14934

150-
- Stake SOL on Solayer
35+
### **4️⃣ Cross-Chain & Security Enhancements**
36+
- **Interoperability across ecosystems**
37+
- **Advanced security protocols**
38+
- **Comprehensive integration with Solana's ecosystem**
15139

152-
- Send an SPL Token Airdrop via ZK Compression
40+
### **5️⃣ Full Decentralization & Community Governance**
41+
- **Decentralized architecture**
42+
- **Community-led decision-making**
43+
- **Sustainable growth & innovation**
15344

154-
- Fetch Price Data from Pyth
45+
**Anyone**—whether an **AI researcher** or a **crypto-native developer**—can train AI agents and seamlessly integrate them with Solana.
15546

156-
- Open PERP Trade
47+
[![Run on Replit](https://replit.com/badge/github/toptrendev/solana-ai-agents)](https://replit.com/@toptrendev/solana-ai-agents)
15748

158-
- Close PERP Trade
49+
---
15950

160-
- Close Empty Token Accounts
51+
## **🔧 Core Blockchain Features**
16152

162-
- Create a Drift account
53+
### **🪙 Token Operations**
54+
- Deploy **SPL tokens** via **Metaplex**
55+
- **Transfer assets** and **balance checks**
56+
- **Stake SOL** for rewards
57+
- **ZK-compressed airdrops** via **Light Protocol & Helius**
16358

164-
- Create a Drift Vault
59+
### **🎨 NFT Integration**
60+
- **Create NFT collections** and list them automatically on **3.land**
61+
- **NFT metadata & royalty management** via **Metaplex**
16562

166-
- Deposit into a Drift Vault
63+
### **📊 DeFi Integration**
64+
- **Jupiter Exchange swaps & PumpPortal integration**
65+
- **Raydium & Orca liquidity pools**
66+
- **Perpetuals trading & lending via Adrena and Drift**
67+
- **Market data via Pyth price feeds**
16768

168-
- Deposit into your Drift account
69+
### **⚡ Solana Blinks**
70+
- **Best USDC lending rates via Lulo**
71+
- **Arcade game transactions**
72+
- **JupSOL staking & Solayer SOL staking**
16973

170-
- Derive a Drift Vault address
74+
### **🛠️ Non-Financial Actions**
75+
- **Bounty registration** via Gib Work
17176

172-
- Do you have a Drift account
77+
---
17378

174-
- Get Drift account information
79+
## **🤖 AI Integration Features**
17580

176-
- Request withdrawal from Drift vault
81+
### **💡 LangChain Integration**
82+
- **Blockchain-ready LangChain tools**
83+
- **Autonomous agent support** with **React framework**
84+
- **Persistent memory management**
85+
- **Real-time streaming responses**
17786

178-
- Carry out a perpetual trade using a Drift vault
87+
### **🚀 Vercel AI SDK Integration**
88+
- **Framework-agnostic** AI toolkit
89+
- **Seamless integration** for AI agent workflows
17990

180-
- Carry out a perpetual trade using your Drift account
91+
### **🔄 Autonomous AI Modes**
92+
- **Interactive mode** for user-guided operations
93+
- **Fully autonomous mode** for AI-driven tasks
94+
- **Configurable action intervals & error handling**
18195

182-
- Update Drift vault parameters
96+
### **🖼️ AI-Powered Tools**
97+
- **DALL·E integration** for **NFT artwork generation**
98+
- **Natural Language Processing (NLP)** for blockchain commands
99+
- **Automated price feed tracking & market analysis**
100+
- **AI-driven decision-making for DeFi strategies**
183101

184-
- Withdraw from Drift account
102+
---
185103

186-
- Borrow from Drift
104+
## **🚀 Quick Start Guide**
187105

188-
- Repay Drift loan
106+
```typescript
107+
import { SolanaAIAgent, createSolanaTools } from "solana-ai-agents";
189108

190-
- Withdraw from Drift vault
109+
// Initialize with private key and optional RPC URL
110+
const agent = new SolanaAIAgent(
111+
"your-wallet-private-key-as-base58",
112+
"https://api.mainnet-beta.solana.com",
113+
"your-openai-api-key"
114+
);
191115

192-
- Update the address a Drift vault is delegated to
116+
// Create LangChain tools
117+
const tools = createSolanaTools(agent);
118+
```
193119

194-
- Get Voltr Vault Position Values
120+
---
195121

196-
- Deposit into Voltr Strategy
122+
## **🛠️ Usage Examples**
197123

198-
- Withdraw from Voltr Strategy
124+
- **Deploy a New Token**
125+
- **Create NFTs & Collections** (Auto-listed on **3Land**)
126+
- **Swap & Lend Tokens**
127+
- **Stake SOL on Solana & Solayer**
128+
- **ZK Compression Airdrops**
129+
- **Fetch Market Data via Pyth**
130+
- **Open & Close Perpetual Trades**
131+
- **Manage Drift Vaults & Accounts**
132+
- **Borrow & Repay Loans on Drift**
199133

200-
- Get a Solana asset by its ID
134+
---
201135

202-
## Examples
136+
## **🔍 Advanced AI & Blockchain Examples**
203137

204-
### LangGraph Multi-Agent System
138+
### **LangGraph Multi-Agent System**
139+
This repository includes a **multi-agent system** using **LangGraph & Solana AI Agent**.
205140

206-
The repository includes an advanced example of building a multi-agent system using LangGraph and Solana AI Agent. Located in `examples/agent-kit-langgraph`, this example demonstrates:
141+
📂 **Located in:** `examples/agent-kit-langgraph`
207142

208-
- Multi-agent architecture using LangGraph's StateGraph
209-
- Specialized agents for different tasks:
210-
- General purpose agent for basic queries
211-
- Transfer/Swap agent for transaction operations
212-
- Read agent for blockchain data queries
213-
- Manager agent for routing and orchestration
214-
- Fully typed TypeScript implementation
215-
- Environment-based configuration
143+
🔹 **Features:**
144+
- **Multi-agent architecture** using **StateGraph**
145+
- **Specialized agents** for queries, transactions, and market analysis
146+
- **Fully typed** implementation in **TypeScript**
147+
- **Configurable & scalable environment**
216148

217-
Check out the [LangGraph example](examples/agent-kit-langgraph) for a complete implementation of an advanced Solana agents system.
149+
🔗 **Explore the full implementation:** [LangGraph Example](examples/agent-kit-langgraph)
218150

219-
## Dependencies
151+
---
220152

221-
The toolkit relies on several key Solana and Metaplex libraries:
153+
## **📦 Dependencies**
222154

223-
- @solana/web3.js
224-
- @solana/spl-token
225-
- @metaplex-foundation/digital-asset-standard-api
226-
- @metaplex-foundation/mpl-token-metadata
227-
- @metaplex-foundation/mpl-core
228-
- @metaplex-foundation/umi
229-
- @lightprotocol/compressed-token
230-
- @lightprotocol/stateless.js
155+
This toolkit integrates key Solana and Metaplex libraries:
156+
- `@solana/web3.js`
157+
- `@solana/spl-token`
158+
- `@metaplex-foundation/mpl-token-metadata`
159+
- `@lightprotocol/compressed-token`
160+
- `@lightprotocol/stateless.js`
231161

232-
## Contributing
162+
---
233163

234-
Contributions are welcome! Please feel free to submit a Pull Request.
235-
Refer to [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines on how to contribute to this project.
164+
## **🤝 Contributing**
236165

237-
## Contributors
166+
Contributions are welcome! Please review the [CONTRIBUTING.md](CONTRIBUTING.md) file before submitting a **Pull Request**.
238167

239-
<a href="https://github.com/earthzetaorg/solana-ai-agents/graphs/contributors">
240-
<img src="https://contrib.rocks/image?repo=earthzetaorg/solana-ai-agents" />
241-
</a>
168+
---
242169

243-
## Star History
170+
## **👥 Contributors**
244171

245-
[![Star History Chart](https://api.star-history.com/svg?repos=earthzetaorg/solana-ai-agents&type=Date)](https://star-history.com/#earthzetaorg/solana-ai-agents&Date)
172+
<a href="https://github.com/toptrendev/solana-ai-agents/graphs/contributors">
173+
<img src="https://contrib.rocks/image?repo=toptrendev/solana-ai-agents" />
174+
</a>
246175

247-
## License
176+
---
248177

249-
Apache-2 License
178+
## **🛡️ Security Notice**
250179

251-
## Security
180+
⚠️ **Always store your private keys securely.** This toolkit handles **private keys and blockchain transactions**, so ensure proper security measures.
252181

253-
This toolkit handles private keys and transactions. Always ensure you're using it in a secure environment and never share your private keys.
182+
---
254183

255-
## 👋 Contact Me
184+
## **📬 Contact & Community**
256185

257-
###
258-
Telegram: https://t.me/earthzeta
259-
###
260-
<div style={{display:flex; justify-content:space-evenly}}>
261-
<a href="https://t.me/earthzeta" target="_blank"><img alt="Telegram"
262-
src="https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white"/></a>
263-
<a href="https://discordapp.com/users/339619501081362432" target="_blank"><img alt="Discord"
264-
src="https://img.shields.io/badge/Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white"/></a>
265-
</div>
186+
📢 **Telegram:** [@toptrendev](https://t.me/toptrendev)
187+
📢 **Discord:** [toptrendev](https://discordapp.com/users/334173411402317846)

0 commit comments

Comments
 (0)