> For the complete documentation index, see [llms.txt](https://smart-global.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smart-global.gitbook.io/docs/smart-contracts/smart-global-token.md).

# 🪙 Smart Global Token

## SmartGlobalToken Overview

### 1. Introduction & Tokenomics

The `SmartGlobalToken` (`SGT`) smart contract is the native token of the Smart Global ecosystem, deployed on the BNB Smart Chain using OpenZeppelin ERC-20 standard libraries.

The token supply is fixed at 20,000,000 units. No minting functions are implemented in the contract code, making the total supply permanent and immutable.

| **Parameter**         | **Value**                  | **Technical Description**                                     |
| --------------------- | -------------------------- | ------------------------------------------------------------- |
| Contract Standard     | BEP-20 (ERC-20 compatible) | Official token identifier across network explorers            |
| Ticker Symbol         | `SGT`                      | Trading symbol on decentralized exchanges (e.g., PancakeSwap) |
| Decimals              | 18                         | Precision unit for micro-calculations                         |
| Max Supply            | 20,000,000 `SGT`           | Fixed supply with no minting function                         |
| DEX Trading Tax       | 5% (Fixed)                 | Automated tax applied to PancakeSwap pool buys and sells      |
| Standard Transfer Tax | 0%                         | Wallet-to-wallet transfers incur no protocol tax              |

### 2. Tax & Trading Logic

The tax mechanism of the `SGT` token is managed according to the following operational parameters:

* Standard Transfers: Direct wallet-to-wallet transfers among members, deposits into ecosystem governance contracts (such as the central bank or fee treasury), and reward distributions incur a 0% tax rate.
* DEX Trading Tax: A 5% tax is automatically deducted by the smart contract strictly when users purchase tokens from, or sell tokens into, the PancakeSwap liquidity pool (`pancakePair`).
* Tax Allocation: All deducted tax revenue is routed to the designated tax treasury address (`taxWallet`) to support ecosystem reward pools, liquidity, and project development.

### 3. Security Parameters & Structural Locks

The `SmartGlobalToken` source code implements four immutable structural locks:

1. Fixed Tax Rate: The 5% tax rate is defined as a constant variable (`uint256 public constant taxFee = 5;`). The contract contains no function to alter or increase this rate.
2. Permanent Trading Lock: Trading is initially paused. Upon executing the `enableTrading` function, the trading boolean permanently updates to `True`. The contract contains no function to disable trading once enabled.
3. Minimum Transaction Limit Lock: The contract permits setting a maximum transaction limit (`maxTxAmount`). However, a hardcoded condition prevents setting this limit below the `minTxLimit` threshold of 100,000 tokens.
4. One-Time Tax Wallet Lock: The `setTaxWallet` configuration function can be executed strictly once. Following initial execution, the address variable is permanently locked.

### 4. Decentralization & Governance

The contract inherits OpenZeppelin's `Ownable` pattern for initial administration (configuring the exchange pool, setting the tax wallet, and enabling trading).

Following the initial setup, ownership can be transferred to a Decentralized Autonomous Organization (DAO) via `transferOwnership` or permanently renounced via `renounceOwnership`.

### 5. Technical Documentation Guide

The documentation for the `SmartGlobalToken` contract is organized into the following categories:

* Operational Functions: Detailed technical analysis of the 4 standard ERC-20 functions: `transfer`, `approve`, `transferFrom`, and allowance adjustments.
* Administrative Functions: Technical reference for administrative utilities: one-time tax wallet setup, PancakeSwap pool initialization, trading enablement, transaction limit management, and ownership transfer/renunciation.
