@tria-sdk/hyperliquid-core 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/dist/api.d.ts +279 -0
  2. package/dist/api.d.ts.map +1 -0
  3. package/dist/api.js +914 -0
  4. package/dist/api.js.map +1 -0
  5. package/dist/client.d.ts +6 -0
  6. package/dist/client.d.ts.map +1 -0
  7. package/dist/client.js +35 -0
  8. package/dist/client.js.map +1 -0
  9. package/dist/exchange.d.ts +131 -0
  10. package/dist/exchange.d.ts.map +1 -0
  11. package/dist/exchange.js +6 -0
  12. package/dist/exchange.js.map +1 -0
  13. package/dist/index.d.ts +7 -0
  14. package/dist/index.d.ts.map +1 -0
  15. package/dist/index.js +7 -0
  16. package/dist/index.js.map +1 -0
  17. package/dist/types.d.ts +357 -0
  18. package/dist/types.d.ts.map +1 -0
  19. package/dist/types.js +6 -0
  20. package/dist/types.js.map +1 -0
  21. package/dist/utils/format.d.ts +62 -0
  22. package/dist/utils/format.d.ts.map +1 -0
  23. package/dist/utils/format.js +193 -0
  24. package/dist/utils/format.js.map +1 -0
  25. package/dist/utils/localization.d.ts +93 -0
  26. package/dist/utils/localization.d.ts.map +1 -0
  27. package/dist/utils/localization.js +108 -0
  28. package/dist/utils/localization.js.map +1 -0
  29. package/dist/websocket/WebSocketManager.d.ts +41 -0
  30. package/dist/websocket/WebSocketManager.d.ts.map +1 -0
  31. package/dist/websocket/WebSocketManager.js +295 -0
  32. package/dist/websocket/WebSocketManager.js.map +1 -0
  33. package/dist/websocket/index.d.ts +3 -0
  34. package/dist/websocket/index.d.ts.map +1 -0
  35. package/dist/websocket/index.js +3 -0
  36. package/dist/websocket/index.js.map +1 -0
  37. package/dist/websocket/types.d.ts +98 -0
  38. package/dist/websocket/types.d.ts.map +1 -0
  39. package/dist/websocket/types.js +2 -0
  40. package/dist/websocket/types.js.map +1 -0
  41. package/package.json +28 -0
