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

# Referral Leaderboard

> Referral Leaderboard — Dark Matter Protocol on Robinhood Chain.

# Referral & Leaderboard Payments

Two reward systems run inside the reactor core. Both are paid from the radiation
purchase fee and from deposit volume — never from a treasury subsidy.

## The referral tree — 4 levels

Every new depositor can bind a referrer (the address must have deposited before).
Referrers earn on every downline radiation purchase, **paid instantly at deposit time**:

```solidity theme={null}
uint256[4] private refLevelRewards = [500, 300, 200, 100]; // 5%, 3%, 2%, 1% (bps/100)
```

| Level | Share of the radiation bought by the downline deposit |
| - | - |
| L1 (direct) | 5% |
| L2 | 3% |
| L3 | 2% |
| L4 | 1% |

**Total referral outflow: 11% of each deposit's radiation** — funded entirely by the
10% radiation purchase fee plus the referral mechanics of the curve (the tree is paid
in radiation units, which the referee converts at their own pace).

The binding is one-shot and permanent:

```solidity theme={null}
if (!hasReferrer(msg.sender) && userDeposits[ref] > 0) {
    addReferrer(ref);
}
```

* The referrer must be an **existing depositor** — no sybil self-referrals from
  fresh wallets.
* Binding can also happen lazily on `condenseMatter(ref)`.
* Referral rewards land as **radiation** in the referrer's balance
  (`claimedRadiation[parent] += c`), compounding through the normal node mechanics.

## Daily leaderboard — top 4 depositors

```
reward pool      = 0.5% of the day's total deposit volume   (dayRewardPercentage = 5 /1000)
split            = 40% / 30% / 20% / 10%                    (weeklyTopPercentages)
```

* Ranking is by **largest single-day deposit** per wallet (`userDailyDeposits`).
* Distributed automatically at the first interaction after the UTC-day rollover
  (`distributeDailyRewards()` runs inside every deposit/compound/extract).
* Winners are paid directly (`payTopReward`) — no claim transaction, nothing to forget.

## Weekly leaderboard — top 4 depositors

```
reward pool      = 1.0% of the week's total deposit volume  (weekRewardPercentage = 10 /1000)
split            = 40% / 30% / 20% / 10%
```

Same mechanics over a 7-day window (`userWeeklyDeposits`, `weeklyWinners`).

## Worked example

Week with **100 ETH** total deposit volume. Top 4 weekly depositors:

| Rank | Winner share | Payout |
| - | - | - |
| #1 | 40% of 1 ETH | **0.40 ETH** |
| #2 | 30% | **0.30 ETH** |
| #3 | 20% | **0.20 ETH** |
| #4 | 10% | **0.10 ETH** |

Plus, if the #1 wallet was referred by someone, that referrer earned 5% of the winner's
radiation on every deposit — before the leaderboard even pays.

## Where the money comes from

| Reward | Funding source |
| - | - |
| Referral levels | Radiation purchase fee (10% at buy time) |
| Daily/weekly leaderboards | 0.5% / 1% of gross deposit volume (inside the curve, paid at rollover) |
| VIP weekly pot | The 1% pool cut forwarded by every deposit ([Event Horizon](pools/event-horizon.md)) |
| Founder fee share | The 1% pool cut ([Founder Pass](pools/founder-pass.md)) |

Next: [Stock Dividend Vault](reactor/stock-dividends.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.