> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cashmere.exchange/llms.txt
> Use this file to discover all available pages before exploring further.

# Levels & Tenure

> A level is time held, and nothing else. No token, no purchase, no approval.

## What a level is

A **level** raises how much of every distribution your NFT takes, up to **3.00×**, and it is earned
by one thing only: keeping the NFT registered to the same wallet.

There is nothing to buy. No progression token, no approval, no burn, no emission schedule, and no
pot for anyone to fund. The contract reads a clock.

```
weight = rarity multiplier × level multiplier
```

<Callout type="info">
  Every NFT climbs at the same rate. A King Broker and an Intern Broker reach the top level on the
  same day — rarity decides how large your slice is, never how fast you climb.
</Callout>

## The schedule

Five levels. Each threshold is a fixed amount of unbroken tenure.

| Level | Tenure required | Multiplier |
| ----: | --------------: | ---------: |
|     0 | on registration |      1.00× |
|     1 |        8.3 days |      1.25× |
|     2 |       22.2 days |      1.50× |
|     3 |       55.6 days |      2.00× |
|     4 |    **150 days** |  **3.00×** |

## You press the button

Tenure is not weight until it is **banked**, and banking it is a call you make.

<Steps>
  <Step title="Check what you have earned">
    The app shows the level your tenure currently justifies, and how long is left until the next
    one. Reading it costs nothing and needs no transaction.
  </Step>

  <Step title="Bank it">
    Level up. Your weight rises in the same transaction, and the engine is told immediately.
  </Step>

  <Step title="Repeat at each threshold">
    Nothing is lost by waiting, but nothing is gained either.
  </Step>
</Steps>

<Callout type="warning">
  **A level is never automatic.** A position that has earned level 4 and never banked it still
  carries level 0 weight and is paid as a level 0 holder. Press it when it is due — or bank several
  NFTs at once.
</Callout>

Levelling up **sets** your position to what the clock has earned; it does not increment. Calling it
repeatedly cannot grant a level your tenure does not justify, and calling it early is refused rather
than granting partial credit. Anyone may do it for any NFT — it can only ever apply what that NFT
already earned, so there is nothing to gain by doing it on someone else's.

## The clock

```mermaid theme={null}
flowchart LR
    A[NFT in wallet<br/>unregistered] -->|register| B[Clock starts<br/>level 0]
    B -->|time passes| C[Level 1 · 2 · 3 · 4<br/>banked by you]
    C -->|sell or transfer| D[Position cleared]
    D -->|buyer registers| B
```

<CardGroup cols={2}>
  <Card title="Starts at registration" icon="play">
    Not at mint, not at launch. Nobody is handed tenure for time before their position existed.
  </Card>

  <Card title="Dies with the sale" icon="scissors">
    Clearing a position deletes the level, the clock and the entry it paid. The buyer starts at
    zero.
  </Card>
</CardGroup>

<Callout type="warning">
  **Moving the NFT at all restarts the clock** — not only selling it. Sending it to a hardware
  wallet, into an escrow, or through a bundler looks identical to a sale from the contract's side,
  because the only thing it can see is that ownership changed. There is no grace period.
</Callout>

This is the whole point of the design: the multiplier is a reward for holding, and it cannot be
handed to somebody else. A borrowed NFT earns level 0 for the length of the loan, and the lender's
tenure is gone when it comes back.

## Levelling does not lock your rewards

Registering raises weight, and that starts the four-hour withdrawal lock. **Levelling up raises
weight and does not.**

The engine is told which kind of rise it is hearing, so an earned level is exempt — and it is safe
by construction rather than by policy, because the shortest level takes longer to reach than the
longest lock the engine can be configured with.

<Callout type="info">
  This is why levelling is worth doing the moment it is due. It costs a transaction, applies
  immediately, and takes nothing away.
</Callout>

## Why time rather than a token

An earlier design accrued a burnable point that holders spent on the same five multipliers. Time
replaces it, on the same schedule, and removes four problems at once: nothing is minted, so there is
no supply to model and no pot to fund; there is no second currency to approve and claim before it
can be spent; there is no keeper or daily funding transaction to keep alive; and capital buys
nothing — it is the same 150 days for the largest holder and the smallest.

Comparable protocols sell their multiplier for a token, which makes it transferable in substance:
whoever pays gets it. Tying it to time is what makes it mean the one thing this collection wants it
to mean — that you are still here.