UNPKG

@nktkas/hyperliquid

Version:

Hyperliquid API SDK for all major JS runtimes, written in TypeScript.

75 lines 3.19 kB
import * as v from "valibot"; // ============================================================ // API Schemas // ============================================================ import { Address, Hex, UnsignedInteger } from "../../_schemas.js"; /** * Request transaction details by transaction hash. */ export const TxDetailsRequest = /* @__PURE__ */ (() => { return v.pipe(v.object({ /** Type of request. */ type: v.pipe(v.literal("txDetails"), v.description("Type of request.")), /** Transaction hash. */ hash: v.pipe(v.pipe(Hex, v.length(66)), v.description("Transaction hash.")), }), v.description("Request transaction details by transaction hash.")); })(); /** * Response with transaction details. */ export const TxDetailsResponse = /* @__PURE__ */ (() => { return v.pipe(v.object({ /** Response type. */ type: v.pipe(v.literal("txDetails"), v.description("Response type.")), /** Transaction details. */ tx: v.pipe(v.object({ /** Action performed in transaction. */ action: v.pipe(v.looseObject({ /** Action type. */ type: v.pipe(v.string(), v.description("Action type.")), }), v.description("Action performed in transaction.")), /** Block number where transaction was included. */ block: v.pipe(UnsignedInteger, v.description("Block number where transaction was included.")), /** Error message if transaction failed. */ error: v.pipe(v.nullable(v.string()), v.description("Error message if transaction failed.")), /** Transaction hash. */ hash: v.pipe(v.pipe(Hex, v.length(66)), v.description("Transaction hash.")), /** Transaction creation timestamp. */ time: v.pipe(UnsignedInteger, v.description("Transaction creation timestamp.")), /** Creator's address. */ user: v.pipe(Address, v.description("Creator's address.")), }), v.description("Transaction details.")), }), v.description("Response with transaction details.")); })(); /** * Request transaction details by transaction hash. * * @param config - General configuration for Info API requests. * @param params - Parameters specific to the API request. * @param signal - [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) to cancel the request. * * @returns Transaction details. * * @throws {ValiError} When the request parameters fail validation (before sending). * @throws {TransportError} When the transport layer throws an error. * * @example * ```ts * import { HttpTransport } from "@nktkas/hyperliquid"; * import { txDetails } from "@nktkas/hyperliquid/api/info"; * * const transport = new HttpTransport(); // only `HttpTransport` supports this API * const data = await txDetails( * { transport }, * { hash: "0x..." }, * ); * ``` */ export function txDetails(config, params, signal) { const request = v.parse(TxDetailsRequest, { type: "txDetails", ...params, }); return config.transport.request("explorer", request, signal); } //# sourceMappingURL=txDetails.js.map