Documentation AstroBase

Construit avec ❤️ sur Base – Où la compétence rencontre les récompenses onchain

1. Introduction

Qu'est-ce qu'AstroBase ? AstroBase est un jeu 3D compétitif onchain, construit nativement sur Base, où les joueurs pilotent un vaisseau spatial à travers l'espace, évitent des obstacles et visent le meilleur score. Chaque partie coûte un petit droit d'entrée (0.00005 ETH ≈ 0,20 $), et la cagnotte hebdomadaire est répartie entre les 3 meilleurs joueurs du podium.

Gameplay arcade rapide – Action instantanée, pur skill

Récompenses hebdomadaires compétitives – Vrais prix pour les meilleurs

100% onchain – Transparent, vérifiable et sécurisé

Accessible partout – Joue sur desktop et mobile

Double classement – Podium hebdo + records absolus

2. Comment jouer

Mécaniques de jeu

Objectif : Pilote ton vaisseau, évite les obstacles, fais le meilleur score
Frais d'entrée : 0.00005 ETH par partie (~0,20 $ au taux actuel)
Durée de session : 1h de jeu actif par paiement

Système de score

Score hebdo : Réinitialisé chaque semaine pour la compétition du podium
Record absolu : Ton meilleur score, conservé à jamais onchain

Répartition des gains hebdo

🥇 1er → 40% de la cagnotte
🥈 2e → 25% de la cagnotte
🥉 3e → 15% de la cagnotte
🔧 Serveur/Owner → 10% (maintenance & dev)
💎 Reste → 10% reste dans le contrat pour la semaine suivante

Reset : Podium et scores hebdo remis à zéro après chaque distribution ; records absolus conservés.

3. Smart Contracts

Adresses déployées

Réseau	Adresse du contrat	Statut
Base Sepolia (Testnet)	0x9559fA7870d8356411ED80D123eAAA7B9fA8f032	✅ Vérifié
Base (Mainnet)	0xf80fa867530Ed4deB895DC090Ec9480a595feB59	✅ Vérifié

Open Source : Contrats vérifiés publiquement sur BaseScan.

Fonctionnalités du contrat

ReentrancyGuard – Protection contre les attaques de réentrance

Pausable – Pause d'urgence (owner uniquement)

Signatures ECDSA – Scores signés côté serveur pour éviter la triche

Système de nonce – Prévient les attaques de replay

Gestion de session – Sessions limitées dans le temps avec expiration

Double score – Classements hebdo et absolu

4. Stack technologique

Frontend & Moteur de jeu

Framework : Next.js 15.5.3 (React 19.1.0)
3D : Three.js via React Three Fiber
Animations : Motion 12.23.22
UI/UX : Design moderne et responsive, optimisé desktop & mobile

Blockchain & Web3

Layer 2 : Base (Ethereum L2) – Transactions rapides et peu chères
Librairie Web3 : wagmi v2.17.2 + viem v2.37.8
Smart Contract : Solidity 0.8.17 optimisé
Validation de signature : ECDSA cryptographique

Infrastructure

Déploiement : Vercel (Edge Network)
Backend : Serveur sécurisé pour la signature des scores
Stockage : Clés privées sécurisées dans les variables d'environnement

5. Sécurité & Transparence

Sécurité des smart contracts

Code audité/vérifié sur BaseScan
Standards de sécurité OpenZeppelin
ReentrancyGuard pour les opérations financières
Validation de signature ECDSA
Protection par nonce contre le replay
Expiration de session pour éviter les abus

Sécurité opérationnelle

Gestion des clés privées dans .env
Configs séparées testnet/mainnet
Contrôles de pause d'urgence
Distribution des gains onchain et transparente

Protection des joueurs

Fair Play : Signatures serveur pour empêcher la triche sur les scores
Chances transparentes : Logique de contrat et distribution vérifiées
Pas de frais cachés : Frais d'entrée et répartitions explicites
Randomness vérifiable : Gameplay 100% skill (pas de RNG caché)

6. Vision long terme

Fonctionnalités prévues

NFTs vaisseaux : skins, raretés, boosts potentiels

Univers étendu : nouveaux mini-jeux, économie partagée

Gouvernance communautaire : votes, répartitions ajustables

Saisons compétitives : tournois mensuels, achievements

7. Communauté & Gouvernance

Rien n'est figé. On construit avec la communauté. Prix, répartitions et mécaniques peuvent évoluer. Code open-source, roadmap publique, updates régulières.