> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allium.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Supply Change

> Mint and burn events that change a stablecoin's on-chain total supply on Cosmos SDK chains.

The Stablecoins Supply Change table records every bank-module event that increases (mint) or decreases (burn) the on-chain total supply of a tracked stablecoin. Rows are the `coinbase` and `burn` events from the chain's fungible token transfers, joined to Allium's stablecoin registry.

### Table Columns

| Column Name | Description |
| - | - |
| from\_address | Sender side of the supply change: the burner address for burns, or the placeholder `0x` for mints. |
| to\_address | Receiving side of the supply change: the minter address for mints, or the placeholder `0x` for burns. |
| currency | Bank denom of the stablecoin (on Injective, e.g. `peggy0x...`, `ibc/...` or `factory/...`). In this table `currency` is the token denom, not the fiat peg; see `stablecoin_currency`. |
| token\_name | Name of the stablecoin, from the chain's fungible token metadata. |
| token\_symbol | Symbol of the stablecoin, from the chain's fungible token metadata. |
| raw\_amount\_str | Mint or burn amount in the token's smallest unit, as a string to retain full precision. |
| raw\_amount | Mint or burn amount in the token's smallest unit (not decimal-adjusted). |
| usd\_amount | Mint or burn amount valued in USD at the hourly token price at the time of the event. |
| usd\_exchange\_rate | Hourly USD price of the token at the time of the event, used to compute `usd_amount`. |
| event\_type | Bank-module event that changed supply: `coinbase` for mints or `burn` for burns. |
| tx\_sender | The address that initiated the transaction. |
| transaction\_hash | The hash of the transaction containing this supply change. |
| transaction\_index | The index of the transaction within the block. |
| event\_index | The index of the event within the transaction. |
| block\_timestamp | Timestamp of the block containing this supply change. |
| block\_height | The height of the block containing this supply change. |
| block\_hash | The hash of the block containing this supply change. |
| block\_event\_kind | The phase in which the block event was emitted: begin (before transactions are processed), end (after all transactions are processed) or finalize (immediately before block commit). Null for transaction events. |
| block\_event\_index | The index of the block event. Null for transaction events. |
| block\_event\_type | The type of the block event. Null for transaction events. |
| code | The transaction result code (0 indicates success). |
| tx\_success | Whether the transaction was successful. |
| authz\_msg\_index | The index of the authorized message within an authz grant execution. |
| memo | Memo of an IBC transfer. Always null in this table, since mint and burn events carry no memo. |
| src\_channel | Source IBC channel for cross-chain transfers. Always null in this table, since mint and burn events have no IBC channel. |
| dst\_channel | Destination IBC channel for cross-chain transfers. Always null in this table, since mint and burn events have no IBC channel. |
| unique\_id | Unique identifier for the supply change event, inherited from the underlying fungible token transfer. |
| amount\_str | Mint or burn amount normalized by token decimals, as a string to retain precision. Falls back to the stablecoin registry's decimals when the token has no fungible token metadata. |
| amount | Mint or burn amount normalized by token decimals. Falls back to the stablecoin registry's decimals when the token has no fungible token metadata. |
| token\_address | Bank denom of the stablecoin, the same value as `currency` (on Injective, e.g. `peggy0x...`, `ibc/...` or `factory/...`). |
| stablecoin\_currency | Fiat currency the stablecoin is pegged to, from Allium's stablecoin registry (e.g. `usd`, `eur`). |
| base\_asset | Canonical name of the stablecoin (e.g. `USDC`, `USDT`). Groups together all deployments of the same stablecoin across chains and issuers. |
| is\_bridge | True if Allium's stablecoin registry marks this token as a bridged representation (e.g. bridged in via Peggy or IBC); false if it is the issuer's canonical deployment. |
| \_metadata\_created\_at | Timestamp when the stablecoin registry record for this token was first created. |
| \_metadata\_updated\_at | Timestamp when the stablecoin registry record for this token was last updated. |
| event\_name | Normalized name of the supply change: `transfer_mint` for `coinbase` events or `transfer_burn` for `burn` events. |
| is\_mint | True if the event increased total supply (a `coinbase` event). |
| is\_burn | True if the event decreased total supply (a `burn` event). |