Add `passthroughFailedTransactionPlanExecution` helper by lorisleiva · Pull Request #1235 · anza-xyz/kit

lorisleiva · 2026-01-23T17:01:12Z

Problem

When executing a transaction plan, if any transaction fails, the executor throws a SOLANA_ERROR__INSTRUCTION_PLANS__FAILED_TO_EXECUTE_TRANSACTION_PLAN error which contains the failed TransactionPlanResult in its error context. This means developers must use try/catch to handle TransactionPlanResults in both success and failure cases.

Summary of Changes

This PR adds a passthroughFailedTransactionPlanExecution helper function that wraps a transaction plan execution promise and returns the TransactionPlanResult regardless of whether execution succeeded or failed.

Example Usage

// Before: duplicated result handling logic
let result: TransactionPlanResult;
try {
    result = await transactionPlanExecutor(transactionPlan);
    // handle successful execution result...
} catch (error) {
    if (isSolanaError(error, SOLANA_ERROR__INSTRUCTION_PLANS__FAILED_TO_EXECUTE_TRANSACTION_PLAN)) {
        result = error.context.transactionPlanResult;
        // handle failed execution result...
    }
    throw error;
}

// After: unified result handling
const result = await passthroughFailedTransactionPlanExecution(transactionPlanExecutor(transactionPlan));

// handle execution result regardless of success or failure. For instance:
const summary = summarizeTransactionPlanResult(result);
if (summary.successful) {
    console.log('All transactions executed successfully');
} else {
    console.log(`${summary.successfulTransactions.length} succeeded`);
    console.log(`${summary.failedTransactions.length} failed`);
    console.log(`${summary.canceledTransactions.length} canceled`);
}

changeset-bot · 2026-01-23T17:01:16Z

🦋 Changeset detected

Latest commit: f8b985f

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 43 packages

Name	Type
@solana/instruction-plans	Minor
@solana/kit	Minor
@solana/accounts	Minor
@solana/addresses	Minor
@solana/assertions	Minor
@solana/codecs-core	Minor
@solana/codecs-data-structures	Minor
@solana/codecs-numbers	Minor
@solana/codecs-strings	Minor
@solana/codecs	Minor
@solana/compat	Minor
@solana/errors	Minor
@solana/fast-stable-stringify	Minor
@solana/functional	Minor
@solana/instructions	Minor
@solana/keys	Minor
@solana/nominal-types	Minor
@solana/offchain-messages	Minor
@solana/options	Minor
@solana/plugin-core	Minor
@solana/programs	Minor
@solana/promises	Minor
@solana/react	Minor
@solana/rpc-api	Minor
@solana/rpc-graphql	Minor
@solana/rpc-parsed-types	Minor
@solana/rpc-spec-types	Minor
@solana/rpc-spec	Minor
@solana/rpc-subscriptions-api	Minor
@solana/rpc-subscriptions-channel-websocket	Minor
@solana/rpc-subscriptions-spec	Minor
@solana/rpc-subscriptions	Minor
@solana/rpc-transformers	Minor
@solana/rpc-transport-http	Minor
@solana/rpc-types	Minor
@solana/rpc	Minor
@solana/signers	Minor
@solana/subscribable	Minor
@solana/sysvars	Minor
@solana/transaction-confirmation	Minor
@solana/transaction-messages	Minor
@solana/transactions	Minor
@solana/webcrypto-ed25519-polyfill	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

lorisleiva · 2026-01-23T17:01:32Z

Add passthroughFailedTransactionPlanExecution helper #1235 👈 (View in Graphite)
main

This stack of pull requests is managed by Graphite. Learn more about stacking.

bundlemon · 2026-01-23T17:03:39Z

BundleMon

Files updated (4)

Status	Path	Size	Limits
✅	instruction-plans/dist/index.browser.mjs	4.11KB (+56B +1.35%)	-
✅	instruction-plans/dist/index.node.mjs	4.11KB (+56B +1.35%)	-
✅	instruction-plans/dist/index.native.mjs	4.11KB (+55B +1.32%)	-
✅	@solana/kit production bundle _{kit/dist/index.production.min.js}	39.67KB (+45B +0.11%)	-

