Skip to main content

Checkpoint

Checkpoints contain finalized transactions and are used for node synchronization and global transaction ordering.

type Checkpoint {
  digest: String!
  sequenceNumber: UInt!
  timestamp: DateTime!
  validatorSignatures: Base64!
  previousCheckpointDigest: String
  networkTotalTransactions: UInt
  rollingGasSummary: GasCostSummary
  epoch: Epoch
  transactionBlocks(
    first: Int
    after: String
    last: Int
    before: String
    filter: TransactionBlockFilter
  ): TransactionBlockConnection!
}

Fields​

Checkpoint.digest ● String! non-null scalar​

A 32-byte hash that uniquely identifies the checkpoint contents, encoded in Base58. This hash can be used to verify checkpoint contents by checking signatures against the committee, Hashing contents to match digest, and checking that the previous checkpoint digest matches.

Checkpoint.sequenceNumber ● UInt! non-null scalar​

This checkpoint's position in the total order of finalized checkpoints, agreed upon by consensus.

Checkpoint.timestamp ● DateTime! non-null scalar​

The timestamp at which the checkpoint is agreed to have happened according to consensus. Transactions that access time in this checkpoint will observe this timestamp.

Checkpoint.validatorSignatures ● Base64! non-null scalar​

This is an aggregation of signatures from a quorum of validators for the checkpoint proposal.

Checkpoint.previousCheckpointDigest ● String scalar​

The digest of the checkpoint at the previous sequence number.

Checkpoint.networkTotalTransactions ● UInt scalar​

The total number of transaction blocks in the network by the end of this checkpoint.

Checkpoint.rollingGasSummary ● GasCostSummary object​

The computation cost, storage cost, storage rebate, and non-refundable storage fee accumulated during this epoch, up to and including this checkpoint. These values increase monotonically across checkpoints in the same epoch, and reset on epoch boundaries.

Checkpoint.epoch ● Epoch object​

The epoch this checkpoint is part of.

Checkpoint.transactionBlocks ● TransactionBlockConnection! non-null object​

Transactions in this checkpoint.

Checkpoint.transactionBlocks.first ● Int scalar​
Checkpoint.transactionBlocks.after ● String scalar​
Checkpoint.transactionBlocks.last ● Int scalar​
Checkpoint.transactionBlocks.before ● String scalar​
Checkpoint.transactionBlocks.filter ● TransactionBlockFilter input​

Returned By​

checkpoint query

Member Of​

AvailableRange object ● CheckpointConnection object ● CheckpointEdge object ● TransactionBlockEffects object