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

# Architecture

HoodLoot runs **entirely onchain** on Robinhood Chain. There's no server holding your balance and no database anyone can quietly edit — the game *is* a set of smart contracts. Every recruit, deploy, claim, upgrade, and burn is a transaction you can see and verify onchain.

***

## The contracts

A handful of contracts run the whole game. Each is themed to what it does:

| Contract               | What it does                                                                                                                                                                                                        |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **$SHARE**             | The token (ERC-20, 21,000,000 hard cap). Only the mining engine can mint it, and 75% of every in-game spend is burned.                                                                                              |
| **Mining Engine**      | The heart of the economy — accrues each block's $SHARE emission to every player by their share of the network Loot Rate, applies the halving schedule, and pays out claims. The only contract that can mint $SHARE. |
| **Outlaws (ERC-1155)** | The Merry Men as tokens — one per outlaw type. Yours to hold, trade, or deploy.                                                                                                                                     |
| **Outlaw Registry**    | Recruiting, staking outlaws onto hideout tiles, and each player's Loot Rate & Upkeep. Holds deployed outlaws in custody while they mine.                                                                            |
| **Hideout Manager**    | The nine hideouts — slots, upkeep caps, the upgrade cooldown, and the ETH tolls at milestone tiers.                                                                                                                 |
| **Price Oracle**       | Reads the Chainlink ETH/USD feed so USD-valued tolls are charged in the right amount of ETH.                                                                                                                        |
| **Referrals**          | One-level, set-once — routes 2.5% of a recruit's claims to whoever brought them in.                                                                                                                                 |
| **Leaderboard**        | The top players by Loot Rate.                                                                                                                                                                                       |

***

## Built to be trusted

* **Fully onchain & verifiable.** The contracts are verified on the block explorer — anyone can read the code and the live state. Nothing about the economy is hidden on a private server.
* **Fixed 21M supply.** The cap and the emission curve are hardcoded and immutable. No function can change them, and the token's `mint` is itself capped — nothing can inflate past 21,000,000 $SHARE.
* **No rug levers.** Prices, loot, upkeep, and emission are all immutable. The only owner control is an **emergency pause** (to freeze the game if an exploit appears) — it can't mint, move funds, or change a single number, and you can always withdraw your outlaws back to your wallet even while paused.
* **You custody your assets.** Outlaws are ERC-1155 tokens in your wallet; deploying one places it in the game's custody to mine, and you can pull it back any time.

***

## The chain

HoodLoot lives on **Robinhood Chain** — an EVM Layer-2 with **ETH gas**, **\~100ms blocks**, and **Chainlink** price feeds from day one. It behaves like any standard EVM chain, so any normal wallet just works. See [Robinhood Chain](/robinhood-chain/robinhood-chain.md).

***

## See Also

* [Virtual Mining](/game-mechanics/virtual-mining.md) — the reward math the mining engine implements
* [$SHARE Token](/game-assets-and-token/share-token.md) — the token, the burn, the cap
* [Robinhood Chain](/robinhood-chain/robinhood-chain.md) — the chain HoodLoot runs on
* [Disclaimer](/reference/disclaimer.md) — HoodLoot is experimental software; play for the loot, not the ladder


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.hoodloot.com/architecture/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.