# @solana/transaction-confirmation > Helpers for confirming Solana transactions Latest version **8.3.0** (published 2026-09-09) · MIT license · 0 weekly downloads ## Install ```sh npm install @solana/transaction-confirmation pnpm add @solana/transaction-confirmation yarn add @solana/transaction-confirmation bun add @solana/transaction-confirmation ``` ## Health **Score 70/100 (B)** — status: active. Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score. Warnings: low downloads. ## Facts | | | |---|---| | Version | 8.3.0 | | Published | 2026-09-09 | | First published | 2024-02-20 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Node | >=20.18.0 | | Dependencies | 10 | | Unpacked size | 302.1 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 695 | | Author | Solana Labs Maintainers | | Maintainers | solana-devs | | Keywords | blockchain, solana, web3 | ## Links - npm: https://www.npmjs.com/package/@solana/transaction-confirmation - Repository: https://github.com/anza-xyz/kit - Homepage: https://www.solanakit.com/api#solanatransaction-confirmation - Issues: https://github.com/anza-xyz/kit/issues - npm.io page: https://npm.io/package/@solana/transaction-confirmation ## Dependencies (10) - [@solana/rpc](https://npm.io/package/@solana/rpc.md) 8.3.0 - [@solana/keys](https://npm.io/package/@solana/keys.md) 8.3.0 - [@solana/errors](https://npm.io/package/@solana/errors.md) 8.3.0 - [@solana/promises](https://npm.io/package/@solana/promises.md) 8.3.0 - [@solana/addresses](https://npm.io/package/@solana/addresses.md) 8.3.0 - [@solana/rpc-types](https://npm.io/package/@solana/rpc-types.md) 8.3.0 - [@solana/transactions](https://npm.io/package/@solana/transactions.md) 8.3.0 - [@solana/codecs-strings](https://npm.io/package/@solana/codecs-strings.md) 8.3.0 - [@solana/rpc-subscriptions](https://npm.io/package/@solana/rpc-subscriptions.md) 8.3.0 - [@solana/transaction-messages](https://npm.io/package/@solana/transaction-messages.md) 8.3.0 ## Recent versions - 8.3.0 (latest) — 2026-09-09 - 8.4.0-canary-20260925083045 (canary) — 2026-09-25 - 5.1.0-experimental-20251205104522 (experimental) — 2025-12-05 - 4.0.0 (4x) — 2025-10-08 - 3.0.3 (3x) — 2025-09-11 - 2.0.0 (next) — 2024-11-07 - 2.0.0-rc.4 (rc) — 2024-11-05 - 2.0.0-preview.4.20240731091009.c2717fc498afa3228c8f8b01600a575989afae99 (preview) — 2024-07-31 - 2.0.0-preview.4 (tp4) — 2024-07-02 - 2.0.0-preview.3 (tp3) — 2024-04-25 - 2.0.0-preview.2 (tp2) — 2024-03-19 - 8.4.0-canary-20260924083259 — 2026-09-24 - 8.4.0-canary-20260923083123 — 2026-09-23 - 8.4.0-canary-20260922155338 — 2026-09-22 - 8.4.0-canary-20260922151509 — 2026-09-22 - … 1789 more at https://npm.io/package/@solana/transaction-confirmation/versions ## README [![npm][npm-image]][npm-url] [![npm-downloads][npm-downloads-image]][npm-url]
[![code-style-prettier][code-style-prettier-image]][code-style-prettier-url] [code-style-prettier-image]: https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square [code-style-prettier-url]: https://github.com/prettier/prettier [npm-downloads-image]: https://img.shields.io/npm/dm/@solana/transaction-confirmation?style=flat [npm-image]: https://img.shields.io/npm/v/@solana/transaction-confirmation?style=flat [npm-url]: https://www.npmjs.com/package/@solana/transaction-confirmation # @solana/transaction-confirmation This package contains utilities for confirming transactions and for building your own transaction confirmation strategies. ## Functions ### `createBlockHeightExceedencePromiseFactory()` When a transaction's lifetime is tied to a blockhash, that transaction can be landed on the network until that blockhash expires. All blockhashes have a block height after which they are considered to have expired. A block height exceedence promise throws when the network progresses past that block height. ```ts import { isSolanaError, SolanaError } from '@solana/errors'; import { createBlockHeightExceedencePromiseFactory } from '@solana/transaction-confirmation'; const getBlockHeightExceedencePromise = createBlockHeightExceedencePromiseFactory({ rpc, rpcSubscriptions, }); try { await getBlockHeightExceedencePromise({ lastValidBlockHeight }); } catch (e) { if (isSolanaError(e, SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED)) { console.error( `The block height of the network has exceeded ${e.context.lastValidBlockHeight}. ` + `It is now ${e.context.currentBlockHeight}`, ); // Re-sign and retry the transaction. return; } throw e; } ``` ### `createNonceInvalidationPromiseFactory()` When a transaction's lifetime is tied to the value stored in a nonce account, that transaction can be landed on the network until the nonce is advanced to a new value. A nonce invalidation promise throws when the value stored in a nonce account is not the expected one. ```ts import { isSolanaError, SolanaError } from '@solana/errors'; import { createNonceInvalidationPromiseFactory } from '@solana/transaction-confirmation'; const getNonceInvalidationPromise = createNonceInvalidationPromiseFactory({ rpc, rpcSubscriptions, }); try { await getNonceInvalidationPromise({ currentNonceValue, nonceAccountAddress, }); } catch (e) { if (isSolanaError(e, SOLANA_ERROR__NONCE_INVALID)) { console.error(`The nonce has advanced to ${e.context.actualNonceValue}`); // Re-sign and retry the transaction. return; } else if (isSolanaError(e, SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND)) { console.error(`No nonce account was found at ${nonceAccountAddress}`); } throw e; } ``` ### `createRecentSignatureConfirmationPromiseFactory()` The status of recently-landed transactions is available in the network's status cache. A recent signature confirmation promise resolves when a transaction achieves the target confirmation commitment, and throws when the transaction fails with an error. ```ts import { createRecentSignatureConfirmationPromiseFactory } from '@solana/transaction-confirmation'; const getRecentSignatureConfirmationPromise = createRecentSignatureConfirmationPromiseFactory({ rpc, rpcSubscriptions, }); try { await getRecentSignatureConfirmationPromise({ commitment, signature, }); console.log(`The transaction with signature \`${signature}\` has achieved a commitment level of \`${commitment}\``); } catch (e) { console.error(`The transaction with signature \`${signature}\` failed`, e.cause); throw e; } ``` ### `getTimeoutPromise()` When no other heuristic exists to infer that a transaction has expired, you can use this promise factory with a commitment level. It throws after 30 seconds when the commitment is `processed`, and 60 seconds otherwise. You would typically race this with another confirmation strategy. ```ts import { safeRace } from '@solana/promises'; import { getTimeoutPromise } from '@solana/transaction-confirmation'; try { await safeRace([getCustomTransactionConfirmationPromise(/* ... */), getTimeoutPromise({ commitment })]); } catch (e) { if (e instanceof DOMException && e.name === 'TimeoutError') { console.log('Could not confirm transaction after a timeout'); } throw e; } ``` ### `waitForDurableNonceTransactionConfirmation()` Supply your own confirmation implementations to this function to create a custom nonce transaction confirmation strategy. ```ts import { waitForDurableNonceTransactionConfirmation } from '@solana/transaction-confirmation'; try { await waitForDurableNonceTransactionConfirmation({ getNonceInvalidationPromise({ abortSignal, commitment, currentNonceValue, nonceAccountAddress }) { // Return a promise that rejects when a nonce becomes invalid. }, getRecentSignatureConfirmationPromise({ abortSignal, commitment, signature }) { // Return a promise that resolves when a transaction achieves confirmation }, }); } catch (e) { // Handle errors. } ``` ### `waitForRecentTransactionConfirmation()` Supply your own confirmation implementations to this function to create a custom confirmation strategy for recently-landed transactions. ```ts import { waitForRecentTransactionConfirmation } from '@solana/transaction-confirmation'; try { await waitForRecentTransactionConfirmation({ getBlockHeightExceedencePromise({ abortSignal, commitment, lastValidBlockHeight }) { // Return a promise that rejects when the blockhash's block height has been exceeded }, getRecentSignatureConfirmationPromise({ abortSignal, commitment, signature }) { // Return a promise that resolves when a transaction achieves confirmation }, }); } catch (e) { // Handle errors. } ``` ### `waitForRecentTransactionConfirmationUntilTimeout()` Supply your own confirmation implementations to this function to create a custom nonce transaction confirmation strategy. ```ts import { waitForRecentTransactionConfirmationUntilTimeout } from '@solana/transaction-confirmation'; try { await waitForRecentTransactionConfirmationUntilTimeout({ getTimeoutPromise({ abortSignal, commitment }) { // Return a promise that rejects after your chosen timeout }, getRecentSignatureConfirmationPromise({ abortSignal, commitment, signature }) { // Return a promise that resolves when a transaction achieves confirmation }, }); } catch (e) { // Handle errors. } ``` --- _Source: https://npm.io/package/@solana/transaction-confirmation · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._