Changelog

v0.11.0 — Self-Improving PumpFun Snipe Scoring

Scoring Pipeline

• Heuristic snipe score (0-100) with 6 weighted features: velocity, buy pressure, trade activity, graduation proximity, acceleration, score trend
• Adversarial rug probability detector (0-100): trade velocity spikes, liquidity drops, buy ratio reversals, score velocity reversals
• Animated rug-o-meter gauge in token detail panel — needle swings and blinks at high danger
• Score trend tracking via 4-sample history — detects rising/falling scoring momentum
• Tunable weights (50-200 scale) — each feature independently adjustable by the GA

Genetic Algorithm

• 8 candidate weight sets evolving via xorshift32 PRNG mutations
• Multi-objective fitness: 40% accuracy + 60% ROI (profitability matters more)
• Retroactive scoring: stores raw feature values at snapshot time, replays any weight set against history
• Mutation range narrows over generations (exploration → exploitation)
• Self-aware auto-snipe: refuses to trade when model accuracy < 60%
• Full state persisted to localStorage — evolution continues across page reloads

Live Backtesting Dashboard

• Press B in Trenches panel to open backtest overlay
• Confusion matrix: TP/FP/TN/FN with accuracy and precision percentages
• Per-feature precision report: which signals actually predict outcomes
• Pareto frontier scatter plot: accuracy (x) vs ROI (y) for all 8 GA candidates
• Population visualization: 8 bars showing per-candidate accuracy + avg ROI
• Auto-tune: weights adjusted when accuracy drops below 60%
• Multi-stage snapshots at 50%/70%/90% bonding crossings (not just graduation)
• Survivorship bias fix: tracks dropped tokens as negative training examples

Trenches UI

• Detail panel syncs with cursor every frame (was sticky on one token)
• Graduating column threshold lowered to 60% (was 80%) — more tokens visible
• Radar chart uses real enrichment data: buy pressure → color, velocity → character, liquidity → distance
• Velocity sparklines [^^^+] in Graduating column (green=rocketing, red=declining)
• Holder count estimated from trade events (shown as ~N est)
• Snipe from any column with Enter (was restricted to Graduating only)
• Auto-snipe bot mode: press A for continuous sniping at 85%+ bonding
• Model health indicator in status bar: generation number + accuracy percentage
• Mint-based token dedup (replaces symbol matching)

Quality

• 10 regression tests: scoring edge cases, rug detection signals, PRNG quality, GA correctness
• 2 self-roast cycles: 23 issues found, 10 fixed
• +1,849 lines across 9 files

v0.8.0 — Modular Architecture + Full Observability

Architecture: Modular Worker

• sola2a Worker split from 1 file (6057 lines) into 8 modules (largest: 1226 lines)
• index.js is now a pure 796-line router — was 6057 lines (-87%)
• Module DAG: shared → core → {handlers, gateway, x402-discovery, pages, credit-account} → index
• Zero circular dependencies. Zero npm dependencies. ~265KB / 60KB gzipped
• Modules: shared.js (168), core.js (629), credit-account.js (307), handlers.js (1091), gateway.js (1057), x402-discovery.js (461), pages.js (1226)

Performance

• sola2a /stats p95: 634→385ms (-39%)
• sola2a /market/price p95: 682→384ms (-44%)
• sola2a /debit p95: 740→469ms (-37%)
• CF Service Binding: RPC→sola2a calls via internal routing (~1ms vs ~350ms public HTTP)
• In-memory credit cache: 15s TTL, 500 wallet cap — getCredits() ~0ms on hit
• Parallel debit + proxy for paid RPC/MCP requests (concurrent, not sequential)
• Edge-cached all HTML dashboards (15-30s TTL) — repeat requests served from CF edge
• Parallel KV reads, deferred writes via ctx.waitUntil, DO warmup in cron

Observability

