The Nest
Documentation

Nest Guide

The complete manual for whelps, rewards, and the NEST economy.

System Check

Ecosystem Overview

Live status check of the platform functions.

Daily Yieldworking
Stakingworking
Legacy Importworking
Legacy Hatchworking
Legacy Checkerworking
Marketworking
First Hatchesworking
Native Mintpaused
Legacy Coop Mintworking
EarlyBirds Remaining...
01. Introduction

What’s The Nest?

In The Nest you can mint Whelp NFTs. Holding an NFT lets you get a daily yield in $Nest, claim it before it expires.

  • Free First Hatch: Mint a free untransferable First Hatch NFT at Level 1 with 1 $Nest/day yield and a 60-hour claim window.
  • Paid Hatches: Hatch 2 additional Whelps for 10 USDC or 20 USDC.
  • Legacy Evolution: Evolve old chickens (held before May 5th 2026 00:00 CET) for 1000 $Nest. They retain their original blockchain level.
  • Native Whelps: Further native Whelps can be hatched if your wallet meets specific requirements (TBA).
  • Slot Recovery: Paid hatches can be minted again ONLY if you sell the current one in the inner market. External transfers or OpenSea sales do not unlock the slot.
  • Goal: Hold your whelps and gain every day.
02. Rewards

Daily Yield Rules

Detailed breakdown of production, timeframes, and decay mechanics.

  • Production by Level: L1 (1), L2 (10), L3 (25), L4 (75), L5 (250) $Nest per day.
  • Claim Windows: Rewards must be collected within: L1 (2.5d), L2 (4.5d), L3 (8.5d), L4 (16.5d), L5 (30.5d).
  • Yield Stop: Failing to claim within the window stops production and burns all pending yield. Re-login is required to restart.
  • Activity Decay: After 30 days without an upgrade attempt, daily yield drops by 1% every 24 hours.
  • Recovery: Any upgrade attempt immediately restores 100% production efficiency.
03. Assets & Progression

Whelp Rules & Costs

All rules from the My Nest page regarding your Whelp NFTs.

  • L1 → L2: 1,000 NEST (90% Success)
  • L2 → L3: 2,500 NEST (60% Success)
  • L3 → L4: 10,000 NEST (30% Success)
  • L4 → L5: 50,000 NEST (10% Success)
  • Fail Safety: If an upgrade fails, the whelp stays at its level, but the transaction counts for activity reset.
04. Trading

Marketplace

Trade Whelps with other players. Anti-abuse rules protect the ecosystem.

  • Inventory Rule: You must own at least 3 NEST NFTs to list a Whelp for sale (always required).
  • Experience Rule: After your first 3 sales, you must also own at least one Level 3+ Whelp to keep listing.
  • Listing Durations: 12 Hours, 1 Day, 1 Week, or 6 Months. Default is 12 Hours.
  • Trading Fees: 3% Protocol Fee + 3% Creator Royalty (paid to original minter) per sale.
  • Currencies: USDC and NEST token accepted.
  • Slot Unlock: Inner market sales are the ONLY way to unlock paid mint slots for re-use. External transfers or OpenSea sales do not count.
05. Yield Optimization

Staking Rules & Rewards

Lock your NEST to earn a share of the weekly protocol rewards and emissions.

  • Tiered Rewards: Rewards are split into 5 buckets (Tiers). The longer you lock, the bigger the share of the prize pool you access.
  • The Tiers & Unlock Times:
    • Tier 0 (Flexible): 0 Days (Immediate) - 4% of pool.
    • Tier 1: 10 Days - 8% of pool.
    • Tier 2: 25 Days - 13% of pool.
    • Tier 3: 50 Days - 25% of pool.
    • Tier 4: 100 Days - 50% of pool.
  • Weekly Prize Pool: Every Sunday, the protocol calculates the rewards based on the Smoothing & Protection logic:
    • Above 1M NEST: All surplus is distributed (up to 50,000 NEST/week). This creates stable high-yield weeks at launch.
    • At or below 1M NEST: Weekly income (penalties/fees) is distributed, with a guaranteed minimum of 5,000 NEST (integrating from the reserve).
  • Early Exit Penalty: You can unstake anytime, but if you exit before the lock expires, you pay a penalty.
    • Linear Decay: The penalty decreases linearly every second as you approach the unlock date.
    • Calculation: Penalty = Capital * (Time Remaining / Total Lock Duration).
    • Example: If you lock for 100 days and exit at day 50, you pay 50% penalty. If you exit at day 90, you pay 10%.
    • Destination: All penalties stay in the prize pool to be distributed to other stakers.
  • Claim Window: Rewards must be claimed manually during the 24h "Claim Window" every Sunday.
  • NFT Boost: Holding Early Bird or Promotional NFTs adds a bonus (up to +20%) to your staking weight, increasing your share of the rewards.
06. Terminology

Glossary

The key words used across The Nest, explained without contract jargon.

The NestThe live app where Whelps, daily NEST yield, staking, marketplace trading, and legacy evolution all connect.
NESTThe ecosystem token used for rewards, upgrades, staking, fees, and game activity.
WhelpThe main NFT of The Nest. Whelps can be minted, bought, received, evolved from legacy Chickens, upgraded, and used to earn daily yield.
Legacy ChickenAn old Chickens by Eggs NFT that may be eligible to evolve into a Whelp if it meets the current rules.
EvolveThe action that turns an eligible legacy Chicken into a new Nest Whelp. Once evolved, that legacy NFT cannot be used again.
Evolved / ConsumedA legacy Chicken that has already been used. If it is marked evolved, it should no longer appear as available to evolve.
Available / EvolvableA legacy Chicken that currently appears eligible to evolve, based on ownership, timing, and previous usage checks.
LockedA legacy Chicken that cannot currently evolve due to timing rules, previous evolution, missing eligibility, or incomplete sync.
Free MintThe first Whelp mint path for a wallet. It may still include a very small anti-spam fee when active.
Paid MintAdditional Whelp mint slots paid by the user. These slots follow special eligibility and unlock rules.
Slot RecoveryA paid mint slot can reopen only when the related Whelp is sold through the internal Nest marketplace.
Daily YieldThe NEST reward generated by holding Whelps. Yield depends on level, activity, claim windows, and current rules.
ClaimableThe amount of NEST currently ready to claim from your Whelps.
LevelA Whelp progression stat. Higher levels can produce more daily yield and may unlock stronger marketplace utility.
UpgradeAn attempt to raise a Whelp level. Failed attempts do not reduce the Whelp level, but they still count as activity.
DecayA production reduction that can start after long inactivity. Upgrade attempts restore production efficiency under current rules.
EarlyBirdA supporter NFT from the launch phase. EarlyBirds can grant bonus benefits depending on the current live configuration.
BonusAn extra boost or benefit from EarlyBirds or future campaign assets.
MarketplaceThe internal Nest market where users can list and buy Whelps under the game's anti-abuse rules.
StakingA system where users lock NEST to participate in weekly reward distribution according to the active staking rules.
Deep SyncA stronger refresh that asks the app to re-check wallet data, ownership, or metadata when something looks stale.
Disclaimer

⚠️ Economic Notice

  • Yield rates, costs, and success probabilities may be adjusted to ensure economic balance.
  • Significant changes will be communicated via official channels and updated in this guide.