Skip to content

docs: add advanced transaction guides and examples - #1995

Closed
catmcgee wants to merge 8 commits into
solana-foundation:mainfrom
catmcgee:catmcgee/dev-190-durable-nonce-example
Closed

catmcgee wants to merge 8 commits into
solana-foundation:mainfrom
catmcgee:catmcgee/dev-190-durable-nonce-example

Conversation

@catmcgee

@catmcgee catmcgee commented Aug 27, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • add a complete durable nonce account and transaction example using Solana Kit
  • add an address lookup table example that compiles and submits a versioned transaction
  • add a partial transaction signing guide covering independent signers, signature verification, and transaction lifetime
  • include type-checked Surfpool examples for the transaction workflows

Fixes DEV-190
Fixes DEV-191
Fixes DEV-950

@vercel

vercel Bot commented Aug 27, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
solana-com-docs Ready Ready Preview Sep 8, 2026 3:54pm UTC
5 Skipped Deployments
Project Deployment Actions Updated
solana-com Skipped Skipped Sep 8, 2026 3:54pm UTC
solana-com-accelerate Skipped Skipped Sep 8, 2026 3:54pm UTC
solana-com-breakpoint-2 Skipped Skipped Sep 8, 2026 3:54pm UTC
solana-com-media Skipped Skipped Sep 8, 2026 3:54pm UTC
templates Skipped Skipped Sep 8, 2026 3:54pm UTC

Request Review

@vercel
vercel Bot temporarily deployed to Preview – templates August 27, 2026 19:25 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com August 27, 2026 19:25 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-breakpoint-2 August 27, 2026 19:25 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-accelerate August 27, 2026 19:25 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-media August 27, 2026 19:25 Inactive
@vercel

vercel Bot commented Aug 27, 2026

Copy link
Copy Markdown

@catmcgee is attempting to deploy a commit to the Solana Foundation Team on Vercel.

A member of the Team first needs to authorize it.

@greptile-apps

greptile-apps Bot commented Aug 27, 2026 •

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR adds advanced transaction documentation and executable examples.

  • Adds a Solana Kit durable-nonce account and transfer workflow with runtime coverage.
  • Adds a partial-signing guide demonstrating immutable message bytes, independent signatures, verification, assembly, and submission.
  • Adds an address lookup table example that creates and extends a table before submitting a v0 transaction.
  • Redirects the former offline-transactions cookbook entry to the canonical partial-signing guide.
  • Updates signature assertions to support examples running against a dedicated validator.

Confidence Score: 5/5

The PR appears safe to merge, with no outstanding correctness, security, or repository-rule findings.

The new examples have corresponding runtime coverage and correctly route signature verification to the validator that processed each transaction. The prior durable-nonce coverage finding was manually resolved after coverage was added.

Important Files Changed

Filename Overview
packages/docs-examples/cookbook/transactions/durable-nonce/kit.ts Creates, initializes, and exercises a durable nonce account using Solana Kit.
packages/docs-examples/cookbook/transactions/durable-nonce/kit.test.ts Adds the runtime coverage requested by the previous review; that previous thread is manually resolved.
packages/docs-examples/cookbook/transactions/partial-signing/legacy.ts Demonstrates independent Ed25519 signing, signature verification, transaction assembly, and submission.
packages/docs-examples/cookbook/transactions/versioned-transaction-alt/legacy.ts Creates and extends an address lookup table and uses it in a submitted v0 transaction.
packages/docs-examples/cookbook/transactions/versioned-transaction-alt/legacy.test.ts Runs the ALT example against an isolated local validator and cleans up its process and ledger.
packages/docs-examples/test/assert-signature.ts Selects the transaction-verification RPC at call time so dedicated-validator examples are checked correctly.
apps/docs/content/docs/en/core/transactions/partial-signing.mdx Adds the canonical guide for coordinating, verifying, and submitting independently collected signatures.

Reviews (4): Last reviewed commit: "Merge remote-tracking branch 'upstream/m..." | Re-trigger Greptile

