useTxNormalizedEvents - Alphscan

useTxNormalizedEvents fetches normalized events for a given transaction ID. It does not use the context client; it creates its own client from the provided base URL or settings. Use it when you have a transaction hash and want loading/error state and refetch.

When to use

Anywhere (no AlphscanProvider required).
When you need normalized events for a single transaction with loading/error and refetch.

Signature

function useTxNormalizedEvents(
  transactionId: string | undefined,
  options?: UseTxNormalizedEventsOptions
): {
  data: TxNormalizedEventsResponse | null;
  loading: boolean;
  error: Error | null;
  refetch: () => Promise<void>;
}

UseTxNormalizedEventsOptions

Option	Type	Default	Description
`baseUrl`	`string`	`"https://api.alphscan.io"`	API base URL.
`settings`	`Partial<AlphscanSettings>`	—	Full settings (overrides baseUrl).
`enabled`	`boolean`	`true`	If false, or transactionId falsy, no request.

Return value

Field	Type	Description
`data`	`TxNormalizedEventsResponse \| null`	`{ transaction_id, events }` or null.
`loading`	`boolean`	Request in progress.
`error`	`Error \| null`	Error if request failed.
`refetch`	`() => Promise<void>`	Refetch events.

Example

import { useTxNormalizedEvents } from "@alphscan/sdk-react";

function TransactionEvents({ txId }: { txId: string | undefined }) {
  const { data, loading, error, refetch } = useTxNormalizedEvents(txId, {
    baseUrl: "https://api.alphscan.io",
    apiKey: process.env.NEXT_PUBLIC_ALPHSCAN_API_KEY,
    enabled: !!txId,
  });

  if (!txId) return <p>Enter a transaction ID</p>;
  if (loading) return <p>Loading events…</p>;
  if (error) return <p>Error: {error.message}</p>;
  if (!data) return null;

  return (
    <div>
      <p>Transaction {data.transaction_id}: {data.events.length} events</p>
      <ul>
        {data.events.map((e) => (
          <li key={e.id}>{e.category} – {e.sub_kind}</li>
        ))}
      </ul>
      <button onClick={refetch}>Refetch</button>
    </div>
  );
}

To render events with the UI library, use @alphscan/sdk-react-ui (e.g. NormalizedEventsList).