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.

ChangeEpochTransaction

A system transaction that updates epoch information on-chain (increments the current epoch). Executed by the system once per epoch, without using gas. Epoch change transactions cannot be submitted by users, because validators will refuse to sign them.

This transaction kind is deprecated in favour of EndOfEpochTransaction.

type ChangeEpochTransaction {
  epoch: Epoch
  protocolConfigs: ProtocolConfigs
  storageCharge: UInt53
  computationCharge: UInt53
  storageRebate: UInt53
  nonRefundableStorageFee: UInt53
  epochStartTimestamp: DateTime
  systemPackages(
    first: Int
    after: String
    last: Int
    before: String
  ): MovePackageConnection!
}

Fields​

ChangeEpochTransaction.epoch ● Epoch object​

The next (to become) epoch.

ChangeEpochTransaction.protocolConfigs ● ProtocolConfigs object​

The epoch's corresponding protocol configuration.

ChangeEpochTransaction.storageCharge ● UInt53 scalar​

The total amount of gas charged for storage during the epoch.

ChangeEpochTransaction.computationCharge ● UInt53 scalar​

The total amount of gas charged for computation during the epoch.

ChangeEpochTransaction.storageRebate ● UInt53 scalar​

The amount of storage rebate refunded to the transaction senders.

ChangeEpochTransaction.nonRefundableStorageFee ● UInt53 scalar​

The non-refundable storage fee.

ChangeEpochTransaction.epochStartTimestamp ● DateTime scalar​

Unix timestamp when epoch started.

ChangeEpochTransaction.systemPackages ● MovePackageConnection! non-null object​

System packages that will be written by validators before the new epoch starts, to upgrade them on-chain. These objects do not have a "previous transaction" because they are not written on-chain yet. Consult effects.objectChanges for this transaction to see the actual objects written.

ChangeEpochTransaction.systemPackages.first ● Int scalar​
ChangeEpochTransaction.systemPackages.after ● String scalar​
ChangeEpochTransaction.systemPackages.last ● Int scalar​
ChangeEpochTransaction.systemPackages.before ● String scalar​

Implemented By​

EndOfEpochTransactionKind union ● TransactionKind union