graphql-alt: Epoch.systemPackages

[amnn]

Description

API for fetching the system packages that were used during a given epoch.

Test plan

New E2E basic tests:

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

...but transactional testing does not support system package upgrades, so this change was also tested manually against the production DB.

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

---

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:51pm

2 Skipped Deployments

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

[Copilot]

Pull Request Overview

This PR implements an API for fetching system packages used during an epoch by updating pagination types and cursor encoding across several GraphQL types. Key changes include:

• Replacing raw cursors (CVersion) with encoded cursor strings (via BcsCursor) in Connection types.
• Adding a new pagination function for system packages in MovePackage.
• Incorporating new workspace dependencies in Cargo.toml and updating related E2E tests.

Reviewed Changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
crates/sui-indexer-alt-graphql/src/api/types/object.rs	Updated connection types and cursor encoding for object version pagination.
crates/sui-indexer-alt-graphql/src/api/types/move_package.rs	Updated connection types and added paginate_system_packages for system package retrieval.
crates/sui-indexer-alt-graphql/src/api/types/epoch.rs	Added systemPackages field to the Epoch type.
crates/sui-indexer-alt-graphql/src/api/scalars/cursor.rs	Introduced BcsCursor with BCS encoding for cursors.
crates/sui-indexer-alt-graphql/src/api/query.rs	Adjusted connection types in query functions accordingly.
Cargo.toml	Updated workspace dependencies.
E2E tests	Added/updated snapshots and move tests for system packages.

Comments suppressed due to low confidence (1)

crates/sui-indexer-alt-graphql/src/api/types/object.rs:78

• Replacing the raw cursor type with an encoded String in the Connection return type is a significant API change; please ensure this is properly documented for API consumers.

ty = "Result<Option<Connection<String, Object>>, RpcError<Error>>",

[wlmyng]

all systems go

[wlmyng]

this was a fun one to read
do we prefer the macro over method chain?

[amnn]

I personally do, it makes it easier to keep track of bracketing etc.