Powered by x402 Protocol ยท Go Runtime ยท NanoSolana Labs

NanoSolana TamaGObot

A GoBot on Solana โ€” autonomous trading intelligence with a virtual pet soul.
Physical companion: TamaGOchi (Arduino Modulinoยฎ I2C) ยท By NanoSolana Labs

9.6MB Binary Size
<10MB RAM Usage
<1s Boot Time
7+ I2C Sensors
nanosolana daemon

        

Real-Time Agent Trading Stats

Point the docs page at a running NanoBot instance and it will stream the current daemon, wallet, OODA, and recent trade snapshot directly from the local API.

Waiting for connection
Daemon unknown
OODA Mode unknown
Wallet not loaded
Wallet SOL 0.0000
Watchlist 0
Cycle Count 0
Open Positions 0
Closed Trades 0

Recent Trades

No snapshot yet
No recent trades available.

    Raw Snapshot

    /api/status
    {}

    What Changed in the Live Go Runtime

    The docs now match the current daemon: local-first MiniMax, native Claude support, cleaner Telegram ops, remote gateway/Tailscale access, and an upgraded live status view.

    ๐Ÿง 

    MiniMax M2.7 Default

    minimax-m2.7:cloud is now the default local Ollama harness model for normal chat, /deepsolana, and skill-aware Solana assistance.

    ๐Ÿค–

    Claude is First-Class

    Anthropic is wired in as a native backend, and Claude Code session workflows still remain available for repo creation, coding, and GitHub automation.

    ๐Ÿ“ฑ

    Telegram is Operator-Grade

    Inline menus, callback actions, smarter natural language, GitHub creation fixes, /personality, and a cleaner /status are now part of the default bot UX.

    ๐ŸŒ

    Tailscale + Remote Gateway

    The gateway now supports Tailscale Serve/Funnel patterns and remote-over-SSH setup modeled on the OpenClaw-style control path.

    ๐Ÿ”Ž

    Grok Search Repaired

    /web and /xsearch now route through the proper Grok tool model instead of the broken generic chat payload path.

    ๐Ÿ“Š

    Ops-Grade Status

    /status now reports daemon runtime, active model, wallet, Honcho, Aster, Hyperliquid, and service health without exposing raw Solana program failure text.

    Everything You Need to Trade Autonomously

    From market data ingestion to hardware LED feedback โ€” one binary does it all.

    ๐Ÿ”„

    OODA Trading Loop

    Observe โ†’ Orient โ†’ Decide โ†’ Act. Continuous autonomous cycle pulling Helius RPC, Birdeye OHLCV, and Aster perps data.

    ๐Ÿง 

    ClawVault Memory

    3-tier epistemological memory: Known (fresh API data) โ†’ Learned (trade patterns) โ†’ Inferred (cross-asset correlations).

    ๐Ÿงฌ

    Honcho Solana Memory

    Telegram sessions become structured trading memory: summaries, peer cards, conclusions, and recalled user preferences for Solana spot and perps.

    ๐Ÿ“Š

    RSI + EMA + ATR Strategy

    Multi-condition signal engine with auto-optimizer. Parameters adjust based on rolling trade performance.

    ๐Ÿ’ฐ

    x402 Payment Protocol

    Monetize your bot's API with crypto-gated endpoints. Multi-chain USDC payments via Solana, Base, Polygon.

    ๐ŸŽ›๏ธ

    Arduino Modulinoยฎ I2C

    8ร— RGB LEDs, buzzer, 3 buttons, rotary knob, IMU, thermometer, ToF sensor. Physical trading feedback.

    ๐ŸŸข

    NVIDIA Edge AI

    Native ARM64 binary for Orin Nano and Spark. Deploy via Brev.dev GPU cloud or bare-metal JetPack.

    ๐Ÿ”‘

    Agentic Wallet

    Auto-generates and persists a Solana keypair on first boot. Standard keygen format, 0600 permissions.

    ๐Ÿ“ฑ

    Telegram Bot

    Telegram Bot API integration with long polling, inline dashboards, operator personalities, strict TELEGRAM_ID access control, and natural-language Aster, GitHub, and research workflows.

    ๐Ÿน

    TamaGObot Pet Engine

    Virtual pet evolves based on on-chain performance: Egg โ†’ Larva โ†’ Juvenile โ†’ Adult โ†’ Alpha. Mood driven by P&L.

    ๐Ÿ“ˆ

    Hyperliquid Perps

    EVM perpetuals on Hyperliquid. Open, close, and cancel positions from Telegram with EIP-712 L1 action signing โ€” no web UI needed.

    Architecture

    A single daemon orchestrates wallet, RPC, pet engine, Telegram, x402, and hardware โ€” all in <10MB.

    OBSERVE Helius ยท Birdeye ยท Aster
    โ†’
    ORIENT RSI ยท EMA ยท ATR ยท Memory
    โ†’
    DECIDE Signal Gate ยท Confidence
    โ†’
    ACT Jupiter ยท SOL Transfer
    LEARN Auto-Optimize ยท Vault
    ๐Ÿน TamaGOchi Mood ยท XP ยท Evolution
    ๐ŸŽ›๏ธ Hardware Modulinoยฎ I2C Bus
    ๐Ÿ’ฐ x402 USDC Paywall
    โ›“๏ธ

    Solana Stack

    • Helius RPC + WebSocket
    • Birdeye Market Data
    • Jupiter DEX Aggregator
    • Aster Perp Futures
    • Hyperliquid EVM Perps
    ๐Ÿ—๏ธ

    Build Targets

    • NVIDIA Orin Nano (ARM64)
    • Raspberry Pi (ARM64)
    • RISC-V (riscv64)
    • macOS Apple Silicon
    ๐Ÿ“ก

    Channels

    • Telegram Bot (zero-dep)
    • Discord (planned)
    • CLI Interactive REPL
    • x402 Paywall API

    ๐Ÿง  Honcho Solana Memory

    Honcho turns Telegram chat turns into durable Solana trading memory. The daemon now creates workspace-aware sessions, models peers, writes trading conclusions, and recalls the right summary before the next trade or research step.

    1

    Capture

    User messages, bot replies, wallet context, watchlists, and session mode are stored in a Honcho session.

    2

    Model

    Honcho builds summaries, peer cards, and representations for the user and the agent inside the trading workspace.

    3

    Conclude

    Repeated preferences become explicit conclusions: preferred tokens, spot vs perps bias, and risk posture.

    4

    Recall

    Before responding, the bot injects summaries and matched conclusions back into prompt context for the next decision.

    ๐Ÿ“˜

    Session Objects

    • Trading-aware session config
    • Workspace metadata
    • Per-message reasoning config
    • File upload support
    ๐Ÿ‘ฅ

    Peer Modeling

    • User + agent peer IDs
    • Observe-me / observe-others
    • Peer cards and representations
    • Perspective-specific recall
    ๐Ÿ“ˆ

    Trading Conclusions

    • Token interest tracking
    • Spot / perps preference
    • Risk appetite inference
    • Semantic conclusion search
    honcho memory replay
    Session ingest BONK
    Telegram turn

    Loading memory turnโ€ฆ

    Session summary

    Waiting for summaryโ€ฆ

    Derived conclusion

    No conclusion yet.

    Prompt recall

    Recalled context will appear here.

    telegram memory commands
    # Inspect the new memory layer
    /honcho_status                 โ†’ workspace, model, and bridge status
    /honcho_context                โ†’ messages + summaries + recalled conclusions
    /honcho_sessions               โ†’ list tracked trading sessions
    /honcho_summaries              โ†’ short and long session summaries
    /honcho_search bonk scalps    โ†’ search messages inside the active session
    /honcho_messages               โ†’ recent stored turns
    /honcho_conclusions BONK       โ†’ semantic trading conclusions

    Arduino Modulinoยฎ + NVIDIA Orin Nano

    Software intelligence bridged with physical hardware. 7 sensors over a single Qwiic I2C cable.

    ๐Ÿ’ก

    Pixels 0x6C

    8ร— RGB LEDs โ€” LC8822

    Status: idle ๐Ÿ”ต signal ๐ŸŸฃ trade ๐ŸŸก win ๐ŸŸข loss ๐Ÿ”ด
    ๐Ÿ”Š

    Buzzer 0x3C

    PKLCS1212E โ€” Tone Generator

    Audio alerts for signals, trades, wins, errors
    ๐Ÿ”˜

    Buttons 0x7C

    3ร— Push + LED

    A = trigger cycle ยท B = toggle mode ยท C = e-stop
    ๐ŸŽ›๏ธ

    Knob 0x76

    PEC11J โ€” Rotary Encoder

    Real-time RSI threshold tuning
    ๐Ÿงญ

    Movement 0x6A

    LSM6DSOX โ€” 6-axis IMU

    Tilt detection โ†’ auto-pause trading
    ๐ŸŒก๏ธ

    Thermo 0x44

    HS3003 โ€” Temp + Humidity

    Environment logging to ClawVault
    ๐Ÿ“ก

    Distance 0x29

    VL53L4CD โ€” Time-of-Flight

    Proximity wake-up (<5cm triggers cycle)

    Supported Platforms

    ๐ŸŸข

    NVIDIA Orin Nano

    make orin
    โ˜๏ธ

    Brev.dev Spark

    brev create nanosolana --gpu
    ๐Ÿ“

    Raspberry Pi

    make rpi
    ๐ŸŽ

    macOS (Stub)

    make macos

    ๐Ÿน TamaGObot

    Your GoBot has a soul. A virtual pet whose life is driven by real on-chain performance. Physical companion: TamaGOchi (Arduino Modulinoยฎ I2C).

    ๐Ÿฅš Egg First boot
    โ†’
    ๐Ÿฆ Larva Wallet created
    โ†’
    ๐Ÿน Juvenile 10+ trades
    โ†’
    ๐Ÿน Adult 50+ trades, >40% WR
    โ†’
    ๐Ÿ‘‘ Alpha 200+ trades, >55% WR
    nanosolana pet
    ๐Ÿฅš NanoSolana  ๐Ÿ˜
    
    ๐Ÿ“Š Stage: egg ยท Level 1 ยท XP 0
    ๐Ÿ˜ Mood: neutral
    โšก Energy: โšกโšกโšกโšกโšกโšกโšกโšกโšกโšก
    ๐Ÿฝ๏ธ Hunger: ๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข
    
    ๐Ÿ“ˆ Trades: 0 ยท Win Rate: 0%
    ๐Ÿ’ฐ Balance: 0.0000 SOL
    ๐Ÿ“Š Total PnL: +0.0000 SOL
    ๐Ÿ”ฅ Streak: +0
    โฑ๏ธ Age: 0s ยท Uptime: 0h

    Mood System

    ๐Ÿคฉ Ecstatic ๐Ÿ˜Š Happy ๐Ÿ˜ Neutral ๐Ÿ˜ฐ Anxious ๐Ÿ˜ข Sad ๐Ÿ˜ด Sleeping ๐Ÿคค Hungry

    Mood is driven by streak, PnL, and wallet balance in real-time.

    ๐Ÿ’ฐ x402 โ€” Crypto-Gated APIs

    Monetize your GoBot's intelligence. Accept USDC payments per API call across multiple chains.

    ๐Ÿ“ฑ
    Client
    Sends request with
    X-PAYMENT header
    0.001 USDC
    ๐Ÿน
    NanoSolana Paywall
    Verifies payment
    Serves API response
    Verify + Settle
    ๐Ÿฆ
    x402 Facilitator
    facilitator.x402.rs
    On-chain settlement

    Supported Chains

    โ—Ž Solana
    ๐Ÿ”ต Base
    ๐ŸŸฃ Polygon
    ๐Ÿ”บ Avalanche
    x402 paywall endpoints
    GET /health          โ€” free
    GET /x402/info       โ€” free
    GET /api/signals     โ€” 0.001 USDC per call
    GET /api/research    โ€” 0.001 USDC per call
    GET /api/agent       โ€” 0.001 USDC per call

    ๐Ÿ“ˆ Hyperliquid โ€” Trade Perps from Telegram

    Full Hyperliquid perpetuals integration โ€” open longs and shorts, manage positions, and cancel orders directly from Telegram. EIP-712 L1 action signing with msgpack encoding, no web UI required.

    ๐Ÿ”

    EIP-712 Signing

    • Phantom agent EIP-712
    • msgpack L1 action encoding
    • chainId 1337 (mainnet)
    • ECDSA secp256k1
    โšก

    Order Types

    • IOC market open (long/short)
    • Reduce-only market close
    • Configurable slippage %
    • Cancel all orders
    ๐Ÿค–

    Telegram Commands

    • /hl ยท /hl_balance
    • /hl_positions ยท /hl_orders
    • /hl_open ยท /hl_close
    • /hl_cancel
    hyperliquid telegram commands
    # Setup in .env
    HYPERLIQUID_PRIVATE_KEY=0x...
    HYPERLIQUID_WALLET=0x...
    
    # Account overview
    /hl                           โ†’ account value, margin, open positions
    /hl_balance                   โ†’ quick balance + withdrawable
    /hl_positions                 โ†’ open perps: side, size, entry, PnL, leverage
    /hl_orders                    โ†’ open limit orders
    
    # Trading
    /hl_open BTC long 0.01        โ†’ open BTC long, 0.01 BTC, 5% slippage
    /hl_open ETH short 0.1 2%     โ†’ open ETH short with 2% slippage
    /hl_close BTC                  โ†’ close full BTC position
    /hl_close SOL 10               โ†’ partial close 10 SOL
    /hl_cancel                     โ†’ cancel all open orders

    ๐Ÿง  MiniMax M2.7 โ€” Local Harness Default

    The live Go runtime now defaults to minimax-m2.7:cloud via Ollama. It sits inside the normal NanoSolana harness, so system prompt, Solana context, Honcho memory, and skill injections all reach the same local-first model path.

    200K
    Context Window
    Ollama
    Default Backend
    Skills
    Still In Harness
    Claude
    Native Optional Backend
    xAI
    Search + Media Tools
    โšก Ollama โ€” One Command
    terminal
    # Pull and run the default local harness model
    ollama run minimax-m2.7:cloud
    
    # Or pull first, run later
    ollama pull minimax-m2.7:cloud
    View on Ollama โ†’
    ๐Ÿค– Use in Claude Code / Codex / OpenCode
    agent launch
    # Claude Code
    ollama launch claude --model minimax-m2.7:cloud
    
    # Codex
    ollama launch codex --model minimax-m2.7:cloud
    
    # OpenCode
    ollama launch opencode --model minimax-m2.7:cloud
    
    # OpenClaw
    ollama launch openclaw --model minimax-m2.7:cloud
    ๐Ÿ”— Use with NanoSolana Daemon
    .env
    # Make MiniMax the daemon default
    LLM_PROVIDER=ollama
    OLLAMA_MODEL=minimax-m2.7:cloud
    OLLAMA_BASE_URL=http://127.0.0.1:11434
    
    # Optional native Claude backend
    ANTHROPIC_API_KEY=sk-ant-...
    ANTHROPIC_MODEL=claude-sonnet-4-6
    
    # Restart daemon to pick up
    nanosolana daemon

    Harness Behavior

    Layer Current behavior Why it matters
    Default routing Normal chat resolves to Ollama first MiniMax is the live default
    System prompt Uses the existing NanoSolana harness prompt Solana tools and skills still apply
    /deepsolana Targets the configured Ollama harness model No hardcoded model branch
    /model Accepts bare Ollama refs like minimax-m2.7:cloud Cleaner operator switching
    Hosted providers Anthropic and xAI remain available Local-first without losing fallbacks
    ๐Ÿ“„ Download Agent Skill Sheet Give this file to any AI agent to install NanoSolana in one shot
    MiniMax M2.7 Local-first Ollama compatible Anthropic supported Skill-aware Solana-native prompt Telegram harness

    Quick Start

    โšก One-Shot Install (curl / npm)

    Install NanoSolana from GitHub or the published npm package, then run nanosolana from anywhere.

    curl install
    curl -fsSL https://raw.githubusercontent.com/x402agent/nanosolana-go/main/install.sh | bash
    with web console
    curl -fsSL https://raw.githubusercontent.com/x402agent/nanosolana-go/main/install.sh | bash -s -- --with-web
    npm / npx install
    npx nanosolana-cli install --with-web
    global CLI
    npm install -g nanosolana-cli
    nanosolana version

    Installs: ~/nanosolana/build/nanosolana, a stable CLI at ~/.nanosolana/bin/nanosolana, the agent wallet, ClawVault workspace, and the optional web console.

    1

    Clone & Build

    $ git clone https://github.com/x402agent/nanosolana-go.git
    $ cd nanosolana-go
    $ cp .env.example .env
    $ make build
    $ ./build/nanosolana version
    2

    Configure

    # Edit .env with your API keys
    HELIUS_API_KEY=your_key_here
    HELIUS_RPC_URL=https://mainnet.helius-rpc.com/?api-key=KEY
    BIRDEYE_API_KEY=optional
    3

    Run

    $ nanosolana daemon
    ๐Ÿน TamaGOchi โ€” A GoBot on Solana
    ๐Ÿ”‘ Agent wallet: 7xKXqR8...3vBp
    ๐Ÿค– Telegram: @YourBot connected
    ๐Ÿ’ฐ x402 paywall: :18402

    ๐Ÿงฉ Publish Your Own NanoSolana Skill to NanoHub

    Package your skill folder and publish it to hub.nanosolana.com via npm.

    1) login
    npx @nanosolana/nanohub login
    2) publish
    npx @nanosolana/nanohub publish ./my-skill \
      --slug my-skill \
      --name "My Skill" \
      --version 1.0.0 \
      --tags latest,solana

    Requirements: SKILL.md (or skills.md), text files only, and a semver version.

    ๐Ÿน NanoSolana TamaGObot Theme
    0:00
    0:00