Unchanged files (132)

Status	Path	Size	Limits
✅	rpc-graphql/dist/index.browser.mjs	18.82KB	-
✅	rpc-graphql/dist/index.native.mjs	18.81KB	-
✅	rpc-graphql/dist/index.node.mjs	18.81KB	-
✅	errors/dist/index.node.mjs	17.22KB	-
✅	errors/dist/index.browser.mjs	17.2KB	-
✅	errors/dist/index.native.mjs	17.2KB	-
✅	transaction-messages/dist/index.browser.mjs	7.29KB	-
✅	transaction-messages/dist/index.native.mjs	7.29KB	-
✅	transaction-messages/dist/index.node.mjs	7.29KB	-
✅	offchain-messages/dist/index.browser.mjs	4.89KB	-
✅	offchain-messages/dist/index.native.mjs	4.89KB	-
✅	offchain-messages/dist/index.node.mjs	4.89KB	-
✅	codecs-data-structures/dist/index.browser.mjs	4.69KB	-
✅	codecs-data-structures/dist/index.native.mjs	4.69KB	-
✅	codecs-data-structures/dist/index.node.mjs	4.69KB	-
✅	codecs-core/dist/index.browser.mjs	3.61KB	-
✅	codecs-core/dist/index.native.mjs	3.61KB	-
✅	codecs-core/dist/index.node.mjs	3.61KB	-
✅	webcrypto-ed25519-polyfill/dist/index.node.mj s	3.61KB	-
✅	webcrypto-ed25519-polyfill/dist/index.browser .mjs	3.59KB	-
✅	webcrypto-ed25519-polyfill/dist/index.native. mjs	3.57KB	-
✅	rpc-subscriptions/dist/index.browser.mjs	3.37KB	-
✅	rpc-subscriptions/dist/index.node.mjs	3.34KB	-
✅	rpc-subscriptions/dist/index.native.mjs	3.31KB	-
✅	rpc-transformers/dist/index.browser.mjs	3.16KB	-
✅	rpc-transformers/dist/index.native.mjs	3.16KB	-
✅	rpc-transformers/dist/index.node.mjs	3.16KB	-
✅	react/dist/index.browser.mjs	3.09KB	-
✅	react/dist/index.native.mjs	3.09KB	-
✅	react/dist/index.node.mjs	3.09KB	-
✅	addresses/dist/index.browser.mjs	2.93KB	-
✅	addresses/dist/index.native.mjs	2.92KB	-
✅	addresses/dist/index.node.mjs	2.92KB	-
✅	signers/dist/index.browser.mjs	2.9KB	-
✅	signers/dist/index.native.mjs	2.9KB	-
✅	signers/dist/index.node.mjs	2.9KB	-
✅	transactions/dist/index.browser.mjs	2.87KB	-
✅	transactions/dist/index.native.mjs	2.86KB	-
✅	transactions/dist/index.node.mjs	2.86KB	-
✅	codecs-strings/dist/index.browser.mjs	2.53KB	-
✅	codecs-strings/dist/index.node.mjs	2.49KB	-
✅	codecs-strings/dist/index.native.mjs	2.45KB	-
✅	transaction-confirmation/dist/index.node.mjs	2.41KB	-
✅	transaction-confirmation/dist/index.native.mj s	2.36KB	-
✅	transaction-confirmation/dist/index.browser.m js	2.35KB	-
✅	sysvars/dist/index.browser.mjs	2.35KB	-
✅	sysvars/dist/index.native.mjs	2.34KB	-
✅	sysvars/dist/index.node.mjs	2.34KB	-
✅	rpc-subscriptions-spec/dist/index.node.mjs	2.18KB	-
✅	rpc-subscriptions-spec/dist/index.native.mjs	2.13KB	-
✅	rpc-subscriptions-spec/dist/index.browser.mjs	2.13KB	-
✅	keys/dist/index.browser.mjs	2.1KB	-
✅	keys/dist/index.native.mjs	2.1KB	-
✅	keys/dist/index.node.mjs	2.1KB	-
✅	rpc/dist/index.node.mjs	1.95KB	-
✅	codecs-numbers/dist/index.browser.mjs	1.95KB	-
✅	codecs-numbers/dist/index.native.mjs	1.95KB	-
✅	codecs-numbers/dist/index.node.mjs	1.94KB	-
✅	rpc-transport-http/dist/index.browser.mjs	1.91KB	-
✅	rpc-transport-http/dist/index.native.mjs	1.9KB	-
✅	kit/dist/index.browser.mjs	1.89KB	-
✅	kit/dist/index.native.mjs	1.89KB	-
✅	kit/dist/index.node.mjs	1.88KB	-
✅	rpc/dist/index.native.mjs	1.81KB	-
✅	rpc/dist/index.browser.mjs	1.8KB	-
✅	subscribable/dist/index.node.mjs	1.8KB	-
✅	subscribable/dist/index.native.mjs	1.75KB	-
✅	subscribable/dist/index.browser.mjs	1.74KB	-
✅	rpc-transport-http/dist/index.node.mjs	1.72KB	-
✅	rpc-types/dist/index.browser.mjs	1.53KB	-
✅	rpc-types/dist/index.native.mjs	1.53KB	-
✅	rpc-types/dist/index.node.mjs	1.53KB	-
✅	rpc-subscriptions-channel-websocket/dist/inde x.node.mjs	1.33KB	-
✅	rpc-subscriptions-channel-websocket/dist/inde x.native.mjs	1.27KB	-
✅	rpc-subscriptions-channel-websocket/dist/inde x.browser.mjs	1.26KB	-
✅	options/dist/index.browser.mjs	1.18KB	-
✅	options/dist/index.native.mjs	1.18KB	-
✅	options/dist/index.node.mjs	1.17KB	-
✅	accounts/dist/index.browser.mjs	1.17KB	-
✅	accounts/dist/index.native.mjs	1.17KB	-
✅	accounts/dist/index.node.mjs	1.16KB	-
✅	rpc-api/dist/index.browser.mjs	976B	-
✅	rpc-api/dist/index.native.mjs	975B	-
✅	rpc-api/dist/index.node.mjs	973B	-
✅	compat/dist/index.browser.mjs	969B	-
✅	compat/dist/index.native.mjs	968B	-
✅	compat/dist/index.node.mjs	966B	-
✅	rpc-spec-types/dist/index.browser.mjs	962B	-
✅	rpc-spec-types/dist/index.native.mjs	961B	-
✅	rpc-spec-types/dist/index.node.mjs	959B	-
✅	rpc-subscriptions-api/dist/index.native.mjs	870B	-
✅	rpc-subscriptions-api/dist/index.node.mjs	869B	-
✅	rpc-subscriptions-api/dist/index.browser.mjs	868B	-
✅	rpc-spec/dist/index.browser.mjs	852B	-
✅	rpc-spec/dist/index.native.mjs	851B	-
✅	rpc-spec/dist/index.node.mjs	850B	-
✅	promises/dist/index.browser.mjs	799B	-
✅	promises/dist/index.native.mjs	798B	-
✅	promises/dist/index.node.mjs	797B	-
✅	assertions/dist/index.browser.mjs	783B	-
✅	instructions/dist/index.browser.mjs	771B	-
✅	instructions/dist/index.native.mjs	770B	-
✅	instructions/dist/index.node.mjs	768B	-
✅	fast-stable-stringify/dist/index.browser.mjs	726B	-
✅	fast-stable-stringify/dist/index.native.mjs	725B	-
✅	assertions/dist/index.native.mjs	724B	-
✅	fast-stable-stringify/dist/index.node.mjs	724B	-
✅	assertions/dist/index.node.mjs	723B	-
✅	programs/dist/index.browser.mjs	329B	-
✅	plugin-core/dist/index.browser.mjs	328B	-
✅	programs/dist/index.native.mjs	327B	-
✅	plugin-core/dist/index.native.mjs	326B	-
✅	programs/dist/index.node.mjs	325B	-
✅	plugin-core/dist/index.node.mjs	324B	-
✅	event-target-impl/dist/index.node.mjs	230B	-
✅	functional/dist/index.browser.mjs	154B	-
✅	functional/dist/index.native.mjs	152B	-
✅	text-encoding-impl/dist/index.native.mjs	152B	-
✅	functional/dist/index.node.mjs	151B	-
✅	codecs/dist/index.browser.mjs	137B	-
✅	codecs/dist/index.native.mjs	136B	-
✅	codecs/dist/index.node.mjs	134B	-
✅	event-target-impl/dist/index.browser.mjs	133B	-
✅	ws-impl/dist/index.node.mjs	131B	-
✅	text-encoding-impl/dist/index.browser.mjs	122B	-
✅	text-encoding-impl/dist/index.node.mjs	119B	-
✅	ws-impl/dist/index.browser.mjs	113B	-
✅	crypto-impl/dist/index.node.mjs	111B	-
✅	crypto-impl/dist/index.browser.mjs	109B	-
✅	rpc-parsed-types/dist/index.browser.mjs	66B	-
✅	rpc-parsed-types/dist/index.native.mjs	65B	-
✅	rpc-parsed-types/dist/index.node.mjs	63B	-

