graphql-alt: Epoch

[amnn]

Description

Add support for querying epochs (getting and multi-getting epochs by their IDs, and getting a checkpoint's epoch).

Test plan

sui$ cargo nextest run -p sui-indexer-alt-e2e-tests

Stack

• graphql-alt: MovePackage #21950
• graphql-alt: consistency infra #21990
• graphql-alt: Query.package, Query.multiGetPackages #21991
• easy refactor(graphql-alt): lock down visibility #21992

---

Release notes

Check each box that your changes affect. If none of the boxes relate to your changes, release notes aren't required.

For each box you select, include information after the relevant heading that describes the impact of your changes that a user might notice and any actions they must take to implement updates.

• Protocol:
• Nodes (Validators and Full nodes):
• gRPC:
• JSON-RPC:
• GraphQL:
• CLI:
• Rust SDK:

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
sui-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	May 19, 2025 2:04pm

2 Skipped Deployments

Name	Status	Preview	Comments	Updated (UTC)
multisig-toolkit	⬜️ Ignored (Inspect)	Visit Preview		May 19, 2025 2:04pm
sui-kiosk	⬜️ Ignored (Inspect)	Visit Preview		May 19, 2025 2:04pm

[Copilot]

Pull Request Overview

This PR adds support for querying epochs by extending the schema, reader, and GraphQL API with new types and resolvers for single and multi-get epoch queries.

• Added new Diesel schema and queryable types for epochs.
• Implemented epoch data loaders in the reader and corresponding GraphQL types and resolvers.
• Extended the API query to support fetching epochs and multiple epochs.

Reviewed Changes

Copilot reviewed 9 out of 17 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
crates/sui-indexer-alt-schema/src/epochs.rs	Updated epoch schema types with Queryable derive to support queries.
crates/sui-indexer-alt-reader/src/lib.rs	Exposed the new epochs module.
crates/sui-indexer-alt-reader/src/epochs.rs	Added Loader implementations for EpochStartKey and EpochEndKey.
crates/sui-indexer-alt-graphql/src/api/types/mod.rs	Included the new epoch module in the API types.
crates/sui-indexer-alt-graphql/src/api/types/epoch.rs	Implemented GraphQL types and resolvers for epoch start and end details.
crates/sui-indexer-alt-graphql/src/api/types/checkpoint.rs	Added a resolver for fetching the epoch related to a checkpoint.
crates/sui-indexer-alt-graphql/src/api/scalars/mod.rs	Added the big_int scalar module required by the epoch types.
crates/sui-indexer-alt-graphql/src/api/scalars/big_int.rs	Provided a BigInt scalar implementation used in the epoch GraphQL types.
crates/sui-indexer-alt-graphql/src/api/query.rs	Introduced new query endpoints to fetch epochs, including multi-get epochs.

Files not reviewed (8)

• crates/sui-indexer-alt-e2e-tests/tests/graphql/checkpoints/epoch.move: Language not supported
• crates/sui-indexer-alt-e2e-tests/tests/graphql/checkpoints/epoch.snap: Language not supported
• crates/sui-indexer-alt-e2e-tests/tests/graphql/epochs/query.move: Language not supported
• crates/sui-indexer-alt-e2e-tests/tests/graphql/epochs/query.snap: Language not supported
• crates/sui-indexer-alt-graphql/schema.graphql: Language not supported
• crates/sui-indexer-alt-graphql/src/snapshots/sui_indexer_alt_graphql__tests__schema.graphql.snap: Language not supported
• crates/sui-indexer-alt-graphql/src/snapshots/sui_indexer_alt_graphql__tests__staging.graphql.snap: Language not supported
• crates/sui-indexer-alt-graphql/staging.graphql: Language not supported

Comments suppressed due to low confidence (1)

crates/sui-indexer-alt-graphql/src/api/query.rs:79

• Typographical errors: 'guarnateed' should be 'guaranteed' and 'epocch' should be 'epoch'.

/// Returns a list of epochs that is guarnateed 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 epocch does not exist yet, or because it was pruned.

[wlmyng]

looks good, lets advance this epoch

[wlmyng]

wheres c7 coming from?

e0
c0: init
c1: L6
c2: L8 advance-epoch

e1
c3 L10
c4 L12
c5 L14 advance epoch

and then c6 from L16

[amnn]

c7 doesn't exist -- it's the proof that there are no more checkpoints (it returns null in the snapshot).