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 $POL, and fuse them to create rare, high-yielding masterpieces.

Unlike traditional idle games, TreeFi uses a Dynamic Health System. If you forget to water your trees, they enter a Dry Spell where their power slowly decays. Total exhaustion leads to a 24-hour warning period before the tree is removed. Stay active, stay green!

Season
15 Days
Base Slots
9
Durability
15 Days
Fusion Need
3 Trees

2. Store & Mystery Chests

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

Shop Items (Maintenance & Utility)

Items are sold individually. Consumables (Water, Fertilizer, Anti-Bug) last 12 hours per tree, while Utilities (Deeds, Catalysts, Stabilizers) last 15 - 30 days.

Item Price / Pack Duration Effect
Water 0.10 POL 12 Hours Required to earn yield. +0% bonus.
Fertilizer 1.00 POL 12 Hours Optional. +4% Yield boost.
Anti-Bug 1.00 POL 12 Hours Optional. +3% Yield boost.
Elixirs 3.0 - 150 POL Instant Removes 33% Rot instantly. Overflow becomes Rot Shield — excess healing converts to future protection.
Mists 0.5 - 25.0 POL Instant Removes 5% Rot. Excess becomes Shield.
Land Deeds 15 POL 30 Days Expands your grid by +1 Slot. Requires an open Utility Slot.
XP Catalyst 10 POL 15 Days Supercharge your leveling! Grants +25% XP from all sources.
Power Stabilizer 5 POL 15 Days Protection against neglect. Reduces Dry Spell decay by 5-20% based on rarity.

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.050 POL
RARE
0.100 POL
EPIC
0.250 POL
LEGENDARY
0.500 POL

3. Health & Durability

Every newly minted tree starts with 15 Days of Durability. Durability counts down continuously regardless of whether a tree is planted or in your inventory. Trees are never "frozen" in time while a season is active.

Warning: Trees in your inventory lose durability just like planted ones. Additionally, ignited trees in the inventory will continue to suffer Dryness Damage (Rot) if they are dry. The inventory is a storage space for unplanting, not a safe haven from aging.

Fair Durability Averaging: When you fuse three trees, your new asset inherits the average remaining durability of the materials used. This means using fresh trees results in a longer-lasting fused tree!

Season Pause: Durability is frozen during the cooldown between seasons. If your tree has 5 days left when a season ends, it will still have 5 days left when the next one begins.

The Dryness System & 24h Notice

If a tree runs out of water, it triggers a 10-minute grace period. After that, it suffers 2% Dryness Damage per hour, which reduces its yield.

A tree only "expires" when its Durability reaches zero. Once expired, it remains in your inventory for 24 hours as a final notice before it is permanently removed.

⚠ 24H Notice Period Dryness Reduces Yield

One Tree = One Season Alignment

Trees have a strict 15-day lifespan, perfectly aligned with the 15-day season.

Durability is frozen during the cooldown period between seasons.

4. Farming (The Grid)

To earn yield, you must plant your trees on the TreeFi grid (your Dashboard). A wallet starts with **9 Initial Grid Slots**, but can expand dynamically through the **Utility System**.

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 15-day season. Once paid, the tree is free to plant/unplant for the rest of that season.

Uncommon
0.10 POL
Rare
0.50 POL
Epic
1.00 POL
Legendary
2.50 POL

Maintenance (Daily Upkeep)

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

Grace Period Earning

Unlike many other systems, TreeFi honors your maintenance. If a season ends but your tree still has water remaining, it will continue to earn rewards during the cooldown phase until the water runs out. Every drop counts!

10-Minute Rot Cooldown

If an ignited tree runs out of water, a 10-minute grace period begins. After 10 minutes, the tree suffers permanent power loss at a rate of 2% per hour. Watering resets the timer and stops further damage.

Power & Yield

Every tree has a Power stat. Your yield is proportional to your personal power share within one of the 4 Tiered Pool (Uncommon, Rare, Epic, Legendary). Higher rarity yields from larger pools.

Uncommon
10 PWR
Rare
40 PWR
Epic
150 PWR
Legendary
600 PWR

The Utility System (Slots & Deeds)

Utility Slots are special sockets on your farm used for Land Deeds, Catalysts, and Stabilizers.
Level Rewards: You start with 1 slot. A new slot unlocks every 5 Levels (up to 8 total).
Auto-Protection: If a Land Deed expires, any trees on those slots are safely Auto-Unplanted to your inventory. Important: These trees remain "Ignited," so you won't have to pay the activation fee again when you replant them!

