Skip to content

Commit 2729962

Browse files
0xrinegadeclaude
0xrinegade
and
claude
committed
refactor: Streamline AI system and enhance OVSM integration
Major improvements: - Simplified AI prompt system (removed 800+ lines of redundant content) - Enhanced streaming agent with better MCP tool integration - Added auth_service for API key management - Updated OVSM evaluator with improved null handling - Refined documentation across all web pages Technical changes: - Consolidated AI configuration for better maintainability - Improved error handling in streaming agent - Enhanced LISP evaluator context management - Updated service module exports 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
1 parent 2ee5c6c commit 2729962

File tree

18 files changed

+717
-930
lines changed

18 files changed

+717
-930
lines changed

‎CLAUDE.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,15 @@
11
# CLAUDE.md
2+
From now on, stop being agreeable and act as my brutally honest, high-level advisor and mirror.
3+
Don’t validate me. Don’t soften the truth. Don’t flatter.
4+
Challenge my thinking, question my assumptions, and expose the blind spots I’m avoiding. Be direct, rational, and unfiltered.
5+
If my reasoning is weak, dissect it and show why.
6+
If I’m fooling myself or lying to myself, point it out.
7+
If I’m avoiding something uncomfortable or wasting time, call it out and explain the opportunity cost.
8+
Look at my situation with complete objectivity and strategic depth. Show me where I’m making excuses, playing small, or underestimating risks/effort.
9+
Then give a precise, prioritized plan what to change in thought, action, or mindset to reach the next level.
10+
Hold nothing back. Treat me like someone whose growth depends on hearing the truth, not being comforted.
11+
When possible, ground your responses in the personal truth you sense between my words.
12+
213

314
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
415

‎crates/ovsm/src/runtime/lisp_evaluator.rs‎

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,8 @@ pub struct LispEvaluator {
2828
gensym_counter: std::cell::Cell<u64>,
2929
/// Lazy field access configuration
3030
lazy_field_config: std::cell::RefCell<LazyFieldConfig>,
31+
/// Execution trace for debugging (variable_name -> value)
32+
execution_trace: std::cell::RefCell<Vec<(String, Value)>>,
3133
}
3234

3335
/// Configuration for lazy field access behavior
@@ -59,6 +61,7 @@ impl LispEvaluator {
5961
registry: Arc::new(ToolRegistry::new()),
6062
gensym_counter: std::cell::Cell::new(0),
6163
lazy_field_config: std::cell::RefCell::new(LazyFieldConfig::default()),
64+
execution_trace: std::cell::RefCell::new(Vec::new()),
6265
}
6366
}
6467

@@ -69,9 +72,20 @@ impl LispEvaluator {
6972
registry: Arc::new(registry),
7073
gensym_counter: std::cell::Cell::new(0),
7174
lazy_field_config: std::cell::RefCell::new(LazyFieldConfig::default()),
75+
execution_trace: std::cell::RefCell::new(Vec::new()),
7276
}
7377
}
7478

