Docs
/
Getting Started
/
Overview
Overview
GRIDLOCK is a competitive mining protocol deployed on Base L2. A 5x5 grid. 25 squares. One winner every ~2 minutes. Deploy ETH, compete for the winning square, claim the pot.
What is GRIDLOCK?
GRIDLOCK is a permissionless, on-chain protocol where participants deploy ETH to squares on a 5x5 grid. Every ~60 blocks (~2 minutes), on-chain RNG selects one winning square out of 25. The winner takes the pot.
The protocol runs entirely on-chain with no off-chain dependencies. No oracles. No keepers. Just code, randomness, and competition.
[NOTE]
GRIDLOCK operates on Base L2 for fast, low-cost transactions. You need ETH on Base to participate.
Key Protocol Stats
| Parameter | Value |
| Grid size | 5x5 (25 squares) |
| Round duration | ~60 blocks (~120 seconds) |
| Winner selection | On-chain RNG |
| Protocol fee | 2% |
| Token | $GRID |
| Max supply | 21,000,000 GRID |
| Mint rate | 1.2 GRID / round |
How It Works (Quick Start)
Every round follows four phases:
- DEPLOY — Choose a square on the 5x5 grid. Commit ETH.
- RESOLVE — On-chain RNG selects 1 winning square out of 25.
- LOCK IN — Winners lock in their ETH + GRID token rewards.
- CLAIM — Withdraw ETH winnings and GRID tokens.
$ ./gridlock --init
[GRIDLOCK v1.0] Protocol initialized on Base L2
[STATUS] Round active — 60 blocks remaining
[GRID] 25 squares loaded. Awaiting deployments...
How the Grid Works
Every ~2 minutes, a new round begins. Four phases. One winner. No mercy.
Round Lifecycle
Each round is triggered by the first deployment. Once someone commits ETH to a square, the round clock starts. After ~60 blocks, the round resolves automatically.
Phase 1: DEPLOY
Players choose a square on the 5x5 grid and commit ETH. Multiple players can deploy to the same square. The first deployment starts the round clock. You have ~60 blocks to position yourself.
> deploy --square [3,2] --amount 0.1eth
DEPLOYED: 0.1 ETH to square [3,2]
ROUND_CLOCK: 58 blocks remaining
Phase 2: RESOLVE
Round ends. On-chain RNG selects 1 winning square out of 25. The grid does not care who you are. It picks a winner and moves on.
> resolve --round 4827
WINNING_SQUARE: [3,2] ✓
Phase 3: LOCK IN
Winners lock in ETH + GRID token rewards within 24 hours. Bots can run checkpoints for miners and earn a small fee for the service.
Phase 4: CLAIM
Withdraw ETH winnings directly. Withdraw GRID tokens with a 10% fee redistributed to the mining pool. The grid feeds itself.
> claim --eth --grid
WITHDRAWN: 0.47 ETH | 0.72 GRID (10% recycled)
Odds and Probability
Each round, every square has an equal 1-in-25 (4%) chance of being selected. The RNG is fully on-chain — no off-chain oracles, no manipulation vectors. Strategy comes from timing, position selection, and ETH commitment.
Deploying
Choose your square on the 5x5 grid. Commit ETH. The first deployment starts the round clock.
Choosing a Square
The grid contains 25 squares, addressed as [row, col] coordinates from [0,0] to [4,4]. You select one square per deployment and attach ETH.
Multiple players can deploy to the same square. If that square wins, the pot is split proportionally based on each player's ETH commitment to that square.
Deployment Amounts
There is no minimum or maximum deployment amount. Deploy as much or as little ETH as you want. Higher commitments to a winning square earn a proportionally larger share of the pot.
[NOTE]
Deploying to a square with fewer other participants means less competition for the pot share if that square wins. But every square has the same odds of being selected.
Round Timing
The first deployment to any square starts the round clock. From that moment, you have ~60 blocks (~2 minutes) before the round resolves. Late deployments are still valid — the window stays open until the block limit.
> deploy --square [1,4] --amount 0.25eth
DEPLOYED: 0.25 ETH to square [1,4]
TOTAL_ON_SQUARE: 0.85 ETH (3 miners)
YOUR_SHARE: 29.4%
Resolution
On-chain RNG selects 1 winning square out of 25. No oracles. No off-chain dependencies.
On-Chain RNG
Winner selection uses on-chain randomness derived from block data. The random value is computed at resolution time and mapped to one of the 25 grid squares. Every square has an equal 1-in-25 probability.
Resolution Trigger
Resolution happens automatically when the block count reaches ~60 blocks after the first deployment. Anyone can call the resolve function to trigger it. The protocol does not require a centralized keeper.
[NOTE]
If nobody lands on the winning square, all deployed ETH feeds the treasury. The grid takes everything.
Empty Square Wins
When the winning square has no deployments, the round's entire pot (minus protocol fee) rolls into the treasury. This creates organic accumulation — and makes the Motherlode jackpot grow larger over time.
Claiming Rewards
Winners lock in their rewards. ETH flows directly. GRID tokens carry a 10% recycling fee.
Lock-In Period
After resolution, winners have 24 hours to lock in their rewards. Bots can run checkpoints on behalf of miners and earn a small fee for the service. This creates a permissionless infrastructure layer.
ETH Rewards
Withdraw ETH winnings directly with no additional fee beyond the 2% protocol fee already deducted at the round level. Your share is proportional to your deployment on the winning square.
GRID Token Rewards
Withdraw GRID tokens with a 10% claim fee. This fee is redistributed to the mining pool — recycled back into future round rewards. The grid feeds itself.
> claim --eth --grid
ETH_CLAIMED: 0.47 ETH
GRID_CLAIMED: 0.72 GRID (0.08 GRID recycled)
STATUS: Rewards locked ✓
Fee Structure
2% protocol fee on all deployed ETH. The rest flows to winners and the burn engine.
Fee Breakdown
| Destination | Percentage | Purpose |
| Protocol treasury | 2% | Operations and development |
| Winners | 68% | Distributed to winning square deployers |
| Burn engine | 30% | Buy and burn $GRID tokens |
How Fees Flow
When ETH is deployed to the grid, the 2% protocol fee is deducted immediately. The remaining 98% enters the round pot. Upon resolution, the pot is distributed according to the table above.
[NOTE]
The 10% GRID claim fee is separate from the 2% protocol fee. It applies only when withdrawing GRID tokens and is recycled into the mining pool.
Burn Engine
Treasury ETH converts to WETH, swaps for GRID on Uniswap V3. 90% of purchased GRID is burned permanently. 10% distributed to stakers.
The Burn Process
The burn engine operates as a continuous deflationary mechanism:
- Treasury ETH is converted to WETH
- WETH is swapped for GRID on Uniswap V3
- 90% of acquired GRID is sent to the burn address (permanently removed from supply)
- 10% of acquired GRID is distributed to stakers as yield
ETH --> WETH --> GRID --> BURNED
--> STAKERS (10%)
Deflationary Impact
Every round that generates fees triggers the burn engine. As protocol activity increases, burn rate accelerates. With a fixed max supply of 21,000,000 GRID and continuous burning, the circulating supply decreases over time.
[NOTE]
The burn engine is fully automated. No manual intervention required. Burns execute as part of the protocol's settlement flow.
Staking
Stake GRID tokens. Earn passive yield from every burn cycle. Yield accrues automatically via a global reward factor. No harvesting needed.
How Staking Works
Staking is simple: deposit GRID tokens into the staking contract. Your yield accrues automatically based on a global reward factor that updates with every burn cycle. No claiming, no compounding, no harvesting.
Yield Source
Staking yield comes from the burn engine. When the engine swaps ETH for GRID, 10% of acquired tokens are distributed proportionally to all stakers. The more protocol activity, the higher the yield.
Auto-Compounding
Yield accrues automatically via a global reward factor. No need to manually harvest or restake. Your staked balance grows passively with every burn cycle.
[NOTE]
There is no lock-up period for staking. Deposit and withdraw at any time. Yield is calculated from the moment of deposit.
Motherlode
0.2 GRID accumulates in the jackpot pool every round. 1-in-625 chance to trigger. The pot grows until someone hits it.
How the Motherlode Works
Every round, 0.2 GRID is added to the Motherlode jackpot pool. The jackpot has a 1-in-625 chance of triggering per round. When triggered, the entire accumulated pot is distributed to that round's winners.
P(x) = 1/625
per round
Accumulation
Because the trigger probability is low, the jackpot accumulates over hundreds of rounds. At 0.2 GRID per round with ~720 rounds per day, the pot can grow significantly before someone hits it.
Distribution
When the Motherlode triggers, the entire jackpot is added to the round's reward pool. It is distributed the same way as regular rewards — proportional to deployment on the winning square.
[NOTE]
The Motherlode trigger is independent of the winning square selection. Both use on-chain RNG but are separate random events.
Reward Modes
50% of rounds: GRID split proportionally across winning miners. 50% of rounds: one miner takes it all. Random weighted selection.
Split Mode (50% of rounds)
In split mode, GRID rewards are distributed proportionally across all miners who deployed to the winning square. Your share is based on your ETH commitment relative to the total ETH on that square.
Winner-Take-All Mode (50% of rounds)
In winner-take-all mode, a single miner receives the entire GRID reward. The winner is selected via random weighted selection — miners who committed more ETH to the winning square have proportionally higher chances of being selected.
| Mode | Frequency | Distribution |
| Split | 50% of rounds | Proportional to deployment |
| Winner-Take-All | 50% of rounds | Single winner (weighted random) |
[NOTE]
The mode for each round is determined by on-chain RNG at resolution time. You cannot predict or choose the mode in advance.
Tokenomics
$GRID is the native token of the GRIDLOCK protocol. Fixed supply. Deflationary by design. Earned through competitive mining.
Supply
| Parameter | Value |
| Max supply | 21,000,000 GRID |
| Mint rate | 1.2 GRID / round |
| Emission | Mining rewards only |
Allocation
| Allocation | Percentage | Amount |
| Mining rewards | 95% | 19,950,000 GRID |
| Team reserve | 3% | 630,000 GRID |
| Initial liquidity | 2% | 420,000 GRID |
Deflationary Mechanics
$GRID supply decreases over time through the burn engine. Every round that generates fees triggers a buy-and-burn cycle via Uniswap V3. With 95% of tokens distributed through mining and continuous burning, effective circulating supply shrinks.
Initial Liquidity
420,000 GRID (2% of supply) is paired with 1 ETH on Uniswap V3 at launch. This provides the initial trading pair for the burn engine to operate and for miners to exit positions.
Smart Contracts
All GRIDLOCK contracts are deployed on Base L2. Fully on-chain. Permissionless. Immutable.
Contract Addresses
[PENDING]
Contract addresses will be published here upon mainnet deployment. All contracts will be verified on BaseScan.
| Contract | Address |
| GRIDLOCK Core | TBD |
| $GRID Token | TBD |
| Staking | TBD |
| Burn Engine | TBD |
| Uniswap V3 Pool | TBD |
Security
All contracts are deployed as immutable — no proxy patterns, no admin keys, no upgrade paths. Once deployed, the protocol runs autonomously. Code is law.
Verification
All source code will be verified on BaseScan and published in the project's public repository. Anyone can audit the logic, read the state, and verify the randomness mechanism.