DUCK MINER ECOSYSTEM

Welcome to the Duck Miner Technical Whitepaper (2026 Edition). This documentation outlines the mechanics, tokenomics, and the robust security architecture behind the simulator.

Platform Overview

Duck Miner is a Web Application distributed as a Telegram Mini App within the TON ecosystem. Players access the game directly through the Telegram client â€” no downloads, no installs.

Platform

Telegram Mini App (Web-based)
Accessible on mobile & desktop

Blockchain

TON Network integration
TON Connect wallet support

Architecture

Server-Side Authority model
Cloud-based serverless backend

Security

Zero-Trust client policy
Rate-limited & audit-logged

All game state, currency balances, item ownership, and economic transactions are validated and enforced exclusively on the server. The client operates in a read-only capacity for sensitive data, ensuring tamper-proof integrity and fair gameplay for all participants.

Figure 1: Mining Center HQ

Quick Start Guide

Starting your empire is simple, but scaling requires sharp tactical resource management.

1. Secure Authentication

Sign in securely. Your session is protected by App Check architecture.

2. Hardware Acquisition

Use GEMS to buy Boxes. You need a GPU + Battery working together to mine.

3. Strategic Deployment

Place chips, mix batteries, and deploy GPUs to maximize the Hash Rate per second.

4. Climb the HQ Floors

Ascend from Starter HQ up to Nexus HQ, unlocking drastic synergic multipliers.

Mining Hierarchy & Architecture

The Duck Miner ecosystem is built on a structured hierarchy of components. Understanding this flow is key to maximizing your revenue velocity.

1. Components

GPUs, Batteries & Chips

2. Rigs

Assembled hardware units

3. Floors

Mining HQ levels

4. Leagues

Competitive ranking

Ecosystem Flow

Components power your Rigs, which are deployed across 9 HQ Floors. As your total Hash Rate grows, you ascend through the Leagues to unlock global treasury rewards.

Mission System

Missions are the core XP and progression driver. Complete daily, weekly, and monthly objectives to earn XP and Gems. Higher streaks multiply your rewards.

Daily Missions (Reset every 24h)

Mission	Requirement	XP	Gems
Check-In	Open the game and check in	50	—
Active Miner	Keep a rig running for 4 hours	100	—
Share	Share the game on social media	75	—
Invite	1 person joined via your referral link	150	—
Spin the Wheel	Use the Ducky Wheel (free or paid)	75	—
Enhance	Perform 1 Enhancement on any item	150	—

Daily missions provide XP only. Completing all 6 daily missions yields 600 base XP (before streak multiplier).

Weekly Missions (Reset every 7 days)

Mission	Requirement	XP	Gems
Dedication	Complete daily missions on 5 out of 7 days	1,500	10
Collector	Open 5 boxes of any type	1,200	5
Investor	Purchase any Gems package (real purchase)	2,000	15
Marathon	Complete 5 Lucky Wheel spins (free or paid)	1,000	5
Ambassador	5 people joined via your referral link this week	1,500	10

Weekly completion yields 7,200 XP + 45 Gems.

Monthly Missions (Reset every 30 days)

Mission	Requirement	XP	Gems
Ascension	Climb to a higher League this month	5,000	50
Magnate	Spend 10,000 DUCK on any in-game transaction	3,000	25
Veteran	Maintain a login streak of 30 consecutive days	2,500	20
Operational	Enhance or evolve 50 items	4,000	30
VIP	Have an active Season Pass (Premium)	3,000	40

Monthly completion yields 17,500 XP + 165 Gems.

Streak Multiplier

Maintaining a daily streak increases your XP rewards. The longer you play consecutively, the higher your multiplier grows â€” up to 2x at 30 days.

Item Database (Visual Gallery)

Explore the full technological stack of 2026. Hover or click on items to see them in action.

Genesis GPUs (Hash Engines)

Common

Genesis 1

10 H/s â€¢ 10W Cons.

Rare

Genesis 2

