> For the complete documentation index, see [llms.txt](https://project-49.gitbook.io/fortunehunters/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://project-49.gitbook.io/fortunehunters/governance.md).

# 8 Governance

FortuneHunters governance is designed to be **participatory yet protective**. It blends the nimbleness of Snapshot off-chain voting with the security of on-chain execution via a time-locked treasury. Below we detail the proposal lifecycle, role hierarchy, conflict resolution, and future upgrades.

***

## 8.1 Governance Philosophy

1. **Seeker-Centric** — Each fortune reading should indirectly influence protocol direction via popularity signals.
2. **Skin-in-the-Game** — Voting power derives from *staked* (not idle) $FORTUNE to align long-term incentives.
3. **Progressive Decentralisation** — Core team retains safety veto in Year 1, sunsets automatically after Year 2 audit.

***

## 8.2 Roles & Powers

| Role                  | Entry Requirement                  | Key Powers                                      | Typical Actions                           |
| --------------------- | ---------------------------------- | ----------------------------------------------- | ----------------------------------------- |
| **Fortune Seeker**    | Hold ≥ 1 $FORTUNE                  | Feedback, festival participation                | Upvote lore ideas, claim quests           |
| **Apprentice Mystic** | Stake ≥ 10 000 $FORTUNE            | Validate AI readings, minor votes               | Dispute accuracy, review proposals        |
| **Master Oracle**     | Stake ≥ 1 000 000 $FORTUNE + KYC   | Open proposals, major votes, validator slashing | Launch new festival season, budget grants |
| **Fox Council**       | Top 9 Master Shamans by reputation | Emergency multisig (3/5)                        | Pause contracts on exploit detection      |

**Reputation Score** is an off-chain metric based on fortune validation accuracy, streak support, and community contributions; resets quarterly.

***

## 8.3 Proposal Lifecycle

```mermaid
graph LR
A(Draft) --> B(Rage-quit Review)
B --> C(Snapshot Vote)
C --> D(Timelock Queue)
D --> E(On-chain Execution)
```

1. **Draft (72 h)** — Proposer outlines change on forums; must lock 5 000 $FORTUNE to avoid spam.
2. **Rage-quit Review (48 h)** — Stakers can exit if they disagree sharply, ensuring soft opt-out.
3. **Snapshot Vote (96 h)** — Quadratic weighting till 100 k stake; linear above.
4. **Timelock Queue (48 h)** — Smart contract queue; Fox Council can only *delay* once (24 h) in emergencies.
5. **Execution** — Aragon OSx plugin triggers contract upgrades or treasury transfers.

### Example Proposal Types

* **Parameter Change** — Adjust festival streak multiplier.
* **Budget Allocation** — 50 000 $DREAM grant to neuroscience study.
* **Protocol Upgrade** — Migrate NFT standard to 721A.

***

## 8.4 Treasury Mechanics

* **Safe Structure** — 3/5 multisig (Fox Council) + 1/1 timelock executor.
* **Asset Mix** — BTC (40 %), $FORTUNE (30 %), USDC (20 %), ETH LSDs (10 %).
* **Reporting** — Monthly transparency report auto-posted to GitBook via GitHub Actions.

### Revenue Sources

1. 2 % cut from every secondary Fortune NFT trade.
2. 0.5 % swap fee from points → $FORTUNE conversions.
3. Validator slashing fines.

### Spending Rules

* No single transaction >5 % of treasury without Fox Council super-majority.
* Grants above 50 000 $FORTUNE require two-phase vote (rough + final).

***

## 8.5 Conflict Resolution

| Scenario             | Path                                                                                           |
| -------------------- | ---------------------------------------------------------------------------------------------- |
| **Reading Dispute**  | Apprentice submits evidence; Master quorum reviews via 3/5 stake.                              |
| **Contract Exploit** | Fox Council pauses contracts; emergency fund migrates.                                         |
| **DAO Deadlock**     | Last-resort community fork: snapshot of fortune scores + token balances exported to new chain. |

***

## 8.6 Future Upgrades

1. **Soul-Bound Badges** — Non-transferable NFT for governance reputation.
2. **Real-Time Param Tuning** — Chainlink Functions to auto-adjust fees based on marketplace volume.
3. **Cross-DAO Alliances** — Shared voting power with K-culture projects like MetaKongz.

FortuneHunters envisions governance **as mystical as the fortunes it reveals**—ritualistic, transparent, and ever-evolving.

## Proposal Flow

```
Draft → Rage-quit Review → Snapshot Vote → On-chain Execution
```

1. **Draft** — Anyone with 1 % circulating $FORTUNE may draft a proposal.
2. **Rage-quit Review** — 72 h period where stakers can exit before voting.
3. **Snapshot Vote** — Off-chain voting weighted by staked $FORTUNE.
4. **On-chain Execution** — Successful proposals queued and executed via timelock.

## Treasury Uses

* Liquidity incentives and buy-backs
* Grants for academic dream researchers
* Cultural events and K-POP collaborations

## Community Roles

| Role                  | Requirement                      | Power                             |
| --------------------- | -------------------------------- | --------------------------------- |
| **Fortune Seeker**    | Hold ≥ 1 $FORTUNE                | Submit feedback, access festivals |
| **Apprentice Mystic** | Stake ≥ 10 000 $FORTUNE          | Validate AI readings, minor votes |
| **Master Oracle**     | Stake ≥ 1 000 000 $FORTUNE + KYC | Open proposals, major votes       |