@nktkas/hyperliquid 0.23.1 → 0.24.0

package/CONTRIBUTING.md

@@ -8,7 +8,7 @@ Welcome, and thank you for taking time in contributing to SDK! You can contribut
 
 ## Development Setup
 
-You will need [Deno](https://deno.land/) 2.0+.
+You will need [Deno](https://deno.com) 2.0+.
 
 1. Fork this repository to your own GitHub account.
 2. Clone the repository to your local device.
@@ -26,7 +26,8 @@ You can run most tests with the following command:
 deno test -A
 ```
 
-However, for complete testing, you will need a private key from a testnet account with funds:
+However, for complete testing, you will need a private key from a testnet account with funds (~100 usdc-perps, ~3
+usdc-spot, ~0.0000001 hype-spot):
 
 ```bash
 deno test -A -- YOUR_PRIVATE_KEY

package/README.md

@@ -6,16 +6,16 @@
 [![bundlephobia](https://img.shields.io/bundlephobia/minzip/@nktkas/hyperliquid?style=flat-square)](https://bundlephobia.com/package/@nktkas/hyperliquid)
 
 Unofficial [Hyperliquid API](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api) SDK for all major JS
-runtimes, written in TypeScript and provided with tests.
+runtimes, written in TypeScript.
 
 ## Features
 
 - 🖋️ **Typed**: Source code is 100% TypeScript.
-- 🧪 **Tested**: Good code coverage and type-safe API responses.
+- 🧪 **Tested**: Good code coverage and type relevance.
 - 📦 **Minimal dependencies**: A few small trusted dependencies.
 - 🌐 **Cross-Environment Support**: Compatible with all major JS runtimes.
-- 🔧 **Integratable**: Easy to use with [viem](https://github.com/wevm/viem),
-  [ethers](https://github.com/ethers-io/ethers.js) and other wallet libraries.
+- 🔧 **Integratable**: Easy to use with wallet providers ([viem](https://github.com/wevm/viem),
+  [ethers](https://github.com/ethers-io/ethers.js), private key directly).
 - 📚 **Documented**: JSDoc annotations with usage examples in source code.
 
 ## Installation
@@ -55,7 +55,7 @@ deno add jsr:@nktkas/hyperliquid
 ```js
 // React Native 0.76.3 / Expo v52
 // Issues:
-// - signing: does not support private keys directly, use viem or ethers
+// - signing: does not support private keys directly, use `viem` or `ethers`
 
 import { Event, EventTarget } from "event-target-shim";
 
@@ -97,27 +97,34 @@ if (!Promise.withResolvers) {
 
 ## Quick Start
 
-#### Info endpoint
+### [Info endpoint](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint)
 
 ```ts
+// 1. Import module
 import * as hl from "@nktkas/hyperliquid";
 
-const transport = new hl.HttpTransport();
-const infoClient = new hl.InfoClient({ transport });
+// 1. Set up client with transport
+const infoClient = new hl.InfoClient({
+    transport: new hl.HttpTransport(), // or `WebSocketTransport`
+});
 
+// 3. Query data
 const openOrders = await infoClient.openOrders({ user: "0x..." });
 ```
 
-#### Exchange endpoint
+### [Exchange endpoint](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint)
 
 ```ts
+// 1. Import module
 import * as hl from "@nktkas/hyperliquid";
 
-const privateKey = "0x..."; // or `viem`, `ethers`
-
-const transport = new hl.HttpTransport();
-const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
+// 2. Set up client with wallet and transport
+const exchClient = new hl.ExchangeClient({
+    wallet: "0x...", // `viem`, `ethers`, or private key directly
+    transport: new hl.HttpTransport(), // or `WebSocketTransport`
+});
 
+// 3. Execute an action
 const result = await exchClient.order({
     orders: [{
         a: 0,
@@ -135,38 +142,41 @@ const result = await exchClient.order({
 });
 ```
 
-#### Subscription
+### [Subscription](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions)
 
 ```ts
+// 1. Import module
 import * as hl from "@nktkas/hyperliquid";
 
-const transport = new hl.WebSocketTransport();
-const subsClient = new hl.SubscriptionClient({ transport });
+// 2. Set up client with transport
+const subsClient = new hl.SubscriptionClient({
+    transport: new hl.WebSocketTransport(),
+});
 
+// 3. Subscribe to events
 const sub = await subsClient.allMids((event) => {
     console.log(event);
 });
-
-await sub.unsubscribe(); // unsubscribe from the event
+await sub.unsubscribe();
 ```
 
-#### Multi-Sign
+### [Multi-Sign](https://hyperliquid.gitbook.io/hyperliquid-docs/hypercore/multi-sig)
 
 ```ts
+// 1. Import module
 import * as hl from "@nktkas/hyperliquid";
 
-const multiSignAddress = "0x...";
-const signers = [
-    "0x...", // Private key; or any other wallet libraries
-] as const;
-
-const transport = new hl.HttpTransport();
-const multiSignClient = new hl.MultiSignClient({ transport, multiSignAddress, signers }); // extends `ExchangeClient`
-
-const data = await multiSignClient.approveAgent({ // same API as `ExchangeClient`
-    agentAddress: "0x...",
-    agentName: "agentName",
+// 2. Set up client with
+const multiSignClient = new hl.MultiSignClient({
+    transport: new hl.HttpTransport(), // or `WebSocketTransport`
+    multiSignAddress: "0x...",
+    signers: [
+        "0x...", // `viem`, `ethers`, or private key directly
+    ],
 });
+
+// 3. Execute an action
+const data = await multiSignClient.approveAgent({ agentAddress: "0x..." });
 ```
 
 ## Usage
@@ -179,26 +189,27 @@ First, choose and configure your transport layer (more details in the [API Refer
 import * as hl from "@nktkas/hyperliquid";
 
 // 1. HTTP Transport: suitable for one-time requests or serverless environments
-const httpTransport = new hl.HttpTransport(); // Accepts optional parameters (e.g. isTestnet, timeout, etc.)
+const httpTransport = new hl.HttpTransport({...}); // Accepts optional parameters (e.g. isTestnet, timeout, etc.)
 
 // 2. WebSocket Transport: has better network latency than HTTP transport
-const wsTransport = new hl.WebSocketTransport(); // Accepts optional parameters (e.g. url, timeout, reconnect, etc.)
+const wsTransport = new hl.WebSocketTransport({...}); // Accepts optional parameters (e.g. url, timeout, reconnect, etc.)
 ```
 
 ### 2) Initialize Client
 
 Next, initialize a client with the transport layer (more details in the [API Reference](#clients)):
 
-#### Create InfoClient
+#### Create [InfoClient](#infoclient)
 
 ```ts
 import * as hl from "@nktkas/hyperliquid";
 
-const transport = new hl.HttpTransport(); // or `WebSocketTransport`
-const infoClient = new hl.InfoClient({ transport });
+const infoClient = new hl.InfoClient({
+    transport: new hl.HttpTransport(), // or `WebSocketTransport`
+});
 ```
 
-#### Create ExchangeClient
+#### Create [ExchangeClient](#exchangeclient)
 
 ```ts
 import * as hl from "@nktkas/hyperliquid";
@@ -216,7 +227,7 @@ const exchClient_privateKey = new hl.ExchangeClient({ wallet: privateKey, transp
 const viemAccount = privateKeyToAccount("0x...");
 const exchClient_viem = new hl.ExchangeClient({ wallet: viemAccount, transport });
 
-// 3. Using Ethers (or Ethers V5)
+// 3. Using Ethers (V5 or V6)
 const ethersWallet = new ethers.Wallet("0x...");
 const exchClient_ethers = new hl.ExchangeClient({ wallet: ethersWallet, transport });
 
@@ -224,70 +235,69 @@ const exchClient_ethers = new hl.ExchangeClient({ wallet: ethersWallet, transpor
 const [account] = await window.ethereum.request({ method: "eth_requestAccounts" });
 const externalWallet = createWalletClient({ account, transport: custom(window.ethereum) });
 const exchClient_viemMetamask = new hl.ExchangeClient({ wallet: externalWallet, transport });
-
-// 5. Using external wallet (e.g. MetaMask) via `window.ethereum`
-const exchClient_windowMetamask = new hl.ExchangeClient({ wallet: window.ethereum, transport });
 ```
 
-#### Create SubscriptionClient
+#### Create [SubscriptionClient](#subscriptionclient)
 
 ```ts
 import * as hl from "@nktkas/hyperliquid";
 
-const transport = new hl.WebSocketTransport(); // only `WebSocketTransport`
-const subsClient = new hl.SubscriptionClient({ transport });
+const subsClient = new hl.SubscriptionClient({
+    transport: new hl.WebSocketTransport(),
+});
 ```
 
-#### Create MultiSignClient
+#### Create [MultiSignClient](#multisignclient)
 
 ```ts
 import * as hl from "@nktkas/hyperliquid";
 import { privateKeyToAccount } from "viem/accounts";
 import { ethers } from "ethers";
 
-const multiSignAddress = "0x...";
-const signers = [
-    privateKeyToAccount("0x..."), // first is leader for multi-sign transaction, must contain own address
-    new ethers.Wallet("0x..."),
-    { // can be a custom async wallet
-        async signTypedData(params: {
-            domain: {
-                name: string;
-                version: string;
-                chainId: number;
-                verifyingContract: Hex;
-            };
-            types: {
-                [key: string]: {
+const multiSignClient = new hl.MultiSignClient({
+    transport: new hl.HttpTransport(), // or `WebSocketTransport`
+    multiSignAddress: "0x...",
+    signers: [
+        privateKeyToAccount("0x..."), // first is leader for multi-sign transaction (signs transaction 2 times)
+        new ethers.Wallet("0x..."),
+        { // can be a custom async wallet
+            async signTypedData(params: {
+                domain: {
                     name: string;
-                    type: string;
-                }[];
-            };
-            primaryType: string;
-            message: Record<string, unknown>;
-        }): Promise<Hex> {
-            // Custom signer logic
-            return "0x..."; // return hex signature
+                    version: string;
+                    chainId: number;
+                    verifyingContract: `0x${string}`;
+                };
+                types: {
+                    [key: string]: {
+                        name: string;
+                        type: string;
+                    }[];
+                };
+                primaryType: string;
+                message: Record<string, unknown>;
+            }): Promise<`0x${string}`> {
+                // Custom signer logic
+                return "0x..."; // return hex signature
+            },
         },
-    },
-    "0x...", // private key directly
-];
-
-const transport = new hl.HttpTransport();
-const multiSignClient = new hl.MultiSignClient({ transport, multiSignAddress, signers }); // extends `ExchangeClient`
+        "0x...", // private key directly
+    ],
+});
 ```
 
 ### 3) Use Client
 
 Finally, use client methods to interact with the Hyperliquid API (more details in the [API Reference](#clients)):
 
-#### Example of using an InfoClient
+#### Example of using an [InfoClient](#infoclient)
 
 ```ts
 import * as hl from "@nktkas/hyperliquid";
 
-const transport = new hl.HttpTransport();
-const infoClient = new hl.InfoClient({ transport });
+const infoClient = new hl.InfoClient({
+    transport: new hl.HttpTransport(), // or `WebSocketTransport`
+});
 
 // L2 Book
 const l2Book = await infoClient.l2Book({ coin: "BTC" });
@@ -299,15 +309,15 @@ const clearinghouseState = await infoClient.clearinghouseState({ user: "0x..." }
 const openOrders = await infoClient.openOrders({ user: "0x..." });
 ```
 
-#### Example of using an ExchangeClient
+#### Example of using an [ExchangeClient](#exchangeclient)
 
 ```ts
 import * as hl from "@nktkas/hyperliquid";
 
-const privateKey = "0x..."; // or `viem`, `ethers`
-
-const transport = new hl.HttpTransport();
-const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
+const exchClient = new hl.ExchangeClient({
+    wallet: "0x...", // `viem`, `ethers`, or private key directly
+    transport: new hl.HttpTransport(), // or `WebSocketTransport`
+});
 
 // Place an orders
 const result = await exchClient.order({
@@ -327,25 +337,20 @@ const result = await exchClient.order({
 });
 
 // Approve an agent
-const result = await exchClient.approveAgent({
-    agentAddress: "0x...",
-    agentName: "agentName",
-});
+const result = await exchClient.approveAgent({ agentAddress: "0x..." });
 
 // Withdraw funds
-const result = await exchClient.withdraw3({
-    destination: account.address,
-    amount: "100",
-});
+const result = await exchClient.withdraw3({ destination: "0x...", amount: "100" });
 ```
 
-#### Example of using a SubscriptionClient
+#### Example of using a [SubscriptionClient](#subscriptionclient)
 
 ```ts
 import * as hl from "@nktkas/hyperliquid";
 
-const transport = new hl.WebSocketTransport();
-const subsClient = new hl.SubscriptionClient({ transport });
+const subsClient = new hl.SubscriptionClient({
+    transport: new hl.WebSocketTransport(),
+});
 
 // L2 Book updates
 await subsClient.l2Book({ coin: "BTC" }, (data) => {
@@ -358,54 +363,25 @@ await subsClient.userFills({ user: "0x..." }, (data) => {
 });
 
 // Candle updates
-const sub = await subsClient.candle({ coin: "BTC", interval: "1h" }, (data) => {
+await subsClient.candle({ coin: "BTC", interval: "1h" }, (data) => {
     console.log(data);
 });
 ```
 
-#### Example of using a MultiSignClient
+#### Example of using a [MultiSignClient](#multisignclient)
 
 ```ts
 import * as hl from "@nktkas/hyperliquid";
 
-const multiSignAddress = "0x...";
-const signers = [
-    "0x...", // Private keys
-] as const;
-
-const transport = new hl.HttpTransport();
-const multiSignClient = new hl.MultiSignClient({ transport, multiSignAddress, signers });
-
-// Interaction is the same as with `ExchangeClient`
-
-// Place an orders
-const result = await multiSignClient.order({
-    orders: [{
-        a: 0,
-        b: true,
-        p: "30000",
-        s: "0.1",
-        r: false,
-        t: {
-            limit: {
-                tif: "Gtc",
-            },
-        },
-    }],
-    grouping: "na",
-});
-
-// Approve an agent
-const result = await multiSignClient.approveAgent({
-    agentAddress: "0x...",
-    agentName: "agentName",
+const multiSignClient = new hl.MultiSignClient({
+    transport: new hl.HttpTransport(), // or `WebSocketTransport`
+    multiSignAddress: "0x...",
+    signers: [
+        "0x...", // `viem`, `ethers`, or private key directly
+    ],
 });
 
-// Withdraw funds
-const result = await multiSignClient.withdraw3({
-    destination: account.address,
-    amount: "100",
-});
+// Interaction is the same as with `ExchangeClient`
 ```
 
 ## API Reference
@@ -414,9 +390,6 @@ const result = await multiSignClient.withdraw3({
 
 A client is an interface through which you can interact with the Hyperliquid API.
 
-The client is responsible for formatting an action, creating a signature correctly, sending a request, and validating a
-response.
-
 #### InfoClient
 
 ```ts
@@ -503,16 +476,11 @@ class InfoClient {
 class ExchangeClient {
     constructor(args: {
         transport: HttpTransport | WebSocketTransport;
-        wallet:
-            | Hex // Private key directly
-            | AbstractViemWalletClient // viem
-            | AbstractEthersSigner // ethers
-            | AbstractEthersV5Signer // ethers v5
-            | AbstractWindowEthereum; // window.ethereum (EIP-1193)
+        wallet: AbstractWallet; // `viem`, `ethers` (v5 or v6), or private key directly
         isTestnet?: boolean; // Whether to use testnet (default: false)
-        defaultVaultAddress?: Hex; // Vault address used by default if not provided in method call
-        signatureChainId?: Hex | (() => MaybePromise<Hex>); // Chain ID used for signing (default: trying to guess based on wallet and `isTestnet`)
-        nonceManager?: () => MaybePromise<number>; // Function to get the next nonce (default: auto-incrementing `Date.now()`)
+        defaultVaultAddress?: `0x${string}`; // Vault address used by default if not provided in method call
+        signatureChainId?: `0x${string}` | (() => MaybePromise<`0x${string}`>); // Chain ID used for signing (default: get chain id from wallet otherwise `0x1`)
+        nonceManager?: () => MaybePromise<number>; // Function to get the next nonce (default: monotonically incrementing `Date.now()`)
     });
 
     // Order
@@ -537,11 +505,10 @@ class ExchangeClient {
     reserveRequestWeight(args: ReserveRequestWeightParameters): Promise<SuccessResponse>;
     setDisplayName(args: SetDisplayNameParameters): Promise<SuccessResponse>;
     setReferrer(args: SetReferrerParameters): Promise<SuccessResponse>;
+    subAccountModify(args: SubAccountModifyParameters): Promise<SuccessResponse>;
     spotUser(args: SpotUserParameters): Promise<SuccessResponse>;
 
     // Transfer
-    perpDexClassTransfer(args: PerpDexClassTransferParameters): Promise<SuccessResponse>;
-    perpDexTransfer(args: PerpDexTransferParameters): Promise<SuccessResponse>;
     spotSend(args: SpotSendParameters): Promise<SuccessResponse>;
     subAccountSpotTransfer(args: SubAccountSpotTransferParameters): Promise<SuccessResponse>;
     subAccountTransfer(args: SubAccountTransferParameters): Promise<SuccessResponse>;
@@ -585,7 +552,7 @@ class SubscriptionClient {
 
     // Market
     activeAssetCtx(args: EventActiveAssetCtxParameters, listener: (data: WsActiveAssetCtx | WsActiveSpotAssetCtx) => void): Promise<Subscription>;
-    activeAssetData(args: EventActiveAssetDataParameters, listener: (data: WsActiveAssetData) => void): Promise<Subscription>;
+    activeAssetData(args: EventActiveAssetDataParameters, listener: (data: ActiveAssetData) => void): Promise<Subscription>;
     allMids(listener: (data: WsAllMids) => void): Promise<Subscription>;
     bbo(args: EventBboParameters, listener: (data: WsBbo) => void): Promise<Subscription>;
     candle(args: EventCandleParameters, listener: (data: Candle) => void): Promise<Subscription>;
@@ -605,7 +572,7 @@ class SubscriptionClient {
     userTwapHistory(args: EventUserTwapHistory, listener: (data: WsUserTwapHistory) => void): Promise<Subscription>;
     userTwapSliceFills(args: EventUserTwapSliceFills, listener: (data: WsUserTwapSliceFills) => void): Promise<Subscription>;
 
-    // Explorer
+    // Explorer (RPC endpoint)
     explorerBlock(listener: (data: WsBlockDetails[]) => void): Promise<Subscription>;
     explorerTxs(listener: (data: TxDetails[]) => void): Promise<Subscription>;
 }
@@ -618,13 +585,10 @@ class SubscriptionClient {
 class MultiSignClient extends ExchangeClient {
     constructor(
         args:
-            & Omit<ExchangeClientParameters, "wallet"> // Instead of `wallet`, you should specify the following parameters:
+            & Omit<ExchangeClientParameters, "wallet"> // instead of `wallet`, you should specify the following parameters:
             & {
-                multiSignAddress: Hex; // Multi-signature address
-                signers: [ // Array of signers
-                    AbstractWalletWithAddress, // First signer is the leader of a multi-sign transaction
-                    ...AbstractWallet[], // Any number of additional signers
-                ];
+                multiSignAddress: `0x${string}`;
+                signers: [AbstractWallet, ...AbstractWallet[]];
             },
     );
 
@@ -638,7 +602,11 @@ Transport acts as a layer between class requests and Hyperliquid servers.
 
 #### HTTP Transport
 
-HTTP transport is suitable for one-off requests or serverless environments.
+**Features:**
+
+- Uses [fetch](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) for requests. Can be configured using
+  [`fetchOptions`](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit).
+- Automatically determines the target URL based on the request + `isTestnet` flag.
 
 ```ts
 class HttpTransport {
@@ -658,7 +626,20 @@ class HttpTransport {
 
 #### WebSocket Transport
 
-WebSocket transport has better network latency than HTTP transport.
+**Features:**
+
+- Uses [WebSocket](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket) for requests.
+- Supports [subscriptions](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions)
+  and [post requests](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/post-requests).
+- Automatically restores connection after loss and resubscribes to previous subscriptions.
+- Smart keep alive (pings only when idle).
+- Lazy initialization with message buffering during connection establishment.
+
+**Limitations:**
+
+- Cannot mix api/explorer endpoints or mainnet/testnet in single connection. Need to create separate instances for
+  different endpoints.
+- Cannot send explorer post-requests via WebSocket. Use [HTTP transport](#http-transport).
 
 ```ts
 class WebSocketTransport {
@@ -701,27 +682,23 @@ The import point gives access to functions that generate signatures for Hyperliq
 ```ts
 import { actionSorter, signL1Action } from "@nktkas/hyperliquid/signing";
 
-const privateKey = "0x..."; // or `viem`, `ethers`
+const privateKey = "0x..."; // `viem`, `ethers`, or private key directly
 
-const nonce = Date.now();
-const action = {
+const action = actionSorter.cancel({
     type: "cancel",
     cancels: [
         { a: 0, o: 12345 },
     ],
-} as const;
-
-const signature = await signL1Action({
-    wallet: privateKey,
-    action: actionSorter[action.type](action),
-    nonce,
 });
+const nonce = Date.now();
+
+const signature = await signL1Action({ wallet: privateKey, action, nonce });
 
 // Send the signed action to the Hyperliquid API
 const response = await fetch("https://api.hyperliquid.xyz/exchange", {
     method: "POST",
     headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ action, signature, nonce }),
+    body: JSON.stringify({ action, signature, nonce }), // recommended to send the same formatted action
 });
 const body = await response.json();
 ```
@@ -729,18 +706,18 @@ const body = await response.json();
 #### Approve agent yourself
 
 ```ts
-import { signUserSignedAction, userSignedActionEip712Types } from "@nktkas/hyperliquid/signing";
+import { actionSorter, signUserSignedAction, userSignedActionEip712Types } from "@nktkas/hyperliquid/signing";
 
-const privateKey = "0x..."; // or `viem`, `ethers`
+const privateKey = "0x..."; // `viem`, `ethers`, or private key directly
 
-const action = {
+const action = actionSorter.approveAgent({
     type: "approveAgent",
     signatureChainId: "0x66eee",
     hyperliquidChain: "Mainnet",
     agentAddress: "0x...",
     agentName: "Agent",
     nonce: Date.now(),
-} as const;
+});
 
 const signature = await signUserSignedAction({
     wallet: privateKey,
@@ -752,7 +729,7 @@ const signature = await signUserSignedAction({
 const response = await fetch("https://api.hyperliquid.xyz/exchange", {
     method: "POST",
     headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ action, signature, nonce: action.nonce }),
+    body: JSON.stringify({ action, signature, nonce: action.nonce }), // recommended to send the same formatted action
 });
 const body = await response.json();
 ```
@@ -771,12 +748,19 @@ L1 action through an external wallet:
 
 ### How to create a market order?
 
-Hyperliquid doesn't have traditional market orders, but you can achieve market-like execution by placing limit orders
-with `tif: "Ioc"` and prices that guarantee immediate execution:
+Hyperliquid doesn't have traditional market orders, but you can achieve market-like execution by placing limit order
+with `tif: "Ioc"` and price that guarantee immediate execution:
 
 - For buys: set limit price >= current best ask
 - For sells: set limit price <= current best bid
 
+### How to use the [Agent Wallet](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/nonces-and-api-wallets#api-wallets) / [Vault](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#subaccounts-and-vaults) / [Sub-Account](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#subaccounts-and-vaults) in `ExchangeClient`?
+
+**Agent Wallet**: Use agent's private key in constructor instead of master account's private key.
+
+**Vault and Sub-Account**: Pass vault or sub-account address via `vaultAddress` options to methods or set
+`defaultVaultAddress` in constructor.
+
 ## Contributing
 
 We appreciate your help! To contribute, please read the [contributing instructions](CONTRIBUTING.md).

package/esm/mod.d.ts

@@ -1,6 +1,6 @@
 export * from "./src/base.js";
 export * from "./src/transports/base.js";
-export type { AbstractEthersSigner, AbstractEthersV5Signer, AbstractViemWalletClient, AbstractWindowEthereum, } from "./src/signing/mod.js";
+export type { AbstractWallet } from "./src/signing/mod.js";
 export * from "./src/clients/exchange.js";
 export * from "./src/clients/info.js";
 export * from "./src/clients/multiSign.js";

package/esm/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AACA,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AAGzC,YAAY,EACR,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,mDAAmD,CAAC;AAGlE,mBAAmB,mCAAmC,CAAC;AACvD,mBAAmB,mCAAmC,CAAC;AACvD,mBAAmB,8BAA8B,CAAC;AAClD,mBAAmB,4BAA4B,CAAC;AAChD,mBAAmB,gCAAgC,CAAC;AACpD,mBAAmB,6BAA6B,CAAC;AACjD,mBAAmB,4BAA4B,CAAC;AAChD,mBAAmB,4BAA4B,CAAC;AAChD,mBAAmB,wCAAwC,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AACA,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AAGzC,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,mDAAmD,CAAC;AAGlE,mBAAmB,mCAAmC,CAAC;AACvD,mBAAmB,mCAAmC,CAAC;AACvD,mBAAmB,8BAA8B,CAAC;AAClD,mBAAmB,4BAA4B,CAAC;AAChD,mBAAmB,gCAAgC,CAAC;AACpD,mBAAmB,6BAA6B,CAAC;AACjD,mBAAmB,4BAA4B,CAAC;AAChD,mBAAmB,4BAA4B,CAAC;AAChD,mBAAmB,wCAAwC,CAAC"}

package/esm/src/base.d.ts

@@ -1,8 +1,3 @@
-export type Hex = `0x${string}`;
-export type MaybePromise<T> = T | Promise<T>;
-export type DeepImmutable<T> = {
-    readonly [K in keyof T]: DeepImmutable<T[K]>;
-};
 /** Base error class for all SDK errors. */
 export declare class HyperliquidError extends Error {
     constructor(message?: string, options?: ErrorOptions);

package/esm/src/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/src/base.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,GAAG,KAAK,MAAM,EAAE,CAAC;AAEhC,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAG7C,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC3B,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/C,CAAC;AAEF,2CAA2C;AAC3C,qBAAa,gBAAiB,SAAQ,KAAK;gBAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIvD"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/src/base.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,qBAAa,gBAAiB,SAAQ,KAAK;gBAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIvD"}