Skip to content

[Writer] docs(solana): separate API overview into Core RPC, DAS, and Photon sections#1238

Open
JackReacher0807 wants to merge 3 commits intomainfrom
docs/writer/solana-api-overview-sections
Open

[Writer] docs(solana): separate API overview into Core RPC, DAS, and Photon sections#1238
JackReacher0807 wants to merge 3 commits intomainfrom
docs/writer/solana-api-overview-sections

Conversation

@JackReacher0807
Copy link
Copy Markdown
Collaborator

Summary

Reorganizes content/api-reference/solana/solana-api-overview.mdx into three clearly-labeled H2 sections so developers can quickly find the method they need instead of scanning one long alphabetical table that mixes three different API surfaces.

New structure

  1. Core Solana RPC methods — standard solana-rpc methods (getAccountInfo, getBalance, getBlock, sendTransaction, etc.)
  2. DAS API (Digital Asset Standard) — Metaplex-defined NFT/asset methods (getAsset, getAssetsByOwner, searchAssets, getNftEditions, …). Links each method to the existing DAS reference at /docs/reference/alchemy-das-apis-for-solana.
  3. Photon API (ZK Compression) — compressed-account and validity-proof methods (getCompressed*, getValidityProof*, getMultipleCompressedAccounts, getIndexerHealth, …). Includes a note that these methods are powered by the Helius Photon indexer.

Verification

  • Every method currently listed in src/openrpc/chains/solana/solana.yaml ends up in exactly one section; all existing endpoint links are preserved.
  • No OpenRPC specs were modified — this is a presentation-only change.
  • docs.yml nav structure is unchanged.

Context

Linear: DOCS-45

Requested by @cosmin on Slack.

…ctions

Reorganize the Solana API overview page into three clearly-labeled sections
so users can tell at a glance which methods belong to the core Solana JSON-RPC
surface, the Metaplex DAS API, and the Photon (ZK Compression) API.

- Adds short intro for each surface
- Links DAS methods to the dedicated /docs/reference/alchemy-das-apis-for-solana page
- Notes that Photon methods are powered by the Helius Photon indexer
- Preserves every existing endpoint link; no OpenRPC spec changes

Requested by @cosmin on Slack.
@JackReacher0807 JackReacher0807 requested a review from a team as a code owner April 20, 2026 18:17
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 20, 2026

🔗 Preview Mode

Name Status Preview Updated (UTC)
Alchemy Docs ✅ Ready 🔗 Visit Preview Apr 20, 2026, 8:12 PM

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 8a081990dd

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".


## Core Solana RPC methods

