graphql-alt: ObjectKey.atCheckpoint fails on future time travel

[amnn]

Description

Based on our discussion on Wednesday, this change makes it so that the atCheckpoint filter will produce an error if you attempt to time travel into the future relative to the current latest checkpoint.

Test plan

Updated E2E tests:

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

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
• graphql-alt: Epoch #21997
• graphql-alt: ProtocolConfigs #22004
• graphql-alt: Epoch.coinDenyList #22005
• graphql-alt: latest Epochs and Protocol Configs #22006
• graphql-alt: indices for packages and epochs #22085
• graphql-alt: Object version pagination #22086
• graphql-alt: IObject.objectAt, MovePackage.packageAt #22087
• graphql-alt: Query.packageVersions #22088
• reader-alt: query! macro #22089
• graphql-alt: Epoch.systemPackages #22090
• graphql-alt: more robust pipeline detection #22115
• reader-alt: evict system packages using DB #22116

---

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 1:46pm

2 Skipped Deployments

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

[Copilot]

Pull Request Overview

This PR adds error handling in the GraphQL API to ensure that queries attempting to fetch data at a future checkpoint fail with an appropriate error message. Key changes include:

• Updated GraphQL schema and documentation comments to clarify the new behavior.
• Adjustments in the scope and object processing logic to return an error when a future checkpoint is provided.
• Corresponding updates in tests to verify the new error handling behavior.

Reviewed Changes

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

Show a summary per file

File	Description
crates/sui-indexer-alt-graphql/staging.graphql	Updated doc comments on checkpoint usage.
crates/sui-indexer-alt-graphql/src/snapshots/*.snap	Updated snapshots to verify the revised checkpoint error messages.
crates/sui-indexer-alt-graphql/src/scope.rs	Modified function to return an Option based on checkpoint validity.
crates/sui-indexer-alt-graphql/src/api/types/object.rs	Added error handling for future checkpoint values with a new error variant.
crates/sui-indexer-alt-graphql/src/api/types/checkpoint.rs	Updated query() to return an error for future checkpoints.
crates/sui-indexer-alt-graphql/src/api/query.rs	Updated comment to clarify new behavior.
crates/sui-indexer-alt-graphql/schema.graphql	Synchronized documentation with the new error handling behavior.
crates/sui-indexer-alt-e2e-tests/*	Updated tests to reflect the new error scenario for future checkpoints.