Skip to content

[docs-agent] Point Solana subscription + Yellowstone gRPC mainnet docs at streaming.alchemy.com - #1568

Open
alchemy-bot wants to merge 1 commit into
mainfrom
docs/solana-streaming-mainnet-endpoint
Open

[docs-agent] Point Solana subscription + Yellowstone gRPC mainnet docs at streaming.alchemy.com#1568
alchemy-bot wants to merge 1 commit into
mainfrom
docs/solana-streaming-mainnet-endpoint

Conversation

@alchemy-bot

Copy link
Copy Markdown
Contributor

Summary

Points the Solana Subscription API (WebSocket) and Yellowstone gRPC docs at Alchemy's new streaming host on Mainnet, while keeping Devnet on the existing g.alchemy.com host.

Mainnet:

  • WebSocket subscriptions: wss://solana-mainnet.streaming.alchemy.com/v2/<key>
  • Yellowstone gRPC: https://solana-mainnet.streaming.alchemy.com

Devnet (unchanged):

  • WebSocket subscriptions: wss://solana-devnet.g.alchemy.com/v2/<key>
  • Yellowstone gRPC: https://solana-devnet.g.alchemy.com

Live-verified: solana-mainnet.streaming.alchemy.com serves HTTP/2 with content-type: application/grpc on gRPC POST paths and accepts WSS upgrades, but returns 404 on plain HTTP JSON-RPC methods like getBlockHeight / getSlot. That's why the plain HTTP JSON-RPC references in the WebSocket pages (the @solana/web3.js Connection HTTP endpoint alongside wsEndpoint) and in historical-replay.mdx's getSlot helper stay on .g.alchemy.com.

Changes

Solana Subscription API (WebSocket)content/api-reference/websockets/solana-subscription-api-endpoints/:

  • solana-subscription-api-endpoints.mdx: rewritten Mainnet/Devnet URL block into a CodeGroup and updated the Info callout to flag the different host bases (the previous "swap solana-mainnet for solana-devnet in the URL above" instruction no longer works because the host base itself changes).
  • account-subscribe.mdx, logs-subscribe.mdx, program-subscribe.mdx, root-subscribe.mdx, signature-subscribe.mdx, slot-subscribe.mdx: swapped every wss://solana-mainnet.g.alchemy.com/v2/...wss://solana-mainnet.streaming.alchemy.com/v2/... (both wscat and wsEndpoint references). Left the https:// HTTP RPC endpoint used by @solana/web3.js Connection on .g.alchemy.com because the streaming host does not serve HTTP JSON-RPC.

Yellowstone gRPCcontent/api-reference/yellowstone/:

  • overview.mdx: updated Mainnet URL in the "supported on both Mainnet and Devnet" Info box.
  • quickstart.mdx: Info box + both Rust code samples.
  • examples.mdx: 3 endpoint references in the Rust snippets.
  • historical-replay.mdx: swapped the GeyserGrpcClient::build_from_shared endpoint. Left the two .post(format!("https://solana-mainnet.g.alchemy.com/v2/{}", api_key)) calls in the get_current_slot helpers untouched — those are HTTP JSON-RPC, not gRPC.

Not touched

  • content/api-reference/solana/ HTTP JSON-RPC pages.
  • content/api-reference/pricing-resources/pricing/compute-unit-costs.mdx.
  • Any other chain's docs.
  • The docs/solana-block-subscribe branch (PR still in review for DOCS-205) already introduced the streaming URL on the new block-subscribe.mdx page; this PR extends the same host to the rest of the subscription surface. No conflicts expected.

Linear

DOCS-206 — https://linear.app/alchemyapi/issue/DOCS-206/point-solana-subscription-api-yellowstone-grpc-mainnet-docs-at

Requested by

@victorbware (via Slack thread)

…s at streaming.alchemy.com

Solana Subscription API (WebSocket) and Yellowstone gRPC docs now point Mainnet at the new streaming host (`solana-mainnet.streaming.alchemy.com`) while keeping Devnet on the existing `solana-devnet.g.alchemy.com` host. Verified live: streaming host serves HTTP/2 gRPC + WSS subscriptions but 404s on plain HTTP JSON-RPC, so the HTTP JSON-RPC endpoint that appears alongside `wsEndpoint` in @solana/web3.js snippets stays on `.g.alchemy.com`; the two `getSlot` helper calls in the historical-replay guide stay on `.g.alchemy.com` for the same reason.

Overview page `solana-subscription-api-endpoints.mdx` gets an explicit Mainnet/Devnet code group and rewritten Info callout that flags the different host bases (users can no longer just swap `solana-mainnet` for `solana-devnet`).

Refs DOCS-206

Requested-by: @
@alchemy-bot
alchemy-bot requested a review from a team as a code owner August 26, 2026 08:09
@github-actions

github-actions Bot commented Aug 26, 2026

Copy link
Copy Markdown

🔗 Preview Mode

Name Status Preview Updated (UTC)
Alchemy Docs ✅ Ready 🔗 Visit Preview Aug 26, 2026, 8:10 AM

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.

1 participant