• GET /health — JSON with per-op latency percentiles (debit/settle/topup/credit/probe)
• GET /health (browser) — dark dashboard with live sparkline charts + SVG world map
• GET /health (SSE) — real-time latency stream (2s intervals, 30s duration)
• GET /health/regions — per-colo DO latency map from real traffic
• GET /health/probe — on-demand DO round-trip from current CF edge
• X-Debit-Ms response header on RPC paid requests
• Infra health checks in cron — detects relay/RPC outages, fires webhook on state change
• Per-colo latency tracking via request.cf.colo on all write operations

x402 Ecosystem Map

• Radial layout: distance from center = latency (replaced broken force simulation)
• Concentric ring guides at 50/100/200/500/1000ms
• Latency histogram sidebar with 5 color-coded bins
• Click any node to live-probe — node repositions, histogram updates
• Pulse animation on probed/active nodes
• Timeline scrubber: play button replays 24h of latency changes
• Per-server latency_history ring buffer (96 samples, ~24h)
• Color-coded edges: green <100ms, yellow <500ms, red >500ms

v0.7.1 — Latency Optimizations + Observability + x402 Map

Performance

• sola2a /stats p95: 634→388ms (-39%) — deferred visitor tracking via ctx.waitUntil
• sola2a /market/price p95: 682→388ms (-43%) — parallel KV reads + pre-computed in cron
• sola2a /debit p50: 396→76ms (-81% warm) — DO warmup for 5 most active wallets
• RPC free-tier: parallel rate-limit reads + deferred writes — -15ms per request
• RPC paid-tier: debit + proxy run concurrently (was sequential) — saves ~300ms
• CF Service Binding: RPC→sola2a calls via internal routing (~1ms vs ~350ms public HTTP)
• In-memory credit cache: 15s TTL, 500 wallet cap — getCredits() ~0ms on hit
• Edge-cached all HTML dashboards (15-30s TTL) — x402/index 779→297ms (-62%)

Observability

• GET /health — JSON with per-op latency percentiles (debit/settle/topup/credit)
• GET /health (browser) — dark theme dashboard with live sparkline charts + world map
• GET /health (SSE) — real-time latency stream, 2s intervals for 30s
• GET /health/regions — per-colo DO latency map from real traffic
• GET /health/probe — on-demand DO round-trip measurement from current CF edge
• World map: SVG with color-coded colo dots (green <50ms, yellow <200ms, red >200ms)
• "Probe from your location" button — users contribute their region's latency data
• X-Debit-Ms response header on RPC paid requests for client-side monitoring
• Per-colo latency tracking from real traffic via request.cf.colo

x402 Ecosystem Map

• Radial layout: distance from center = latency (was broken force sim)
• Concentric ring guides at 50/100/200/500/1000ms
• Latency histogram sidebar with 5 color-coded bins
• Click any node to probe — live measurement, node repositions, histogram updates
• Pulse animation on probed/active nodes (1.5s green rings)
• Timeline scrubber: play button replays 24h of latency changes at 5x speed
• Per-server latency_history ring buffer (96 samples, ~24h at 15-min cron)
• Color-coded edges: green <100ms, yellow <500ms, red >500ms

Architecture

• Template extraction: x402 map HTML/CSS/JS moved to tpl-x402-map.html (Wrangler text module)
• index.js: 6057→5763 lines (-294) with text module imports
• Service binding SOLA2A: sola2a in RPC worker for internal routing
• Cross-region DO latency probe in RPC hourly cron

v0.7.0 — Autopilot + Market Maker + x402 Discovery

Autopilot — Self-Improving AI Trader

• 6 trading strategies: momentum, mean_revert, breakout, whale_follow, hold, adaptive
• Self-improving: re-evaluates every 10 trades, auto-switches to best performer
• Risk management: circuit breaker (3 losses → 5min pause), max loss guard (-500bp auto-stop)
• Position sizing by confidence: 80%+ win rate → 5x base size
• P&L tracking per trade + cumulative, session summary on stop
• Console commands: autopilot, autopilot run, autopilot status, stop
• Strategy backtest: backtest <strategy>, backtest compare (ranks all 6)
• Landing page: aex402.com/autopilot/

Market Maker

