Skip to content

[docs-agent] Add Preconfirmations gRPC Subscribe page - #1734

Merged
vahnag merged 2 commits into
mainfrom
docs-agent/preconf-grpc-subscribe
Oct 30, 2026
Merged

vahnag merged 2 commits into
mainfrom
docs-agent/preconf-grpc-subscribe

Conversation

@alchemy-bot

Copy link
Copy Markdown
Contributor

Summary

Documents the new alchemy.preconf.v1.Preconf/Subscribe server-streaming gRPC method that streams Solana transactions from Jito BAM nodes as they are sequenced into a block, before the block lands on-chain.

The new page is a standalone section in the chains tab, sibling to Yellowstone gRPC (per follow-up guidance in the Slack thread: "let's put it separated from Yellowstone gRPC since it is a different method"):

  • Nav section: Preconfirmations gRPC → Subscribe to Preconfirmed Transactions
  • Slug: /docs/reference/preconf-grpc-subscribe
  • File: content/api-reference/preconf/subscribe.mdx

Content follows the structure of the source documentation: endpoint + auth, grpcurl example, filter structure proto, per-field reference, response structure, delivery semantics, pricing, errors, and the full .proto at the bottom. The page notes that alchemy.preconf.v1.Preconf is a separate service from Yellowstone's geyser.Geyser but shares the streaming.alchemy.com:443 host and x-token auth, and cross-links to the Yellowstone overview.

Also adds a Preconfirmations gRPC discovery card to the two "Standard APIs" overview pages that already surface Yellowstone gRPC:

  • content/api-reference/introduction/api-overview.mdx
  • content/api-reference/node-api/chain-apis-overview.mdx

Validation

  • pnpm run validate:docs-yml → ✅
  • npx prettier --check on all four touched files → ✅

Not included (open questions)

  • No per-method CU row added to content/api-reference/pricing-resources/pricing/compute-unit-costs.mdx. Preconf pricing (max(100 × n, 3,000) CU per slot) is documented on the new page itself but doesn't fit the existing bandwidth or per-method CU tables cleanly. Happy to add a dedicated section there as a follow-up if desired.

Requested by

@andreidg31 (via Slack thread)

Documents the alchemy.preconf.v1.Preconf/Subscribe server-streaming gRPC method that streams Solana transactions from Jito BAM nodes before they land on-chain. New page lives under a standalone "Preconfirmations gRPC" nav section (sibling to Yellowstone gRPC) with slug reference/preconf-grpc-subscribe. Also adds a discovery card to the API Overview and Chain APIs overview.

Requested-by: @andreidg31
@alchemy-bot
alchemy-bot requested a review from a team as a code owner October 29, 2026 10:23
@github-actions

github-actions Bot commented Oct 29, 2026 •

Copy link
Copy Markdown

🔗 Preview Mode

Name Status Preview Updated (UTC)
Alchemy Docs ✅ Ready 🔗 Visit Preview Oct 29, 2026, 10:33 AM

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-29T10:26:33.215998Z 38e7ab3 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

…nces

Per Andrei's follow-up in the Slack thread, remove the explicit :443 TLS port from the endpoint / grpcurl example and drop the <Info> + inline cross-link that compared the Preconf service to Yellowstone gRPC. The page now stands on its own without framing Preconfirmations as a sibling-of-Yellowstone service.

Requested-by: @andreidg31
@vahnag
vahnag merged commit 0519c91 into main Oct 30, 2026
14 of 15 checks passed
@vahnag
vahnag deleted the docs-agent/preconf-grpc-subscribe branch October 30, 2026 09:23
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