# owning a tile

You've claimed a tile. Now what?

## Day 1: do nothing

You don't need to interact with the contract daily to earn. The reward-per-share accumulator works in the background — every new fee adds to your `pendingFees` automatically.

You can verify your accrual at any time:

* Open the tile modal in the app and check **"Pending fees"** in the owner section.
* Or call `getPlayer(yourAddress)` directly on the contract.

## Claiming your fees

When you want to withdraw what you've earned:

1. Open your tile in the app (RevShare or 2D/3D map).
2. Click **Claim Fees**.
3. Confirm the transaction.
4. The contract sends your accumulated holder share to your wallet.

There's no minimum amount, no vesting, no lockup. You can claim 1 wei or 1 ETH the same way.

## Keeping your tile safe

The single risk you need to manage is **deposit runway**. The contract takes 5% of your declared price per week as tax. With the default initial deposit of 0.003 ETH and a declared price of 0.01 ETH:

```
weekly tax  = 0.01 × 5% = 0.0005 ETH
runway      = 0.003 / 0.0005 = 6 weeks
```

After 6 weeks, anyone calling `pokeTax` will foreclosure your tile if you haven't topped up.

### Topping up

```
Click "Add Deposit" → enter amount → confirm
```

You can add any amount. The deposit balance is yours — anything left when you exit comes back to you (via abandon or buyout).

### Withdrawing excess

If you over-deposited, you can pull some back:

```
Click "Withdraw Deposit" (when the UI exposes it) → enter amount
```

The contract settles your tax first, then sends the requested amount back. You can never withdraw more than your deposit minus tax owed.

## Pricing strategy

This is where Harberger gets interesting.

### Defensive pricing

Set price = 0.01 ETH (the minimum). You pay the least tax (0.0005 ETH/week), but anyone can buy your tile for 0.011 ETH. Good if you don't care about the specific tile.

### Aggressive pricing

Set price = 0.1 ETH. You pay much more tax (0.005 ETH/week = 0.02 ETH/month). But to buy you out, someone needs to commit 0.11 ETH. Plus, when they do, they pay 0.01 ETH in fee that splits 0.009 to Treasury / 0.001 to holders — and you get 0.1 ETH for a tile you originally paid 0.01 ETH for.

### Adaptive pricing

Most rational holders adjust price based on tile demand. If your tile is highly contested, raise the price (and accept the tax). If it sits quietly, lower it.

### Caution: appreciation tax

Raising price isn't free. The contract takes 30% of the price increase as appreciation tax. So going from 0.01 → 0.02 ETH costs 0.003 ETH in tax. Make sure you have it in your deposit or send it along with the `setPrice` call.

## Exiting

Two ways out:

### Abandon

```
Click "Abandon Tile" → confirm
```

The contract:

* Settles any pending tax
* Refunds your remaining deposit
* Marks the tile empty
* Emits `TileAbandoned`

Your `pendingFees` are NOT touched — they remain claimable forever.

### Be bought out

You don't control this — someone else triggers it. When it happens:

* You receive `effectivePrice + your remaining deposit`
* 90% of the 10% buyout fee goes to Treasury
* 10% of the buyout fee adds to the holders pool (including the new owner)

You walk away with cash. If the price had appreciated above what you paid, you profited.

## When the universe ignores you

The frontend uses tile-bound metadata to show **OWNED** status on the RevShare grid. But the planet itself in the 2D and 3D views is computed from the gitlawb data, **not** from on-chain state. Your tile ownership doesn't change the planet's visual.

What changes is:

* The badge on the RevShare card flips from AVAILABLE to OWNED.
* The tile modal shows your address as owner.
* You earn fees.

The economy and the universe are coupled by the `repoName` link, but visually distinct.


---

# 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/owning-a-tile.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.