Skip to content

docs: updates for published source releases (4) - #1917

Open
solana-docs-checker[bot] wants to merge 4 commits into
mainfrom
bot/docs-check-rolling
Open

solana-docs-checker[bot] wants to merge 4 commits into
mainfrom
bot/docs-check-rolling

Conversation

@solana-docs-checker

@solana-docs-checker solana-docs-checker Bot commented Aug 15, 2026 •

Copy link
Copy Markdown

Documentation updates for published source releases

@catmcgee, this rolling PR contains documentation changes for newly published releases.

Each commit corresponds to one published release. Squash-merge or cherry-pick as appropriate.

Last checked: 2026-11-21T09:09:02.545Z UTC
Releases covered: 4
Files updated: 7
Findings needing manual review: 1

Releases covered by this branch

anza-xyz/kit@v7.1.0 — v7.1.0

Files updated:

  • apps/docs/content/docs/en/core/transactions/transaction-introspection.mdx

anza-xyz/kit-plugins@@solana/kit-plugin-rpc@0.16.0 — @solana/kit-plugin-rpc@0.16.0

Files updated:

  • apps/docs/content/docs/en/frontend/client.mdx

anza-xyz/solana-sdk@offchain-message@v3.0.1 — offchain-message@v3.0.1

Files updated:

  • apps/docs/content/docs/en/core/transactions/transaction-pipeline.mdx

anza-xyz/solana-sdk@reward-info@v7.0.0 — reward-info@v7.0.0

Files updated:

  • apps/docs/content/docs/en/core/accounts/account-runtime.mdx
  • apps/docs/content/docs/en/rpc/http/getblock.mdx
  • apps/docs/content/docs/en/rpc/json-structures.mdx
  • apps/docs/content/docs/en/core/accounts/account-types.mdx

Findings that need manual review

These findings could not be applied cleanly. Review them manually.

solana-foundation/solana-web3.js@v1.99.0 — @solana/web3.js v1.99.0

  • apps/docs/content/docs/en/payments/agentic-payments/intro-to-x402.mdx (high, original-file-not-found) — The inline comment in the USDC server example states that web3.js v1 cannot deserialize v1 transactions and instructs readers to use @solana/kit or web3.js v3 with maxSupportedTransactionVersion: 1. With the v1.99.0 release, @solana/web3.js (v1) now supports reading v1 transactions via the new MessageV1 class and VersionedTransaction.deserialize branch (TransactionVersion = 'legacy' | 0 | 1), so this claim is no longer true and the capped maxSupportedTransactionVersion: 0 is misleading for a v1-payment facilitator built on web3.js v1.

    Suggested edits

    find:

          // Fetch the transaction to verify payment details.
          // web3.js v1 cannot deserialize v1 transactions, so the max version is
          // capped at 0 here. A facilitator that must settle v1 payments needs
          // @solana/kit or web3.js v3 and a max version of 1.
          const confirmedTx = await connection.getTransaction(signature, {
            commitment: "confirmed",
            maxSupportedTransactionVersion: 0
          });
    

    replace:

          // Fetch the transaction to verify payment details.
          // @solana/web3.js v1.99.0+ can deserialize v1 transactions, so a
          // facilitator that must settle v1 payments can set
          // maxSupportedTransactionVersion to 1 once the v1 format is active.
          const confirmedTx = await connection.getTransaction(signature, {
            commitment: "confirmed",
            maxSupportedTransactionVersion: 1
          });
    

@vercel

vercel Bot commented Aug 15, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
solana-com-bldr Error Error Nov 21, 2026 9:12am UTC
solana-com-docs Ready Ready Preview Nov 21, 2026 9:12am UTC
solana-docs-preview Error Error Nov 21, 2026 9:12am UTC
5 Skipped Deployments
Project Deployment Actions Updated
solana-com Skipped Skipped Nov 21, 2026 9:12am UTC
solana-com-accelerate Skipped Skipped Nov 21, 2026 9:12am UTC
solana-com-breakpoint-2 Skipped Skipped Nov 21, 2026 9:12am UTC
solana-com-media Skipped Skipped Nov 21, 2026 9:12am UTC
templates Skipped Skipped Nov 21, 2026 9:12am UTC

Request Review

@vercel
vercel Bot temporarily deployed to Preview – solana-com-breakpoint-2 August 15, 2026 09:12 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com August 15, 2026 09:12 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-accelerate August 15, 2026 09:12 Inactive
@vercel
vercel Bot temporarily deployed to Preview – templates August 15, 2026 09:12 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-media August 15, 2026 09:12 Inactive
@greptile-apps

greptile-apps Bot commented Aug 15, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerView in GreptileConfidence Score: 5/5

[Low impact] The PR appears safe to merge, with two non-blocking documentation findings still open.

Findings

  1. P2 Unpinned BailOut Reference ▶
  2. P2 JSON encoding explained incorrectly ▶

Summary

Updates seven documentation pages for published Solana releases.

  • The introspection guide now covers more confirmed-transaction results.
  • The Rust sysvar example now uses wincode to read account data.
  • The reward docs now include VAT as a reward type.
  • The transaction error table now explains BailOut.
  • The RPC preset list now includes Solana testnet.
  • The loader list stays in the account-runtime page without its source link.

Reviews (100) · Last reviewed commit: "docs(anza-xyz/solana-sdk@reward-info@v7...." · Reviewed by Greptile

