Presale Contract Functions Documentation

Immutable, secure, referral-based presale with automated PancakeSwap V2 liquidity deployment on Binance Smart Chain.

Presale Contract Address

0x27D9C6482A2c7A6aC9533F8da876Befe1B4B216B

Public / External Functions

contribute(address _referrer) – payable

Purpose: Buy presale tokens by sending BNB What it does:

• Accepts BNB from user (minimum 0.002 BNB, maximum 20 BNB per wallet)

• Registers user exactly once

• Assigns the provided _referrer as their upline

• Instantly distributes referral rewards:

  • 10% → Level 1 referrer

  • 5% → Level 2 referrer

  • 5% → Level 3 referrer

• If _referrer is the official marketing wallet → marketing gets full 20% instantly (no L2/L3 split)

• Increases totalRaised

Why: One-click purchase with instant multi-level referral payout

---

receive() – payable fallback

Purpose: Allow direct BNB sends to contract What it does: Automatically calls contribute(MARKETING_WALLET) Why: Users can just send BNB directly → they get tokens and marketing wallet earns the full 20% referral reward

---

withdraw() – external

Purpose: Let users cancel their contribution before liquidity is added What it does:

• Refunds 80% of contributed BNB

• 20% Early Withdraw Penalty Applied

• Reduces totalRaised accordingly

• Can only be used before pool creation

Why: Fair exit option with penalty to discourage exploits and boost marketing by redirecting penalty to referral rewards and marketing wallet

---

claimTokens() – external

Purpose: Claim your purchased GemHunt tokens after liquidity pool is created What it does:

• Calculates tokens owed: contribution × 800,000 tokens per BNB

• Transfers exact amount from contract to user

• Prevents double-claiming

Why: Final token distribution step after fair launch

---

finalizeAndCreatePool() – onlyOwner

Purpose: Owner finalizes presale and adds liquidity to PancakeSwap What it does:

• Takes exactly 50% of raised BNB + 200M GemHunt tokens

• Calls PancakeSwap addLiquidityETH()

• Sends ALL LP tokens to dead address (permanent burn)

• Marks presale as finalized

• Can retry up to 3 times if router temporarily fails

Why: Guaranteed fair launch – no LP rug possible

---

---

claimDevFee() – onlyOwner

Purpose: Claim 30% development/marketing fee What it does:

• Transfers 30% of totalRaised to owner

Why: Fund development, marketing, audits, CEX listings

---

---

withdrawRemainingETH() – onlyOwner

Purpose: Sweep any dust BNB left after launch Why: Clean up contract balance

---

recoverWrongTokens(address _token) – onlyOwner

Purpose: Recover any ERC20 accidentally sent to contract What it does: Transfers tokens to owner (cannot recover the presale token itself) Why: Standard safety function

---

Key View Functions

Function	Returns	Use Case
getTokenAllocation(address)	How many tokens a user can claim	Show user balance
getUserInfo(address)	Full user data (contributed, earned, referrer, etc.)	Dashboard display
getReferralChain(address)	L1 → L2 → L3 referrers	Show referral tree
getDirectReferrals(address)	Array of all people you directly referred	Referral leaderboard
getPresaleStats()	Total raised, remaining to hard cap, tokens sold	Progress bar
getBNBDistribution()	How much BNB goes to LP / dev / referrals	Transparency page
canClaimDevFee()	true if dev fee is ready to be claimed	Owner panel
canFinalizePool()	true if presale can be launched	Finalize button enable

---

Constants Summary

Name	Value	Meaning
Tokens per BNB	800,000 GEM	Presale price
Presale allocation	800M GEM	Sold to users
Liquidity allocation	200M GEM	Added to PancakeSwap
Hard cap	1000 BNB	Maximum raise
Min / Max buy	0.002 – 20 BNB	Per wallet limits
Liquidity	50% of raised	Burned
Dev/Marketing fee	30% of raised	Claimable
Referral rewards	10% + 5% + 5%	Instant payout
Marketing direct reward	20%	When marketing wallet is used as referrer
Early withdraw penalty	20%	Discourages Exploits

No ownership renouncement needed — ownership is only used for finalization and fee claim (standard practice).