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

Mission	Objective	XP
Daily Check-In	Log in and check in	50
Daily Mining	Have active rigs mining	100
Daily Share	Share with a friend	75
Daily Invite	Invite a new player	150
Daily Wheel	Spin the Fortune Wheel	75
Daily Enhance	Enhance an item	150

Weekly & Monthly

Mission	Objective	XP	Gems
Weekly Dedication	Complete 5 daily missions in a week	1,500	10
Weekly Collector	Collect 10 items	1,200	5
Weekly Investor	Spend 1000 DUCK	2,000	15
Monthly Veteran	30-day login streak	2,500	20
Monthly Ascension	Reach a new league	5,000	50

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

24h Duration

Li-Ion Pack

40h Duration

Titanate

56h Duration

Nuclear Cell

72h 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 capacity 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

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	Hash Multiplier	Duration Multiplier
Level 1	1.25x	1.2x Duration
Level 2	1.75x	1.5x Duration
Level 3	2.50x	2.0x Duration
Level 4	4.00x	3.0x Duration
Level 5	6.50x	5.0x Duration

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 45%
Rare Chip 35%
Epic Chip 15%
Legendary Chip 4.5%
Mystic Chip 0.5%

Fortune Wheel

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

Figure 2: The Fortune Wheel

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

📦 🔋 🤖 👑

Daily Luck

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

Paid Spins

Looking for a specific component? Paid spins use GEMS to 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. Each auction runs for a fixed duration, with the highest bidder winning the item at the end.

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.

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.

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 P2P Market, buying the cheapest DUCK from players and permanently burning it.

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

Withdrawal Fee: 3.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 P2P trading and Auctions.
▶ Evolution: Spent as a mandatory fee to finalize equipment Level-Ups.
▶ Cash Out: Can be sold to other players or swapped to TON via native withdrawals.

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 P2P Market, buying the cheapest DUCK from players and permanently burning it.
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.

P2P Market

Players can list $DUCK for direct peer-to-peer sales. The escrow contract holds assets securely until transaction confirmation.

3% fee on every executed trade.
Real-time balance verification via Firebase Functions.
Lightning-fast limit order matching under 30 seconds.

Buyback & Token Burn

The system collects a 3% native fee (in TON) on all P2P market trades. This fee, combined with the Investment Pool, fuels the automated Buyback Bot. Every 8 hours, the bot sweeps the P2P market, buying the cheapest available $DUCK sell orders and permanently burning them. This guarantees constant liquidity and creates a deflationary price floor for miners.

Wallet & Withdrawals

Connect your TON Wallet to enable deposits and withdrawals. The platform uses TON Connect for secure, non-custodial authentication.

💳 TON Connect

Connect via Tonkeeper, Tonhub, or any TON-compatible wallet
Wallet address is bound to your account on first connection
Non-custodial — your private keys never leave your wallet

💸 Withdrawals

Minimum: 0.10 TON equivalent

Fee: 3.5% (covers TON gas + deflationary burn)

Payout: Converted to TON and sent to your wallet

Daily Limit: 5 withdrawals per day

Address Validation: Regex-verified TON address format (EQ/UQ prefix)

Withdrawals are processed by a secure automated bot. Payout times may vary based on TON network congestion but typically complete within minutes.

Ducky Expeditions (Coming Soon)

The core mining loop is just the beginning. Expeditions will allow players to deploy specialized Duck Drones into the wasteland to locate rare components and NFTs.

Fortress Architecture (Security)

Duck Miner is completely Fail-Secure.

1. Firebase App Check

Every API interaction is fingerprinted by Google reCAPTCHA Enterprise. Forged client tokens are immediately rejected (403 Forbidden).

2. Backend Truth

Market Orders, Enhancements, and Withdrawals execute inside Node.js Cloud Functions. The client is purely visual.

Vision & Mission

Duck Miner exists to redefine the boundaries of Play-to-Earn gaming inside the Telegram ecosystem. Our mission is to build a self-sustaining, fair, and transparent virtual economy where every player's effort has real value.

The Vision

To become the reference infrastructure for idle-mining P2E games on Telegram, combining deterministic tokenomics, zero-trust security, and a vibrant player-driven marketplace.

100% server-side enforced economy — no client cheats
Revenue-backed token emission (D-1 Treasury Peg)
Sustainable growth without inflationary spirals
Community governance via league participation

Core Principles

01
Fair Play — No pay-to-win shortcuts. Free players can reach every tier through strategic gameplay.
02
Transparency — All drop rates, emission formulas, and fee structures are publicly documented.
03
Security First — Zero-trust architecture where the client is treated as untrusted at all times.
04
Real Value — $DUCK emission is pegged to actual revenue, not speculation.

Community-Driven Development

Major feature decisions are influenced by community feedback through our Discord and Telegram channels. The Duck Labs team maintains a bi-weekly development cadence with public changelogs.

Launch Trajectory & Team

Operated by Duck Labs, a collective of Web3 architects focused on balanced telemetry and unexploitable P2E economies.

✓

Phase 1 & 2: Architecture (Completed)

Secure backend validation, 2D UI Overhaul, deterministic tokenomics, P2P Market, and Auction System.

✓

Phase 3: Security Hardening (Completed)

Zero-Trust architecture, centralized admin controls, rate limiting on all critical functions, and full Whitepaper synchronization.

4

Phase 4: Expeditions & Multi-Mining (Q3 2026)

Ducky Expeditions launch, multi-currency mining pools (TON, BTC, ETH), and $DUCK Token Generation Event.

5

Phase 5: TON Ecosystem (Q4 2026)

Full on-chain persistence on The Open Network (TON) and decentralized asset bridge.

Seasons & Chapters

Duck Miner operates on a 30-day seasonal cycle. Each season brings fresh content, rebalanced economies, and exclusive rewards for active participants.

Season Duration

Each season lasts exactly 30 days. Leaderboard progress resets while permanent upgrades carry over.

Seasonal Rewards

Top-ranked players earn exclusive items, bonus Gems, and special cosmetic badges.

Leaderboard Reset

League rankings reset each season, giving every player a fresh competitive start.

Chapter Progression

Chapters are permanent milestones in the Duck Miner universe. Unlike seasons, chapter content is cumulative — each new chapter adds features without removing existing ones.

1

Chapter 1: Genesis Mining

The foundation. Core mining loop, GPU/Battery/Chip economy, Recycler, and Enhancement system.

✓ Live

2

Chapter 2: The Marketplace

P2P Market, Auction House, Buyback & Burn mechanism, and the full dual-token economy.

✓ Live

3

Chapter 3: Expeditions & Beyond

Drone-based exploration, rare NFT discoveries, multi-currency mining pools, and cross-chain bridges.

Coming Q3 2026

4

Chapter 4: The TON Era

Full on-chain persistence on The Open Network, decentralized governance, and community-driven content tools.

Planned Q4 2026

Seasonal × Chapter Interaction

Each season may introduce chapter-specific themed events. For example, a “Genesis Mining Season” might boost GPU drop rates, while an “Expedition Season” could unlock new exploration zones with exclusive loot tables.