@nktkas/hyperliquid 0.13.0 → 0.13.1

package/esm/src/types/exchange/requests.d.ts

@@ -0,0 +1,435 @@
+import type { Hex } from "../common.js";
+import type { OrderParms } from "./common.js";
+/** Base structure for exchange requests. */
+export interface BaseExchangeRequest {
+    /** Action to perform. */
+    action: {
+        /** Type of action. */
+        type: string;
+        /** Additional action parameters. */
+        [key: string]: unknown;
+    };
+    /** Unique request identifier (recommended: current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: {
+        r: Hex;
+        s: Hex;
+        v: number;
+    };
+}
+/**
+ * Approve an agent to sign on behalf of the master or sub-accounts.
+ * @returns {SuccessResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-an-api-wallet | Hyperliquid GitBook}
+ */
+export interface ApproveAgentRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "approveAgent";
+        /** HyperLiquid network. */
+        hyperliquidChain: "Mainnet" | "Testnet";
+        /** Chain ID used for signing. */
+        signatureChainId: Hex;
+        /** Agent address. */
+        agentAddress: Hex;
+        /** Agent name. */
+        agentName: string;
+        /** Unique request identifier (recommended: current timestamp in ms). */
+        nonce: number;
+    };
+}
+/**
+ * Approve a max fee rate for a builder address.
+ * @returns {SuccessResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-a-builder-fee | Hyperliquid GitBook}
+ */
+export interface ApproveBuilderFeeRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "approveBuilderFee";
+        /** HyperLiquid network. */
+        hyperliquidChain: "Mainnet" | "Testnet";
+        /** Chain ID used for signing. */
+        signatureChainId: Hex;
+        /** Max fee rate (e.g., "0.01%"). */
+        maxFeeRate: `${string}%`;
+        /** Builder address. */
+        builder: Hex;
+        /** Unique request identifier (recommended: current timestamp in ms). */
+        nonce: number;
+    };
+}
+/**
+ * Modify multiple orders.
+ * @returns {OrderResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-multiple-orders | Hyperliquid GitBook}
+ */
+export interface BatchModifyRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "batchModify";
+        /** Order modifications. */
+        modifies: {
+            /** Order ID to modify. */
+            oid: number;
+            /** New order parameters. */
+            order: OrderParms;
+        }[];
+    };
+    /** Vault address (optional, for vault trading). */
+    vaultAddress?: Hex;
+}
+/**
+ * Cancel order(s).
+ * @returns {CancelResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s | Hyperliquid GitBook}
+ */
+export interface CancelRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "cancel";
+        /** Orders to cancel. */
+        cancels: {
+            /** An integer representing the asset being traded. */
+            a: number;
+            /** Order ID. */
+            o: number;
+        }[];
+    };
+    /** Vault address (optional, for vault trading). */
+    vaultAddress?: Hex;
+}
+/**
+ * Cancel order(s) by Client Order ID.
+ * @returns {CancelResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s-by-cloid | Hyperliquid GitBook}
+ */
+export interface CancelByCloidRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "cancelByCloid";
+        /** Orders to cancel. */
+        cancels: {
+            /** An integer representing the asset being traded. */
+            asset: number;
+            /** Client Order ID. */
+            cloid: Hex;
+        }[];
+    };
+    /** Vault address (optional, for vault trading). */
+    vaultAddress?: Hex;
+}
+/**
+ * Create a sub-account.
+ * @returns {CreateSubAccountResponse}
+ */
+export interface CreateSubAccountRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "createSubAccount";
+        /** Sub-account name. */
+        name: string;
+    };
+}
+/**
+ * Modify an order.
+ * @returns {SuccessResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-an-order | Hyperliquid GitBook}
+ */
+export interface ModifyRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "modify";
+        /** Order ID to modify. */
+        oid: number;
+        /** New order parameters. */
+        order: OrderParms;
+    };
+    /** Vault address (optional, for vault trading). */
+    vaultAddress?: Hex;
+}
+/**
+ * Place an order(s).
+ * @returns {OrderResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-an-order | Hyperliquid GitBook}
+ */
+export interface OrderRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "order";
+        /** Order parameters. */
+        orders: OrderParms[];
+        /**
+         * Order grouping strategy:
+         * - `"na"`: Standard order without grouping.
+         * - `"normalTpsl"`: TP/SL order with fixed size that doesn't adjust with position changes.
+         * - `"positionTpsl"`: TP/SL order that adjusts proportionally with the position size.
+         */
+        grouping: "na" | "normalTpsl" | "positionTpsl";
+        /** Builder fee. */
+        builder?: {
+            /** The address of the builder. */
+            b: Hex;
+            /** The builder fee to charge in tenths of basis points. */
+            f: number;
+        };
+    };
+    /** Vault address (optional, for vault trading). */
+    vaultAddress?: Hex;
+}
+/**
+ * Schedule a time to cancel all open orders.
+ * @returns {SuccessResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#schedule-cancel-dead-mans-switch | Hyperliquid GitBook}
+ */
+export interface ScheduleCancelRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "scheduleCancel";
+        /**
+         * Scheduled time (in ms since epoch).
+         * Must be at least 5 seconds in the future.
+         *
+         * If not specified, will cause all scheduled cancel operations to be deleted
+         */
+        time?: number;
+    };
+    /** Vault address (optional, for vault trading). */
+    vaultAddress?: Hex;
+}
+/**
+ * Set a referral code.
+ * @returns {SuccessResponse}
+ */
+export interface SetReferrerRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "setReferrer";
+        /** Referral code. */
+        code: string;
+    };
+}
+/**
+ * Transfer a spot asset on L1 to another address.
+ * @returns {SuccessResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#l1-spot-transfer | Hyperliquid GitBook}
+ */
+export interface SpotSendRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "spotSend";
+        /** HyperLiquid network. */
+        hyperliquidChain: "Mainnet" | "Testnet";
+        /** Chain ID used for signing. */
+        signatureChainId: Hex;
+        /** Recipient address. */
+        destination: Hex;
+        /** Token identifier. */
+        token: `${string}:${Hex}`;
+        /** Amount to send. */
+        amount: string;
+        /** Current timestamp in ms. */
+        time: number;
+    };
+}
+/**
+ * Transfer between sub-accounts.
+ * @returns {SuccessResponse}
+ */
+export interface SubAccountTransferRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "subAccountTransfer";
+        /** Sub-account address. */
+        subAccountUser: Hex;
+        /** `true` for deposit, `false` for withdrawal. */
+        isDeposit: boolean;
+        /** Amount to transfer (float * 1e6). */
+        usd: number;
+    };
+}
+/**
+ * Cancel a TWAP order.
+ * @returns {TwapCancelResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-a-twap-order | Hyperliquid GitBook}
+ */
+export interface TwapCancelRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "twapCancel";
+        /** An integer representing the asset being traded. */
+        a: number;
+        /** Twap ID. */
+        t: number;
+    };
+    /** Vault address (optional, for vault trading). */
+    vaultAddress?: Hex;
+}
+/**
+ * Place a TWAP order.
+ * @returns {TwapOrderResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-a-twap-order | Hyperliquid GitBook}
+ */
+export interface TwapOrderRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "twapOrder";
+        /** Twap parameters. */
+        twap: {
+            /** An integer representing the asset being traded. */
+            a: number;
+            /** Position side (`true` for long, `false` for short). */
+            b: boolean;
+            /** Size (in base currency units). */
+            s: string;
+            /** Is reduce-only? */
+            r: boolean;
+            /** TWAP duration in minutes. */
+            m: number;
+            /** Enable random order timing. */
+            t: boolean;
+        };
+    };
+    /** Vault address (optional, for vault trading). */
+    vaultAddress?: Hex;
+}
+/**
+ * Update isolated margin for a position.
+ * @returns {SuccessResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#update-isolated-margin | Hyperliquid GitBook}
+ */
+export interface UpdateIsolatedMarginRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "updateIsolatedMargin";
+        /** An integer representing the asset being traded. */
+        asset: number;
+        /** Position side (`true` for long, `false` for short). */
+        isBuy: boolean;
+        /** Amount to adjust (in USD). This should be an integer value. */
+        ntli: number;
+    };
+    /** Vault address (optional, for vault trading). */
+    vaultAddress?: Hex;
+}
+/**
+ * Update leverage for cross or isolated margin.
+ * @returns {SuccessResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#update-leverage | Hyperliquid GitBook}
+ */
+export interface UpdateLeverageRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "updateLeverage";
+        /** An integer representing the asset being traded. */
+        asset: number;
+        /** `true` for cross leverage, `false` for isolated leverage. */
+        isCross: boolean;
+        /** New leverage value. */
+        leverage: number;
+    };
+    /** Vault address (optional, for vault trading). */
+    vaultAddress?: Hex;
+}
+/**
+ * Transfer funds between Spot and Perp accounts.
+ * @returns {SuccessResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#transfer-from-spot-account-to-perp-account-and-vice-versa | Hyperliquid GitBook}
+ */
+export interface UsdClassTransferRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "usdClassTransfer";
+        /** HyperLiquid network. */
+        hyperliquidChain: "Mainnet" | "Testnet";
+        /** Chain ID used for signing. */
+        signatureChainId: Hex;
+        /** USD amount to transfer. */
+        amount: string;
+        /** `true` for Spot to Perp, `false` for Perp to Spot. */
+        toPerp: boolean;
+        /** Unique request identifier (recommended: current timestamp in ms). */
+        nonce: number;
+    };
+}
+/**
+ * Transfer USDC on L1 to another address.
+ * @returns {SuccessResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#l1-usdc-transfer | Hyperliquid GitBook}
+ */
+export interface UsdSendRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "usdSend";
+        /** HyperLiquid network. */
+        hyperliquidChain: "Mainnet" | "Testnet";
+        /** Chain ID used for signing. */
+        signatureChainId: Hex;
+        /** Recipient address. */
+        destination: Hex;
+        /** USD amount to send. */
+        amount: string;
+        /** Current timestamp in ms. */
+        time: number;
+    };
+}
+/**
+ * Transfer funds to/from a vault.
+ * @returns {SuccessResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#deposit-or-withdraw-from-a-vault | Hyperliquid GitBook}
+ */
+export interface VaultTransferRequest extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "vaultTransfer";
+        /** Vault address. */
+        vaultAddress: Hex;
+        /** `true` for deposit, `false` for withdrawal. */
+        isDeposit: boolean;
+        /** Amount to transfer (float * 1e6). */
+        usd: number;
+    };
+}
+/**
+ * Initiate a withdrawal request.
+ * @returns {SuccessResponse}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#initiate-a-withdrawal-request | Hyperliquid GitBook}
+ */
+export interface Withdraw3Request extends BaseExchangeRequest {
+    /** Action to be performed. */
+    action: {
+        /** Type of action. */
+        type: "withdraw3";
+        /** HyperLiquid network. */
+        hyperliquidChain: "Mainnet" | "Testnet";
+        /** Chain ID used for signing. */
+        signatureChainId: Hex;
+        /** USD amount to withdraw. */
+        amount: string;
+        /** Current timestamp in ms. */
+        time: number;
+        /** Recipient address. */
+        destination: Hex;
+    };
+}
+//# sourceMappingURL=requests.d.ts.map

