Egglee — Documentation

🚀 Getting Started

Start earning in under a minute. All you need is a MetaMask wallet connected to BNB Smart Chain.

Step 1 — Connect Your Wallet

Click "Launch App" and then "Connect Wallet". MetaMask will ask you to sign a verification message. This proves you own the wallet — we never see your private keys or seed phrase.

Step 2 — Accept Terms & Get Your Starter Kit

On your first login, you'll be asked to accept the Terms of Service. Once accepted, you automatically receive your free starter kit:

Item	Quantity	Details
Common Chicken	1	Produces 1 egg/day, lives 183 days, consumes 1 feed/day
Feed	5 units	Enough to feed your starter chicken for 5 days

Tip: Your starter chicken begins producing eggs immediately. Collect and sell them to build your first USDT balance, then reinvest in more feed or chickens.

Step 3 — Manage Your Farm

From the dashboard, you can:

Overview: See your chickens, eggs, feed stock, and USDT balance at a glance
Farm: Incubate eggs, feed chicks, view hatch history, and manage your flock
Wallet: Buy feed/chickens/eggs, request withdrawals, and view transaction history

🐔 Chicken Species

There are three chicken breeds in Egglee, each with different production rates, costs, and lifespans. Better breeds produce more but require more feed.

Species	Price	Eggs/Day	Feed/Day	Lifespan	Hatch Chance
Common	$1.00	1	1	183 days	70%
Premium	$10.00	3	2	221 days	25%
Rare	$20.00	5	3	269 days	5%

📊 Understanding Hatch Chance

The "Hatch Chance" column shows the probability that a newly hatched chick will become this species. When an egg hatches successfully, the species is randomly selected using these weights: 70% Common, 25% Premium, 5% Rare. This means incubating eggs is the only way to potentially get a Rare or Premium chicken without buying one directly.

Profitability Comparison

Here's how each species compares in daily net value (egg revenue minus feed cost):

Species	Eggs/Day	Revenue/Day	Feed Cost/Day	Net Profit/Day	ROI (days)
Common	1	$0.12	$0.10	$0.02	~50 days
Premium	3	$0.36	$0.20	$0.16	~63 days
Rare	5	$0.60	$0.30	$0.30	~67 days

Revenue calculated at system egg sell price of $0.12/egg. Feed cost calculated at $0.10/unit.

Lifetime Profit

Total net profit over the entire lifespan of each chicken:

Species	Purchase	Lifespan	Total Eggs	Total Revenue	Total Feed Cost	Net Lifetime Profit
Common	$1.00	183 days	~183	$21.96	$18.30	+$2.66
Premium	$10.00	221 days	~663	$79.56	$44.20	+$25.36
Rare	$20.00	269 days	~1,345	$161.40	$80.70	+$60.70

Strategy: Common chickens have the fastest ROI (50 days) but lowest absolute profit. Premium and Rare have similar ROI periods (~63-67 days) but much higher total earnings. Start with Common chickens to build capital, then upgrade to Premium and Rare for maximum lifetime profit.

🥚 Egg Production

Eggs are your primary source of income. Understanding how production works helps you maximize earnings.

Production Cycle

The game runs a production cycle every 10 minutes, totaling 144 cycles per day. During each cycle, every alive and fed chicken has a chance to produce an egg.

probability_per_cycle = eggs_per_day / 144

For example, a Common chicken (1 egg/day) has a 0.69% chance per cycle to produce an egg. Over 144 cycles, this averages out to ~1 egg per day. Production is probabilistic, so daily output may vary slightly.

Egg Statuses

Status	Description	Actions Available
Available	Freshly produced or purchased, sitting in your farm	Sell to system ($0.12) or Incubate
Incubating	Placed in incubator, waiting to hatch	Wait for hatching result (72 hours)
Hatched	Successfully hatched into a chick	None (chick is now growing)
Failed	Incubation failed, no chick produced	None (egg is consumed)
Sold (System)	Collected and sold to the system	None ($0.12 USDT credited)
Expired	Not collected within 7 days	None (egg is lost)

Warning: Produced eggs expire after 7 days if not collected or incubated. Check your farm regularly to avoid losing production!

Selling Eggs

