Get Solana Transaction Status - Para Docs

You’re viewing the 2.0 (LTS) docs. View the current 3.0 version of this page.

Monitor transaction confirmation status and wait for finality on Solana. This guide covers checking transaction results and understanding commitment levels.

@solana/kit
@solana/web3.js
Anchor

import { useParaSolanaSigner } from '@getpara/react-sdk';
import { createSolanaRpc } from '@solana/kit';
import { Signature, Commitment } from '@solana/web3.js';

const rpc = createSolanaRpc("https://api.mainnet-beta.solana.com");

function TransactionStatus() {
  const { solanaSigner, isLoading } = useParaSolanaSigner({ rpc });

  const checkTransactionStatus = async (signature: Signature) => {
    try {
      const { value: statuses } = await rpc
        .getSignatureStatuses([signature], { searchTransactionHistory: true })
        .send();

      const status = statuses[0];

      if (!status) {
        console.log("Transaction not found");
        return null;
      }

      console.log("Confirmations:", status.confirmations || "Max (32+)");
      console.log("Confirmation status:", status.confirmationStatus);
      console.log("Slot:", status.slot);

      if (status.err) {
        console.error("Transaction failed:", status.err);
        return false;
      }

      return status;
    } catch (error) {
      console.error("Error checking status:", error);
      throw error;
    }
  };

  const waitForConfirmation = async (
    signature: Signature,
    commitment: Commitment = 'confirmed'
  ) => {
    try {
      const startTime = Date.now();

      let confirmed = false;
      while (!confirmed) {
        const { value: statuses } = await rpc
          .getSignatureStatuses([signature], { searchTransactionHistory: true })
          .send();

        const status = statuses[0];

        if (status?.confirmationStatus === commitment ||
            status?.confirmationStatus === 'finalized') {
          confirmed = true;

          if (status.err) {
            throw new Error(`Transaction failed: ${JSON.stringify(status.err)}`);
          }
        }

        // Wait before next poll
        if (!confirmed) {
          await new Promise(resolve => setTimeout(resolve, 1000));
        }

        // Timeout after 30 seconds
        if (Date.now() - startTime > 30000) {
          throw new Error('Transaction confirmation timeout');
        }
      }

      const elapsed = Date.now() - startTime;
      console.log(`Transaction confirmed in ${elapsed}ms`);

      // Get transaction details
      const { value: txInfo } = await rpc
        .getTransaction(signature, {
          commitment,
          maxSupportedTransactionVersion: 0,
        })
        .send();

      if (txInfo) {
        console.log("Block time:", new Date(txInfo.blockTime * 1000));
        console.log("Fee:", txInfo.meta.fee, "lamports");
        console.log("Compute units:", txInfo.meta.computeUnitsConsumed);
      }

      return txInfo;
    } catch (error) {
      console.error("Confirmation error:", error);
      throw error;
    }
  };

  return (
    <div>
      <button onClick={() => checkTransactionStatus("YOUR_SIGNATURE" as Signature)}>
        Check Status
      </button>
      <button onClick={() => waitForConfirmation("YOUR_SIGNATURE" as Signature, "finalized")}>
        Wait for Finalization
      </button>
    </div>
  );
}

import { useParaSolana } from './hooks/useParaSolana';
import { TransactionSignature, Commitment } from '@solana/web3.js';

function TransactionStatus() {
  const { connection } = useParaSolana();

  const checkTransactionStatus = async (signature: string) => {
    try {
      // Get signature status
      const status = await connection.getSignatureStatus(signature);

      if (status.value === null) {
        console.log("Transaction not found");
        return null;
      }

      console.log("Confirmations:", status.value.confirmations || "Max (32+)");
      console.log("Confirmation status:", status.value.confirmationStatus);
      console.log("Slot:", status.value.slot);

      if (status.value.err) {
        console.error("Transaction failed:", status.value.err);
        return false;
      }

      return status.value.confirmationStatus;
    } catch (error) {
      console.error("Error checking status:", error);
      throw error;
    }
  };

  const waitForConfirmation = async (
    signature: string,
    commitment: Commitment = 'confirmed'
  ) => {
    try {
      const startTime = Date.now();

      // Wait for confirmation with timeout
      const confirmation = await connection.confirmTransaction(
        signature,
        commitment
      );

      const elapsed = Date.now() - startTime;
      console.log(`Transaction confirmed in ${elapsed}ms`);

      if (confirmation.value.err) {
        throw new Error(`Transaction failed: ${confirmation.value.err}`);
      }

      // Get detailed transaction info
      const txInfo = await connection.getTransaction(signature, {
        commitment,
        maxSupportedTransactionVersion: 0,
      });

      if (txInfo) {
        console.log("Block time:", new Date(txInfo.blockTime! * 1000));
        console.log("Fee:", txInfo.meta?.fee, "lamports");
        console.log("Compute units consumed:", txInfo.meta?.computeUnitsConsumed);
      }

      return txInfo;
    } catch (error) {
      console.error("Confirmation error:", error);
      throw error;
    }
  };

  return (
    <div>
      <button onClick={() => checkTransactionStatus("YOUR_SIGNATURE")}>
        Check Status
      </button>
      <button onClick={() => waitForConfirmation("YOUR_SIGNATURE", "finalized")}>
        Wait for Finalization
      </button>
    </div>
  );
}

Check transaction status using the RPC client:

import { useParaSolanaSigner } from "@getpara/react-sdk";
import { createSolanaRpc } from "@solana/kit";

const rpc = createSolanaRpc("https://api.devnet.solana.com");

function TransactionStatus() {
  const { solanaSigner } = useParaSolanaSigner({ rpc });

  const checkStatus = async (signature: string) => {
    const { value: statuses } = await rpc.getSignatureStatuses([signature as any]).send();
    const status = statuses[0];

    if (!status) {
      console.log("Transaction not found");
      return;
    }

    console.log("Confirmation status:", status.confirmationStatus);
    console.log("Slot:", status.slot);

    if (status.err) {
      console.error("Transaction failed:", status.err);
    }
  };

  return <button onClick={() => checkStatus("your-signature...")}>Check Status</button>;
}

Next Steps