Skip to content

[docs-agent] Add 5 missing Sui gRPC method reference pages - #1580

Merged
oskarciupider-alchemy merged 1 commit into
mainfrom
docs/sui-grpc-list-and-subscribe-methods
Aug 31, 2026
Merged

[docs-agent] Add 5 missing Sui gRPC method reference pages#1580
oskarciupider-alchemy merged 1 commit into
mainfrom
docs/sui-grpc-list-and-subscribe-methods

Conversation

@alchemy-bot

Copy link
Copy Markdown
Contributor

Summary

Adds per-method reference documentation for the 5 sui.rpc.v2 methods that already reach sui-mainnet.g.alchemy.com:443 but aren't documented today:

  • LedgerService/ListCheckpoints, ListTransactions, ListEvents — server-streaming, cursor-bounded via QueryOptions + Watermark + QueryEnd.
  • SubscriptionService/SubscribeTransactions, SubscribeEvents — server-streaming from the current tip.

Files touched:

  • content/api-reference/sui-grpc/objects-and-ledger.mdx — 3 new List* sections appended in the existing per-method format (Request table, Response table, grpcurl example, Note where useful).
  • content/api-reference/sui-grpc/subscriptions.mdx — 2 new Subscribe* sections appended, same shape as SubscribeCheckpoints.
  • content/api-reference/sui-grpc/overview.mdx — 3 new rows in the LedgerService table, 2 new rows in the SubscriptionService table, and the SubscriptionService intro re-worded (previously checkpoint-only) plus the "Streaming support" bullet in the top-of-page pitch broadened.

Canonical source for all shapes: MystenLabs/sui-apis @ proto/sui/rpc/v2/{ledger_service,subscription_service,filter,query_options}.proto.

Related

Not in scope (natural follow-up)

The 3 LedgerService/List* methods are isStreaming: true in Alchemy's topconfig.yml but are NOT registered under multi_network_ws.yml grpc_stream_configs for SUI_MAINNET, so they currently bill at the default cu_per_byte: 0.04 (~200x higher than Yellowstone's $75/TB rate). That's an OMGWINNING/chain-config change, deliberately deferred per the requester's ordering. Filing separately after this lands.

Linear

DOCS-210 - https://linear.app/alchemyapi/issue/DOCS-210/add-5-missing-sui-grpc-method-reference-pages-ledgerservicelist

Requested by

@oskarciupider-alchemy (via Slack thread)

Adds per-method reference documentation for the 5 sui.rpc.v2 methods already
reachable on sui-mainnet.g.alchemy.com:443 but not yet documented:

* LedgerService/ListCheckpoints, ListTransactions, ListEvents
  (server-streaming, cursor-bounded via QueryOptions + Watermark + QueryEnd)
* SubscriptionService/SubscribeTransactions, SubscribeEvents
  (server-streaming from tip, TransactionFilter/EventFilter)

Also updates the sui-grpc overview page to list the new methods under
LedgerService and SubscriptionService, and broadens the SubscriptionService
intro (previously described as checkpoint-only) plus the streaming bullet on
the "Why Sui gRPC?" section.

Source for all shapes: MystenLabs/sui-apis @ proto/sui/rpc/v2/{ledger_service,
subscription_service,filter,query_options}.proto.

Refs DOCS-210

Requested-by: @oskarciupider-alchemy
@alchemy-bot
alchemy-bot requested a review from a team as a code owner August 28, 2026 17:36
@github-actions

github-actions Bot commented Aug 28, 2026

Copy link
Copy Markdown

🔗 Preview Mode

Name Status Preview Updated (UTC)
Alchemy Docs ✅ Ready 🔗 Visit Preview Aug 28, 2026, 5:37 PM

@oskarciupider-alchemy
oskarciupider-alchemy merged commit 59f5cec into main Aug 31, 2026
15 of 16 checks passed
@oskarciupider-alchemy
oskarciupider-alchemy deleted the docs/sui-grpc-list-and-subscribe-methods branch August 31, 2026 12:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants