# Freeze & Unlock Windows

Streamlock uses a milestone-based lifecycle to manage when selling and withdrawals can occur. Understanding these phases is essential to timing your exits.

***

## The Lifecycle: GRIND → FREEZE → UNLOCK → GRIND

Every token pool on Streamlock cycles through three phases:

| Phase      | What Happens                            | Selling Allowed?           |
| ---------- | --------------------------------------- | -------------------------- |
| **GRIND**  | Price works toward the milestone target | No (tokens locked)         |
| **FREEZE** | Target hit — pool freezes               | No                         |
| **UNLOCK** | Window opens for selling/withdrawing    | Yes (with time-decay fees) |

After the unlock window closes, the pool enters a new GRIND phase with a higher milestone target. The cycle repeats.

***

## GRIND Phase

The active trading phase. Buyers purchase tokens, and the community works ("grinds") to push the price toward the current milestone target.

During GRIND:

* Buying is open (subject to epoch caps)
* Selling and withdrawals are **not available**
* Price progress toward target is tracked on the token page

***

## FREEZE Phase

When the market price hits or exceeds the milestone target, the pool enters a **freeze**.

**Purpose:**

* Prevents immediate sell-the-news dumps
* Gives the community time to recognize the milestone
* Creates a predictable transition to the unlock window

**Duration:**

* Milestone 1: **24 hours** (86,400 seconds)
* Subsequent milestones get shorter: `base / (1 + (m-1)/5)`

| Milestone | Freeze Duration |
| --------- | --------------- |
| 1         | 24h             |
| 2         | 20h             |
| 3         | \~17.1h         |
| 5         | \~13.3h         |
| 10        | \~8.7h          |

During freeze:

* No selling or withdrawals
* Buying is still open
* Price is above target by definition

***

## UNLOCK Phase

After the freeze ends, the **unlock window** opens. This is the only time you can sell tokens or withdraw from your stream.

**Duration:**

* Milestone 1: **48 hours** (172,800 seconds)
* Subsequent milestones get longer: `base × (1 + (m-1)/3)`

| Milestone | Unlock Window |
| --------- | ------------- |
| 1         | 48h           |
| 2         | 64h           |
| 3         | \~80h         |
| 5         | \~112h        |
| 10        | \~192h        |

During the unlock window:

* Sell your tokens for SOL via the AMM
* Withdraw tokens to your wallet
* Sell fees start high (\~25%) and decay to \~1% by end of window

After the unlock window closes, any unsold tokens remain locked. The pool enters a new GRIND phase with a higher milestone target.

***

## Milestone Progression

Each time a target is hit and the cycle completes, the next target is set higher:

```
Next Target = Current Target × (1 + 1/√milestone)
```

| Milestone | Multiplier | Example (starting at 0.0001 SOL) |
| --------- | ---------- | -------------------------------- |
| 1 → 2     | 2.0×       | 0.0001 → 0.0002                  |
| 2 → 3     | \~1.71×    | 0.0002 → 0.000342                |
| 3 → 4     | \~1.58×    | 0.000342 → 0.000540              |
| 5 → 6     | \~1.45×    | —                                |
| 10 → 11   | \~1.32×    | —                                |

Target growth slows with each milestone, making each successive target harder but still achievable.

***

## Anti-Whale Time Lock

If you purchase more than the 1% holding limit, excess tokens go into a separate time-locked position:

| Position Type      | Lock Conditions                                       |
| ------------------ | ----------------------------------------------------- |
| Price-gated stream | Until milestone target hit + unlock window            |
| Excess (>1%)       | 67-day cliff + 67-day linear vesting (134 days total) |

The excess lock uses Streamflow:

* **First 67 days**: Fully locked (cliff period)
* **Next 67 days**: Linear daily vesting

This ensures fair distribution without preventing large buyers from participating.

***

## Dispute Window (Gaming)

For the gaming system, dispute windows protect players from incorrect game results.

**How it works:**

1. Game ends → Results submitted by operator
2. **Dispute window opens** (typically 1 hour)
3. Players can challenge results if incorrect
4. Window closes → Results finalized
5. Entitlement changes applied to ledgers

**What you can dispute:**

* Incorrect game outcomes
* Wrong entitlement calculations
* Operator errors

**Cost:** Small dispute fee (refunded if dispute is valid)

***

## Timing Summary

```
     ┌──────────┐     ┌──────────┐     ┌──────────┐
     │  GRIND   │────▶│  FREEZE  │────▶│  UNLOCK  │
     │          │     │          │     │  WINDOW  │
     │ Buy open │     │ No sell  │     │ Sell open│
     │ No sell  │     │ 24h (M1) │     │ 48h (M1) │
     └────┬─────┘     └──────────┘     └────┬─────┘
          │                                  │
          │         New target set            │
          ◀──────────────────────────────────-┘
```

For gaming:

```
GAME ENDS
    ↓
┌─────────────────┐
│ Results Submit  │  ← Operator posts outcomes
└────────┬────────┘
         ↓
┌─────────────────┐
│ Dispute Window  │  ← Players can challenge (~1 hour)
└────────┬────────┘
         ↓
┌─────────────────┐
│   Finalized     │  ← Entitlements updated
└─────────────────┘
```

***

## Key Takeaways

1. **Three phases** — GRIND (buy/hold), FREEZE (wait), UNLOCK (sell/withdraw)
2. **Freeze gets shorter** with each milestone — rewarding long-term holders
3. **Unlock window gets longer** with each milestone — more time to exit
4. **Sell fees decay** during the unlock window — patience pays off
5. **134-day lock on excess** — 67-day cliff + 67-day vesting for anti-whale
6. **1-hour dispute window** — Challenge bad game results quickly

***

## Related

* [Target Price & Milestones](https://streamlock.gitbook.io/streamlock-docs/core-concepts/target-price) - How targets progress
* [Streaming Proceeds](https://streamlock.gitbook.io/streamlock-docs/core-concepts/streaming-proceeds) - How settlement works
* [Fee Structure](https://streamlock.gitbook.io/streamlock-docs/fees-and-economics/fee-structure) - Fees during the unlock window