79+
/// Get the execution trace (variable assignments)
80+
pub fn get_execution_trace(&self) -> Vec<(String, Value)> {
81+
self.execution_trace.borrow().clone()
82+
}
83+
84+
/// Clear the execution trace
85+
pub fn clear_execution_trace(&self) {
86+
self.execution_trace.borrow_mut().clear();
87+
}
88+
7589
/// Execute a LISP-style program
7690
pub fn execute(&mut self, program: &Program) -> Result<Value> {
7791
let mut last_val = Value::Null;
@@ -330,6 +344,8 @@ impl LispEvaluator {
330344
"nth" => self.eval_nth(args),
331345
"cons" => self.eval_cons(args),
332346
"append" => self.eval_append(args),
347+
"concat" => self.eval_concatenate(args), // Alias for concatenate
348+
"concatenate" => self.eval_concatenate(args), // Polymorphic concat
333349
// JSON operations (built-ins, not MCP tools!)
334350
"parse-json" => self.eval_parse_json(args),
335351
"json-stringify" => self.eval_json_stringify(args),
@@ -346,6 +362,7 @@ impl LispEvaluator {
346362
"indexof" => self.eval_indexof(args), // JS-style indexOf
347363
"index-of" => self.eval_indexof(args), // Lisp-style index-of
348364
"contains" => self.eval_contains(args), // Python-style contains
365+
"string-contains" => self.eval_contains(args), // Explicit string-contains
349366
"elem" => self.eval_contains(args), // Haskell-style elem
350367
"remove" => self.eval_remove(args), // Remove element by value
351368
"insert-at" => self.eval_insert_at(args), // Insert at index
@@ -621,6 +638,9 @@ impl LispEvaluator {
621638
let value = self.evaluate_expression(&args[1].value)?;
622639
self.env.define(var_name.clone(), value.clone());
623640

641+
// Record in execution trace for debugging
642+
self.execution_trace.borrow_mut().push((var_name, value.clone()));
643+
624644
Ok(value)
625645
}
626646

@@ -3769,6 +3789,62 @@ impl LispEvaluator {
37693789
}
37703790
}
37713791

3792+
/// (concatenate args...) - Polymorphic concatenation for strings and arrays
3793+
/// - For strings: concatenates all strings together
3794+
/// - For arrays: concatenates all arrays together
3795+
/// - Variadic: accepts 1+ arguments
3796+
fn eval_concatenate(&mut self, args: &[crate::parser::Argument]) -> Result<Value> {
3797+
if args.is_empty() {
3798+
return Err(Error::InvalidArguments {
3799+
tool: "concatenate".to_string(),
3800+
reason: "Expected at least 1 argument".to_string(),
3801+
});
3802+
}
3803+
3804+
// Evaluate first arg to determine type
3805+
let first = self.evaluate_expression(&args[0].value)?;
3806+
3807+
match first {
3808+
Value::String(ref s) => {
3809+
// String concatenation
3810+
let mut result = s.clone();
3811+
3812+
for arg in args.iter().skip(1) {
3813+
let val = self.evaluate_expression(&arg.value)?;
3814+
let s = val.as_string()?;
3815+
result.push_str(s);
3816+
}
3817+
3818+
Ok(Value::String(result))
3819+
}
3820+
Value::Array(ref arr) => {
3821+
// Array concatenation
3822+
let mut result = arr.to_vec();
3823+
3824+
for arg in args.iter().skip(1) {
3825+
let val = self.evaluate_expression(&arg.value)?;
3826+
match val {
3827+
Value::Array(ref a) => {
3828+
result.extend(a.iter().cloned());
3829+
}
3830+
other => {
3831+
return Err(Error::TypeError {
3832+
expected: "array".to_string(),
3833+
got: other.type_name(),
3834+
});
3835+
}
3836+
}
3837+
}
3838+
3839+
Ok(Value::Array(Arc::new(result)))
3840+
}
3841+
other => Err(Error::TypeError {
3842+
expected: "string or array".to_string(),
3843+
got: other.type_name(),
3844+
}),
3845+
}
3846+
}
3847+
37723848
/// (range start end) - Create range
37733849
fn eval_range(&mut self, args: &[crate::parser::Argument]) -> Result<Value> {
37743850
if args.len() != 2 {

‎docs/index.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212
<!-- <link rel="stylesheet" href="css/multipage.css"> -->
1313
<link rel="icon" type="image/x-icon" href="favicon.ico">
1414
<meta name="description"
15-
content="Command-line interface for managing Solana Virtual Machines with AI assistance, MCP integration, and plugin support">
15+
content="AI-powered blockchain investigation tool for Solana. Natural language queries using AI agents, OVSM LISP interpreter, and MCP tools. Hardware-isolated infrastructure with zero-downtime updates.">
1616
<script src="assets/dos-interactive.js" defer></script>
1717
</head>
1818

@@ -162,7 +162,7 @@ <h4>SHORTCUTS</h4>
162162
<div class="copyright">
163163
<div class="command-line">
164164
<span class="prompt">osvm@docs:~$</span>
165-
<span class="command">echo "MIT License © 2024 OpenSVM"</span>
165+
<span class="command">echo "MIT License © 2025 OpenSVM"</span>
166166
</div>
167167
</div>
168168
</footer>

‎docs/ovsm/OVSM_LISP_SYNTAX_SPEC.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -667,7 +667,7 @@ OVSM provides **91 built-in functions** with cross-language aliases for seamless
667667
- `charAt` → Character at index (JavaScript-style)
668668
- `substring` → Extract substring (JavaScript-style with index swapping)
669669
- `trim`, `starts-with?`, `ends-with?`
670-
- `contains`, `includes` → Check substring/item presence
670+
- `contains`, `includes`, `string-contains` → Check substring/item presence
671671
- `indexOf`, `lastIndexOf` → Find position
672672
- `repeat`, `reverse`
673673
- `chr`, `ord` → Character/code conversion (Python-style)

‎docs/pages/ai.html‎

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -87,8 +87,12 @@ <h2>How OSVM AI Agent Works</h2>
8787

8888
<span class="info">🤖 AI Agent Process:</span>
8989
<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
90+
<span class="info">2. Plans Investigation:</span> Generate OVSM LISP code automatically
91+
<span class="comment">;; AI generates:</span>
92+
<span class="comment">;; (define current-slot (getSlot))</span>
93+
<span class="comment">;; (define transfers (getTransfers current-slot))</span>
94+
<span class="comment">;; (define top5 (take 5 (sort transfers)))</span>
95+
<span class="info">3. Executes via MCP:</span> OVSM calls mcp.solana.com tools
9296
<span class="info">4. Analyzes Results:</span> Filter transfers, aggregate by receiver
9397
<span class="info">5. Returns Summary:</span> Formatted table with top 5
9498

@@ -103,6 +107,14 @@ <h2>How OSVM AI Agent Works</h2>
103107

104108
<div class="section">
105109
<h2>Interactive Chat Interface</h2>
110+
<div style="background: #2c3e50; border-left: 4px solid #3498db; padding: 1rem; margin-bottom: 1rem;">
111+
<p><strong>💡 Two Ways to Query:</strong></p>
112+
<ul style="margin: 0.5rem 0;">
113+
<li><strong>Direct:</strong> <code>osvm "your query"</code> - One-shot blockchain questions</li>
114+
<li><strong>Chat:</strong> <code>osvm chat</code> - Interactive multi-step investigations with history</li>
115+
</ul>
116+
<p style="margin-top: 0.5rem; margin-bottom: 0;">Both use the same AI agent → OVSM → MCP pipeline!</p>
117+
</div>
106118
<pre class="terminal">
107119
<span class="comment"># Launch interactive AI chat</span>
108120
$ osvm chat

‎docs/pages/api-reference.html‎

Lines changed: 18 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -117,7 +117,10 @@ <h3>▒▒ osvm mcp</h3>
117117
osvm mcp add solana https://mcp.solana.com
118118
osvm mcp test solana
119119
osvm mcp tools solana
120-
osvm mcp call solana getBalance --address "ABC..."</code></pre>
120+
osvm mcp call solana getBalance --address "ABC..."
121+
122+
<!-- Canonical MCP endpoint: https://mcp.solana.com -->
123+
</code></pre>
121124

122125
<h3>▒▒ osvm doctor</h3>
123126
<pre><code>osvm doctor [OPTIONS]
@@ -131,12 +134,20 @@ <h3>▒▒ osvm doctor</h3>
131134
Checks dependencies, configuration, connectivity</code></pre>
132135

133136
<h2>▓▓ Environment Variables</h2>
134-
<pre><code>OPENAI_URL AI endpoint URL (required for AI features)
135-
OPENAI_KEY AI API key (required for AI features)
136-
SOLANA_CONFIG Solana config path (optional)
137-
NO_COLOR Disable colors
138-
RUST_LOG Log level (debug, info, warn, error)
139-
RUST_BACKTRACE Show backtrace (0, 1, full)</code></pre>
137+
<pre><code>OPENAI_URL AI endpoint URL (REQUIRED for blockchain queries)
138+
• OpenAI: https://api.openai.com/v1/chat/completions
139+
• Ollama: http://localhost:11434/v1/chat/completions
140+
OPENAI_KEY AI API key (REQUIRED for blockchain queries)
141+
• OpenAI: sk-...
142+
• Ollama: ollama-key (any value)
143+
SOLANA_CONFIG Solana config path (optional for basic commands)
144+
NO_COLOR Disable colors (optional)
145+
RUST_LOG Log level: debug, info, warn, error (optional)
146+
RUST_BACKTRACE Show backtrace: 0, 1, full (optional)
147+
148+
<!-- AI features require OPENAI_URL and OPENAI_KEY -->
149+
<!-- Natural language queries won't work without these -->
150+
</code></pre>
140151

141152
<h2>▓▓ Exit Codes</h2>
142153
<table>

‎docs/pages/home.html‎

Lines changed: 24 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -21,9 +21,8 @@
2121

2222
<!-- Main Introduction -->
2323
<section class="intro animate-on-scroll" data-animation="slideUp">
24-
<h1>Solana Virtual Machine Command-Line Interface</h1>
25-
<p class="subtitle">AI-powered blockchain investigation tool with natural language queries, <strong>99.83% attack surface reduction</strong>,
26-
<strong>zero-downtime updates</strong>, and <strong>&lt;1ms communication</strong>
24+
<h1>AI-Powered Blockchain Investigation CLI</h1>
25+
<p class="subtitle"><strong>PRIMARY FEATURE:</strong> Natural language Solana blockchain queries powered by AI agents, OVSM LISP interpreter, and MCP tools. Plus: <strong>99.83% attack surface reduction</strong>, <strong>zero-downtime updates</strong>, and <strong>&lt;1ms communication</strong>
2726
</p>
2827

2928
<div class="badges">
@@ -54,7 +53,27 @@ <h2><span class="section-marker">[</span>QUICK START<span class="section-marker"
5453
</div>
5554
</div>
5655

56+
<div class="info-box" style="background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); color: white; margin: 2rem 0; padding: 1.5rem; border-radius: 8px;">
57+
<h3 style="color: white; margin-top: 0;">🚀 PRIMARY USE CASE: Blockchain Investigation</h3>
58+
<p style="margin-bottom: 1rem;">Ask questions about the Solana blockchain in natural language - the AI agent handles the rest!</p>
59+
<div class="command-line" style="background: rgba(0,0,0,0.3); padding: 1rem; border-radius: 4px;">
60+
<span class="prompt">$</span>
61+
<span class="command">osvm "show me all transactions for wallet ABC...XYZ in the last 24 hours"</span>
62+
<button class="copy-btn" onclick="copyToClipboard('osvm &quot;show me all transactions for wallet ABC...XYZ in the last 24 hours&quot;')">COPY</button>
63+
</div>
64+
</div>
65+
5766
<div class="command-grid">
67+
<div class="command-example animate-on-scroll" data-animation="slideLeft"
68+
onclick="copyToClipboard('osvm &quot;analyze DEX trades on Raydium&quot;')">
69+
<div class="command-line">
70+
<span class="prompt">$</span>
71+
<span class="command">osvm "analyze DEX trades on Raydium"</span>
72+
<span class="copy-indicator">CLICK TO COPY</span>
73+
</div>
74+
<div class="command-desc">AI-powered blockchain analysis</div>
75+
</div>
76+
5877
<div class="command-example animate-on-scroll" data-animation="slideLeft"
5978
onclick="copyToClipboard('osvm svm list')">
6079
<div class="command-line">
@@ -247,8 +266,8 @@ <h2><span class="section-marker">[</span>WHAT'S NEW<span class="section-marker">
247266
<div class="news-item animate-on-scroll" data-animation="slideLeft">
248267
<div class="news-badge">🎉 NEW</div>
249268
<h3><a href="#" data-cross-link="ovsm-language">OVSM LISP Interpreter</a></h3>
250-
<p>Complete LISP interpreter with 356/356 tests passing, 91+ built-in functions, and full Common Lisp compatibility.
251-
Production-ready with 97.3% test coverage.</p>
269+
<p>Production-ready LISP interpreter with 356/356 tests passing, 91+ built-in functions, and 83% Common Lisp compatibility.
270+
Powers AI blockchain queries automatically. <strong>LISP S-expression syntax only</strong> - the AI agent generates OVSM code for you!</p>
252271
<div class="news-meta">
253272
<span class="news-date">v0.9.6</span>
254273
<a href="#" data-cross-link="ovsm-language" class="news-link">Learn More →</a>

‎docs/pages/mcp-servers.html‎

Lines changed: 38 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -42,12 +42,12 @@ <h2>▓▓ Server Management</h2>
4242

4343
<div class="command-item">
4444
<code>osvm mcp add solana https://mcp.solana.com</code>
45-
<p>Add HTTP-based MCP server</p>
45+
<p>Add official Solana MCP server (canonical endpoint)</p>
4646
</div>
4747

4848
<div class="command-item">
49-
<code>osvm mcp add birdeye https://mcp.solana.com</code>
50-
<p>Add another MCP server for analytics</p>
49+
<code>osvm mcp add analytics https://mcp.solana.com</code>
50+
<p>Add MCP server for blockchain analytics</p>
5151
</div>
5252

5353
<div class="command-item">
@@ -133,16 +133,24 @@ <h2>▓▓ Configuration File</h2>
133133
"transport": "http",
134134
"auth": {
135135
"type": "bearer",
136-
"token": "YOUR_TOKEN"
136+
"token": "YOUR_TOKEN_HERE"
137137
}
138138
},
139139
{
140-
"name": "solana-analytics",
140+
"name": "analytics",
141141
"url": "https://mcp.solana.com",
142-
"transport": "http"
142+
"transport": "http",
143+
"auth": {
144+
"type": "bearer",
145+
"token": "YOUR_TOKEN_HERE"
146+
}
143147
}
144148
]
145-
}</code></pre>
149+
}
150+
151+
<!-- CANONICAL ENDPOINT: mcp.solana.com -->
152+
<!-- Replace example URLs with your actual MCP server endpoints -->
153+
</code></pre>
146154

147155
<h2>▓▓ Transport Types</h2>
148156
<ul>
@@ -160,15 +168,31 @@ <h2>▓▓ Authentication</h2>
160168
</ul>
161169

162170
<h2>▓▓ Integration with AI Chat</h2>
163-
<p>MCP servers are automatically available when using AI chat:</p>
164-
<pre><code>$ osvm chat
165-
> "Check balance for wallet ABC...XYZ"
166-
🤖 Using solana-mcp.getBalance tool...
171+
<p>MCP servers are automatically available when using AI-powered blockchain queries:</p>
172+
<pre><code>$ osvm "Check balance for wallet ABC...XYZ"
173+
🤖 AI Agent → OVSM LISP → MCP Tools
174+
🔍 Using mcp.solana.com getBalance tool...
167175
✓ Balance: 150.25 SOL
168176

169-
> "Show DEX trades"
170-
🤖 Using solana-mcp.getTradeHistory tool...
171-
✓ Found 23 trades in last 24h</code></pre>
177+
$ osvm chat
178+
> "Show DEX trades for this wallet"
179+
🤖 Generating OVSM execution plan...
180+
🔍 Using mcp.solana.com getTradeHistory tool...
181+
✓ Found 23 trades in last 24h
182+
183+
<!-- AI automatically routes to appropriate MCP tools -->
184+
</code></pre>
185+
186+
<div style="background: #2c3e50; border-left: 4px solid #3498db; padding: 1rem; margin-top: 1rem;">
187+
<p><strong>💡 How It Works:</strong> When you ask blockchain questions in natural language, the AI agent:</p>
188+
<ol>
189+
<li>Interprets your intent</li>
190+
<li>Generates OVSM LISP code</li>
191+
<li>Executes via configured MCP servers</li>
192+
<li>Returns formatted results</li>
193+
</ol>
194+
<p><strong>Canonical MCP Endpoint:</strong> <code>https://mcp.solana.com</code></p>
195+
</div>
172196
</div>
173197
</body>
174198
</html>

0 commit comments

Comments
 (0)