import {
  type EIP1193RequestFn,
  type EIP1474Methods,
  formatTransaction,
  type Hash,
  type Transaction,
} from "viem";

type GetTransactionByHashParameters = {
  hash: Hash;
};

/**
 * Retrieves a transaction by its hash.
 * @param request - The EIP1193 request function.
 * @param params - The parameters for retrieving the transaction.
 * @returns A promise that resolves to the transaction.
 * @throws An error if the transaction is not found.
 * @rpc
 * @example
 * ```ts
 * import { getRpcClient, eth_getTransactionByHash } from "thirdweb/rpc";
 * const rpcRequest = getRpcClient({ client, chain });
 *  const transaction = await eth_getTransactionByHash(rpcRequest, {
 *  hash: "0x...",
 * });
 * ```
 */
export async function eth_getTransactionByHash(
  request: EIP1193RequestFn<EIP1474Methods>,
  params: GetTransactionByHashParameters,
): Promise<Transaction> {
  const receipt = await request({
    method: "eth_getTransactionByHash",
    params: [params.hash],
  });

  if (!receipt) {
    throw new Error("Transaction not found.");
  }

  return formatTransaction(receipt);
}