5. 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.

No Loss (Risk-Free) Protocol

Unlike outdated systems, TreeFi never destroys your material trees on a failed fusion. If the cosmic energy fails to merge, you keep all 3 trees, though they suffer a 33% Rot penalty. Only successful fusions consume the material trees.

Ignition Requirement

Only Ignited Trees can be used as materials for Fusion. If your trees are not yet ignited, you must first start production on them (Grid) before they can be merged in the Fusion Chamber. This ensures that only high-activity assets are eligible for tier progression.

Fusion fees are tiered: 5 POL (Uncommon), 25 POL (Rare), 100 POL (Epic).

Fusion Success Rates & Scroll Costs

Input (3x) Output Base Rate Max Boost (Scrolls) Scroll Cost
3× Uncommon 1× Rare 70% 100% 2 POL
3× Rare 1× Epic 50% 100% 10 POL
3× Epic 1× Legendary 30% 100% 40 POL

Multiple Success Scrolls

You can now use multiple scrolls in a single fusion to stack your success chance:

  • Stackable Boosts: Each scroll adds a flat % (Uncommon: +10%, Rare: +15%, Epic: +20% per scroll), allowing you to reach 100% Guaranteed Success.
  • Safe Failure: If you don't use scrolls and fail, you keep your trees but they incur 33% Rot.

6. Active Economy

TreeFi operates in 15-Day Seasons, perfectly aligned with each tree's 15-Day lifespan. One tree, one season — no revenue resets, no durability waste, no hidden cross-season penalties. The community payout pool accumulates for the full season duration.

Season Cooldown Lockdown

When a season ends, the game enters a strict Cooldown Phase. During this time, the core game operations are locked down — you cannot farm, plant, maintain, buy items, or fuse trees. However, you can still access the Claim, Profile, and Leaderboard pages to review and withdraw your rewards.

🛡️ Zero-Penalty Cooldown: Tree durability does not decrease during cooldown. Ignited power drain is also paused. You will never lose progress for time spent waiting between seasons.

TreeFi operates as a Community-Driven Protocol. For core assets (Chest Sales, Fusion Fees, Ignition Fees), 100% of all revenue is returned directly to players. For expansion items (VIP & Utilities), 95% of revenue is allocated to the reward pool, with the remainder incentivizing community growth through referrals.

Global Hybrid Reward Pools (99% Total)

Rewards are distributed through a unified system that balances base stability with high-tier profit incentives. To ensure stability, the system uses Dynamic Smoothed Payouts (1/N) — distributing a variable percentage of the Net Mature Balance based on the days remaining in the season. On Day 1, payouts are conservative (~6%), and they accelerate daily until reaching 100% on the final day. This ensures a grand finale and consistent returns across the active season.

Because rewards are shared globally, redistribution is **built-in**: if high-tier assets are scarce, their profit share automatically stays in the pool for active Epic and Rare players, ensures the community always receives its full 100% share.

The Fairness Guarantee: TreeFi uses a Player-First Reserve system. Before any profits are distributed, the system sets aside enough POL to ensure every active tree meets its base target for the season. This "Floor" is protected by the Community Reserve.

Profit Gradients (The Overflow): Once the base targets are secured, extra profits (surplus) are distributed. Higher rarity trees receive a larger share of this overflow:

1. Uncommon: Focuses on active safety and steady growth.
2. Rare: Balanced growth with increased yield potential.
3. Epic: Expert tier with significant profit shares.
4. Legendary: The ultimate tier for maximum yield and prestige.

Community Growth & Commissions

Core Ecosystem: TreeFi is a non-profit community protocol. 100% of core revenue stays within the ecosystem to fund player rewards.

Growth Incentives: To reward community builders, a portion of every purchase (up to 5% for expansion items) is distributed as direct commissions to referrers.

Daily Yield = [Min. Dynamic Floor Target (ROI Protection)] + [Weighted Power Share of Surplus Overflow]
Daily Payout Pool = Today's Floor + (Surplus Rate × Season Pool Overflow)
Vesting Protocol = Tiered Instant Release (20% - 100%) + Linear Drip synced to Asset Durability

Dynamic Tiered Release & Maturation

To ensure total liquidity balance, TreeFi uses a **Dynamic Maturation System**. Instead of a fixed 15-day delay, the system syncs revenue release to the **Durability** of the asset that generated it.

Maintenance
100% Instant
Direct Pool Refill
Fusion & Ignition
50% Instant
High-Power Liquidity
Mystery Chests
20% Instant
Protocol Stability

