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

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

What is Solana Robotics?

Solana Robotics is an open-source platform combining AI agents, blockchain automation, and physical robotics—all powered by the Solana blockchain and the $CLAWD token. Built for 1,000+ developers with a modular, scalable architecture.

┌──────────────────────────────────────────────────────────────────────────────────────┐
│                           SOLANA ROBOTICS ECOSYSTEM                                   │
├──────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                       │
│    ┌─────────────────┐         ┌─────────────────┐         ┌─────────────────┐       │
│    │   NVIDIA ISAAC  │────────▶│  SOLANA CHAIN   │◀────────│  $CLAWD TOKEN   │       │
│    │   Jetson Orin   │         │  Robot Registry │         │   x402 Protocol │       │
│    └────────┬────────┘         └────────┬────────┘         └────────┬────────┘       │
│             │                           │                           │                │
│             ▼                           ▼                           ▼                │
│    ┌─────────────────┐         ┌─────────────────┐         ┌─────────────────┐       │
│    │     COSMOS      │         │      TASK       │         │  VIBE TO EARN   │       │
│    │   World Model   │────────▶│   MARKETPLACE   │◀────────│    Developer    │       │
│    │  (Perception)   │         │    (Escrow)     │         │    Rewards      │       │
│    └────────┬────────┘         └────────┬────────┘         └────────┬────────┘       │
│             │                           │                           │                │
│             ▼                           ▼                           ▼                │
│    ┌─────────────────┐         ┌─────────────────┐         ┌─────────────────┐       │
│    │    NEMOTRON     │         │     ELIZA       │         │     ROBOT       │       │
│    │   (Reasoning)   │────────▶│     ROBOT       │◀────────│    PASSPORT     │       │
│    │     340B LLM    │         │   (elizaOS)     │         │   (NFT ID)      │       │
│    └─────────────────┘         └─────────────────┘         └─────────────────┘       │
│                                                                                       │
└──────────────────────────────────────────────────────────────────────────────────────┘

Core Capabilities

$CLAWD Token

Token Utility

┌────────────────┐    ┌────────────────┐    ┌────────────────┐    ┌────────────────┐
│    REGISTER    │    │      PAY       │    │    GOVERN      │    │     EARN       │
│                │    │                │    │                │    │                │
│  Stake $CLAWD  │    │  Task rewards  │    │  Vote on       │    │  Vibe to Earn  │
│  to register   │───▶│  and x402      │───▶│  protocol      │───▶│  developer     │
│  your robot    │    │  micropayments │    │  decisions     │    │  rewards       │
└────────────────┘    └────────────────┘    └────────────────┘    └────────────────┘

Staking Tiers

Quick Start

Prerequisites

Installation

# Clone the repository
git clone https://github.com/8bitsats/Solana-Robotics-Kit.git
cd Solana-Robotics-Kit

# Configure environment (never commit .env)
cp .env.example .env

# Install JS dependencies
pnpm install

# Or use the helper
./start.sh install
./start.sh web

Start the Operator Console / Dashboard

pnpm dev
# Opens the tRPC server + Vite client integration

Open http://localhost:3000 (or the port printed by Vite) to access the dashboard.

Run a Robot Daemon

python -m apps.robot_daemon.main \
  --task-runner \
  --capabilities navigation,delivery \
  --poll-s 5

Token Operations ($CLAWD)

# Gate / balance checks use mint:
# 8cHzQHUS2s2h8TzCmfqPKYiM4dSt4roa3n7MyRLApump
# Override with CLAWD_TOKEN_ADDRESS or TOKEN_ADDRESS in .env

# Jupiter swap (browser)
# https://jup.ag/swap/SOL-8cHzQHUS2s2h8TzCmfqPKYiM4dSt4roa3n7MyRLApump

Eliza Robot

Full elizaOS monorepo lives under eliza/. Character:

• eliza/characters/solana-robotics-clawd.json
• Bridge notes: agents/eliza_robot/README.md

./start.sh eliza-install
./start.sh eliza
# or:
cd eliza && bun install && bun run dev

Skills under eliza/skills/ include clawd-token-ops, Solana, Helius, trading, and more.

Architecture

Scalable Design

Built for 1,000+ developers with:

• Modular packages — clear separation of concerns
• Clear navigation — easy to find components
• Developer-friendly — clear entry points and docs
• Professional structure — industry-standard organization

System Layers

