# Holder Rewards

Streamlock redistributes **40% of all trading fees** collected during unlock windows directly to token holders as SOL. Hold through the unlock, earn from those who sell.

***

## Overview

Every time a token completes a milestone cycle (GRIND → FREEZE → UNLOCK), trading fees collected during the unlock window are split:

| Share   | Recipient     | How                                        |
| ------- | ------------- | ------------------------------------------ |
| **50%** | Protocol      | Retained in protocol treasury              |
| **40%** | Token holders | Merkle vault — claim SOL on the token page |
| **10%** | Token creator | Direct SOL transfer                        |

This applies to **all** trading fees during the unlock window — both buy fees (3% flat + epoch pressure) and sell fees (25% → 1% decay).

***

## How It Works

### 1. Accumulate

During the unlock window, every buy and sell generates fees. These are tracked on-chain in the pool's `unlock_fees_collected` field.

### 2. Snapshot

When the unlock window ends, the protocol snapshots all token holders and their balances — including tokens held in Streamflow escrow streams. Your balance at the moment the window closes determines your share.

### 3. Distribute

The protocol computes each holder's pro-rata share and creates a **Merkle vault** on-chain, funded with 40% of the total fees. A Merkle root is published so claims can be verified trustlessly.

### 4. Claim

A green banner appears on the token page showing your claimable SOL. Click **Claim** to receive your reward. The protocol covers transaction costs — no gas fee required.

***

## Who Qualifies?

Any wallet holding tokens at the end of the unlock window. This includes:

* Tokens in your wallet
* Tokens in Streamflow escrow streams (locked positions)

**You do NOT qualify if:**

* You sold all your tokens during the unlock window (balance = 0 at snapshot)
* You never held the token

***

## Incentive Design

The holder rewards system creates a strong incentive to hold through unlock windows:

| Action                  | Outcome                                                            |
| ----------------------- | ------------------------------------------------------------------ |
| **Hold through unlock** | Earn SOL from trading fees (both buyers and sellers fund the pool) |
| **Sell during unlock**  | Forfeit your share; your sell fee goes partly to those who held    |
| **Buy during unlock**   | Your buy fee partly rewards existing holders                       |

This means:

* **Holders are rewarded** for not panicking
* **Sellers fund the rewards** through their sell fees
* **New buyers also contribute** — their buy fees add to the reward pool
* **The reward pool grows** even if few people sell (buy fees still accumulate)

***

## Example

A token completes milestone 2. During the unlock window:

```
Total buy volume:   50 SOL (average 5% fee → 2.5 SOL in buy fees)
Total sell volume:  30 SOL (average 13% fee → 3.9 SOL in sell fees)
Total trading fees: 6.4 SOL

Split:
  Protocol (50%):  3.20 SOL
  Holders (40%):   2.56 SOL  ← Merkle vault
  Creator (10%):   0.64 SOL

You hold 3% of the token supply:
  Your reward: 2.56 × 3% = 0.077 SOL
```

Rewards compound across milestones. A token that goes through milestones 1, 2, and 3 generates three separate reward distributions.

***

## Claiming

1. Visit the token page while connected with your wallet
2. If you have unclaimed rewards, a green **Holder Rewards Available** banner appears
3. Each milestone reward is shown separately with the claimable SOL amount
4. Click **Claim** — the transaction is sent automatically
5. SOL arrives in your wallet within seconds

You can claim at any time — rewards don't expire.

***

## Technical Details

* Rewards are secured by a **Merkle proof** system — the same pattern used by Jupiter airdrops and other major Solana protocols
* Each milestone creates a separate on-chain **AccumulatorVault** PDA
* Double-claiming is impossible (claim status is tracked on-chain via PDA)
* The Merkle root and proofs are computed off-chain and published on-chain for trustless verification

***

## Related

* [Fee Structure](https://streamlock.gitbook.io/streamlock-docs/fees-and-economics/fee-structure) — Full fee rates and distribution
* [Freeze & Unlock Windows](https://streamlock.gitbook.io/streamlock-docs/core-concepts/freeze-and-unlock) — How the unlock lifecycle works
* [Selling Tokens](https://streamlock.gitbook.io/streamlock-docs/guides/selling-tokens) — Sell fee timing strategies