Skip to content

Commit 2ee5c6c

Browse files
0xrinegadeclaude
0xrinegade
and
claude
committed
docs: Replace example MCP servers with mcp.solana.com
## Changes - Replaced helius-mcp.example.com → mcp.solana.com - Replaced birdeye-mcp.example.com → mcp.solana.com - Replaced shyft-mcp.example.com → mcp.solana.com - Updated server names: helius → solana, birdeye → solana-analytics - Updated all MCP command examples to use correct server names ## Files Updated - docs/pages/mcp-servers.html - docs/pages/mcp.html - docs/pages/api-reference.html All MCP examples now use the official Solana MCP server at mcp.solana.com 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
1 parent 5f27101 commit 2ee5c6c

File tree

9 files changed

+450
-166
lines changed

9 files changed

+450
-166
lines changed

‎docs/pages/ai-integration.html‎

Lines changed: 64 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -11,39 +11,67 @@
1111
<div class="main-wrapper">
1212
<h1>AI Integration</h1>
1313

14-
<h2>▓▓ Natural Language Commands</h2>
15-
<p>OSVM understands natural language queries. Simply type what you want to do:</p>
14+
<h2>▓▓ Natural Language Blockchain Queries (PRIMARY FEATURE)</h2>
15+
<p>OSVM's main feature is AI-powered natural language queries for blockchain investigation:</p>
1616

1717
<div class="command-item">
18-
<code>osvm "deploy my program to mainnet"</code>
19-
<p>AI interprets and executes your intent</p>
18+
<code>osvm "show me all transactions for wallet ABC...XYZ in the last 24 hours"</code>
19+
<p>Blockchain investigation with natural language</p>
2020
</div>
2121

2222
<div class="command-item">
23-
<code>osvm "show me all validators on sonic"</code>
24-
<p>Natural language query processing</p>
23+
<code>osvm "analyze DEX trading volume on Raydium for token XYZ"</code>
24+
<p>AI interprets and executes blockchain analysis</p>
25+
</div>
26+
27+
<div class="command-item">
28+
<code>osvm "find NFT holders for collection ABC with rare traits"</code>
29+
<p>Complex blockchain queries made simple</p>
30+
</div>
31+
32+
<div class="command-item">
33+
<code>osvm "identify unusual activity in program 123...456"</code>
34+
<p>Pattern detection and anomaly analysis</p>
35+
</div>
36+
37+
<h2>▓▓ AI Planning Mode</h2>
38+
<p>Use explicit planning mode for detailed query execution:</p>
39+
40+
<div class="command-item">
41+
<code>osvm plan "analyze arbitrage opportunities between Orca and Raydium"</code>
42+
<p>AI generates OVSM execution plan</p>
43+
</div>
44+
45+
<div class="command-item">
46+
<code>osvm -p "find wallets that interacted with both program A and B"</code>
47+
<p>Short flag for planning mode</p>
48+
</div>
49+
50+
<div class="command-item">
51+
<code>osvm -a "calculate total fees paid by wallet X this month"</code>
52+
<p>Alternative planning flag alias</p>
2553
</div>
2654

2755
<h2>▓▓ Interactive Chat</h2>
2856
<div class="command-item">
2957
<code>osvm chat</code>
30-
<p>Launch basic chat interface</p>
58+
<p>Launch interactive chat for continuous investigation</p>
3159
</div>
3260

3361
<div class="command-item">
3462
<code>osvm chat --advanced</code>
35-
<p>FAR-style multi-session interface</p>
63+
<p>Advanced multi-session interface with more tools</p>
3664
</div>
3765

66+
<h2>▓▓ AI-Powered Code Auditing</h2>
3867
<div class="command-item">
39-
<code>osvm chat --microvm</code>
40-
<p>Isolated chat with ephemeral tool VMs</p>
68+
<code>osvm audit ./contracts</code>
69+
<p>Security audit with AI-enhanced vulnerability detection</p>
4170
</div>
4271

43-
<h2>▓▓ AI-Powered Auditing</h2>
4472
<div class="command-item">
4573
<code>osvm audit github.com/project/contract</code>
46-
<p>Security audit with AI analysis</p>
74+
<p>Audit directly from GitHub repositories</p>
4775
</div>
4876

4977
<h2>▓▓ Configuration</h2>
@@ -55,23 +83,35 @@ <h3>▒▒ Local AI (Ollama)</h3>
5583
<pre><code>export OPENAI_URL="http://localhost:11434/v1/chat/completions"
5684
export OPENAI_KEY="ollama"</code></pre>
5785