┌─────────────────────────────────────────────────────────────────────────────────────┐
│                              APPLICATION LAYER                                       │
│  ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐                   │
│  │  Operator        │  │  Robot           │  │  Vibe to Earn    │                   │
│  │  Console (Vite)  │  │  Daemon (Python) │  │  API (FastAPI)   │                   │
│  └──────────────────┘  └──────────────────┘  └──────────────────┘                   │
├─────────────────────────────────────────────────────────────────────────────────────┤
│                                AI / AGENT LAYER                                      │
│  ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐                   │
│  │  NVIDIA Cosmos   │  │  NVIDIA Nemotron │  │  Eliza Robot     │                   │
│  │  (Perception)    │  │  (Reasoning)     │  │  (elizaOS)       │                   │
│  └──────────────────┘  └──────────────────┘  └──────────────────┘                   │
├─────────────────────────────────────────────────────────────────────────────────────┤
│                             BLOCKCHAIN LAYER                                         │
│  ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐  ┌─────────────┐  │
│  │  Robot           │  │  Task            │  │  Action          │  │  $CLAWD     │  │
│  │  Registry        │  │  Marketplace     │  │  Log             │  │  Token      │  │
│  └──────────────────┘  └──────────────────┘  └──────────────────┘  └─────────────┘  │
├─────────────────────────────────────────────────────────────────────────────────────┤
│                              HARDWARE LAYER                                          │
│  ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐                   │
│  │  NVIDIA Jetson   │  │  Sensors         │  │  Asimov v1       │                   │
│  │  Orin Nano       │  │  (LiDAR, Camera) │  │  (25 DOF)        │                   │
│  └──────────────────┘  └──────────────────┘  └──────────────────┘                   │
└─────────────────────────────────────────────────────────────────────────────────────┘

Monorepo Layout

Documentation

Bags SDK Integration

The platform integrates with the Bags SDK for partner fee management and token operations.

from packages.vibe_to_earn.bags_integration import BagsSDKClient

# Initialize client
client = BagsSDKClient(api_key="your_bags_api_key")

# Get partner fee stats
stats = await client.get_partner_claim_stats()
print(f"Unclaimed fees: {stats.unclaimed_sol} SOL")

# Claim partner fees
signature = await client.claim_partner_fees()
print(f"Claimed! Transaction: {signature}")

# Get $CLAWD token lifetime fees
fees = await client.get_token_lifetime_fees("8cHzQHUS2s2h8TzCmfqPKYiM4dSt4roa3n7MyRLApump")
print(f"Lifetime fees: {fees} SOL")

NVIDIA Integration

Supported Hardware

AI Models

from packages.nim_client import NIMClient

# Initialize NVIDIA NIM client
nim = NIMClient()

# Cosmos - World model for perception
perception = await nim.cosmos.perceive(camera_frame)

# Nemotron - 340B reasoning model
reasoning = await nim.nemotron.reason(
    context=perception,
    task="Navigate to delivery point while avoiding obstacles"
)

# Isaac - Robot control
await nim.isaac.execute(reasoning.actions)

See docs/ORIN_NANO_SETUP.md for detailed setup instructions.

Roadmap

Phase 1: Foundation

• Robot Registry on-chain program
• Task Marketplace with escrow
• $CLAWD token integration
• x402 protocol support
• Operator Console web app
• Robot Passport NFTs
• Blender MCP integration
• NVIDIA NIM client
• Voice synthesis (OpenVoice + MeloTTS)
• Vibe to Earn platform
• Eliza robot (elizaOS) monorepo

Phase 2: Intelligence (Current)

• Multi-robot coordination
• NVIDIA Cosmos perception
• Nemotron 340B reasoning
• Fleet management dashboard
• Autonomous task discovery

Phase 3: Ecosystem

• DAO governance with $CLAWD
• Third-party integrations
• Hardware partnerships (NVIDIA, Boston Dynamics)
• Mainnet deployment
• Enterprise SLAs

Contributing

We welcome contributions! Earn $CLAWD tokens through the Vibe to Earn program.

# Fork, clone, and create a branch
git clone https://github.com/YOUR_USERNAME/Solana-Robotics-Kit.git
git checkout -b feature/your-feature

# Make changes and test
pnpm test
python -m pytest tests/   # if applicable

# Submit PR with conventional commits
git commit -m "feat: add new robot capability"
git push origin feature/your-feature

See CONTRIBUTING.md for detailed guidelines.

Contribution Rewards

Enterprise Support

For enterprise deployments, we offer:

Contact: enterprise@solanarobotics.org

Community

License

Vibe to Earn - Developer Rewards

Contribute code, earn $CLAWD tokens! The Vibe to Earn platform rewards developers who actively participate in the Solana Robotics ecosystem.

┌────────────────────────────────────────────────────────────────────────────────────┐
│                              VIBE TO EARN PLATFORM                                  │
├────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                     │
│  ┌──────────────┐      ┌──────────────┐      ┌──────────────┐      ┌─────────────┐│
│  │   CONTRIBUTE │      │    TRACK     │      │    EARN      │      │   CLAIM     ││
│  │              │      │              │      │              │      │             ││
│  │  Commits     │─────▶│  GitHub      │─────▶│  $CLAWD      │─────▶│  Wallet     ││
│  │  PRs, Issues │      │  Webhooks    │      │  Tokens      │      │  Transfer   ││
│  └──────────────┘      └──────────────┘      └──────────────┘      └─────────────┘│
│                                                                                     │
└────────────────────────────────────────────────────────────────────────────────────┘

Reward Structure

Getting Started with Vibe to Earn

# 1. Register as a developer
curl -X POST https://api.solanarobotics.org/vibe/developers/register \
  -H "Content-Type: application/json" \
  -d '{"github_username": "your-username", "wallet_address": "YourSolanaWallet"}'

# 2. Start contributing to the repo!

# 3. Claim your rewards
curl -X POST https://api.solanarobotics.org/vibe/rewards/claim \
  -d '{"github_username": "your-username"}'

Read the full Vibe to Earn guide