tokenised_fund.superstate.constants

Documentation for eth_defi.tokenised_fund.superstate.constants Python module.

Reviewed Superstate tokenised-fund deployments.

The registry is deliberately chain-aware. A token contract address alone is not a globally unique vault identifier and must not classify a contract on a different EVM chain as a Superstate fund.

Module Attributes

`SUPERSTATE_ETHEREUM_CHAIN_ID`	Ethereum mainnet chain id.
`USTB_ETHEREUM_ADDRESS`	Invesco Short Duration US Government Securities Fund (USTB) Ethereum proxy.
`USTB_ETHEREUM_FIRST_SEEN_AT_BLOCK`	First Ethereum block with USTB proxy bytecode.
`USTB_ETHEREUM_FIRST_SEEN_AT`	USTB deployment timestamp as a naive UTC datetime.
`USTB_ETHEREUM_CONTINUOUS_PRICE_ORACLE`	Superstate's documented USTB continuous-price oracle on Ethereum.
`USTB_ETHEREUM_ORACLE_DECIMALS`	The verified USTB oracle uses six decimal places.
`SUPERSTATE_PRODUCTS_BY_CHAIN`	Reviewed Superstate fund addresses keyed by chain id.
`SUPERSTATE_HARDCODED_LEADS`	Hardcoded discovery leads for reviewed Superstate fund-token deployments.

SUPERSTATE_ETHEREUM_CHAIN_ID = 1: Ethereum mainnet chain id.

USTB_ETHEREUM_ADDRESS = '0x43415eb6ff9db7e26a15b704e7a3edce97d31c4e'

Invesco Short Duration US Government Securities Fund (USTB) Ethereum proxy.

Source: https://docs.superstate.com/welcome-to-superstate/smart-contracts

USTB_ETHEREUM_FIRST_SEEN_AT_BLOCK = 18725909

First Ethereum block with USTB proxy bytecode.

Determined with an archive-RPC binary search on 2026-07-17. The preceding block has no code at USTB_ETHEREUM_ADDRESS.

USTB_ETHEREUM_FIRST_SEEN_AT = datetime.datetime(2023, 12, 5, 17, 11, 35): USTB deployment timestamp as a naive UTC datetime.

USTB_ETHEREUM_CONTINUOUS_PRICE_ORACLE = '0xe4fa682f94610ccd170680cc3b045d77d9e528a8'

Superstate’s documented USTB continuous-price oracle on Ethereum.

https://docs.superstate.com/welcome-to-superstate/smart-contracts

USTB_ETHEREUM_ORACLE_DECIMALS = 6

The verified USTB oracle uses six decimal places.

Direct and historical reads use this reviewed deployment constant so each historical point remains reproducible when token configuration changes.

SUPERSTATE_PRODUCTS_BY_CHAIN: dict[int, frozenset[eth_typing.evm.HexAddress]] = {1: frozenset({'0x43415eb6ff9db7e26a15b704e7a3edce97d31c4e'})}: Reviewed Superstate fund addresses keyed by chain id.

SUPERSTATE_HARDCODED_LEADS = ((1, '0x43415eb6ff9db7e26a15b704e7a3edce97d31c4e', 18725909, datetime.datetime(2023, 12, 5, 17, 11, 35)),): Hardcoded discovery leads for reviewed Superstate fund-token deployments.