Tron Whale Hub

Tron Whale Hub (TWH)

Official whitepaper for the TWH token — a community-focused TRC-20 asset on the TRON blockchain with transparent on-chain sell-tax mechanics.

Abstract

Tron Whale Hub (TWH) is a TRC-20 token deployed on TRON mainnet with a fixed total supply of 10,000,000,000 tokens (6 decimal places). The protocol implements a transparent 10% sell tax on trades routed through registered SunSwap V2 liquidity pairs. Of each taxed sell, 5% is permanently burned and 5% is automatically swapped to USDT (TRC-20) and sent to the marketing vault wallet.

All tax logic, trading gates, and administrative controls are enforced entirely on-chain through an audited Solidity smart contract. This document describes the token design, economics, technical architecture, launch process, and associated risks.

1. Introduction

TRON is one of the largest blockchain networks by daily transaction volume, offering fast settlement and low fees relative to many alternatives. SunSwap V2 provides decentralized exchange (DEX) infrastructure compatible with the Uniswap V2 model, enabling TWH/USDT trading pairs.

TWH is designed as a community-oriented token with built-in deflationary pressure (burn on sell) and automated marketing vault funding (USDT conversion on sell). The contract prioritizes operational safety: sell transactions never revert due to swap failures, reentrancy is guarded, and slippage protection is configurable within hard-coded limits.

2. Tokenomics

Supply Distribution

The entire fixed supply is minted to the deployer address at contract creation. Allocation across treasury, liquidity, marketing, community, and team wallets is managed off-chain by the project team. Recommended operational practice is to segregate funds into role-specific wallets before public trading is enabled.

Tax Structure (Sell Only)

3. On-Chain Mechanics

3.1 Sell Tax Flow

When a non-excluded wallet sells TWH to a registered SunSwap V2 pair:

3.2 Swap Safety

• Swap execution is wrapped in try/catch — a failed swap never reverts the user's sell transaction.
• Default slippage tolerance is 5% (500 basis points), adjustable by owner up to a 20% hard cap.
• Auto-swap triggers when contract tax balance reaches swapTokensAtAmount (default: 100 TWH).
• Owner may call manualSwapTaxTokens() to force-swap regardless of threshold.

3.3 Trading Gate

At deployment, tradingEnabled is set to false. While disabled, transfers between non-excluded wallets are blocked. Excluded addresses (owner, contract, marketing wallet, router, dead address) may still transfer freely. This allows pre-launch wallet distribution and liquidity setup before public trading opens.

3.4 Pair Registration

The primary taxed pair is TWH/USDT on SunSwap V2. The owner calls registerMainPair() after liquidity exists. Additional pairs (e.g. TWH/WTRX) may be registered via registerPair() to prevent tax bypass through alternate routes.

3.5 Owner Controls

• setTradingEnabled(bool) — enable or disable public trading
• setMarketingWallet(address) — update USDT recipient
• setSwapEnabled(bool) — toggle auto-swap
• setSwapSlippageBps(uint256) — adjust slippage (max 20%)
• setSwapTokensAtAmount(uint256) — adjust auto-swap threshold
• setExcludedFromFee / setExcludedFromSellTax — manage exemptions
• transferOwnership / renounceOwnership — ownership management
• rescueERC20 / rescueTRX — recover mistakenly sent assets (not TWH itself)

4. Smart Contract

Security Features

• Reentrancy guard on external swap entry point
• Custom errors for gas-efficient reverts
• immutable router and USDT references
• One-time max router approval (Energy optimization)
• Sell tax constants are constant — not modifiable post-deploy
• Separate fee-exclusion and sell-tax-exclusion mappings

5. Launch Sequence

The recommended mainnet launch order enforced by the contract design:

1. Deploy token — contract live, full supply minted to deployer
2. Distribute tokens — split across treasury, LP, and marketing wallets (while trading disabled)
3. Add TWH/USDT liquidity on SunSwap V2
4. Call registerMainPair() — registers the SunSwap TWH/USDT pair for taxation
5. Call setTradingEnabled(true) — opens public trading

6. Security & Risks

Participants should understand the following risks before acquiring or trading TWH:

• Smart contract risk — despite careful design, all on-chain code carries inherent technical risk. A third-party audit is planned.
• Owner privileges — the owner can enable/disable trading, update the marketing wallet, register pairs, and adjust swap settings. Ownership renunciation is possible but irreversible.
• Market risk — cryptocurrency prices are volatile. Past performance does not guarantee future results.
• Regulatory risk — token regulations vary by jurisdiction. Users are responsible for compliance in their region.
• DEX liquidity risk — low liquidity may cause high slippage. The 10% sell tax further reduces received amounts on sells.
• Tax token perception — tokens with transfer taxes may be flagged by explorers or wallets until reputation is established.

7. Roadmap

8. Disclaimer

This whitepaper is for informational purposes only and does not constitute financial, legal, or investment advice. Tron Whale Hub (TWH) is a utility/community token. No promise of profit, return, or price appreciation is made or implied.

Cryptocurrency participation involves substantial risk, including the possible loss of all funds invested. Always conduct your own research (DYOR) and consult qualified professionals before making financial decisions.

Contract address: TSPBa4v3KvbBD9b42xSjrnsZm9Mq3c4oqZ
Contact: contact@project-twh.online
Website: project-twh.online