package/esm/src/types/exchange/requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.d.ts","sourceRoot":"","sources":["../../../../src/src/types/exchange/requests.ts"],"names":[],"mappings":"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"}

package/esm/src/types/exchange/requests.js

@@ -0,0 +1 @@
+export {};

package/esm/src/types/exchange/responses.d.ts

@@ -0,0 +1,141 @@
+import type { Hex } from "../common.js";
+/** Base structure for exchange responses. */
+export interface BaseExchangeResponse {
+    /** Response status */
+    status: "ok" | "err";
+    /** Error message or success data */
+    response: string | {
+        /** Type of operation. */
+        type: string;
+        /** Specific data for the operation. */
+        data?: unknown;
+    };
+}
+/** Successful response without specific data. */
+export interface SuccessResponse extends BaseExchangeResponse {
+    /** Successful status. */
+    status: "ok";
+    /** Response details. */
+    response: {
+        /** Type of operation. */
+        type: "default";
+    };
+}
+/** Error response for failed operations. */
+export interface ErrorResponse extends BaseExchangeResponse {
+    /** Error status. */
+    status: "err";
+    /** Error message. */
+    response: string;
+}
+/** Response for order cancellation. */
+export interface CancelResponse extends BaseExchangeResponse {
+    /** Successful status. */
+    status: "ok";
+    /** Response details. */
+    response: {
+        /** Type of operation. */
+        type: "cancel";
+        /** Specific data. */
+        data: {
+            /** Array of statuses or error messages. */
+            statuses: ("success" | {
+                /** Error message. */
+                error: string;
+            })[];
+        };
+    };
+}
+/** Response for creating a sub-account. */
+export interface CreateSubAccountResponse extends BaseExchangeResponse {
+    /** Successful status. */
+    status: "ok";
+    /** Response details. */
+    response: {
+        /** Type of operation. */
+        type: "createSubAccount";
+        /** Sub-account address. */
+        data: Hex;
+    };
+}
+/** Response for order placement and batch modifications. */
+export interface OrderResponse extends BaseExchangeResponse {
+    /** Successful status. */
+    status: "ok";
+    /** Response details. */
+    response: {
+        /** Type of operation. */
+        type: "order";
+        /** Specific data. */
+        data: {
+            /** Array of statuses or error messages. */
+            statuses: ({
+                /** Resting order status. */
+                resting: {
+                    /** Order ID. */
+                    oid: number;
+                    /** Client Order ID. */
+                    cloid?: Hex;
+                };
+            } | {
+                /** Filled order status. */
+                filled: {
+                    /** Total size filled. */
+                    totalSz: string;
+                    /** Average price of fill. */
+                    avgPx: string;
+                    /** Order ID. */
+                    oid: number;
+                    /** Client Order ID. */
+                    cloid?: Hex;
+                };
+            } | {
+                /** Error message. */
+                error: string;
+            })[];
+        };
+    };
+}
+/** Response for creating a TWAP order. */
+export interface TwapOrderResponse extends BaseExchangeResponse {
+    /** Successful status. */
+    status: "ok";
+    /** Response details. */
+    response: {
+        /** Type of operation. */
+        type: "twapOrder";
+        /** Specific data. */
+        data: {
+            /** Status of the operation. */
+            status: {
+                /** Running order status. */
+                running: {
+                    /** TWAP ID. */
+                    twapId: number;
+                };
+            } | {
+                /** Error message. */
+                error: string;
+            };
+        };
+    };
+}
+/** Response for canceling a TWAP order. */
+export interface TwapCancelResponse extends BaseExchangeResponse {
+    /** Successful status. */
+    status: "ok";
+    /** Response details. */
+    response: {
+        /** Type of operation. */
+        type: "twapCancel";
+        /** Specific data. */
+        data: {
+            /** Status of the operation. */
+            status: string | {
+                /** Error message. */
+                error: string;
+            };
+        };
+    };
+}
+//# sourceMappingURL=responses.d.ts.map

