Skip to main content

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 {
  computationCharge: UInt53
  epoch: Epoch
  epochStartTimestamp: DateTime
  nonRefundableStorageFee: UInt53
  protocolConfigs: ProtocolConfigs
  storageCharge: UInt53
  storageRebate: UInt53
  systemPackages(
    first: Int
    after: String
    last: Int
    before: String
  ): MovePackageConnection
}

Fields​

ChangeEpochTransaction.computationCharge ● UInt53 scalar​

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

ChangeEpochTransaction.epoch ● Epoch object​

The next (to become) epoch.

ChangeEpochTransaction.epochStartTimestamp ● DateTime scalar​

Unix timestamp when epoch started.

ChangeEpochTransaction.nonRefundableStorageFee ● UInt53 scalar​

The non-refundable storage fee.

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.storageRebate ● UInt53 scalar​

The amount of storage rebate refunded to the transaction senders.

ChangeEpochTransaction.systemPackages ● MovePackageConnection 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