25 H/s â€¢ 25W Cons.

Epic

Genesis 3

60 H/s â€¢ 50W Cons.

Legendary

Genesis 4

150 H/s â€¢ 100W Cons.

Mystic

Genesis 5

333 H/s â€¢ 150W Cons.

AI Chips (Logic Boosters)

AI Genesis 1

+0.5% Hash Boost

AI Genesis 2

+1.0% Hash Boost

AI Genesis 3

+2.0% Hash Boost

AI Genesis 4

+3.0% Hash Boost

AI Genesis 5

+5.0% Hash Boost

Power Batteries (Uptime)

AAA Batteries

8h Duration

Lead-Acid

16h Duration

Li-Ion Pack

24h Duration

Titanate

36h Duration

Nuclear Cell

48h Duration

ℹ

Production Version

You are viewing the documentation for Version 2.0 (Post-Security Audit). The application strictly operates on server-side validations using Firebase Functions.

Inventory Tiers

Legacy items are gone. We've optimized the inventory into a clean curve across 5 rarity tiers.

⬜ Common 🔵 Rare 🟢 Epic 🟡 Legendary 💎 Mystic

🖥 GPU: Provides raw Hash Rate for DUCK generation.
🔋 Battery: Defines the Rig's Uptime. Mining is Always-On as long as a charge exists. When depleted, mining stops immediately.
🧠 AI Chip: Passive multipliers. Boosts Hash Rate or improves system efficiency.

The Recycler (Dismantling)

The Recycler is the backbone of the evolution economy. To upgrade your hardware, you must dismantle secondary items to obtain Scraps.

Dismantling Yields

Hashboards

Obtained by dismantling GPUs. Used to level up Genesis units.
AI Circuits

Obtained by dismantling Chips. Used for Chip level upgrades.
Power Cells

Obtained by dismantling Batteries. Increases Battery hash bonus via evolution.

Scrap EXP Yields

Scrap Rarity	EXP Granted
âšª Common Scrap	10 EXP
ðŸ”µ Rare Scrap	35 EXP
ðŸŸ£ Epic Scrap	150 EXP
ðŸŸ¡ Legendary Scrap	500 EXP
ðŸ’Ž Mystic Scrap	1,500 EXP

Dismantling has a 20% sink rate (dust yield), ensuring components remain rare and valuable.

Enhancement & Leveling System

Equipment Evolution Flow: Dismantle → Feed EXP → Evolve

The Equipment Evolution Pipeline: Dismantle spare items into Scraps → Feed Scraps to gain EXP → Pay $DUCK to Evolve

Hardware can be leveled up from Level 0 to Level 5 using the physical scrap components retrieved from the Recycler. Each level-up grants massive multipliers to both Hash Rate and efficiency.

âš™ï¸

Leveling Mechanics (EXP)

Inject Scraps (Hashboards, AI Circuits, or Power Cells) into an item to gain EXP. Once the EXP bar is full, pay a small $DUCK fee to finalize the Evolution to the next level.

Level	GPU Hash Multi	Battery Bonus	Chip % Multi
Level 1	1.25x	+3 H/s, +2%	1.15x
Level 2	1.75x	+8 H/s, +4%	1.35x
Level 3	2.50x	+15 H/s, +7%	1.60x
Level 4	4.00x	+30 H/s, +12%	2.00x
Level 5	6.50x	+50 H/s, +18%	2.50x

Evolution $DUCK Cost

Each level-up requires a $DUCK payment. The base cost scales by level and is multiplied by the item's rarity tier.

Level-up	Base Cost (Common)
0 → 1	50 DUCK
1 → 2	150 DUCK
2 → 3	200 DUCK
3 → 4	250 DUCK
4 → 5	350 DUCK

Rarity	Cost Multiplier
Common	×1
Rare	×5
Epic	×15
Legendary	×30
Mystic	×50

Example: evolving a Rare item from Level 2 to Level 3 costs 200 × 5 = 1,000 DUCK.

