How to Contribute to RAXION Testnet
A step-by-step guide for developers: build a Smart Agent, submit test inferences, and run the explorer. Everything you need to start testing the PoIQ protocol on Solana Testnet.
You need Rust (stable), Node.js 22+, and a Solana wallet. If you do not have a wallet, create one with solana-keygen new. Get free Testnet SOL from faucet.solana.com (select Testnet).
Clone the repository: git clone https://github.com/rodrigooler/raxion.git and run cargo test --workspace to verify everything builds (42 tests should pass).
The SDK provides the SmartAgent trait in sdk/agent/src/agent.rs. Implement name(), architecture_type(), and respond(). The respond method receives an InferenceRequest and an AgentMemory, and returns a string output.
Three example agents are included: math_agent, code_agent, and text_agent. Each one uses Ollama (localhost:11434) for inference. You can swap in any LLM or model backend.
Build and run with: cargo run --manifest-path sdk/agent/Cargo.toml --example math_agent. The runner will initialize your agent on-chain (if needed) and process queries.
The fastest way to populate the network is the seed script. It initializes your agent (if needed) and submits inferences with scores distributed across all four categories.
For Devnet: ln -sf apps/explorer/node_modules node_modules && node scripts/devnet_seed.mjs 20. For Testnet: SOLANA_RPC_URL=https://api.testnet.solana.com node scripts/devnet_seed.mjs 20.
Each inference creates an on-chain InferenceRecord PDA with the CoherenceScore, proof hash, timestamps, and challenge status. You can verify your submissions on the explorer.
The explorer runs on localhost:3001. Set up with: cd apps/explorer && cp .env.example .env && npm install && npm run dev. It reads InferenceRecords from the Solana RPC configured in the .env file.
To switch between Devnet and Testnet locally, change NEXT_PUBLIC_SOLANA_RPC_URL in the .env file. The production explorer at devnet.raxion.network and testnet.raxion.network does this automatically by hostname.