CrudeFi Docs
CrudeFi Protocol · Direction A
Operator's Manual
Everything you need to deploy, extract, and win.
Complete field manual for CrudeFi, an on-chain oil extraction economy on Solana. Read before deployment.
OVERVIEW
CrudeFi is an on-chain oil extraction economy on Solana. You own land. You drill. You earn. No trading. No providing liquidity. No clicking buttons all day. You build an oil operation, it runs on-chain 24/7, and you collect yield.
The Idea
Your land is an NFT. Your rigs are infrastructure units you deploy on that land. The more rigs you run, the more Crude/sec you generate. Crude/sec is your hashrate. It determines your share of daily $BLACKGOLD emissions. More rigs = more yield. Simple.
On top of that there's a jackpot. Every hour there's a chance an event fires and one player wins the entire pool. The more unclaimed crude you're sitting on, the higher your odds. So the game becomes: do you claim now, or hold and go for the jackpot?
The Jackpot Theme
CrudeFi is framed around geopolitical oil-market events because oil has always moved on global news. Jackpot firings are named after supply shocks. The UI marks the moment, and one player walks away with the entire pool.
The Loop
MINT LAND → DEPLOY RIGS → GENERATE CRUDE/SEC → EARN YIELD → HOLD FOR JACKPOT → WIN
GETTING STARTED
Three things you need: a Phantom wallet, 0.5 SOL minimum, and an invite code. That's it. Game is invite-only at launch so you need a code from someone already in.
WALLET
Phantom on Solana mainnet
0.5 SOL
Minimum to mint
INVITE CODE
From an existing player
The Decision You'll Always Be Making
CLAIM
HOLD
That tension is the core of CrudeFi.
SETUP
Six-step deployment from wallet connect to first emission. Run each in order.
CONNECT YOUR WALLET
BUY YOUR NFT FOR 0.5 SOL
Max 5 NFTs per wallet during early mint.
Note
Submit the wallet you're actually minting from. Whitelist is wallet-specific. Wrong address and you can't mint.
STAKE YOUR NFT TO LOCK INTO THE GAME
BUY INFRASTRUCTURE WITH $BLACKGOLD
DEPLOY YOUR INFRASTRUCTURE ON YOUR FIELD
START EARNING
Now decide: claim now or hold for the jackpot?
HOW IT WORKS
Crude/sec is Your Hashrate
Every unit you deploy generates Crude/sec. Add them all up and that's your hashrate. Your hashrate determines your cut of daily emissions.
Your daily $BLACKGOLD = (Your Crude/sec ÷ Total system Crude/sec) × Daily emission × 99%
If total system is running 100,000 Crude/sec and you're running 1,000, you get 1% of that day's emissions. As more players join, the total goes up, which is why early players with less competition earn more per unit of Crude/sec than late ones.
Emissions Decay: Early is Early
Daily emissions drop every phase. Once a phase ends it never comes back.
| PHASE | PERIOD | DAILY EMISSION | STATUS |
|---|---|---|---|
| PHASE 1 | Day 1 – 15 | 10,000,000 / day | ACTIVE |
| PHASE 2 | Day 16 – 45 | 5,000,000 / day | PENDING |
| PHASE 3 | Day 46 – 105 | 2,500,000 / day | PENDING |
| PHASE 4 | Day 106+ | 1,000,000 / day | PENDING |
← scroll →
Phase 1 pays 10x more per day than Phase 4. A player running 1,000 Crude/sec in Phase 1 earns what a Phase 4 player needs 10,000 Crude/sec to match. That gap never closes.
Slots Are Your Ceiling
Your NFT tier = your slot count. Slots are your limit for how many units you can deploy.
MAX OUTPUT
Claiming Resets Your Jackpot Weight
When you claim crude it becomes $BLACKGOLD, but your jackpot weight goes to zero immediately.
CLAIM
- • Get $BLACKGOLD now
- • Pay 2% claim tax
- • Jackpot weight resets
- • Can rebuy more infra
HOLD
- • Jackpot weight keeps building
- • Zero tax
- • Higher odds every hour you hold
- • Risk: someone else wins the pool
CLAIM TAX SPLIT
48-HOUR ANTI-BOT WINDOW
BURN & ECONOMICS
Six burn mechanisms. Running simultaneously. Every day. This is what makes CrudeFi last more than a week.
Token Supply
1,000,000,000 $BLACKGOLD
Fixed · No printing ever
| ALLOCATION | AMOUNT | % |
|---|---|---|
| Team | 70,000,000 | 7% |
| Liquidity pool | 80,000,000 | 8% |
| Player emissions | 850,000,000 | 85% |
← scroll →
150M live on day 1. The other 850M gets earned by players through gameplay over ~1.5 years. No presale. No VC dump.
Six Burn Vectors
| TRIGGER | WHAT BURNS |
|---|---|
| Player mints (0.5 SOL) | 60% of SOL buys $BLACKGOLD on market and burns |
| Infrastructure draw | 80% of $BLACKGOLD spent |
| Maintenance payment | 80% of $BLACKGOLD spent |
| Crude claim | 1.5% of claimed amount |
| NFT auction bid | 80% of winning bid |
| Secondary NFT resale | 1% of sale price |
← scroll →
Mint burns and draw burns are the engine. Every new player triggers a SOL-funded buyback and burn. Every infrastructure draw burns 80% of the $BLACKGOLD spent. The bigger the game gets, the more draws and mints fire, the more burns. Supply shrinks as the game grows. That's the flywheel.
All Splits in One Table
| ACTION | BURN | JACKPOT | TEAM | TREASURY | USERS |
|---|---|---|---|---|---|
| SOL entry | 60% | 25% | 10% | 5% | — |
| $BLACKGOLD infra spend | 80% | 10% | — | — | 10% reward |
| Crude claim tax | 1.5% | 0.5% | — | — | 98% to you |
| Daily emission | — | 1% | — | — | 99% to players |
| NFT auction bid | 80% | 10% | 10% | — | — |
| Secondary royalty (7%) | 1% | 1% | 5% | — | — |
← scroll →
FIELDS
Your Reserve NFT is your land. It defines how many infrastructure slots you have and that number is your ceiling forever. Can't upgrade it post-mint. What you mint is what you get.
The Five Tiers
FRONTIER LEASE
Open mint 0.5 SOL always
OFFSHORE CONCESSION
Auction ($BLACKGOLD only)
DEEP BASIN RESERVE
Auction ($BLACKGOLD only)
REFINERY CONTROL ZONE
Auction ($BLACKGOLD only)
SOVEREIGN STRATEGIC RESERVE
Auction ($BLACKGOLD only)
L1 NEVER CLOSES
THE WHALE TIER
Slots Explained Simply
A slot is a space for a unit. Different units take different slot counts. You can't deploy more slots than your NFT allows. Wallets with multiple NFTs manage each one separately. Slots don't combine.
Secondary Market Royalties
Every secondary resale of a Reserve NFT carries a 7% royalty:
5%
Team
1%
Jackpot
1%
Burn
Every time an NFT changes hands, the jackpot grows and more $BLACKGOLD burns.
INFRASTRUCTURE
Infrastructure units are what generate your Crude/sec. Deploy them on your land and they run 24/7 automatically.
How to Get Units
Lottery-style. Each draw costs 5,000 $BLACKGOLD and gives you a random unit. Rarer units have lower win chances.
80%
Burned
10%
Jackpot
10%
Reward Contract
All Units
| UNIT | SLOTS | CRUDE/SEC | CRUDE/SLOT | TIER |
|---|---|---|---|---|
| Rotary Drill Rig | — | — | — | Basic |
| Pumpjack Array | — | — | — | Basic |
| Seismic Scanner Grid | — | — | — | Standard |
| Pipeline Trunkline | — | — | — | Standard |
| Pressure Valve System | — | — | — | Advanced |
| Refinery Catalytic Unit | — | — | — | Advanced |
| Offshore Platform | — | — | — | Premium |
| Storage Terminal | — | — | — | Premium |
| Quantum Crude Reactor | — | — | — | Elite |
← scroll →
THE BEST UNIT
$BLACKGOLD
$BLACKGOLD is the token that powers everything in CrudeFi. You earn it by playing. You spend it to build. A large chunk burns with every transaction.
1,000,000,000 TOTAL SUPPLY
Fixed · No minting ever
Supply Breakdown
| ALLOCATION | AMOUNT | % | WHEN |
|---|---|---|---|
| Team | 70,000,000 | 7% | vested |
| Liquidity pool | 80,000,000 | 8% | Day 1 |
| Player emissions | 850,000,000 | 85% | Earned via gameplay |
← scroll →
150M circulates on day 1. The rest flows to players over ~1.5 years through decaying emissions. No presale. No VC. You earn it or you buy it on market.
How You Earn It
DAILY EMISSIONS
Proportional to your Crude/sec share of the total system. More rigs = bigger cut.
JACKPOT
One player wins the entire pool when the next event fires.
REFERRALS
5% of every referred player's yield, forever, automatically.
How You Spend It
- ▸Infrastructure draws (5,000 $BLACKGOLD per draw)
- ▸NFT auctions: bid on L2–L5 reserves after early mint (no SOL accepted)
Why It Deflates
80% of every draw burns. Every new mint triggers a $BLACKGOLD buyback and burn from SOL. Every jackpot firing pulls $BLACKGOLD out of circulation via the 1.5% claim tax. As more players build and play, more burns happen. Supply shrinks while demand grows from new players needing $BLACKGOLD to enter the game.
JACKPOT
Every hour the protocol runs a check. 1/69 chance it fires. When it fires, one player wins the entire jackpot pool. Everything in it. To one wallet. This is the mechanic that makes CrudeFi a game and not just a farm.
Your Odds
Your win chance = Your unclaimed crude ÷ Total system unclaimed crude
No VIP access. No whitelist advantage. The player sitting on the most unclaimed crude at the snapshot moment has the highest odds. Claim your crude and your odds reset to zero. Hold it and your probability builds every hour.
VERIFIABLE RANDOM FUNCTION
Where the Pool Comes From
Six sources feed it simultaneously:
| SOURCE | RATE |
|---|---|
| New player entry | 25% of every 0.5 SOL mint |
| Infrastructure draws & maintenance | 10% of $BLACKGOLD spent |
| Daily emissions | 1% every day |
| Crude claims | 0.5% of every claim |
| NFT auction bids | 10% of every winning bid |
| Secondary NFT resales | 1% of sale |
← scroll →
It builds constantly. Even when nobody's playing, daily emissions keep feeding it. By the time it fires, the pool is always meaningful.
The Minimum Threshold
100,000 $BLACKGOLD FLOOR
The Event Theme
Each jackpot firing gets a name. The UI marks the event, names it, announces the winner. Built to be screenshot-able and shareable.
Why You Should Hold
A player who claims every day has zero jackpot power. A player who hasn't claimed in two weeks has been stacking probability while everyone else reset their own odds. The longer you hold, the larger your share of total system unclaimed crude, because other players are claiming and resetting their positions while yours just keeps growing.
YOUR MOMENT
EARLY MINT
1,000
NFTs Total
2 × 500
Two Phases
0.5 SOL
One Price
After the early mint closes, L2 through L5 go to $BLACKGOLD auction only. Base price is gone forever.
Why Mint Early
Phase 1 emissions are 10,000,000 $BLACKGOLD per day. That drops to 5M on day 16, then 2.5M, then 1M from day 106 forever. The earlier your rigs are running, the more of the highest emission rate you capture. That window doesn't reopen.
Phase 1 and Phase 2
Same contract. Same tiers. Same odds. Same price. Just capped at 500 per phase, and your wallet should be whitelisted for mint. Whatever doesn't get minted in Phase 1 rolls into Phase 2. First come, first served until 1,000 total is hit.
Tier Odds
| TIER | NAME | TOTAL | ODDS | AFTER MINT |
|---|---|---|---|---|
| L1 | FRONTIER LEASE | 445 | 44.5% | Open mint 0.5 SOL always |
| L2 | OFFSHORE CONCESSION | 390 | 39% | Auction ($BLACKGOLD only) |
| L3 | DEEP BASIN RESERVE | 120 | 12% | Auction ($BLACKGOLD only) |
| L4 | REFINERY CONTROL ZONE | 35 | 3.5% | Auction ($BLACKGOLD only) |
| L5 | SOVEREIGN STRATEGIC RESERVE | 10 | 1% | Auction ($BLACKGOLD only) |
← scroll →
Tier revealed at mint. Random draw on-chain. Same 0.5 SOL price regardless of what you get. L5 is the rarest. Only 20 exist total across the entire protocol. 10 in early mint, 10 go straight to auction.
Where Your SOL Goes
| RECIPIENT | SHARE |
|---|---|
| $BLACKGOLD buyback & burn | 60% |
| Jackpot pool | 25% |
| Team | 10% |
| Treasury | 5% |
← scroll →
60% of your 0.5 SOL immediately buys $BLACKGOLD on the open market and burns it. Supply starts shrinking from the first mint.
Max Per Wallet
5 NFTs during the early mint window.
Get Whitelisted
Whitelist only. Submit your Solana wallet address via the Drill Permit page.
CRITICAL
REFERRALS
CrudeFi is invite-only at launch. Every player starts with 2 invite codes after minting NFT. Share your code. When someone joins using it, you earn 5% of their generated $BLACKGOLD yield forever, automatically, no claiming needed.
Getting More Codes
You start with 2 codes. As you play more and generate more yield daily, you earn 1 new invite code per 100 $BLACKGOLD mined. Play more. Earn more. Unlock more codes. Bring in more players. Earn more from them too. Cap at 5 active codes per player. You won't earn a new one until your existing codes are used.
How the Earnings Work
| DETAIL | VALUE |
|---|---|
| Starting codes | 2 per player |
| Referral yield | 5% of referee's earned $BLACKGOLD |
| Code cap | Max 5 active codes per player |
| Replenishment | 1 new code per 100 $BLACKGOLD mined, once existing codes are used |
| Payment | Automatic from Reward Contract |
| Structure | One level, no chain referrals |
| Duration | Lifetime |
← scroll →
The Play
Bring in active builders. Someone running an L5 with 15,000 Crude/sec is a serious passive income source for you. 5% of their daily emissions lands in your wallet without you doing anything extra. Quality referrals beat quantity every time.
SHARE FREELY
FAQ
Field intelligence. Click any question to expand the briefing.
Do I need to stay online for my rigs to run?+
No. Infrastructure runs on-chain 24/7. Close your tab, sleep, go on holiday. Crude/sec keeps ticking, emissions keep landing.
Can I lose my Reserve NFT?+
No. Staking activates your land but the NFT stays in your wallet. Unstake any time. It's never at risk.
Can I hold multiple NFTs?+
Yes. No limit on holdings. Each NFT is managed independently. Slots don't combine across NFTs. To play the game you only need 1 NFT; multiple NFTs don't combine in a single game. Early mint cap is 5 per wallet, so you can mint and gift it to your friends who can start drilling on solana.
Why can't I claim in the first 48 hours?+
Anti-bot window. Stops sybil wallets from farming entry rewards and dumping immediately. Early claims in this window get taxed up to 50%. Just hold. Jackpot windows start firing within those first two days anyway.
How is the jackpot winner chosen?+
Verifiable Random Function (VRF) on-chain. Your odds = your unclaimed crude / total system unclaimed crude at snapshot. Fully provable. Nobody can manipulate it, including the team.
Is there a way to know when the jackpot fires?+
No. 1/69 chance per hour, expected ~50–100 hours between events. The unpredictability is the point.
What if the jackpot hasn't fired in days?+
It's still building. Every hour it doesn't fire, it gets more from daily emissions, new mints, claims, and draws. A jackpot that hasn't fired in a week is a very large jackpot.
When do emissions end?+
Phase 4 runs at 1M/day for ~400 days starting day 106. Total runway ~1.5 years from launch. Long-term reward mechanisms keep the game running beyond that. V2 updates arrive by Phase 3 with significant new gameplay.
What is the Reward Contract?+
Protocol-controlled contract holding the 10% recycled from draws and maintenance. Supplements long-term rewards so game can sustain longer for users. Not a team wallet.
LINKS
SECURITY ADVISORY
Official Channels
| Website | crudefi.xyz |
| Twitter / X | @Crudefi |
| Telegram | t.me/CrudefiCommunity |
Contract Addresses
| ASSET | ADDRESS |
|---|---|
| $BLACKGOLD Token | TBA at launch |
| Mint Contract | TBA at launch |
| Jackpot Contract | TBA at launch |
← scroll →
Addresses will be posted here and pinned in Telegram at launch. Do not interact with any contract not listed on this page.
V2: INCOMING
This documentation covers V1, the extraction economy. Mint land, deploy rigs, farm emissions, win the jackpot. V2 is what comes after V1 is live and stable.
PvP. Territorial contests.
Players will be able to directly contest each other's operations.
RAID RESERVES
Siphon accumulated crude
DISRUPT RIGS
Reduce competitor output
TERRITORY CONTROL
Compete for dominance
CrudeFi stops being just themed around oil-market competition and becomes an actual contest with real competitive mechanics where players can take from each other and compete for dominance.
Timeline
V2 starts development once V1 is live and stable. One thing at a time, done right. Full details on PvP mechanics and territory systems drop after V1 launches.
WHY THIS MATTERS NOW
End of Manual
CRUDEFI PROTOCOL // SOLANA // ALL RIGHTS RESERVED