@solana-docs-checker
solana-docs-checker Bot force-pushed the bot/docs-check-rolling branch from d54d1c8 to 73d24cc Compare August 16, 2026 09:09
@vercel
vercel Bot temporarily deployed to Preview – solana-com-accelerate August 16, 2026 09:09 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-media August 16, 2026 09:09 Inactive
@vercel
vercel Bot temporarily deployed to Preview – templates August 16, 2026 09:09 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-breakpoint-2 August 16, 2026 09:09 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com August 16, 2026 09:09 Inactive
@solana-docs-checker
solana-docs-checker Bot force-pushed the bot/docs-check-rolling branch from 73d24cc to 309f486 Compare August 17, 2026 09:17
@vercel
vercel Bot temporarily deployed to Preview – templates August 17, 2026 09:17 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-accelerate August 17, 2026 09:17 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-media August 17, 2026 09:17 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-breakpoint-2 August 17, 2026 09:17 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com August 17, 2026 09:17 Inactive
@solana-docs-checker
solana-docs-checker Bot force-pushed the bot/docs-check-rolling branch from 309f486 to e71e165 Compare August 18, 2026 09:12
@vercel
vercel Bot temporarily deployed to Preview – solana-com-media August 18, 2026 09:12 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com August 23, 2026 09:09 Inactive
@vercel
vercel Bot temporarily deployed to Preview – templates August 23, 2026 09:09 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-accelerate August 23, 2026 09:09 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-media August 23, 2026 09:09 Inactive
@solana-docs-checker
solana-docs-checker Bot force-pushed the bot/docs-check-rolling branch from b9eca94 to 143fc58 Compare August 24, 2026 09:19
@vercel
vercel Bot temporarily deployed to Preview – solana-com-breakpoint-2 August 24, 2026 09:19 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-media August 24, 2026 09:19 Inactive
@solana-docs-checker

Copy link
Copy Markdown
Author

@catmcgee, new published release findings were added:

@h4rkl

h4rkl commented Sep 1, 2026

Copy link
Copy Markdown
Collaborator

Thanks for the contribution. Before this can proceed through review, please squash this PR to one commit and amend/sign that final commit so GitHub shows it as Verified.

The current head has 3 commit(s), and GitHub reports unsigned for the commit verification check.

Please force-push the updated branch when ready; we will re-run the review against the new head.

| [`UnbalancedTransaction`](https://github.com/anza-xyz/solana-sdk/blob/clock%40v2.2.3/transaction-error/src/lib.rs#L136) | Post-execution check | Total lamport balance before the transaction does not equal the balance after |
| [`ProgramCacheHitMaxLimit`](https://github.com/anza-xyz/solana-sdk/blob/clock%40v2.2.3/transaction-error/src/lib.rs#L139) | Account loading | Program cache hit max limit |
| [`CommitCancelled`](https://github.com/anza-xyz/solana-sdk/blob/clock%40v2.2.3/transaction-error/src/lib.rs#L142) | Commit | Commit cancelled internally |
| [`BailOut`](https://github.com/anza-xyz/solana-sdk/blob/master/transaction-error/src/lib.rs) | Block production | Block production bailed out; transaction is discarded to protect the leader and is explicitly excluded from consensus (does not propagate to followers) |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

P2 Unpinned BailOut Reference

This table is presented as the complete TransactionError enum, and every existing entry points to the immutable clock@v2.2.3 definition. The new BailOut entry is absent from that release and instead links to mutable master, so readers cannot verify the documented variant or behavior against the table's stated SDK version. Please link it to the specific release that introduced it or update the table's documented version.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

@solana-docs-checker

Copy link
Copy Markdown
Author

@catmcgee, new published release findings were added:

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Your trial has ended. Reactivate Greptile to resume code reviews.

@solana-docs-checker

Copy link
Copy Markdown
Author

@catmcgee, new published release findings were added:

@greptile-apps

greptile-apps Bot commented Sep 16, 2026

Copy link
Copy Markdown
Contributor

Want your agent to iterate on Greptile's feedback? Try greploops.

Comment on lines +106 to +108
`map` over them. Note that the `'json'` overload's `transaction` is typed as
`never`: the JSON path decompiles the message server-side, so there are no
re-encodable wire bytes to return.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

P2 JSON encoding explained incorrectly

The new callout says json decompiles the message on the server, but json returns compiled instructions with account indexes. Server-side parsing belongs to jsonParsed, which this page correctly says the decoder rejects. This blurs the difference between the encodings and makes it harder for readers to choose one.

Remove the server-side claim and explain only that the json response does not include serialized transaction bytes.

Suggested change
`map` over them. Note that the `'json'` overload's `transaction` is typed as
`never`: the JSON path decompiles the message server-side, so there are no
re-encodable wire bytes to return.
`map` over them. Note that the `'json'` overload's `transaction` is typed as
`never`: the JSON response contains compiled instructions rather than
serialized transaction bytes.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

catmcgee
catmcgee previously approved these changes Oct 12, 2026
jacobcreech
jacobcreech previously approved these changes Oct 12, 2026

@ababove20-jpg ababove20-jpg left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

This section clearly outlines the necessary checks for program accounts, ensuring that only valid loaders are used and that transactions fail gracefully when accounts are missing or misconfigured. It helps maintain the integrity and security of program execution on Solana.

This branch had an error being deployed

1 failed (outdated), 1 active, and 5 inactive deployments
Preview – solana-com-docs — 6189ef81 Deployed Nov 21, 2026 by vercel[bot]
Preview – solana-com-breakpoint-2 — 6189ef81 Deployed Nov 21, 2026 by vercel[bot]
Preview – solana-com — 6189ef81 Deployed Nov 21, 2026 by vercel[bot]
Preview – templates — 6189ef81 Deployed Nov 21, 2026 by vercel[bot]
Preview – solana-com-media — 6189ef81 Deployed Nov 21, 2026 by vercel[bot]
Preview – solana-com-accelerate — 6189ef81 Deployed Nov 21, 2026 by vercel[bot]
Preview – solana-docs-preview — b76d4389 Deployed Oct 15, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants