🌌 Stellarcade

Stellarcade is a decentralized arcade platform built on the Stellar network using Soroban smart contracts. We provide provably fair games, community prize pools, and a seamless gaming experience using Stellar's fast and low-cost infrastructure.

✨ Key Features

• Provably Fair Gaming: Our Random Number Generator (RNG) contract ensures every game result is verifiable and fair.
• Decentralized Prize Pools: Play and win from pools managed entirely by smart contracts.
• Stellar Speed: Lightning-fast transactions and minimal fees.
• Multiple Games: Coin Flip, Trivia, and more—all on-chain.
• Open Source: Built by the community, for the community.

🛠 Tech Stack

• Smart Contracts: Rust & Soroban SDK
• Backend: Node.js, Express, PostgreSQL, Redis
• Frontend: Vite + React (Coming Soon)
• Infrastructure: Docker, GitHub Actions

🚀 Quick Start

Prerequisites

• Rust & Soroban CLI
• Node.js (v18+)
• Docker

Setup

1. Clone the repository:

   git clone https://github.com/stellar/stellarcade.git
   cd stellarcade

2. Install dependencies:

   # Backend
   cd backend && npm install
   
   # Contracts
   cd ../contracts/prize-pool && cargo build

3. Run with Docker:

   docker-compose up -d

📚 Documentation

Detailed documentation can be found in the docs/ folder:

• Architecture
• Game Rules
• API Reference
• Setup Guide

🤝 Contributing

We welcome contributions! Please see our CONTRIBUTING.md for details on how to get started.

🛡 Security

For security concerns, please refer to our SECURITY.md.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

💬 Community

• Discord Placeholder
• Twitter / X Placeholder
• Stellar Developers Foundation

---

Created with ❤️ for the Stellar Ecosystem (2026)