Acquisition & Boxes

New hardware is acquired through specialized Boxes. Each box has a deterministic drop rate validated on our secure backend.

GPU BOX

Foundational hardware engine

Cost: 600 GEMS

Common GPU 45%
Rare GPU 35%
Epic GPU 15%
Legendary GPU 4.5%
Mystic GPU 0.5%

CHARGE BOX

Energy units & capacity

Cost: 400 GEMS

Common Battery 45%
Rare Battery 35%
Epic Battery 15%
Legendary Battery 4.5%
Mystic Battery 0.5%

AI BOX

Calculative hash boosters

Cost: 400 GEMS

Common Chip 50%
Rare Chip 38%
Epic Chip 10%
Legendary Chip 1.8%
Mystic Chip 0.2%

MYSTERY BOX

Contains a random equipment box

Cost: 250 GEMS

GPU Box 33%
Charge Box 33%
AI Box 34%

Fortune Wheel

Spin the Ducky Wheel daily for random rewards. All results are determined by server-side RNG â€” no client manipulation possible.

Possible Rewards

The wheel contains a variety of assets essential for your progress. Each spin gives you a chance at high-value items.

ðŸ’Ž $GEMS

ðŸª™ $DUCK

ðŸ“¦ GPU Box

ðŸ”‹ Charge Box

ðŸ¤– AI Box

ðŸ‘‘ Founder Box

Daily Luck

Players get a free spin every 8 hours. This is your primary way to earn premium currency without investment.

Paid Spins

Looking for a specific component? Paid spins cost 50 GEMS and offer a weighted chance at high-end equipment boxes.

Floor Bonuses & Slot Configuration

Each HQ floor grants a unique passive bonus. Higher floors also unlock more GPU and Chip slots for your rig.

Slot Configuration per Floor

Floor	Name	GPU Slots	Chip Slots	Battery	Unlock Cost
1	Starter Lab	2	1	1	Free
2	Neon Server Room	3	1	1	500 Gems
3	Industrial Core	4	2	1	1,000 Gems
4	Cryo Chamber	5	2	1	2,500 Gems
5	Quantum Lab	5	2	1	5,000 Gems
6	Deep Mine Forge	6	3	1	10,000 Gems
7	Orbital Station	7	3	1	25,000 Gems
8	Void Matrix	8	3	1	50,000 Gems
9	Nexus Core	9	4	1	100,000 Gems

Passive Bonuses

Floor	Passive Bonus
1	+10% XP Earnings
2	+5% Battery Duration
3	+3% Hashrate (Common/Rare GPUs)
4	-5% Energy Consumption
5	+2% Enhancement Success
6	+2% Global Hashrate
7	+5% Mission XP
8	+3% Enhancement Success
9	+5% Global Hashrate

Floor Ã— Equipment Synergies

Floor	Condition	Synergy Bonus
2	Rare Battery equipped	+20% Battery Duration
3	Common/Rare GPUs equipped	+5% Hashrate
4	Epic+ Battery equipped	+180s flat duration
5	Legendary/Mystic Chip equipped	+3% Hashrate
6	Items at Lv.3+	+2% Hashrate per level
8	Any equipment	+5% Enhancement Success

League Bonuses

Participating in competitive leagues grants monthly rewards and hash multipliers.

Novice

+0% Hash Rate, No GEMS

Bronze

+1% Productivity Bonus

Silver

+3% Productivity Bonus

Gold

+5% Productivity Bonus

Platinum

+9% Productivity Bonus

Diamond

+15% Productivity Bonus

Ranking Multipliers

Productivity bonuses are multiplicative and apply to your total calculated Hash Rate, increasing your share of the daily DUCK emission pool.

League Requirements

Both Hash Rate and XP requirements must be met to advance.

League	Min Hash Rate	Min XP	Reward Share
Novice	0 H/s	0 XP	-
Bronze	100 H/s	1,000 XP	Low Share
Silver	1,000 H/s	5,000 XP	Med Share
Gold	5,000 H/s	20,000 XP	High Share
Platinum	20,000 H/s	50,000 XP	Elite Share
Diamond	100,000 H/s	150,000 XP	Master Share

