Solarium

Node Operator Guide

Run a Worker or Validator node to participate in verifiable AI consensus and earn SOL.

Running as Worker

Worker nodes claim open tasks, run AI inference (via Gemini or mock), and submit cryptographic commitments.

Running as Validator

Validator nodes independently verify worker results and vote on correctness.

Prerequisites

  • Node.js 24.x
  • Solana CLI 3.x (Agave)
  • A funded Solana keypair
  • GEMINI_API_KEY (for real AI inference)

Configuration

Create a .env file in the agent/ directory:

env
# Node Environment Variables
WALLET_PATH=~/.config/solana/id.json
RPC_URL=https://api.mainnet-beta.solana.com

# Node Role (worker | validator)
NODE_ROLE=worker

# Inference Provider Keys
GEMINI_API_KEY=aizaSy...

Start the Agent

Run the robust Solarium Rust/TS agent to start monitoring the blockchain state. The agent will automatically claim tasks it is eligible for based on its role.

bash
npm run start:agent

Earnings & Reputation

Nodes start with 5000 reputation points (max 10000). Each successful task adds 50 points. Slashing removes 200 points. Nodes below 1000 reputation cannot participate.