TECHNICAL WHITEPAPER v1.0

WHITE PAPER

Complete technical documentation of the Feline Dynasty ecosystem — tokenomics, game mechanics, breeding genetics, DeFi systems, and economic sustainability on the TON blockchain.

download Download PDF (EN) download Download PDF (IT)

19 Chapters

TRIPLE Economy

14 Languages

TON Blockchain

01. Executive Summary 02. Architecture Overview 03. Triple-Token Economy 04. NFT Cat System 05. Habitat System 06. Breeding & Genetics 07. Fusion Lab 08. Cat Synth Lab 09. DeFi Center 10. Arena PvP System 11. Guild System & Wars 12. Engagement Systems 13. Marketplace & Auctions 14. Referral Program 15. Treasury & Blockchain 16. Security Architecture 17. Economic Sustainability 18. Roadmap 19. Conclusion

01.

Executive Summary

Feline Dynasty is an idle breeding Play-to-Earn (P2E) game operating as a Telegram Mini App on the TON Blockchain. Players collect, breed, and evolve unique geometric cat NFTs, each producing in-game currency passively. The game features a triple-token economy designed for long-term sustainability, a comprehensive DeFi center, guild-based territory wars, and PvP arena battles.

check_circle5 NFT rarity tiers with increasing production rates

check_circle20-level habitat progression with cosmetic rewards

check_circleMulti-tier DeFi staking with dynamic APY

check_circleMulti-level referral commission structure

check_circle14 languages supported natively

check_circleMulti-oracle pricing for reliable market data

check_circleAutomated + manual withdrawal with treasury protection

02.

Architecture Overview

Technical Stack

Layer	Technology
Frontend	React + TypeScript, Tailwind CSS, Shadcn UI
Backend	Express.js + TypeScript (Cloudflare Functions)
Database	PostgreSQL (Neon) with Drizzle ORM
Blockchain	TON (The Open Network)
Hosting	Cloudflare Pages + Functions + KV
Connection Pooling	Cloudflare Hyperdrive
Wallet Integration	TON Connect with cryptographic proof verification
Real-time	WebSocket with polling fallback

Infrastructure

The system is deployed on Cloudflare's global edge network, ensuring low latency worldwide. The database uses Neon's serverless PostgreSQL with connection pooling through Cloudflare Hyperdrive for optimal performance under load. Smart contracts are deployed on the TON blockchain using FunC, handling deposit/withdrawal operations with multi-signature security.

03.

Triple-Token Economy

The Feline Dynasty ecosystem utilizes a sophisticated three-token architecture designed to maintain equilibrium between inflationary utility and deflationary governance.

bolt

EF

Essenza Felina: Passive cat production, upgrades, in-game purchases.

Utility Token

token

FTON

Feline Token: Cat purchases, marketplace, premium features.

Premium Token

workspace_premium

FGOLD

Feline Gold: Staking, withdrawal to TON, premium operations.

Withdrawable

// Token Flow Cat Production --> EF (passive hourly) | v EF Conversion --> FTON + FGOLD | | v v Marketplace Withdrawal (TON) Cosmetics Staking Upgrades Burning

Dynamic FGOLD Allocation

FGOLD_Share(t) = α(t) * EF_converted where α(t) = f(Active_Users, Treasury_Health) α ∈ [α_min, α_max], monotonically increasing with user base

Fee Structure

Net_Revenue = Σ(Transaction_i * Fee_Rate_i) for i ∈ {deposits, withdrawals, marketplace, auctions, breeding, fusion} // Token Equilibrium condition: Total_Sinks ≥ Total_Emissions * (1 + Safety_Margin)

04.

NFT Cat System

Rarity Tiers

Rarity	Cat Type	Description
Common	Kitten	Entry-level, accessible to all players
Uncommon	Hunter	Enhanced production, breeding potential
Rare	Guardian	Significant output, genetic diversity
Epic	Emperor	High-value producer, rare genetics
Legendary	Divine	Maximum production, premium genetics

Production Formula

P_eff(cat) = R_base(rarity) * M_habitat(level) * (1 + B_genetics) * (1 + B_achievement) * A_ability where: R_base = base production rate (tier-specific constant, EF/h) M_habitat = habitat multiplier function, M: [1..20] → [1.0, M_max] B_genetics = Σ(trait_bonus_i) for i ∈ {eye, fur, body, ear, tail, pattern} B_achievement = Σ(milestone_bonus_j) for completed achievements j A_ability = special ability multiplier ≥ 1.0

Accumulation System

Cap(level) = C_base + (level * C_increment) Overflow_Zone = Cap * κ, where κ > 1 Production_Rate = { P_eff if accumulated < Cap P_eff * δ if Cap ≤ accumulated < Overflow_Zone (δ < 1) 0 if accumulated ≥ Overflow_Zone }

05.

Habitat Evolution

The habitat is a 20-level progression system that directly impacts EF production through multiplier bonuses. Players upgrade their habitat through 20 unique levels, from "Basic Shelter" to "Genesis".