package/esm/src/types/exchange/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../../../src/src/types/exchange/responses.ts"],"names":[],"mappings":"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"}

package/esm/src/types/exchange/responses.js

@@ -0,0 +1 @@
+export {};

package/esm/src/types/explorer/common.d.ts

@@ -0,0 +1,37 @@
+import type { Hex } from "../common.js";
+/** The transaction details. */
+export interface TxDetails {
+    /** The action of the transaction. */
+    action: {
+        /** Type of action. */
+        type: string;
+        /** Additional action parameters. */
+        [key: string]: unknown;
+    };
+    /** The block number in which the transaction was included. */
+    block: number;
+    /** The error message if the transaction failed. */
+    error: string | null;
+    /** The hash of the transaction. */
+    hash: Hex;
+    /** The time at which the transaction was created. */
+    time: number;
+    /** The user that created the transaction. */
+    user: Hex;
+}
+/** The block details. */
+export interface BlockDetails {
+    /** The time at which the block was created. */
+    blockTime: number;
+    /** The hash of the block. */
+    hash: Hex;
+    /** The height of the block. */
+    height: number;
+    /** The number of transactions in the block. */
+    numTxs: number;
+    /** The proposer of the block. */
+    proposer: Hex;
+    /** The transactions in the block. */
+    txs: TxDetails[];
+}
+//# sourceMappingURL=common.d.ts.map