Click "Collect Eggs" to sell all available eggs to the system at the fixed price of $0.12 per egg. The USDT is instantly added to your wallet balance.

Buying Eggs

You can also buy eggs directly from the system for $0.20 per egg via MetaMask (USDT/BEP-20). Purchased eggs can be incubated just like produced eggs, with the same 30% hatch success rate and species probabilities.

💡 Why Buy Eggs?

Buying eggs to incubate is a strategy to rapidly expand your flock. Although you pay $0.20 per egg (vs. $0.12 selling value), a successful hatch gives you a chicken worth $1-$20. With a 30% success rate and weighted species chances, the expected value makes it a worthwhile investment for growth.

🌾 Feed System

Feed is the fuel that keeps your farm running. Without it, your chickens stop producing and will die within 72 hours.

How Feed Works

Every production cycle (every 10 minutes), the system calculates the total feed needed by all your alive chickens:

feed_per_cycle = SUM(each_chicken.feed_per_day) / 144

If you have enough feed, it's automatically deducted and your chickens produce normally. If not, all your chickens enter starvation mode — they stop producing eggs and a 72-hour death timer begins.

Feed Pricing

Item	Price	Feeds Common Chicken For
1 Feed Unit	$0.10	1 day (1 feed/day)
10 Feed Units	$1.00	10 days
50 Feed Units	$5.00	50 days

Feed Consumption by Species

Species	Feed/Day	Feed/Cycle (10 min)	Monthly Feed Cost
Common	1	~0.0069	$3.00
Premium	2	~0.0139	$6.00
Rare	3	~0.0208	$9.00

Tip: Always keep a buffer of feed in stock. Running out means all your chickens stop producing and start starving simultaneously. A good rule is to keep at least 3 days' worth of feed at all times.

🔥 Incubation & Hatching

Incubation lets you turn eggs into new chickens — the only way to grow your flock without buying directly. Both produced and purchased eggs can be incubated.

The Incubation Process

🥚 Egg (produced or bought) → ⏳ Incubate 72h (0.5 feed/day) → 🎲 Hatch Roll (30% success) → 🐣 Chick!

Key Numbers

Parameter	Value
Incubation duration	72 hours (3 days)
Feed consumption during incubation	0.5 feed/day (1.5 total)
Incubation feed cost	$0.15 (1.5 units × $0.10)
Hatch success rate	30%
Hatch failure rate	70% (egg is lost)
Species on success: Common	70% chance
Species on success: Premium	25% chance
Species on success: Rare	5% chance

Important: Incubation consumes 0.5 feed per day for 3 days (1.5 feed total). The egg is also consumed. If the hatch fails (70% chance), you lose both the egg and the feed spent. Only incubate eggs you can afford to lose.

What Eggs Can Be Incubated?

All eggs — whether produced by your chickens or purchased from the system — can be incubated. They all have the same 30% success rate and the same species probabilities.

Expected Value Analysis

The expected value of incubating one produced egg (opportunity cost = $0.12 sell price):

EV chicken value = 0.70 × $1.00 + 0.25 × $10.00 + 0.05 × $20.00 = $4.20

EV = 0.30 × $4.20 - $0.12 (egg) - $0.15 (incub. feed) = $1.26 - $0.27 = +$0.99

The expected value of incubating one purchased egg ($0.20 cost):

EV = 0.30 × $4.20 - $0.20 (egg) - $0.15 (incub. feed) = $1.26 - $0.35 = +$0.91

Both scenarios have strong positive expected value, making incubation a worthwhile strategy long-term despite the 70% failure rate per attempt. Note: this EV does not include the chick growth feed cost ($0.60), which brings net EV to approximately +$0.39 (produced) or +$0.31 (purchased) per attempt.

🐣 Chick Growth

When an egg hatches successfully, a chick is born. Chicks must be fed daily before they become productive adult chickens.

Growth Requirements

A chick becomes an adult chicken when both conditions are met:

Condition	Requirement
Time elapsed since hatch	12 days minimum
Feed consumption rate	0.5 feed per day
Total feed consumed	6.0 units (12 days × 0.5/day)

Growth Cost

growth_cost = 12 days × 0.5 feed/day × $0.10/unit = $0.60

Full Incubation + Growth Cost

The total cost to go from egg to adult chicken:

