Repository navigation
graphql: serve Epoch.systemPackages from ListSystemPackages - #28571
Open
nickvikeras wants to merge 1 commit into
Open
nickvikeras wants to merge 1 commit into
nickvikeras wants to merge 1 commit into
Conversation
1 of 8 tasks
nickvikeras
force-pushed
the
nickv/list-system-packages
branch
3 times, most recently
from
November 5, 2026 00:06
7503e3f to
3c4f15e
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages-graphql
branch
from
November 5, 2026 00:17
4a6ef8e to
386a953
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages
branch
from
November 5, 2026 00:51
3c4f15e to
6776299
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages-graphql
branch
from
November 5, 2026 00:54
386a953 to
1240bfb
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages
branch
from
November 5, 2026 15:50
6776299 to
154fc2a
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages-graphql
branch
from
November 5, 2026 15:54
1240bfb to
a30860d
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages
branch
from
November 5, 2026 19:20
154fc2a to
aa88587
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages-graphql
branch
from
November 5, 2026 19:25
a30860d to
fd5334a
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages
branch
from
November 5, 2026 23:00
aa88587 to
9bebda9
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages-graphql
branch
from
November 5, 2026 23:13
fd5334a to
2a0f7fb
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages
branch
from
November 6, 2026 00:47
9bebda9 to
f08189a
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages-graphql
branch
from
November 6, 2026 00:47
2a0f7fb to
e08d3ff
Compare
nickvikeras
added a commit
that referenced
this pull request
Nov 6, 2026
nickvikeras
force-pushed
the
nickv/list-system-packages
branch
from
November 6, 2026 21:32
f08189a to
9b7983f
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages-graphql
branch
from
November 6, 2026 21:32
e08d3ff to
15daa23
Compare
nickvikeras
changed the base branch from
nickv/list-system-packages
to
nickv/package-member-not-found
November 6, 2026 21:33
nickvikeras
added a commit
that referenced
this pull request
Nov 6, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 6, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 6, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 7, 2026
nickvikeras
force-pushed
the
nickv/package-member-not-found
branch
from
November 7, 2026 00:15
aceb0f9 to
cdfdc30
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages-graphql
branch
from
November 7, 2026 00:15
15daa23 to
8a6afda
Compare
nickvikeras
added a commit
that referenced
this pull request
Nov 7, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 7, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 7, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 7, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 7, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 12, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 12, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 12, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 12, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 12, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 12, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 12, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 12, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 13, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 13, 2026
nickvikeras
force-pushed
the
nickv/package-member-not-found
branch
from
November 13, 2026 04:15
1a1f187 to
9ac52b1
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages-graphql
branch
from
November 13, 2026 04:15
3cb150a to
6e7de46
Compare
nickvikeras
added a commit
that referenced
this pull request
Nov 13, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 13, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 13, 2026
nickvikeras
force-pushed
the
nickv/package-member-not-found
branch
from
November 13, 2026 11:11
9ac52b1 to
c7bd7c1
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages-graphql
branch
from
November 13, 2026 11:11
6e7de46 to
864ae04
Compare
nickvikeras
added a commit
that referenced
this pull request
Nov 13, 2026
nickvikeras
force-pushed
the
nickv/package-member-not-found
branch
from
November 14, 2026 03:01
c7bd7c1 to
2dacf83
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages-graphql
branch
2 times, most recently
from
November 14, 2026 06:25
29263a2 to
9d9d743
Compare
nickvikeras
force-pushed
the
nickv/package-member-not-found
branch
from
November 14, 2026 06:25
2dacf83 to
12f720b
Compare
nickvikeras
added a commit
that referenced
this pull request
Nov 14, 2026
nickvikeras
added a commit
that referenced
this pull request
Nov 14, 2026
nickvikeras
force-pushed
the
nickv/list-system-packages-graphql
branch
from
November 15, 2026 02:09
9d9d743 to
d210650
Compare
nickvikeras
added a commit
that referenced
this pull request
Nov 15, 2026
Epoch.systemPackages asks the ledger gRPC service for the system packages as of the checkpoint before the epoch's first, loads them through the KV loader, and paginates by package ID as the kv_packages query did. A BELOW_EARLIEST_AVAILABLE answer resolves the field to null.
nickvikeras
force-pushed
the
nickv/package-member-not-found
branch
from
November 15, 2026 19:59
2ae8a85 to
395a785
Compare
nickvikeras
force-pushed
the
nickv/list-system-packages-graphql
branch
from
November 15, 2026 19:59
d210650 to
1a073d8
Compare
nickvikeras
added a commit
that referenced
this pull request
Nov 15, 2026
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
GraphQL's
Epoch.systemPackagesreads the system packages from Postgreskv_packages. This serves it fromMovePackageService.ListSystemPackages(#28561) on the ledger gRPC service instead, as of the checkpoint before the epoch's first, and loads the packages through the KV loader. Pagination by package ID is unchanged. The field resolves tonullwhen the service answersBELOW_EARLIEST_AVAILABLE, or when a listed package version can no longer be loaded (a full node that keeps only each object's latest version lists replaced framework versions it no longer stores). Stacked on #28606.Rollout: deploy kv-rpc with #28561 before this GraphQL change. A GraphQL service whose ledger gRPC endpoint does not serve
ListSystemPackagesyet fails everyEpoch.systemPackagesread.Test plan
sui-indexer-alt-readerunit tests against a mockMovePackageService:LedgerGrpcReader::list_system_packagesreturns packages in server order, returnsNoneforOUT_OF_RANGEBELOW_EARLIEST_AVAILABLE, and fails onABOVE_LATEST_AVAILABLE.epochs/system_packages.move(forward, backward and cursor pagination) andtransactions/kind/end_of_epoch.movepass with unchanged snapshots.sui-indexer-alt-e2e-teststestget_package_parity_tests: a fullnode and kv-rpc on the same chain give the sameGetPackage,GetDatatype,GetFunction,ListPackageVersions(one lineage and every package, page tokens and cursors in both orders, each server continuing from the other's cursors) andListSystemPackagesanswers for a package published and upgraded twice and for the system packages, by storage ID, by version and at checkpoints around each publish.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.
Epoch.systemPackagesis read from the ledger gRPC service instead of Postgres. It resolves tonullfor an epoch the ledger service cannot serve: one that starts below its earliest available checkpoint, such as on a pruned full node, or one whose system package versions it no longer stores. Operators must point GraphQL at a ledger gRPC service (kv-rpc) that servesListSystemPackagesbefore upgrading GraphQL.