useTransactionStatus

​

Features

• Automatic Polling: The hook uses the SDK’s built-in sleep strategy to periodically check the network until the transaction settles.
• Success and Failure Tracking: It identifies whether a transaction succeeded, failed, or was not found on the network.
• Simple State Management: Returns standard loading and data states, making it easy to show progress spinners or success messages.

​

Usage

import { useTransactionStatus } from "@sorokit/hooks";

function TransactionTracker({ hash }) {
  const { data, isLoading, error } = useTransactionStatus(hash);

  if (isLoading) return <span>Waiting for ledger close...</span>;
  if (error) return <span>Error: {error.message}</span>;

  return (
    <div>
      <p>Status: {data.status}</p>
      {data.status === "SUCCESS" && <p>Transaction confirmed!</p>}
    </div>
  );
}

​

Parameters

• hash: The unique string identifier for the transaction.
• options: An optional object containing an enabled boolean to control when the polling starts.

​

Return Value

• status: A string indicating the result (SUCCESS, FAILED, or NOT_FOUND).
• returnValue: The raw XDR result of the transaction if it was a successful contract call.