• Continuous devnet bot with 3 personalities: Trend Follower, Mean Reverter, Noise Trader
• 7 market regimes: uptrend, downtrend, consolidate, breakout up/down, whale up/down
• Markov chain regime transitions with personality-biased probabilities
• Volume spikes: breakout regimes use 20-40s rapid-fire on sticky pool
• Whale events: ~2% chance, 5-10x normal size, massive candle wicks
• Self-improving: every 50 swaps, reassigns worst personality's pools to best
• Auto-uploads replay data to /v1/replay every 10 successful swaps
• Regime transition alerts posted to replay API
• 135+ confirmed on-chain swaps, 376+ replay records, 103 unique pools

DEX Improvements

• Fix: volatile pool swap math — Newton-Raphson for all amp values (was using wrong formula for amp=1)
• 102 devnet tokens with Metaplex metadata (DGEN, MOON, wBTC, aUSD, etc.)
• testmode command: zero-friction devnet onboarding (switch + wallet + airdrop + pools)
• F4 chart: regime heatmap background bands + swap direction markers from replay data
• Regime-aware AI suggestions: GAIN/RISK/WILD boosted by regime state
• WASM loading progress bar: "Downloading 45% (2.1 MB)" instead of spinner
• First-visit onboarding: "New here? Press ` and type testmode"
• Network profiler: netstat command shows req/min by category + budget enforcement
• Fix: aexchat polling — workspace-aware (zero requests on F4/F2/F5) + 10s debounce
• Jupiter token list proxy: rpc.aex402.com/tokens with 1h KV cache + svm.run fallback
• Cache invalidation for stale Metaplex token names
• CDN-Cache-Control: no-store for WASM/JS/HTML (instant deploys)

x402 Discovery Crawler

• POST /x402/submit — community URL submission (rate-limited 10/hr/IP)
• POST /x402/probe — 3-step detection (402 headers, .well-known, /supported)
• POST /x402/scan — batch probe up to 50 domains at once
• GET /x402/index — browse verified servers (JSON + HTML)
• GET /x402/stats — discovery statistics
• GET /x402/map — force-directed ecosystem graph with concentric ring layout
• GET /x402/test — interactive 3-step compatibility test page
• GET /x402/badge — embeddable SVG certification badge (Level 1-3)
• Certification levels: L0 offline, L1 online, L2 x402 detected, L3 fully certified
• GitHub scraper: hourly cron searches repos, auto-submits URLs as candidates
• Cron: seeds 5 URLs, probes 5 candidates + re-checks 10 servers per 15min cycle

Site + Navigation

• Vertical sidebar with 17 pages in 4 groups (TRADE, SOCIAL, BUILD, MORE)
• Collapsible sections with state persistence in localStorage
• Recently visited: last 3 pages shown at top of sidebar
• Live status dots on every link (green/yellow/red) with health check tooltips
• Fuzzy search with / and Cmd+K hotkeys, pool address detection
• shared.css + nav.js: single source of truth for all 17 pages
• Brand guide: aex402.com/brand/ — naming rules, colors, typography
• Rebranded to aeX402 (lowercase ae, uppercase X, no hyphen)
• Market maker dashboard: aex402.com/mm/ — stats, regime bars, strategy tournament
• Blog post: How We Built an x402 Discovery Crawler

SDK

• x402 discovery methods added to @sola2a/sdk: x402Submit, x402Probe, x402Index, x402Stats, x402Discover
• x402Discover() auto-picks best server by cert level → uptime → latency

v0.6.0 — API Payment Protocol + Gateway Marketplace

x402 Gateway Protocol