58-
<h2>▓▓ Features</h2>
86+
<h2>▓▓ AI Features</h2>
5987
<ul>
60-
<li>Natural language understanding</li>
61-
<li>Context-aware responses</li>
62-
<li>Tool planning and execution</li>
63-
<li>Code generation</li>
64-
<li>Error diagnosis</li>
65-
<li>Performance optimization suggestions</li>
88+
<li>Natural language blockchain query understanding</li>
89+
<li>Context-aware investigation planning</li>
90+
<li>OVSM LISP code generation for execution</li>
91+
<li>MCP tool integration for data access</li>
92+
<li>Multi-step investigation workflows</li>
93+
<li>Security vulnerability detection</li>
94+
<li>Code review and best practices</li>
95+
<li>Error diagnosis and troubleshooting</li>
6696
</ul>
6797

68-
<h2>▓▓ Circuit Breaker</h2>
98+
<h2>▓▓ How OSVM AI Agent Works</h2>
99+
<p>When you run a blockchain query, the AI agent:</p>
100+
<ol>
101+
<li><strong>Understands Intent:</strong> Parses your natural language query</li>
102+
<li><strong>Plans Investigation:</strong> Generates OVSM LISP code to execute</li>
103+
<li><strong>Executes via MCP:</strong> Runs plan using MCP tools and RPC endpoints</li>
104+
<li><strong>Analyzes Results:</strong> Processes raw blockchain data into insights</li>
105+
<li><strong>Returns Summary:</strong> Provides human-readable analysis with key findings</li>
106+
</ol>
107+
108+
<h2>▓▓ Circuit Breaker Protection</h2>
69109
<p>OSVM includes automatic failure protection:</p>
70110
<ul>
71-
<li>5 failure threshold</li>
72-
<li>30 second timeout</li>
73-
<li>Automatic recovery</li>
74-
<li>Fallback to local processing</li>
111+
<li>5 failure threshold before circuit opens</li>
112+
<li>30 second timeout for requests</li>
113+
<li>Automatic recovery after cooldown</li>
114+
<li>Graceful fallback to local processing</li>
75115
</ul>
76116
</div>
77117
</body>

‎docs/pages/ai.html‎

Lines changed: 68 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -26,65 +26,104 @@ <h1>AI Integration</h1>
2626

2727
<div class="feature-grid">
2828
<div class="feature-card">
29-
<h3>🤖 Natural Language Queries</h3>
29+
<h3>🔍 Blockchain Investigation (PRIMARY)</h3>
3030
<pre class="code-block">
31-
<span class="comment"># Ask anything in plain English</span>
32-
$ osvm "What is my wallet balance?"
33-
$ osvm "Deploy my program to devnet"
34-
$ osvm "Show validator performance metrics"</pre>
31+
<span class="comment"># Natural language blockchain queries</span>
32+
$ osvm "show me all transactions for wallet ABC...XYZ"
33+
$ osvm "analyze DEX trading volume on Raydium"
34+
$ osvm "find NFT holders with rare traits"
35+
$ osvm "track SOL flow between these wallets"
36+
<span class="success">✓ AI interprets and executes</span>
37+
<span class="success">✓ Returns human-readable insights</span></pre>
3538
</div>
3639

3740
<div class="feature-card">
38-
<h3>🔍 Smart Code Auditing</h3>
41+
<h3>🧠 AI Planning Mode</h3>
3942
<pre class="code-block">
40-
<span class="comment"># AI-powered security analysis</span>
41-
$ osvm audit ./my-program
42-
$ osvm audit github.com/solana-labs/token --ai
43-
<span class="success">✓ Vulnerability detection</span>
44-
<span class="success">✓ Best practice recommendations</span></pre>
43+
<span class="comment"># Explicit OVSM planning</span>
44+
$ osvm plan "analyze arbitrage opportunities"
45+
$ osvm -p "find unusual wallet activity"
46+
$ osvm -a "calculate monthly fees"
47+
<span class="info">📋 Generating OVSM execution plan...</span>
48+
<span class="success">✓ Plan: 5 steps</span>
49+
<span class="success">✓ Using 3 MCP tools</span>
50+
<span class="success">✓ Executing...</span></pre>
4551
</div>
4652

4753
<div class="feature-card">
48-
<h3>🎯 Intelligent Planning</h3>
54+
<h3>🔒 Smart Code Auditing</h3>
4955
<pre class="code-block">
50-
<span class="comment"># AI creates execution plans</span>
51-
$ osvm chat --advanced
52-
> "Optimize my validator setup"
53-
<span class="info">📋 Creating optimization plan...</span>
54-
<span class="success">✓ Network tuning</span>
55-
<span class="success">✓ Hardware optimization</span></pre>
56+
<span class="comment"># AI-powered security analysis</span>
57+
$ osvm audit ./my-program
58+
$ osvm audit github.com/solana-labs/token
59+
<span class="success">✓ Vulnerability detection</span>
60+
<span class="success">✓ Best practice recommendations</span>
61+
<span class="success">✓ Exit code 1 on critical findings</span></pre>
5662
</div>
5763
</div>
5864

