TAMAWEB DOCUMENTATION

Complete technical documentation for the $TAMA earning system, smart contracts, and gameplay mechanics

๐Ÿ“‹ Table of Contents

๐ŸŽฏ Project Overview

Game mechanics and core concepts

๐Ÿ’ฐ Earning System

Mathematical formulas for $TAMA rewards

๐Ÿ“Š Tokenomics

Supply distribution and burn mechanics

โšก Multipliers & Bonuses

Boost calculations and streak rewards

๐Ÿฆ Staking System

Compound interest and yield farming

๐Ÿ—ณ๏ธ Governance

DAO voting power calculations

๐Ÿ”ง API Reference

Smart contract functions

๐Ÿ›ก๏ธ Security

Audit reports and safety measures

๐ŸŽฏ Project Overview

Game Mechanics

TAMAWEB is a play-to-earn virtual pet game where players care for digital pets and earn $TAMA tokens through various activities. The earning system is designed with sophisticated mathematical models to ensure sustainable tokenomics and fair reward distribution.

Core Activities

Players earn $TAMA through: pet care actions, mini-game completions, daily login streaks, social interactions, and achievement unlocks.

Token Utility

๐Ÿ’Ž Primary Utility

  • Pet food and care items
  • Cosmetic upgrades
  • Game speed boosts
  • Premium features access

๐Ÿ›๏ธ Governance

  • Vote on game updates
  • Proposal submission
  • Community fund allocation
  • Parameter adjustments

๐Ÿ’ฐ DeFi Integration

  • Liquidity provision
  • Yield farming
  • Cross-chain bridging
  • DEX trading

๐Ÿ’ฐ $TAMA Earning System

Base Earning Formula

R = B ร— A ร— H ร— S ร— T ร— D

Where R = Total $TAMA Reward per Action

Pet Care Reward Calculation
Reward = BaseRate ร— (1 + HappinessBonus) ร— ActivityMultiplier ร— TimeDecay
BaseRate: 0.001 - 0.025 $TAMA per action
HappinessBonus: 0% - 50% based on pet happiness (0-100)
ActivityMultiplier: Varies by action type
TimeDecay: Prevents spam, resets every 300 seconds

Activity-Specific Multipliers

Activity Base Rate Multiplier Cooldown Max Daily
Feeding 0.008 $TAMA 1.0x 5 minutes 50 actions
Playing 0.012 $TAMA 1.2x 3 minutes 100 actions
Cleaning 0.006 $TAMA 0.8x 10 minutes 20 actions
Training 0.015 $TAMA 1.5x 15 minutes 30 actions
Mini-Games 0.020 $TAMA 2.0x 2 minutes 200 actions

Happiness Bonus Calculation

Happiness Impact on Rewards
HappinessMultiplier = 1 + (PetHappiness / 200)
Where PetHappiness โˆˆ [0, 100]
At 0 Happiness: 1.0x multiplier (no bonus)
At 50 Happiness: 1.25x multiplier (+25% bonus)
At 100 Happiness: 1.5x multiplier (+50% bonus)

Time Decay Anti-Spam Mechanism

Reward Decay Over Time
TimeDecay = max(0.1, 1 - (ActionCount / MaxActions)ยฒ)
ActionCount: Number of actions in current 5-minute window
MaxActions: 10 actions per 5-minute period
Minimum Multiplier: 0.1x (10% of base reward)

โš ๏ธ Anti-Bot Protection

The system implements multiple layers of bot protection including: action timing analysis, pattern recognition, CAPTCHA verification for high-frequency users, and wallet behavior analysis.

๐Ÿ“Š Advanced Tokenomics

Supply Distribution

Total Supply = 1,000,000,000 $TAMA

๐ŸŽฎ Play-to-Earn Pool (20%)

200,000,000 $TAMA

Distributed over 3 years with decreasing emission rates

๐Ÿ’ง Liquidity Pool (70%)

700,000,000 $TAMA

Massive liquidity on Jupiter and Raydium DEXs

๐Ÿ› ๏ธ Development (5%)

50,000,000 $TAMA

Vested over 2 years for continued development

๐Ÿ“ข Marketing (5%)

50,000,000 $TAMA

Community incentives and partnerships

Emission Schedule

Daily Emission Calculation
DailyEmission = InitialRate ร— (0.985)^DayNumber
InitialRate: 300,000 $TAMA per day
Decay Rate: 1.5% reduction daily
Half-life: ~46 days
Total Distribution Period: 3 years

Burn Mechanisms

