Caldera Protocol
Docs
How conquest, pricing, mining, and staking work on Robinhood Chain — written for operators and players who want the full picture.
overview
Overview
Caldera is territory conquest on Robinhood Chain. Seven vents. Lands are the product.
There are 7 lands — one per territory — on a single world board. You seize a territory with ETH, earn CLDR while you hold it, and exit when someone outbids you — taking 85% of the next seize price in ETH.
CLDR is fair-launched on Stonks. The protocol does not pre-fund a mining vault and does not mint a team allocation. Mining rewards come only from buybacks funded by seize ETH.
- Seven territories — scarcity by design
- Owner-only — no renters, no operators, no leases
- ETH for conquest — CLDR for mining and staking
- Transparent split on every seize: 85% · 3% · 10% · 2%
- Fixed floor step: +10% after each successful seize
loop
The loop
One cycle. No seasonal reset required to understand the game.
- 01Open the globe and select a territory.
- 02Seize it by paying the current floor in ETH.
- 03Hold to accrue CLDR mining from the buyback-funded vault.
- 04Optionally stake CLDR to earn a share of the 3% ETH slice.
- 05When outbid, receive 85% of the new seize price in ETH instantly.
- 06Repeat on the same territory or expand across the board.
lands
Territories
Seven lands. One board. Every flip matters — you take territory from a holder, not from an empty grid of hundreds.
Each land is a named vent on the globe. Selecting it opens the command panel for seize, portfolio, and stake actions.
| ID | Code | Territory |
|---|---|---|
| 1 | EMB | Ember |
| 2 | ASH | Ashfall |
| 3 | RDG | Ridge |
| 4 | BSN | Basin |
| 5 | CRN | Crown |
| 6 | FRG | Forge |
| 7 | SPR | Spire |
| Field | Meaning |
|---|---|
| Owner | Current controller; zero address = unclaimed |
| Floor / next price | ETH required for the next seize |
| Weight | Mining share factor for that territory |
| Seize count | How many times the land has flipped |
Weight is deterministic from land ID and does not change the seize price. It only affects how mining rewards are split among holders.
Weight
weight = 80 + (landId % 41) → range 80–120
pricing
Pricing
Every territory starts at the same genesis floor. Demand sets the rest.
There is no per-territory premium at genesis. Hot lands rise because they flip more often — not because the protocol assigned them a higher starting price.
| Parameter | Value |
|---|---|
| Genesis floor | STARTING_PRICE (0.01 ETH) |
| Price step | +10% after every successful seize |
| Payment asset | ETH (native) |
| Overpay | Excess ETH refunded in the same transaction |
Next floor
nextPrice = currentPrice × 1.10
| Seize # | Floor (from 0.01 ETH genesis) |
|---|---|
| 1 (genesis) | 0.0100 ETH |
| 2 | 0.0110 ETH |
| 3 | 0.0121 ETH |
| 10 | ~0.0236 ETH |
| 20 | ~0.0612 ETH |
seize
Seize economics
Every ETH paid into a seize is fully allocated. Nothing is opaque.
| Slice | Share | Destination |
|---|---|---|
| Previous owner | 85% | ETH paid instantly to the outbid holder |
| Stakers | 3% | ETH distributed to CLDR stakers |
| Buyback → vault | 10% | ETH swapped to CLDR, deposited into mining vault |
| Protocol | 2% | Ops sink (withdrawable by protocol address) |
Genesis exception: when a land has never been owned, there is no previous owner. The 85% slice is redirected into the buyback path so early conquest still seeds the mining vault instead of minting phantom refunds.
- Genesis buyback path = 85% + 10% = 95% of seize ETH toward CLDR buyback
- Overbid buyback path = 10% of seize ETH toward CLDR buyback
- Rounding dust accrues to the protocol slice
mining
Mining
Hold land → earn CLDR. Vault fills only when seizes buy back CLDR from the open market.
CalderaMiner tracks each land’s effective weight and accrues rewards pro-rata. Claiming mining also refreshes activity on your lands.
- No pre-allocated mining fund
- Rewards arrive only after successful buybacks deposit CLDR
- If buyback ETH queues (no router / thin liquidity), flush when the pool is ready
| Idle rule | Effect |
|---|---|
| Active (seize or claim within 7 days) | Full land weight |
| Idle > 7 days | Effective weight drops to 25% |
| Claim mining | Counts as engagement — resets idle timer |
staking
Staking
Stake CLDR to earn the 3% ETH slice from every seize across the board.
CalderaStake is a separate module. Stakers do not need to own land. Land holders do not need to stake. The two yield paths are complementary.
- Stake CLDR → earn ETH from the global seize stream
- Claim ETH anytime rewards are pending (independent of unstake)
- If ETH arrives before anyone is staked, it residual-queues and flushes when stake appears
- Unstake is instant — no queue, no cooldown (COOLDOWN = 0)
- Withdraw any amount up to your staked balance in one transaction
- Pending ETH rewards remain claimable before or after unstake
token
CLDR & fair launch
CLDR is the mining and staking asset — not the seize currency. Live on Stonks.
| Property | Spec |
|---|---|
| Ticker | CLDR (Caldera) |
| Role | Mining rewards + stake collateral |
| Seize currency | ETH (not CLDR) |
| Launch venue | Stonks Brokers (Robinhood Chain) |
| Team allocation | None in protocol contracts |
| Mining prefund | None — vault is buyback-funded only |
CLDR is fair-launched on Stonks. The game stack points at that token only — no team mint inside Caldera contracts. Seize buybacks purchase CLDR from the open market to fund the mining vault.
addresses
Live addresses
Robinhood Chain (4663). Fill after Stonks CLDR + forge deploy — placeholders until then.
| Role | Address |
|---|---|
| CLDR token | — (Stonks CA pending) |
| Game | — |
| Miner | — |
| Stake | — |
| Buyback | — |
| Protocol %2 | — |
architecture
Architecture
Five contracts. Clear boundaries. Permissionless claims.
| Contract | Responsibility |
|---|---|
| CLDR (Stonks) | Fair-launch ERC-20 — game never mints supply |
| CalderaGame | Land state, ETH seize, split routing |
| CalderaBuyback | Queue ETH, swap to CLDR, fund miner |
| CalderaMiner | Weight accounting, CLDR claims, idle decay |
| CalderaStake | CLDR stake, ETH reward claims, instant unstake |
- 01User calls Game.seize{value}(landId).
- 02Game updates ownership and notifies Miner.
- 03Game sends ETH to previous owner / Stake / Buyback / protocol accrual.
- 04Buyback swaps ETH→CLDR (or queues) and deposits into Miner.
- 05Holders claimMining(); stakers claimEth().
risks
Risks & notes
Read this before size. Caldera is an onchain game, not a savings product.
- Smart-contract risk — contracts may contain bugs; audits are not implied by this document
- Market risk — land floors can rise faster than you can exit if you are not outbid
- Liquidity risk — buybacks depend on a live CLDR/ETH market and router
- Opportunity cost — ETH locked in a land earns only via mining / future outbid, not via guaranteed yield
- Chain risk — Robinhood Chain availability, fees, and finality apply