Skip to main content

Interface: IotaSystemStateSummaryV2

This is the JSON-RPC type for the IotaSystemStateV2 object. It flattens all fields to make them top-level fields such that it as minimum dependencies to the internal data structures of the IOTA system state type.

Properties

PropertyTypeDescription
activeValidatorsIotaValidatorSummary[]The list of active validators in the current epoch.
atRiskValidators[string, string][]Map storing the number of epochs for which each validator has been below the low stake threshold.
committeeMembersstring[]List of committee validators in the current epoch. Each element is an index pointing to active_validators.
epochstringThe current epoch ID, starting from 0.
epochDurationMsstringThe duration of an epoch, in milliseconds.
epochStartTimestampMsstringUnix timestamp of the current epoch start
inactivePoolsIdstringID of the object that maps from a staking pool ID to the inactive validator that has that pool as its staking pool.
inactivePoolsSizestringNumber of inactive staking pools.
iotaTotalSupplystringThe current IOTA supply.
iotaTreasuryCapIdstringThe TreasuryCap<IOTA> object ID.
maxValidatorCountstringMaximum number of active validators at any moment. We do not allow the number of validators in any epoch to go above this.
minValidatorCountstringMinimum number of active validators at any moment. We do not allow the number of validators in any epoch to go under this.
minValidatorJoiningStakestringLower-bound on the amount of stake required to become a validator.
pendingActiveValidatorsIdstringID of the object that contains the list of new validators that will join at the end of the epoch.
pendingActiveValidatorsSizestringNumber of new validators that will join at the end of the epoch.
pendingRemovalsstring[]Removal requests from the validators. Each element is an index pointing to active_validators.
protocolVersionstringThe current protocol version, starting from 1.
referenceGasPricestringThe reference gas price for the current epoch.
safeModebooleanWhether the system is running in a downgraded safe mode due to a non-recoverable bug. This is set whenever we failed to execute advance_epoch, and ended up executing advance_epoch_safe_mode. It can be reset once we are able to successfully execute advance_epoch.
safeModeComputationChargesstringAmount of computation charges accumulated (and not yet distributed) during safe mode.
safeModeComputationChargesBurnedstringAmount of burned computation charges accumulated during safe mode.
safeModeNonRefundableStorageFeestringAmount of non-refundable storage fee accumulated during safe mode.
safeModeStorageChargesstringAmount of storage charges accumulated (and not yet distributed) during safe mode.
safeModeStorageRebatesstringAmount of storage rebates accumulated (and not yet burned) during safe mode.
stakingPoolMappingsIdstringID of the object that maps from staking pool's ID to the iota address of a validator.
stakingPoolMappingsSizestringNumber of staking pool mappings.
storageFundNonRefundableBalancestringThe non-refundable portion of the storage fund coming from non-refundable storage rebates and any leftover staking rewards.
storageFundTotalObjectStorageRebatesstringThe storage rebates of all the objects on-chain stored in the storage fund.
systemStateVersionstringThe current version of the system state data structure type.
totalStakestringTotal amount of stake from all committee validators at the beginning of the epoch.
validatorCandidatesIdstringID of the object that stores preactive validators, mapping their addresses to their Validator structs.
validatorCandidatesSizestringNumber of preactive validators.
validatorLowStakeGracePeriodstringA validator can have stake below validator_low_stake_threshold for this many epochs before being kicked out.
validatorLowStakeThresholdstringValidators with stake amount below validator_low_stake_threshold are considered to have low stake and will be escorted out of the validator set after being below this threshold for more than validator_low_stake_grace_period number of epochs.
validatorReportRecords[string, string[]][]A map storing the records of validator reporting each other.
validatorVeryLowStakeThresholdstringValidators with stake below validator_very_low_stake_threshold will be removed immediately at epoch change, no grace period.