# glossary

### Admission

The one-time 0.007 ETH fee paid to the Treasury when claiming a tile. Non-refundable. Distinct from the tax deposit.

### Appreciation tax

A 30% levy on the *amount by which you raise* your declared price. Charged at the moment of `setPrice`. Splits 60% Treasury / 40% holders.

### Buyout

The act of taking a tile from its current owner by paying their declared price + a 10% fee. Cannot be refused by the current owner — that's the Harberger contract.

### Buyout fee

10% of the buyout price, paid by the buyer on top of the declared price. Splits 90% Treasury / 10% holders pool.

### Declared price

The price the tile owner publicly commits to sell at. Anyone can buy the tile at this price (plus 10% fee). Higher price → more tax, more buyout-resistance.

### Deposit

The ETH reserve sitting inside your tile, used to pay weekly Harberger tax. Refunded on abandon, returned to you on buyout.

### Effective price

The current buyout price after decay has been applied. Decays 20% every 2 weeks since the last `setPrice` or buyout, floored at 10% of original.

### First commit hash

The cryptographic fingerprint of a repository's first commit. Used as the **seed** to generate the planet. Immutable.

### Foreclosure

What happens when a tile's deposit runs out and someone calls `pokeTax`. The tile is marked empty and returned to the market.

### gitlawb

The public, decentralized git network underlying GitVerse. Provides the repo and agent data the universe is built from. Public node at `node.gitlawb.com`.

### Harberger tax

A property regime where owners declare their own price and pay tax proportional to it. Anyone can buy at the declared price. Eliminates speculative hoarding.

### Holders pool

The portion of any fee that flows to all current tile holders, distributed proportionally to tile count. Computed via reward-per-share accumulator.

### Pending fees

Your accumulated but unclaimed holder share. Computed automatically. Withdrawn with `claimFees()`.

### Planet

The visual representation of a single repository, generated deterministically from its first commit hash + metadata.

### Reward-per-share

The accumulator used by the contract to distribute fees to holders without iterating. When a fee arrives, the accumulator increases by `feeAmount / totalHolders`. Each holder's share = `(currentAccumulator - theirSnapshot) × theirTileCount`.

### Seed

The first commit hash. The cryptographic input that determines the entire planet.

### Star

The visual representation of a single agent (developer or org), positioned in the universe by hashing the agent's DID.

### Tile

A claimable slot in the GitVerse economy. There are 10,000. Each binds to a planet via `repoName`. Buying a tile gives you a share of all protocol revenue.

### Treasury

The on-chain address that receives the protocol's share of all fees. Funds infrastructure (RPC, indexing, frontend, audits). Configurable by the contract authority, but not by users.

### Unborn world

A planet for a repo without a readable first commit hash. We don't fabricate seeds, so the planet renders as a placeholder until the repo publishes its first commit.


---

# 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/glossary.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.
