@nktkas/hyperliquid 0.20.0 → 0.21.0

package/README.md

@@ -45,9 +45,9 @@ deno add jsr:@nktkas/hyperliquid
 import * as hl from "@nktkas/hyperliquid";
 
 const transport = new hl.HttpTransport();
-const client = new hl.PublicClient({ transport });
+const infoClient = new hl.InfoClient({ transport });
 
-const openOrders = await client.openOrders({ user: "0x..." }); // Change to your address
+const openOrders = await infoClient.openOrders({ user: "0x..." }); // Change to your address
 ```
 
 ```ts
@@ -57,9 +57,9 @@ import { privateKeyToAccount } from "viem/accounts";
 const wallet = privateKeyToAccount("0x..."); // Your private key
 
 const transport = new hl.HttpTransport();
-const client = new hl.WalletClient({ wallet, transport });
+const exchClient = new hl.ExchangeClient({ wallet, transport });
 
-const result = await client.order({
+const result = await exchClient.order({
     orders: [{
         a: 0, // Asset index
         b: true, // Buy order
@@ -80,9 +80,9 @@ const result = await client.order({
 import * as hl from "@nktkas/hyperliquid";
 
 const transport = new hl.WebSocketTransport();
-const client = new hl.EventClient({ transport });
+const subsClient = new hl.SubscriptionClient({ transport });
 
-const sub = await client.allMids((event) => {
+const sub = await subsClient.allMids((event) => {
     console.log(event);
 });
 
@@ -109,16 +109,16 @@ const wsTransport = new hl.WebSocketTransport(); // Accepts optional parameters
 
 Next, initialize a client with the transport layer (more details in the [API Reference](#clients)):
 
-#### Create PublicClient
+#### Create InfoClient
 
 ```ts
 import * as hl from "@nktkas/hyperliquid";
 
 const transport = new hl.HttpTransport(); // or WebSocketTransport
-const client = new hl.PublicClient({ transport });
+const infoClient = new hl.InfoClient({ transport });
 ```
 
-#### Create WalletClient
+#### Create ExchangeClient
 
 ```ts
 import * as hl from "@nktkas/hyperliquid";
@@ -130,53 +130,53 @@ const transport = new hl.HttpTransport(); // or WebSocketTransport
 
 // 1. Using Viem with private key
 const viemAccount = privateKeyToAccount("0x...");
-const viemClient = new hl.WalletClient({ wallet: viemAccount, transport });
+const ExchangeClient_Viem = new hl.ExchangeClient({ wallet: viemAccount, transport });
 
 // 2. Using Ethers (or Ethers V5) with private key
 const ethersWallet = new ethers.Wallet("0x...");
-const ethersClient = new hl.WalletClient({ wallet: ethersWallet, transport });
+const ExchangeClient_Ethers = new hl.ExchangeClient({ wallet: ethersWallet, transport });
 
 // 3. Using external wallet (e.g. MetaMask) via Viem
 const [account] = await window.ethereum.request({ method: "eth_requestAccounts" });
 const externalWallet = createWalletClient({ account, transport: custom(window.ethereum) });
-const viemMetamaskClient = new hl.WalletClient({ wallet: externalWallet, transport });
+const ExchangeClient_ViemMetamask = new hl.ExchangeClient({ wallet: externalWallet, transport });
 
 // 4. Using external wallet (e.g. MetaMask) via `window.ethereum` directly
-const windowMetamaskClient = new hl.WalletClient({ wallet: window.ethereum, transport });
+const ExchangeClient_WindowMetamask = new hl.ExchangeClient({ wallet: window.ethereum, transport });
 ```
 
-#### Create EventClient
+#### Create SubscriptionClient
 
 ```ts
 import * as hl from "@nktkas/hyperliquid";
 
 const transport = new hl.WebSocketTransport(); // only WebSocketTransport
-const client = new hl.EventClient({ transport });
+const subsClient = new hl.SubscriptionClient({ transport });
 ```
 
 ### 3) Use Client
 
 Finally, use client methods to interact with the Hyperliquid API (more details in the [API Reference](#clients)):
 
-#### Example of using a public client
+#### Example of using an InfoClient
 
 ```ts
 import * as hl from "@nktkas/hyperliquid";
 
 const transport = new hl.HttpTransport();
-const client = new hl.PublicClient({ transport });
+const infoClient = new hl.InfoClient({ transport });
 
 // L2 Book
-const l2Book = await client.l2Book({ coin: "BTC" });
+const l2Book = await infoClient.l2Book({ coin: "BTC" });
 
 // Account clearinghouse state
-const clearinghouseState = await client.clearinghouseState({ user: "0x..." });
+const clearinghouseState = await infoClient.clearinghouseState({ user: "0x..." });
 
 // Open orders
-const openOrders = await client.openOrders({ user: "0x..." });
+const openOrders = await infoClient.openOrders({ user: "0x..." });
 ```
 
-#### Example of using a wallet client
+#### Example of using an ExchangeClient
 
 ```ts
 import * as hl from "@nktkas/hyperliquid";
@@ -184,10 +184,10 @@ import { privateKeyToAccount } from "viem/accounts";
 
 const account = privateKeyToAccount("0x...");
 const transport = new hl.HttpTransport();
-const client = new hl.WalletClient({ wallet: account, transport });
+const exchClient = new hl.ExchangeClient({ wallet: account, transport });
 
 // Place an orders
-const result = await client.order({
+const result = await exchClient.order({
     orders: [{
         a: 0,
         b: true,
@@ -204,25 +204,25 @@ const result = await client.order({
 });
 
 // Approve an agent
-const result = await client.approveAgent({
+const result = await exchClient.approveAgent({
     agentAddress: "0x...",
     agentName: "agentName",
 });
 
 // Withdraw funds
-const result = await client.withdraw3({
+const result = await exchClient.withdraw3({
     destination: account.address,
     amount: "100",
 });
 ```
 
-#### Example of using an event client
+#### Example of using a SubscriptionClient
 
 ```ts
 import * as hl from "@nktkas/hyperliquid";
 
 const transport = new hl.WebSocketTransport();
-const client = new hl.EventClient({ transport });
+const subsClient = new hl.SubscriptionClient({ transport });
 
 // L2 Book updates
 await client.l2Book({ coin: "BTC" }, (data) => {
@@ -246,16 +246,16 @@ await client.explorerBlock((data) => {
 
 A Client provides access to the Hyperliquid API endpoints.
 
-#### Public Client
+#### Info Client
 
-A Public Client which provides access to
+An Info Client which provides access to
 [Info API](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint) and Explorer API, such as
 `l2Book` and `clearinghouseState`.
 
-The Public Client class sets up with a given [Transport](#transports).
+The Info Client class sets up with a given [Transport](#transports).
 
 ```ts
-class PublicClient {
+class InfoClient {
     constructor(args: {
         transport: HttpTransport | WebSocketTransport;
     });
@@ -324,18 +324,18 @@ class PublicClient {
 }
 ```
 
-#### Wallet Client
+#### Exchange Client
 
-A Wallet Client which provides access to
+An Exchange Client which provides access to
 [Exchange API](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint), such as `order`
 and `withdraw3`.
 
-The Wallet Client class sets up with a given [Transport](#transports) and a wallet instance, which can be a
+The Exchange Client class sets up with a given [Transport](#transports) and a wallet instance, which can be a
 [viem](https://viem.sh/docs/clients/wallet), [ethers.js](https://docs.ethers.org/v6/api/providers/#Signer) or other
 wallet libraries.
 
 ```ts
-class WalletClient {
+class ExchangeClient {
     constructor(args: {
         transport: HttpTransport | WebSocketTransport;
         wallet:
@@ -408,17 +408,17 @@ class WalletClient {
 }
 ```
 
-#### Event Client
+#### Subscription Client
 
-A Event Client which provides access to
+A Subscription Client which provides access to
 [Subscriptions API](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions), such as
 real-time updates for `l2Book` and `userFills`.
 
-The Event Client class sets up with a given [WebSocket Transport](#websocket-transport).
+The Subscription Client class sets up with a given [WebSocket Transport](#websocket-transport).
 
 <!-- deno-fmt-ignore-start -->
 ```ts
-class EventClient {
+class SubscriptionClient {
     constructor(args: {
         transport: WebSocketTransport;
     });
@@ -473,8 +473,6 @@ class HttpTransport {
         onRequest?: (request: Request) => MaybePromise<Request | void | null | undefined>; // A callback before request is sent
         onResponse?: (response: Response) => MaybePromise<Response | void | null | undefined>; // A callback after response is received
     });
-
-    request(endpoint: "info" | "exchange" | "explorer", payload: unknown, signal?: AbortSignal): Promise<unknown>;
 }
 ```
 
@@ -499,16 +497,8 @@ class WebSocketTransport {
             shouldReconnect?: (event: CloseEvent) => boolean | Promise<boolean>; // Custom reconnection logic (default: Always reconnect)
             messageBuffer?: MessageBufferStrategy; // Message buffering strategy between reconnection (default: FIFO buffer)
         };
+        autoResubscribe?: boolean; // Whether to automatically resubscribe to events after reconnection (default: true)
     });
-
-    request(endpoint: "info" | "exchange", payload: unknown, signal?: AbortSignal): Promise<unknown>;
-    subscribe(
-        channel: string,
-        payload: unknown,
-        listener: (data: CustomEvent) => void,
-        signal?: AbortSignal,
-    ): Promise<Subscription>;
-
     ready(signal?: AbortSignal): Promise<void>;
     close(signal?: AbortSignal): Promise<void>;
 }

package/esm/mod.d.ts

@@ -1,10 +1,9 @@
-import "./_dnt.polyfills.js";
 export * from "./src/base.js";
 export * from "./src/transports/base.js";
 export type { AbstractEthersSigner, AbstractEthersV5Signer, AbstractExtendedViemWalletClient, AbstractViemWalletClient, AbstractWindowEthereum, } from "./src/signing.js";
-export * from "./src/clients/event.js";
-export * from "./src/clients/public.js";
-export * from "./src/clients/wallet.js";
+export * from "./src/clients/subscription.js";
+export * from "./src/clients/info.js";
+export * from "./src/clients/exchange.js";
 export * from "./src/transports/http/http_transport.js";
 export * from "./src/transports/websocket/websocket_transport.js";
 export type * from "./src/types/exchange/responses.js";

package/esm/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AACA,OAAO,qBAAqB,CAAC;AAE7B,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AAGzC,YAAY,EACR,oBAAoB,EACpB,sBAAsB,EACtB,gCAAgC,EAChC,wBAAwB,EACxB,sBAAsB,GACzB,MAAM,kBAAkB,CAAC;AAG1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AAGxC,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,iCAAiC,CAAC;AACrD,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,EACR,oBAAoB,EACpB,sBAAsB,EACtB,gCAAgC,EAChC,wBAAwB,EACxB,sBAAsB,GACzB,MAAM,kBAAkB,CAAC;AAG1B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAG1C,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,iCAAiC,CAAC;AACrD,mBAAmB,6BAA6B,CAAC;AACjD,mBAAmB,4BAA4B,CAAC;AAChD,mBAAmB,4BAA4B,CAAC;AAChD,mBAAmB,wCAAwC,CAAC"}

package/esm/mod.js

@@ -1,11 +1,10 @@
 // Base interfaces
-import "./_dnt.polyfills.js";
 export * from "./src/base.js";
 export * from "./src/transports/base.js";
 // Clients
-export * from "./src/clients/event.js";
-export * from "./src/clients/public.js";
-export * from "./src/clients/wallet.js";
+export * from "./src/clients/subscription.js";
+export * from "./src/clients/info.js";
+export * from "./src/clients/exchange.js";
 // Transports
 export * from "./src/transports/http/http_transport.js";
 export * from "./src/transports/websocket/websocket_transport.js";