Total files change +212B +0.05%

Final result: ✅

View report in BundleMon website ➡️

Current branch size history | Target branch size history

github-actions · 2026-01-23T17:10:31Z

Documentation Preview: https://kit-docs-8utdjfti7-anza-tech.vercel.app

mcintyre94

Nice, looks great! Great typetests too

github-actions · 2026-01-24T13:41:44Z

🔎💬 Inkeep AI search and chat service is syncing content for source 'Solana Kit Docs'

github-actions · 2026-02-09T08:21:50Z

Because there has been no activity on this PR for 14 days since it was merged, it has been automatically locked. Please open a new issue if it requires a follow up.

lorisleiva marked this pull request as ready for review January 23, 2026 17:01

mcintyre94 approved these changes Jan 23, 2026

View reviewed changes

Comment thread packages/instruction-plans/src/__typetests__/transaction-plan-executor-typetest.ts Outdated

Add passthroughFailedTransactionPlanExecution helper

f8b985f

lorisleiva force-pushed the 01-23-add_passthroughfailedtransactionplanexecution_helper branch from 55e88c1 to f8b985f Compare January 24, 2026 12:01

lorisleiva merged commit a47e441 into main Jan 24, 2026
16 checks passed

lorisleiva deleted the 01-23-add_passthroughfailedtransactionplanexecution_helper branch January 24, 2026 13:33