Stage	Duration	Feed Used	Cost
Egg (produced)	—	—	$0.12 (opportunity cost)
Egg (purchased)	—	—	$0.20
Incubation	3 days	1.5 units	$0.15
Chick Growth	12 days	6.0 units	$0.60
Total (produced egg)	15 days	7.5 units	$0.87
Total (purchased egg)	15 days	7.5 units	$0.95

🥚 Egg → ⏳ Incubate 3 days (1.5 feed) → 🐣 Chick grows 12 days (6.0 feed) → 🐔 Adult chicken!

Tip: The total cost of $0.87-$0.95 per attempt (with only 30% success) means on average you spend ~$2.90-$3.17 per successful chicken. This is much cheaper than buying a Premium ($10) or Rare ($20) directly, but you're more likely to get a Common (70%).

💀 Death Mechanics

Chickens can die in two ways. Both are permanent — dead chickens cannot be revived.

Natural Death (Lifespan)

Every chicken has a fixed lifespan determined by its species. When the lifespan expires, the chicken dies automatically at the next production cycle.

Species	Lifespan	Total Eggs (theoretical)	Gross Revenue
Common	183 days	~183 eggs	~$21.96
Premium	221 days	~663 eggs	~$79.56
Rare	269 days	~1,345 eggs	~$161.40

Starvation Death

If your feed balance runs out:

All your chickens immediately stop producing eggs
A starvation timer starts for each unfed chicken
If you refill feed before the deadline, starvation is cleared and production resumes
If a chicken goes 72 hours (3 days) without feed, it dies permanently

Critical: Starvation affects ALL your chickens at once. If you run out of feed with 20 chickens, all 20 start starving simultaneously. Refilling feed within 72 hours saves them all — failing to do so kills them all.

🌾 Feed runs out → ⚠️ Starvation starts (no eggs) → ⏰ 72h countdown → 💀 Death (permanent)

💰 Wallet & Withdrawals

Your wallet holds two balances: USDT (from selling eggs) and Feed (for your chickens and incubation).

Earning USDT

You earn USDT by:

Selling eggs to the system: $0.12 per egg (instant)
Depositing USDT: Send USDT (BEP-20) directly to the platform wallet

Spending USDT

You spend USDT by purchasing via MetaMask (USDT on BSC):

Item	Price
1 Feed Unit	$0.10
1 Egg	$0.20
Common Chicken	$1.00
Premium Chicken	$10.00
Rare Chicken	$20.00

Withdrawals

Parameter	Value
Withdrawal fee	3%
Max withdrawals per day	1
Processing time (SLA)	Up to 72 hours
Network	BNB Smart Chain (BEP-20)
Token	USDT (Tether)

How Withdrawals Work

📝 Request withdrawal → 💸 3% fee deducted → ⏳ Admin review → ✅ USDT sent to your wallet

💡 Example

You request a withdrawal of $10.00. The 3% fee is $0.30, so you receive $9.70 USDT in your MetaMask wallet on BSC.

Deposits

To deposit USDT into Egglee:

Copy the platform's deposit wallet address from the Wallet tab
Send USDT (BEP-20 only) from your MetaMask
Wait for 12 block confirmations (~36 seconds on BSC)
Your balance is automatically credited

Important: Only send USDT on BNB Smart Chain (BEP-20). Tokens sent on other networks (Ethereum, Polygon, etc.) or wrong token contracts cannot be recovered.

📋 Quick Reference

All key numbers in one place.

Mechanic	Value
Production cycle frequency	Every 10 minutes
Cycles per day	144
Egg sell price (to system)	$0.12
Egg buy price (from system)	$0.20
Feed price per unit	$0.10
Egg expiration	7 days
Incubation duration	72 hours (3 days)
Incubation feed consumption	0.5 feed/day (1.5 total)
Hatch success rate	30%
Chick growth period	12 days
Chick feed consumption	0.5 feed/day (6.0 total)
Total egg-to-chicken time	15 days
Total egg-to-chicken feed	7.5 units ($0.75)
Starvation death timer	72 hours
Withdrawal fee	3%
Max withdrawals per day	1
Blockchain confirmations	12 blocks
Starter kit (free)	1 Common Chicken + 5 Feed