Standard Solana JSON-RPC methods for reading on-chain state, submitting transactions, and inspecting the cluster. These match the official [Solana RPC specification](https://solana.com/docs/rpc) and are supported on every Alchemy Solana endpoint.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Fix Core RPC portability claim

This new sentence states that methods in this section match the official Solana RPC spec and are supported on every Alchemy Solana endpoint, but the same table includes getPriorityFeeEstimate and simulateBundle (lines 34 and 46), which are documented as provider-specific functionality (getPriorityFeeEstimate recommendation logic and Jito bundle simulation in src/openrpc/chains/_components/solana/methods.yaml, lines 643 and 886). This can mislead readers about cross-provider compatibility, so the wording should be narrowed or those methods separated.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Addressed in 4a4456b. Moved getPriorityFeeEstimate and simulateBundle into a new ### Alchemy-specific extensions subsection under Core Solana RPC methods, with a note that they are not part of the official Solana RPC specification and are not available on other Solana RPC providers. The Core RPC table now only lists methods from the official Solana RPC spec that work against any provider.

| [`getAssetsByAuthority`](/docs/reference/alchemy-das-apis-for-solana/solana-das-api-endpoints/get-assets-by-authority) | [`getAssetsByCreator`](/docs/reference/alchemy-das-apis-for-solana/solana-das-api-endpoints/get-assets-by-creator) |
| [`getAssetsByGroup`](/docs/reference/alchemy-das-apis-for-solana/solana-das-api-endpoints/get-assets-by-group) | [`getAssetsByOwner`](/docs/reference/alchemy-das-apis-for-solana/solana-das-api-endpoints/get-assets-by-owner) |
| [`getAssetSignatures`](/docs/reference/alchemy-das-apis-for-solana/solana-das-api-endpoints/get-asset-signatures) | [`getNftEditions`](/docs/reference/alchemy-das-apis-for-solana/solana-das-api-endpoints/get-nft-editions) |
| [`searchAssets`](/docs/reference/alchemy-das-apis-for-solana/solana-das-api-endpoints/search-assets) | |
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Include getTokenAccounts in DAS overview table

The DAS section is presented as the method list for this API surface, but getTokenAccounts is missing even though it is part of the DAS reference methods table (content/api-reference/data/nft-api/alchemy-das-apis-for-solana.mdx, Methods section). Users using this page as the overview can incorrectly conclude that getTokenAccounts is unavailable from the Solana DAS surface.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Already addressed in the previous commit 198d4f7getTokenAccounts is in the DAS API table on line 68 of the current file. You can verify with: grep getTokenAccounts content/api-reference/solana/solana-api-overview.mdx. Matches the method list in content/api-reference/data/nft-api/alchemy-das-apis-for-solana.mdx.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 20, 2026

🔍 Link Check

Status: ❌ Failed

Summary

Status Count
🔍 Total 7910
✅ Successful 6757
⏳ Timeouts 0
🔀 Redirected 398
👻 Excluded 674
❓ Unknown 0
🚫 Errors 80
⛔ Unsupported 1
Broken links (80) — click to expand

Errors per input

Errors in ./content/wallets/pages/bundler-api/bundler-faqs.mdx

Errors in ./content/api-reference/op-mainnet/op-mainnet-api-faq/op-mainnet-api-faq.mdx

Errors in ./content/wallets/pages/recipes/smart-wallets-aave.mdx

Errors in ./content/wallets/pages/smart-wallets/how-to-stamp-requests.mdx

Errors in ./content/wallets/pages/concepts/smart-account-client.mdx

Errors in ./content/wallets/pages/smart-wallets/quickstart/index.mdx

Errors in ./content/wallets/pages/index.mdx

Errors in ./content/wallets/pages/authentication/overview.mdx

Errors in ./content/api-reference/introduction/api-overview.mdx

Errors in ./content/tutorials/alchemy-university/smart-contract-basics/multi-sig-contracts.mdx

Errors in ./content/wallets/pages/recipes/send-usdc.mdx

Errors in ./content/wallets/pages/recipes/upgrade-to-smart-accounts.mdx

Errors in ./content/wallets/pages/react-native/getting-started/getting-started-expo.mdx

Errors in ./content/changelog/2025-08-28.md

Errors in ./content/api-reference/hyperevm/hyperevm-api-overview.mdx

Errors in ./content/wallets/pages/react-native/getting-started/getting-started-rn-bare.mdx

Errors in ./content/changelog/2026-04-09.md

Errors in ./content/api-reference/katana/katana-api-overview.mdx

Errors in ./content/changelog/2025-09-18.md

Errors in ./content/changelog/2026-03-26.md

Errors in ./content/api-reference/arbitrum-nova/arbitrum-nova-deprecation-notice.mdx

Errors in ./content/api-reference/arbitrum/arbitrum-api-faq/arbitrum-api-faq.mdx

Errors in ./content/wallets/pages/recipes/onramp-funds.mdx

View workflow run

Copy link
Copy Markdown
Contributor

@cosmingamanusi cosmingamanusi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image section not created

- Address Codex P2: narrow Core RPC portability claim to strictly standard
  Solana RPC methods; move getPriorityFeeEstimate and simulateBundle into a
  new ### Alchemy-specific extensions subsection with a note that they are
  not available on other Solana RPC providers.
- Addresses Cosmin's CHANGES_REQUESTED feedback on PR #1238.
@JackReacher0807
Copy link
Copy Markdown
Collaborator Author

@cosmingamanusi thanks for the re-review! A couple of things:

  1. Your screenshot URL (user-attachments/assets/73841f3e-df3a-4ffe-bfb7-aa23378b8abb) returns 404 for me — it looks like the GitHub attachment expired or isn't publicly reachable, so I couldn't see exactly which section was missing in the render you saw. Could you re-upload the screenshot or name the specific section?

  2. For reference, the current file at content/api-reference/solana/solana-api-overview.mdx has 5 H2/H3 section headings as of commit 4a4456b:

    • ## Solana APIs (intro)
    • ## Core Solana RPC methods
      • ### Alchemy-specific extensions (new — see below)
    • ## DAS API (Digital Asset Standard)
    • ## Photon API (ZK Compression)
  3. Based on the parallel Codex review, I also split out getPriorityFeeEstimate and simulateBundle into a new ### Alchemy-specific extensions subsection under Core RPC, so the Core RPC table is now strictly the official Solana JSON-RPC spec methods.

  4. Fresh preview should be up shortly at the URL in the preview comment above — would you mind taking another look and confirming whether the missing section issue is resolved? If something is still not rendering, a fresh screenshot would help a lot.

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.

2 participants