@nadohq/engine-client 0.19.1 → 0.21.0

package/dist/{EngineBaseClient-DOOXIhnZ.d.ts → EngineBaseClient-Cn4PMYKt.d.ts}

@@ -1,6 +1,7 @@
-import { G as EngineServerQueryResponseByType, H as EngineServerQueryRequestByType, U as EngineServerQueryRequestType, V as EngineServerQueryRequest } from "./serverQueryTypes-B3vC8vxT.js";
+import { G as EngineServerQueryResponseByType, H as EngineServerQueryRequestByType, U as EngineServerQueryRequestType } from "./serverQueryTypes-B3vC8vxT.js";
 import { a as EngineServerExecuteRequestByType, l as EngineServerExecuteSuccessResult, o as EngineServerExecuteRequestType } from "./serverExecuteTypes-CgbHjnWM.js";
-import { L as GetEngineNoncesParams, R as GetEngineNoncesResponse } from "./clientQueryTypes-DuRgEeBT.js";
+import { G as GetEngineNoncesResponse, W as GetEngineNoncesParams } from "./clientQueryTypes-BaYOTnpm.js";
+import { a as EngineServerCachedQueryRequestByType, c as EngineServerCachedQueryResponseByType, d as EngineServerEdgeControlRequestByType, f as EngineServerEdgeControlRequestType, o as EngineServerCachedQueryRequestType, p as EngineServerEdgeControlResponseByType } from "./serverEdgeQueryTypes-DbSUWFzo.js";
 import { SignableRequestType, SignableRequestTypeToParams, WalletClientWithAccount } from "@nadohq/shared";
 import { AxiosInstance } from "axios";
 
