# AstroBase

### 1. Introduction

#### What is AstroBase?

AstroBase is a competitive 3D onchain game built natively on Base, where players pilot a spaceship through space, dodging obstacles while aiming for the highest score.Each game session costs a small entry fee (0.00005 ETH ≈ $0.20), and the weekly prize pool is distributed among the top 3 players on the podium.Why AstroBase?

* Fast-paced arcade gameplay – Instant action, pure skill
* Competitive weekly rewards – Real prizes for top performers
* 100% onchain – Transparent, verifiable, and secure
* Accessible everywhere – Play on desktop and mobile
* Dual leaderboards – Weekly podium + all-time records

***

### 2. How to Play

#### Game Mechanics

* Objective: Navigate your spaceship, avoid obstacles, and achieve the highest score
* Entry Fee: 0.00005 ETH per game session (\~$0.20 at current rates)
* Session Duration: 1 hour of active gameplay per payment
* Scoring System:
* Weekly Score: Resets every week for podium competition
* All-Time Score: Your personal best, preserved forever onchain

#### Weekly Prize Distribution

Every 7 days, the jackpot is distributed automatically:

* 🥇 1st place → 40% of the jackpot
* 🥈 2nd place → 25% of the jackpot
* 🥉 3rd place → 15% of the jackpot
* 🔧 Server/Owner → 10% (maintenance & development)
* 💎 Remaining → 10% stays in the contract for next week

Reset: The weekly podium and scores reset after each distribution, but all-time records are preserved.

***

### 3. Smart Contracts

#### Deployed Addresses

| Network                | Contract Address                                                                                                              | Status     |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ---------- |
| Base Sepolia (Testnet) | [0x9559fA7870d8356411ED80D123eAAA7B9fA8f032](https://sepolia.basescan.org/address/0x9559fA7870d8356411ED80D123eAAA7B9fA8f032) | ✅ Verified |
| Base (Mainnet)         | [0xf80fa867530Ed4deB895DC090Ec9480a595feB59](https://basescan.org/address/0xf80fa867530Ed4deB895DC090Ec9480a595feB59)         | ✅ Verified |

🔍 Open Source: All contracts are publicly verified on BaseScan for complete transparency.

#### Contract Features

* ✅ ReentrancyGuard – Protection against reentrancy attacks
* ✅ Pausable – Emergency pause functionality (owner only)
* ✅ ECDSA Signatures – Server-signed scores prevent cheating
* ✅ Nonce System – Prevents replay attacks
* ✅ Session Management – Time-limited game sessions with expiration
* ✅ Dual Scoring – Separate weekly and all-time leaderboards

***

### 4. Technology Stack

#### Frontend & Game Engine

* Framework: Next.js 15.5.3 (React 19.1.0)
* 3D Graphics: Three.js via React Three Fiber
* Animations: Motion 12.23.22
* UI/UX: Modern, responsive design optimized for desktop and mobile

#### Blockchain & Web3

* Layer 2: Base (Ethereum L2) – Fast, low-cost transactions
* Web3 Library: wagmi v2.17.2 + viem v2.37.8
* Smart Contract: Solidity 0.8.17 with optimizations enabled
* Signature Validation: ECDSA cryptographic signatures

#### Infrastructure

* Deployment: Vercel (Edge Network)
* Backend: Secure server for score signing
* Storage: Private keys stored securely in environment variables (never exposed)

***

### 5. Security & Transparency

#### Smart Contract Security

✅ Audited Code: Open-source contracts verified on BaseScan

✅ Battle-Tested Libraries: Uses OpenZeppelin's security standards

✅ Protected Functions: ReentrancyGuard on all financial operations

✅ Signature Validation: Only server-signed scores are accepted

✅ Nonce Protection: Each score submission uses a unique nonce

✅ Session Expiration: Time-limited game sessions prevent abuse

#### Operational Security

✅ Private Key Management: All sensitive keys stored in .env (never committed to Git)

✅ Environment Separation: Separate testnet and mainnet configurations

✅ Emergency Controls: Owner can pause contract in case of emergency

✅ Transparent Distribution: All prize payouts are publicly verifiable onchain

#### Player Protection

* Fair Play: Server-side signature validation prevents score manipulation
* Transparent Odds: All game logic and prize distribution is visible in the verified contract
* No Hidden Fees: Entry fee and distribution percentages are clearly defined
* Verifiable Randomness: No hidden RNG – pure skill-based gameplay

🔒 Security is our priority. We follow industry best practices and maintain complete transparency.

***

### 6. Long-Term Vision

AstroBase is more than a single game – it's the foundation of an evolving onchain gaming ecosystem, guided by our community.

#### Planned Features

🎨 Spaceship NFTs

* Unique visual collections with multiple skins
* Rarity tiers (Common, Rare, Epic, Legendary)
* Potential gameplay boosts and perks
* Tradeable on secondary markets

🪐 Expanded AstroBase Universe

* New interconnected mini-games (races, fleet battles, missions)
* Shared economy and cross-game progression
* Seasonal events and limited-time challenges

🗳️ Community Governance

* Player voting on new features
* Adjustable prize distribution based on feedback
* Community-proposed game modes
* Transparent roadmap evolution

🏆 Competitive Seasons

* Monthly tournaments with special prizes
* Seasonal leaderboards and achievements
* Exclusive rewards for top performers

***

### 7. Community & Governance

#### Our Philosophy

Nothing is set in stone. We believe in building with the community, not just for it.

* Active Listening: Pricing, reward splits, and gameplay mechanics can evolve
* Transparent Development: Open-source code, public roadmap, regular updates
* Community-Driven: Major decisions will involve player input
* Fair Evolution: Changes are announced in advance and explained clearly

#### Transparency Principles

✅ All smart contracts are open-source and verified✅ Prize distributions are publicly auditable onchain✅ Development updates shared regularly on Twitter and Telegram✅ Community feedback actively shapes the product roadmap

***

### 8. Quick Links

#### Play & Connect

* 🎮 Play AstroBase – [Start playing now](https://astrobase.games/fr)
* 🐦 Twitter – [Follow for updates](https://x.com/AstroBase_)
* 💬 Telegram – [Join the community](https://t.me/+lse_BRZX4kNjODE8)
* 💬 Discord → Coming soon

#### Developer Resources

* 📄 GitHub Repository – Coming soon
* 📖 Technical Documentation – Coming soon
* 🛠️ API Documentation – Coming soon

***

### 9. FAQ

Q: How much does it cost to play?

A: 0.00005 ETH per game session (\~$0.20). This gives you 1 hour of gameplay.

Q: When is the jackpot distributed?

A: Every 7 days, automatically via smart contract.

Q: Can I play on mobile?

A: Yes! AstroBase is optimized for both desktop and mobile browsers.

Q: Is the game fair?

A: Absolutely. All scores are cryptographically signed and validated. The smart contract is open-source and verified.

Q: What happens to my all-time score?

A: Your all-time best score is preserved forever onchain, even after weekly resets.

Q: Can I withdraw if I change my mind?

A: Entry fees go directly into the prize pool and cannot be withdrawn. Only play what you're comfortable risking.

***

Built with ❤️ on Base– Where skill meets onchain rewards

\\
