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

# Stardust

> Stardust — Dark Matter Protocol on Robinhood Chain.

# Stardust (DUST) & the Wheel

DUST is the app-wide **activity score**: everything you do sprinkles it. It is a
**non-transferable** ERC20 (transfers locked) with **no monetary rights** — it powers
in-app status, the prize wheel, and treasury governance vote weight. Keeping it
non-transferable keeps the whole loop free of real-money gambling mechanics.

## Earning

| Source | Amount | Where |
| - | - | - |
| Reactor deposits | **500 DUST per 1 ETH** (`stardustPerEth`), boostable | Auto on every `injectMass` |
| Daily check-in | **25 DUST** base, **+20% per consecutive day**, capped at **3× (75)** | Self-serve, on-chain (`checkIn()`) |
| Off-chain activity | shares, claims, referrals, lootbox opens | Relayer signs an award; user cashes via `claimAward` |

### The streak ladder

```
day 1: 25 DUST
day 2: 30 DUST   (×1.2)
day 3: 36 DUST   (×1.44)
day 4: 43.2 DUST (×1.728)
day 5: 51.8 DUST (×2.074)
…     capped at 75 DUST (×3) from day 11 on
```

Missing a day (48h gap) **resets the streak** — unless rescued: within 24h after a
lapse, `saveStreak()` pays an ETH fee (base **0.001 ETH × saved streak multiplier**)
to keep the ladder where it left off. **100% of rescue fees forward to the
DarkMatterTreasury** — this is one of the treasury's core streams.

## Spending — the Wheel

| Parameter | Value |
| - | - |
| Spin cost | **100 DUST, burned** (deflationary sink) |
| Founder Pass price | 50 DUST |
| Free spin | First spin every 24h is free |
| Jackpot refill | **55% of every spin's cost** refills the jackpot pool (`JACKPOT_REFILL_BPS = 5500`) |
| Jackpot seed | 1500 DUST |
| The house keeps | **Nothing** — the wheel is not a profit center |

```
100 DUST spin ──▶ burned (gone forever)
                    └── 55 DUST equivalent refills the jackpot pool
Prizes: DUST payouts · 24h 2×/3× stardust boosts · the jackpot
```

### Boost stacking

Boosts multiply **all** DUST earning while active. The stacking rule is friendly:
an **equal** boost extends the 24h window; a **weaker** boost never downgrades a
stronger active one.

### Wheel randomness

Commit→reveal over the canonical **ArbSys L2 block hash** (see
[Event Horizon](../pools/event-horizon.md) for why the EVM block number can't be
used on this chain): the spin commits a future L2 block, the reveal derives the seed
from `blockhash(commitL2Block)` — a hash that did not exist when the player signed.
Stale commits (past the 256-block horizon) re-commit instead of bricking.

## Supernova — global boosts

When the treasury's cumulative spend crosses a milestone, it fires
`activateGlobalBoost(20000 bps, 1 day)` — **everyone's** DUST earning is multiplied
server-wide for 24h. See [Treasury](../pools/treasury.md).

## Governance weight

DUST `balanceOf` is the **vote power** in treasury proposals (1% quorum of snapshotted
supply). More activity → more DUST → more say in where the treasury's DAO era spends.

## Ledger honesty

Every DUST source flows through one credited-mint path:

```solidity theme={null}
function _creditDust(address user, uint256 amount, string memory source) internal {
    _mint(user, amount);
    lifetimeEarned[user] += amount;
    emit DustEarned(user, amount, source);
}
```

`lifetimeEarned` / `lifetimeSpent` are public per-address ledgers; every source string
("deposit", "checkin", "award", …) is emitted with the mint.

Next: [Earn Zap Router](../earn/earn-zap.md).


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