# revshare overview

GitVerse RevShare is the on-chain economy layer. It lives in the **GitVersePlanets** contract on Base mainnet and powers a Harberger-taxed market of 10,000 tiles, each bound to a planet.

> One paragraph: buy a tile for 0.01 ETH, earn 90% of all protocol fees split among tile holders, claim anytime. Anyone can buy your tile from you at your declared price + 10% fee. Set a high price and you collect more buyout premium but pay more weekly tax. Set a low price and someone takes the tile from you cheap. Find the balance.

## The four things you can do as a holder

| Action           | Cost                               | What happens                                                            |
| ---------------- | ---------------------------------- | ----------------------------------------------------------------------- |
| **Claim a tile** | 0.01 ETH                           | 0.007 ETH to Treasury, 0.003 ETH funds your tax deposit. Tile is yours. |
| **Claim fees**   | Gas only                           | Pending holder share is sent to your wallet.                            |
| **Add deposit**  | Any amount                         | Extends time before your tile is foreclosed.                            |
| **Set price**    | Gas (+ appreciation tax if higher) | Changes the buyout price for your tile.                                 |
| **Abandon tile** | Gas                                | Tile returns to market; you get your deposit back.                      |

## The four things others can do to you

| Action                   | Cost                      | What happens                                                                                      |
| ------------------------ | ------------------------- | ------------------------------------------------------------------------------------------------- |
| **Buy you out**          | Your declared price × 1.1 | They become the new owner. You get declared price + deposit back.                                 |
| **Poke your tax**        | Gas only                  | Anyone can force a tax collection on your tile. If you can't pay → foreclosure.                   |
| **Wait for decay**       | —                         | Your price decays 20% every 2 weeks (floor: 10% of original). Refresh via `setPrice` to fight it. |
| **Wait for foreclosure** | —                         | If your deposit runs out, the tile auto-forecloses.                                               |

## Where the money comes from

Every ETH that flows through the contract is split between **Treasury** and **tile holders**. The exact splits per source:

| Source                      | Treasury share   | Holders share  |
| --------------------------- | ---------------- | -------------- |
| Admission (every claim)     | 100% (0.007 ETH) | —              |
| Buyout fee (10% of price)   | 90% of the fee   | 10% of the fee |
| Weekly Harberger tax        | 50%              | 50%            |
| Appreciation tax (price up) | 60%              | 40%            |
| Token fees received         | 10%              | 90%            |

The "holders share" is split across all active tile holders proportional to the number of tiles they own. If 200 tiles are active and you own 1, you earn 1/200 of every holder share.

## How fees accumulate

The contract uses a **reward-per-share** accumulator (gas-cheap, no loops). When new revenue arrives:

```
globalRewardPerShare += newAmount / totalTileHolders
```

When you claim:

```
yourShare = (globalRewardPerShare - yourSnapshot) × yourTileCount
```

The bookkeeping is automatic. You only pay gas when you withdraw.

## Why this design is fair

| Concern                                       | How it's addressed                                                                                                                                                   |
| --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "Whales hoard tiles and starve everyone else" | Max 5 tiles per wallet — enforced on every claim and buyout.                                                                                                         |
| "I pay 0.01 ETH and the founders take it all" | Buyout / appreciation / tax revenue is mostly **holder-share**, not Treasury. The Treasury gets the admission but the *recurring* revenue mostly returns to holders. |
| "Stale holders block everyone"                | Harberger forces them to sell, decay erodes their effective price, and unpaid tax foreclosures clear the market.                                                     |
| "The team can change the rules"               | The contract is non-upgradeable. Every parameter is fixed at deploy time. Only `paused` and the Treasury address can change.                                         |


---

# Agent Instructions: 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://gitverse.gitbook.io/gitverse-docs/revshare-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.