--- title: "GET /system" method: GET path: "/system" tags: ["System"] --- # GET /system `GET /system` ## Response `200` - SystemStateSummary - `active_validators` ValidatorSummary[], required — The list of active validators in the current epoch. - `address` string, hex, required — A 32-byte Sui address, encoded as a hex string. - `commission_rate` string, u64, required — Radix-10 encoded 64-bit unsigned integer - `description` string, required - `exchange_rates_id` string, hex, required — A 32-byte Sui address, encoded as a hex string. - `exchange_rates_size` string, u64, required — Number of exchange rates in the table. - `gas_price` string, u64, required — Radix-10 encoded 64-bit unsigned integer - `image_url` string, required - `name` string, required - `net_address` string, required - `network_public_key` string, base64, required — Base64 encoded data - `next_epoch_commission_rate` string, u64, required — Radix-10 encoded 64-bit unsigned integer - `next_epoch_gas_price` string, u64, required — Radix-10 encoded 64-bit unsigned integer - `next_epoch_net_address` string - `next_epoch_network_public_key` string, base64 — Base64 encoded data - `next_epoch_p2p_address` string - `next_epoch_primary_address` string - `next_epoch_proof_of_possession` string - `next_epoch_protocol_public_key` string, base64 — Base64 encoded data - `next_epoch_stake` string, u64, required — Radix-10 encoded 64-bit unsigned integer - `next_epoch_worker_address` string - `next_epoch_worker_public_key` string, base64 — Base64 encoded data - `operation_cap_id` string, hex, required — A 32-byte Sui address, encoded as a hex string. - `p2p_address` string, required - `pending_pool_token_withdraw` string, u64, required — Pending pool token withdrawn during the current epoch, emptied at epoch boundaries. - `pending_stake` string, u64, required — Pending stake amount for this epoch. - `pending_total_sui_withdraw` string, u64, required — Pending stake withdrawn during the current epoch, emptied at epoch boundaries. - `pool_token_balance` string, u64, required — Total number of pool tokens issued by the pool. - `primary_address` string, required - `project_url` string, required - `proof_of_possession_bytes` string, required - `protocol_public_key` string, base64, required — Base64 encoded data - `rewards_pool` string, u64, required — The epoch stake rewards will be added here at the end of each epoch. - `staking_pool_activation_epoch` string, u64 — The epoch at which this pool became active. - `staking_pool_deactivation_epoch` string, u64 — The epoch at which this staking pool ceased to be active. `None` = {pre-active, active}, - `staking_pool_id` string, hex, required — A 32-byte Sui address, encoded as a hex string. - `staking_pool_sui_balance` string, u64, required — The total number of SUI tokens in this pool. - `voting_power` string, u64, required — Radix-10 encoded 64-bit unsigned integer - `worker_address` string, required - `worker_public_key` string, base64, required — Base64 encoded data - `at_risk_validators` array[], required — Map storing the number of epochs for which each validator has been below the low stake threshold. - unknown[] - unknown - `epoch` string, u64, required — The current epoch ID, starting from 0. - `epoch_duration_ms` string, u64, required — The duration of an epoch, in milliseconds. - `epoch_start_timestamp_ms` string, u64, required — Unix timestamp of the current epoch start - `inactive_pools_id` string, hex, required — A 32-byte Sui address, encoded as a hex string. - `inactive_pools_size` string, u64, required — Number of inactive staking pools. - `max_validator_count` string, u64, required — Maximum number of active validators at any moment. We do not allow the number of validators in any epoch to go above this. - `min_validator_joining_stake` string, u64, required — Lower-bound on the amount of stake required to become a validator. - `pending_active_validators_id` string, hex, required — A 32-byte Sui address, encoded as a hex string. - `pending_active_validators_size` string, u64, required — Number of new validators that will join at the end of the epoch. - `pending_removals` string[], required — Removal requests from the validators. Each element is an index pointing to `active_validators`. - `protocol_version` string, u64, required — The current protocol version, starting from 1. - `reference_gas_price` string, u64, required — The reference gas price for the current epoch. - `safe_mode` boolean, required — Whether 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. - `safe_mode_computation_rewards` string, u64, required — Amount of computation rewards accumulated (and not yet distributed) during safe mode. - `safe_mode_non_refundable_storage_fee` string, u64, required — Amount of non-refundable storage fee accumulated during safe mode. - `safe_mode_storage_rebates` string, u64, required — Amount of storage rebates accumulated (and not yet burned) during safe mode. - `safe_mode_storage_rewards` string, u64, required — Amount of storage rewards accumulated (and not yet distributed) during safe mode. - `stake_subsidy_balance` string, u64, required — Balance of SUI set aside for stake subsidies that will be drawn down over time. - `stake_subsidy_current_distribution_amount` string, u64, required — The amount of stake subsidy to be drawn down per epoch. This amount decays and decreases over time. - `stake_subsidy_decrease_rate` integer, required — The rate at which the distribution amount decays at the end of each period. Expressed in basis points. - `stake_subsidy_distribution_counter` string, u64, required — This counter may be different from the current epoch number if in some epochs we decide to skip the subsidy. - `stake_subsidy_period_length` string, u64, required — Number of distributions to occur before the distribution amount decays. - `stake_subsidy_start_epoch` string, u64, required — The starting epoch in which stake subsidies start being paid out - `staking_pool_mappings_id` string, hex, required — A 32-byte Sui address, encoded as a hex string. - `staking_pool_mappings_size` string, u64, required — Number of staking pool mappings. - `storage_fund_non_refundable_balance` string, u64, required — The non-refundable portion of the storage fund coming from storage reinvestment, non-refundable storage rebates and any leftover staking rewards. - `storage_fund_total_object_storage_rebates` string, u64, required — The storage rebates of all the objects on-chain stored in the storage fund. - `system_state_version` string, u64, required — The current version of the system state data structure type. - `total_stake` string, u64, required — Total amount of stake from all active validators at the beginning of the epoch. - `validator_candidates_id` string, hex, required — A 32-byte Sui address, encoded as a hex string. - `validator_candidates_size` string, u64, required — Number of preactive validators. - `validator_low_stake_grace_period` string, u64, required — A validator can have stake below `validator_low_stake_threshold` for this many epochs before being kicked out. - `validator_low_stake_threshold` string, u64, required — Validators 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. - `validator_report_records` array[], required — A map storing the records of validator reporting each other. - unknown[] - unknown - `validator_very_low_stake_threshold` string, u64, required — Validators with stake below `validator_very_low_stake_threshold` will be removed immediately at epoch change, no grace period. ## Changes - **2024-07-17** `b4c290f3f934` — 3 info - api operation id `GetSystemStateSummary` was added - api tag `System` added - added the success response with the status `200` [Change history](https://skmtc.dev/verichains/apis/sui-node-api/changes/system/get.md) --- [API](https://skmtc.dev/verichains/apis/sui-node-api.md) · [All operations](https://skmtc.dev/verichains/apis/sui-node-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/verichains/sui-node-api/revisions/f4c58925668c/schema)