@@ -35,12 +36,25 @@ declare class EngineBaseClient {
    */
   query<TRequestType extends EngineServerQueryRequestType>(requestType: TRequestType, params: EngineServerQueryRequestByType[TRequestType]): Promise<EngineServerQueryResponseByType[TRequestType]>;
   /**
-   * A simple, typechecked fn for constructing a query request in the format expected by the server.
+   * Queries the gateway's in-memory cache via the `/edge/query` endpoint. Lower latency than
+   * {@link query} at the cost of eventual consistency — do not use for order, margin, or
+   * settlement decisions.
    *
    * @param requestType
    * @param params
+   * @public
+   */
+  edgeQuery<TRequestType extends EngineServerCachedQueryRequestType>(requestType: TRequestType, params: EngineServerCachedQueryRequestByType[TRequestType]): Promise<EngineServerCachedQueryResponseByType[TRequestType]>;
+  /**
+   * Sends an edge control message (`ping` / `time`) via the `/edge/query` endpoint. These
+   * return immediately from the server clock and use a different envelope than the cached data
+   * queries (no `data` field), so the whole response body is returned.
+   *
+   * @param requestType
+   * @param params
+   * @public
    */
-  getQueryRequest<TRequestType extends EngineServerQueryRequestType>(requestType: TRequestType, params: EngineServerQueryRequestByType[TRequestType]): EngineServerQueryRequest<TRequestType>;
+  edgeControlQuery<TRequestType extends EngineServerEdgeControlRequestType>(requestType: TRequestType, params: EngineServerEdgeControlRequestByType[TRequestType]): Promise<EngineServerEdgeControlResponseByType[TRequestType]>;
   /**
    * POSTs an execute message to the engine and returns the successful response. Throws the failure response wrapped
    * in an EngineServerFailureError on failure.
@@ -50,6 +64,17 @@ declare class EngineBaseClient {
    * @public
    */
   execute<TRequestType extends EngineServerExecuteRequestType>(requestType: TRequestType, params: EngineServerExecuteRequestByType[TRequestType]): Promise<EngineServerExecuteSuccessResult<TRequestType>>;
+  /**
+   * A simple, typechecked fn for constructing a `type`-tagged request body in the format expected
+   * by the server. Generic over the request type / params pair so it can build live query, edge
+   * (cached) query, and edge control request bodies alike.
+   *
+   * @param requestType
+   * @param params
+   */
+  getQueryRequest<TRequestType extends string, TParams extends object>(requestType: TRequestType, params: TParams): {
+    type: TRequestType;
+  } & TParams;
   /**
    * A simple, typechecked fn for constructing an execute request in the format expected by the server.
    *
@@ -72,4 +97,4 @@ declare class EngineBaseClient {
 }
 //#endregion
 export { EngineClientOpts as n, EngineBaseClient as t };
-//# sourceMappingURL=EngineBaseClient-DOOXIhnZ.d.ts.map
+//# sourceMappingURL=EngineBaseClient-Cn4PMYKt.d.ts.map

package/dist/EngineBaseClient-Cn4PMYKt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EngineBaseClient-Cn4PMYKt.d.ts","names":[],"sources":["../src/src/EngineBaseClient.ts"],"mappings":";;;;;;;;UA+BiB,gBAAA;EAEf,GAAA;EAEA,YAAA,GAAe,uBAAA;EAEf,wBAAA,GAA2B,uBAAuB;AAAA;AAAA,KAI/C,wBAAA,GAA2B,OAAO,CAAC,gCAAA;AAVxC;;;AAAA,cAwBa,gBAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EAtBlB;;;AAAkD;AACnD;EAmCQ,eAAA,CACL,wBAAA,EAA0B,uBAAA;EAKf,UAAA,CAAW,OAAA,YAAmB,OAAA;EAc9B,SAAA,CACX,MAAA,EAAQ,qBAAA,GACP,OAAA,CAAQ,uBAAA;EAtD2D;AAcxE;;;;;;EAwDe,KAAA,sBAA2B,4BAAA,CAAA,CACtC,WAAA,EAAa,YAAA,EACb,MAAA,EAAQ,8BAAA,CAA+B,YAAA,IACtC,OAAA,CAAQ,+BAAA,CAAgC,YAAA;EAnCA;;;;;;;;;EA8D9B,SAAA,sBACU,kCAAA,CAAA,CAErB,WAAA,EAAa,YAAA,EACb,MAAA,EAAQ,oCAAA,CAAqC,YAAA,IAC5C,OAAA,CAAQ,qCAAA,CAAsC,YAAA;EAhC9C;;;;;;;;;EA4DU,gBAAA,sBACU,kCAAA,CAAA,CAErB,WAAA,EAAa,YAAA,EACb,MAAA,EAAQ,oCAAA,CAAqC,YAAA,IAC5C,OAAA,CAAQ,qCAAA,CAAsC,YAAA;EADvC;;;;;;;;EAqBG,OAAA,sBAA6B,8BAAA,CAAA,CACxC,WAAA,EAAa,YAAA,EACb,MAAA,EAAQ,gCAAA,CAAiC,YAAA,IACxC,OAAA,CAAQ,gCAAA,CAAiC,YAAA;EAAA;;;;;;;;EAqBrC,eAAA,qDAAA,CACL,WAAA,EAAa,YAAA,EACb,MAAA,EAAQ,OAAA;IACL,IAAA,EAAM,YAAA;EAAA,IAAiB,OAAA;EAgBzB;;;;;;EAHI,iBAAA,sBAAuC,8BAAA,CAAA,CAC5C,WAAA,EAAa,YAAA,EACb,MAAA,EAAQ,gCAAA,CAAiC,YAAA,IACxC,wBAAA;EAmBqC;;;;;;;;;EAJ3B,IAAA,WAAe,mBAAA,CAAA,CAC1B,WAAA,EAAa,CAAA,EACb,iBAAA,UACA,OAAA,UACA,MAAA,EAAQ,2BAAA,CAA4B,CAAA,IAAE,OAAA;EAAA,QAmBhC,mBAAA;EAAA,QAQA,iBAAA;AAAA"}

package/dist/{EngineBaseClient-L1ue7jBx.d.cts → EngineBaseClient-a2leWTER.d.cts}

@@ -1,6 +1,7 @@
-import { G as EngineServerQueryResponseByType, H as EngineServerQueryRequestByType, U as EngineServerQueryRequestType, V as EngineServerQueryRequest } from "./serverQueryTypes-Dva9R2tV.cjs";
+import { G as EngineServerQueryResponseByType, H as EngineServerQueryRequestByType, U as EngineServerQueryRequestType } from "./serverQueryTypes-Dva9R2tV.cjs";
 import { a as EngineServerExecuteRequestByType, l as EngineServerExecuteSuccessResult, o as EngineServerExecuteRequestType } from "./serverExecuteTypes-DejTR8Is.cjs";
-import { L as GetEngineNoncesParams, R as GetEngineNoncesResponse } from "./clientQueryTypes-DlTtS_mX.cjs";
+import { G as GetEngineNoncesResponse, W as GetEngineNoncesParams } from "./clientQueryTypes-BTKfuoGI.cjs";
+import { a as EngineServerCachedQueryRequestByType, c as EngineServerCachedQueryResponseByType, d as EngineServerEdgeControlRequestByType, f as EngineServerEdgeControlRequestType, o as EngineServerCachedQueryRequestType, p as EngineServerEdgeControlResponseByType } from "./serverEdgeQueryTypes-BpMlbsCD.cjs";
 import { SignableRequestType, SignableRequestTypeToParams, WalletClientWithAccount } from "@nadohq/shared";
 import { AxiosInstance } from "axios";
 
@@ -35,12 +36,25 @@ declare class EngineBaseClient {
    */
   query<TRequestType extends EngineServerQueryRequestType>(requestType: TRequestType, params: EngineServerQueryRequestByType[TRequestType]): Promise<EngineServerQueryResponseByType[TRequestType]>;
   /**
-   * A simple, typechecked fn for constructing a query request in the format expected by the server.
+   * Queries the gateway's in-memory cache via the `/edge/query` endpoint. Lower latency than
+   * {@link query} at the cost of eventual consistency — do not use for order, margin, or
+   * settlement decisions.
    *
    * @param requestType
    * @param params
+   * @public
+   */
+  edgeQuery<TRequestType extends EngineServerCachedQueryRequestType>(requestType: TRequestType, params: EngineServerCachedQueryRequestByType[TRequestType]): Promise<EngineServerCachedQueryResponseByType[TRequestType]>;
+  /**
+   * Sends an edge control message (`ping` / `time`) via the `/edge/query` endpoint. These
+   * return immediately from the server clock and use a different envelope than the cached data
+   * queries (no `data` field), so the whole response body is returned.
+   *
+   * @param requestType
+   * @param params
+   * @public
    */
-  getQueryRequest<TRequestType extends EngineServerQueryRequestType>(requestType: TRequestType, params: EngineServerQueryRequestByType[TRequestType]): EngineServerQueryRequest<TRequestType>;
+  edgeControlQuery<TRequestType extends EngineServerEdgeControlRequestType>(requestType: TRequestType, params: EngineServerEdgeControlRequestByType[TRequestType]): Promise<EngineServerEdgeControlResponseByType[TRequestType]>;
   /**
    * POSTs an execute message to the engine and returns the successful response. Throws the failure response wrapped
    * in an EngineServerFailureError on failure.
@@ -50,6 +64,17 @@ declare class EngineBaseClient {
    * @public
    */
   execute<TRequestType extends EngineServerExecuteRequestType>(requestType: TRequestType, params: EngineServerExecuteRequestByType[TRequestType]): Promise<EngineServerExecuteSuccessResult<TRequestType>>;
+  /**
+   * A simple, typechecked fn for constructing a `type`-tagged request body in the format expected
+   * by the server. Generic over the request type / params pair so it can build live query, edge
+   * (cached) query, and edge control request bodies alike.
+   *
+   * @param requestType
+   * @param params
+   */
+  getQueryRequest<TRequestType extends string, TParams extends object>(requestType: TRequestType, params: TParams): {
+    type: TRequestType;
+  } & TParams;
   /**
    * A simple, typechecked fn for constructing an execute request in the format expected by the server.
    *
@@ -72,4 +97,4 @@ declare class EngineBaseClient {
 }
 //#endregion
 export { EngineClientOpts as n, EngineBaseClient as t };
-//# sourceMappingURL=EngineBaseClient-L1ue7jBx.d.cts.map
+//# sourceMappingURL=EngineBaseClient-a2leWTER.d.cts.map

package/dist/EngineBaseClient-a2leWTER.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EngineBaseClient-a2leWTER.d.cts","names":[],"sources":["../src/src/EngineBaseClient.ts"],"mappings":";;;;;;;;UA+BiB,gBAAA;EAEf,GAAA;EAEA,YAAA,GAAe,uBAAA;EAEf,wBAAA,GAA2B,uBAAuB;AAAA;AAAA,KAI/C,wBAAA,GAA2B,OAAO,CAAC,gCAAA;AAVxC;;;AAAA,cAwBa,gBAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EAtBlB;;;AAAkD;AACnD;EAmCQ,eAAA,CACL,wBAAA,EAA0B,uBAAA;EAKf,UAAA,CAAW,OAAA,YAAmB,OAAA;EAc9B,SAAA,CACX,MAAA,EAAQ,qBAAA,GACP,OAAA,CAAQ,uBAAA;EAtD2D;AAcxE;;;;;;EAwDe,KAAA,sBAA2B,4BAAA,CAAA,CACtC,WAAA,EAAa,YAAA,EACb,MAAA,EAAQ,8BAAA,CAA+B,YAAA,IACtC,OAAA,CAAQ,+BAAA,CAAgC,YAAA;EAnCA;;;;;;;;;EA8D9B,SAAA,sBACU,kCAAA,CAAA,CAErB,WAAA,EAAa,YAAA,EACb,MAAA,EAAQ,oCAAA,CAAqC,YAAA,IAC5C,OAAA,CAAQ,qCAAA,CAAsC,YAAA;EAhC9C;;;;;;;;;EA4DU,gBAAA,sBACU,kCAAA,CAAA,CAErB,WAAA,EAAa,YAAA,EACb,MAAA,EAAQ,oCAAA,CAAqC,YAAA,IAC5C,OAAA,CAAQ,qCAAA,CAAsC,YAAA;EADvC;;;;;;;;EAqBG,OAAA,sBAA6B,8BAAA,CAAA,CACxC,WAAA,EAAa,YAAA,EACb,MAAA,EAAQ,gCAAA,CAAiC,YAAA,IACxC,OAAA,CAAQ,gCAAA,CAAiC,YAAA;EAAA;;;;;;;;EAqBrC,eAAA,qDAAA,CACL,WAAA,EAAa,YAAA,EACb,MAAA,EAAQ,OAAA;IACL,IAAA,EAAM,YAAA;EAAA,IAAiB,OAAA;EAgBzB;;;;;;EAHI,iBAAA,sBAAuC,8BAAA,CAAA,CAC5C,WAAA,EAAa,YAAA,EACb,MAAA,EAAQ,gCAAA,CAAiC,YAAA,IACxC,wBAAA;EAmBqC;;;;;;;;;EAJ3B,IAAA,WAAe,mBAAA,CAAA,CAC1B,WAAA,EAAa,CAAA,EACb,iBAAA,UACA,OAAA,UACA,MAAA,EAAQ,2BAAA,CAA4B,CAAA,IAAE,OAAA;EAAA,QAmBhC,mBAAA;EAAA,QAQA,iBAAA;AAAA"}

package/dist/{EngineBaseClient-Uc1D8ftx.cjs → EngineBaseClient-zgQmbhJv.cjs}

@@ -71,16 +71,36 @@ var EngineBaseClient = class {
 		return response.data.data;
 	}
 	/**
-	* A simple, typechecked fn for constructing a query request in the format expected by the server.
+	* Queries the gateway's in-memory cache via the `/edge/query` endpoint. Lower latency than
+	* {@link query} at the cost of eventual consistency — do not use for order, margin, or
+	* settlement decisions.
 	*
 	* @param requestType
 	* @param params
+	* @public
 	*/
-	getQueryRequest(requestType, params) {
-		return {
-			type: requestType,
-			...params
-		};
+	async edgeQuery(requestType, params) {
+		const request = this.getQueryRequest(requestType, params);
+		const response = await this.axiosInstance.post(`${this.opts.url}/edge/query`, request);
+		this.checkResponseStatus(response);
+		this.checkServerStatus(response);
+		return response.data.data;
+	}
+	/**
+	* Sends an edge control message (`ping` / `time`) via the `/edge/query` endpoint. These
+	* return immediately from the server clock and use a different envelope than the cached data
+	* queries (no `data` field), so the whole response body is returned.
+	*
+	* @param requestType
+	* @param params
+	* @public
+	*/
+	async edgeControlQuery(requestType, params) {
+		const request = this.getQueryRequest(requestType, params);
+		const response = await this.axiosInstance.post(`${this.opts.url}/edge/query`, request);
+		this.checkResponseStatus(response);
+		this.checkServerStatus(response);
+		return response.data;
 	}
 	/**
 	* POSTs an execute message to the engine and returns the successful response. Throws the failure response wrapped
@@ -98,6 +118,20 @@ var EngineBaseClient = class {
 		return response.data;
 	}
 	/**
+	* A simple, typechecked fn for constructing a `type`-tagged request body in the format expected
+	* by the server. Generic over the request type / params pair so it can build live query, edge
+	* (cached) query, and edge control request bodies alike.
+	*
+	* @param requestType
+	* @param params
+	*/
+	getQueryRequest(requestType, params) {
+		return {
+			type: requestType,
+			...params
+		};
+	}
+	/**
 	* A simple, typechecked fn for constructing an execute request in the format expected by the server.
 	*
 	* @param requestType
@@ -147,4 +181,4 @@ Object.defineProperty(exports, "__toESM", {
 	}
 });
 
-//# sourceMappingURL=EngineBaseClient-Uc1D8ftx.cjs.map
+//# sourceMappingURL=EngineBaseClient-zgQmbhJv.cjs.map

package/dist/EngineBaseClient-zgQmbhJv.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"EngineBaseClient-zgQmbhJv.cjs","names":["WalletNotProvidedError","successResponse","EngineServerFailureError"],"sources":["../src/EngineBaseClient.ts"],"sourcesContent":["import {\n  getSignedTransactionRequest,\n  SignableRequestType,\n  SignableRequestTypeToParams,\n  WalletClientWithAccount,\n  WalletNotProvidedError,\n} from '@nadohq/shared';\nimport axios, { AxiosInstance, AxiosResponse } from 'axios';\nimport {\n  EngineServerCachedQueryRequestByType,\n  EngineServerCachedQueryRequestType,\n  EngineServerCachedQueryResponse,\n  EngineServerCachedQueryResponseByType,\n  EngineServerCachedQuerySuccessResponse,\n  EngineServerEdgeControlRequestByType,\n  EngineServerEdgeControlRequestType,\n  EngineServerEdgeControlResponseByType,\n  EngineServerExecuteRequestByType,\n  EngineServerExecuteRequestType,\n  EngineServerExecuteResult,\n  EngineServerExecuteSuccessResult,\n  EngineServerQueryRequestByType,\n  EngineServerQueryRequestType,\n  EngineServerQueryResponse,\n  EngineServerQueryResponseByType,\n  EngineServerQuerySuccessResponse,\n  GetEngineNoncesParams,\n  GetEngineNoncesResponse,\n} from './types';\nimport { EngineServerFailureError } from './types/EngineServerFailureError';\n\nexport interface EngineClientOpts {\n  // Server URL\n  url: string;\n  // Wallet client for EIP712 signing\n  walletClient?: WalletClientWithAccount;\n  // Linked signer registered through the engine, if provided, execute requests will use this signer\n  linkedSignerWalletClient?: WalletClientWithAccount;\n}\n\n// Only 1 key can be defined per execute request\ntype EngineExecuteRequestBody = Partial<EngineServerExecuteRequestByType>;\n\ntype EngineQueryRequestResponse<\n  T extends EngineServerQueryRequestType = EngineServerQueryRequestType,\n> = EngineServerQueryResponse<T>;\n\ntype EngineCachedQueryRequestResponse<\n  T extends EngineServerCachedQueryRequestType =\n    EngineServerCachedQueryRequestType,\n> = EngineServerCachedQueryResponse<T>;\n\n/**\n * Base client for all engine requests\n */\nexport class EngineBaseClient {\n  readonly opts: EngineClientOpts;\n  readonly axiosInstance: AxiosInstance;\n\n  constructor(opts: EngineClientOpts) {\n    this.opts = opts;\n    this.axiosInstance = axios.create({\n      withCredentials: true,\n      // We have custom logic to validate response status and create an appropriate error\n      validateStatus: () => true,\n    });\n  }\n\n  /**\n   * Sets the linked signer for execute requests\n   *\n   * @param linkedSignerWalletClient The linkedSigner to use for all signatures. Set to null to revert to the chain signer\n   */\n  public setLinkedSigner(\n    linkedSignerWalletClient: WalletClientWithAccount | null,\n  ) {\n    this.opts.linkedSignerWalletClient = linkedSignerWalletClient ?? undefined;\n  }\n\n  public async getTxNonce(address?: string): Promise<string> {\n    const addr = address ?? this.opts.walletClient?.account.address;\n\n    if (!addr) {\n      throw new WalletNotProvidedError();\n    }\n\n    return (\n      await this.getNonces({\n        address: addr,\n      })\n    ).txNonce;\n  }\n\n  public async getNonces(\n    params: GetEngineNoncesParams,\n  ): Promise<GetEngineNoncesResponse> {\n    const baseResp = await this.query('nonces', params);\n\n    return {\n      orderNonce: baseResp.order_nonce,\n      txNonce: baseResp.tx_nonce,\n    };\n  }\n\n  /**\n   * Queries the engine, all query params are stringified into the query string\n   *\n   * @param requestType\n   * @param params\n   * @public\n   */\n  public async query<TRequestType extends EngineServerQueryRequestType>(\n    requestType: TRequestType,\n    params: EngineServerQueryRequestByType[TRequestType],\n  ): Promise<EngineServerQueryResponseByType[TRequestType]> {\n    const request = this.getQueryRequest(requestType, params);\n    const response = await this.axiosInstance.post<EngineQueryRequestResponse>(\n      `${this.opts.url}/query`,\n      request,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus throws on failure responses so the cast to the success response is acceptable here\n    const successResponse = response as AxiosResponse<\n      EngineServerQuerySuccessResponse<TRequestType>\n    >;\n\n    return successResponse.data.data;\n  }\n\n  /**\n   * Queries the gateway's in-memory cache via the `/edge/query` endpoint. Lower latency than\n   * {@link query} at the cost of eventual consistency — do not use for order, margin, or\n   * settlement decisions.\n   *\n   * @param requestType\n   * @param params\n   * @public\n   */\n  public async edgeQuery<\n    TRequestType extends EngineServerCachedQueryRequestType,\n  >(\n    requestType: TRequestType,\n    params: EngineServerCachedQueryRequestByType[TRequestType],\n  ): Promise<EngineServerCachedQueryResponseByType[TRequestType]> {\n    const request = this.getQueryRequest(requestType, params);\n    const response =\n      await this.axiosInstance.post<EngineCachedQueryRequestResponse>(\n        `${this.opts.url}/edge/query`,\n        request,\n      );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus throws on failure responses so the cast to the success response is acceptable here\n    const successResponse = response as AxiosResponse<\n      EngineServerCachedQuerySuccessResponse<TRequestType>\n    >;\n\n    return successResponse.data.data;\n  }\n\n  /**\n   * Sends an edge control message (`ping` / `time`) via the `/edge/query` endpoint. These\n   * return immediately from the server clock and use a different envelope than the cached data\n   * queries (no `data` field), so the whole response body is returned.\n   *\n   * @param requestType\n   * @param params\n   * @public\n   */\n  public async edgeControlQuery<\n    TRequestType extends EngineServerEdgeControlRequestType,\n  >(\n    requestType: TRequestType,\n    params: EngineServerEdgeControlRequestByType[TRequestType],\n  ): Promise<EngineServerEdgeControlResponseByType[TRequestType]> {\n    const request = this.getQueryRequest(requestType, params);\n    const response = await this.axiosInstance.post<\n      EngineServerEdgeControlResponseByType[TRequestType]\n    >(`${this.opts.url}/edge/query`, request);\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    return response.data;\n  }\n\n  /**\n   * POSTs an execute message to the engine and returns the successful response. Throws the failure response wrapped\n   * in an EngineServerFailureError on failure.\n   *\n   * @param requestType\n   * @param params\n   * @public\n   */\n  public async execute<TRequestType extends EngineServerExecuteRequestType>(\n    requestType: TRequestType,\n    params: EngineServerExecuteRequestByType[TRequestType],\n  ): Promise<EngineServerExecuteSuccessResult<TRequestType>> {\n    const reqBody = this.getExecuteRequest(requestType, params);\n    const response = await this.axiosInstance.post<\n      EngineServerExecuteResult<TRequestType>\n    >(`${this.opts.url}/execute`, reqBody);\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus catches the failure result and throws the error, so the cast to the success response is acceptable here\n    return response.data as EngineServerExecuteSuccessResult<TRequestType>;\n  }\n\n  /**\n   * A simple, typechecked fn for constructing a `type`-tagged request body in the format expected\n   * by the server. Generic over the request type / params pair so it can build live query, edge\n   * (cached) query, and edge control request bodies alike.\n   *\n   * @param requestType\n   * @param params\n   */\n  public getQueryRequest<TRequestType extends string, TParams extends object>(\n    requestType: TRequestType,\n    params: TParams,\n  ): { type: TRequestType } & TParams {\n    return {\n      type: requestType,\n      ...params,\n    };\n  }\n\n  /**\n   * A simple, typechecked fn for constructing an execute request in the format expected by the server.\n   *\n   * @param requestType\n   * @param params\n   */\n  public getExecuteRequest<TRequestType extends EngineServerExecuteRequestType>(\n    requestType: TRequestType,\n    params: EngineServerExecuteRequestByType[TRequestType],\n  ): EngineExecuteRequestBody {\n    return {\n      [requestType]: params,\n    };\n  }\n\n  /**\n   * Signs a given request with the signer provided to the engine\n   *\n   * @param requestType\n   * @param verifyingContract\n   * @param chainId\n   * @param params\n   * @public\n   */\n  public async sign<T extends SignableRequestType>(\n    requestType: T,\n    verifyingContract: string,\n    chainId: number,\n    params: SignableRequestTypeToParams[T],\n  ) {\n    // Use the linked signer if provided, otherwise use the default signer provided to the engine\n    const walletClient =\n      this.opts.linkedSignerWalletClient ?? this.opts.walletClient;\n\n    if (!walletClient) {\n      throw new WalletNotProvidedError();\n    }\n\n    return getSignedTransactionRequest({\n      chainId,\n      requestParams: params,\n      requestType,\n      walletClient,\n      verifyingContract,\n    });\n  }\n\n  private checkResponseStatus(response: AxiosResponse) {\n    if (response.status !== 200 || !response.data) {\n      throw Error(\n        `Unexpected response from server: ${response.status} ${response.statusText}. Data: ${response.data}`,\n      );\n    }\n  }\n\n  private checkServerStatus(\n    response: AxiosResponse<\n      | EngineServerExecuteResult\n      | EngineQueryRequestResponse\n      | EngineCachedQueryRequestResponse\n      | EngineServerEdgeControlResponseByType[EngineServerEdgeControlRequestType]\n    >,\n  ) {\n    if (response.data.status !== 'success') {\n      throw new EngineServerFailureError(response.data);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuDA,IAAa,mBAAb,MAA8B;CAI5B,YAAY,MAAwB;EAClC,KAAK,OAAO;EACZ,KAAK,gBAAgB,MAAA,QAAM,OAAO;GAChC,iBAAiB;GAEjB,sBAAsB;EACxB,CAAC;CACH;;;;;;CAOA,gBACE,0BACA;EACA,KAAK,KAAK,2BAA2B,4BAA4B,KAAA;CACnE;CAEA,MAAa,WAAW,SAAmC;EACzD,MAAM,OAAO,WAAW,KAAK,KAAK,cAAc,QAAQ;EAExD,IAAI,CAAC,MACH,MAAM,IAAIA,eAAAA,uBAAuB;EAGnC,QACE,MAAM,KAAK,UAAU,EACnB,SAAS,KACX,CAAC,GACD;CACJ;CAEA,MAAa,UACX,QACkC;EAClC,MAAM,WAAW,MAAM,KAAK,MAAM,UAAU,MAAM;EAElD,OAAO;GACL,YAAY,SAAS;GACrB,SAAS,SAAS;EACpB;CACF;;;;;;;;CASA,MAAa,MACX,aACA,QACwD;EACxD,MAAM,UAAU,KAAK,gBAAgB,aAAa,MAAM;EACxD,MAAM,WAAW,MAAM,KAAK,cAAc,KACxC,GAAG,KAAK,KAAK,IAAI,SACjB,OACF;EAEA,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAO/B,OAAOC,SAAgB,KAAK;CAC9B;;;;;;;;;;CAWA,MAAa,UAGX,aACA,QAC8D;EAC9D,MAAM,UAAU,KAAK,gBAAgB,aAAa,MAAM;EACxD,MAAM,WACJ,MAAM,KAAK,cAAc,KACvB,GAAG,KAAK,KAAK,IAAI,cACjB,OACF;EAEF,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAO/B,OAAOA,SAAgB,KAAK;CAC9B;;;;;;;;;;CAWA,MAAa,iBAGX,aACA,QAC8D;EAC9D,MAAM,UAAU,KAAK,gBAAgB,aAAa,MAAM;EACxD,MAAM,WAAW,MAAM,KAAK,cAAc,KAExC,GAAG,KAAK,KAAK,IAAI,cAAc,OAAO;EAExC,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAE/B,OAAO,SAAS;CAClB;;;;;;;;;CAUA,MAAa,QACX,aACA,QACyD;EACzD,MAAM,UAAU,KAAK,kBAAkB,aAAa,MAAM;EAC1D,MAAM,WAAW,MAAM,KAAK,cAAc,KAExC,GAAG,KAAK,KAAK,IAAI,WAAW,OAAO;EAErC,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAG/B,OAAO,SAAS;CAClB;;;;;;;;;CAUA,gBACE,aACA,QACkC;EAClC,OAAO;GACL,MAAM;GACN,GAAG;EACL;CACF;;;;;;;CAQA,kBACE,aACA,QAC0B;EAC1B,OAAO,GACJ,cAAc,OACjB;CACF;;;;;;;;;;CAWA,MAAa,KACX,aACA,mBACA,SACA,QACA;EAEA,MAAM,eACJ,KAAK,KAAK,4BAA4B,KAAK,KAAK;EAElD,IAAI,CAAC,cACH,MAAM,IAAID,eAAAA,uBAAuB;EAGnC,QAAA,GAAA,eAAA,6BAAmC;GACjC;GACA,eAAe;GACf;GACA;GACA;EACF,CAAC;CACH;CAEA,oBAA4B,UAAyB;EACnD,IAAI,SAAS,WAAW,OAAO,CAAC,SAAS,MACvC,MAAM,MACJ,oCAAoC,SAAS,OAAO,GAAG,SAAS,WAAW,UAAU,SAAS,MAChG;CAEJ;CAEA,kBACE,UAMA;EACA,IAAI,SAAS,KAAK,WAAW,WAC3B,MAAM,IAAIE,uCAAAA,yBAAyB,SAAS,IAAI;CAEpD;AACF"}

package/dist/EngineBaseClient.cjs

@@ -1,3 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_EngineBaseClient = require("./EngineBaseClient-Uc1D8ftx.cjs");
+const require_EngineBaseClient = require("./EngineBaseClient-zgQmbhJv.cjs");
 exports.EngineBaseClient = require_EngineBaseClient.EngineBaseClient;

package/dist/EngineBaseClient.d.cts

@@ -1,2 +1,2 @@
-import { n as EngineClientOpts, t as EngineBaseClient } from "./EngineBaseClient-L1ue7jBx.cjs";
+import { n as EngineClientOpts, t as EngineBaseClient } from "./EngineBaseClient-a2leWTER.cjs";
 export { EngineBaseClient, EngineClientOpts };

package/dist/EngineBaseClient.d.ts

@@ -1,2 +1,2 @@
-import { n as EngineClientOpts, t as EngineBaseClient } from "./EngineBaseClient-DOOXIhnZ.js";
+import { n as EngineClientOpts, t as EngineBaseClient } from "./EngineBaseClient-Cn4PMYKt.js";
 export { EngineBaseClient, EngineClientOpts };

package/dist/EngineBaseClient.js

@@ -48,16 +48,36 @@ var EngineBaseClient = class {
 		return response.data.data;
 	}
 	/**
-	* A simple, typechecked fn for constructing a query request in the format expected by the server.
+	* Queries the gateway's in-memory cache via the `/edge/query` endpoint. Lower latency than
+	* {@link query} at the cost of eventual consistency — do not use for order, margin, or
+	* settlement decisions.
 	*
 	* @param requestType
 	* @param params
+	* @public
 	*/
-	getQueryRequest(requestType, params) {
-		return {
-			type: requestType,
-			...params
-		};
+	async edgeQuery(requestType, params) {
+		const request = this.getQueryRequest(requestType, params);
+		const response = await this.axiosInstance.post(`${this.opts.url}/edge/query`, request);
+		this.checkResponseStatus(response);
+		this.checkServerStatus(response);
+		return response.data.data;
+	}
+	/**
+	* Sends an edge control message (`ping` / `time`) via the `/edge/query` endpoint. These
+	* return immediately from the server clock and use a different envelope than the cached data
+	* queries (no `data` field), so the whole response body is returned.
+	*
+	* @param requestType
+	* @param params
+	* @public
+	*/
+	async edgeControlQuery(requestType, params) {
+		const request = this.getQueryRequest(requestType, params);
+		const response = await this.axiosInstance.post(`${this.opts.url}/edge/query`, request);
+		this.checkResponseStatus(response);
+		this.checkServerStatus(response);
+		return response.data;
 	}
 	/**
 	* POSTs an execute message to the engine and returns the successful response. Throws the failure response wrapped
@@ -75,6 +95,20 @@ var EngineBaseClient = class {
 		return response.data;
 	}
 	/**
+	* A simple, typechecked fn for constructing a `type`-tagged request body in the format expected
+	* by the server. Generic over the request type / params pair so it can build live query, edge
+	* (cached) query, and edge control request bodies alike.
+	*
+	* @param requestType
+	* @param params
+	*/
+	getQueryRequest(requestType, params) {
+		return {
+			type: requestType,
+			...params
+		};
+	}
+	/**
 	* A simple, typechecked fn for constructing an execute request in the format expected by the server.
 	*
 	* @param requestType

package/dist/EngineBaseClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"EngineBaseClient.js","names":["successResponse"],"sources":["../src/EngineBaseClient.ts"],"sourcesContent":["import {\n  getSignedTransactionRequest,\n  SignableRequestType,\n  SignableRequestTypeToParams,\n  WalletClientWithAccount,\n  WalletNotProvidedError,\n} from '@nadohq/shared';\nimport axios, { AxiosInstance, AxiosResponse } from 'axios';\nimport {\n  EngineServerExecuteRequestByType,\n  EngineServerExecuteRequestType,\n  EngineServerExecuteResult,\n  EngineServerExecuteSuccessResult,\n  EngineServerQueryRequest,\n  EngineServerQueryRequestByType,\n  EngineServerQueryRequestType,\n  EngineServerQueryResponse,\n  EngineServerQueryResponseByType,\n  EngineServerQuerySuccessResponse,\n  GetEngineNoncesParams,\n  GetEngineNoncesResponse,\n} from './types';\nimport { EngineServerFailureError } from './types/EngineServerFailureError';\n\nexport interface EngineClientOpts {\n  // Server URL\n  url: string;\n  // Wallet client for EIP712 signing\n  walletClient?: WalletClientWithAccount;\n  // Linked signer registered through the engine, if provided, execute requests will use this signer\n  linkedSignerWalletClient?: WalletClientWithAccount;\n}\n\n// Only 1 key can be defined per execute request\ntype EngineExecuteRequestBody = Partial<EngineServerExecuteRequestByType>;\n\ntype EngineQueryRequestResponse<\n  T extends EngineServerQueryRequestType = EngineServerQueryRequestType,\n> = EngineServerQueryResponse<T>;\n\n/**\n * Base client for all engine requests\n */\nexport class EngineBaseClient {\n  readonly opts: EngineClientOpts;\n  readonly axiosInstance: AxiosInstance;\n\n  constructor(opts: EngineClientOpts) {\n    this.opts = opts;\n    this.axiosInstance = axios.create({\n      withCredentials: true,\n      // We have custom logic to validate response status and create an appropriate error\n      validateStatus: () => true,\n    });\n  }\n\n  /**\n   * Sets the linked signer for execute requests\n   *\n   * @param linkedSignerWalletClient The linkedSigner to use for all signatures. Set to null to revert to the chain signer\n   */\n  public setLinkedSigner(\n    linkedSignerWalletClient: WalletClientWithAccount | null,\n  ) {\n    this.opts.linkedSignerWalletClient = linkedSignerWalletClient ?? undefined;\n  }\n\n  public async getTxNonce(address?: string): Promise<string> {\n    const addr = address ?? this.opts.walletClient?.account.address;\n\n    if (!addr) {\n      throw new WalletNotProvidedError();\n    }\n\n    return (\n      await this.getNonces({\n        address: addr,\n      })\n    ).txNonce;\n  }\n\n  public async getNonces(\n    params: GetEngineNoncesParams,\n  ): Promise<GetEngineNoncesResponse> {\n    const baseResp = await this.query('nonces', params);\n\n    return {\n      orderNonce: baseResp.order_nonce,\n      txNonce: baseResp.tx_nonce,\n    };\n  }\n\n  /**\n   * Queries the engine, all query params are stringified into the query string\n   *\n   * @param requestType\n   * @param params\n   * @public\n   */\n  public async query<TRequestType extends EngineServerQueryRequestType>(\n    requestType: TRequestType,\n    params: EngineServerQueryRequestByType[TRequestType],\n  ): Promise<EngineServerQueryResponseByType[TRequestType]> {\n    const request = this.getQueryRequest(requestType, params);\n    const response = await this.axiosInstance.post<EngineQueryRequestResponse>(\n      `${this.opts.url}/query`,\n      request,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus throws on failure responses so the cast to the success response is acceptable here\n    const successResponse = response as AxiosResponse<\n      EngineServerQuerySuccessResponse<TRequestType>\n    >;\n\n    return successResponse.data.data;\n  }\n\n  /**\n   * A simple, typechecked fn for constructing a query request in the format expected by the server.\n   *\n   * @param requestType\n   * @param params\n   */\n  public getQueryRequest<TRequestType extends EngineServerQueryRequestType>(\n    requestType: TRequestType,\n    params: EngineServerQueryRequestByType[TRequestType],\n  ): EngineServerQueryRequest<TRequestType> {\n    return {\n      type: requestType,\n      ...params,\n    };\n  }\n\n  /**\n   * POSTs an execute message to the engine and returns the successful response. Throws the failure response wrapped\n   * in an EngineServerFailureError on failure.\n   *\n   * @param requestType\n   * @param params\n   * @public\n   */\n  public async execute<TRequestType extends EngineServerExecuteRequestType>(\n    requestType: TRequestType,\n    params: EngineServerExecuteRequestByType[TRequestType],\n  ): Promise<EngineServerExecuteSuccessResult<TRequestType>> {\n    const reqBody = this.getExecuteRequest(requestType, params);\n    const response = await this.axiosInstance.post<\n      EngineServerExecuteResult<TRequestType>\n    >(`${this.opts.url}/execute`, reqBody);\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus catches the failure result and throws the error, so the cast to the success response is acceptable here\n    return response.data as EngineServerExecuteSuccessResult<TRequestType>;\n  }\n\n  /**\n   * A simple, typechecked fn for constructing an execute request in the format expected by the server.\n   *\n   * @param requestType\n   * @param params\n   */\n  public getExecuteRequest<TRequestType extends EngineServerExecuteRequestType>(\n    requestType: TRequestType,\n    params: EngineServerExecuteRequestByType[TRequestType],\n  ): EngineExecuteRequestBody {\n    return {\n      [requestType]: params,\n    };\n  }\n\n  /**\n   * Signs a given request with the signer provided to the engine\n   *\n   * @param requestType\n   * @param verifyingContract\n   * @param chainId\n   * @param params\n   * @public\n   */\n  public async sign<T extends SignableRequestType>(\n    requestType: T,\n    verifyingContract: string,\n    chainId: number,\n    params: SignableRequestTypeToParams[T],\n  ) {\n    // Use the linked signer if provided, otherwise use the default signer provided to the engine\n    const walletClient =\n      this.opts.linkedSignerWalletClient ?? this.opts.walletClient;\n\n    if (!walletClient) {\n      throw new WalletNotProvidedError();\n    }\n\n    return getSignedTransactionRequest({\n      chainId,\n      requestParams: params,\n      requestType,\n      walletClient,\n      verifyingContract,\n    });\n  }\n\n  private checkResponseStatus(response: AxiosResponse) {\n    if (response.status !== 200 || !response.data) {\n      throw Error(\n        `Unexpected response from server: ${response.status} ${response.statusText}. Data: ${response.data}`,\n      );\n    }\n  }\n\n  private checkServerStatus(\n    response: AxiosResponse<\n      EngineServerExecuteResult | EngineQueryRequestResponse\n    >,\n  ) {\n    if (response.data.status !== 'success') {\n      throw new EngineServerFailureError(response.data);\n    }\n  }\n}\n"],"mappings":";;;;;;;AA2CA,IAAa,mBAAb,MAA8B;CAI5B,YAAY,MAAwB;EAClC,KAAK,OAAO;EACZ,KAAK,gBAAgB,MAAM,OAAO;GAChC,iBAAiB;GAEjB,sBAAsB;EACxB,CAAC;CACH;;;;;;CAOA,gBACE,0BACA;EACA,KAAK,KAAK,2BAA2B,4BAA4B,KAAA;CACnE;CAEA,MAAa,WAAW,SAAmC;EACzD,MAAM,OAAO,WAAW,KAAK,KAAK,cAAc,QAAQ;EAExD,IAAI,CAAC,MACH,MAAM,IAAI,uBAAuB;EAGnC,QACE,MAAM,KAAK,UAAU,EACnB,SAAS,KACX,CAAC,GACD;CACJ;CAEA,MAAa,UACX,QACkC;EAClC,MAAM,WAAW,MAAM,KAAK,MAAM,UAAU,MAAM;EAElD,OAAO;GACL,YAAY,SAAS;GACrB,SAAS,SAAS;EACpB;CACF;;;;;;;;CASA,MAAa,MACX,aACA,QACwD;EACxD,MAAM,UAAU,KAAK,gBAAgB,aAAa,MAAM;EACxD,MAAM,WAAW,MAAM,KAAK,cAAc,KACxC,GAAG,KAAK,KAAK,IAAI,SACjB,OACF;EAEA,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAO/B,OAAOA,SAAgB,KAAK;CAC9B;;;;;;;CAQA,gBACE,aACA,QACwC;EACxC,OAAO;GACL,MAAM;GACN,GAAG;EACL;CACF;;;;;;;;;CAUA,MAAa,QACX,aACA,QACyD;EACzD,MAAM,UAAU,KAAK,kBAAkB,aAAa,MAAM;EAC1D,MAAM,WAAW,MAAM,KAAK,cAAc,KAExC,GAAG,KAAK,KAAK,IAAI,WAAW,OAAO;EAErC,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAG/B,OAAO,SAAS;CAClB;;;;;;;CAQA,kBACE,aACA,QAC0B;EAC1B,OAAO,GACJ,cAAc,OACjB;CACF;;;;;;;;;;CAWA,MAAa,KACX,aACA,mBACA,SACA,QACA;EAEA,MAAM,eACJ,KAAK,KAAK,4BAA4B,KAAK,KAAK;EAElD,IAAI,CAAC,cACH,MAAM,IAAI,uBAAuB;EAGnC,OAAO,4BAA4B;GACjC;GACA,eAAe;GACf;GACA;GACA;EACF,CAAC;CACH;CAEA,oBAA4B,UAAyB;EACnD,IAAI,SAAS,WAAW,OAAO,CAAC,SAAS,MACvC,MAAM,MACJ,oCAAoC,SAAS,OAAO,GAAG,SAAS,WAAW,UAAU,SAAS,MAChG;CAEJ;CAEA,kBACE,UAGA;EACA,IAAI,SAAS,KAAK,WAAW,WAC3B,MAAM,IAAI,yBAAyB,SAAS,IAAI;CAEpD;AACF"}
+{"version":3,"file":"EngineBaseClient.js","names":["successResponse"],"sources":["../src/EngineBaseClient.ts"],"sourcesContent":["import {\n  getSignedTransactionRequest,\n  SignableRequestType,\n  SignableRequestTypeToParams,\n  WalletClientWithAccount,\n  WalletNotProvidedError,\n} from '@nadohq/shared';\nimport axios, { AxiosInstance, AxiosResponse } from 'axios';\nimport {\n  EngineServerCachedQueryRequestByType,\n  EngineServerCachedQueryRequestType,\n  EngineServerCachedQueryResponse,\n  EngineServerCachedQueryResponseByType,\n  EngineServerCachedQuerySuccessResponse,\n  EngineServerEdgeControlRequestByType,\n  EngineServerEdgeControlRequestType,\n  EngineServerEdgeControlResponseByType,\n  EngineServerExecuteRequestByType,\n  EngineServerExecuteRequestType,\n  EngineServerExecuteResult,\n  EngineServerExecuteSuccessResult,\n  EngineServerQueryRequestByType,\n  EngineServerQueryRequestType,\n  EngineServerQueryResponse,\n  EngineServerQueryResponseByType,\n  EngineServerQuerySuccessResponse,\n  GetEngineNoncesParams,\n  GetEngineNoncesResponse,\n} from './types';\nimport { EngineServerFailureError } from './types/EngineServerFailureError';\n\nexport interface EngineClientOpts {\n  // Server URL\n  url: string;\n  // Wallet client for EIP712 signing\n  walletClient?: WalletClientWithAccount;\n  // Linked signer registered through the engine, if provided, execute requests will use this signer\n  linkedSignerWalletClient?: WalletClientWithAccount;\n}\n\n// Only 1 key can be defined per execute request\ntype EngineExecuteRequestBody = Partial<EngineServerExecuteRequestByType>;\n\ntype EngineQueryRequestResponse<\n  T extends EngineServerQueryRequestType = EngineServerQueryRequestType,\n> = EngineServerQueryResponse<T>;\n\ntype EngineCachedQueryRequestResponse<\n  T extends EngineServerCachedQueryRequestType =\n    EngineServerCachedQueryRequestType,\n> = EngineServerCachedQueryResponse<T>;\n\n/**\n * Base client for all engine requests\n */\nexport class EngineBaseClient {\n  readonly opts: EngineClientOpts;\n  readonly axiosInstance: AxiosInstance;\n\n  constructor(opts: EngineClientOpts) {\n    this.opts = opts;\n    this.axiosInstance = axios.create({\n      withCredentials: true,\n      // We have custom logic to validate response status and create an appropriate error\n      validateStatus: () => true,\n    });\n  }\n\n  /**\n   * Sets the linked signer for execute requests\n   *\n   * @param linkedSignerWalletClient The linkedSigner to use for all signatures. Set to null to revert to the chain signer\n   */\n  public setLinkedSigner(\n    linkedSignerWalletClient: WalletClientWithAccount | null,\n  ) {\n    this.opts.linkedSignerWalletClient = linkedSignerWalletClient ?? undefined;\n  }\n\n  public async getTxNonce(address?: string): Promise<string> {\n    const addr = address ?? this.opts.walletClient?.account.address;\n\n    if (!addr) {\n      throw new WalletNotProvidedError();\n    }\n\n    return (\n      await this.getNonces({\n        address: addr,\n      })\n    ).txNonce;\n  }\n\n  public async getNonces(\n    params: GetEngineNoncesParams,\n  ): Promise<GetEngineNoncesResponse> {\n    const baseResp = await this.query('nonces', params);\n\n    return {\n      orderNonce: baseResp.order_nonce,\n      txNonce: baseResp.tx_nonce,\n    };\n  }\n\n  /**\n   * Queries the engine, all query params are stringified into the query string\n   *\n   * @param requestType\n   * @param params\n   * @public\n   */\n  public async query<TRequestType extends EngineServerQueryRequestType>(\n    requestType: TRequestType,\n    params: EngineServerQueryRequestByType[TRequestType],\n  ): Promise<EngineServerQueryResponseByType[TRequestType]> {\n    const request = this.getQueryRequest(requestType, params);\n    const response = await this.axiosInstance.post<EngineQueryRequestResponse>(\n      `${this.opts.url}/query`,\n      request,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus throws on failure responses so the cast to the success response is acceptable here\n    const successResponse = response as AxiosResponse<\n      EngineServerQuerySuccessResponse<TRequestType>\n    >;\n\n    return successResponse.data.data;\n  }\n\n  /**\n   * Queries the gateway's in-memory cache via the `/edge/query` endpoint. Lower latency than\n   * {@link query} at the cost of eventual consistency — do not use for order, margin, or\n   * settlement decisions.\n   *\n   * @param requestType\n   * @param params\n   * @public\n   */\n  public async edgeQuery<\n    TRequestType extends EngineServerCachedQueryRequestType,\n  >(\n    requestType: TRequestType,\n    params: EngineServerCachedQueryRequestByType[TRequestType],\n  ): Promise<EngineServerCachedQueryResponseByType[TRequestType]> {\n    const request = this.getQueryRequest(requestType, params);\n    const response =\n      await this.axiosInstance.post<EngineCachedQueryRequestResponse>(\n        `${this.opts.url}/edge/query`,\n        request,\n      );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus throws on failure responses so the cast to the success response is acceptable here\n    const successResponse = response as AxiosResponse<\n      EngineServerCachedQuerySuccessResponse<TRequestType>\n    >;\n\n    return successResponse.data.data;\n  }\n\n  /**\n   * Sends an edge control message (`ping` / `time`) via the `/edge/query` endpoint. These\n   * return immediately from the server clock and use a different envelope than the cached data\n   * queries (no `data` field), so the whole response body is returned.\n   *\n   * @param requestType\n   * @param params\n   * @public\n   */\n  public async edgeControlQuery<\n    TRequestType extends EngineServerEdgeControlRequestType,\n  >(\n    requestType: TRequestType,\n    params: EngineServerEdgeControlRequestByType[TRequestType],\n  ): Promise<EngineServerEdgeControlResponseByType[TRequestType]> {\n    const request = this.getQueryRequest(requestType, params);\n    const response = await this.axiosInstance.post<\n      EngineServerEdgeControlResponseByType[TRequestType]\n    >(`${this.opts.url}/edge/query`, request);\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    return response.data;\n  }\n\n  /**\n   * POSTs an execute message to the engine and returns the successful response. Throws the failure response wrapped\n   * in an EngineServerFailureError on failure.\n   *\n   * @param requestType\n   * @param params\n   * @public\n   */\n  public async execute<TRequestType extends EngineServerExecuteRequestType>(\n    requestType: TRequestType,\n    params: EngineServerExecuteRequestByType[TRequestType],\n  ): Promise<EngineServerExecuteSuccessResult<TRequestType>> {\n    const reqBody = this.getExecuteRequest(requestType, params);\n    const response = await this.axiosInstance.post<\n      EngineServerExecuteResult<TRequestType>\n    >(`${this.opts.url}/execute`, reqBody);\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus catches the failure result and throws the error, so the cast to the success response is acceptable here\n    return response.data as EngineServerExecuteSuccessResult<TRequestType>;\n  }\n\n  /**\n   * A simple, typechecked fn for constructing a `type`-tagged request body in the format expected\n   * by the server. Generic over the request type / params pair so it can build live query, edge\n   * (cached) query, and edge control request bodies alike.\n   *\n   * @param requestType\n   * @param params\n   */\n  public getQueryRequest<TRequestType extends string, TParams extends object>(\n    requestType: TRequestType,\n    params: TParams,\n  ): { type: TRequestType } & TParams {\n    return {\n      type: requestType,\n      ...params,\n    };\n  }\n\n  /**\n   * A simple, typechecked fn for constructing an execute request in the format expected by the server.\n   *\n   * @param requestType\n   * @param params\n   */\n  public getExecuteRequest<TRequestType extends EngineServerExecuteRequestType>(\n    requestType: TRequestType,\n    params: EngineServerExecuteRequestByType[TRequestType],\n  ): EngineExecuteRequestBody {\n    return {\n      [requestType]: params,\n    };\n  }\n\n  /**\n   * Signs a given request with the signer provided to the engine\n   *\n   * @param requestType\n   * @param verifyingContract\n   * @param chainId\n   * @param params\n   * @public\n   */\n  public async sign<T extends SignableRequestType>(\n    requestType: T,\n    verifyingContract: string,\n    chainId: number,\n    params: SignableRequestTypeToParams[T],\n  ) {\n    // Use the linked signer if provided, otherwise use the default signer provided to the engine\n    const walletClient =\n      this.opts.linkedSignerWalletClient ?? this.opts.walletClient;\n\n    if (!walletClient) {\n      throw new WalletNotProvidedError();\n    }\n\n    return getSignedTransactionRequest({\n      chainId,\n      requestParams: params,\n      requestType,\n      walletClient,\n      verifyingContract,\n    });\n  }\n\n  private checkResponseStatus(response: AxiosResponse) {\n    if (response.status !== 200 || !response.data) {\n      throw Error(\n        `Unexpected response from server: ${response.status} ${response.statusText}. Data: ${response.data}`,\n      );\n    }\n  }\n\n  private checkServerStatus(\n    response: AxiosResponse<\n      | EngineServerExecuteResult\n      | EngineQueryRequestResponse\n      | EngineCachedQueryRequestResponse\n      | EngineServerEdgeControlResponseByType[EngineServerEdgeControlRequestType]\n    >,\n  ) {\n    if (response.data.status !== 'success') {\n      throw new EngineServerFailureError(response.data);\n    }\n  }\n}\n"],"mappings":";;;;;;;AAuDA,IAAa,mBAAb,MAA8B;CAI5B,YAAY,MAAwB;EAClC,KAAK,OAAO;EACZ,KAAK,gBAAgB,MAAM,OAAO;GAChC,iBAAiB;GAEjB,sBAAsB;EACxB,CAAC;CACH;;;;;;CAOA,gBACE,0BACA;EACA,KAAK,KAAK,2BAA2B,4BAA4B,KAAA;CACnE;CAEA,MAAa,WAAW,SAAmC;EACzD,MAAM,OAAO,WAAW,KAAK,KAAK,cAAc,QAAQ;EAExD,IAAI,CAAC,MACH,MAAM,IAAI,uBAAuB;EAGnC,QACE,MAAM,KAAK,UAAU,EACnB,SAAS,KACX,CAAC,GACD;CACJ;CAEA,MAAa,UACX,QACkC;EAClC,MAAM,WAAW,MAAM,KAAK,MAAM,UAAU,MAAM;EAElD,OAAO;GACL,YAAY,SAAS;GACrB,SAAS,SAAS;EACpB;CACF;;;;;;;;CASA,MAAa,MACX,aACA,QACwD;EACxD,MAAM,UAAU,KAAK,gBAAgB,aAAa,MAAM;EACxD,MAAM,WAAW,MAAM,KAAK,cAAc,KACxC,GAAG,KAAK,KAAK,IAAI,SACjB,OACF;EAEA,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAO/B,OAAOA,SAAgB,KAAK;CAC9B;;;;;;;;;;CAWA,MAAa,UAGX,aACA,QAC8D;EAC9D,MAAM,UAAU,KAAK,gBAAgB,aAAa,MAAM;EACxD,MAAM,WACJ,MAAM,KAAK,cAAc,KACvB,GAAG,KAAK,KAAK,IAAI,cACjB,OACF;EAEF,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAO/B,OAAOA,SAAgB,KAAK;CAC9B;;;;;;;;;;CAWA,MAAa,iBAGX,aACA,QAC8D;EAC9D,MAAM,UAAU,KAAK,gBAAgB,aAAa,MAAM;EACxD,MAAM,WAAW,MAAM,KAAK,cAAc,KAExC,GAAG,KAAK,KAAK,IAAI,cAAc,OAAO;EAExC,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAE/B,OAAO,SAAS;CAClB;;;;;;;;;CAUA,MAAa,QACX,aACA,QACyD;EACzD,MAAM,UAAU,KAAK,kBAAkB,aAAa,MAAM;EAC1D,MAAM,WAAW,MAAM,KAAK,cAAc,KAExC,GAAG,KAAK,KAAK,IAAI,WAAW,OAAO;EAErC,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAG/B,OAAO,SAAS;CAClB;;;;;;;;;CAUA,gBACE,aACA,QACkC;EAClC,OAAO;GACL,MAAM;GACN,GAAG;EACL;CACF;;;;;;;CAQA,kBACE,aACA,QAC0B;EAC1B,OAAO,GACJ,cAAc,OACjB;CACF;;;;;;;;;;CAWA,MAAa,KACX,aACA,mBACA,SACA,QACA;EAEA,MAAM,eACJ,KAAK,KAAK,4BAA4B,KAAK,KAAK;EAElD,IAAI,CAAC,cACH,MAAM,IAAI,uBAAuB;EAGnC,OAAO,4BAA4B;GACjC;GACA,eAAe;GACf;GACA;GACA;EACF,CAAC;CACH;CAEA,oBAA4B,UAAyB;EACnD,IAAI,SAAS,WAAW,OAAO,CAAC,SAAS,MACvC,MAAM,MACJ,oCAAoC,SAAS,OAAO,GAAG,SAAS,WAAW,UAAU,SAAS,MAChG;CAEJ;CAEA,kBACE,UAMA;EACA,IAAI,SAAS,KAAK,WAAW,WAC3B,MAAM,IAAI,yBAAyB,SAAS,IAAI;CAEpD;AACF"}

package/dist/EngineClient.cjs

@@ -1,14 +1,15 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("./EngineBaseClient-Uc1D8ftx.cjs");
+require("./EngineBaseClient-zgQmbhJv.cjs");
+const require_EngineEdgeQueryClient = require("./EngineEdgeQueryClient.cjs");
 const require_EngineExecuteClient = require("./EngineExecuteClient.cjs");
 const require_EngineQueryClient = require("./EngineQueryClient.cjs");
 const require_EngineWebClient = require("./EngineWebClient.cjs");
 let ts_mixer = require("ts-mixer");
 //#region src/EngineClient.ts
 /**
-* Combined Engine client providing query, execution, and WebSocket functionality for off-chain matching engine communication
+* Combined Engine client providing query, edge (cached) query, execution, and WebSocket functionality for off-chain matching engine communication
 */
-var EngineClient = class extends (0, ts_mixer.Mixin)(require_EngineQueryClient.EngineQueryClient, require_EngineExecuteClient.EngineExecuteClient, require_EngineWebClient.EngineWebClient) {};
+var EngineClient = class extends (0, ts_mixer.Mixin)(require_EngineQueryClient.EngineQueryClient, require_EngineEdgeQueryClient.EngineEdgeQueryClient, require_EngineExecuteClient.EngineExecuteClient, require_EngineWebClient.EngineWebClient) {};
 //#endregion
 exports.EngineClient = EngineClient;
 

package/dist/EngineClient.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"EngineClient.cjs","names":["EngineQueryClient","EngineExecuteClient","EngineWebClient"],"sources":["../src/EngineClient.ts"],"sourcesContent":["import { Mixin } from 'ts-mixer';\nimport { EngineExecuteClient } from './EngineExecuteClient';\nimport { EngineQueryClient } from './EngineQueryClient';\nimport { EngineWebClient } from './EngineWebClient';\n\n/**\n * Combined Engine client providing query, execution, and WebSocket functionality for off-chain matching engine communication\n */\nexport class EngineClient extends Mixin(\n  EngineQueryClient,\n  EngineExecuteClient,\n  EngineWebClient,\n) {}\n"],"mappings":";;;;;;;;;;AAQA,IAAa,eAAb,eAAA,GAAA,SAAA,OACEA,0BAAAA,mBACAC,4BAAAA,qBACAC,wBAAAA,eACF,EAAE,CAAC"}
+{"version":3,"file":"EngineClient.cjs","names":["EngineQueryClient","EngineEdgeQueryClient","EngineExecuteClient","EngineWebClient"],"sources":["../src/EngineClient.ts"],"sourcesContent":["import { Mixin } from 'ts-mixer';\nimport { EngineEdgeQueryClient } from './EngineEdgeQueryClient';\nimport { EngineExecuteClient } from './EngineExecuteClient';\nimport { EngineQueryClient } from './EngineQueryClient';\nimport { EngineWebClient } from './EngineWebClient';\n\n/**\n * Combined Engine client providing query, edge (cached) query, execution, and WebSocket functionality for off-chain matching engine communication\n */\nexport class EngineClient extends Mixin(\n  EngineQueryClient,\n  EngineEdgeQueryClient,\n  EngineExecuteClient,\n  EngineWebClient,\n) {}\n"],"mappings":";;;;;;;;;;;AASA,IAAa,eAAb,eAAA,GAAA,SAAA,OACEA,0BAAAA,mBACAC,8BAAAA,uBACAC,4BAAAA,qBACAC,wBAAAA,eACF,EAAE,CAAC"}

package/dist/EngineClient.d.cts

@@ -1,11 +1,12 @@
-import { t as EngineExecuteClient } from "./EngineExecuteClient-BGlNK5Le.cjs";
-import { t as EngineQueryClient } from "./EngineQueryClient-C_7p1oRx.cjs";
-import { t as EngineWebClient } from "./EngineWebClient-DajZqKAQ.cjs";
+import { t as EngineEdgeQueryClient } from "./EngineEdgeQueryClient-CPEDAOd0.cjs";
+import { t as EngineExecuteClient } from "./EngineExecuteClient-BLUkw1vR.cjs";
+import { t as EngineQueryClient } from "./EngineQueryClient-Br-BC5LQ.cjs";
+import { t as EngineWebClient } from "./EngineWebClient-i8BslipN.cjs";
 
 //#region src/EngineClient.d.ts
-declare const EngineClient_base: import("ts-mixer/dist/types/types").Class<any[], EngineQueryClient & EngineExecuteClient & EngineWebClient, typeof EngineQueryClient & typeof EngineExecuteClient & typeof EngineWebClient>;
+declare const EngineClient_base: import("ts-mixer/dist/types/types").Class<any[], EngineQueryClient & EngineEdgeQueryClient & EngineExecuteClient & EngineWebClient, typeof EngineQueryClient & typeof EngineEdgeQueryClient & typeof EngineExecuteClient & typeof EngineWebClient>;
 /**
- * Combined Engine client providing query, execution, and WebSocket functionality for off-chain matching engine communication
+ * Combined Engine client providing query, edge (cached) query, execution, and WebSocket functionality for off-chain matching engine communication
  */
 declare class EngineClient extends EngineClient_base {}
 //#endregion

package/dist/EngineClient.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"EngineClient.d.cts","names":[],"sources":["../src/src/EngineClient.ts"],"mappings":";;;;;cAGoD,iBAAA;;AAAA;;cAKvC,YAAA,SAAqB,iBAIjC"}
+{"version":3,"file":"EngineClient.d.cts","names":[],"sources":["../src/src/EngineClient.ts"],"mappings":";;;;;;cAIoD,iBAAA;;AAAA;;cAKvC,YAAA,SAAqB,iBAKjC"}

package/dist/EngineClient.d.ts

@@ -1,11 +1,12 @@
-import { t as EngineExecuteClient } from "./EngineExecuteClient-0EBoXRd7.js";
-import { t as EngineQueryClient } from "./EngineQueryClient-DQwCRaYl.js";
-import { t as EngineWebClient } from "./EngineWebClient-CEwqgd4t.js";
+import { t as EngineEdgeQueryClient } from "./EngineEdgeQueryClient-B9Y8srJa.js";
+import { t as EngineExecuteClient } from "./EngineExecuteClient-ReEcySA_.js";
+import { t as EngineQueryClient } from "./EngineQueryClient-C0xBMTo-.js";
+import { t as EngineWebClient } from "./EngineWebClient-KXOdpUol.js";
 
 //#region src/EngineClient.d.ts
-declare const EngineClient_base: import("ts-mixer/dist/types/types").Class<any[], EngineQueryClient & EngineExecuteClient & EngineWebClient, typeof EngineQueryClient & typeof EngineExecuteClient & typeof EngineWebClient>;
+declare const EngineClient_base: import("ts-mixer/dist/types/types").Class<any[], EngineQueryClient & EngineEdgeQueryClient & EngineExecuteClient & EngineWebClient, typeof EngineQueryClient & typeof EngineEdgeQueryClient & typeof EngineExecuteClient & typeof EngineWebClient>;
 /**
- * Combined Engine client providing query, execution, and WebSocket functionality for off-chain matching engine communication
+ * Combined Engine client providing query, edge (cached) query, execution, and WebSocket functionality for off-chain matching engine communication
  */
 declare class EngineClient extends EngineClient_base {}
 //#endregion

package/dist/EngineClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EngineClient.d.ts","names":[],"sources":["../src/src/EngineClient.ts"],"mappings":";;;;;cAGoD,iBAAA;;AAAA;;cAKvC,YAAA,SAAqB,iBAIjC"}
+{"version":3,"file":"EngineClient.d.ts","names":[],"sources":["../src/src/EngineClient.ts"],"mappings":";;;;;;cAIoD,iBAAA;;AAAA;;cAKvC,YAAA,SAAqB,iBAKjC"}

package/dist/EngineClient.js

@@ -1,12 +1,13 @@
+import { EngineEdgeQueryClient } from "./EngineEdgeQueryClient.js";
 import { EngineExecuteClient } from "./EngineExecuteClient.js";
 import { EngineQueryClient } from "./EngineQueryClient.js";
 import { EngineWebClient } from "./EngineWebClient.js";
 import { Mixin } from "ts-mixer";
 //#region src/EngineClient.ts
 /**
-* Combined Engine client providing query, execution, and WebSocket functionality for off-chain matching engine communication
+* Combined Engine client providing query, edge (cached) query, execution, and WebSocket functionality for off-chain matching engine communication
 */
-var EngineClient = class extends Mixin(EngineQueryClient, EngineExecuteClient, EngineWebClient) {};
+var EngineClient = class extends Mixin(EngineQueryClient, EngineEdgeQueryClient, EngineExecuteClient, EngineWebClient) {};
 //#endregion
 export { EngineClient };
 

package/dist/EngineClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"EngineClient.js","names":[],"sources":["../src/EngineClient.ts"],"sourcesContent":["import { Mixin } from 'ts-mixer';\nimport { EngineExecuteClient } from './EngineExecuteClient';\nimport { EngineQueryClient } from './EngineQueryClient';\nimport { EngineWebClient } from './EngineWebClient';\n\n/**\n * Combined Engine client providing query, execution, and WebSocket functionality for off-chain matching engine communication\n */\nexport class EngineClient extends Mixin(\n  EngineQueryClient,\n  EngineExecuteClient,\n  EngineWebClient,\n) {}\n"],"mappings":";;;;;;;;AAQA,IAAa,eAAb,cAAkC,MAChC,mBACA,qBACA,eACF,EAAE,CAAC"}
+{"version":3,"file":"EngineClient.js","names":[],"sources":["../src/EngineClient.ts"],"sourcesContent":["import { Mixin } from 'ts-mixer';\nimport { EngineEdgeQueryClient } from './EngineEdgeQueryClient';\nimport { EngineExecuteClient } from './EngineExecuteClient';\nimport { EngineQueryClient } from './EngineQueryClient';\nimport { EngineWebClient } from './EngineWebClient';\n\n/**\n * Combined Engine client providing query, edge (cached) query, execution, and WebSocket functionality for off-chain matching engine communication\n */\nexport class EngineClient extends Mixin(\n  EngineQueryClient,\n  EngineEdgeQueryClient,\n  EngineExecuteClient,\n  EngineWebClient,\n) {}\n"],"mappings":";;;;;;;;;AASA,IAAa,eAAb,cAAkC,MAChC,mBACA,uBACA,qBACA,eACF,EAAE,CAAC"}

package/dist/EngineEdgeQueryClient-B9Y8srJa.d.ts

@@ -0,0 +1,79 @@
+import { q as EngineServerStatusResponse } from "./serverQueryTypes-B3vC8vxT.js";
+import { M as GetEngineMarketPricesResponse, U as GetEngineNlpPoolInfoResponse, _ as GetEngineContractsResponse, b as GetEngineHealthGroupsResponse, c as EnginePingResponse, f as EngineSymbolsResponse, g as GetEngineCachedMarketPricesParams, h as GetEngineCachedBboHistoryResponse, m as GetEngineCachedBboHistoryParams, n as EngineCachedTimeParams, nt as GetEngineSymbolsParams, p as GetEngineAllMarketsResponse, s as EnginePingParams } from "./clientQueryTypes-BaYOTnpm.js";
+import { t as EngineBaseClient } from "./EngineBaseClient-Cn4PMYKt.js";
+import { MarketWithProduct } from "@nadohq/shared";
+
+//#region src/EngineEdgeQueryClient.d.ts
+/**
+ * "Edge" queries hit the gateway's in-memory cache via `/edge/query`. They are lower latency
+ * than the live {@link EngineQueryClient} queries but eventually consistent — do not use them
+ * for order, margin, or settlement decisions.
+ *
+ * Each `getCached*` method mirrors the data shape of its live counterpart; only the request
+ * type and refresh semantics differ.
+ *
+ * @see https://docs.nado.xyz/developer-resources/api/gateway/edge
+ */
+declare class EngineEdgeQueryClient extends EngineBaseClient {
+  /**
+   * Cached highest bid / lowest ask per product. Products with no cached best-bid/offer yet are
+   * silently omitted, so the returned array may be shorter than `productIds`.
+   *
+   * @param params Omit `productIds` to return every product currently in the cache
+   */
+  getCachedMarketPrices(params?: GetEngineCachedMarketPricesParams): Promise<GetEngineMarketPricesResponse>;
+  /**
+   * Cached product metadata and trading config (increments, fees, weights, trading status).
+   *
+   * @param params Optional `productIds` / `productType` filters
+   */
+  getCachedSymbols(params?: GetEngineSymbolsParams): Promise<EngineSymbolsResponse>;
+  /**
+   * Cached chain ID and on-chain contract addresses for the current chain. Always available: if
+   * the cache is cold the gateway falls back to its live contract config.
+   */
+  getCachedContracts(): Promise<GetEngineContractsResponse>;
+  /**
+   * Cached engine status (e.g. `active`, `syncing`). Refreshed every 500ms.
+   */
+  getCachedStatus(): Promise<EngineServerStatusResponse>;
+  /**
+   * Cached full config, risk, and on-chain state for every spot and perp product.
+   */
+  getCachedAllMarkets(): Promise<GetEngineAllMarketsResponse>;
+  /**
+   * Cached all products grouped per edge market, keyed by chain ID.
+   */
+  getCachedEdgeAllMarkets(): Promise<Record<number, MarketWithProduct[]>>;
+  /**
+   * Cached spot/perp product pairings used for health grouping.
+   */
+  getCachedHealthGroups(): Promise<GetEngineHealthGroupsResponse>;
+  /**
+   * Cached NLP pool information. Refreshed every 5s.
+   */
+  getCachedNlpPoolInfo(): Promise<GetEngineNlpPoolInfoResponse>;
+  /**
+   * A rolling, down-samplable time series of best-bid/offer snapshots per product. The gateway
+   * samples the live price cache every 500ms and retains up to 30 minutes of history per product.
+   *
+   * @param params
+   */
+  getCachedBboHistory(params?: GetEngineCachedBboHistoryParams): Promise<GetEngineCachedBboHistoryResponse>;
+  /**
+   * Latency / clock-sync helper. Echoes `clientTime` back alongside the server time so the caller
+   * can measure round-trip latency and clock offset in one call.
+   *
+   * @param params
+   */
+  ping(params?: EnginePingParams): Promise<EnginePingResponse>;
+  /**
+   * Returns the current server time (epoch ms) from the gateway clock.
+   *
+   * @param params
+   */
+  getEdgeControlTime(params?: EngineCachedTimeParams): Promise<number>;
+}
+//#endregion
+export { EngineEdgeQueryClient as t };
+//# sourceMappingURL=EngineEdgeQueryClient-B9Y8srJa.d.ts.map

package/dist/EngineEdgeQueryClient-B9Y8srJa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EngineEdgeQueryClient-B9Y8srJa.d.ts","names":[],"sources":["../src/src/EngineEdgeQueryClient.ts"],"mappings":";;;;;;;;;;AAsCA;;;;;;cAAa,qBAAA,SAA8B,gBAAA;EAyB9B;;;;;;EAlBL,qBAAA,CACJ,MAAA,GAAQ,iCAAA,GACP,OAAA,CAAQ,6BAAA;EAiDkB;;;;;EAnCvB,gBAAA,CACJ,MAAA,GAAQ,sBAAA,GACP,OAAA,CAAQ,qBAAA;EAyF2B;;;;EA1EhC,kBAAA,CAAA,GAAsB,OAAA,CAAQ,0BAAA;EAuGjB;;;EA5Fb,eAAA,CAAA,GAAmB,OAAA,CAAQ,0BAAA;EAmH9B;;;EA5GG,mBAAA,CAAA,GAAuB,OAAA,CAAQ,2BAAA;EA1DI;;;EA2EnC,uBAAA,CAAA,GAA2B,OAAA,CAC/B,MAAA,SAAe,iBAAA;EAnEd;;;EAyFG,qBAAA,CAAA,GAAyB,OAAA,CAAQ,6BAAA;EA1ErC;;;EA0FI,oBAAA,CAAA,GAAwB,OAAA,CAAQ,4BAAA;EA1EV;;;;;;EAqFtB,mBAAA,CACJ,MAAA,GAAQ,+BAAA,GACP,OAAA,CAAQ,iCAAA;EArE0B;;;;;;EAqF/B,IAAA,CAAK,MAAA,GAAQ,gBAAA,GAAwB,OAAA,CAAQ,kBAAA;EA7CZ;;;;;EAkEjC,kBAAA,CACJ,MAAA,GAAQ,sBAAA,GACP,OAAA;AAAA"}