Documentação AstroBase

Construído com ❤️ na Base – Onde habilidade encontra recompensas onchain

1. Introdução

O que é AstroBase? AstroBase é um jogo 3D competitivo onchain construído nativamente na Base, onde jogadores pilotam uma nave pelo espaço, desviando de obstáculos e buscando a maior pontuação. Cada sessão custa uma pequena taxa de entrada (0.00005 ETH ≈ $0,20), e o prêmio semanal é distribuído entre os 3 melhores do pódio.

Gameplay arcade acelerado – Ação instantânea, pura habilidade

Recompensas semanais competitivas – Prêmios reais para os melhores

100% onchain – Transparente, verificável e seguro

Acessível em todo lugar – Jogue no desktop e no celular

Duas classificações – Pódio semanal + recordes absolutos

2. Como Jogar

Mecânicas do Jogo

Objetivo: Pilote sua nave, evite obstáculos e faça a maior pontuação
Taxa de entrada: 0.00005 ETH por sessão (~$0,20 na cotação atual)
Duração da sessão: 1 hora de jogo ativo por pagamento

Sistema de Pontuação

Pontuação Semanal: Reinicia toda semana para competição do pódio
Recorde Absoluto: Seu melhor resultado, salvo para sempre onchain

Distribuição Semanal de Prêmios

🥇 1º lugar → 40% do prêmio
🥈 2º lugar → 25% do prêmio
🥉 3º lugar → 15% do prêmio
🔧 Servidor/Proprietário → 10% (manutenção e desenvolvimento)
💎 Restante → 10% fica no contrato para a próxima semana

Reinício: O pódio e as pontuações semanais reiniciam após cada distribuição; recordes absolutos permanecem.

3. Smart Contracts

Endereços Implantados

Rede	Endereço do Contrato	Status
Base Sepolia (Testnet)	0x9559fA7870d8356411ED80D123eAAA7B9fA8f032	✅ Verificado
Base (Mainnet)	0xf80fa867530Ed4deB895DC090Ec9480a595feB59	✅ Verificado

Open Source: Contratos verificados publicamente no BaseScan.

Funcionalidades do Contrato

ReentrancyGuard – Proteção contra ataques de reentrada

Pausable – Função de pausa de emergência (apenas proprietário)

Assinaturas ECDSA – Pontuações assinadas pelo servidor evitam trapaças

Sistema de Nonce – Previne ataques de repetição

Gestão de Sessão – Sessões com tempo limitado e expiração

Pontuação Dupla – Rankings semanais e absolutos

4. Stack Tecnológico

Frontend & Motor do Jogo

Framework: Next.js 15.5.3 (React 19.1.0)
Gráficos 3D: Three.js via React Three Fiber
Animações: Motion 12.23.22
UI/UX: Design moderno e responsivo otimizado para desktop e mobile

Blockchain & Web3

Layer 2: Base (Ethereum L2) – Transações rápidas e baratas
Biblioteca Web3: wagmi v2.17.2 + viem v2.37.8
Smart Contract: Solidity 0.8.17 com otimizações
Validação de Assinatura: Assinaturas criptográficas ECDSA

Infraestrutura

Deploy: Vercel (Edge Network)
Backend: Servidor seguro para assinatura de pontuações
Armazenamento: Chaves privadas protegidas em variáveis de ambiente

5. Segurança & Transparência

Segurança do Smart Contract

Código auditado/verificado no BaseScan
Padrões de segurança OpenZeppelin
ReentrancyGuard para operações financeiras
Validação de assinatura ECDSA
Proteção de nonce contra replay
Expiração de sessão para evitar abuso

Segurança Operacional

Gestão de chave privada no .env
Configs separadas para testnet/mainnet
Controles de pausa de emergência
Distribuição de prêmios onchain e transparente

Proteção ao Jogador

Jogo Justo: Assinaturas do servidor previnem manipulação de pontuação
Probabilidades Transparentes: Lógica e distribuição do contrato verificadas
Sem Taxas Ocultas: Taxa de entrada e divisões explícitas
Aleatoriedade Verificável: Gameplay 100% habilidade (sem RNG oculto)

6. Visão de Longo Prazo

Funcionalidades Planejadas

NFTs de naves: skins, níveis de raridade, boosts

Universo expandido: novos mini-games, economia compartilhada

Governança comunitária: votação, divisões ajustáveis

Temporadas competitivas: torneios mensais, conquistas

7. Comunidade & Governança

Nada está escrito em pedra. Construímos com a comunidade. Preço, divisões de prêmios e mecânicas podem evoluir. Código open-source, roadmap público e atualizações regulares.