Transaction Burn Formula
BurnAmount = TransactionValue ร— BurnRate ร— DemandMultiplier
BurnRate: 2% of all in-game purchases
DemandMultiplier: 1.0x - 3.0x based on trading volume
Monthly Burns: Community vote on additional burns

๐Ÿ”ฅ Deflationary Pressure

With 70% in liquidity providing massive stability, the burn rate is designed to exceed emission rate after 12 months, creating net deflationary pressure while maintaining deep liquidity.

โšก Multipliers & Bonus Systems

Daily Login Streak Multiplier

Streak Bonus Calculation
StreakMultiplier = 1 + min(0.5, StreakDays ร— 0.02)
Day 1-7: +2% per day (max 14%)
Day 8-25: +2% per day (max 50%)
Day 25+: Capped at 50% bonus

Pet Level Bonus System

Pet Level XP Required Earning Bonus Special Abilities
1-10 100 ร— Levelยฒ 0% - 10% Basic care
11-25 200 ร— Levelยฒ 11% - 25% Mini-games unlocked
26-50 300 ร— Levelยฒ 26% - 50% Breeding available
51-100 500 ร— Levelยฒ 51% - 100% Master tier rewards

Achievement Multipliers

Achievement Bonus Stack
TotalBonus = โˆ(1 + AchievementBonus_i) - 1
Individual Bonuses: 5% - 25% per achievement
Maximum Stack: 200% total bonus
Rare Achievements: 50% - 100% bonus each

Social Activity Rewards

๐Ÿ‘ฅ Friend Referrals

5% of friend's earnings for 30 days

Friend gets 10% bonus for 7 days

๐ŸŽ‰ Community Events

2x - 5x multipliers during events

Limited time bonus periods

๐Ÿ† Leaderboards

Top 1%: 50% bonus

Top 10%: 25% bonus

Top 25%: 10% bonus

๐Ÿฆ Staking & Yield Farming

Basic Staking Formula

Compound Interest Calculation
FinalAmount = P ร— (1 + r/n)^(nร—t)
P: Principal amount staked
r: Annual interest rate (12% - 36%)
n: Compounding frequency (daily = 365)
t: Time in years

Staking Tiers & Rewards

Tier Minimum Stake APY Lock Period Bonus Rewards
Bronze 1,000 $TAMA 12% No lock None
Silver 10,000 $TAMA 18% 30 days 5% play bonus
Gold 50,000 $TAMA 24% 90 days 10% play bonus
Platinum 100,000 $TAMA 30% 180 days 15% play bonus
Diamond 500,000 $TAMA 36% 365 days 25% play bonus

Liquidity Pool Rewards

LP Token Yield Calculation
LP_Rewards = (UserLiquidity / TotalLiquidity) ร— DailyRewards ร— TimeStaked
UserLiquidity: User's share of the liquidity pool
TotalLiquidity: Total pool liquidity
DailyRewards: 50,000 $TAMA distributed daily
TimeStaked: Days providing liquidity

Impermanent Loss Protection

IL Compensation Formula
Compensation = max(0, IL_Amount ร— ProtectionRate ร— StakeDuration)
IL_Amount: Calculated impermanent loss
ProtectionRate: 50% - 100% based on stake duration
Full Protection: After 180 days of staking

๐Ÿ—ณ๏ธ DAO Governance System

Voting Power Calculation

Governance Weight Formula
VotingPower = โˆš(StakedTokens) ร— TimeBonusMultiplier ร— ActivityScore
StakedTokens: Amount of $TAMA staked for governance
TimeBonusMultiplier: 1.0x - 2.0x based on stake duration
ActivityScore: 0.5x - 1.5x based on game activity

Proposal Requirements

MinimumStake = 100,000 $TAMA

Required to submit governance proposals

Voting Thresholds

Proposal Type Quorum Required Approval Threshold Execution Delay
Parameter Changes 15% of supply 60% approval 48 hours
Treasury Allocation 25% of supply 65% approval 7 days
Smart Contract Upgrades 35% of supply 75% approval 14 days
Emergency Actions 10% of supply 80% approval Immediate

Reward Distribution for Voters

Voter Incentive Formula
VoterReward = (ParticipationReward / TotalVoters) ร— ConsistencyBonus
ParticipationReward: 10,000 $TAMA per proposal
ConsistencyBonus: 1.0x - 2.0x for regular voters
Minimum Stake: 1,000 $TAMA to receive rewards

๐Ÿ”ง Smart Contract API Reference

Core Contract Functions

// Earning Functions
function calculatePetCareReward(
    uint256 baseRate,
    uint256 happinessLevel,
    uint256 activityMultiplier,
    uint256 timeDecay
) external pure returns (uint256 reward);

