> For the complete documentation index, see [llms.txt](https://basehouse.games/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://basehouse.games/docs/overview.md).

# Overview

> **Decentralized casino platform on Base network with provably fair gaming, automated revenue distribution, and community governance.**

## What is Base House Protocol?

Base House Protocol is a comprehensive decentralized casino platform that provides:

* **🎲 Provably Fair Gaming**: All games use Chainlink VRF v2.5 for verifiable randomness
* **💰 Revenue Sharing**: Automatic distribution of protocol earnings to stakeholders
* **🏛️ Community Governance**: DAO-controlled protocol development and parameters
* **🔒 Security First**: Audited smart contracts with multiple security layers

## Quick Start

### For Players

**Play casino games with guaranteed fairness**

* **Get Started**: [How to Play](https://github.com/basehousegames/docs/blob/main/2-players/how-to-play.md)
* **Browse Games**: [Available Games](/docs/for-players/available-games.md)

### For Token Holders

**Stake HOUSE tokens and earn protocol revenue**

* **Learn About Tokenomics**: [HOUSE Token](/docs/getting-started/tokenomics.md)
* **Understand Revenue**: 30% to stakers, 50% treasury, 5% developers, 15% operators

### For Developers

**Build games and earn revenue share**

* **Game Development**: [Development Guide](/docs/for-game-builders/development.md)
* **Frontend Integration**: [Frontend Guide](/docs/for-operators/frontend.md)

### For Community

**Participate in protocol governance**

* **Get Involved**: [Contributing](/docs/community/contributing.md)
* **Learn Governance**: [HOUSE Token](/docs/getting-started/tokenomics.md#governance-framework)

## Available Games

| Game                  | Type      | House Edge | Features                                |
| --------------------- | --------- | ---------- | --------------------------------------- |
| **Coin Flip**         | Binary    | 2.5%       | Simple heads/tails, instant results     |
| **Dice Games**        | Multi-bet | 2.5%       | Numbers, ranges, over/under, odds/evens |
| **European Roulette** | Classic   | 2.7%       | All standard bet types, single zero     |
| **Slot Machine**      | Slots     | 2.5%       | 3-reel, multiple paylines               |
| **HiLo Card**         | Strategy  | 2.5%       | Card prediction with skill element      |
| **Wheel of Fortune**  | Spin      | 2.5%       | Configurable segments and payouts       |

**Coming Soon**: Blackjack tables with multi-player support

## HOUSE Token

**Fixed supply governance token with revenue sharing**

* **Total Supply**: 1,000,000 HOUSE (no inflation)
* **Distribution**: 20% auction, 70% treasury, 10% founders
* **Utility**: Governance voting, revenue sharing through staking
* **Staking**: ERC-4626 vault with instant liquidity

[Learn More →](/docs/getting-started/tokenomics.md)

## Architecture

**Built on battle-tested foundations**

* **Network**: Base (Ethereum Layer 2)
* **Randomness**: Chainlink VRF v2.5 with direct ETH funding
* **Standards**: OpenZeppelin contracts, ERC-4626 staking
* **Security**: Multi-layer protection, emergency controls

[Technical Details →](/docs/contracts/architecture.md)

## Revenue Model

**Transparent, automated revenue distribution**

```
Protocol Revenue (100%)
├── Stakers (30%) - ETH rewards for HOUSE token stakers
├── Treasury (50%) - Protocol operations and development
├── Game Developers (5%) - Incentivize new game creation
└── Frontend Operators (15%) - Support ecosystem growth
```

[Revenue Details →](/docs/getting-started/tokenomics.md#revenue-distribution)

## Security & Fairness

**Multiple layers of protection and verification**

* **Provably Fair**: Chainlink VRF ensures cryptographically verifiable randomness
* **Open Source**: All contract code publicly auditable
* **Professional Audits**: Contracts audited by security firms
* **Emergency Controls**: Pause mechanisms and governance safeguards

[Security Model →](/docs/contracts/architecture.md#security-architecture)

## Ecosystem

**Multiple ways to participate and earn**

### Players

* Play provably fair casino games
* Instant ETH payouts
* Transparent, on-chain results

### HOUSE Token Holders

* Stake for 30% of protocol revenue
* Vote on governance proposals
* No lock-up periods

### Game Developers

* Build games using BaseGame framework
* Earn 5% of revenue from your games
* Automated revenue attribution

### Frontend Operators

* Create user interfaces
* Earn 15% of attributed volume
* Multiple operators can coexist
* Automated revenue attribution

## Documentation

### Getting Started

* [Tokenomics](/docs/getting-started/tokenomics.md) - HOUSE token economics
* [Roadmap](/docs/getting-started/roadmap.md) - Development timeline

### For Players

* [How to Play](https://github.com/basehousegames/docs/blob/main/2-players/how-to-play.md) - Complete player guide
* [Available Games](/docs/for-players/available-games.md) - All games explained

### For Builders

* [Game Development](/docs/for-game-builders/development.md) - Build casino games
* [Frontend Development](/docs/for-operators/frontend.md) - Create interfaces

### For Developers

* [Architecture](/docs/contracts/architecture.md) - System design
* [Base Game Framework](/docs/contracts/games/base-game.md) - Game development
* [Individual Games](https://github.com/basehousegames/docs/blob/main/5-contracts/games/README.md) - Specific game implementations

### Community

* [Contributing](/docs/community/contributing.md) - How to contribute
* [Code of Conduct](/docs/community/code-of-conduct.md) - Community guidelines
* [Support](/docs/community/support.md) - Get help

### Resources

* [Contract Addresses](/docs/deployments/addresses.md) - Live deployments
* [Testnet Addresses](/docs/deployments/test-addresses.md) - Testing contracts
* [FAQ](/docs/resources/general.md) - Common questions
* [Glossary](https://github.com/basehousegames/docs/blob/main/8-resources/glossary.md) - Terms and definitions
* [External Links](/docs/resources/links.md) - Useful resources

## 🔗 Links

* **GitHub**: [Repository](https://github.com/basehousegames)
* **Discord**: [Discord](https://discord.gg/nqhDkgDJ)
* **Discord**: [Telegram](https://t.me/basehousegames)
* **Twitter**: [BaseHouseGames](https://twitter.com/basehousegames)
* **Website**: [basehouse.games](https://basehouse.games)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://basehouse.games/docs/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
