SuperstateVaultHistoricalReader

Documentation for eth_defi.tokenised_fund.superstate.historical.SuperstateVaultHistoricalReader Python class.

class SuperstateVaultHistoricalReader

Bases: eth_defi.vault.base.VaultHistoricalReader

Read Superstate ERC-20 supply and issuer-published NAV history.

USTB’s getChainlinkPrice() method returns the Superstate continuous price at the queried archive block. It is a NAV/share feed, not a token exchange price and not a redemption-liquidity guarantee. The reader marks failed or stale oracle values as errors rather than inventing a price.

Create the historical reader.

Parameters

• vault – Reviewed Superstate fund adapter.

• stateful – Whether to retain shared adaptive multicall state.

Attributes summary

address
first_block

Methods summary

__init__(vault, stateful)	Create the historical reader.
construct_multicalls()	Construct the supply and NAV calls for each historical sample.
process_result(block_number, timestamp, ...)	Convert archive multicall responses into a historical price row.

__init__(vault, stateful)

Create the historical reader.

Parameters

• vault (SuperstateVault) – Reviewed Superstate fund adapter.

• stateful (bool) – Whether to retain shared adaptive multicall state.

construct_multicalls()

Construct the supply and NAV calls for each historical sample.

Returns

Calls to USTB totalSupply() and getChainlinkPrice().

Return type

collections.abc.Iterable[eth_defi.event_reader.multicall_batcher.EncodedCall]

process_result(block_number, timestamp, call_results)

Convert archive multicall responses into a historical price row.

Parameters

• block_number (int) – Ethereum block containing the readings.

• timestamp (datetime.datetime) – Naive UTC block timestamp.

• call_results (list[eth_defi.event_reader.multicall_batcher.EncodedCallResult]) – Results from construct_multicalls().

Returns

Supply, NAV/share and NAV-denominated TVL observation.

Return type

eth_defi.vault.base.VaultHistoricalRead