GRIDMAN NETWORKS
GRIDMAN WHITEPAPER v2.0
Released: 2026 · Network: Base Blockchain
01 Executive Summary
GridMan is a decentralized virtual mining ecosystem designed to make cryptocurrency participation accessible to everyone. Traditional mining networks require expensive hardware, significant energy consumption, and advanced technical expertise. GridMan eliminates these barriers by introducing a virtual mining model powered by community participation, network expansion, and decentralized growth.
GridMan transforms every participant into a valuable contributor within a global digital grid, where collective activity strengthens the ecosystem and creates long-term value.
Our mission is simple: Connect People. Mine Value. Grow Together.
02 Vision & Mission
Vision
To build the world's largest community-powered virtual mining grid, connecting millions of participants through a decentralized digital economy.
Mission
- Make mining accessible to everyone.
- Lower the barrier to Web3 participation.
- Reward contribution and community growth.
- Build a sustainable digital economy.
- Create a decentralized network powered by people.
03 Core Principles
Accessibility
Anyone can participate regardless of technical experience or financial resources.
Transparency
All token allocations and mining mechanisms are publicly verifiable.
Community
The Grid grows through people, not machines.
Sustainability
A fixed token supply ensures long-term predictability.
Decentralization
The network belongs to its participants.
04 The Problem
Despite rapid growth in blockchain adoption, participation remains limited by several barriers:
High Entry Costs
Traditional mining requires expensive equipment and infrastructure.
Technical Complexity
Most users are unfamiliar with blockchain technology.
Centralization
Mining power is concentrated among a small number of operators.
Limited Accessibility
Millions of people are excluded from participating in digital economies.
05 The Solution
GridMan introduces a simple and scalable virtual mining model. Instead of rewarding hardware ownership, GridMan rewards network participation and community expansion. The Grid grows stronger as more users contribute to the ecosystem.
06 What is GridMan?
GridMan is a decentralized virtual mining network built around the concept of a digital grid. Every participant becomes a contributor to the network. Every connection strengthens the ecosystem. Every contribution creates value.
Core Philosophy: Every Connection Creates Value.
07 Why GridMan?
GridMan combines the simplicity of virtual mining with the power of network effects. No expensive hardware. No technical barriers. No geographic limitations. Just participation, growth, and community.
Every participant strengthens the Grid, and every connection creates value.
08 Adaptive Virtual Mining Mechanism
GridMan utilizes a scalable community-powered virtual mining system designed for long-term sustainability and decentralized participation. Mining rates dynamically adjust based on total global network adoption.
Mining Activation
Users can begin mining by connecting their wallet and activating their mining account. Once activated, rewards accumulate automatically.
Global Users: Below 1,000
Base: 2.0 GMAN/min
Referral: +2.0 GMAN/min / active ref
Global Users: 1,000 – 10,000
Base: 1.0 GMAN/min
Referral: +1.0 GMAN/min / active ref
Global Users: 10,000 – 50,000
Base: 0.5 GMAN/min
Referral: +0.5 GMAN/min / active ref
Global Users: Above 50,000
Base: 0.25 GMAN/min
Referral: +0.25 GMAN/min / active ref
The total mining rate is calculated using the following multiplicative formula that stacks all active boost sources:
- R — Total Effective Mining Rate (GMAN/min)
- B — Base Mining Rate per network tier (2.0 / 1.0 / 0.5 / 0.25 GMAN/min)
- I — Invite multiplier = min(inviteCount, 100). Each active referral adds 1× base rate.
- L — Activity League bonus % (Silver +10%, Gold +20%, Platinum +30%, Legend +40%)
- S — Speed Boost % (Mystery Box or on-chain admin). Max total boost capped at +200%.
- K — Staking Boost % (10K GMAN = +2%, 50K = +5%, 100K = +8%, 500K = +10%)
📈 Example: Tier 1, 5 invites, Gold League (+20%), 30% Speed Boost, 5% Staking Boost
R = 2.0 × (1 + 5) × (1 + 0.20) × (1 + 0.30) × (1 + 0.05) = 2.0 × 6 × 1.2 × 1.3 × 1.05 = 19.66 GMAN/min
Three independent boost sources stack multiplicatively:
Total combined boost is capped at +200%. The "BOOST ACTIVE" badge appears in the Dashboard when any boost source is active.
🤖 Captcha Verification
To start or claim mining rewards, participants must complete a simple image-based captcha challenge. This prevents automated bots from abusing the mining system and ensures fair distribution for human participants.
- Captcha appears as a modal overlay before mining activation and claim transactions.
- User must select the correct image from a set of options to proceed.
- Failed attempts require a new challenge.
- Once passed, the mining action or claim executes on-chain.
Sustainability & Fair Distribution
- Mining emissions decrease automatically as network participation grows.
- Maximum referral rewards per account may be capped.
- Inactive accounts do not generate referral mining bonuses.
- Anti-bot verification systems protect the integrity of the Grid.
- Mining rewards are distributed exclusively from the fixed mining allocation pool.
- No additional GMAN tokens will ever be minted beyond the maximum supply.
09 Grid Points (GP)
Grid Points (GP) is an on-chain reputation point system that records each participant's contribution within the GridMan ecosystem. Total GP determines a miner's Grid Level and unlocks mining speed multipliers through the Activity League.
Each account's Total GP is calculated from four components in real-time:
- On-Chain GP — GP accumulated from the smart contract (governance votes, etc.).
- Staked GMAN — Every 1 GMAN locked = 1 GP. Ratio 1:1. Active while staked.
- GP Lock Bonus — Passive GP accrued daily per GMAN staked: Starter 0.1 · Staker 0.12 · Vault 0.15 · Diamond 0.2 GP/GMAN/day. Claimable manually from the Vault.
- Bonus GP — GP from off-chain activities: Daily Check-In, Mission Hub, referrals, etc. Stored in Firebase.
Every 1 GMAN locked = 1 GP instantly. GP active while GMAN is staked.
Passive GP accrues daily per GMAN staked: Starter 0.1 · Staker 0.12 · Vault 0.15 · Diamond 0.2 GP/GMAN/day. Claimed manually from the Vault.
10 Grid Level 1–7
Grid Level is a miner's progression tier within the GridMan ecosystem, calculated automatically based on total accumulated GP. The higher the Grid Level, the greater the mining speed bonus received through the Activity League.
| Grid Level | GP Required | Activity League | Mining Bonus |
|---|---|---|---|
| Grid 1 | 0 – 999 GP | 🥉 Bronze | — |
| Grid 2 | 1,000 – 9,999 GP | 🥈 Silver | +10% |
| Grid 3 | 10,000 – 49,999 GP | 🥇 Gold | +20% |
| Grid 4 | 50,000 – 99,999 GP | 🥇 Gold | +20% |
| Grid 5 | 100,000 – 499,999 GP | 💎 Platinum | +30% |
| Grid 6 | 500,000 – 999,999 GP | 💎 Platinum | +30% |
| Grid 7 | 1,000,000+ GP | 🏆 Legend | +40% |
Grid Level is calculated in real-time. Whenever GP increases (staking, check-in, mission), the level can rise immediately without any manual action.
11 Activity League
Activity League is a tier system based on Grid Level that grants a permanent multiplier on each node's mining speed. The higher the league, the greater the bonus received on top of the base mining rate.
Bronze League
Grid 1 · 0 – 999 GP
No bonus. Mining speed follows the network tier base rate.
Silver League
Grid 2 · 1,000+ GP
Mining speed increases by 10% from the current total rate.
Gold League
Grid 3–4 · 10,000+ GP
Mining speed increases by 20% from the current total rate.
Platinum League
Grid 5–6 · 100,000+ GP
Mining speed increases by 30% from the current total rate.
Legend League
Grid 7 · 1,000,000+ GP
Highest mining speed. Unlocks the Grid Legend Badge 🔱 and exclusive access to governance features.
⚗️ Mining Formula with League Multiplier
R_final — Effective mining speed after league bonus. League% — Activity League bonus percentage (0%, 10%, 20%, 30%, or 40%).
12 What is $GMAN?
$GMAN is the native utility token of the GridMan ecosystem.
13 Staking Vault
Advanced Staking Vault is an on-chain locking system in the Miner Profile Hub that allows participants to lock GMAN tokens in the GmanEcosystemRewards smart contract. Staking generates three simultaneous benefits: instant GP (1:1), a passive GP lock bonus per day, and an annual GMAN APY reward claimable on-chain.
Every 1 GMAN staked = 1 GP credited immediately. Active as long as GMAN is locked.
Passive GP accrues daily per GMAN staked: Starter 0.1 · Staker 0.12 · Vault 0.15 · Diamond 0.2 GP/GMAN/day.
Annual GMAN reward calculated on-chain per tier. Claimable manually at any time (min. 1,000 GMAN staked).
| Tier | Lock Duration | GP / day | APY | Mystery Keys |
|---|---|---|---|---|
| 🌱 Starter | 7 days | 0.10 / GMAN | 10% | +1 instant |
| ⚡ Staker | 14 days | 0.12 / GMAN | 12% | +1 instant · 1/day |
| 🏛️ Vault | 30 days | 0.15 / GMAN | 15% | +2 instant · 3/day |
| 💎 Diamond | 60 days | 0.20 / GMAN | 20% | +3 instant · 5/day |
🔒 How Lock Stake Works
- Select a lock duration (7d · 14d · 30d · 60d) corresponding to your desired tier. Minimum stake: 1,000 GMAN (required for APY claim).
- Enter the GMAN amount in the Staking Vault input field.
- One-time ERC-20 approval (MaxUint256) — no re-approval needed.
- GMAN is sent to the smart contract; wallet balance decreases accordingly.
- Every 1 GMAN staked = 1 GP instantly.
- Lock timer starts immediately. Timer resets to the new tier duration only if the tier upgrades; same-tier top-ups preserve the existing lock. You cannot select a shorter lock than the active one.
- GP Lock Bonus accrues daily and can be claimed manually at any time.
- GMAN APY accumulates on-chain and is claimable via the Claim GMAN APY button.
🔓 Unstake — 3-Step Process
⏸️ Cooldown Freeze — What Gets Paused
When an unstake request is active (72-hour cooldown), two reward streams are paused to prevent abuse:
Clicking "Cancel Request" aborts the unstake and immediately restores both reward streams.
⚙️ Owner-Configurable Parameters
The contract owner can update the following parameters at any time without affecting locks already in progress:
In addition to GP rewards, staking GMAN permanently boosts your active mining speed while tokens remain locked. The boost is applied automatically on-chain via getStakingBoost() and stacks with Activity League and Mystery Box speed boosts.
| Min. Staked | Mining Speed Boost | Status |
|---|---|---|
| 10,000 GMAN | +2% | ✓ Active |
| 50,000 GMAN | +5% | ✓ Active |
| 100,000 GMAN | +8% | ✓ Active |
| 500,000 GMAN | +10% | ✓ Active |
Staking Vault is the fastest way to raise your Grid Level, earn passive GP daily, and accumulate GMAN APY on-chain — simultaneously.
🔄 Auto-Compound Mode
Participants can enable Auto-Compound from the Staking Vault section in the Profile Hub. When enabled, all GMAN APY rewards are automatically re-staked instead of being sent to your wallet. This means your principal grows continuously, generating exponential returns over time.
- Toggle on/off anytime via the Auto-Compound switch in the Staking Vault
- Each APY claim cycle re-stakes the rewards, increasing totalStaked
- Auto-Compound status is stored on-chain in the ecosystem contract
- Disable at any time — future claims will send tokens to your wallet normally
- Recommended for long-term holders who want to maximize yield
14 Tokenomics Structure
| Allocation | Percentage | Vesting |
|---|---|---|
| ⛏️ Mining Rewards | 50% (500,000,000) | Emitted through adaptive mining |
| 💧 Liquidity Pool (DEX) | 15% (150,000,000) | Locked liquidity |
| 🌱 Ecosystem & Staking | 15% (150,000,000) | Released based on ecosystem growth |
| 🎯 Airdrop & Community | 10% (100,000,000) | Vested over community campaigns |
| 👥 Team | 5% (50,000,000) | 12 months cliff + 24 months vesting |
| 🏦 Treasury & Reserve | 4% (40,000,000) | Locked, governance-controlled |
| 🧠 Advisors | 1% (10,000,000) | 6 months cliff + 18 months vesting |
15 Buyback & Burn Mechanism
To strengthen long-term sustainability and reduce circulating supply pressure, GridMan implements a buyback and burn mechanism.
💸 Sources of Funding
- Launchpad fees
- Ecosystem service fees
- Partnership revenue
- Marketplace commissions
- Future protocol revenue
⚙️ Mechanism
- Protocol revenue allocated to buy GMAN from open market.
- Purchased tokens sent to a burn address.
- Burned tokens permanently removed from circulation.
Circulating supply decreases over time.
Creates sustainable deflationary pressure.
Ecosystem growth directly benefits token holders.
16 Utility Expansion
🚀 Launchpad Access
GMAN holders gain priority access to future project launches within the GridMan ecosystem.
- Guaranteed allocations
- Whitelist access
- Early-stage investment opportunities
- Tier-based participation system
🗳️ DAO Governance
GMAN holders will participate in decentralized governance. Voting areas include:
- Treasury allocation
- Ecosystem grants
- Strategic partnerships
- Protocol upgrades
- Community proposals
GRIDMAN is no longer just a referral mining token — it is a community mining + staking + governance + launchpad ecosystem.
17 Sustainability Model
🔋 Participation
Users earn rewards through active mining.
📈 Expansion
Every new participant strengthens the Grid.
💎 Scarcity
Mining rewards are limited to a fixed allocation pool. No additional supply will ever be created.
18 Daily Check-In
Daily Check-In is a daily mission available in the Miner Profile Hub. Each participant can check in once per day to earn GP and keep their Win Streak active. Consistent daily activity unlocks significant bonus milestones.
📆 Check-In Rules
- Check-in can only be performed once per day.
- If a day is missed, Win Streak resets to Day 1.
- Daily check-in grants +5 GP per day.
- Streak is stored in Firebase and synchronized in real-time.
- A 30-day visual calendar is shown in a popup modal to track progress.
🏆 Milestone Bonus
🔁 Streak Recovery
If you miss a daily check-in, your streak does not instantly reset. You have 1 hour from the time your streak breaks to recover it by spending 1 Mystery Key.
- Streak recovery button appears automatically when a broken streak is detected
- Spending 1 key restores the streak to its previous count
- Recovery window: 60 minutes after the missed check-in time
- After the window expires, the streak resets to Day 1
- Available only if you have at least 1 Mystery Key in your balance
💡 Total GP from a Perfect 30-Day Streak
19 Mission Hub
Mission Hub is the mission center in the Miner Profile Hub, providing 10 missions to earn bonus Grid Points (GP). Two types of missions are available: Daily (repeats every day, configurable via Firebase without redeploy) and Once (one-time per account lifetime). Daily missions can be refreshed by the team at any time — mission definitions are loaded from Firebase on page load.
Check in every day to maintain your Win Streak. Opens a 30-day calendar popup with bonus milestones.
Follow the official GRIDMAN account on Twitter/X.
Like and Retweet the pinned post of @gridman_xyz.
Create a tweet about GRIDMAN, then submit the tweet link for verification. The highest reward among social missions.
Join the official Telegram group @gridman_xyz.
Join the official GRIDMAN community Discord server.
Subscribe to the GRIDMAN educational YouTube channel @gridman_xyz.
Invite 1 friend to join using your referral link.
Stake GMAN for the first time in the Staking Vault. Auto-completes after the stake transaction succeeds.
Participate in on-chain governance voting. Auto-completes after the vote is successfully submitted.
📊 Maximum Total GP from Mission Hub
20 Airdrop Quest Hub
The Airdrop Quest Hub is a community engagement system located on the main Dashboard. Participants complete social and on-chain tasks to earn early contributor GMAN allocations and unlock exclusive community roles such as Gridman OG Status.
Quest Progression
Complete all quests to unlock Gridman OG Status and maximum airdrop allocation.
| Quest | Type | Reward |
|---|---|---|
|
🐦Follow X (Twitter)
Follow @gridman_xyz official account |
Social | +150 GMAN |
|
🔁Retweet & Tag 3 Friends
Retweet our pinned post on X |
Social | +200 GMAN |
|
👾Join Discord Server
Get your early Node Miner role |
Social | +250 GMAN |
|
🎨Create Gridman Meme
Post a meme on X and tag us |
Social | +500 GMAN |
|
👥Invite 2 Active Friends
Get 2 active node referrals |
On-Chain | +1,000 GMAN |
|
👑Invite 3 Active Friends
Unlock your OG Status |
On-Chain | +2,000 GMAN & OG |
Social quests are verified automatically after a short delay. On-chain quests read directly from the smart contract referral count.
21 Mystery Box System
Mystery Box is a gamified reward system accessible from the Miner Profile Hub. Participants can open boxes to win random prizes ranging from Grid Points and GMAN tokens to Mining Speed Boosts and USDT. Every box open carries a chance at a legendary USDT grand prize of up to $100.
🗝️ Open with Key (Free)
Mystery Keys are earned through various in-app activities and grant one free box open each. Using a key costs nothing beyond the key itself — no ETH required.
- One key consumed per box open
- Keys are non-transferable and wallet-bound
- Key balance is displayed on the Profile Hub
💎 Pay 0.0001 ETH
If no keys are available, participants can pay 0.0001 ETH directly via their wallet to open a box. The ETH fee is routed to the protocol treasury for ecosystem sustainability.
- Available anytime regardless of key balance
- Same reward pool as key-based opens
- Transaction signed via MetaMask / Web3 wallet
💎 Buy Keys with ETH
Mystery Keys can be purchased directly using ETH at discounted bulk rates. Keys are automatically credited to your wallet after payment.
| Package | Price (ETH) | Cost per Key | Discount |
|---|---|---|---|
| 5 Keys | 0.0004 | 0.00008 | 20% |
| 10 Keys | 0.0007 | 0.00007 | 30% |
| 20 Keys | 0.0012 | 0.00006 | 40% |
| 40 Keys | 0.002 | 0.00005 | 50% |
ETH is sent to the mining contract and verifiable on-chain. Keys are credited instantly via the API.
| Reward | Rarity | Amount | Probability |
|---|---|---|---|
| 💵 USDT | Legendary | $1 – $100 | 0.1% |
| 🪙 GMAN Tokens | Rare | 100 – 5,000 GMAN | 30% |
| ⚡ Mining Speed Boost | Epic | +10% – +50% / 24h | 15% |
| ⭐ Grid Points (GP) | Common | 50 – 5,000 GP | 40% |
| 🥹 Empty | Empty | No reward | ~14.9% |
Won GMAN is held in escrow and requires a separate on-chain claim via the Profile Hub.
Speed boost is activated immediately and lasts 24 hours, increasing mining output for that period.
USDT winners receive a signed claim signature from the backend to process the on-chain withdrawal.
Mystery Box is accessible at any time from the floating button on the Dashboard or directly from the Miner Profile Hub.
22 Badge Inventory
Badge Inventory is a collection of 8 achievement badges that miners can unlock based on specific activities and milestones. Badges cannot be purchased — they can only be earned through genuine contribution to the GridMan ecosystem.
| Badge | Name | Rarity | Unlock Condition |
|---|---|---|---|
| 🛡️ | Node Badge | Common | Connect your wallet to the GridMan ecosystem. |
| ⛏️ | Miner Badge | Uncommon | Claim a mining reward at least once. |
| ⭐ | Star Badge | Rare | Successfully invite 10 active friends. |
| 🚀 | Grid Pioneer | Epic | Reach Grid Level 5. |
| 💎 | Staker Badge | Epic | Stake a minimum of 1,000 GMAN in the Staking Vault. |
| 🗳️ | DAO Member | Legendary | Submit minimum 1 governance vote on-chain. |
| 🔱 | Grid Legend | Mythic | Reach Grid Level 7 (Legend League). |
| 👑 | Grid Master | Genesis | Unlock all 7 previous badges. |
Locked badges appear in grayscale and are inactive. Badges unlock automatically when their conditions are met.
24 Leaderboard
The Leaderboard section on the main Dashboard provides a real-time ranking of the top nodes in the GridMan network. Four tabs are available: Top Earners, Top Referrals, Top GP, and Top Staked.
💰 Top Earners
Ranks participants by the total amount of GMAN rewards claimed from the mining contract. Reflects cumulative mining output over the lifetime of each account.
- Sourced from on-chain claim history
- Displayed in GMAN with 2-decimal precision
- Identifies the most active long-term contributors
👥 Top Referrals
Ranks participants by the number of successfully activated referrals. Each referral counts only if the referred user has activated their mining node on-chain.
- Read directly from the smart contract
- Updates in real-time as new nodes activate
- Drives motivation for community growth
⭐ Top GP
Ranks participants by total Grid Points earned — the sum of on-chain GP, off-chain bonus GP, and staking GP accrual. The highest reflection of overall network contribution.
- Combines on-chain + Firebase data sources
- Staking GP bonus included in total calculation
- Best indicator of comprehensive participation
🔒 Top Staked
Ranks participants by the amount of GMAN staked in the Staking Vault. Reflects capital commitment and long-term belief in the GridMan ecosystem.
- Read from on-chain staking contract
- Includes all lock durations (Starter to Diamond)
- Highlights the most committed community members
Both leaderboard tabs are populated from a live batch read of all registered wallet addresses using a Multicall contract. Data refreshes automatically on each page load without additional user interaction.
25 Live Activity Feed
The Live Activity Feed is a floating notification panel displayed in the bottom-right corner of the Dashboard. It simulates a real-time stream of recent network activity, providing social proof of the ecosystem's vitality and encouraging new participants to take action.
Shows when miners activate their node or claim rewards.
Shows new invites and referral expansions across the grid.
Shows box opens and rewards claimed by the community.
- New feed items appear every few seconds and scroll into view automatically.
- Each card shows a truncated wallet address, action description, and a timestamp of "NOW".
- Feed items are colour-coded by event type (emerald for mining, indigo for referrals, purple for mystery box).
- The feed stack holds the most recent items visible without overflowing the screen.
26 On-Chain Governance Vote
The Governance Vote feature allows Grid 3+ participants to submit an on-chain vote once every 30 days. Voting rewards the participant with +800 GP and +1 Mystery Key per vote.
🗳️ Vote Requirements
- Minimum Grid Level 3 (10,000+ GP)
- Must wait 30 days between votes per account
- Votes are recorded on-chain via executeGovernanceVote()
- Countdown timer shows remaining time until next eligible vote
🎁 Vote Rewards
- +800 GP credited as Bonus GP in Firebase
- +1 Mystery Key added to your balance
- Activity Log entry recorded with vote count
- Auto-completes the "First Governance Vote" Mission Hub mission (+200 GP bonus)
Active voters maintain their Grid multipliers. Grid 3+ participants must vote every 30 days to keep their Activity League bonus active.
27 Admin Panel
The Admin Panel at gridman.xyz/admin.html provides the contract owner with tools to manage the ecosystem directly without external tools like Remix or Etherscan.
⚙️ Contract Management
- Mining Fee — Set the ETH fee for startMining transactions
- Claim Fee — Set the ETH fee for withdraw/claim transactions
- Speed Boost (single) — Apply a speed boost to any wallet with custom percentage and expiry
- Bulk Speed Boost — Apply speed boosts to multiple wallets at once via batch upload
- APY Tiers — Update Starter/Staker/Vault/Diamond APY basis points (0–10,000 bps)
- Lock Durations — Update lock duration per tier in seconds (max 365 days)
📊 Dashboard & Monitoring
- Distribution Cron — Manually trigger the daily GMAN distribution to eligible miners
- Cron Status — View total staked, total distributed, and available for distribution
- Owner Verification — Only the contract owner address can access admin functions
- Live Simulation — Preview speed boost results before sending the on-chain transaction
All admin actions require the connected wallet to be the contract owner. Transactions are signed via MetaMask.
28 Profile Settings & Tools
🌓 Theme Schedule
The interface automatically switches between Dark and Light mode based on the time of day: Light mode from 06:00 to 18:00, Dark mode from 18:00 to 06:00. Default is Dark mode at all times if no schedule has been set.
- Auto-rechecks every minute — switches automatically at 06:00 and 18:00
- Manual toggle overrides the schedule — your choice persists in localStorage
- System preference detection also works if no schedule or manual choice exists
📊 Activity Log Filtering
The Activity Log displays a chronological history of all user actions. A filter bar lets users narrow down entries by category.
- All — show all entries
- ⛏️ Mining — start mining, claim mining, mining reward events
- 🎁 Box — mystery box opens, GMAN/USDT claims
- 🔒 Staking — stake, unstake, APY, GP lock actions
- 📆 Check-in — daily check-in and streak activity
- 👥 Referral — referral and invite events
- 🗳️ Voting — governance vote entries
- 🎯 Mission — mission hub completions, tweet verifications
- 🗝️ Keys — mystery key earned or spent events
👛 Wallet Balance
The Profile Hub displays the connected wallet's GMAN token balance fetched directly from the ERC-20 contract.
- Reads balance via balanceOf(account) on the GMAN token contract
- Auto-updates on page load and after transactions
- Displayed in the Profile sidebar with GMAN label
📈 GP History Chart
A visual chart in the Profile Hub displays the user's Grid Points progression over time, rendered on an HTML canvas.
- Chart updates in real-time as GP changes are detected
- Range selector: 7D / 14D / 30D / 90D views
- Rendered via custom renderGpChart() canvas drawing
- Debounced re-render (400ms) on data updates
📥 Full Data Export (CSV)
From the Profile Hub, users can export their complete on-chain and off-chain data as a CSV file for personal record keeping, tax reporting, or analysis.
- Activity Log — all logged actions with timestamps
- Mining Summary — total claimed, unclaim, GP, invites, mining rate
- Staking Summary — staked amount, accruals, APY, auto-compound status
- Mystery Box — boxes opened, rewards won per category, current keys
- Wallet — address, GMAN balance, streak count, last check-in
29 Governance & Security
🗳️ Governance
GridMan plans to gradually transition toward community governance.
- Treasury Management
- Ecosystem Funding
- Partnership Approval
- Protocol Upgrades
- Community Voting
The long-term goal is to establish a decentralized ecosystem governed by its participants.
🔒 Security
- Open Smart Contracts
- Multi-Signature Treasury
- Independent Audits
- Transparent Operations
Users always maintain custody of their own assets.
30 Strategic Roadmap
🏗️ Phase 1 — Foundation
- ✓ Website Launch
- ✓ Smart Contract Deployment
- ✓ Virtual Mining Launch
- ✓ Community Building
- ✓ Referral System Activation
- ✓ First 10,000 Miners
- ✓ Staking Vault Launch
- ✓ Mystery Box System
- ✓ Mission Hub (10 missions)
- ✓ Leaderboard (4 tabs)
- ✓ Daily Check-In & Streaks
🚀 Phase 2 — Expansion
- IDO Launch
- DEX Listing
- Liquidity Expansion
- CoinGecko Listing
- CoinMarketCap Listing
- 100,000+ Members
⚙️ Phase 3 — Utility
- ✓ Buy Keys with ETH (bulk discounts)
- ✓ Auto-Compound Staking
- ✓ Daily Mission Refresh System
- ✓ Theme Schedule (Dark/Light auto-switch)
- ✓ Full CSV Data Export
- Mobile Application
- Governance Beta
- Strategic Partnerships
- Ecosystem Expansion
🌐 Phase 4 — Ecosystem
- Cross-Chain Integration
- Community Governance
- Ecosystem Grants
- Global Marketing
- 1 Million+ Users
🌟 Phase 5 — Global Grid
- Major Exchange Listings
- Enterprise Partnerships
- Decentralized Treasury
- Global Adoption
- GridMan Expansion
31 Conclusion
GridMan represents a new generation of community-powered virtual mining networks. Built on accessibility, transparency, and sustainable growth, GridMan empowers anyone to participate in Web3 and become part of a global decentralized ecosystem.
The future is not built by machines alone. The future is built by people.
32 Seasonal Events
Seasonal Events are time-limited activities that appear on the Dashboard during special occasions or community campaigns. Events are configured server-side and push rewards directly to eligible participants.
🎯 Event Types
- Claimable Events — Participants manually claim rewards via a button in the event card
- Auto-Drop Events — Rewards are pushed by the server based on eligibility criteria
- Keys — Mystery Keys awarded for event participation
- GP — Grid Points awarded as event bonuses
- GMAN — Token rewards distributed through the event
⏱️ Event Display
- Active events appear as cards with countdown timers in the Dashboard
- Each card shows event name, reward type, and remaining time
- Claimed events disappear from the active list
- Expired events auto-hide without user action
- Event data loaded from Firebase on page load
Events are created and managed server-side — no contract deployment needed for each campaign.
33 PWA Installation
GridMan can be installed as a Progressive Web Application (PWA) on mobile and desktop devices. This provides a native-app-like experience without requiring an app store download.
📲 Installation
- Mobile (Android) — Tap the install banner or browser menu → "Add to Home Screen"
- Desktop (Chrome/Edge) — Click the install icon in the address bar or menu → "Install GridMan"
- iOS (Safari) — Tap Share → "Add to Home Screen"
- Installed app runs full-screen with no browser chrome
⚙️ Technical Details
- Service worker handles offline caching for static assets
- manifest.json defines app name, icons, and theme color
- Custom install button available via pwa-install.js on the Profile page
- beforeinstallprompt captured for deferred prompt UX
- Meta tag: <meta name="mobile-web-app-capable" content="yes">
34 API Reference
The backend server at api.gridman.xyz provides REST API endpoints for core platform operations. All requests include CORS headers allowing the gridman.xyz origin.
| Method | Path | Description |
|---|---|---|
| GET | / | Server health check. Returns { "status": "ok", "uptime": ... } |
| GET | /health | Health endpoint with timestamp and block height |
| GET | /api/og | OG image for share cards. Query: addr, mining, claimed, power, refs, totalGp. Returns 480×800 PNG. |
| GET | /api/leaderboard | Top node data for the Dashboard leaderboard. Returns JSON array of top participants. |
| GET | /share-card | Share card page with OG tags. Query: addr. Returns rendered HTML + OG image. |
| POST | /roll-mystery-box | Open mystery box. Body: account, txHash, key (boolean). Returns reward object. |
| POST | /buy-keys | Purchase mystery keys with ETH. Body: account, package (key count), txHash. Rate limited. |
| GET | /admin/cron/status | Admin: check distribution cron status (returns totals and daily participation) |
| POST | /admin/cron/distribute | Admin: manually trigger daily distribution to eligible miners |