MAX

Base Tier (Novice) Imperial Tier (Grandmaster)

Habitat Multiplier Growth

M_habitat(n) = 1 + Σ(Δ_i) for i = 2..n where Δ_i follows a diminishing returns curve: Δ_i = Δ_base * (1 - e^(-λ*i)) / i^γ Upgrade_Cost(n) = C_1 * n^β * e^(μ*n) // exponential-polynomial hybrid ensuring late-game scarcity

Endgame Cosmetic Rewards (Levels 11-20)

BadgesProfile display

AurasVisual effects

FramesProfile frames

BackgroundsHabitat decor

PedestalsCat display

06.

Breeding & Genetics

Offspring Rarity Determination

R_offspring = floor((R_parent1 + R_parent2) / 2) + Mutation(p) where Mutation(p) = { +1 with probability p_mutation 0 with probability (1 - p_mutation) } p_mutation = p_base + (generation * Δ_gen)

Allele Inheritance Model

The game implements a Mendelian inheritance model with 7 trait categories: Eye Color, Fur Pattern, Fur Color, Body Shape, Ear Type, Tail Type, and Special Ability.

For each trait T: Allele_pool = {P1_dom(w₁), P1_rec(w₂), P2_dom(w₃), P2_rec(w₄)} where w₁ + w₂ + w₃ + w₄ = 1.0 Selected_allele = weighted_random(Allele_pool) if random() < p_mutation(generation): Selected_allele = mutate(Selected_allele, direction)

Genetic Production Bonuses

B_genetics_total = Σ(TRAIT_BONUS[rarity(trait_i)]) for i ∈ all_traits P_final = P_base * (1 + B_genetics_total) * ABILITY_MULTIPLIER[ability_type]

07.

Fusion Lab

The Fusion Lab allows players to combine multiple cats of identical type and rarity to create a higher-rarity cat.

P(success) = P_base * Quality_Factor(input_cats) On Success: Output = Cat(rarity + 1, random_genetics(rarity + 1)) On Failure: Lost = N - 1 cats Survivor receives permanent +σ% production bonus

Rarity Progression

Common → Uncommon → Rare → Epic → Legendary

08.

Cat Synth Lab

The Synth Lab is a guild-collaborative crafting system for advanced cat modifications.

speed

Production Enhancement

Boost cat output

auto_awesome

Rarity Enhancement

Chance to upgrade rarity

genetics

Trait Fusion

Combine best genetic traits

09.

DeFi Center

Staking

Mining

Lending

Dynamic APY Staking

APY_actual(tier, t) = APY_base(tier) * H(t) where H(t) = Treasury Health Multiplier: H(t) = { 1.0 if Reserve_Ratio > θ_healthy (Reserve_Ratio - θ_critical) / (θ_healthy - θ_critical) if θ_critical < Reserve_Ratio ≤ θ_healthy H_min if Reserve_Ratio ≤ θ_critical } Safety Constraint: TVL_staking ≤ τ_hard * Treasury_Total

Mining (Emission Control)

EF_daily(user) = FTON_committed * R_base * M_lock(duration) Global Emission Cap: Σ(EF_daily(all_miners)) ≤ Total_EF_Supply * ε_daily

NFT Lending

Loan_Amount(cat) = Collateral_Value(rarity) * LTV_ratio Interest = Principal * r_flat (fixed rate, fixed term) Liquidation triggered if: - LTV exceeds LTV_max, OR - Loan term expires without repayment → NFT transferred to lending pool

10.

Arena PvP System

ELO Rating System

R_new = R_current + K * (S - E) where: K = adjustment constant (asymmetric: K_win > K_loss) S = actual outcome (1 = win, 0 = loss) E = expected outcome = 1 / (1 + 10^((R_opponent - R_current) / 400)) Matchmaking constraint: |R_player - R_opponent| ≤ Δ_max

Battle Rewards & Equipment

Equipment_Drop = Bernoulli(p_drop) Rarity_Distribution = Categorical(p_common, p_uncommon, p_rare, p_epic, p_legendary) where Σ(p_i) = 1.0 and p_i decreases with rarity Stat_Bonus(slot, rarity) = f(fighter_level, rarity_tier) for slot ∈ {weapon, armor, helmet, accessory}

11.

Guild System & Wars

Territory Conquest

Territory_Value(t) = Base_Bonus * Decay_Function(t) Decay_Function(t) = { 1.0 if t_inactive ≤ T_grace max(D_min, 1.0 - ρ * (t_inactive - T_grace)) if t_inactive > T_grace } Attack_Power = Σ(EF_contributed_by_members) / η

Dual Treasury Architecture

Treasury	Purpose
Game Treasury	Player deposits/withdrawals
Guild Treasury	Guild operations, war funding

12.

Engagement Systems

casino

Daily Roulette

Weighted prize wheel with tokens and rare cats

local_fire_department

