Skip to main content

IotaSystemStateV2

IotaSystemStateV2 Objects​

class IotaSystemStateV2(IotaSystemStateV2Protocol)

A typed view of the 0x3::iota_system_state_inner::IotaSystemStateV2 inner system state.

Exposes the scalar epoch parameters plus the nested validator set ([ValidatorSetV2]), storage fund ([StorageFundV1]), system parameters ([SystemParametersV1]), and the treasury's total supply.

try_from_bcs​

@classmethod
def try_from_bcs(cls, bytes: bytes) -> IotaSystemStateV2

Decode an IotaSystemStateV2 from raw BCS bytes.

There is no object-based constructor: the inner state is stored as a dynamic field of the 0x5 wrapper, not as a top-level object with its own type tag.

epoch_start_timestamp_ms​

def epoch_start_timestamp_ms() -> int

Unix timestamp (ms) of the current epoch start.

extra_fields_id​

def extra_fields_id() -> ObjectId

Object ID of the Bag holding fields added to this struct after its current on-chain layout was set.

iota_total_supply​

def iota_total_supply() -> int

Total IOTA supply controlled by the system treasury, in nanos.

parameters​

def parameters() -> SystemParametersV1

The system parameters.

reference_gas_price​

def reference_gas_price() -> int

The reference gas price for the current epoch, in nanos.

safe_mode​

def safe_mode() -> bool

Whether the system is running in a downgraded safe mode.

safe_mode_computation_charges​

def safe_mode_computation_charges() -> int

Computation charges accumulated during safe mode, in nanos.

safe_mode_computation_charges_burned​

def safe_mode_computation_charges_burned() -> int

Computation charges burned during safe mode, in nanos.

safe_mode_non_refundable_storage_fee​

def safe_mode_non_refundable_storage_fee() -> int

Non-refundable storage fees accumulated during safe mode, in nanos.

safe_mode_storage_charges​

def safe_mode_storage_charges() -> int

Storage charges accumulated during safe mode, in nanos.

safe_mode_storage_rebates​

def safe_mode_storage_rebates() -> int

Storage rebates accumulated during safe mode, in nanos.

storage_fund​

def storage_fund() -> StorageFundV1

The storage fund.

validator_report_records​

def validator_report_records() -> dict[Address, typing.List[Address]]

Validator report records: each reported validator's address mapped to the addresses of the validators reporting it.

validators​

def validators() -> ValidatorSetV2

The validator set.