function claimDailyReward(
    address user,
    uint256 streakDays
) external returns (uint256 amount);

// Staking Functions
function stakeTokens(
    uint256 amount,
    uint8 tier
) external returns (bool success);

function calculateStakeRewards(
    address staker
) external view returns (uint256 rewards);

// Governance Functions
function submitProposal(
    string memory title,
    string memory description,
    bytes memory callData
) external returns (uint256 proposalId);

function vote(
    uint256 proposalId,
    bool support
) external returns (bool success);
                

Event Signatures

event PetCareReward(
    address indexed user,
    uint256 amount,
    uint8 activityType,
    uint256 timestamp
);

event StakeCreated(
    address indexed staker,
    uint256 amount,
    uint8 tier,
    uint256 unlockTime
);

event ProposalCreated(
    uint256 indexed proposalId,
    address indexed proposer,
    string title
);

event VoteCast(
    uint256 indexed proposalId,
    address indexed voter,
    bool support,
    uint256 votingPower
);
                

Error Codes

Error Code Description Resolution
ERR_001 Insufficient balance Check token balance before transaction
ERR_002 Cooldown active Wait for cooldown period to expire
ERR_003 Invalid pet state Ensure pet is alive and healthy
ERR_004 Staking period not ended Wait for lock period to complete
ERR_005 Proposal already voted Cannot vote twice on same proposal

Integration Examples

// JavaScript Web3 Integration
const contract = new web3.eth.Contract(ABI, CONTRACT_ADDRESS);

// Claim rewards example
async function claimRewards() {
    try {
        const tx = await contract.methods
            .claimDailyReward(userAddress, streakDays)
            .send({ from: userAddress });
        
        console.log('Rewards claimed:', tx.transactionHash);
    } catch (error) {
        console.error('Claim failed:', error.message);
    }
}

// Check staking rewards
async function getStakeRewards(userAddress) {
    const rewards = await contract.methods
        .calculateStakeRewards(userAddress)
        .call();
    
    return web3.utils.fromWei(rewards, 'ether');
}
                

๐Ÿ›ก๏ธ Security & Audit Information

Smart Contract Security

๐Ÿ” Audit Status

Smart contracts have been audited by CertiK and Quantstamp. All critical and high-severity issues have been resolved.

Security Measures

๐Ÿ” Multi-Signature Wallet

Treasury funds secured with 4-of-7 multi-sig

No single point of failure for fund management

โฐ Time Locks

All parameter changes have mandatory delays

Community has time to review and react

๐Ÿค– Anti-Bot Protection

Advanced pattern recognition algorithms

Rate limiting and behavioral analysis

๐Ÿ”„ Upgradability

Proxy pattern for critical bug fixes

Community governance required for upgrades

Risk Mitigation

Maximum Daily Risk Exposure
MaxRisk = min(DailyEmission ร— 0.1, TreasuryBalance ร— 0.05)
Daily Emission Limit: 10% of scheduled emission
Treasury Limit: 5% of total treasury
Emergency Pause: Available for critical issues

Bug Bounty Program

Severity Reward Range Description
Critical $50,000 - $100,000 Fund drainage, complete system compromise
High $10,000 - $50,000 Significant fund loss, governance bypass
Medium $1,000 - $10,000 Logic errors, reward manipulation
Low $100 - $1,000 Minor issues, optimization opportunities

โš ๏ธ Responsible Disclosure

Please report security vulnerabilities through our private disclosure program. Public disclosure before fixes are implemented may disqualify you from bounty rewards.

๐Ÿ“š Additional Resources

๐Ÿ“ง Contact Information

Technical Support: tech@tamaweb.xyz

Security Issues: security@tamaweb.xyz

Partnerships: partners@tamaweb.xyz

General Inquiries: hello@tamaweb.xyz

๐Ÿ“Š Analytics & Tracking

  • DexScreener: Real-time price data
  • CoinGecko: Market statistics
  • Solscan: Transaction explorer
  • DefiLlama: TVL tracking

๐Ÿ›๏ธ Governance Platform

Participate in DAO governance through our decentralized voting platform. Stake $TAMA tokens to gain voting power and help shape the future of TAMAWEB.

๐Ÿ“‹ Changelog

v1.2.0 (May 24, 2025): Enhanced earning formulas, new staking tiers, governance improvements

v1.1.5 (May 10, 2025): Bug fixes, optimized gas usage, anti-bot enhancements

v1.1.0 (April 28, 2025): Staking system launch, liquidity mining program

v1.0.0 (April 15, 2025): Initial mainnet deployment, basic earning system