Daily Streak

Consecutive login rewards with escalating bonuses

treasure_chest

Treasure Hunt

30-day progressive reward cycle

task_alt

Mission System

Social and partner missions for community engagement

military_tech

Achievements

Milestone-based permanent EF production boosts

emoji_events

Competitions

Periodic leaderboard events with FGOLD prize pools

13.

Marketplace & Auctions

P2P Marketplace

Direct cat trading between players with platform fees on sales. Prices set by sellers in FTON.

Auction System

Time-limited bidding with minimum bid increments. Anti-wash-trading detection prevents market manipulation through behavioral analysis.

14.

Referral Program

The Multi-Tier Bloom

Referral rewards cascade through the dynasty tree. As nodes grow further from the origin, connection strength decreases but total volume potential increases.

Anti-abuse protections include:

shieldCircular referral loop detection
shieldSelf-farming prevention via device analysis
shieldMinimum distribution thresholds

person

15.

Treasury & Blockchain

contract

Smart Contracts

FunC on TON mainnet with multi-signature security

monitoring

Multi-Oracle Pricing

5-oracle cascade for reliable TON/USD pricing

account_balance_wallet

USDT Deposits

Native TON + USDT Jetton transfers supported

swap_vert

Withdrawal System

Automated below threshold, manual approval for larger amounts. Lifetime cap relative to deposits.

shield

Treasury Protection

Absolute floor mechanism blocks all withdrawals below critical reserve threshold.

16.

Security Architecture

Authentication Layers

Telegram initData Validation

Cryptographic verification with expiry protection

Session Tokens

Signed tokens with timing-safe comparison

Wallet Proof Verification

Cryptographic signature validation of wallet ownership

Anti-Abuse System

Detection	Method
Multi-Account	Device fingerprinting + behavioral analysis
Bot Detection	Timing pattern analysis, speed anomaly
Wash Trading	Buyer/seller correlation analysis
Referral Abuse	Loop detection, self-farming prevention
Exploit Detection	Rate anomaly detection on economic ops

17.

Economic Sustainability

Inflation Control

dS/dt = Emissions(t) - Sinks(t) - Burns(t) where: Emissions(t) = Mining_Output(t) + Staking_Rewards(t) + Game_Rewards(t) Sinks(t) = Σ(Fee_i * Volume_i) for all fee-bearing operations Burns(t) = Breeding_Burns + Fusion_Burns + Synth_Burns + Cosmetic_Burns // Stability condition: dS/dt ≤ 0 (net deflationary or neutral)

Growth Zone

Supply emission exceeds burn. Permitted during early phases to establish player base.

Imperial Zone

Perfect equilibrium (1:1 burn-to-mint ratio). Our primary long-term target.

Scarcity Zone

Hyper-deflationary pressure. Triggered when circulating supply exceeds protocol caps.

Treasury Health System

H(t) = Treasury_Balance(t) / Total_Liability(t) Adaptive Response Function: APY_multiplier = g₁(H) ∈ [H_min_mult, 1.0] Emission_rate = g₂(H) ∈ [ε_min, ε_max] Fee_multiplier = g₃(H) ∈ [1.0, F_max] Withdrawal_speed = g₄(H) ∈ [0, W_max_daily] Emergency Protocol: if H(t) < θ_floor: Withdrawal_speed = 0 // absolute floor protection

18.

Roadmap

PHASE 1 Launch & Core COMPLETED

Triple-Token Economy, NFT Cats, 20-Level Habitat, Breeding + Fusion + Genetics, DeFi Center, Arena PvP, Marketplace, 14 Languages

PHASE 2 Growth COMPLETED

Advanced Security, Cosmetics Shop, Achievement System, Landing Page, Daily Streak & Treasure Hunt

PHASE 3 Expansion IN PROGRESS

Guild Wars & Territory Control, NFT On-Chain Minting, Competition System, Cat Synth Lab (Done), Partner Games

PHASE 4 Dynasty Universe FUTURE

2D PC Adventure Game, Cross-Platform Sync, Multi-Level World with NPCs, NFT Cats as companions

19.

Conclusion

Feline Dynasty represents a new paradigm in blockchain gaming: a sustainable, community-driven economy built on the TON blockchain. Through its triple-token model, dynamic treasury management, and multi-layered security architecture, the project is designed for long-term viability rather than short-term speculation.

01Triple-token separation prevents single-point economic failure

02Dynamic economic controls adapt to market conditions in real-time

03Multi-oracle pricing eliminates manipulation risks

04Production-grade security with cryptographic verification at every layer

0514-language support for true global accessibility

Disclaimer: This whitepaper is for informational purposes only. It does not constitute financial advice. Token values and game mechanics are subject to change based on economic conditions and development priorities. Always do your own research before participating in any blockchain-based project.

pets

Start Your Dynasty Today

The whitepaper is just the beginning. Join the feline revolution on TON and claim your territory.

Play on Telegram Join the Community