Skip to main content

epoch

Fetch an epoch by its ID, or fetch the latest epoch if no ID is provided.

Returns null if the epoch does not exist yet, or was pruned.

epoch(
  epochId: UInt53
): Epoch

Arguments​

epoch.epochId ● UInt53 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.