TreeFi Whitepaper

The definitive guide to mechanics, tokenomics, and the fusion protocol. Master the strategy in TreeFi's sustainable, attention-based economy.

1. Introduction

Welcome to TreeFi. TreeFi is a strategic resource-management game built around sustainable, attention-based rewards. Your goal is simple: acquire trees, plant them to farm $TFC, and fuse them to create rare, high-yielding masterpieces.

Unlike traditional idle games, TreeFi uses a Lethal Burning System. If you forget to water your trees, they enter a Burning State where their power rapidly decays. If a tree's Burning intensity reaches 100%, it is permanently destroyed. Stay active, stay green!

Season
7 Days
Base Slots
3
Reset
Every Season
Fusion Need
3 Trees

2. Store & Mystery Chests

To enter the economy, you must purchase a Mystery Chest from the Store using $TFC. This is the primary entry point for all assets. Each chest contains 1 Uncommon Tree.

Shop Items (Maintenance)

Items are sold individually. Consumables (Water, Fertilizer, Anti-Bug) have a base duration of 8 hours regardless of tree rarity.

Item Price / Pack Duration Effect
Water $0.01 worth of $TFC 8 Hours Required to earn yield. +0% bonus.
Fertilizer $0.10 worth of $TFC 8 Hours Optional. +4% Yield boost.
Anti-Bug $0.10 worth of $TFC 8 Hours Optional. +3% Yield boost.
Repair Items $0.01 - $0.20 worth of $TFC Instant Removes 5% Burning instantly. Only heals standard Burning damage, not Permanent Rot. Overflow becomes Shield — excess repair converts to future protection.

Graduated Maintenance Fees

Maintenance costs scale with tree rarity. This "Action Tax" funds the Season Pool daily payouts. Higher rarity trees have higher yields but require more significant upkeep.

UNCOMMON
$0.0003 worth of $TFC
RARE
$0.0023 worth of $TFC
EPIC
$0.0100 worth of $TFC
LEGENDARY
$0.0500 worth of $TFC

3. Seasonal Reset & Burning

TreeFi uses a Hard Seasonal Reset model. To ensure a fresh economy and maximum scarcity, all game assets are ephemeral and tied to the current season.

The Great Burn:

The moment a season ends and enters its 24-hour Cooldown phase, a global "Burn" is triggered:

  • All Trees are Burned: Every tree (planted or in inventory) is permanently deleted.
  • All Items are Burned: All unused Water, Fertilizer, Scrolls, and Repair Items are cleared from your inventory.

Why? This ensures that every season starts on a level playing field, prevents asset inflation, and maintains the value of new purchases each cycle.

Lethal Burning & Permanent Scarring

While the season is active, neglecting your trees leads to Rot Damage. This damage is split: 80% becomes repairable Burning, while 20% becomes Permanent Rot that cannot be repaired. If combined damage reaches 100%, your tree is lost before the season even ends.

Rarity Total Burn Rate Repairable (80%) Perm Rot (20%)
Uncommon 5% / hr 4.0% / hr 1.0% / hr
Rare 4% / hr 3.2% / hr 0.8% / hr
Epic 3% / hr 2.4% / hr 0.6% / hr
Legendary 2% / hr 1.6% / hr 0.4% / hr
⚠ Pre-Season Loss Perm Rot

1h Cooldown & Daily Settlements

A brief 1-hour cooldown period is used for Final Settlement. During this time, the forest is gone, while your mined $TFC is settled directly to your balance. This reward is automatically added to your balance once the settlement is complete.

Continuous 24/7 Access (No Season Gate)

TreeFi operates on an open 24/7 continuous economy with no lockout gates. Any player can enter, plant trees, and start mining at any time. Mined $TFC can be withdrawn 24/7 with decaying exit fees. Every tree operates on a graduated rolling lifespan (7 to 28 days) and continues mining across seasons as long as it has remaining operating time.

