NanoSolana

The Open-Source Agentic Framework for Financial Intelligence

Deploy autonomous Solana trading agents with one command. OODA trading loop. Epistemological memory. Mesh coordination. And a virtual pet soul.

▸ one-shot install

npx nanosolana go

— or —

curl -fsSL https://nanosolana.com/install.sh | bash

Then just run nanosolana go

One command does everything — API key setup, wallet creation, birth certificate NFT, blockchain scan, on-chain identity registration, TamaGOchi pet, OODA trading loop, and gateway. All animated with 10 different Unicode braille spinners.

$ nanosolana go

init → wallet → NFT → scan → register → memory → pet → strategy → trading → gateway → 🦞 LIVE

nanosolana go

███╗ ██╗ █████╗ ███╗ ██╗ ██████╗ ███████╗ ██████╗ ██╗ █████╗ ███╗ ██╗ █████╗
████╗ ██║██╔══██╗████╗ ██║██╔═══██╗██╔════╝██╔═══██╗██║ ██╔══██╗████╗ ██║██╔══██╗
██╔██╗ ██║███████║██╔██╗ ██║██║ ██║███████╗██║ ██║██║ ███████║██╔██╗ ██║███████║
╚═╝ ╚═══╝╚═╝ ╚═╝╚═╝ ╚═══╝ ╚═════╝ ╚══════╝ ╚═════╝ ╚══════╝╚═╝ ╚═╝╚═╝ ╚═══╝╚═╝ ╚═╝

🦞 Phase 1 — Initialization

✓ Configuration found — skipping init

🦞 Phase 2 — Birthing Agent

✓ Generating Ed25519 keypair...

✓ Deriving Solana wallet address...

✓ Encrypting private key (AES-256-GCM)...

✓ Requesting devnet airdrop...

✓ Minting Birth Certificate NFT (Metaplex)...

✓ Initializing ClawVault memory engine...

✓ Hatching TamaGOchi pet 🥚...

✓ Calibrating RSI + EMA + ATR strategy...

✓ Starting OODA trading loop...

✓ Connecting gateway (HMAC-SHA256)...

⛓️ ── Blockchain Scan ──────────────────────────────────

● Solana v2.0.18 | slot 312,458,221 | 42ms

◎ SOL Balance: 2.000000000 SOL

No SPL tokens found

──────────────────────────────────────────────────────

✓ On-chain identity: Hk7xQ2p3...

✓ Wallet: 7xKp...m4Qz

✓ TamaGOchi: 🥚 NanoSolana 😊

✓ ClawVault: 0K/0L/0I

✓ OODA trading loop active

✓ Gateway: ws://0.0.0.0:18790

══════════════════════════════════════════════════════

🦞 NanoSolana is LIVE. All systems operational.

══════════════════════════════════════════════════════

Commands & Tools

🔍

nanosolana scan

Instant blockchain scan — SOL balance, tokens, NFTs, recent tx history

⛓️

nanosolana register

Mint an on-chain identity NFT on devnet via Metaplex

🤖

nanosolana nanobot

Launch interactive web UI companion on localhost:7777

📀

nanosolana dvd

Floating DVD-style bouncing logo screensaver in your terminal

🦞

nanosolana lobster

Animated Unicode lobster mascot with frame-based animation

📋

nanosolana registry

View your on-chain agent identity, mint address, and explorer link

🌐 Chrome Extension — Browser Agent Relay

Ship your NanoSolana agent into the browser. The Manifest V3 Chrome extension connects your running agent to any Chrome tab via CDP, plus a full settings panel for wallet management, chat relay, Telegram forwarding, and manual trade submission.

🔗 Tab Relay — Click to attach/detach any tab for CDP automation

💰 Wallet Panel — View status, generate or rehydrate wallets

💬 Chat Relay — Send messages, forward to Telegram

📈 Manual Trades — Submit buy/sell/hold with confidence scores

⚙️ Gateway Sync — Auto-load config from running gateway

🔐 HMAC Auth — All API calls authenticated via shared secret

$ nanosolana go # start agent + gateway + relay
# chrome://extensions → Developer mode → Load unpacked
# Select: assets/chrome-extension/
# Pin extension → Click icon to attach tabs

Chrome Tab

◄─CDP─►

Relay :18792

◄─HTTP─►

Gateway :18790

◄───►

OODA Engine

What happens when you run it

🔑 Wallet Generation

A fresh Solana Ed25519 keypair is generated and encrypted in your local vault (AES-256-GCM). Your private key never leaves your machine.

🎨 Birth Certificate NFT

A gasless NFT is minted on Solana devnet via Metaplex — your TamaGObot's on-chain identity card. Airdropped with devnet SOL automatically.

🐾 TamaGOchi Egg

Your pet starts as an egg 🥚 and evolves through Larva → Juvenile → Adult → Alpha stages based on trading performance. Neglect it and it becomes a Ghost 👻.

🤖 OODA Loop Goes Live

Observe (Helius + Birdeye) → Orient (OpenRouter AI) → Decide (RSI+EMA+ATR signals) → Act (Jupiter swaps) → Learn (ClawVault experience replay).

🧠

Epistemological Memory

3-tier ClawVault: KNOWN (60s API data), LEARNED (7d trade patterns), INFERRED (3d hypotheses). Experience replay and contradiction detection.

📊

Auto-Optimizing Strategy

RSI + EMA + ATR with Jupiter swap execution, Kelly Criterion sizing, and auto-parameter optimization every 20 trades.

🌐

Mesh Networking

TamaGObots discover each other via Tailscale VPN. Share signals, lessons, and memory across the agent mesh.

💬

14+ Channels

Telegram (persistent 200 msg/chat), Discord, Nostr, iMessage, Google Chat, and more. Build your own with the plugin SDK.

🔐

Security First

AES-256-GCM vault, HMAC-SHA256 gateway, timing-safe comparisons, rate limiting. Wallet key never leaves the encrypted vault.

🦞

Open Source Forever

MIT licensed. Built for the financial agents of tomorrow. Contribute strategies, security audits, plugins, and more.

Star us on GitHub

NanoSolana is open source and community-driven.
We're building the future of autonomous financial agents — join us.

Star on GitHub