@yuants/vendor-hyperliquid 0.5.2 → 0.6.0

package/dist/api/client.js

@@ -30,7 +30,7 @@ const callApi = async (method, path, params) => {
         return JSON.parse(retStr);
     }
     catch (err) {
-        console.error(formatTime(Date.now()), 'HyperliquidRequestFailed', path, JSON.stringify(params), retStr);
+        console.error(formatTime(Date.now()), 'HyperliquidRequestFailed', path, JSON.stringify(params), retStr, err);
         throw err;
     }
 };

package/dist/api/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { UUID, formatTime } from '@yuants/utils';\nimport { Subject, filter, firstValueFrom, mergeMap, of, shareReplay, throwError, timeout, timer } from 'rxjs';\n\ntype HttpMethod = 'GET' | 'POST';\n\nconst BASE_URL = 'https://api.hyperliquid.xyz';\n\nconst buildUrl = (path: string, method: HttpMethod, params?: any) => {\n  const url = new URL(BASE_URL);\n  url.pathname = path;\n  if (method === 'GET' && params) {\n    const entries = Object.entries(params).sort(([a], [b]) => a.localeCompare(b));\n    for (const [key, value] of entries) {\n      url.searchParams.set(key, '' + value);\n    }\n  }\n  return url;\n};\n\nconst callApi = async (method: HttpMethod, path: string, params?: any) => {\n  const url = buildUrl(path, method, params);\n  const body = method === 'GET' ? '' : JSON.stringify(params ?? {});\n  const headers: Record<string, string> = { 'Content-Type': 'application/json' };\n  console.info(formatTime(Date.now()), method, url.href, body);\n  const res = await fetch(url.href, {\n    method,\n    headers,\n    body: method === 'GET' ? undefined : body || undefined,\n  });\n  const retStr = await res.text();\n  try {\n    if (process.env.LOG_LEVEL === 'DEBUG') {\n      console.debug(formatTime(Date.now()), 'HyperliquidResponse', path, JSON.stringify(params), retStr);\n    }\n    return JSON.parse(retStr);\n  } catch (err) {\n    console.error(formatTime(Date.now()), 'HyperliquidRequestFailed', path, JSON.stringify(params), retStr);\n    throw err;\n  }\n};\n\ntype FlowController = {\n  requestQueue: Array<{ trace_id: string; method: HttpMethod; path: string; params?: any }>;\n  responseChannel: Subject<{ trace_id: string; response?: any; error?: Error }>;\n};\n\nconst controllers = new Map<string, FlowController>();\n\nconst ensureController = (path: string, period: number, limit: number) => {\n  if (controllers.has(path)) {\n    return controllers.get(path)!;\n  }\n  const controller: FlowController = {\n    requestQueue: [],\n    responseChannel: new Subject(),\n  };\n  timer(0, period)\n    .pipe(\n      filter(() => controller.requestQueue.length > 0),\n      mergeMap(() => controller.requestQueue.splice(0, limit)),\n      mergeMap(async (request) => {\n        try {\n          const response = await callApi(request.method, request.path, request.params);\n          return { trace_id: request.trace_id, response };\n        } catch (error) {\n          return { trace_id: request.trace_id, error: error as Error };\n        }\n      }),\n    )\n    .subscribe(controller.responseChannel);\n  controllers.set(path, controller);\n  return controller;\n};\n\nexport const request = <T = any>(method: HttpMethod, path: string, params?: any) =>\n  callApi(method, path, params) as Promise<T>;\n\nexport const requestWithFlowControl = async <T = any>(\n  method: HttpMethod,\n  path: string,\n  flowControl: { period: number; limit: number },\n  params?: any,\n) => {\n  const controller = ensureController(path, flowControl.period, flowControl.limit);\n  const trace_id = UUID();\n  const res$ = controller.responseChannel.pipe(\n    filter((resp) => resp.trace_id === trace_id),\n    mergeMap((resp) => (resp.error ? throwError(() => resp.error) : of(resp))),\n    timeout(30_000),\n    shareReplay(1),\n  );\n  controller.requestQueue.push({ trace_id, method, path, params });\n  return ((await firstValueFrom(res$)).response ?? null) as T;\n};\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAI9G,MAAM,QAAQ,GAAG,6BAA6B,CAAC;AAE/C,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,MAAkB,EAAE,MAAY,EAAE,EAAE;IAClE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC;IACpB,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,EAAE;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE;YAClC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC;SACvC;KACF;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,KAAK,EAAE,MAAkB,EAAE,IAAY,EAAE,MAAY,EAAE,EAAE;IACvE,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,CAAC;IAClE,MAAM,OAAO,GAA2B,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;IAC/E,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;QAChC,MAAM;QACN,OAAO;QACP,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,SAAS;KACvD,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI;QACF,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,OAAO,EAAE;YACrC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,qBAAqB,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;SACpG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;KAC3B;IAAC,OAAO,GAAG,EAAE;QACZ,OAAO,CAAC,KAAK,CACX,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EACtB,0BAA0B,EAC1B,IAAI,EACJ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EACtB,MAAM,EACN,GAAG,CACJ,CAAC;QACF,MAAM,GAAG,CAAC;KACX;AACH,CAAC,CAAC;AAOF,MAAM,WAAW,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEtD,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,MAAc,EAAE,KAAa,EAAE,EAAE;IACvE,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACzB,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;KAC/B;IACD,MAAM,UAAU,GAAmB;QACjC,YAAY,EAAE,EAAE;QAChB,eAAe,EAAE,IAAI,OAAO,EAAE;KAC/B,CAAC;IACF,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC;SACb,IAAI,CACH,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,EAChD,QAAQ,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EACxD,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACzB,IAAI;YACF,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7E,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC;SACjD;QAAC,OAAO,KAAK,EAAE;YACd,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;SAC9D;IACH,CAAC,CAAC,CACH;SACA,SAAS,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IACzC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAClC,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAU,MAAkB,EAAE,IAAY,EAAE,MAAY,EAAE,EAAE,CACjF,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAe,CAAC;AAE9C,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EACzC,MAAkB,EAClB,IAAY,EACZ,WAA8C,EAC9C,MAAY,EACZ,EAAE;;IACF,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,IAAI,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,UAAU,CAAC,eAAe,CAAC,IAAI,CAC1C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,EAC5C,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAC1E,OAAO,CAAC,KAAM,CAAC,EACf,WAAW,CAAC,CAAC,CAAC,CACf,CAAC;IACF,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACjE,OAAO,CAAC,MAAA,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,mCAAI,IAAI,CAAM,CAAC;AAC9D,CAAC,CAAC","sourcesContent":["import { UUID, formatTime } from '@yuants/utils';\nimport { Subject, filter, firstValueFrom, mergeMap, of, shareReplay, throwError, timeout, timer } from 'rxjs';\n\ntype HttpMethod = 'GET' | 'POST';\n\nconst BASE_URL = 'https://api.hyperliquid.xyz';\n\nconst buildUrl = (path: string, method: HttpMethod, params?: any) => {\n  const url = new URL(BASE_URL);\n  url.pathname = path;\n  if (method === 'GET' && params) {\n    const entries = Object.entries(params).sort(([a], [b]) => a.localeCompare(b));\n    for (const [key, value] of entries) {\n      url.searchParams.set(key, '' + value);\n    }\n  }\n  return url;\n};\n\nconst callApi = async (method: HttpMethod, path: string, params?: any) => {\n  const url = buildUrl(path, method, params);\n  const body = method === 'GET' ? '' : JSON.stringify(params ?? {});\n  const headers: Record<string, string> = { 'Content-Type': 'application/json' };\n  console.info(formatTime(Date.now()), method, url.href, body);\n  const res = await fetch(url.href, {\n    method,\n    headers,\n    body: method === 'GET' ? undefined : body || undefined,\n  });\n  const retStr = await res.text();\n  try {\n    if (process.env.LOG_LEVEL === 'DEBUG') {\n      console.debug(formatTime(Date.now()), 'HyperliquidResponse', path, JSON.stringify(params), retStr);\n    }\n    return JSON.parse(retStr);\n  } catch (err) {\n    console.error(\n      formatTime(Date.now()),\n      'HyperliquidRequestFailed',\n      path,\n      JSON.stringify(params),\n      retStr,\n      err,\n    );\n    throw err;\n  }\n};\n\ntype FlowController = {\n  requestQueue: Array<{ trace_id: string; method: HttpMethod; path: string; params?: any }>;\n  responseChannel: Subject<{ trace_id: string; response?: any; error?: Error }>;\n};\n\nconst controllers = new Map<string, FlowController>();\n\nconst ensureController = (path: string, period: number, limit: number) => {\n  if (controllers.has(path)) {\n    return controllers.get(path)!;\n  }\n  const controller: FlowController = {\n    requestQueue: [],\n    responseChannel: new Subject(),\n  };\n  timer(0, period)\n    .pipe(\n      filter(() => controller.requestQueue.length > 0),\n      mergeMap(() => controller.requestQueue.splice(0, limit)),\n      mergeMap(async (request) => {\n        try {\n          const response = await callApi(request.method, request.path, request.params);\n          return { trace_id: request.trace_id, response };\n        } catch (error) {\n          return { trace_id: request.trace_id, error: error as Error };\n        }\n      }),\n    )\n    .subscribe(controller.responseChannel);\n  controllers.set(path, controller);\n  return controller;\n};\n\nexport const request = <T = any>(method: HttpMethod, path: string, params?: any) =>\n  callApi(method, path, params) as Promise<T>;\n\nexport const requestWithFlowControl = async <T = any>(\n  method: HttpMethod,\n  path: string,\n  flowControl: { period: number; limit: number },\n  params?: any,\n) => {\n  const controller = ensureController(path, flowControl.period, flowControl.limit);\n  const trace_id = UUID();\n  const res$ = controller.responseChannel.pipe(\n    filter((resp) => resp.trace_id === trace_id),\n    mergeMap((resp) => (resp.error ? throwError(() => resp.error) : of(resp))),\n    timeout(30_000),\n    shareReplay(1),\n  );\n  controller.requestQueue.push({ trace_id, method, path, params });\n  return ((await firstValueFrom(res$)).response ?? null) as T;\n};\n"]}