Key features of the continuous economy include:

  • Zero Season Gate: Open access 24/7 without lockout deadlines.
  • Daily Reward Settlement: Direct midnight token payout based on Power0.75.

  • Decaying Exit Fees: Flexible early withdrawals (15% down to 0%) with 100% recycling into tomorrow's pool.
  • 4. Land NFTs

    Every player starts with 3 free base slots to plant trees immediately. To expand your farm, you can own and equip Land NFTs. Land NFTs are on-chain assets that permanently grant you additional farming slots and passive production boosts.

    Land Rarities & Bonuses

    Rare
    • Slots: 3
    • Production Boost: +3%
    • Rot Resistance: +3 Min
    Epic
    • Slots: 6
    • Production Boost: +6%
    • Rot Resistance: +6 Min
    Legendary
    • Slots: 9
    • Production Boost: +10%
    • Rot Resistance: +10 Min

    5. Farming (The Grid)

    To earn yield, you must plant your trees on your equipped Land NFTs. Every wallet starts with 3 Base Slots. You must own and equip a Land NFT (Rare=3, Epic=6, Legendary=9 slots) to start farming.

    Ignition Fee (One-Time Activation Per Season)

    The first time you plant a tree each season, you pay a one-time Ignition Fee. This fee resets at the start of each new 7-day season. Once paid, the tree is free to plant/unplant for the rest of that season.

    Uncommon
    $0.01 worth of $TFC
    Rare
    $0.03 worth of $TFC
    Epic
    $0.09 worth of $TFC
    Legendary
    $0.18 worth of $TFC

    Maintenance (Daily Upkeep)

    Planted trees yield nothing if not watered! You must apply Water (required) at least once every 8 hours to keep your tree farming. Each water item costs a nominal maintenance fee (scales by rarity) and lasts 8 hours. Fertilizer (+4%) and Anti-Bug (+3%) are optional boosts that stack on top.

    Hard Seasonal Reset

    TreeFi uses a hard reset model. The moment a season ends, all assets (trees & items) are burned. No rewards are generated during the cooldown phase as the prize pool is being finalized for distribution. Note: Potion and Water extensions (time remaining) do NOT wipe and carry over to the next season.

    10-Minute Cooldown & Permanent Scarring

    If an ignited tree runs out of water, a 10-minute grace period begins. After 10 minutes, the tree suffers Damage. Damage is split: 80% becomes Burning (which can be repaired), and 20% becomes Permanent Rot (which reduces power forever). If combined damage reaches 100%, the tree is permanently deleted. Watering resets the timer and stops further damage. Crucially, while a tree has any active Burning damage, it temporarily loses access to all global Yield Boosts (Referral, Skills, and Land) until repaired!

    Power & Yield

    Every tree has a Raw Power stat compressed into Effective Mining Power via the sub-linear curve (Power0.75). Higher tiers also enjoy extended operating lifespans.

    Rarity Power Effective Power Lifespan
    🌱 Uncommon 10 5.62 Power 168h (7d)
    🌿 Rare 47 17.95 Power 336h (14d)
    🌲 Epic 210 55.22 Power 504h (21d)
    👑 Legendary 860 158.81 Power 672h (28d)

    6. Fusion Protocol

    Fusion is the only way to obtain Rare, Epic, and Legendary assets. You must provide exactly 3 trees of the same rarity to attempt a Fusion.

    Ignition Requirement

    Before a tree can be used in fusion, it must first be Ignited. You must plant the tree on your farm and pay the one-time Season Activation Fee (Start Production). Once ignited, you must unplant it (send it back to your inventory) to make it available for fusion.

    Lethal Fusion Protocol

    Fusion is high-stakes. If a fusion attempt fails, all three material trees are permanently destroyed ("burned to ashes"). This mechanism ensures rarity remains meaningful within the ecosystem.

    Rot Reset

    Additionally, successfully fusing trees will completely reset any Permanent Rot to 0% on the newly created higher-tier tree. This makes fusion a strategic way to cleanse heavily scarred assets.

    Fusion fees are tiered: $0.20 USD (Uncommon), $0.60 USD (Rare), $1.80 USD (Epic). (These fees are dynamically paid in $TFC using the live Oracle price)

    Fusion Success Rates & Scroll Costs

    Input (3x) Output Base Rate Scroll Cost
    3× Uncommon 1× Rare 70% $0.10 worth of $TFC
    3× Rare 1× Epic 50% $0.30 worth of $TFC
    3× Epic 1× Legendary 30% $1.00 worth of $TFC

    Rescue Shield Scrolls

    To mitigate the risks of the Lethal Fusion Protocol, you can use a Success Scroll:

    • Flat 10% Boost: Using a scroll adds a flat 10% bonus to your success chance.
    • Rescue Shield: When a scroll is used, if the fusion fails, exactly 1 material tree is saved from destruction. The other two will still be lost.
    • One Per Fusion: Only one scroll can be used per attempt (non-stackable).

    Leaf Shards (The 100% Guarantee)

    Leaf Shards are powerful items that allow you to guarantee a successful fusion.

    • Stackable +5% Per Shard: Every Leaf Shard you inject into the fusion adds a flat +5% success rate. They can be freely stacked all the way up to 100% success!
    • Matching Rarity: The shards you use must match the rarity of the trees you are fusing (e.g., fusing 3x Rare trees requires Rare Leaf Shards).
    • Where to get them: Leaf Shards are primarily obtained as Bonus Drops from the Fishing mini-game. Alternatively, you can buy them from other players on the Player Marketplace!

    Chest Boost & Pity Discount

    Chest Luck Boost: Every Mystery Chest you open permanently increases your Fusion Success Rate by +0.5% (capped at +10%). Resets to 0% after a successful fusion.

    Pity Fee Discount: Every failed fusion reduces the next Fusion fee by 0.5%.

    7. Skill Tree & XP

    Farming yields more than just $TFC! Active farming and fusion generate XP (Experience Points). As you gain XP, you level up your account and earn Skill Points. These points can be spent in the Skill Tree (accessible from your Profile) to permanently enhance your account for the duration of the season.

    Earning XP

    Quests, Tasks, and Fusions reward XP. Trees also generate a small amount of passive XP every hour.

    Fusion XP Rewards
    Fusion Normal VIP
    🌿 Rare 100 XP 200 XP
    🌲 Epic 500 XP 1,000 XP
    👑 Legendary 1,500 XP 3,000 XP
    Passive Tree XP
    Rarity Normal VIP
    🌱 Uncommon 20 XP/h 40 XP/h
    🌿 Rare 60 XP/h 120 XP/h
    🌲 Epic 180 XP/h 360 XP/h
    👑 Legendary 540 XP/h 1,080 XP/h

    The Four Mastery Paths

    Discount Mastery

    Reduces the cost of Shop items and Fusion fees by -0.5% per level. Max Level 10 (-5%).

    Yield Expert

    Increases the farming yield of all planted trees by +0.3% per level. Max Level 10 (+3%).

    Fusion Luck

    Increases base fusion success rate by +0.3% per level. Max Level 10 (+3%).

    Time Weaver

    Extends the duration of all Maintenance items (Water, Fertilizer) by +6 mins per level. Max Level 20 (+2 hours).

    8. TreeFi Coin ($TFC) Tokenomics

    TreeFi is powered by TreeFi Coin ($TFC), a hyper-deflationary utility token launched via the Flap Protocol. The token is designed to reward active players and penalize market inflation through a powerful deflationary ecosystem.

    Token Profile

    Token Name
    TreeFi Coin
    Ticker
    $TFC
    Total Supply
    1 Billion
    Airdrop
    1%
    Chain
    Robinhood Network
    Smart Contract Address (Robinhood Network)
    0x4ca7bceb7c6aebba562984c0b50108337a0b7777

    Market Economy (Flap Tax Protocol)

    To ensure external revenue flows into the game, we utilize Flap's asymmetric tax system:

    DEX Trading Taxes

    Every time $TFC is traded on decentralized exchanges, a small tax is collected and distributed to sustain the game's economy:

    20% Market Auto-Burn: 20% of all collected taxes are instantly burned by the Flap protocol, keeping the market supply deflationary.

    50% Game Treasury (Buybacks): 50% flows directly into the game's Treasury. We use this to perform Manual Buybacks of $TFC on the open market, injecting the purchased tokens directly into the Seasonal Prize Pool to reward active players.

    20% Marketing & Growth: 20% is allocated to a dedicated marketing wallet to fund campaigns, attract new players, and expand the TreeFi ecosystem.

    10% Server & Development: 10% covers the essential costs of running the game, including high-performance RPC nodes, servers, and ongoing protocol development.

    100% Safe & Decentralized

    Because $TFC is launched via the Flap Protocol, it is mathematically impossible for the team to rug-pull or manipulate the market.

    • Zero Control Over Supply: The TreeFi team has NO control over the token supply.
    • Locked on Flap Portal: The entire token supply is securely locked and managed exclusively by the decentralized Flap Portal.
    • No Team Tokens: The team cannot mint new tokens or dump on players. The ONLY thing the team can collect are the small trading taxes used to fund the game!

    9. Prize Pool Economy

    TreeFi uses a transparent Seasonal Prize Pool. All the TFC spent in the game is shared directly with the players at the end of the season. This makes the game completely fair and sustainable for everyone.

    Seasonal Cycles

    The game runs in 7-Day Seasons. At the end of each season, the accumulated Prize Pool is distributed, and the protocol enters a short cooldown phase before the next cycle begins.

    Fair Entry (Dynamic $TFC Costs)

    To ensure a perfectly equal playing field, all in-game items (like Chests, Water, and Fertilizer) have a fixed underlying USD value. While purchases are made exclusively in $TFC, our live Oracle automatically adjusts the amount of $TFC required based on real-time market prices.

    Why do we do this? If costs were fixed in $TFC, early players would have a massive, unfair advantage over new players if the token price skyrockets. By dynamically adjusting the $TFC cost to match a stable USD entry, it will always cost the exact same real-world value to play the game, keeping the barrier to entry completely fair for everyone.

    Community Revenue Distribution Model

    Every transaction within the ecosystem (Chests, Fusion, Ignition, Items) contributes directly to the seasonal prize pool. This revenue is strictly allocated to reward active players:

    Community Prize Pool (97% Farming / 3% Fishing)

    All TFC spent in the game flows directly into continuous daily token mining pools to reward active farmers based on their effective power.

    Prize Pool Vault Contract:
    0xA200f21E37e78c7fEe370165AfCf8cb2F5aa3113

    Daily TFC Token Mining

    Your trees continuously mine $TFC Tokens from the daily reward pool. Effective Mining Power is calculated using the sub-linear curve (Power0.75), preventing whale monopolies and rewarding every active farmer:

    • Uncommon: Steady mining yield (5.62 Effective Power), ideal for entry-level farmers.
    • Rare/Epic/Legendary: Substantially higher mining power (up to 158.81 Effective Power) and extended rolling lifespans up to 28 days.
    • Maintenance Matters: Only watered trees mine rewards. If your tree runs dry, mining halts immediately!
    Daily TFC Payout = (Your Effective Power / Total Global Effective Power) × Daily Mining Pool

    Fair Distribution

    The sub-linear mining model ensures healthy rotation of capital and guarantees continuous daily token earnings without hyperinflation or whale drainage.

    Automated Settlement: No manual claiming is required. Once the season finalizes, your TFC rewards are automatically calculated and transferred directly to your Game Balance. You can view your performance summary the next time you log in!

    10. Referral System (Yield Booster)

    TreeFi’s referral system is designed to reward players for growing the community without draining the seasonal prize pool.

    The Yield Booster

    When you invite friends to TreeFi using your referral link, they become part of your Tribe. If an invited friend becomes an Active Farmer (meaning they have spent $TFC to start playing, such as buying a chest or igniting a tree), you unlock a permanent Yield Boost for your own farm!

    • Each Active Referral grants a +0.5% boost to your global mining yield.
    • The boost is capped at a maximum of +5% (which requires 10 Active Referrals).
    • This bonus applies multiplicatively to your hourly mining yield, making it extremely valuable for players with high-power trees.

    Fair Economy Protection

    Unlike traditional pyramid schemes that drain the community prize pool to pay referrers, the Yield Booster strictly rewards you with higher mining yield. This ensures 100% of the game's revenue stays securely in the Prize Pool for all active farmers to share fairly.

    11. Combat Arena & PvP Duels Under Construction

    Feature Currently Under Construction The Combat Arena is currently under construction. We are working hard to bring this feature to you soon!

    12. Interactive Mini-Games

    The Mystic Bird

    A mysterious bird frequently flies across your screen. If you're quick enough to catch it, you'll be rewarded with XP!

    • Appearance Rate: Randomly every 1 to 5 minutes.
    • Reward: Between 10 and 50 XP. VIP players receive a 2x multiplier.

    Shake the Tree

    Your tree occasionally has loose leaves or hidden XP. Give it a shake when the prompt appears!

    • Appearance Rate: Randomly every 1 to 10 minutes.
    • Reward: Between 10 and 50 XP.

    Lucky Spin

    The Lucky Spin is a daily engagement wheel that rewards active players with random prizes. Every player gets 1 free spin every 24 hours. Additional spins can be purchased for $0.20 worth of $TFC each.

    Possible Rewards

    Mystery Chest
    1% chance
    1.00$ TFC
    5% chance
    Uncommon Scroll
    5% chance
    Uncommon Repair
    5% chance
    500 XP
    10% chance
    Anti Bug x1
    10% chance
    Fertilizer x1
    10% chance
    Water x2
    25% chance
    250 XP
    29% chance

    Anti-Abuse Rules

    • Free spin cooldown is tracked server-side — it cannot be bypassed by refreshing the page.
    • Each paid spin requires a valid session token.
    • Winnings are credited instantly to your in-game balance and logged in your transaction history.

    13. Land Rent System

    Not everyone has a Land NFT — and that's okay. The Land Rent System allows Land NFT owners to rent out their unused plot slots to other players, creating a passive income stream for landowners and a lower-barrier entry for non-NFT holders.

    For Land Owners

    List your unused Land NFTs for rent at a price you set. Renters pay you directly in $TFC every 6 hours.

    For Renters (No NFT Required)

    Browse available land listings and rent them for a fixed rate billed every 6 hours. Once rented, you can plant your trees on that land and earn rewards just like a regular land owner.

    Cancellations & Evictions

    If a renter runs out of $TFC to pay the rent, or if they cancel early, their trees are automatically uprooted and returned to their inventory. If a Land Owner forces an eviction, they are penalized and must refund the renter's current 6-hour block.

    14. VIP Status

    TreeFi offers aesthetic and quality-of-life enhancements for dedicated players. VIP status does not provide unfair advantages in combat or yield rates, but it helps you stand out on the leaderboards.

    How to Obtain VIP

    Unlike standard items, VIP cannot be purchased in the Shop. Instead, it is highly exclusive! At the end of every season, 10 random players are selected to receive VIP status for the following season as a special reward. To be eligible, you must share your Season Rewards on X from the Season End page, and actively engage with our community on X and Discord!

    Season VIP Perks

    If you are lucky enough to win the VIP pass, it grants the following benefits for the entire season:

    • 2x XP Generation: Level up your Skill Tree twice as fast from farming.
    • Double Spin: Get 2 Free Daily Spins on the Lucky Wheel instead of 1.
    • +5% Fusion Bonus: A flat increase to all your fusion success rates.
    • +20 Max Stamina (Fishing): Increases your fishing stamina cap to 120 so you can sleep longer without capping out.
    • -10% Bite Time (Fishing): All fish bite 10% faster, saving you precious active time.
    • +5% Bonus Drop (Fishing): Increases your chance to find Leaf Shards and Potions while fishing.
    • +25% Bonus XP (Fishing): Earn 25% more Player XP and Fishing XP on every successful catch.

    Profile & Leaderboard Customization

    VIP players can unlock exclusive customizations to show off their status:

    Glow Colors

    Apply a custom glowing border to your name on the Top Masters leaderboard.

    Animations

    Add subtle pulse or wave animations to your profile display.