@@ -0,0 +1,295 @@
1
+ import { SubscriptionClient, WebSocketTransport, } from "@nktkas/hyperliquid";
2
+ const DEFAULT_THROTTLE_CONFIGS = {
3
+ allMids: { minInterval: 1000, maxBatchSize: 1 },
4
+ l2Book: { minInterval: 500, maxBatchSize: 1 },
5
+ trades: { minInterval: 500, maxBatchSize: 10 },
6
+ activeAssetCtx: { minInterval: 2000, maxBatchSize: 1 },
7
+ };
8
+ const DEFAULT_RECONNECT_CONFIG = {
9
+ initialDelay: 1000,
10
+ maxDelay: 30000,
11
+ multiplier: 2,
12
+ maxAttempts: 10,
13
+ };
14
+ export class WebSocketManager {
15
+ constructor(config) {
16
+ this.subscriptions = new Map();
17
+ this.throttleTimers = new Map();
18
+ this.pendingUpdates = new Map();
19
+ this.reconnectAttempts = 0;
20
+ this.reconnectTimer = null;
21
+ this.connectionListeners = new Set();
22
+ this.isPaused = false;
23
+ this.pausedSubscriptions = new Map();
24
+ this.wsTransport = null;
25
+ this.subscriptionClient = null;
26
+ this.throttleConfigs = {
27
+ ...DEFAULT_THROTTLE_CONFIGS,
28
+ ...config?.throttle,
29
+ };
30
+ this.reconnectConfig = {
31
+ ...DEFAULT_RECONNECT_CONFIG,
32
+ ...config?.reconnect,
33
+ };
34
+ this.network = config?.network ?? "mainnet";
35
+ }
36
+ getWebSocketTransport() {
37
+ if (!this.wsTransport) {
38
+ this.wsTransport = new WebSocketTransport({
39
+ isTestnet: this.network === "testnet",
40
+ timeout: 30000,
41
+ });
42
+ }
43
+ return this.wsTransport;
44
+ }
45
+ getSubscriptionClient() {
46
+ if (!this.subscriptionClient) {
47
+ this.subscriptionClient = new SubscriptionClient({
48
+ transport: this.getWebSocketTransport(),
49
+ });
50
+ }
51
+ return this.subscriptionClient;
52
+ }
53
+ pause() {
54
+ if (this.isPaused)
55
+ return;
56
+ this.isPaused = true;
57
+ for (const [key, entry] of this.subscriptions.entries()) {
58
+ this.pausedSubscriptions.set(key, {
59
+ type: entry.type,
60
+ params: entry.params,
61
+ });
62
+ if (entry.subscription) {
63
+ try {
64
+ entry.subscription.unsubscribe();
65
+ }
66
+ catch (_) { }
67
+ entry.subscription = null;
68
+ }
69
+ }
70
+ for (const timer of this.throttleTimers.values()) {
71
+ clearTimeout(timer);
72
+ }
73
+ this.throttleTimers.clear();
74
+ this.pendingUpdates.clear();
75
+ }
76
+ async resume() {
77
+ if (!this.isPaused)
78
+ return;
79
+ this.isPaused = false;
80
+ for (const [key, { type }] of this.pausedSubscriptions.entries()) {
81
+ const entry = this.subscriptions.get(key);
82
+ if (entry && entry.listeners.size > 0) {
83
+ await this.startSubscription(type, key, entry);
84
+ }
85
+ }
86
+ this.pausedSubscriptions.clear();
87
+ }
88
+ getSubscriptionKey(type, params) {
89
+ if (!params || Object.keys(params).length === 0) {
90
+ return type;
91
+ }
92
+ return `${type}:${JSON.stringify(params)}`;
93
+ }
94
+ async subscribe(type, listener, params) {
95
+ const key = this.getSubscriptionKey(type, params);
96
+ let entry = this.subscriptions.get(key);
97
+ if (entry) {
98
+ entry.refCount++;
99
+ entry.listeners.add(listener);
100
+ if (entry.lastData !== undefined) {
101
+ try {
102
+ listener(entry.lastData);
103
+ }
104
+ catch (_) { }
105
+ }
106
+ }
107
+ else {
108
+ entry = {
109
+ subscription: null,
110
+ refCount: 1,
111
+ listeners: new Set([listener]),
112
+ lastData: undefined,
113
+ params,
114
+ type,
115
+ };
116
+ this.subscriptions.set(key, entry);
117
+ await this.startSubscription(type, key, entry);
118
+ }
119
+ return () => this.unsubscribe(key, listener);
120
+ }
121
+ async startSubscription(type, key, entry) {
122
+ if (this.isPaused)
123
+ return;
124
+ try {
125
+ const client = this.getSubscriptionClient();
126
+ const throttledHandler = this.createThrottledHandler(type, key);
127
+ let subscription;
128
+ switch (type) {
129
+ case "allMids":
130
+ subscription = await client.allMids(throttledHandler);
131
+ break;
132
+ case "l2Book":
133
+ if (!entry.params?.coin) {
134
+ throw new Error("l2Book requires coin parameter");
135
+ }
136
+ subscription = await client.l2Book({ coin: entry.params.coin }, throttledHandler);
137
+ break;
138
+ case "trades":
139
+ if (!entry.params?.coin) {
140
+ throw new Error("trades requires coin parameter");
141
+ }
142
+ subscription = await client.trades({ coin: entry.params.coin }, throttledHandler);
143
+ break;
144
+ case "activeAssetCtx":
145
+ if (!entry.params?.coin) {
146
+ throw new Error("activeAssetCtx requires coin parameter");
147
+ }
148
+ subscription = await client.activeAssetCtx({ coin: entry.params.coin }, throttledHandler);
149
+ break;
150
+ default:
151
+ throw new Error(`Unknown subscription type: ${type}`);
152
+ }
153
+ const currentEntry = this.subscriptions.get(key);
154
+ if (currentEntry) {
155
+ currentEntry.subscription = subscription;
156
+ }
157
+ this.reconnectAttempts = 0;
158
+ this.notifyConnectionListeners(true);
159
+ }
160
+ catch (error) {
161
+ this.scheduleReconnect(type, key, entry);
162
+ }
163
+ }
164
+ createThrottledHandler(type, key) {
165
+ const config = this.throttleConfigs[type];
166
+ return (data) => {
167
+ const pending = this.pendingUpdates.get(key) || [];
168
+ pending.push(data);
169
+ if (pending.length > config.maxBatchSize) {
170
+ pending.shift();
171
+ }
172
+ this.pendingUpdates.set(key, pending);
173
+ if (!this.throttleTimers.has(key)) {
174
+ const timer = setTimeout(() => {
175
+ this.dispatchUpdates(key);
176
+ this.throttleTimers.delete(key);
177
+ }, config.minInterval);
178
+ this.throttleTimers.set(key, timer);
179
+ }
180
+ };
181
+ }
182
+ dispatchUpdates(key) {
183
+ const entry = this.subscriptions.get(key);
184
+ const pending = this.pendingUpdates.get(key);
185
+ if (!entry || !pending || pending.length === 0)
186
+ return;
187
+ const latestData = pending[pending.length - 1];
188
+ entry.lastData = latestData;
189
+ this.pendingUpdates.set(key, []);
190
+ entry.listeners.forEach((listener) => {
191
+ try {
192
+ listener(latestData);
193
+ }
194
+ catch (_) { }
195
+ });
196
+ }
197
+ unsubscribe(key, listener) {
198
+ const entry = this.subscriptions.get(key);
199
+ if (!entry)
200
+ return;
201
+ entry.listeners.delete(listener);
202
+ entry.refCount--;
203
+ if (entry.refCount <= 0) {
204
+ this.cleanupSubscription(key);
205
+ }
206
+ }
207
+ cleanupSubscription(key) {
208
+ const entry = this.subscriptions.get(key);
209
+ if (!entry)
210
+ return;
211
+ if (entry.subscription) {
212
+ try {
213
+ entry.subscription.unsubscribe();
214
+ }
215
+ catch (_) { }
216
+ }
217
+ const timer = this.throttleTimers.get(key);
218
+ if (timer) {
219
+ clearTimeout(timer);
220
+ this.throttleTimers.delete(key);
221
+ }
222
+ this.subscriptions.delete(key);
223
+ this.pendingUpdates.delete(key);
224
+ }
225
+ scheduleReconnect(type, key, entry) {
226
+ if (this.reconnectAttempts >= this.reconnectConfig.maxAttempts) {
227
+ this.notifyConnectionListeners(false);
228
+ return;
229
+ }
230
+ const delay = Math.min(this.reconnectConfig.initialDelay *
231
+ Math.pow(this.reconnectConfig.multiplier, this.reconnectAttempts), this.reconnectConfig.maxDelay);
232
+ this.reconnectAttempts++;
233
+ this.reconnectTimer = setTimeout(() => {
234
+ this.startSubscription(type, key, entry);
235
+ }, delay);
236
+ }
237
+ onConnectionChange(listener) {
238
+ this.connectionListeners.add(listener);
239
+ return () => this.connectionListeners.delete(listener);
240
+ }
241
+ notifyConnectionListeners(connected) {
242
+ this.connectionListeners.forEach((listener) => {
243
+ try {
244
+ listener(connected);
245
+ }
246
+ catch (_) { }
247
+ });
248
+ }
249
+ cleanup() {
250
+ if (this.reconnectTimer) {
251
+ clearTimeout(this.reconnectTimer);
252
+ this.reconnectTimer = null;
253
+ }
254
+ for (const key of this.subscriptions.keys()) {
255
+ this.cleanupSubscription(key);
256
+ }
257
+ this.subscriptions.clear();
258
+ this.throttleTimers.clear();
259
+ this.pendingUpdates.clear();
260
+ this.connectionListeners.clear();
261
+ this.pausedSubscriptions.clear();
262
+ this.wsTransport = null;
263
+ this.subscriptionClient = null;
264
+ this.reconnectAttempts = 0;
265
+ this.isPaused = false;
266
+ }
267
+ getStats() {
268
+ let listeners = 0;
269
+ this.subscriptions.forEach((entry) => {
270
+ listeners += entry.listeners.size;
271
+ });
272
+ return {
273
+ subscriptions: this.subscriptions.size,
274
+ listeners,
275
+ isPaused: this.isPaused,
276
+ };
277
+ }
278
+ }
279
+ let defaultManager = null;
280
+ export function getWebSocketManager(config) {
281
+ if (!defaultManager) {
282
+ defaultManager = new WebSocketManager(config);
283
+ }
284
+ return defaultManager;
285
+ }
286
+ export function resetWebSocketManager() {
287
+ if (defaultManager) {
288
+ defaultManager.cleanup();
289
+ defaultManager = null;
290
+ }
291
+ }
292
+ export function createWebSocketManager(config) {
293
+ return new WebSocketManager(config);
294
+ }
295
+ //# sourceMappingURL=WebSocketManager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"WebSocketManager.js","sourceRoot":"","sources":["../../src/websocket/WebSocketManager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ export * from "./types";
2
+ export { WebSocketManager, getWebSocketManager, resetWebSocketManager, createWebSocketManager, } from "./WebSocketManager";
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/websocket/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}
@@ -0,0 +1,3 @@
1
+ export * from "./types";
2
+ export { WebSocketManager, getWebSocketManager, resetWebSocketManager, createWebSocketManager, } from "./WebSocketManager";
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/websocket/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}
@@ -0,0 +1,98 @@
1
+ import type { WebSocketSubscription } from "@nktkas/hyperliquid";
2
+ import type { HyperliquidNetwork } from "../types";
3
+ export type { HyperliquidNetwork };
4
+ export type SubscriptionType = "allMids" | "l2Book" | "trades" | "activeAssetCtx";
5
+ export interface SubscriptionParams {
6
+ coin?: string;
7
+ [key: string]: unknown;
8
+ }
9
+ export interface SubscriptionEntry {
10
+ subscription: WebSocketSubscription | null;
11
+ refCount: number;
12
+ listeners: Set<(data: unknown) => void>;
13
+ lastData: unknown;
14
+ params?: SubscriptionParams;
15
+ type: SubscriptionType;
16
+ }
17
+ export interface ThrottleConfig {
18
+ minInterval: number;
19
+ maxBatchSize: number;
20
+ }
21
+ export interface ReconnectConfig {
22
+ initialDelay: number;
23
+ maxDelay: number;
24
+ multiplier: number;
25
+ maxAttempts: number;
26
+ }
27
+ export interface WebSocketManagerConfig {
28
+ throttle?: Partial<Record<SubscriptionType, ThrottleConfig>>;
29
+ reconnect?: Partial<ReconnectConfig>;
30
+ network?: "mainnet" | "testnet";
31
+ }
32
+ export interface LifecycleCallbacks {
33
+ onPause?: () => void;
34
+ onResume?: () => void;
35
+ onConnectionChange?: (connected: boolean) => void;
36
+ }
37
+ export interface L2BookLevel {
38
+ px: string;
39
+ sz: string;
40
+ n: number;
41
+ }
42
+ export interface L2BookEvent {
43
+ coin: string;
44
+ time: number;
45
+ levels: [L2BookLevel[], L2BookLevel[]];
46
+ }
47
+ export interface TradeEvent {
48
+ coin: string;
49
+ side: string;
50
+ px: string;
51
+ sz: string;
52
+ time: number;
53
+ hash: string;
54
+ tid: number;
55
+ }
56
+ export interface AllMidsEvent {
57
+ mids: Record<string, string>;
58
+ }
59
+ export interface ActiveAssetCtxEvent {
60
+ coin: string;
61
+ ctx: {
62
+ funding: string;
63
+ openInterest: string;
64
+ prevDayPx: string;
65
+ dayNtlVlm: string;
66
+ premium: string;
67
+ oraclePx: string;
68
+ markPx: string;
69
+ midPx: string;
70
+ impactPxs: [string, string];
71
+ };
72
+ }
73
+ export interface OrderbookData {
74
+ bids: OrderbookLevel[];
75
+ asks: OrderbookLevel[];
76
+ spread: number | null;
77
+ spreadPercent: number | null;
78
+ midPrice: number | null;
79
+ lastUpdate: number;
80
+ }
81
+ export interface OrderbookLevel {
82
+ price: number;
83
+ size: number;
84
+ total: number;
85
+ }
86
+ export interface TradeData {
87
+ price: number;
88
+ size: number;
89
+ side: string;
90
+ time: number;
91
+ hash: string;
92
+ }
93
+ export interface PriceData {
94
+ coin: string;
95
+ price: number;
96
+ lastUpdate: number;
97
+ }
98
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/websocket/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/websocket/types.ts"],"names":[],"mappings":""}
package/package.json ADDED
@@ -0,0 +1,28 @@
1
+ {
2
+ "name": "@tria-sdk/hyperliquid-core",
3
+ "version": "0.1.0",
4
+ "description": "Platform-agnostic Hyperliquid API client and types for web and React Native",
5
+ "main": "./dist/index.js",
6
+ "module": "./dist/index.js",
7
+ "types": "./dist/index.d.ts",
8
+ "sideEffects": false,
9
+ "scripts": {
10
+ "build": "rimraf dist && tsc --project tsconfig.json",
11
+ "dev": "tsc --watch --project tsconfig.json",
12
+ "publish": "npm run build && npm publish"
13
+ },
14
+ "dependencies": {
15
+ "zod": "^3.24.2",
16
+ "@nktkas/hyperliquid": "^0.29.1"
17
+ },
18
+ "devDependencies": {
19
+ "rimraf": "^5.0.7",
20
+ "typescript": "^5.3.3"
21
+ },
22
+ "files": [
23
+ "dist"
24
+ ],
25
+ "publishConfig": {
26
+ "access": "public"
27
+ }
28
+ }