package/esm/src/types/explorer/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/src/types/explorer/common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC,+BAA+B;AAC/B,MAAM,WAAW,SAAS;IACtB,qCAAqC;IACrC,MAAM,EAAE;QACJ,sBAAsB;QACtB,IAAI,EAAE,MAAM,CAAC;QAEb,oCAAoC;QACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KAC1B,CAAC;IAEF,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IAEd,mDAAmD;IACnD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB,mCAAmC;IACnC,IAAI,EAAE,GAAG,CAAC;IAEV,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IAEb,6CAA6C;IAC7C,IAAI,EAAE,GAAG,CAAC;CACb;AAED,yBAAyB;AACzB,MAAM,WAAW,YAAY;IACzB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAElB,6BAA6B;IAC7B,IAAI,EAAE,GAAG,CAAC;IAEV,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IAEf,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IAEf,iCAAiC;IACjC,QAAQ,EAAE,GAAG,CAAC;IAEd,qCAAqC;IACrC,GAAG,EAAE,SAAS,EAAE,CAAC;CACpB"}

package/esm/src/types/explorer/common.js

@@ -0,0 +1 @@
+export {};

package/esm/src/types/explorer/requests.d.ts

@@ -0,0 +1,22 @@
+import type { Hex } from "../common.js";
+/**
+ * The request to get the details of a transaction.
+ * @returns {TxDetailsResponse} The details of a transaction.
+ */
+export interface TxDetailsRequest {
+    /** Type of request. */
+    type: "txDetails";
+    /** The hash of a transaction. */
+    hash: Hex;
+}
+/**
+ * The request to get the details of a block.
+ * @returns {BlockDetailsResponse} The details of a block.
+ */
+export interface BlockDetailsRequest {
+    /** Type of request. */
+    type: "blockDetails";
+    /** The height of a block. */
+    height: number;
+}
+//# sourceMappingURL=requests.d.ts.map

package/esm/src/types/explorer/requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.d.ts","sourceRoot":"","sources":["../../../../src/src/types/explorer/requests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,uBAAuB;IACvB,IAAI,EAAE,WAAW,CAAC;IAElB,iCAAiC;IACjC,IAAI,EAAE,GAAG,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC,uBAAuB;IACvB,IAAI,EAAE,cAAc,CAAC;IAErB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;CAClB"}

package/esm/src/types/explorer/requests.js

@@ -0,0 +1 @@
+export {};