Skip to main content
⚠️ This is the beta version of the Sui GraphQL schema. The beta schema will replace the alpha GraphQL schema upon its official release.

multiGetEpochs

Fetch epochs by their IDs.

Returns a list of epochs that is guaranteed to be the same length as keys. If an epoch in keys could not be found in the store, its corresponding entry in the result will be null. This could be because the epoch does not exist yet, or because it was pruned.

multiGetEpochs(
  keys: [UInt53!]!
): [Epoch]!

Arguments​

multiGetEpochs.keys ● [UInt53!]! non-null scalar​

Type​

Epoch object​

Activity on Sui is partitioned in time, into epochs.

Epoch changes are opportunities for the network to reconfigure itself (perform protocol or system package upgrades, or change the committee) and distribute staking rewards. The network aims to keep epochs roughly the same duration as each other.

During a particular epoch the following data is fixed:

  • protocol version,
  • reference gas price,
  • system package versions,
  • validators in the committee.