This was referenced Jan 24, 2026

Version Packages #1214

Merged

Version Packages meefs/kit#2

Closed

Version Packages Bostt/solana-web3.js#30

Open

Version Packages amilz/solana-kit#4

Closed

github-actions Bot locked as resolved and limited conversation to collaborators Feb 9, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add `passthroughFailedTransactionPlanExecution` helper#1235

Add `passthroughFailedTransactionPlanExecution` helper#1235
lorisleiva merged 1 commit into
mainfrom
01-23-add_passthroughfailedtransactionplanexecution_helper

lorisleiva commented Jan 23, 2026 •

edited

Loading

Uh oh!

changeset-bot Bot commented Jan 23, 2026 •

edited

Loading

Uh oh!

lorisleiva commented Jan 23, 2026

Uh oh!

bundlemon Bot commented Jan 23, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jan 23, 2026 •

edited

Loading

Uh oh!

mcintyre94 left a comment

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Jan 24, 2026

Uh oh!

github-actions Bot commented Feb 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

lorisleiva commented Jan 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Problem

Summary of Changes

Example Usage

Uh oh!

changeset-bot Bot commented Jan 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

lorisleiva commented Jan 23, 2026

Uh oh!

bundlemon Bot commented Jan 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

BundleMon

Uh oh!

github-actions Bot commented Jan 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mcintyre94 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Jan 24, 2026

Uh oh!

github-actions Bot commented Feb 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

lorisleiva commented Jan 23, 2026 •

edited

Loading

changeset-bot Bot commented Jan 23, 2026 •

edited

Loading

bundlemon Bot commented Jan 23, 2026 •

edited

Loading

github-actions Bot commented Jan 23, 2026 •

edited

Loading