Founder Pass (Season Pass)

Each season runs for 30 days. Premium holders unlock daily boxes and gem drops across a structured reward calendar.

Premium Rewards

ðŸ“¦ 6Ã— Founder Boxes â€” Days 1, 7, 14, 21, 28, 30
ðŸ“¦ 18Ã— Equipment Boxes â€” GPU, Battery, AI Chip
ðŸ’Ž 600 Gems total â€” Days 5, 10, 15, 20, 25

Cost: 3,750 Gems (~$75 value) â€” Estimated total reward value: $300+

ðŸ“… How it Works

1 reward slot unlocks every 24 hours
Unclaimed rewards stack â€” claim all at once
Season resets after 30 days with a new reward pool
All claims are validated server-side to prevent manipulation

Auction System

The Auction House allows players to list and bid on rare items using $DUCK. Three auctions are scheduled daily (resetting at 00:00 and 12:00 UTC), with the highest bidder winning each item at the end of the auction window.

List

Set a minimum starting bid and duration

Bid

Outbid competitors â€” $DUCK is escrowed until resolution

Win

Highest bid wins â€” item transferred atomically

Escrow Protection

All bids are held in escrow via atomic transactions. Outbid players have their funds returned instantly. No risk of lost assets.

Anti-Snipe Any bid placed in the last 5 minutes automatically extends the auction by 10 minutes, preventing last-second sniping.

Minimum Increment Each new bid must be at least 5% higher than the current highest bid to be accepted.

Daily Schedule 3 auctions per day. New slots open at 00:00 UTC and 12:00 UTC.

Ranking & Leaderboard

Compete globally for the top positions. Rankings factor in Hash Rate, XP, and League tier. Top players each season receive exclusive rewards.

Real-time leaderboard updated every block cycle (10 minutes)
Seasonal rankings with rewards at the end of each 30-day season
League-based segregation â€” compete within your tier for fairness

Flash Sales

Limited-time promotions with discounted Gem packages and exclusive bundles. Flash Sales appear periodically and run for a short window â€” usually 24 to 72 hours.

âš¡ How it Works

Timer-based countdown â€” expires when the clock hits zero
Discounts range from 20% to 50% off standard prices
Some bundles include exclusive items not available in the shop
All purchases are server-validated and rate-limited

ðŸ”” Stay Alert

Flash Sales are announced via in-game notifications. Active players who maintain a daily streak will receive early access alerts before the general population.

Referral (MLM) Program

Build your network and earn passive income on every Gem purchase within your downline. Our transparent 3-tier structure rewards community growth.

Tier 1 (Direct): 7% Commission on purchases from friends you directly invited.
Tier 2: 3% Commission on purchases from users invited by your Tier 1.
Tier 3: 2% Commission on purchases from users invited by your Tier 2.

ðŸ›¡ï¸

Network Transparency

Administrators have full visibility into referral hierarchies to ensure fair play. Commissions are credited instantly in TON-equivalent value.

The Tri-Economy

To ensure long-term sustainability, Duck Miner employs a Tri-Economy Segregation Structure. This design safely isolates external fiat injections from yield outputs, preventing runaway inflation and maintaining a balanced ecosystem driven by three distinct assets.

$DUCK Utility

The principal on-chain value carrier. DUCK follows a strict, mathematically predictable Fixed Emission schedule inspired by Bitcoin, ensuring absolute long-term digital scarcity. In-game store revenue acts as a deflationary engine via automated buybacks.

Contract Address (TON): EQB1MwY2KewTJBAczfrT3LhVS69ua4B8tFyYp3oy4xy8RHyd

Supply: 100,000,000 DUCK Contract Revoked (Minting Disabled)

Mining Mechanics: Distributed proportionally every 10-minute block based on your active Hash Rate vs the total Network Hash Rate.

