Player Guide

Oil Strategic Reserve (OSR) is a gamified, virtual node-mining platform on Solana. You burn $OSR tokens to deploy virtual Oil Rigs and Mining Shafts on your own 3D compound. Those nodes produce real rewards over time, paid out from a 229M $OSR emission reserve released via a Bitcoin-style halving curve.

Think of it like an incremental game where every action is on-chain: your rigs and shafts are real state, your burns reduce the $OSR supply, and your rewards settle to your wallet.

Both Oil Rigs and Mining Shafts accrue $OSR per second. Mining Shafts can additionally compound pending $OSR directly into level-ups; Oil Rigs are claim-only in v1.

1. 1

   Connect a wallet

   Open the Command Center and connect a Solana wallet. In mock mode you can just paste any address to try the game.

2. 2

   Deploy your first node

   Tap Deploy. Pick an Oil Rig or Mining Shaft, burn the required $OSR + small SOL fee, and it appears on your compound.

3. 3

   Let it produce

   Nodes accrue rewards every second at a rate determined by level, components, and the live emission factor. Watch pending rewards tick up in your HUD.

4. 4

   Claim, upgrade, compound

   Claim to cash out (2% fee), upgrade a node to multiply its rate, or compound a Mining Shaft to auto-spend pending $OSR on a level-up. Repeat.

You can own up to 5 nodes per wallet, mixed freely. Each node is an independent entity with its own level, components, and production rate.

Every node levels up independently from L1 → L10+. Each level adds new 3D geometry (more pumps, derricks, processing gear) and shifts the node's aura color, making progress visible at a glance on the compound.

Effective production rate at any level: baseRate × levelMult × componentMult × emissionFactor

Aura tiers

Higher levels also pump up the scene's bloom intensity — a max-level compound looks visibly brighter than a fresh one.

Each node has 4 component slots. Components are earned by opening Supply Crates (costs $OSR, 3 per day per node type). Every drop has a rarity tier that multiplies the node's output:

A node's total component multiplier is the average of its 4 installed components (empty slots count as 1.0×). Equip better rarities → higher multiplier → faster production.

Slot compatibility: Oil Rig components fit only in Oil Rigs, Mining Shaft components fit only in Shafts. Each component has a specific slot (you can't put a Derrick Tower in a Pump Jack socket).

Use the Inventory page to move components between nodes — unequip from one, equip on another. The displaced component falls back to your locker.

Rewards accrue continuously, per second, based on:

• Your node's base rate (family constant, set per Oil Rig / Mining Shaft)
• The level multiplier (1.0× at L1, 5.0× at L10, extrapolates beyond)
• The component multiplier (average rarity across 4 slots)
• The live emission factor (see section 9)

Pending rewards are kept server-side and streamed to your HUD every ~10s. When you Claim All, every node's pending balance is zeroed and the reserve wallet pays out the net amount to your wallet (2% fee retained in the reserve to keep emissions solvent).

Upgrades and compounds internally accrue first, so you never lose production between actions. A timestamp reset on level-up prevents you from retroactively getting paid at the new, higher rate for time already spent at the old level.

Instead of claiming pending $OSR, you can compound it — the protocol spends your pending balance directly on a level-up for that shaft. Pros:

• Lower fee (0.75% vs 2% on claims)
• No SOL upgrade fee (burns pending balance only)
• Automatic — click once, done

The compound succeeds only if your pending (minus fee) covers the next level's upgrade cost. Otherwise it's skipped and your pending balance is untouched.

Oil Rig compound is disabled in v1 as a design decision — we kept the feature set narrow for launch. It may land in a future version if players ask for it.

Every OSR leg of a mint or upgrade follows the 70% burn / 30% treasury split. See Tokenomics for the live numbers straight from the backend.

OSR uses a halving emission curve. Global OSR issuance starts at 262 OSR/sec at genesis and halves every 7 days until the lifetime supply is fully paid out.

E(t) = 262 OSR/sec × 0.5 ^ (t / 7d)

Day 0  : 22.6M OSR emitted
Day 7  : 50% of lifetime already emitted
Day 14 : 75% emitted
Day 30 : 95% emitted
Lifetime total: 229M OSR (pre-minted, mint authority revoked)

Each user earns a share of each second's emission, proportional to their grow-power (sum of component multipliers across their nodes):

user_rate = min(your_gp / network_gp, 30%) × E(t) × welcome_boost

Two key mechanics:
  • Share cap: no user can capture more than 30% of emission
    (prevents lottery-in-thin-network wins)
  • Welcome boost: new users get 8× multiplier for 72h,
    linearly decaying — critical for latecomer retention

Why does emission halve? To front-load excitement during the first 2 weeks while still leaving meaningful yields for latecomers. By day 14, 75% of lifetime OSR has been distributed — but latecomers with the welcome boost still earn well for their first 72 hours.

You can always see current global emission and your share on the Reserve Vault page — it's fully public.