Comment thread packages/docs-examples/cookbook/transactions/durable-nonce/kit.ts
@vercel
vercel Bot temporarily deployed to Preview – solana-com-media August 27, 2026 20:16 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com August 27, 2026 20:16 Inactive
@vercel
vercel Bot temporarily deployed to Preview – templates August 27, 2026 20:16 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-accelerate August 27, 2026 20:16 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-breakpoint-2 August 27, 2026 20:16 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-accelerate August 28, 2026 15:28 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-media August 28, 2026 15:28 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com-breakpoint-2 August 28, 2026 15:28 Inactive
@vercel
vercel Bot temporarily deployed to Preview – solana-com August 28, 2026 15:28 Inactive
@vercel
vercel Bot temporarily deployed to Preview – templates August 28, 2026 15:28 Inactive
@catmcgee catmcgee changed the title DEV-190 Add durable nonce transaction example docs: add advanced transaction guides and examples Aug 28, 2026
@catmcgee

Copy link
Copy Markdown
Contributor Author

Superseded by #2127, which consolidates this with the other five overlapping docs PRs. Closing here — the work is carried over intact, and the conflicts between these branches are resolved there deliberately rather than by whichever merged last.

Closing in favour of #2127.

@catmcgee catmcgee closed this Sep 17, 2026
catmcgee added a commit to catmcgee/solana-com that referenced this pull request Sep 17, 2026
Consolidates six docs PRs that were individually mergeable but overlapped each
other, so whichever landed second would have conflicted — most sharply solana-foundation#1974
and solana-foundation#1910, which shared 22 files and both moved pages out of Payments into
Resources. Reviewing them separately meant reviewing an intermediate structure
that would never exist.

Supersedes solana-foundation#1910, solana-foundation#1974, solana-foundation#1980, solana-foundation#1981, solana-foundation#1975 and solana-foundation#1995.
Tickets: DEV-190, DEV-191, DEV-196, DEV-187, DEV-944, DEV-945, DEV-949, DEV-969.

Four conflicts were resolved to keep both sides' intent:

- en/payments/meta.json — agentic-payments would have been duplicated and
  production-readiness had to be dropped, since solana-foundation#1974 moves it to tools.
- apps/docs/next.config.ts — both PRs add redirects; all are kept, and each
  moved route now generates a .md twin, because the web app forwards raw
  markdown requests with .md intact.
- en/references/meta.json — solana-foundation#1981 adds solana-cli/spl-token-cli from a base
  that still had feature-gates, which solana-foundation#1980 retires. Kept the additions,
  honoured the removal, and verified every remaining nav entry resolves.
- en/programs/examples.mdx — solana-foundation#1975 adds Pinocchio to every row; main had
  gained a linked Realloc description. Both kept.

The consolidation also caught four cross-PR defects no single PR could have
surfaced: three links to routes another PR had moved, and a stale anchor.
catmcgee added a commit that referenced this pull request Sep 17, 2026
Consolidates six docs PRs that were individually mergeable but overlapped each
other, so whichever landed second would have conflicted — most sharply #1974
and #1910, which shared 22 files and both moved pages out of Payments into
Resources. Reviewing them separately meant reviewing an intermediate structure
that would never exist.

Supersedes #1910, #1974, #1980, #1981, #1975 and #1995.
Tickets: DEV-190, DEV-191, DEV-196, DEV-187, DEV-944, DEV-945, DEV-949, DEV-969.

Four conflicts were resolved to keep both sides' intent:

- en/payments/meta.json — agentic-payments would have been duplicated and
  production-readiness had to be dropped, since #1974 moves it to tools.
- apps/docs/next.config.ts — both PRs add redirects; all are kept, and each
  moved route now generates a .md twin, because the web app forwards raw
  markdown requests with .md intact.
- en/references/meta.json — #1981 adds solana-cli/spl-token-cli from a base
  that still had feature-gates, which #1980 retires. Kept the additions,
  honoured the removal, and verified every remaining nav entry resolves.
- en/programs/examples.mdx — #1975 adds Pinocchio to every row; main had
  gained a linked Realloc description. Both kept.

The consolidation also caught four cross-PR defects no single PR could have
surfaced: three links to routes another PR had moved, and a stale anchor.

This branch was successfully deployed

1 active and 5 inactive deployments
Preview – solana-com-docs — 8702c613 Deployed Sep 8, 2026 by vercel[bot]
Preview – solana-com-media — 8702c613 Deployed Sep 8, 2026 by vercel[bot]
Preview – solana-com-accelerate — 8702c613 Deployed Sep 8, 2026 by vercel[bot]
Preview – solana-com — 8702c613 Deployed Sep 8, 2026 by vercel[bot]
Preview – templates — 8702c613 Deployed Sep 8, 2026 by vercel[bot]
Preview – solana-com-breakpoint-2 — 8702c613 Deployed Sep 8, 2026 by vercel[bot]
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