ROI Protection (Floor Compression): For assets with custom durability (e.g. Fusions inheriting 3.3 days life), the system **compresses the daily floor target**. This ensures that even short-lived high-tier trees reach their ROI targets before expiration.

Late Season Carry-Over: If you deposit on the final days of a season, any *un-dripped (immature)* revenue is automatically carried over to fund the next season's active pool.

Per-Transaction Maturity: Maturity is evaluated per purchase, not as a season average. A player who buys on Day 1, Day 6, and Day 14 of the same season has each investment evaluated independently at season end:

Day 1 purchase → ~95% Mature (full rebate eligible)
Day 6 purchase → ~68% Mature (partial rebate eligible)
Day 14 purchase → ~25% Mature (mostly Carry-Over)

This ensures every individual investment is treated fairly — the system never penalises an early buyer for someone else's late entry.

Dynamic Profit Tax (0 - 5%)

TreeFi uses a Progressive ROI Protection model. To ensure every player recovers their capital, the system applies a 0% tax until you have achieved 100% ROI. Once your investment is recovered, a 5% "Profit Share" tax is applied only to the surplus portions of your claims.

Until 100% ROI
0% TAX
Pure Profit
5% TAX
The 5% "Profit Share" tax is returned 100% to the Community Pool to fund rewards for other active players.

The Safety Net (Maturity-Aware Rebates)

At the end of every season, any residual pool funds are automatically distributed as Rebates to players who ended in net loss. Crucially, this uses a Maturity-Aware calculation (20% Instant + 80% Linear 15-Day Drip) to determine each player's eligible loss — protecting Day 1 players from late-joiners claiming their share.

Late Joiners (e.g. Day 14) rely on the Carry-Over for their protection — their immature funds are moved to the next season. Only their mature portion competes for the current rebate, preventing "Rebate Sniping" by large late deposits.

Seasonal Finalization (Auto-Claim)

Forgetful? No problem. In the **final hour** of the season cooldown, the protocol triggers a **Seasonal Finalization**. All pending rewards in your unclaimed balance are automatically moved to your wallet balance, ensuring you never miss a payout.

7. Referral System

TreeFi incentivizes community growth through a transparent and automated Referral System. By inviting new players, you earn direct commissions from their activity, helping you grow your forest faster.

Chest Referral

When a user joins using your link and purchases a Mystery Chest, you receive a direct commission instantly into your rewards balance.

VIP & Utility

High-value referrals! Earn a massive **5% POL Commission** on all VIP Pass and Utility Item (Land Deeds, Catalysts, etc.) purchases made by your invited friends.

Security & Rules
  • Self-Referral Prevention: Users cannot refer themselves using multiple wallets.
  • Permanent Link: Once a user is referred by you, they are permanently linked to your account for all future activities.
  • Referral XP (25% Bonus): Referrers gain **25% of any XP** earned by their friends from Shop or Chest purchases.

8. Account Progression

TreeFi features a persistent **Account Progression** system that rewards long-term farmers with increased capacity and prestige.

Earning Experience (XP)

Grow your prestige through active farming:

  • Passive Farming: 1 XP per hour for every 10 Power (must be watered).
  • Referral Bonus: Earn 25% of any XP your friends earn.
  • Shop & Fusion: Large bursts of XP for buying items or merging trees.

Level Unlocks

Your account level determines your **Utility Slot Capacity**. All players start with 1 slot. Every **5 Levels**, an additional slot is unlocked automatically (up to 8 total).

9. Identity & Customization

Your legacy in TreeFi is personal. We've moved beyond hexadecimal addresses to allow players to express their unique identity within the forest.

Unique Usernames

Claim your name! Every player can set a Unique Username (3-20 characters) that replaces their wallet address on the Leaderboard and in the global site header.

Tree Avatars

Represent your best assets. You can choose any tree image from your owned collection to serve as your profile photo, visible to all other pioneers.

Prestige VIP Pass

The **Prestige VIP Pass** is the ultimate status symbol in TreeFi. It grants you 30 days of exclusive visual perks while directly supporting the game economy.

Golden Identity

Stand out with a **Golden Glowing Name** and a crown icon on the global leaderboard. Show the world you're a top-tier pioneer.

Custom Effects

Unlock dynamic animations including **Rainbow**, **Fire**, and **Pulse** effects for your profile row to command attention.

Premium Badge

Receive an exclusive **VIP Badge** on your profile and next to your name site-wide, certifying your elite status in the forest.

Membership lasts 30 days and can be extended at any time from the Shop.