governance

twitter

website

Stablecoin issuers

Tron USDD

# Tron USDD Outstanding supply Methodology

## 1. Overview

The TRON USDD outstanding supply metric measures the total circulating supply of USDD (TrueUSD on TRON) tokens by tracking cumulative mint and redemption events over time. This metric answers the business question "How many USDD tokens are currently in circulation on the TRON network?" The calculation uses a net flow approach, starting from zero and adding mints while subtracting redemptions to maintain a running total of outstanding tokens.

## 2. Data sources

- **TRON blockchain events**: Parsed `USDD_Deposit_event` logs representing token minting operations and `USDD_Withdrawal_event` logs representing token redemption operations
- **Event metadata**: Transaction hashes, block timestamps, log indices, and contract addresses from TRON blockchain transactions
- **External data**: End-of-day token price feeds for USD conversion of supply values

## 3. Step-by-step calculation

### Component A: USDD mint tracking
- **Purpose**: Captures all USDD token creation events on TRON
- **Logic**: Extracts parsed `USDD_Deposit_event` logs from TRON blockchain, filtering out removed events to ensure data quality. Each deposit event represents new USDD tokens being minted into circulation. The `sad` field contains the mint amount with 6 decimal precision, which is normalized by dividing by 1,000,000 to get the actual token amount
- **Key fields**: `block_timestamp` for timing, `transaction_hash` and `log_index` for unique identification, `address` as the token contract address, and `sad` as the mint amount

### Component B: USDD redemption tracking  
- **Purpose**: Captures all USDD token destruction events on TRON
- **Logic**: Extracts parsed `USDD_Withdrawal_event` logs from TRON blockchain, filtering out removed events. Each withdrawal event represents USDD tokens being redeemed and removed from circulation. The `sad` field contains the redemption amount with 6 decimal precision, normalized the same way as mints but with negative sign to represent supply reduction
- **Key fields**: `block_timestamp` for timing, `transaction_hash` and `log_index` for unique identification, `address` as the token contract address, and `sad` as the redemption amount

### Component C: Daily net flow aggregation
- **Purpose**: Combines mints and redemptions into daily net supply changes
- **Logic**: Unions mint events (positive amounts) with redemption events (negative amounts) into a single dataset. Truncates timestamps to day boundaries and groups by date, chain, and token address. Sums all mint and redemption amounts within each day to calculate net daily supply change
- **Key fields**: `timestamp` truncated to day, `chain_id` as 'tron', `token_address` for the USDD contract, and `amount` as the net daily change

### Component D: Cumulative supply calculation
- **Purpose**: Calculates running total of outstanding USDD supply over time
- **Logic**: Uses a window function with sum aggregation partitioned by chain and token address, ordered by timestamp. This creates a cumulative sum where each day's outstanding supply equals the previous day's supply plus the net daily change. Starting from zero, positive net flows increase supply while negative flows decrease it
- **Key fields**: `outstanding_supply` as the cumulative running total

### Component E: Time series continuity
- **Purpose**: Ensures continuous daily time series without gaps
- **Logic**: Applies forward-fill logic to populate missing dates between the first and last observed events. For any missing date, the previous day's outstanding supply value is carried forward, ensuring the metric shows consistent supply levels even on days without mint or redemption activity
- **Key fields**: Maintained `outstanding_supply` values across all dates in the range

### Final aggregation
- **Combining components**: The intermediate model produces a complete daily time series of outstanding supply values
- **Currency conversion**: USD conversion is applied using end-of-day price feeds through the conversion macro, multiplying token amounts by daily USD prices
- **Time aggregation**: Data is aggregated at daily boundaries using timestamp truncation to day level
- **Final calculation**: The final outstanding supply represents the cumulative sum of all historical net USDD mint and redemption flows, converted to USD value and formatted according to standard metric schema requirements

*This methodology was automatically generated by Token Terminal's methodology analyzer.*

Circulating supply of stablecoins issued by the project.

Tron USDD

Outstanding supply

Outstanding supply

Competitive landscape

Chain breakdown