5965
<div class="section">
6066
<h2>Configuration</h2>
6167
<pre class="terminal">
62-
<span class="comment"># Configure AI providers</span>
68+
<span class="comment"># Configure OpenAI</span>
6369
$ export OPENAI_KEY="sk-..."
6470
$ export OPENAI_URL="https://api.openai.com/v1/chat/completions"
6571

6672
<span class="comment"># Or use local Ollama</span>
6773
$ export OPENAI_URL="http://localhost:11434/v1/chat/completions"
74+
$ export OPENAI_KEY="ollama-key"
6875

69-
<span class="comment"># Use OSVM's built-in AI</span>
70-
$ osvm --use-internal-ai "analyze my transactions"</pre>
76+
<span class="comment"># Check AI status</span>
77+
$ osvm chat
78+
<span class="info">🤖 AI Provider: OpenAI</span>
79+
<span class="success">✓ Connection established</span></pre>
7180
</div>
7281

7382
<div class="section">
74-
<h2>Advanced Chat Interface</h2>
83+
<h2>How OSVM AI Agent Works</h2>
7584
<pre class="terminal">
76-
<span class="comment"># Launch interactive AI chat</span>
77-
$ osvm chat --advanced
85+
<span class="comment"># Example query flow</span>
86+
$ osvm "find the top 5 SOL receivers in the last hour"
87+
88+
<span class="info">🤖 AI Agent Process:</span>
89+
<span class="info">1. Understands Intent:</span> Find top receivers by SOL amount
90+
<span class="info">2. Plans Investigation:</span> Generate OVSM LISP code
91+
<span class="info">3. Executes via MCP:</span> Call getSlot, getBlocks, getTransactions
92+
<span class="info">4. Analyzes Results:</span> Filter transfers, aggregate by receiver
93+
<span class="info">5. Returns Summary:</span> Formatted table with top 5
7894

7995
<span class="success">╔═══════════════════════════════════════════╗</span>
80-
<span class="success">║ OSVM AI Chat - Multi-Session Interface ║</span>
96+
<span class="success">║ Rank │ Wallet Address │ Amount ║</span>
8197
<span class="success">╠═══════════════════════════════════════════╣</span>
82-
<span class="success">║ • Natural language understanding ║</span>
83-
<span class="success">║ • Tool execution planning ║</span>
84-
<span class="success">║ • MCP server integration ║</span>
85-
<span class="success">║ • Session recording & replay ║</span>
98+
<span class="success">║ 1 │ 7xKX...9mPQ │ 1,250 SOL║</span>
99+
<span class="success">║ 2 │ 3bZQ...4rT2 │ 890 SOL ║</span>
100+
<span class="success">║ 3 │ 9mPQ...7xKX │ 625 SOL ║</span>
86101
<span class="success">╚═══════════════════════════════════════════╝</span></pre>
87102
</div>
103+
104+
<div class="section">
105+
<h2>Interactive Chat Interface</h2>
106+
<pre class="terminal">
107+
<span class="comment"># Launch interactive AI chat</span>
108+
$ osvm chat
109+
110+
<span class="success">╔═══════════════════════════════════════════╗</span>
111+
<span class="success">║ OSVM AI Chat - Blockchain Investigation ║</span>
112+
<span class="success">╠═══════════════════════════════════════════╣</span>
113+
<span class="success">║ • Natural language queries ║</span>
114+
<span class="success">║ • Multi-step investigations ║</span>
115+
<span class="success">║ • OVSM LISP execution ║</span>
116+
<span class="success">║ • MCP tool integration ║</span>
117+
<span class="success">║ • Session history & export ║</span>
118+
<span class="success">╚═══════════════════════════════════════════╝</span>
119+
120+
> "Check my wallet balance"
121+
<span class="success">✓ Balance: 250.75 SOL</span>
122+
123+
> "Show recent DEX trades"
124+
<span class="info">🔍 Querying Raydium and Orca...</span>
125+
<span class="success">✓ Found 15 trades in last 24h</span></pre>
126+
</div>
88127
</section>
89128

90129
<div class="navigation-hint animate-on-scroll" data-animation="fadeIn">

0 commit comments

Comments
 (0)