Documentación de AstroBase

Construido con ❤️ en Base – Donde la habilidad se encuentra con recompensas onchain

1. Introducción

¿Qué es AstroBase? AstroBase es un juego competitivo 3D onchain construido nativamente en Base, donde los jugadores pilotan una nave espacial por el espacio, esquivando obstáculos y buscando la máxima puntuación. Cada partida cuesta una pequeña tarifa de entrada (0.00005 ETH ≈ $0.20), y el pozo semanal se distribuye entre los 3 mejores jugadores del podio.

Jugabilidad arcade rápida – Acción instantánea, pura habilidad
Recompensas semanales competitivas – Premios reales para los mejores
100% onchain – Transparente, verificable y seguro
Accesible en todas partes – Juega en escritorio y móvil
Doble clasificación – Podio semanal + récords históricos

2. Cómo jugar

Mecánicas del juego

  • Objetivo: Pilota tu nave, esquiva obstáculos y logra la mayor puntuación
  • Tarifa de entrada: 0.00005 ETH por partida (~$0.20 al cambio actual)
  • Duración de la sesión: 1 hora de juego activo por pago

Sistema de puntuación

  • Puntuación semanal: Se reinicia cada semana para la competencia del podio
  • Puntuación histórica: Tu mejor marca personal, guardada para siempre onchain

Distribución de premios semanal

  • 🥇 1º puesto → 40% del pozo
  • 🥈 2º puesto → 25% del pozo
  • 🥉 3º puesto → 15% del pozo
  • 🔧 Servidor/Propietario → 10% (mantenimiento y desarrollo)
  • 💎 Resto → 10% permanece en el contrato para la siguiente semana

Reinicio: El podio y las puntuaciones semanales se reinician tras cada distribución; los récords históricos permanecen.

3. Smart Contracts

Direcciones desplegadas

RedDirección del contratoEstado
Base Sepolia (Testnet)0x9559fA7870d8356411ED80D123eAAA7B9fA8f032✅ Verificado
Base (Mainnet)0xf80fa867530Ed4deB895DC090Ec9480a595feB59✅ Verificado

Open Source: Contratos verificados públicamente en BaseScan.

Características del contrato

ReentrancyGuard – Protección contra ataques de reentrada
Pausable – Función de pausa de emergencia (solo propietario)
Firmas ECDSA – Puntuaciones firmadas por el servidor para evitar trampas
Sistema de nonce – Previene ataques de repetición
Gestión de sesiones – Sesiones limitadas en el tiempo con expiración
Doble puntuación – Clasificaciones semanales e históricas

4. Stack tecnológico

Frontend y motor de juego

  • Framework: Next.js 15.5.3 (React 19.1.0)
  • Gráficos 3D: Three.js vía React Three Fiber
  • Animaciones: Motion 12.23.22
  • UI/UX: Diseño moderno y responsivo optimizado para escritorio y móvil

Blockchain y Web3

  • Capa 2: Base (Ethereum L2) – Transacciones rápidas y de bajo coste
  • Librería Web3: wagmi v2.17.2 + viem v2.37.8
  • Smart Contract: Solidity 0.8.17 con optimizaciones
  • Validación de firmas: Firmas criptográficas ECDSA

Infraestructura

  • Despliegue: Vercel (Edge Network)
  • Backend: Servidor seguro para firmar puntuaciones
  • Almacenamiento: Claves privadas protegidas en variables de entorno

5. Seguridad y transparencia

Seguridad del Smart Contract

  • Código auditado/verificado en BaseScan
  • Estándares de seguridad OpenZeppelin
  • ReentrancyGuard para operaciones financieras
  • Validación de firmas ECDSA
  • Protección de nonce contra repetición
  • Expiración de sesión para evitar abusos

Seguridad operativa

  • Gestión de claves privadas en .env
  • Configuraciones separadas para testnet/mainnet
  • Controles de pausa de emergencia
  • Distribución de premios transparente y onchain

Protección al jugador

  • Juego limpio: Firmas del servidor previenen manipulación de puntuaciones
  • Probabilidades transparentes: Lógica de contrato y distribución verificadas
  • Sin comisiones ocultas: Tarifa de entrada y repartos explícitos
  • Aleatoriedad verificable: Juego basado en habilidad pura (sin RNG oculto)

6. Visión a largo plazo

Características planeadas

NFTs de naves: skins, rarezas, posibles mejoras
Universo expandido: nuevos minijuegos, economía compartida
Gobernanza comunitaria: votaciones, repartos ajustables
Temporadas competitivas: torneos mensuales, logros

7. Comunidad y gobernanza

Nada está escrito en piedra. Construimos con la comunidad. Precios, repartos y mecánicas pueden evolucionar. Código open source, hoja de ruta pública y actualizaciones regulares.

  • Contratos open source y verificados
  • Distribuciones de premios auditables onchain
  • Actualizaciones regulares en Twitter y Telegram
  • El feedback de la comunidad define la hoja de ruta

8. Enlaces rápidos

9. Preguntas frecuentes

Q: ¿Cuánto cuesta jugar?
A: 0.00005 ETH por sesión (~$0.20) para 1 hora de juego.
Q: ¿Cuándo se distribuye el pozo?
A: Cada 7 días, automáticamente vía smart contract.
Q: ¿Puedo jugar en móvil?
A: Sí, optimizado para navegadores de escritorio y móvil.
Q: ¿El juego es justo?
A: Sí. Las puntuaciones están firmadas y validadas criptográficamente. Los contratos están verificados.
Q: ¿Qué pasa con mi récord histórico?
A: Tu mejor puntuación histórica permanece onchain para siempre.
Q: ¿Puedo retirar si cambio de opinión?
A: Las tarifas de entrada financian el pozo y no son reembolsables.
AstroBase