package/dist/api/private-api.js

@@ -8,6 +8,14 @@ const getWallet = (credential) => {
     }
     return walletCache.get(credential.private_key);
 };
+/**
+ * Place orders on Hyperliquid exchange
+ * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-an-order
+ * API Endpoint: POST /exchange
+ * @param credential - User credential containing private key for signing
+ * @param params - Order placement parameters
+ * @returns Promise resolving to exchange response
+ */
 export const placeOrder = async (credential, params) => {
     var _a, _b;
     const action = {
@@ -22,6 +30,14 @@ export const placeOrder = async (credential, params) => {
     const signature = await signL1Action(getWallet(credential), action, (_a = params.vaultAddress) !== null && _a !== void 0 ? _a : null, nonce, (_b = params.expiresAfter) !== null && _b !== void 0 ? _b : null, true);
     return request('POST', 'exchange', { action, nonce, signature });
 };
+/**
+ * Cancel orders on Hyperliquid exchange
+ * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s
+ * API Endpoint: POST /exchange
+ * @param credential - User credential containing private key for signing
+ * @param params - Order cancellation parameters
+ * @returns Promise resolving to exchange response
+ */
 export const cancelOrder = async (credential, params) => {
     var _a, _b;
     const action = {
@@ -32,4 +48,44 @@ export const cancelOrder = async (credential, params) => {
     const signature = await signL1Action(getWallet(credential), action, (_a = params.vaultAddress) !== null && _a !== void 0 ? _a : null, nonce, (_b = params.expiresAfter) !== null && _b !== void 0 ? _b : null, true);
     return request('POST', 'exchange', { action, nonce, signature });
 };
+/**
+ * Modify an existing order on Hyperliquid exchange
+ * API Endpoint: POST /exchange
+ * @param credential - User credential containing private key for signing
+ * @param params - Order modification parameters
+ * @returns Promise resolving to exchange response
+ */
+export const modifyOrder = async (credential, params) => {
+    var _a, _b;
+    const action = {
+        type: 'modify',
+        oid: params.oid,
+        order: params.order,
+    };
+    const nonce = Date.now();
+    const signature = await signL1Action(getWallet(credential), action, (_a = params.vaultAddress) !== null && _a !== void 0 ? _a : null, nonce, (_b = params.expiresAfter) !== null && _b !== void 0 ? _b : null, true);
+    return request('POST', 'exchange', { action, nonce, signature });
+};
+/**
+ * Get user's fill history (trade history) from Hyperliquid
+ * API Endpoint: POST /info (type: userFills)
+ * @param credential - User credential containing private key for authentication
+ * @param params - Optional time range parameters
+ * @returns Promise resolving to user fill history with detailed trade information
+ */
+export const getUserFills = async (credential, params) => {
+    const wallet = getWallet(credential);
+    const address = wallet.address;
+    const requestBody = {
+        type: 'userFills',
+        user: address,
+    };
+    if (params === null || params === void 0 ? void 0 : params.startTime) {
+        requestBody.startTime = params.startTime;
+    }
+    if (params === null || params === void 0 ? void 0 : params.endTime) {
+        requestBody.endTime = params.endTime;
+    }
+    return request('POST', 'info', requestBody);
+};
 //# sourceMappingURL=private-api.js.map

package/dist/api/private-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"private-api.js","sourceRoot":"","sources":["../../src/api/private-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAyBnC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE9C,MAAM,SAAS,GAAG,CAAC,UAAuB,EAAE,EAAE;IAC5C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE;QAC5C,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;KAC7E;IACD,OAAO,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAE,CAAC;AAClD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC7B,UAAuB,EACvB,MAKC,EACD,EAAE;;IACF,MAAM,MAAM,GAAwB;QAClC,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,IAAI;KACf,CAAC;IACF,IAAI,MAAM,CAAC,OAAO,EAAE;QAClB,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;KACpC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,SAAS,GAAG,MAAM,YAAY,CAClC,SAAS,CAAC,UAAU,CAAC,EACrB,MAAM,EACN,MAAA,MAAM,CAAC,YAAY,mCAAI,IAAI,EAC3B,KAAK,EACL,MAAA,MAAM,CAAC,YAAY,mCAAI,IAAI,EAC3B,IAAI,CACL,CAAC;IACF,OAAO,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAC9B,UAAuB,EACvB,MAAkF,EAClF,EAAE;;IACF,MAAM,MAAM,GAAwB;QAClC,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,SAAS,GAAG,MAAM,YAAY,CAClC,SAAS,CAAC,UAAU,CAAC,EACrB,MAAM,EACN,MAAA,MAAM,CAAC,YAAY,mCAAI,IAAI,EAC3B,KAAK,EACL,MAAA,MAAM,CAAC,YAAY,mCAAI,IAAI,EAC3B,IAAI,CACL,CAAC;IACF,OAAO,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AACnE,CAAC,CAAC","sourcesContent":["import { Wallet } from 'ethers';\nimport { signL1Action } from '../sign';\nimport { request } from './client';\nimport { ICredential } from './types';\n\ntype OrderPayload = {\n  a: number;\n  b: boolean;\n  p: string;\n  s: string;\n  r: boolean;\n  t: {\n    limit?: { tif: string };\n    trigger?: {\n      isMarket: boolean;\n      triggerPx: string;\n      tpsl: string;\n    };\n  };\n  c?: number;\n};\n\ntype CancelPayload = {\n  a: number;\n  o: number;\n};\n\nconst walletCache = new Map<string, Wallet>();\n\nconst getWallet = (credential: ICredential) => {\n  if (!walletCache.has(credential.private_key)) {\n    walletCache.set(credential.private_key, new Wallet(credential.private_key));\n  }\n  return walletCache.get(credential.private_key)!;\n};\n\nexport const placeOrder = async (\n  credential: ICredential,\n  params: {\n    orders: OrderPayload[];\n    builder?: { b: string; f: number };\n    vaultAddress?: string;\n    expiresAfter?: number;\n  },\n) => {\n  const action: Record<string, any> = {\n    type: 'order',\n    orders: params.orders,\n    grouping: 'na',\n  };\n  if (params.builder) {\n    action['builder'] = params.builder;\n  }\n  const nonce = Date.now();\n  const signature = await signL1Action(\n    getWallet(credential),\n    action,\n    params.vaultAddress ?? null,\n    nonce,\n    params.expiresAfter ?? null,\n    true,\n  );\n  return request('POST', 'exchange', { action, nonce, signature });\n};\n\nexport const cancelOrder = async (\n  credential: ICredential,\n  params: { cancels: CancelPayload[]; vaultAddress?: string; expiresAfter?: number },\n) => {\n  const action: Record<string, any> = {\n    type: 'cancel',\n    cancels: params.cancels,\n  };\n  const nonce = Date.now();\n  const signature = await signL1Action(\n    getWallet(credential),\n    action,\n    params.vaultAddress ?? null,\n    nonce,\n    params.expiresAfter ?? null,\n    true,\n  );\n  return request('POST', 'exchange', { action, nonce, signature });\n};\n"]}
+{"version":3,"file":"private-api.js","sourceRoot":"","sources":["../../src/api/private-api.ts"],"names":[],"mappings":"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","sourcesContent":["import { Wallet } from 'ethers';\nimport { signL1Action } from '../sign';\nimport { request } from './client';\nimport { ICredential } from './types';\n\n/**\n * Order payload for placing orders on Hyperliquid\n */\ntype OrderPayload = {\n  /** Asset index (absolute) */\n  a: number;\n  /** Buy flag (true for buy, false for sell) */\n  b: boolean;\n  /** Limit price string */\n  p: string;\n  /** Size string */\n  s: string;\n  /** Reduce only flag */\n  r: boolean;\n  /** Order type configuration */\n  t: {\n    /** Time in force for limit orders: \"Alo\" (Post-Only), \"Ioc\" (Immediate or Cancel), \"Gtc\" (Good til Cancel) */\n    limit?: { tif: string };\n    /** Trigger order configuration */\n    trigger?: {\n      /** Is market trigger price */\n      isMarket: boolean;\n      /** Trigger price string */\n      triggerPx: string;\n      /** Take profit/stop loss indicator */\n      tpsl: string;\n    };\n  };\n  /** Order fee coefficient */\n  c?: number;\n};\n\n/**\n * Cancel order payload\n */\ntype CancelPayload = {\n  /** Asset index (absolute) */\n  a: number;\n  /** Order ID */\n  o: number;\n};\n\n/**\n * Modify order payload\n */\ntype ModifyOrderPayload = {\n  /** Order ID to modify */\n  oid: number | string;\n  /** New order parameters */\n  order: OrderPayload;\n};\n\nconst walletCache = new Map<string, Wallet>();\n\nconst getWallet = (credential: ICredential) => {\n  if (!walletCache.has(credential.private_key)) {\n    walletCache.set(credential.private_key, new Wallet(credential.private_key));\n  }\n  return walletCache.get(credential.private_key)!;\n};\n\n/**\n * Place orders on Hyperliquid exchange\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-an-order\n * API Endpoint: POST /exchange\n * @param credential - User credential containing private key for signing\n * @param params - Order placement parameters\n * @returns Promise resolving to exchange response\n */\nexport const placeOrder = async (\n  credential: ICredential,\n  params: {\n    orders: OrderPayload[];\n    builder?: { b: string; f: number };\n    vaultAddress?: string;\n    expiresAfter?: number;\n  },\n) => {\n  const action: Record<string, any> = {\n    type: 'order',\n    orders: params.orders,\n    grouping: 'na',\n  };\n  if (params.builder) {\n    action['builder'] = params.builder;\n  }\n  const nonce = Date.now();\n  const signature = await signL1Action(\n    getWallet(credential),\n    action,\n    params.vaultAddress ?? null,\n    nonce,\n    params.expiresAfter ?? null,\n    true,\n  );\n  return request('POST', 'exchange', { action, nonce, signature });\n};\n\n/**\n * Cancel orders on Hyperliquid exchange\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s\n * API Endpoint: POST /exchange\n * @param credential - User credential containing private key for signing\n * @param params - Order cancellation parameters\n * @returns Promise resolving to exchange response\n */\nexport const cancelOrder = async (\n  credential: ICredential,\n  params: { cancels: CancelPayload[]; vaultAddress?: string; expiresAfter?: number },\n) => {\n  const action: Record<string, any> = {\n    type: 'cancel',\n    cancels: params.cancels,\n  };\n  const nonce = Date.now();\n  const signature = await signL1Action(\n    getWallet(credential),\n    action,\n    params.vaultAddress ?? null,\n    nonce,\n    params.expiresAfter ?? null,\n    true,\n  );\n  return request('POST', 'exchange', { action, nonce, signature });\n};\n\n/**\n * Modify an existing order on Hyperliquid exchange\n * API Endpoint: POST /exchange\n * @param credential - User credential containing private key for signing\n * @param params - Order modification parameters\n * @returns Promise resolving to exchange response\n */\nexport const modifyOrder = async (\n  credential: ICredential,\n  params: {\n    oid: number | string;\n    order: OrderPayload;\n    vaultAddress?: string;\n    expiresAfter?: number;\n  },\n) => {\n  const action: Record<string, any> = {\n    type: 'modify',\n    oid: params.oid,\n    order: params.order,\n  };\n  const nonce = Date.now();\n  const signature = await signL1Action(\n    getWallet(credential),\n    action,\n    params.vaultAddress ?? null,\n    nonce,\n    params.expiresAfter ?? null,\n    true,\n  );\n  return request('POST', 'exchange', { action, nonce, signature });\n};\n\n/**\n * Get user's fill history (trade history) from Hyperliquid\n * API Endpoint: POST /info (type: userFills)\n * @param credential - User credential containing private key for authentication\n * @param params - Optional time range parameters\n * @returns Promise resolving to user fill history with detailed trade information\n */\nexport const getUserFills = async (\n  credential: ICredential,\n  params?: { startTime?: number; endTime?: number },\n) => {\n  const wallet = getWallet(credential);\n  const address = wallet.address;\n\n  const requestBody: any = {\n    type: 'userFills',\n    user: address,\n  };\n\n  if (params?.startTime) {\n    requestBody.startTime = params.startTime;\n  }\n\n  if (params?.endTime) {\n    requestBody.endTime = params.endTime;\n  }\n\n  return request<{\n    fills: {\n      time: number;\n      feedId: string;\n      hash: string;\n      coin: string;\n      side: string;\n      px: string;\n      sz: string;\n      oid: number;\n      startPos: string;\n      fee: string;\n      feeToken: string;\n      closedSize: string;\n      closedPnl: string;\n      dir: string;\n      source: string;\n      type: string;\n      positionAction: string;\n      asset: number;\n      tid: string;\n      crossChain: any;\n    }[];\n  }>('POST', 'info', requestBody);\n};\n"]}

package/dist/api/public-api.js

@@ -1,12 +1,94 @@
 import { request } from './client';
+/**
+ * Get user's perpetual account summary including positions, margin, and portfolio information
+ * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-perpetuals-account-summary
+ * API Endpoint: POST /info (type: clearinghouseState)
+ * @param params - Query parameters
+ * @param params.user - User's wallet address
+ * @returns Promise resolving to account summary with margin information, positions, and portfolio details
+ */
 export const getUserPerpetualsAccountSummary = (params) => request('POST', 'info', Object.assign(Object.assign({}, params), { type: 'clearinghouseState' }));
+/**
+ * Get perpetual market metadata including available assets, their specifications, and margin tiers
+ * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-metadata
+ * API Endpoint: POST /info (type: meta)
+ * @param params - Optional query parameters
+ * @param params.dex - Optional DEX identifier
+ * @returns Promise resolving to universe of perpetual assets and margin configuration
+ */
 export const getPerpetualsMetaData = (params) => request('POST', 'info', Object.assign(Object.assign({}, (params !== null && params !== void 0 ? params : {})), { type: 'meta' }));
+/**
+ * Get spot market metadata including available tokens and trading pairs
+ * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-metadata
+ * API Endpoint: POST /info (type: spotMeta)
+ * @returns Promise resolving to spot universe with token information and pair configurations
+ */
 export const getSpotMetaData = () => request('POST', 'info', { type: 'spotMeta' });
+/**
+ * Get user's funding rate payment history for perpetual positions
+ * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-a-users-funding-history-or-non-funding-ledger-updates
+ * API Endpoint: POST /info (type: fundingHistory)
+ * @param params - Query parameters
+ * @param params.user - User's wallet address
+ * @param params.startTime - Optional start timestamp in milliseconds
+ * @param params.endTime - Optional end timestamp in milliseconds
+ * @returns Promise resolving to array of funding payment records with amounts and rates
+ */
 export const getUserFundingHistory = (params) => request('POST', 'info', Object.assign(Object.assign({}, params), { type: 'fundingHistory' }));
-export const getUserTokenBalances = (params) => request('POST', 'info', Object.assign(Object.assign({}, params), { type: 'tokenBalances' }));
+/**
+ * Get user's token balances for both spot and perpetual accounts
+ * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-a-users-token-balances
+ * API Endpoint: POST /info (type: tokenBalances)
+ * @param params - Query parameters
+ * @param params.user - User's wallet address
+ * @returns Promise resolving to array of token balances with held and total amounts
+ */
+export const getUserTokenBalances = (params) => request('POST', 'info', Object.assign(Object.assign({}, params), { type: 'spotClearinghouseState' }));
+/**
+ * Get user's currently open orders across all markets
+ * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#open-orders
+ * API Endpoint: POST /info (type: openOrders)
+ * @param params - Query parameters
+ * @param params.user - User's wallet address
+ * @returns Promise resolving to array of open order details with prices, sizes, and timestamps
+ */
 export const getUserOpenOrders = (params) => request('POST', 'info', Object.assign(Object.assign({}, params), { type: 'openOrders' }));
+/**
+ * Get historical funding rates for a specific perpetual asset
+ * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-historical-funding-rates
+ * API Endpoint: POST /info (type: fundingHistory)
+ * @param params - Query parameters
+ * @param params.coin - Asset symbol (e.g., "BTC", "ETH")
+ * @param params.startTime - Start timestamp in milliseconds
+ * @param params.endTime - Optional end timestamp in milliseconds
+ * @returns Promise resolving to array of historical funding rate records
+ */
 export const getHistoricalFundingRates = (params) => request('POST', 'info', Object.assign(Object.assign({}, params), { type: 'fundingHistory' }));
+/**
+ * Get current mid prices for all tradable assets
+ * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-mids-for-all-coins
+ * API Endpoint: POST /info (type: allMids)
+ * @returns Promise resolving to record of asset symbols mapped to their mid prices
+ */
 export const getAllMids = () => request('POST', 'info', { type: 'allMids' });
+/**
+ * Get metadata and asset contexts (prices, funding, OI) for all perpetuals
+ * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-asset-contexts-includes-mark-price-current-funding-open-interest-etc.
+ * API Endpoint: POST /info (type: metaAndAssetCtxs)
+ * @returns Promise resolving to metadata and current asset contexts
+ */
 export const getMetaAndAssetCtxs = () => request('POST', 'info', { type: 'metaAndAssetCtxs' });
+/**
+ * Get candle/K-line data for a specific asset and time range
+ * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#candle-snapshot
+ * API Endpoint: POST /info (type: candleSnapshot)
+ * @param params - Query parameters
+ * @param params.req - Request object with candle parameters
+ * @param params.req.coin - Asset symbol
+ * @param params.req.interval - Time interval (e.g., "1m", "5m", "1h", "1d")
+ * @param params.req.startTime - Start timestamp in milliseconds
+ * @param params.req.endTime - End timestamp in milliseconds
+ * @returns Promise resolving to candle data with OHLCV information
+ */
 export const getCandleSnapshot = (params) => request('POST', 'info', Object.assign({ type: 'candleSnapshot' }, params));
 //# sourceMappingURL=public-api.js.map

package/dist/api/public-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../../src/api/public-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,MAAwB,EAAE,EAAE,CAC1E,OAAO,CAoCJ,MAAM,EAAE,MAAM,kCAAO,MAAM,KAAE,IAAI,EAAE,oBAAoB,IAAG,CAAC;AAEhE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAyB,EAAE,EAAE,CACjE,OAAO,CAkBJ,MAAM,EAAE,MAAM,kCAAO,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,KAAE,IAAI,EAAE,MAAM,IAAG,CAAC;AAE1D,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE,CAClC,OAAO,CAiBJ,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAA8D,EAAE,EAAE,CACtG,OAAO,CAML,MAAM,EAAE,MAAM,kCAAO,MAAM,KAAE,IAAI,EAAE,gBAAgB,IAAG,CAAC;AAE3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAwB,EAAE,EAAE,CAC/D,OAAO,CACL,MAAM,EACN,MAAM,kCAED,MAAM,KACT,IAAI,EAAE,eAAe,IAExB,CAAC;AAEJ,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAwB,EAAE,EAAE,CAC5D,OAAO,CACL,MAAM,EACN,MAAM,kCAED,MAAM,KACT,IAAI,EAAE,YAAY,IAErB,CAAC;AAEJ,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,MAA6D,EAAE,EAAE,CACzG,OAAO,CAAyE,MAAM,EAAE,MAAM,kCACzF,MAAM,KACT,IAAI,EAAE,gBAAgB,IACtB,CAAC;AAEL,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,OAAO,CAAyB,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AAErG,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,EAAE,CACtC,OAAO,CAuBL,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAElD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAEjC,EAAE,EAAE,CACH,OAAO,CAaL,MAAM,EAAE,MAAM,kBAAI,IAAI,EAAE,gBAAgB,IAAK,MAAM,EAAG,CAAC","sourcesContent":["import { request } from './client';\n\nexport const getUserPerpetualsAccountSummary = (params: { user: string }) =>\n  request<{\n    marginSummary: {\n      accountValue: string;\n      totalNtlPos: string;\n      totalRawUsd: string;\n      totalMarginUsed: string;\n    };\n    crossMarginSummary: {\n      accountValue: string;\n      totalNtlPos: string;\n      totalRawUsd: string;\n      totalMarginUsed: string;\n    };\n    crossMaintenanceMarginUsed: string;\n    withdrawable: string;\n    assetPositions: {\n      type: string;\n      position: {\n        coin: string;\n        szi: string;\n        leverage: { type: string; value: number };\n        entryPx: string;\n        positionValue: string;\n        unrealizedPnl: string;\n        returnOnEquity: string;\n        liquidationPx: string;\n        marginUsed: string;\n        maxLeverage: number;\n        cumFunding: {\n          allTime: string;\n          sinceOpen: string;\n          sinceChange: string;\n        };\n      };\n    }[];\n    time: number;\n  }>('POST', 'info', { ...params, type: 'clearinghouseState' });\n\nexport const getPerpetualsMetaData = (params?: { dex?: string }) =>\n  request<{\n    universe: {\n      name: string;\n      szDecimals: number;\n      maxLeverage: number;\n      onlyIsolated?: boolean;\n      isDelisted?: boolean;\n    }[];\n    marginTables: [\n      number,\n      {\n        description: string;\n        marginTiers: {\n          lowerBound: string;\n          maxLeverage: number;\n        }[];\n      },\n    ][];\n  }>('POST', 'info', { ...(params ?? {}), type: 'meta' });\n\nexport const getSpotMetaData = () =>\n  request<{\n    tokens: {\n      name: string;\n      szDecimals: number;\n      weiDecimals: number;\n      index: number;\n      tokenId: string;\n      isCanonical: boolean;\n      evmContract: null;\n      fullName: null;\n    }[];\n    universe: {\n      name: string;\n      tokens: number[];\n      index: number;\n      isCanonical: boolean;\n    }[];\n  }>('POST', 'info', { type: 'spotMeta' });\n\nexport const getUserFundingHistory = (params: { user: string; startTime?: number; endTime?: number }) =>\n  request<\n    {\n      time: number;\n      hash: string;\n      delta: { type: string; coin: string; usdc: string; szi: string; fundingRate: string };\n    }[]\n  >('POST', 'info', { ...params, type: 'fundingHistory' });\n\nexport const getUserTokenBalances = (params: { user: string }) =>\n  request<{ balances: { coin: string; token: number; hold: string; total: string; entryNtl: string }[] }>(\n    'POST',\n    'info',\n    {\n      ...params,\n      type: 'tokenBalances',\n    },\n  );\n\nexport const getUserOpenOrders = (params: { user: string }) =>\n  request<{ coin: string; limitPx: string; oid: number; side: string; sz: string; timestamp: number }[]>(\n    'POST',\n    'info',\n    {\n      ...params,\n      type: 'openOrders',\n    },\n  );\n\nexport const getHistoricalFundingRates = (params: { coin: string; startTime: number; endTime?: number }) =>\n  request<{ coin: string; fundingRate: string; premium: string; time: number }[]>('POST', 'info', {\n    ...params,\n    type: 'fundingHistory',\n  });\n\nexport const getAllMids = () => request<Record<string, string>>('POST', 'info', { type: 'allMids' });\n\nexport const getMetaAndAssetCtxs = () =>\n  request<\n    [\n      {\n        universe: {\n          name: string;\n          szDecimals: number;\n          maxLeverage: number;\n          onlyIsolated?: boolean;\n          isDelisted?: boolean;\n        }[];\n      },\n      {\n        dayNtlVlm: string;\n        funding: string;\n        impactPxs: [string, string];\n        markPx: string;\n        midPx: string;\n        openInterest: string;\n        oraclePx: string;\n        premium: string;\n        prevDayPx: string;\n      }[],\n    ]\n  >('POST', 'info', { type: 'metaAndAssetCtxs' });\n\nexport const getCandleSnapshot = (params: {\n  req: { coin: string; interval: string; startTime: number; endTime: number };\n}) =>\n  request<\n    {\n      T: number;\n      c: string;\n      h: string;\n      i: string;\n      l: string;\n      o: string;\n      n: number;\n      s: string;\n      t: number;\n      v: string;\n    }[]\n  >('POST', 'info', { type: 'candleSnapshot', ...params });\n"]}
+{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../../src/api/public-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,MAAwB,EAAE,EAAE,CAC1E,OAAO,CAoCJ,MAAM,EAAE,MAAM,kCAAO,MAAM,KAAE,IAAI,EAAE,oBAAoB,IAAG,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAyB,EAAE,EAAE,CACjE,OAAO,CAkBJ,MAAM,EAAE,MAAM,kCAAO,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,KAAE,IAAI,EAAE,MAAM,IAAG,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE,CAClC,OAAO,CAiBJ,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;AAE3C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAA8D,EAAE,EAAE,CACtG,OAAO,CAML,MAAM,EAAE,MAAM,kCAAO,MAAM,KAAE,IAAI,EAAE,gBAAgB,IAAG,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAwB,EAAE,EAAE,CAC/D,OAAO,CACL,MAAM,EACN,MAAM,kCAED,MAAM,KACT,IAAI,EAAE,wBAAwB,IAEjC,CAAC;AAEJ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAwB,EAAE,EAAE,CAC5D,OAAO,CACL,MAAM,EACN,MAAM,kCAED,MAAM,KACT,IAAI,EAAE,YAAY,IAErB,CAAC;AAEJ;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,MAA6D,EAAE,EAAE,CACzG,OAAO,CAAyE,MAAM,EAAE,MAAM,kCACzF,MAAM,KACT,IAAI,EAAE,gBAAgB,IACtB,CAAC;AAEL;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,OAAO,CAAyB,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AAErG;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,EAAE,CACtC,OAAO,CAuBL,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAEjC,EAAE,EAAE,CACH,OAAO,CAaL,MAAM,EAAE,MAAM,kBAAI,IAAI,EAAE,gBAAgB,IAAK,MAAM,EAAG,CAAC","sourcesContent":["import { request } from './client';\n\n/**\n * Get user's perpetual account summary including positions, margin, and portfolio information\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-perpetuals-account-summary\n * API Endpoint: POST /info (type: clearinghouseState)\n * @param params - Query parameters\n * @param params.user - User's wallet address\n * @returns Promise resolving to account summary with margin information, positions, and portfolio details\n */\nexport const getUserPerpetualsAccountSummary = (params: { user: string }) =>\n  request<{\n    marginSummary: {\n      accountValue: string;\n      totalNtlPos: string;\n      totalRawUsd: string;\n      totalMarginUsed: string;\n    };\n    crossMarginSummary: {\n      accountValue: string;\n      totalNtlPos: string;\n      totalRawUsd: string;\n      totalMarginUsed: string;\n    };\n    crossMaintenanceMarginUsed: string;\n    withdrawable: string;\n    assetPositions: {\n      type: string;\n      position: {\n        coin: string;\n        szi: string;\n        leverage: { type: string; value: number };\n        entryPx: string;\n        positionValue: string;\n        unrealizedPnl: string;\n        returnOnEquity: string;\n        liquidationPx: string;\n        marginUsed: string;\n        maxLeverage: number;\n        cumFunding: {\n          allTime: string;\n          sinceOpen: string;\n          sinceChange: string;\n        };\n      };\n    }[];\n    time: number;\n  }>('POST', 'info', { ...params, type: 'clearinghouseState' });\n\n/**\n * Get perpetual market metadata including available assets, their specifications, and margin tiers\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-metadata\n * API Endpoint: POST /info (type: meta)\n * @param params - Optional query parameters\n * @param params.dex - Optional DEX identifier\n * @returns Promise resolving to universe of perpetual assets and margin configuration\n */\nexport const getPerpetualsMetaData = (params?: { dex?: string }) =>\n  request<{\n    universe: {\n      name: string;\n      szDecimals: number;\n      maxLeverage: number;\n      onlyIsolated?: boolean;\n      isDelisted?: boolean;\n    }[];\n    marginTables: [\n      number,\n      {\n        description: string;\n        marginTiers: {\n          lowerBound: string;\n          maxLeverage: number;\n        }[];\n      },\n    ][];\n  }>('POST', 'info', { ...(params ?? {}), type: 'meta' });\n\n/**\n * Get spot market metadata including available tokens and trading pairs\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-metadata\n * API Endpoint: POST /info (type: spotMeta)\n * @returns Promise resolving to spot universe with token information and pair configurations\n */\nexport const getSpotMetaData = () =>\n  request<{\n    tokens: {\n      name: string;\n      szDecimals: number;\n      weiDecimals: number;\n      index: number;\n      tokenId: string;\n      isCanonical: boolean;\n      evmContract: null;\n      fullName: null;\n    }[];\n    universe: {\n      name: string;\n      tokens: number[];\n      index: number;\n      isCanonical: boolean;\n    }[];\n  }>('POST', 'info', { type: 'spotMeta' });\n\n/**\n * Get user's funding rate payment history for perpetual positions\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-a-users-funding-history-or-non-funding-ledger-updates\n * API Endpoint: POST /info (type: fundingHistory)\n * @param params - Query parameters\n * @param params.user - User's wallet address\n * @param params.startTime - Optional start timestamp in milliseconds\n * @param params.endTime - Optional end timestamp in milliseconds\n * @returns Promise resolving to array of funding payment records with amounts and rates\n */\nexport const getUserFundingHistory = (params: { user: string; startTime?: number; endTime?: number }) =>\n  request<\n    {\n      time: number;\n      hash: string;\n      delta: { type: string; coin: string; usdc: string; szi: string; fundingRate: string };\n    }[]\n  >('POST', 'info', { ...params, type: 'fundingHistory' });\n\n/**\n * Get user's token balances for both spot and perpetual accounts\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-a-users-token-balances\n * API Endpoint: POST /info (type: tokenBalances)\n * @param params - Query parameters\n * @param params.user - User's wallet address\n * @returns Promise resolving to array of token balances with held and total amounts\n */\nexport const getUserTokenBalances = (params: { user: string }) =>\n  request<{ balances: { coin: string; token: number; hold: string; total: string; entryNtl: string }[] }>(\n    'POST',\n    'info',\n    {\n      ...params,\n      type: 'spotClearinghouseState',\n    },\n  );\n\n/**\n * Get user's currently open orders across all markets\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#open-orders\n * API Endpoint: POST /info (type: openOrders)\n * @param params - Query parameters\n * @param params.user - User's wallet address\n * @returns Promise resolving to array of open order details with prices, sizes, and timestamps\n */\nexport const getUserOpenOrders = (params: { user: string }) =>\n  request<{ coin: string; limitPx: string; oid: number; side: string; sz: string; timestamp: number }[]>(\n    'POST',\n    'info',\n    {\n      ...params,\n      type: 'openOrders',\n    },\n  );\n\n/**\n * Get historical funding rates for a specific perpetual asset\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-historical-funding-rates\n * API Endpoint: POST /info (type: fundingHistory)\n * @param params - Query parameters\n * @param params.coin - Asset symbol (e.g., \"BTC\", \"ETH\")\n * @param params.startTime - Start timestamp in milliseconds\n * @param params.endTime - Optional end timestamp in milliseconds\n * @returns Promise resolving to array of historical funding rate records\n */\nexport const getHistoricalFundingRates = (params: { coin: string; startTime: number; endTime?: number }) =>\n  request<{ coin: string; fundingRate: string; premium: string; time: number }[]>('POST', 'info', {\n    ...params,\n    type: 'fundingHistory',\n  });\n\n/**\n * Get current mid prices for all tradable assets\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-mids-for-all-coins\n * API Endpoint: POST /info (type: allMids)\n * @returns Promise resolving to record of asset symbols mapped to their mid prices\n */\nexport const getAllMids = () => request<Record<string, string>>('POST', 'info', { type: 'allMids' });\n\n/**\n * Get metadata and asset contexts (prices, funding, OI) for all perpetuals\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-asset-contexts-includes-mark-price-current-funding-open-interest-etc.\n * API Endpoint: POST /info (type: metaAndAssetCtxs)\n * @returns Promise resolving to metadata and current asset contexts\n */\nexport const getMetaAndAssetCtxs = () =>\n  request<\n    [\n      {\n        universe: {\n          name: string;\n          szDecimals: number;\n          maxLeverage: number;\n          onlyIsolated?: boolean;\n          isDelisted?: boolean;\n        }[];\n      },\n      {\n        dayNtlVlm: string;\n        funding: string;\n        impactPxs: [string, string];\n        markPx: string;\n        midPx: string;\n        openInterest: string;\n        oraclePx: string;\n        premium: string;\n        prevDayPx: string;\n      }[],\n    ]\n  >('POST', 'info', { type: 'metaAndAssetCtxs' });\n\n/**\n * Get candle/K-line data for a specific asset and time range\n * API Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#candle-snapshot\n * API Endpoint: POST /info (type: candleSnapshot)\n * @param params - Query parameters\n * @param params.req - Request object with candle parameters\n * @param params.req.coin - Asset symbol\n * @param params.req.interval - Time interval (e.g., \"1m\", \"5m\", \"1h\", \"1d\")\n * @param params.req.startTime - Start timestamp in milliseconds\n * @param params.req.endTime - End timestamp in milliseconds\n * @returns Promise resolving to candle data with OHLCV information\n */\nexport const getCandleSnapshot = (params: {\n  req: { coin: string; interval: string; startTime: number; endTime: number };\n}) =>\n  request<\n    {\n      T: number;\n      c: string;\n      h: string;\n      i: string;\n      l: string;\n      o: string;\n      n: number;\n      s: string;\n      t: number;\n      v: string;\n    }[]\n  >('POST', 'info', { type: 'candleSnapshot', ...params });\n"]}

package/dist/api/types.js

@@ -1,8 +1,25 @@
 import { Wallet } from 'ethers';
+/**
+ * 从凭证获取地址
+ * @param credential 凭证对象
+ * @returns 钱包地址
+ */
+export const getAddressFromCredential = (credential) => {
+    const wallet = new Wallet(credential.private_key);
+    return wallet.address;
+};
+/**
+ * 创建凭证对象
+ * @param private_key 私钥
+ * @returns 凭证对象
+ */
 export const createCredential = (private_key) => {
-    const wallet = new Wallet(private_key);
-    return { private_key, address: wallet.address };
+    return { private_key };
 };
+/**
+ * 获取默认凭证（从环境变量）
+ * @returns 默认凭证对象
+ */
 export const getDefaultCredential = () => {
     const private_key = process.env.PRIVATE_KEY;
     if (!private_key) {

package/dist/api/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAOhC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAe,EAAE;IACnE,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC;IACvC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;AAClD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAgB,EAAE;IACpD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAC5C,IAAI,CAAC,WAAW,EAAE;QAChB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;KAC5E;IACD,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC;AACvC,CAAC,CAAC","sourcesContent":["import { Wallet } from 'ethers';\n\nexport interface ICredential {\n  private_key: string;\n  address: string;\n}\n\nexport const createCredential = (private_key: string): ICredential => {\n  const wallet = new Wallet(private_key);\n  return { private_key, address: wallet.address };\n};\n\nexport const getDefaultCredential = (): ICredential => {\n  const private_key = process.env.PRIVATE_KEY;\n  if (!private_key) {\n    throw new Error('Missing Hyperliquid credential: PRIVATE_KEY must be set');\n  }\n  return createCredential(private_key);\n};\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAUhC;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,UAAuB,EAAU,EAAE;IAC1E,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAe,EAAE;IACnE,OAAO,EAAE,WAAW,EAAE,CAAC;AACzB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAgB,EAAE;IACpD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAC5C,IAAI,CAAC,WAAW,EAAE;QAChB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;KAC5E;IACD,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC;AACvC,CAAC,CAAC","sourcesContent":["import { Wallet } from 'ethers';\n\n/**\n * Hyperliquid 凭证接口\n * 仅包含核心数据，行为方法通过辅助函数提供\n */\nexport interface ICredential {\n  private_key: string;\n}\n\n/**\n * 从凭证获取地址\n * @param credential 凭证对象\n * @returns 钱包地址\n */\nexport const getAddressFromCredential = (credential: ICredential): string => {\n  const wallet = new Wallet(credential.private_key);\n  return wallet.address;\n};\n\n/**\n * 创建凭证对象\n * @param private_key 私钥\n * @returns 凭证对象\n */\nexport const createCredential = (private_key: string): ICredential => {\n  return { private_key };\n};\n\n/**\n * 获取默认凭证（从环境变量）\n * @returns 默认凭证对象\n */\nexport const getDefaultCredential = (): ICredential => {\n  const private_key = process.env.PRIVATE_KEY;\n  if (!private_key) {\n    throw new Error('Missing Hyperliquid credential: PRIVATE_KEY must be set');\n  }\n  return createCredential(private_key);\n};\n"]}

package/dist/index.js

@@ -1,5 +1,10 @@
-import './account';
-import './order-actions';
-import './order-actions-with-credential';
-import './public-data';
+// Import services from new structure
+import './services/account-actions-with-credential';
+import './services/accounts/perp';
+import './services/order-actions-with-credential';
+// Import market data services
+import './services/markets/interest-rate';
+import './services/markets/ohlc';
+import './services/markets/product';
+import './services/markets/quote';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,CAAC;AACnB,OAAO,iBAAiB,CAAC;AACzB,OAAO,iCAAiC,CAAC;AACzC,OAAO,eAAe,CAAC","sourcesContent":["import './account';\nimport './order-actions';\nimport './order-actions-with-credential';\nimport './public-data';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,4CAA4C,CAAC;AACpD,OAAO,0BAA0B,CAAC;AAClC,OAAO,0CAA0C,CAAC;AAElD,8BAA8B;AAC9B,OAAO,kCAAkC,CAAC;AAC1C,OAAO,yBAAyB,CAAC;AACjC,OAAO,4BAA4B,CAAC;AACpC,OAAO,0BAA0B,CAAC","sourcesContent":["// Import services from new structure\nimport './services/account-actions-with-credential';\nimport './services/accounts/perp';\nimport './services/order-actions-with-credential';\n\n// Import market data services\nimport './services/markets/interest-rate';\nimport './services/markets/ohlc';\nimport './services/markets/product';\nimport './services/markets/quote';\n"]}

package/dist/services/account-actions-with-credential.js

@@ -0,0 +1,122 @@
+import { provideAccountActionsWithCredential } from '@yuants/data-account';
+import { Terminal } from '@yuants/protocol';
+import { encodePath, formatTime } from '@yuants/utils';
+import { getUserOpenOrders, getUserPerpetualsAccountSummary, getUserTokenBalances } from '../api/public-api';
+import { getAddressFromCredential } from '../api/types';
+/**
+ * Get account info for perpetual account
+ */
+const getPerpAccountInfo = async (credential, account_id) => {
+    console.info(`[${formatTime(Date.now())}] Getting perp account info for ${account_id}`);
+    const summary = await getUserPerpetualsAccountSummary({ user: getAddressFromCredential(credential) });
+    const orders = await getUserOpenOrders({ user: getAddressFromCredential(credential) });
+    // Map positions
+    const positions = summary.assetPositions.map((position) => ({
+        position_id: `${position.position.coin}-USD`,
+        datasource_id: 'HYPERLIQUID',
+        product_id: encodePath('PERPETUAL', `${position.position.coin}-USD`),
+        direction: +position.position.szi > 0 ? 'LONG' : 'SHORT',
+        volume: Math.abs(+position.position.szi),
+        free_volume: Math.abs(+position.position.szi),
+        position_price: +position.position.entryPx,
+        closable_price: Math.abs(+position.position.positionValue / +position.position.szi || 0),
+        floating_profit: +position.position.unrealizedPnl,
+        valuation: +position.position.positionValue,
+        margin: +position.position.marginUsed,
+    }));
+    // Map orders
+    const mapOrderDirection = (side) => {
+        const normalized = side.toUpperCase();
+        if (normalized === 'BID' || normalized === 'BUY') {
+            return 'OPEN_LONG';
+        }
+        if (normalized === 'ASK' || normalized === 'SELL') {
+            return 'OPEN_SHORT';
+        }
+        return 'OPEN_LONG';
+    };
+    const pending_orders = orders.map((order) => {
+        var _a, _b;
+        return ({
+            order_id: `${order.oid}`,
+            account_id,
+            product_id: encodePath('PERPETUAL', `${(_a = order.coin) === null || _a === void 0 ? void 0 : _a.trim()}-USD`),
+            order_type: 'LIMIT',
+            order_direction: mapOrderDirection(order.side),
+            volume: Number(order.sz) || 0,
+            price: Number(order.limitPx) || undefined,
+            submit_at: Number((_b = order.timestamp) !== null && _b !== void 0 ? _b : Date.now()),
+        });
+    });
+    return {
+        money: {
+            currency: 'USDC',
+            equity: +summary.crossMarginSummary.accountValue,
+            free: +summary.withdrawable,
+        },
+        positions,
+        pending_orders,
+    };
+};
+/**
+ * Get account info for spot account
+ */
+const getSpotAccountInfo = async (credential, account_id) => {
+    console.info(`[${formatTime(Date.now())}] Getting spot account info for ${account_id}`);
+    const balances = await getUserTokenBalances({ user: getAddressFromCredential(credential) });
+    // Map token balances to positions (using spot as "positions")
+    const positions = balances.balances
+        .filter((balance) => Number(balance.total) > 0)
+        .map((balance) => ({
+        position_id: `${balance.coin}`,
+        datasource_id: 'HYPERLIQUID',
+        product_id: encodePath('SPOT', `${balance.coin}-USDC`),
+        direction: 'LONG',
+        volume: Number(balance.total),
+        free_volume: Number(balance.total) - Number(balance.hold),
+        position_price: 1,
+        closable_price: 1,
+        floating_profit: 0,
+        valuation: Number(balance.total),
+        margin: 0,
+    }));
+    return {
+        money: {
+            currency: 'USDC',
+            equity: positions.reduce((sum, pos) => sum + pos.valuation, 0),
+            free: positions.reduce((sum, pos) => sum + pos.free_volume, 0),
+        },
+        positions,
+        pending_orders: [], // Spot orders would need separate API call
+    };
+};
+provideAccountActionsWithCredential(Terminal.fromNodeEnv(), 'HYPERLIQUID', {
+    type: 'object',
+    required: ['private_key'],
+    properties: {
+        private_key: { type: 'string' },
+    },
+}, {
+    listAccounts: async (credential) => {
+        console.info(`[${formatTime(Date.now())}] Listing accounts for ${getAddressFromCredential(credential)}`);
+        return [
+            {
+                account_id: `hyperliquid/${getAddressFromCredential(credential)}/perp/USDC`,
+            },
+            {
+                account_id: `hyperliquid/${getAddressFromCredential(credential)}/spot/USDC`,
+            },
+        ];
+    },
+    getAccountInfo: async (credential, account_id) => {
+        console.info(`[${formatTime(Date.now())}] Getting account info for ${account_id}`);
+        if (account_id.endsWith('/perp/USDC')) {
+            return getPerpAccountInfo(credential, account_id);
+        }
+        if (account_id.endsWith('/spot/USDC')) {
+            return getSpotAccountInfo(credential, account_id);
+        }
+        throw new Error(`Unsupported account type for account_id: ${account_id}`);
+    },
+});
+//# sourceMappingURL=account-actions-with-credential.js.map

package/dist/services/account-actions-with-credential.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-actions-with-credential.js","sourceRoot":"","sources":["../../src/services/account-actions-with-credential.ts"],"names":[],"mappings":"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","sourcesContent":["import { provideAccountActionsWithCredential } from '@yuants/data-account';\nimport { Terminal } from '@yuants/protocol';\nimport { encodePath, formatTime } from '@yuants/utils';\nimport { getUserOpenOrders, getUserPerpetualsAccountSummary, getUserTokenBalances } from '../api/public-api';\nimport { ICredential, getAddressFromCredential } from '../api/types';\n\n/**\n * Get account info for perpetual account\n */\nconst getPerpAccountInfo = async (credential: ICredential, account_id: string) => {\n  console.info(`[${formatTime(Date.now())}] Getting perp account info for ${account_id}`);\n\n  const summary = await getUserPerpetualsAccountSummary({ user: getAddressFromCredential(credential) });\n  const orders = await getUserOpenOrders({ user: getAddressFromCredential(credential) });\n\n  // Map positions\n  const positions = summary.assetPositions.map((position) => ({\n    position_id: `${position.position.coin}-USD`,\n    datasource_id: 'HYPERLIQUID',\n    product_id: encodePath('PERPETUAL', `${position.position.coin}-USD`),\n    direction: +position.position.szi > 0 ? 'LONG' : 'SHORT',\n    volume: Math.abs(+position.position.szi),\n    free_volume: Math.abs(+position.position.szi),\n    position_price: +position.position.entryPx,\n    closable_price: Math.abs(+position.position.positionValue / +position.position.szi || 0),\n    floating_profit: +position.position.unrealizedPnl,\n    valuation: +position.position.positionValue,\n    margin: +position.position.marginUsed,\n  }));\n\n  // Map orders\n  const mapOrderDirection = (side: string) => {\n    const normalized = side.toUpperCase();\n    if (normalized === 'BID' || normalized === 'BUY') {\n      return 'OPEN_LONG';\n    }\n    if (normalized === 'ASK' || normalized === 'SELL') {\n      return 'OPEN_SHORT';\n    }\n    return 'OPEN_LONG';\n  };\n\n  const pending_orders = orders.map((order) => ({\n    order_id: `${order.oid}`,\n    account_id,\n    product_id: encodePath('PERPETUAL', `${order.coin?.trim()}-USD`),\n    order_type: 'LIMIT',\n    order_direction: mapOrderDirection(order.side),\n    volume: Number(order.sz) || 0,\n    price: Number(order.limitPx) || undefined,\n    submit_at: Number(order.timestamp ?? Date.now()),\n  }));\n\n  return {\n    money: {\n      currency: 'USDC',\n      equity: +summary.crossMarginSummary.accountValue,\n      free: +summary.withdrawable,\n    },\n    positions,\n    pending_orders,\n  };\n};\n\n/**\n * Get account info for spot account\n */\nconst getSpotAccountInfo = async (credential: ICredential, account_id: string) => {\n  console.info(`[${formatTime(Date.now())}] Getting spot account info for ${account_id}`);\n\n  const balances = await getUserTokenBalances({ user: getAddressFromCredential(credential) });\n\n  // Map token balances to positions (using spot as \"positions\")\n  const positions = balances.balances\n    .filter((balance: any) => Number(balance.total) > 0)\n    .map((balance: any) => ({\n      position_id: `${balance.coin}`,\n      datasource_id: 'HYPERLIQUID',\n      product_id: encodePath('SPOT', `${balance.coin}-USDC`),\n      direction: 'LONG',\n      volume: Number(balance.total),\n      free_volume: Number(balance.total) - Number(balance.hold),\n      position_price: 1, // USDC as quote currency\n      closable_price: 1,\n      floating_profit: 0,\n      valuation: Number(balance.total),\n      margin: 0,\n    }));\n\n  return {\n    money: {\n      currency: 'USDC',\n      equity: positions.reduce((sum: number, pos: any) => sum + pos.valuation, 0),\n      free: positions.reduce((sum: number, pos: any) => sum + pos.free_volume, 0),\n    },\n    positions,\n    pending_orders: [], // Spot orders would need separate API call\n  };\n};\n\nprovideAccountActionsWithCredential<ICredential>(\n  Terminal.fromNodeEnv(),\n  'HYPERLIQUID',\n  {\n    type: 'object',\n    required: ['private_key'],\n    properties: {\n      private_key: { type: 'string' },\n    },\n  },\n  {\n    listAccounts: async (credential) => {\n      console.info(\n        `[${formatTime(Date.now())}] Listing accounts for ${getAddressFromCredential(credential)}`,\n      );\n      return [\n        {\n          account_id: `hyperliquid/${getAddressFromCredential(credential)}/perp/USDC`,\n        },\n        {\n          account_id: `hyperliquid/${getAddressFromCredential(credential)}/spot/USDC`,\n        },\n      ];\n    },\n    getAccountInfo: async (credential, account_id) => {\n      console.info(`[${formatTime(Date.now())}] Getting account info for ${account_id}`);\n\n      if (account_id.endsWith('/perp/USDC')) {\n        return getPerpAccountInfo(credential, account_id);\n      }\n      if (account_id.endsWith('/spot/USDC')) {\n        return getSpotAccountInfo(credential, account_id);\n      }\n      throw new Error(`Unsupported account type for account_id: ${account_id}`);\n    },\n  },\n);\n"]}

package/dist/{account.js → services/accounts/perp.js}

@@ -2,11 +2,11 @@ import { addAccountMarket, provideAccountInfoService } from '@yuants/data-accoun
 import { providePendingOrdersService } from '@yuants/data-order';
 import { Terminal } from '@yuants/protocol';
 import { encodePath } from '@yuants/utils';
-import { getUserOpenOrders, getUserPerpetualsAccountSummary } from './api/public-api';
-import { getDefaultCredential } from './api/types';
+import { getUserOpenOrders, getUserPerpetualsAccountSummary } from '../../api/public-api';
+import { getDefaultCredential, getAddressFromCredential } from '../../api/types';
 const terminal = Terminal.fromNodeEnv();
 const credential = getDefaultCredential();
-const walletAddress = credential.address.toLowerCase();
+const walletAddress = getAddressFromCredential(credential).toLowerCase();
 export const defaultPerpAccountId = `hyperliquid/${walletAddress}/perp/USDC`;
 addAccountMarket(terminal, { account_id: defaultPerpAccountId, market_id: 'HYPERLIQUID/PERP' });
 const mapPosition = (position) => ({
@@ -23,7 +23,7 @@ const mapPosition = (position) => ({
     margin: +position.position.marginUsed,
 });
 provideAccountInfoService(terminal, defaultPerpAccountId, async () => {
-    const summary = await getUserPerpetualsAccountSummary({ user: credential.address });
+    const summary = await getUserPerpetualsAccountSummary({ user: getAddressFromCredential(credential) });
     return {
         money: {
             currency: 'USDC',
@@ -44,7 +44,7 @@ const mapOrderDirection = (side) => {
     return 'OPEN_LONG';
 };
 providePendingOrdersService(terminal, defaultPerpAccountId, async () => {
-    const orders = await getUserOpenOrders({ user: credential.address });
+    const orders = await getUserOpenOrders({ user: getAddressFromCredential(credential) });
     return orders.map((order) => {
         var _a, _b;
         return ({
@@ -59,4 +59,4 @@ providePendingOrdersService(terminal, defaultPerpAccountId, async () => {
         });
     });
 }, { auto_refresh_interval: 2000 });
-//# sourceMappingURL=account.js.map
+//# sourceMappingURL=perp.js.map

package/dist/services/accounts/perp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perp.js","sourceRoot":"","sources":["../../../src/services/accounts/perp.ts"],"names":[],"mappings":"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","sourcesContent":["import { addAccountMarket, IPosition, provideAccountInfoService } from '@yuants/data-account';\nimport { IOrder, providePendingOrdersService } from '@yuants/data-order';\nimport { Terminal } from '@yuants/protocol';\nimport { encodePath } from '@yuants/utils';\nimport { getUserOpenOrders, getUserPerpetualsAccountSummary } from '../../api/public-api';\nimport { getDefaultCredential, getAddressFromCredential } from '../../api/types';\n\nconst terminal = Terminal.fromNodeEnv();\nconst credential = getDefaultCredential();\nconst walletAddress = getAddressFromCredential(credential).toLowerCase();\nexport const defaultPerpAccountId = `hyperliquid/${walletAddress}/perp/USDC`;\n\naddAccountMarket(terminal, { account_id: defaultPerpAccountId, market_id: 'HYPERLIQUID/PERP' });\n\nconst mapPosition = (position: any): IPosition => ({\n  position_id: `${position.position.coin}-USD`,\n  datasource_id: 'HYPERLIQUID',\n  product_id: encodePath('PERPETUAL', `${position.position.coin}-USD`),\n  direction: +position.position.szi > 0 ? 'LONG' : 'SHORT',\n  volume: Math.abs(+position.position.szi),\n  free_volume: Math.abs(+position.position.szi),\n  position_price: +position.position.entryPx,\n  closable_price: Math.abs(+position.position.positionValue / +position.position.szi || 0),\n  floating_profit: +position.position.unrealizedPnl,\n  valuation: +position.position.positionValue,\n  margin: +position.position.marginUsed,\n});\n\nprovideAccountInfoService(\n  terminal,\n  defaultPerpAccountId,\n  async () => {\n    const summary = await getUserPerpetualsAccountSummary({ user: getAddressFromCredential(credential) });\n    return {\n      money: {\n        currency: 'USDC',\n        equity: +summary.crossMarginSummary.accountValue,\n        free: +summary.withdrawable,\n      },\n      positions: summary.assetPositions.map(mapPosition),\n    };\n  },\n  { auto_refresh_interval: 1000 },\n);\n\nconst mapOrderDirection = (side: string): IOrder['order_direction'] => {\n  const normalized = side.toUpperCase();\n  if (normalized === 'BID' || normalized === 'BUY') {\n    return 'OPEN_LONG';\n  }\n  if (normalized === 'ASK' || normalized === 'SELL') {\n    return 'OPEN_SHORT';\n  }\n  return 'OPEN_LONG';\n};\n\nprovidePendingOrdersService(\n  terminal,\n  defaultPerpAccountId,\n  async () => {\n    const orders = await getUserOpenOrders({ user: getAddressFromCredential(credential) });\n    return orders.map(\n      (order): IOrder => ({\n        order_id: `${order.oid}`,\n        account_id: defaultPerpAccountId,\n        product_id: encodePath('PERPETUAL', `${order.coin?.trim()}-USD`),\n        order_type: 'LIMIT',\n        order_direction: mapOrderDirection(order.side),\n        volume: Number(order.sz) || 0,\n        price: Number(order.limitPx) || undefined,\n        submit_at: Number(order.timestamp ?? Date.now()),\n      }),\n    );\n  },\n  { auto_refresh_interval: 2000 },\n);\n"]}

package/dist/{public-data → services/markets}/interest-rate.js

@@ -15,7 +15,7 @@ import { Terminal } from '@yuants/protocol';
 import { createSQLWriter } from '@yuants/sql';
 import { decodePath, encodePath, formatTime } from '@yuants/utils';
 import { defer, map, mergeAll, repeat, retry, shareReplay, tap } from 'rxjs';
-import { getHistoricalFundingRates, getPerpetualsMetaData } from '../api/public-api';
+import { getHistoricalFundingRates, getPerpetualsMetaData } from '../../api/public-api';
 const terminal = Terminal.fromNodeEnv();
 const perpetualProducts$ = defer(async () => {
     const meta = await getPerpetualsMetaData();

package/dist/services/markets/interest-rate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interest-rate.js","sourceRoot":"","sources":["../../../src/services/markets/interest-rate.ts"],"names":[],"mappings":"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","sourcesContent":["import { IInterestRate } from '@yuants/data-interest-rate';\nimport { createSeriesProvider, ISeriesCollectingTask } from '@yuants/data-series';\nimport { Terminal } from '@yuants/protocol';\nimport { createSQLWriter } from '@yuants/sql';\nimport { decodePath, encodePath, formatTime } from '@yuants/utils';\nimport { defer, map, mergeAll, repeat, retry, shareReplay, tap } from 'rxjs';\nimport { getHistoricalFundingRates, getPerpetualsMetaData } from '../../api/public-api';\n\nconst terminal = Terminal.fromNodeEnv();\n\nconst perpetualProducts$ = defer(async () => {\n  const meta = await getPerpetualsMetaData();\n  return meta.universe.map((product) => ({\n    product_id: encodePath('PERPETUAL', `${product.name}-USD`),\n    datasource_id: 'HYPERLIQUID',\n    no_interest_rate: false,\n  }));\n}).pipe(\n  tap({ error: (err) => console.error(formatTime(Date.now()), 'PerpetualProductFetchFailed', err) }),\n  retry({ delay: 10_000 }),\n  repeat({ delay: 3600_000 }),\n  shareReplay({ bufferSize: 1, refCount: true }),\n);\n\ncreateSQLWriter<ISeriesCollectingTask>(terminal, {\n  data$: perpetualProducts$.pipe(\n    map((products) => products.filter((product) => product.no_interest_rate === false)),\n    mergeAll(),\n    map(\n      (product): ISeriesCollectingTask => ({\n        series_id: encodePath(product.datasource_id, product.product_id),\n        table_name: 'interest_rate',\n        cron_pattern: '0 * * * *',\n        cron_timezone: 'UTC',\n        disabled: false,\n        replay_count: 0,\n      }),\n    ),\n  ),\n  tableName: 'series_collecting_task',\n  writeInterval: 1000,\n  conflictKeys: ['series_id', 'table_name'],\n});\n\ncreateSeriesProvider<IInterestRate>(terminal, {\n  tableName: 'interest_rate',\n  series_id_prefix_parts: ['HYPERLIQUID'],\n  reversed: true,\n  serviceOptions: { concurrent: 1 },\n  queryFn: async function* ({ series_id, started_at, ended_at }) {\n    const start = started_at || 0;\n    const end = ended_at || Date.now();\n    const [datasource_id, product_id] = decodePath(series_id);\n    const [, instId] = decodePath(product_id);\n    const coin = instId.split('-')[0];\n    let current = start;\n    while (current <= end) {\n      const res = await getHistoricalFundingRates({ coin, startTime: current, endTime: end });\n      if (!res || res.length === 0) {\n        break;\n      }\n      const filtered = res.filter((v) => v.time >= current && v.time <= end);\n      if (!filtered.length) {\n        break;\n      }\n      yield filtered.map(\n        (v): IInterestRate => ({\n          series_id,\n          product_id,\n          datasource_id,\n          created_at: formatTime(v.time),\n          long_rate: `${-parseFloat(v.fundingRate)}`,\n          short_rate: `${v.fundingRate}`,\n          settlement_price: '',\n        }),\n      );\n      if (res.length < 500) {\n        break;\n      }\n      current = filtered[filtered.length - 1].time + 1;\n    }\n  },\n});\n"]}

package/dist/{public-data → services/markets}/ohlc.js

@@ -13,7 +13,7 @@ var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _ar
 import { createSeriesProvider } from '@yuants/data-series';
 import { Terminal } from '@yuants/protocol';
 import { decodePath, formatTime } from '@yuants/utils';
-import { getCandleSnapshot } from '../api/public-api';
+import { getCandleSnapshot } from '../../api/public-api';
 const terminal = Terminal.fromNodeEnv();
 const DURATION_TO_HYPERLIQUID_INTERVAL = {
     PT1M: '1m',

package/dist/services/markets/ohlc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ohlc.js","sourceRoot":"","sources":["../../../src/services/markets/ohlc.ts"],"names":[],"mappings":"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","sourcesContent":["import { IOHLC } from '@yuants/data-ohlc';\nimport { createSeriesProvider } from '@yuants/data-series';\nimport { Terminal } from '@yuants/protocol';\nimport { decodePath, formatTime } from '@yuants/utils';\nimport { getCandleSnapshot } from '../../api/public-api';\n\nconst terminal = Terminal.fromNodeEnv();\n\nconst DURATION_TO_HYPERLIQUID_INTERVAL: Record<string, string> = {\n  PT1M: '1m',\n  PT3M: '3m',\n  PT5M: '5m',\n  PT15M: '15m',\n  PT30M: '30m',\n  PT1H: '1h',\n  PT2H: '2h',\n  PT4H: '4h',\n  PT8H: '8h',\n  PT12H: '12h',\n  P1D: '1d',\n  P3D: '3d',\n  P1W: '1w',\n  P1M: '1M',\n};\n\nconst DURATION_TO_PERIOD_IN_SEC: Record<string, number> = {\n  PT1M: 60,\n  PT3M: 180,\n  PT5M: 300,\n  PT15M: 900,\n  PT30M: 1800,\n  PT1H: 3600,\n  PT2H: 7200,\n  PT4H: 14400,\n  PT8H: 28800,\n  PT12H: 43200,\n  P1D: 86400,\n  P3D: 259200,\n  P1W: 604800,\n  P1M: 2592000,\n};\n\ncreateSeriesProvider<IOHLC>(terminal, {\n  tableName: 'ohlc',\n  series_id_prefix_parts: ['HYPERLIQUID'],\n  reversed: true,\n  serviceOptions: { concurrent: 1 },\n  queryFn: async function* ({ series_id, ended_at }) {\n    const [datasource_id, product_id, duration] = decodePath(series_id);\n    const period_in_sec = DURATION_TO_PERIOD_IN_SEC[duration];\n    if (!datasource_id || !product_id || !period_in_sec) {\n      throw new Error(`Invalid series_id: ${series_id}`);\n    }\n    const [, instId] = decodePath(product_id);\n    if (!instId) {\n      throw new Error(`Invalid product_id: ${product_id}`);\n    }\n    const coin = instId.split('-')[0];\n    const interval = DURATION_TO_HYPERLIQUID_INTERVAL[duration];\n    if (!interval) {\n      throw new Error(`Unsupported duration: ${duration}`);\n    }\n    const startTime = 0;\n    const res = await getCandleSnapshot({\n      req: {\n        coin,\n        interval,\n        startTime,\n        endTime: ended_at,\n      },\n    });\n    if (!res || !res.length) {\n      return;\n    }\n    const data = res\n      .filter((x) => x.t < ended_at)\n      .map(\n        (x): IOHLC => ({\n          series_id,\n          datasource_id,\n          product_id,\n          duration,\n          created_at: formatTime(x.t),\n          closed_at: formatTime(x.t + period_in_sec * 1000),\n          open: x.o,\n          high: x.h,\n          low: x.l,\n          close: x.c,\n          volume: x.v,\n          open_interest: '0',\n        }),\n      )\n      .sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime());\n    if (data.length > 0) {\n      yield data;\n    }\n  },\n});\n"]}