Skip to main content

Table Details

PropertyValue
Table Nameprovenance.stablecoins.supply_change
Table StatusProduction-Ready
Unique Keyblock_timestamp, unique_id
Clustering Key(s)block_timestamp::date
Search Optimizationfrom_address, to_address, transaction_hash

Table Columns

Column NameData TypeDescription
from_addressVARCHAR(16777216)Address that initiated or sent from in this event. For token transfers, the account whose balance decreased. For transactions, the transaction sender (msg.sender).
to_addressVARCHAR(16777216)Address that received in this event. For token transfers, the account whose balance increased. For transactions, the destination address (may be a smart contract).
currencyVARCHAR(16777216)Fiat currency this stablecoin is pegged to, as an ISO 4217 code in lowercase (e.g. usd, eur, jpy).
token_nameVARCHAR(16777216)Full name of the token (e.g. “USD Coin”, “Wrapped Ether”).
token_symbolVARCHAR(16777216)Ticker symbol of the token (e.g. “USDC”, “WETH”).
raw_amount_strVARCHAR(16777216)Token amount in the smallest unit as a string. Same concept as amount_raw_str — the column is named raw_amount_str in models that follow the raw_ prefix convention rather than the _raw suffix convention.
raw_amountFLOATToken amount in the smallest indivisible unit (not decimal-adjusted). Same concept as amount_raw — the column is named raw_amount in models that follow the raw_ prefix convention.
usd_amountFLOATUSD value of the token amount at the time of the event, computed using the hourly USD exchange rate.
usd_exchange_rateFLOATUSD price per unit of the token at the time of the event, used to compute usd_amount. Sourced from Allium’s hourly price feed.
event_typeVARCHAR(16777216)Type or category of the onchain event that produced this record. The specific values depend on the model (e.g. transfer_single / batch_transfer for ERC-1155, deposit / withdraw for bridges).
tx_senderVARCHAR(16777216)Address that signed and submitted the transaction.
transaction_hashVARCHAR(64)Hash of the transaction that produced this record. Uniquely identifies a transaction within the blockchain.
transaction_indexNUMBER(38,0)Zero-based position of the transaction within its block. The first transaction in a block has index 0.
event_indexNUMBER(38,0)Zero-based index of this event within its transaction. The specific semantics depend on the chain — on Aptos this is the event_index within the transaction; on Cosmos this is within the message.
block_timestampTIMESTAMP_NTZ(9)Timestamp (UTC) of the block that contains this record.
block_heightNUMBER(38,0)Number of confirmed blocks between this block and the genesis block (inclusive). Unlike block_slot, this only increments for slots that produced a block.
block_hashVARCHAR(64)Cryptographic hash of the block header that contains this record. Uniquely identifies a block.
block_event_kindVARCHAR(16777216)Block event kind if originating from a block event: begin, end, or finalize.
block_event_indexNUMBER(38,0)Block event index (null for transaction events).
block_event_typeVARCHAR(16777216)Block event type string (null for transaction events).
codeNUMBER(38,0)The bytecode of the contract
tx_successBOOLEANTrue if the transaction executed successfully; false if it reverted.
authz_msg_indexNUMBER(38,0)Authz Message index within the transfer.
memoVARCHAR(16777216)Memo for IBC transfers, if applicable.
src_channelVARCHAR(16777216)Source channel for the IBC transfer for inbound transfers.
dst_channelVARCHAR(16777216)Destination channel for the IBC transfer for inbound transfers.
unique_idVARCHAR(16777216)Allium’s deterministic unique identifier for this row. Generated from the fields that uniquely identify the record (e.g. transaction hash + log index). Stable across full refreshes.
amount_strVARCHAR(16777216)Normalized token amount stored as a string to preserve full precision. Equivalent to amount but avoids floating-point truncation for very large or very small values.
amountFLOATToken amount normalized by the token’s decimal precision (amount_raw / 10^decimals). This is the human-readable value (e.g. 1.5 USDC rather than 1500000).
token_addressVARCHAR(16777216)Contract address of the token. For EVM chains, native currency (e.g. ETH, MATIC) is represented as the zero address (0x0000000000000000000000000000000000000000). For Solana, this is the mint address.
stablecoin_currencyVARCHAR(16777216)Fiat currency denomination of this stablecoin on Provenance (e.g., USD, EUR).
base_assetVARCHAR(16777216)Canonical name of the stablecoin (e.g. USDC, USDT, DAI). Groups together all deployments of the same stablecoin across chains and issuers.
is_bridgeBOOLEANTrue if this stablecoin token is a bridged representation (e.g. USDC bridged from Ethereum to an L2 via a third-party bridge). False if it is the canonical deployment by the issuer.
_metadata_created_atTIMESTAMP_NTZ(9)Timestamp when the token metadata record was first created.
_metadata_updated_atTIMESTAMP_NTZ(9)When the stablecoin metadata was last updated.
event_nameVARCHAR(16777216)Name of the smart contract event that triggered this bridge record (e.g. Deposit, Send, TransferInitiated).
is_mintBOOLEANBoolean flag indicating if this is a token minting event
is_burnBOOLEANBoolean flag indicating if this is a token burning event
_created_atTIMESTAMP_NTZ(9)Timestamp of when the entry was created in the database.
_updated_atTIMESTAMP_NTZ(9)Timestamp of when the entry was last updated in the database.