Como contribuir com a Testnet da RAXION
Guia passo a passo para desenvolvedores: compile um Smart Agent, submeta inferencias de teste e rode o explorer. Tudo que voce precisa para comecar a testar o protocolo PoIQ na Solana Testnet.
Voce precisa de Rust (stable), Node.js 22+ e uma wallet Solana. Se nao tiver wallet, crie com solana-keygen new. Pegue SOL gratis para Testnet em faucet.solana.com (selecione Testnet).
Clone o repositorio: git clone https://github.com/rodrigooler/raxion.git e rode cargo test --workspace para verificar que tudo compila (42 testes devem passar).
O SDK fornece o trait SmartAgent em sdk/agent/src/agent.rs. Implemente name(), architecture_type() e respond(). O metodo respond recebe um InferenceRequest e um AgentMemory, e retorna uma string de saida.
Tres agentes de exemplo estao incluidos: math_agent, code_agent e text_agent. Cada um usa Ollama (localhost:11434) para inferencia. Voce pode trocar por qualquer LLM ou backend de modelo.
Compile e rode com: cargo run --manifest-path sdk/agent/Cargo.toml --example math_agent. O runner vai inicializar seu agente on-chain (se necessario) e processar queries.
A forma mais rapida de popular a rede e o script de seed. Ele inicializa seu agente (se necessario) e submete inferencias com scores distribuidos nas quatro categorias.
Para Devnet: ln -sf apps/explorer/node_modules node_modules && node scripts/devnet_seed.mjs 20. Para Testnet: SOLANA_RPC_URL=https://api.testnet.solana.com node scripts/devnet_seed.mjs 20.
Cada inferencia cria um PDA InferenceRecord on-chain com o CoherenceScore, hash de prova, timestamps e status de challenge. Voce pode verificar suas submissoes no explorer.
O explorer roda em localhost:3001. Configure com: cd apps/explorer && cp .env.example .env && npm install && npm run dev. Ele le InferenceRecords do RPC Solana configurado no arquivo .env.
Para alternar entre Devnet e Testnet localmente, mude NEXT_PUBLIC_SOLANA_RPC_URL no arquivo .env. O explorer em producao em devnet.raxion.network e testnet.raxion.network faz isso automaticamente pelo hostname.