Genesis Block: Mining emission started on April 28, 2026 (GENESIS_TIMESTAMP). No DUCK was pre-mined — all supply enters through active player mining.

Halving System (Time-Based): Emission starts at exactly 50 DUCK per block. Every 4 months, the block reward is cut by 25% (1/4), indefinitely extending the mining lifespan.

Deflationary Buyback Program: 10% of all fiat/crypto store revenue is deposited into the `buyback_pool`. Every 8 hours, an autonomous server function sweeps the DuckSwap AMM pool, injecting USDT and permanently burning DUCK.

Budget Spread: 80% to active Mining Pool / 20% to League Pool

Withdrawal Fee: 5% (covers TON gas + deflationary burn)

Relations in the Game:

â–¶ Earnings: Mined passively through Hash Rate and distributed every 10-minute block.
â–¶ Market: Used as the exclusive base currency for DuckSwap trading and Auctions.
â–¶ Evolution: Spent as a mandatory fee to finalize equipment Level-Ups.
â–¶ Cash Out: Swap $DUCK for USDT instantly on DuckSwap. There is no fixed exchange rate — the price is determined entirely by player supply and demand.

Projected Emission Decay (First 10 Halvings)

$GEMS PREMIUM (REAL REVENUE)

The fiat-pegged fuel layer utilized to acquire baseline materials and boost operations without diluting the crypto token.

Fixed Peg: 50 GEMS ≈ $1.00 Value (Paid in TON)

Supply: Infinite (Fiat gateway)

Revenue Distribution (TON):

100% of the TON injected via GEM/Pass purchases is distributed transparently to sustain the ecosystem:

Automated Buyback Pool: 10%
Investment & Liquidity Pool: 53%
Referral Program (MLM): 12%
Marketing & Growth: 15%
Team & Infrastructure: 10%

The Dual-Liquidity Strategy:

The majority of game revenue (63% total) is secured to ensure players can always cash out and to maintain extreme deflationary pressure on $DUCK:

10% (Automated Buyback): Instantly sent to the `buyback_pool` wallet. Every 8 hours, an autonomous server function sweeps the DuckSwap AMM pool, injecting USDT and permanently burning DUCK.
53% (Investment Pool): Retained in hot wallets to guarantee automatic, immediate TON withdrawals for players, and allocated to external investments (Bitcoin, etc) to compound the treasury's fiat value to fuel future mega-buybacks.

Relations in the Game:

â–¶ Acquisition: Bought with real-world value (TON via TonConnect).
â–¶ Loot Boxes: The only currency accepted to buy GPU, Battery, and AI Chip Boxes.
â–¶ HQ Expansion: Used to unlock new HQ Floors and expand Rig slots.
â–¶ Premium Features: Pays for Fortune Wheel premium spins and Founder Pass activations.

DuckSwap (AMM)

DuckSwap is the automated market maker (AMM) for trading $DUCK and $TON. It uses a Constant Product Market Maker (CPMM) model to provide instant swaps directly from the liquidity pool.

Instant swaps between $DUCK and $TON.
5% AMM swap fee (fuels the deflationary Buyback & Burn pool and covers network gas).
Real-time price discovery based on liquidity pool ratios ($x * y = k$).

Free Market Pricing

$DUCK has no fixed exchange rate. The price is determined entirely by player supply and demand on DuckSwap. This ensures a sustainable, manipulation-resistant economy where the token's value reflects genuine ecosystem activity.

Flea Market (P2P Items)

The Flea Market is a true Player-to-Player (P2P) marketplace for trading hardware items like GPUs, Batteries, and AI Chips for $DUCK.

2.5% Listing Fee: Charged upfront in $DUCK (non-refundable) to prevent market spam.
5% Sale Fee: Deducted from the final sale price upon a successful trade.
Listings expire after 48 hours and items are returned if unsold.
Maximum of 3 active listings per category (GPUs, Batteries, Chips) at a time.