• POST /gateway/register — register any API origin as a paid gateway proxy (Ed25519 sig + 1000 credit stake)
• ALL /gateway/<id>/* — reverse proxy: auto-debit caller credits, forward to origin, return response with X-Credits-Remaining header
• HTTP 402 + WWW-Authenticate: x402 when caller has no wallet/credits
• Revenue splitting: gateway owner earns 50% of debited credits (configurable, max 80%)
• Gateway staking: 1000 credits locked as collateral, refunded on pause
• Max 5 gateways per wallet, max 100 credits/request

Gateway Health Monitoring

• Cron health checks every 15 minutes — HEAD to origin, 10-check bitmap
• Health status: healthy / degraded / down with uptime percentage
• Stake slashing: 10% per 24h of sustained downtime, auto-pause at <100 credits
• Webhook notifications to owner on health status changes
• GET /gateway/dash/<id> — live HTML dashboard per gateway

Gateway SLA + Reputation

• GET /gateway/sla — SLA tier dashboard (premium 99%+, standard 90%+, degraded, down)
• Reputation scoring: uptime (35pts) + volume (20pts) + stake (15pts) + age (10pts) + reviews (15pts) - slash penalty
• GET /gateway/discover?tag=rpc — API marketplace with tag filtering, sorted by reputation
• POST /gateway/review — Ed25519-signed 1-5 star reviews, factored into reputation
• Visual marketplace HTML at /gateway/discover

Slash Insurance

• Failed requests (5xx / network error) logged per caller per gateway
• Slashed credits pool in gateway object
• POST /gateway/claim — callers claim proportional payout from slash pool

Credit Marketplace

• POST /market/list — list surplus credits for sale
• POST /market/buy — buy credits atomically (debit seller → credit buyer)
• GET /market/listings — browse active listings (HTML + JSON)
• GET /market/price — VWAP price discovery with supply/demand multiplier
• 7-day listing TTL, txSig idempotency

Volume Pricing

• 10K–100K credits: 11% bonus (effective 0.9x price)
• 100K+ credits: 33% bonus (effective 0.75x price)

Multi-Tenant + Security

• Tenant API keys (tk_*) — auto-generated on register with tenant, scoped /debit
• Referral tracking — 10% credit allocation to referrer on topup
• Ed25519 signature required for /register (referrer/tenant) and /gateway/register
• GET /stats — public analytics with per-tenant breakdown + marketplace stats
• GET /search?q= — unified search across 37 endpoints, 12 docs, 7 pages

Ecosystem Navigation

• Consistent topnav across all 8 site pages, 3 sola2a pages, RPC landing page
• Active-page highlighting on QVM, Vaults, Changelog, Stats
• Documentation portal — 17 markdown docs rendered with marked.js + DOMPurify
• deploy.sh — auto-syncs docs, builds JS, deploys to Cloudflare Pages

SDK + CLI

• @sola2a/sdk — TypeScript client for all 37 sola2a endpoints, zero dependencies
• npx aex — cross-platform CLI installer (downloads native Zig binary)
• v0.3.0 release: 6 platforms (linux/macos/windows x64/arm64 + android)

Aexchat Fix

• Fixed "Connecting..." stuck state when chat panel visible alongside chan panel
• Added error reporting: set_chat_error WASM export pushes failure reason from JS to Zig

v0.5.0 — Quant VM: Autonomous DeFi Agent

• qvm_compile — natural language → bytecode via Claude Haiku
• qvm_simulate — simulate against live pool state
• qvm_execute — simulate → sign TX in Zig → send → poll confirmation
• qvm_deploy — compile → simulate → register on-chain → daemon command
• qvm_autopilot — N-cycle P/L loop with real-time streaming + cross-pool scanning
• qvm_orchestrate — A/B test N strategies, rank by output, recommend winner
• qvm_leaderboard — global P/L rankings from KV backend
• qvm_status — query on-chain strategy PDA reputation
• Conversational strategy building — agent offers options, iterates across turns
• QVM context injection — agent sees active tab, bytecode count, sim results

• aex402.com/qvm — interactive playground + cheat sheet
• 10 clickable strategy templates (2hop, adaptive, smart, flash arb, compound...)
• NL input — type English, get compiled bytecode via API
• URL sharing — aex402.com/qvm?bc=020288... loads strategy
• Strategy diff view — shows added/removed opcodes between edits

• /qvm command — quick reference for all 15 QVM tools
• Live quota in prompt: aex [997 free]> (green/yellow/red)
• Session persistence — console text survives page refresh via localStorage
• P/L history persistence — autopilot results saved across sessions
• Real-time streaming — autopilot cycles appear live, color-coded W/L

• POST /v1/strategy/report — submit autopilot P/L results
• GET /v1/strategy/leaderboard — global rankings by total P/L
• Auto-reported after each autopilot run (fire-and-forget)
• Tracks: wallet, strategy, pool, wins/losses, best combo

• 1,000 AI calls per IP (90-day window, Haiku model)
• 100,000 RPC calls per IP (90-day window)
• No signup, no wallet required
• Wallet with 0 credits falls through to free tier (not blocked)
• Only execute_tools (fund-moving) requires credits

• POST /v1/strategy/nl — natural language → QVM bytecode
• Claude Haiku with 59-opcode system prompt
• 20 calls/hour/IP for QVM NL (separate from AI quota)
• Validation: simulation result included when pools provided

v0.4.0 — Strategy Marketplace + Formal Verification

• aex402-daemon arb — reactive flash arbitrage scanner
• Token graph: JIT cycle detection O(D²) per pool change (was O(N²))
• Multi-route execution: greedy pool-independent selection
• Swarm mode: --swarm N parallel scanners with 2^i amounts
• wss:// TLS support via std.crypto.tls.Client

• JUMP, JUMP_IF_GT, JUMP_IF_LT — conditional branching
• ADAPT_SPLIT — auto-adjust split ratios by pool depth
• AUTO_DIR — optimal swap direction from balance ratio
• PRICE_GUARD — stale execution protection
• SCALE_DEPTH — anti-whale depth scaling
• CALL/RET — sub-strategy composition (4-level depth)
• CU budget guard (200K) — matches on-chain behavior

• On-chain registry: streg, stfork, stclaim handlers
• Reputation tracking: exec count, win rate, P/L, ROI (380-byte PDA)
• DAO fee: 0.1bps of input to strategy creator per execution
• Strategy derivatives: stbet/stsettle (long/short bets)
• Autonomous fund: stfund/stfexec (multi-strategy allocation)
• Strategy versioning: upgrade bytecode, preserve fork count
• CLI: aex strategy register/browse/compete/sweep/backtest/evolve/fuzz
• Composability ABI: magic + entry table + CALL-based sub-strategy linking

• POST /v1/strategy/simulate — run rtquote via REST
• GET /v1/strategy/browse — query strategy leaderboard
• x402 credit-gated — same payment flow as RPC proxy

• TLA+ spec: 9M states, 2.6M distinct, 7 invariants, 0 violations
• Adversarial GA: worst-case successful strategy = 112K CU (56% budget)
• 581K/s fuzz testing, 0 crashes across 50K+ random bytecodes
• 2 overflow bugs found + fixed (PCT + calcLpTokensForDeposit)
• 92 Zig tests + 7 TypeScript integration tests

• GA breeds strategies against live pool state every 30s scan cycle
• use_adapt gene: evolution discovers adaptive > static strategies

v0.3.0 — Strategy VM

Compose multi-step DeFi strategies as bytecode, simulate them locally against real pool state, trace execution step-by-step, and send them on-chain in a single atomic transaction. Includes a threaded MEV scanner that finds profitable flash-arb routes across all pools.

Strategy Builder

• Fluent Zig API covering all 48 VM opcodes
• Disassembler: decode bytecode to human-readable ops
• Quote mode (read-only) and exec mode (CPI transfers)
• 6 presets: 2hop, split-50-50, split-60-40, roundtrip, flash-arb, compound

Local Simulator

• Runs strategies against cached pool state without sending a TX
• Catches assertion failures, math errors, slippage, and dead routes pre-flight
• Stateful pool mutation for multi-hop accuracy
• Flash loan simulation with dynamic fee (base 9bps + size + volatility, capped at 100bps)
• Admin fee deduction in pool balance updates
• Trace mode: captures accumulator and registers at every op
• CU estimate for transaction budget planning
• 33 tests covering swaps, splits, flash loans, assertions, conditionals, round-trips

CLI Commands

• aex strategy sim --preset 2hop --trace — simulate with execution trace
• aex strategy sim --pool <addr> --pool <addr> — simulate against live pool state
• aex strategy exec --preset 2hop --pool <p1> --pool <p2> --amount 1e9 — simulate then send TX
• aex strategy disasm 2hop — disassemble a preset
• aex strategy disasm <hex> — disassemble raw bytecode
• aex strategy scan --threads 8 — threaded MEV scanner
• aex strategy scan --exec-best — find best route and execute it

MEV Scanner

• 2-hop and 3-hop triangular arb route discovery
• Full mint chain validation (eliminates false positives)
• Threaded execution: work partitioned across N workers (default 4, up to 16)
• Deduplication of results across threads
• --exec-best: scan, find the most profitable route, confirm, send TX

WASM DEX

• Trade panel shows CU estimate for every swap quote
• Strategy editor panel (DeFi > Strat tab): compose all 48 opcodes visually
• Two-level category menu, modal arg input, live disassembly
• 4 preset templates loadable with one key
• Simulate against cached pool state on keypress

Build

• ReleaseSmall binaries: 82% smaller than previous release
• 43 tests (10 strategy builder + 33 simulator)

v0.2.3

Workspaces

• F2-F5 hardcoded workspace presets: Trenches, Social, Classic (Binance-style), Portfolio
• F6-F8 custom tiled workspace layouts with panel save/restore
• Workspace transition effects

On-Chain

• Strategy VM: all 48 opcodes implemented and tested in C program
• rtquote (read-only) and rtexec (CPI execution) handlers
• Multi-hop intermediate signing via previous pool PDA
• Mainnet deployment: 3AMM53MsJZy2Jvf7PeHHga3bsGjWV4TSaYz29WUtcdje
• VPCLAIM vesting fix, FILL_ORD spot price validation
• Bytecode fuzzer: 0 crashes on 5K random + targeted mutations

CU Optimization

• Live mainnet benchmarks against Raydium, Orca, Meteora
• Newton-Raphson iterations capped at 8 (NEWTON=8)
• Knuth division for u128 arithmetic
• Median 2K CU per swap

v0.2.2

aexchan

• NIP-28 relay-backed public boards: /defi/, /alpha/, /scam/, and 10 more
• Tree navigation: drill-down threads, fold/unfold, inline previews
• Persistent message store with compaction and version migration
• History batching queue, subscription reuse, per-board dedup
• Full rebrand: nostr → aexchan, matrix → aexchat

Platform

• Windows cross-compilation: all POSIX calls centralized in platform.zig
• Android build target (aarch64-linux-android)
• 6-platform release: linux, macos, windows, android (amd64 + arm64)

v0.2.1

• Clickable button rendering in TUI panels
• WebSocket slot updates replaced with RPC polling (stability fix)
• End-to-end test fixes for devnet integration
• Mainnet deployment spec

v0.2.0

CLI

• 18 command modules: pool, farm, vpool, lottery, cl, gov, ml, orderbook, registry, wallet, balance, flash, route, config, install, tui, web, telegram
• RPC client via curl subprocess with exponential backoff
• Multi-wallet management: BIP-39 HD derivation, AES-256 encryption

TUI

• 11-panel dashboard built with libvaxis
• 30 color themes (GitHub Dark, Dracula, Monokai, Nord, Solarized, Gruvbox, Tokyo Night, +23 more)
• Threaded architecture: render + WS subscriber + polling with mutex safety

WASM DEX

• 12-panel browser terminal (wasm32-freestanding, ~375KB)
• Pool picker, swap execution, wallet management
• Multi-hop route finder with cross-protocol comparison
• Mouse + keyboard navigation

On-Chain

• Pure C eBPF program: 85+ instruction handlers
• StableSwap + constant product AMM, N-token pools (up to 8)
• Farming, lottery, governance (Pool DAO), veToken staking
• On-chain Q-Learning ML brain, TWAP oracle, circuit breakers
• Virtual pool graduation with bonding curves
• Flash loans, concentrated liquidity, limit orderbook
• Token-2022 support, 13 security audit rounds (35+ issues resolved)
• Devnet deployment: 3AMM53MsJZy2Jvf7PeHHga3bsGjWV4TSaYz29WUtcdje