@nadohq/otc-client 0.50.0

package/README.md

@@ -0,0 +1,91 @@
+# `@nadohq/otc-client`
+
+HTTP client for the Nado OTC service. Submits an already-signed fill-or-kill taker order,
+reads that execution back, and builds quote subscriptions. No bearer token and no wallet client.
+
+The caller opens the quote WebSocket. A quote can prefill a form; `execute` does not
+require one.
+
+[Full SDK Documentation](https://nadohq.github.io/nado-typescript-sdk/index.html)
+
+## Usage
+
+```ts
+import { OtcClient, OTC_CLIENT_ENDPOINTS } from '@nadohq/otc-client';
+
+const otc = new OtcClient({ url: OTC_CLIENT_ENDPOINTS.inkMainnet });
+
+const result = await otc.execute({
+  dealId: crypto.randomUUID(),
+  taker,
+});
+
+if (result.deal_id && result.taker_digest) {
+  const status = await otc.getExecutionStatus({
+    dealId: result.deal_id,
+    takerDigest: result.taker_digest,
+  });
+}
+```
+
+A `failure` from admission has no digest, so there is nothing to poll. Poll an in-progress
+failure once it includes `taker_digest`.
+
+It is also available on a `NadoClient` context.
+
+```ts
+const result = await nadoClient.context.otcClient.execute({ dealId, taker });
+```
+
+## Quotes
+
+`subscribe` and `unsubscribe` are the only RFQ methods. Pass one `stream`, or `streams` for
+several. `unsubscribe` repeats the same stream fields. `wallet` is a 20-byte address.
+Socket messages use the server types directly.
+
+```ts
+import {
+  buildOtcRfqSubscriptionMessage,
+  OTC_RFQ_WS_CLIENT_ENDPOINTS,
+  OtcServerRfqMessage,
+} from '@nadohq/otc-client';
+
+const ws = new WebSocket(OTC_RFQ_WS_CLIENT_ENDPOINTS.inkMainnet);
+
+ws.onopen = () => {
+  ws.send(
+    JSON.stringify(
+      buildOtcRfqSubscriptionMessage('subscribe', {
+        id: 1,
+        stream: {
+          type: 'quote',
+          productId: 2,
+          wallet,
+          size: '-1000000000000000000',
+          sizeUnit: 'base',
+        },
+      }),
+    ),
+  );
+};
+
+ws.onmessage = (event) => {
+  const message = JSON.parse(String(event.data)) as OtcServerRfqMessage;
+  if ('type' in message && message.type === 'quote_batch') {
+    for (const quote of message.quotes) {
+      if (quote.status === 'available' && quote.price_x18) {
+        // quote.price_x18, quote.valid_until_ms, quote.base_size
+      }
+    }
+  }
+};
+```
+
+An ack has `result: null` and sets `error` when the server rejected that request. A
+`quote_batch` follows a successful subscribe. `status: 'available'` carries `price_x18`,
+`valid_until_ms`, and `base_size`. `status: 'unavailable'` does not.
+
+`execute` and `getExecutionStatus` return the JSON body for success, failure, and
+`pending_resolution`, including non-200 admission responses. Branch on `status` and
+`recovery_action`, not the HTTP code. `getReady` reports whether a route's quote and deal
+coverage overlap.

package/dist/OtcClient-qUPYb1BP.cjs

@@ -0,0 +1,88 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let _nadohq_shared = require("@nadohq/shared");
+let axios = require("axios");
+axios = __toESM(axios, 1);
+//#region src/OtcClient.ts
+/**
+* Client for the public OTC service.
+*
+* {@link OtcClient.execute} does not sign. The caller supplies an already-signed taker order.
+* A quote is not required. {@link OtcClient.getExecutionStatus} only reads a deal; it does not
+* start or resume one.
+*
+* Responses are the JSON body as returned, including non-200 admission responses. Branch on
+* `status` and `recovery_action`.
+*/
+var OtcClient = class {
+	constructor(opts) {
+		this.opts = opts;
+		this.axiosInstance = axios.default.create({
+			withCredentials: false,
+			validateStatus: () => true,
+			headers: (0, _nadohq_shared.getNadoClientTypeHeaders)(opts.clientType)
+		});
+	}
+	/**
+	* Submits a signed taker order. Send this body unchanged on `retry_same_request`.
+	*/
+	async execute(params) {
+		return this.postExecution("/v1/executor", {
+			deal_id: params.dealId,
+			taker: params.taker,
+			...params.pricerId ? { pricer_id: params.pricerId } : {}
+		});
+	}
+	/**
+	* Reads one execution. Use it after a lost response, a refresh, or `wait`.
+	*/
+	async getExecutionStatus(params) {
+		return this.postExecution("/v1/executor/status", {
+			deal_id: params.dealId,
+			taker_digest: params.takerDigest
+		});
+	}
+	/**
+	* Checks that quote and deal product scopes overlap for a route. An omitted `pricerId`
+	* asks the service default. A direct execution needs a matching deal worker, not a prior quote.
+	*/
+	async getReady(params = {}) {
+		const response = await this.axiosInstance.get(`${this.opts.url}/ready`, { params: params.pricerId ? { pricer_id: params.pricerId } : void 0 });
+		return {
+			httpStatus: response.status,
+			ready: response.status === 200
+		};
+	}
+	async postExecution(path, body) {
+		return (await this.axiosInstance.post(`${this.opts.url}${path}`, body)).data;
+	}
+};
+//#endregion
+Object.defineProperty(exports, "OtcClient", {
+	enumerable: true,
+	get: function() {
+		return OtcClient;
+	}
+});
+
+//# sourceMappingURL=OtcClient-qUPYb1BP.cjs.map

package/dist/OtcClient-qUPYb1BP.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtcClient-qUPYb1BP.cjs","names":[],"sources":["../src/OtcClient.ts"],"sourcesContent":["import { getNadoClientTypeHeaders } from '@nadohq/shared';\nimport axios, { AxiosInstance } from 'axios';\nimport {\n  OtcExecuteParams,\n  OtcGetExecutionStatusParams,\n  OtcGetReadyParams,\n  OtcReadyResult,\n} from './types/clientTypes';\nimport { OtcServerExecutionResponse } from './types/serverTypes';\n\nexport interface OtcClientOpts {\n  /**\n   * OTC service origin, without a path, e.g. {@link OTC_CLIENT_ENDPOINTS}.\n   */\n  url: string;\n  // If provided, identifies the calling client, sent as a header with every request\n  clientType?: string;\n}\n\n/**\n * Client for the public OTC service.\n *\n * {@link OtcClient.execute} does not sign. The caller supplies an already-signed taker order.\n * A quote is not required. {@link OtcClient.getExecutionStatus} only reads a deal; it does not\n * start or resume one.\n *\n * Responses are the JSON body as returned, including non-200 admission responses. Branch on\n * `status` and `recovery_action`.\n */\nexport class OtcClient {\n  readonly opts: OtcClientOpts;\n  readonly axiosInstance: AxiosInstance;\n\n  constructor(opts: OtcClientOpts) {\n    this.opts = opts;\n    this.axiosInstance = axios.create({\n      withCredentials: false,\n      validateStatus: () => true,\n      headers: getNadoClientTypeHeaders(opts.clientType),\n    });\n  }\n\n  /**\n   * Submits a signed taker order. Send this body unchanged on `retry_same_request`.\n   */\n  async execute(params: OtcExecuteParams): Promise<OtcServerExecutionResponse> {\n    return this.postExecution('/v1/executor', {\n      deal_id: params.dealId,\n      taker: params.taker,\n      ...(params.pricerId ? { pricer_id: params.pricerId } : {}),\n    });\n  }\n\n  /**\n   * Reads one execution. Use it after a lost response, a refresh, or `wait`.\n   */\n  async getExecutionStatus(\n    params: OtcGetExecutionStatusParams,\n  ): Promise<OtcServerExecutionResponse> {\n    return this.postExecution('/v1/executor/status', {\n      deal_id: params.dealId,\n      taker_digest: params.takerDigest,\n    });\n  }\n\n  /**\n   * Checks that quote and deal product scopes overlap for a route. An omitted `pricerId`\n   * asks the service default. A direct execution needs a matching deal worker, not a prior quote.\n   */\n  async getReady(params: OtcGetReadyParams = {}): Promise<OtcReadyResult> {\n    const response = await this.axiosInstance.get(`${this.opts.url}/ready`, {\n      params: params.pricerId ? { pricer_id: params.pricerId } : undefined,\n    });\n    return {\n      httpStatus: response.status,\n      ready: response.status === 200,\n    };\n  }\n\n  private async postExecution(\n    path: string,\n    body: unknown,\n  ): Promise<OtcServerExecutionResponse> {\n    const response = await this.axiosInstance.post(\n      `${this.opts.url}${path}`,\n      body,\n    );\n    return response.data as OtcServerExecutionResponse;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,IAAa,YAAb,MAAuB;CAIrB,YAAY,MAAqB;EAC/B,KAAK,OAAO;EACZ,KAAK,gBAAgB,MAAA,QAAM,OAAO;GAChC,iBAAiB;GACjB,sBAAsB;GACtB,UAAA,GAAA,eAAA,0BAAkC,KAAK,UAAU;EACnD,CAAC;CACH;;;;CAKA,MAAM,QAAQ,QAA+D;EAC3E,OAAO,KAAK,cAAc,gBAAgB;GACxC,SAAS,OAAO;GAChB,OAAO,OAAO;GACd,GAAI,OAAO,WAAW,EAAE,WAAW,OAAO,SAAS,IAAI,CAAC;EAC1D,CAAC;CACH;;;;CAKA,MAAM,mBACJ,QACqC;EACrC,OAAO,KAAK,cAAc,uBAAuB;GAC/C,SAAS,OAAO;GAChB,cAAc,OAAO;EACvB,CAAC;CACH;;;;;CAMA,MAAM,SAAS,SAA4B,CAAC,GAA4B;EACtE,MAAM,WAAW,MAAM,KAAK,cAAc,IAAI,GAAG,KAAK,KAAK,IAAI,SAAS,EACtE,QAAQ,OAAO,WAAW,EAAE,WAAW,OAAO,SAAS,IAAI,KAAA,EAC7D,CAAC;EACD,OAAO;GACL,YAAY,SAAS;GACrB,OAAO,SAAS,WAAW;EAC7B;CACF;CAEA,MAAc,cACZ,MACA,MACqC;EAKrC,QAAO,MAJgB,KAAK,cAAc,KACxC,GAAG,KAAK,KAAK,MAAM,QACnB,IACF,GACgB;CAClB;AACF"}

package/dist/OtcClient.cjs

@@ -0,0 +1,3 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_OtcClient = require("./OtcClient-qUPYb1BP.cjs");
+exports.OtcClient = require_OtcClient.OtcClient;

package/dist/OtcClient.d.cts

@@ -0,0 +1,44 @@
+import { i as OtcServerExecutionResponse } from "./serverTypes-CZOJ78c_.cjs";
+import { a as OtcReadyResult, n as OtcGetExecutionStatusParams, r as OtcGetReadyParams, t as OtcExecuteParams } from "./clientTypes-B7w3RxqK.cjs";
+import { AxiosInstance } from "axios";
+
+//#region src/OtcClient.d.ts
+interface OtcClientOpts {
+  /**
+   * OTC service origin, without a path, e.g. {@link OTC_CLIENT_ENDPOINTS}.
+   */
+  url: string;
+  clientType?: string;
+}
+/**
+ * Client for the public OTC service.
+ *
+ * {@link OtcClient.execute} does not sign. The caller supplies an already-signed taker order.
+ * A quote is not required. {@link OtcClient.getExecutionStatus} only reads a deal; it does not
+ * start or resume one.
+ *
+ * Responses are the JSON body as returned, including non-200 admission responses. Branch on
+ * `status` and `recovery_action`.
+ */
+declare class OtcClient {
+  readonly opts: OtcClientOpts;
+  readonly axiosInstance: AxiosInstance;
+  constructor(opts: OtcClientOpts);
+  /**
+   * Submits a signed taker order. Send this body unchanged on `retry_same_request`.
+   */
+  execute(params: OtcExecuteParams): Promise<OtcServerExecutionResponse>;
+  /**
+   * Reads one execution. Use it after a lost response, a refresh, or `wait`.
+   */
+  getExecutionStatus(params: OtcGetExecutionStatusParams): Promise<OtcServerExecutionResponse>;
+  /**
+   * Checks that quote and deal product scopes overlap for a route. An omitted `pricerId`
+   * asks the service default. A direct execution needs a matching deal worker, not a prior quote.
+   */
+  getReady(params?: OtcGetReadyParams): Promise<OtcReadyResult>;
+  private postExecution;
+}
+//#endregion
+export { OtcClient, OtcClientOpts };
+//# sourceMappingURL=OtcClient.d.cts.map

package/dist/OtcClient.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtcClient.d.cts","names":[],"sources":["../src/src/OtcClient.ts"],"mappings":";;;;;UAUiB,aAAA;;AAAjB;;EAIE,GAAA;EAEA,UAAU;AAAA;AAaZ;;;;;;;;;;AAAA,cAAa,SAAA;EAAA,SACF,IAAA,EAAM,aAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,aAAA;EAoC8B;;;EAxB1C,OAAA,CAAQ,MAAA,EAAQ,gBAAA,GAAmB,OAAA,CAAQ,0BAAA;EAflC;;;EA0BT,kBAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,0BAAA;EAzBO;;;;EAoCZ,QAAA,CAAS,MAAA,GAAQ,iBAAA,GAAyB,OAAA,CAAQ,cAAA;EAAA,QAU1C,aAAA;AAAA"}

package/dist/OtcClient.d.ts

@@ -0,0 +1,44 @@
+import { i as OtcServerExecutionResponse } from "./serverTypes-CZOJ78c_.js";
+import { a as OtcReadyResult, n as OtcGetExecutionStatusParams, r as OtcGetReadyParams, t as OtcExecuteParams } from "./clientTypes-DVAoYtGx.js";
+import { AxiosInstance } from "axios";
+
+//#region src/OtcClient.d.ts
+interface OtcClientOpts {
+  /**
+   * OTC service origin, without a path, e.g. {@link OTC_CLIENT_ENDPOINTS}.
+   */
+  url: string;
+  clientType?: string;
+}
+/**
+ * Client for the public OTC service.
+ *
+ * {@link OtcClient.execute} does not sign. The caller supplies an already-signed taker order.
+ * A quote is not required. {@link OtcClient.getExecutionStatus} only reads a deal; it does not
+ * start or resume one.
+ *
+ * Responses are the JSON body as returned, including non-200 admission responses. Branch on
+ * `status` and `recovery_action`.
+ */
+declare class OtcClient {
+  readonly opts: OtcClientOpts;
+  readonly axiosInstance: AxiosInstance;
+  constructor(opts: OtcClientOpts);
+  /**
+   * Submits a signed taker order. Send this body unchanged on `retry_same_request`.
+   */
+  execute(params: OtcExecuteParams): Promise<OtcServerExecutionResponse>;
+  /**
+   * Reads one execution. Use it after a lost response, a refresh, or `wait`.
+   */
+  getExecutionStatus(params: OtcGetExecutionStatusParams): Promise<OtcServerExecutionResponse>;
+  /**
+   * Checks that quote and deal product scopes overlap for a route. An omitted `pricerId`
+   * asks the service default. A direct execution needs a matching deal worker, not a prior quote.
+   */
+  getReady(params?: OtcGetReadyParams): Promise<OtcReadyResult>;
+  private postExecution;
+}
+//#endregion
+export { OtcClient, OtcClientOpts };
+//# sourceMappingURL=OtcClient.d.ts.map

package/dist/OtcClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtcClient.d.ts","names":[],"sources":["../src/src/OtcClient.ts"],"mappings":";;;;;UAUiB,aAAA;;AAAjB;;EAIE,GAAA;EAEA,UAAU;AAAA;AAaZ;;;;;;;;;;AAAA,cAAa,SAAA;EAAA,SACF,IAAA,EAAM,aAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,aAAA;EAoC8B;;;EAxB1C,OAAA,CAAQ,MAAA,EAAQ,gBAAA,GAAmB,OAAA,CAAQ,0BAAA;EAflC;;;EA0BT,kBAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,0BAAA;EAzBO;;;;EAoCZ,QAAA,CAAS,MAAA,GAAQ,iBAAA,GAAyB,OAAA,CAAQ,cAAA;EAAA,QAU1C,aAAA;AAAA"}

package/dist/OtcClient.js

@@ -0,0 +1,60 @@
+import { getNadoClientTypeHeaders } from "@nadohq/shared";
+import axios from "axios";
+//#region src/OtcClient.ts
+/**
+* Client for the public OTC service.
+*
+* {@link OtcClient.execute} does not sign. The caller supplies an already-signed taker order.
+* A quote is not required. {@link OtcClient.getExecutionStatus} only reads a deal; it does not
+* start or resume one.
+*
+* Responses are the JSON body as returned, including non-200 admission responses. Branch on
+* `status` and `recovery_action`.
+*/
+var OtcClient = class {
+	constructor(opts) {
+		this.opts = opts;
+		this.axiosInstance = axios.create({
+			withCredentials: false,
+			validateStatus: () => true,
+			headers: getNadoClientTypeHeaders(opts.clientType)
+		});
+	}
+	/**
+	* Submits a signed taker order. Send this body unchanged on `retry_same_request`.
+	*/
+	async execute(params) {
+		return this.postExecution("/v1/executor", {
+			deal_id: params.dealId,
+			taker: params.taker,
+			...params.pricerId ? { pricer_id: params.pricerId } : {}
+		});
+	}
+	/**
+	* Reads one execution. Use it after a lost response, a refresh, or `wait`.
+	*/
+	async getExecutionStatus(params) {
+		return this.postExecution("/v1/executor/status", {
+			deal_id: params.dealId,
+			taker_digest: params.takerDigest
+		});
+	}
+	/**
+	* Checks that quote and deal product scopes overlap for a route. An omitted `pricerId`
+	* asks the service default. A direct execution needs a matching deal worker, not a prior quote.
+	*/
+	async getReady(params = {}) {
+		const response = await this.axiosInstance.get(`${this.opts.url}/ready`, { params: params.pricerId ? { pricer_id: params.pricerId } : void 0 });
+		return {
+			httpStatus: response.status,
+			ready: response.status === 200
+		};
+	}
+	async postExecution(path, body) {
+		return (await this.axiosInstance.post(`${this.opts.url}${path}`, body)).data;
+	}
+};
+//#endregion
+export { OtcClient };
+
+//# sourceMappingURL=OtcClient.js.map

package/dist/OtcClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtcClient.js","names":[],"sources":["../src/OtcClient.ts"],"sourcesContent":["import { getNadoClientTypeHeaders } from '@nadohq/shared';\nimport axios, { AxiosInstance } from 'axios';\nimport {\n  OtcExecuteParams,\n  OtcGetExecutionStatusParams,\n  OtcGetReadyParams,\n  OtcReadyResult,\n} from './types/clientTypes';\nimport { OtcServerExecutionResponse } from './types/serverTypes';\n\nexport interface OtcClientOpts {\n  /**\n   * OTC service origin, without a path, e.g. {@link OTC_CLIENT_ENDPOINTS}.\n   */\n  url: string;\n  // If provided, identifies the calling client, sent as a header with every request\n  clientType?: string;\n}\n\n/**\n * Client for the public OTC service.\n *\n * {@link OtcClient.execute} does not sign. The caller supplies an already-signed taker order.\n * A quote is not required. {@link OtcClient.getExecutionStatus} only reads a deal; it does not\n * start or resume one.\n *\n * Responses are the JSON body as returned, including non-200 admission responses. Branch on\n * `status` and `recovery_action`.\n */\nexport class OtcClient {\n  readonly opts: OtcClientOpts;\n  readonly axiosInstance: AxiosInstance;\n\n  constructor(opts: OtcClientOpts) {\n    this.opts = opts;\n    this.axiosInstance = axios.create({\n      withCredentials: false,\n      validateStatus: () => true,\n      headers: getNadoClientTypeHeaders(opts.clientType),\n    });\n  }\n\n  /**\n   * Submits a signed taker order. Send this body unchanged on `retry_same_request`.\n   */\n  async execute(params: OtcExecuteParams): Promise<OtcServerExecutionResponse> {\n    return this.postExecution('/v1/executor', {\n      deal_id: params.dealId,\n      taker: params.taker,\n      ...(params.pricerId ? { pricer_id: params.pricerId } : {}),\n    });\n  }\n\n  /**\n   * Reads one execution. Use it after a lost response, a refresh, or `wait`.\n   */\n  async getExecutionStatus(\n    params: OtcGetExecutionStatusParams,\n  ): Promise<OtcServerExecutionResponse> {\n    return this.postExecution('/v1/executor/status', {\n      deal_id: params.dealId,\n      taker_digest: params.takerDigest,\n    });\n  }\n\n  /**\n   * Checks that quote and deal product scopes overlap for a route. An omitted `pricerId`\n   * asks the service default. A direct execution needs a matching deal worker, not a prior quote.\n   */\n  async getReady(params: OtcGetReadyParams = {}): Promise<OtcReadyResult> {\n    const response = await this.axiosInstance.get(`${this.opts.url}/ready`, {\n      params: params.pricerId ? { pricer_id: params.pricerId } : undefined,\n    });\n    return {\n      httpStatus: response.status,\n      ready: response.status === 200,\n    };\n  }\n\n  private async postExecution(\n    path: string,\n    body: unknown,\n  ): Promise<OtcServerExecutionResponse> {\n    const response = await this.axiosInstance.post(\n      `${this.opts.url}${path}`,\n      body,\n    );\n    return response.data as OtcServerExecutionResponse;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AA6BA,IAAa,YAAb,MAAuB;CAIrB,YAAY,MAAqB;EAC/B,KAAK,OAAO;EACZ,KAAK,gBAAgB,MAAM,OAAO;GAChC,iBAAiB;GACjB,sBAAsB;GACtB,SAAS,yBAAyB,KAAK,UAAU;EACnD,CAAC;CACH;;;;CAKA,MAAM,QAAQ,QAA+D;EAC3E,OAAO,KAAK,cAAc,gBAAgB;GACxC,SAAS,OAAO;GAChB,OAAO,OAAO;GACd,GAAI,OAAO,WAAW,EAAE,WAAW,OAAO,SAAS,IAAI,CAAC;EAC1D,CAAC;CACH;;;;CAKA,MAAM,mBACJ,QACqC;EACrC,OAAO,KAAK,cAAc,uBAAuB;GAC/C,SAAS,OAAO;GAChB,cAAc,OAAO;EACvB,CAAC;CACH;;;;;CAMA,MAAM,SAAS,SAA4B,CAAC,GAA4B;EACtE,MAAM,WAAW,MAAM,KAAK,cAAc,IAAI,GAAG,KAAK,KAAK,IAAI,SAAS,EACtE,QAAQ,OAAO,WAAW,EAAE,WAAW,OAAO,SAAS,IAAI,KAAA,EAC7D,CAAC;EACD,OAAO;GACL,YAAY,SAAS;GACrB,OAAO,SAAS,WAAW;EAC7B;CACF;CAEA,MAAc,cACZ,MACA,MACqC;EAKrC,QAAO,MAJgB,KAAK,cAAc,KACxC,GAAG,KAAK,KAAK,MAAM,QACnB,IACF,GACgB;CAClB;AACF"}

package/dist/clientTypes-B7w3RxqK.d.cts

@@ -0,0 +1,57 @@
+import { t as OtcQuoteSizeUnit } from "./serverTypes-CZOJ78c_.cjs";
+import { EngineServerPlaceOrderParams } from "@nadohq/engine-client";
+
+//#region src/types/clientTypes.d.ts
+/**
+ * Signed Nado order the OTC service settles. An engine `place_order` payload without
+ * `id`, `spot_leverage`, and `borrow_margin`.
+ */
+type OtcServerTakerOrderParams = Omit<EngineServerPlaceOrderParams, 'id' | 'spot_leverage' | 'borrow_margin'>;
+interface OtcExecuteParams {
+  /** Client-generated idempotency key, 1–128 bytes. Kept across retries of this intent. */
+  dealId: string;
+  taker: OtcServerTakerOrderParams;
+  /** Execution route. Omitted selects the service default (`awr`). */
+  pricerId?: string;
+}
+interface OtcGetExecutionStatusParams {
+  dealId: string;
+  takerDigest: string;
+}
+interface OtcGetReadyParams {
+  pricerId?: string;
+}
+/**
+ * Route coverage. HTTP 200 is ready; 400 and 503 are not. This does not guarantee liquidity
+ * or that an order will be accepted.
+ */
+interface OtcReadyResult {
+  httpStatus: number;
+  ready: boolean;
+}
+/**
+ * One quote subscription. `wallet` is a 20-byte address, not a 32-byte subaccount.
+ * `size` is a non-zero signed x18 integer string.
+ */
+interface OtcQuoteStream {
+  type: 'quote';
+  productId: number;
+  wallet: string;
+  size: string;
+  sizeUnit: OtcQuoteSizeUnit;
+  /** Execution route. Omitted selects the service default (`awr`). */
+  pricerId?: string;
+}
+interface OtcRfqSubscriptionStreamParams {
+  id: number;
+  stream: OtcQuoteStream;
+}
+interface OtcRfqSubscriptionStreamsParams {
+  id: number;
+  streams: OtcQuoteStream[];
+}
+/** Subscribe or unsubscribe target. Pass one stream, or several. */
+type OtcRfqSubscriptionParams = OtcRfqSubscriptionStreamParams | OtcRfqSubscriptionStreamsParams;
+//#endregion
+export { OtcReadyResult as a, OtcRfqSubscriptionStreamsParams as c, OtcQuoteStream as i, OtcServerTakerOrderParams as l, OtcGetExecutionStatusParams as n, OtcRfqSubscriptionParams as o, OtcGetReadyParams as r, OtcRfqSubscriptionStreamParams as s, OtcExecuteParams as t };
+//# sourceMappingURL=clientTypes-B7w3RxqK.d.cts.map

package/dist/clientTypes-B7w3RxqK.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientTypes-B7w3RxqK.d.cts","names":[],"sources":["../src/types/src/types/clientTypes.ts"],"mappings":";;;;;;AAOA;;KAAY,yBAAA,GAA4B,IAAI,CAC1C,4BAAA;AAAA,UAIe,gBAAA;EAJa;EAM5B,MAAA;EACA,KAAA,EAAO,yBAAyB;;EAEhC,QAAA;AAAA;AAAA,UAGe,2BAAA;EACf,MAAA;EACA,WAAW;AAAA;AAAA,UAGI,iBAAA;EACf,QAAQ;AAAA;;;AAJG;AAGb;UAQiB,cAAA;EACf,UAAA;EACA,KAAK;AAAA;AAFP;;;;AAAA,UASiB,cAAA;EACf,IAAA;EACA,SAAA;EACA,MAAA;EACA,IAAA;EACA,QAAA,EAAU,gBAAgB;EAH1B;EAKA,QAAA;AAAA;AAAA,UAGe,8BAAA;EACf,EAAA;EACA,MAAA,EAAQ,cAAc;AAAA;AAAA,UAGP,+BAAA;EACf,EAAA;EACA,OAAA,EAAS,cAAc;AAAA;;KAIb,wBAAA,GACR,8BAAA,GACA,+BAA+B"}

package/dist/clientTypes-DVAoYtGx.d.ts

@@ -0,0 +1,57 @@
+import { t as OtcQuoteSizeUnit } from "./serverTypes-CZOJ78c_.js";
+import { EngineServerPlaceOrderParams } from "@nadohq/engine-client";
+
+//#region src/types/clientTypes.d.ts
+/**
+ * Signed Nado order the OTC service settles. An engine `place_order` payload without
+ * `id`, `spot_leverage`, and `borrow_margin`.
+ */
+type OtcServerTakerOrderParams = Omit<EngineServerPlaceOrderParams, 'id' | 'spot_leverage' | 'borrow_margin'>;
+interface OtcExecuteParams {
+  /** Client-generated idempotency key, 1–128 bytes. Kept across retries of this intent. */
+  dealId: string;
+  taker: OtcServerTakerOrderParams;
+  /** Execution route. Omitted selects the service default (`awr`). */
+  pricerId?: string;
+}
+interface OtcGetExecutionStatusParams {
+  dealId: string;
+  takerDigest: string;
+}
+interface OtcGetReadyParams {
+  pricerId?: string;
+}
+/**
+ * Route coverage. HTTP 200 is ready; 400 and 503 are not. This does not guarantee liquidity
+ * or that an order will be accepted.
+ */
+interface OtcReadyResult {
+  httpStatus: number;
+  ready: boolean;
+}
+/**
+ * One quote subscription. `wallet` is a 20-byte address, not a 32-byte subaccount.
+ * `size` is a non-zero signed x18 integer string.
+ */
+interface OtcQuoteStream {
+  type: 'quote';
+  productId: number;
+  wallet: string;
+  size: string;
+  sizeUnit: OtcQuoteSizeUnit;
+  /** Execution route. Omitted selects the service default (`awr`). */
+  pricerId?: string;
+}
+interface OtcRfqSubscriptionStreamParams {
+  id: number;
+  stream: OtcQuoteStream;
+}
+interface OtcRfqSubscriptionStreamsParams {
+  id: number;
+  streams: OtcQuoteStream[];
+}
+/** Subscribe or unsubscribe target. Pass one stream, or several. */
+type OtcRfqSubscriptionParams = OtcRfqSubscriptionStreamParams | OtcRfqSubscriptionStreamsParams;
+//#endregion
+export { OtcReadyResult as a, OtcRfqSubscriptionStreamsParams as c, OtcQuoteStream as i, OtcServerTakerOrderParams as l, OtcGetExecutionStatusParams as n, OtcRfqSubscriptionParams as o, OtcGetReadyParams as r, OtcRfqSubscriptionStreamParams as s, OtcExecuteParams as t };
+//# sourceMappingURL=clientTypes-DVAoYtGx.d.ts.map

package/dist/clientTypes-DVAoYtGx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientTypes-DVAoYtGx.d.ts","names":[],"sources":["../src/types/src/types/clientTypes.ts"],"mappings":";;;;;;AAOA;;KAAY,yBAAA,GAA4B,IAAI,CAC1C,4BAAA;AAAA,UAIe,gBAAA;EAJa;EAM5B,MAAA;EACA,KAAA,EAAO,yBAAyB;;EAEhC,QAAA;AAAA;AAAA,UAGe,2BAAA;EACf,MAAA;EACA,WAAW;AAAA;AAAA,UAGI,iBAAA;EACf,QAAQ;AAAA;;;AAJG;AAGb;UAQiB,cAAA;EACf,UAAA;EACA,KAAK;AAAA;AAFP;;;;AAAA,UASiB,cAAA;EACf,IAAA;EACA,SAAA;EACA,MAAA;EACA,IAAA;EACA,QAAA,EAAU,gBAAgB;EAH1B;EAKA,QAAA;AAAA;AAAA,UAGe,8BAAA;EACf,EAAA;EACA,MAAA,EAAQ,cAAc;AAAA;AAAA,UAGP,+BAAA;EACf,EAAA;EACA,OAAA,EAAS,cAAc;AAAA;;KAIb,wBAAA,GACR,8BAAA,GACA,+BAA+B"}

package/dist/endpoints.cjs

@@ -0,0 +1,24 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/endpoints.ts
+/**
+* OTC service origin per chain env. `local` uses the testnet service; there is no localhost
+* deployment.
+*/
+const OTC_CLIENT_ENDPOINTS = {
+	local: "https://otc.test.nado-backend.xyz",
+	inkTestnet: "https://otc.test.nado-backend.xyz",
+	inkMainnet: "https://otc.prod.nado-backend.xyz"
+};
+/**
+* Taker quote socket per chain env. The caller opens it.
+*/
+const OTC_RFQ_WS_CLIENT_ENDPOINTS = {
+	local: "wss://otc.test.nado-backend.xyz/v1/rfqs/ws",
+	inkTestnet: "wss://otc.test.nado-backend.xyz/v1/rfqs/ws",
+	inkMainnet: "wss://otc.prod.nado-backend.xyz/v1/rfqs/ws"
+};
+//#endregion
+exports.OTC_CLIENT_ENDPOINTS = OTC_CLIENT_ENDPOINTS;
+exports.OTC_RFQ_WS_CLIENT_ENDPOINTS = OTC_RFQ_WS_CLIENT_ENDPOINTS;
+
+//# sourceMappingURL=endpoints.cjs.map

package/dist/endpoints.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.cjs","names":[],"sources":["../src/endpoints.ts"],"sourcesContent":["import { ChainEnv } from '@nadohq/shared';\n\n/**\n * OTC service origin per chain env. `local` uses the testnet service; there is no localhost\n * deployment.\n */\nexport const OTC_CLIENT_ENDPOINTS: Record<ChainEnv, string> = {\n  local: 'https://otc.test.nado-backend.xyz',\n  inkTestnet: 'https://otc.test.nado-backend.xyz',\n  inkMainnet: 'https://otc.prod.nado-backend.xyz',\n};\n\n/**\n * Taker quote socket per chain env. The caller opens it.\n */\nexport const OTC_RFQ_WS_CLIENT_ENDPOINTS: Record<ChainEnv, string> = {\n  local: 'wss://otc.test.nado-backend.xyz/v1/rfqs/ws',\n  inkTestnet: 'wss://otc.test.nado-backend.xyz/v1/rfqs/ws',\n  inkMainnet: 'wss://otc.prod.nado-backend.xyz/v1/rfqs/ws',\n};\n"],"mappings":";;;;;;AAMA,MAAa,uBAAiD;CAC5D,OAAO;CACP,YAAY;CACZ,YAAY;AACd;;;;AAKA,MAAa,8BAAwD;CACnE,OAAO;CACP,YAAY;CACZ,YAAY;AACd"}

package/dist/endpoints.d.cts

@@ -0,0 +1,15 @@
+import { ChainEnv } from "@nadohq/shared";
+
+//#region src/endpoints.d.ts
+/**
+ * OTC service origin per chain env. `local` uses the testnet service; there is no localhost
+ * deployment.
+ */
+declare const OTC_CLIENT_ENDPOINTS: Record<ChainEnv, string>;
+/**
+ * Taker quote socket per chain env. The caller opens it.
+ */
+declare const OTC_RFQ_WS_CLIENT_ENDPOINTS: Record<ChainEnv, string>;
+//#endregion
+export { OTC_CLIENT_ENDPOINTS, OTC_RFQ_WS_CLIENT_ENDPOINTS };
+//# sourceMappingURL=endpoints.d.cts.map

package/dist/endpoints.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.cts","names":[],"sources":["../src/src/endpoints.ts"],"mappings":";;;;;AAMA;;cAAa,oBAAA,EAAsB,MAAM,CAAC,QAAA;;AAAQ;AASlD;cAAa,2BAAA,EAA6B,MAAM,CAAC,QAAA"}

package/dist/endpoints.d.ts

@@ -0,0 +1,15 @@
+import { ChainEnv } from "@nadohq/shared";
+
+//#region src/endpoints.d.ts
+/**
+ * OTC service origin per chain env. `local` uses the testnet service; there is no localhost
+ * deployment.
+ */
+declare const OTC_CLIENT_ENDPOINTS: Record<ChainEnv, string>;
+/**
+ * Taker quote socket per chain env. The caller opens it.
+ */
+declare const OTC_RFQ_WS_CLIENT_ENDPOINTS: Record<ChainEnv, string>;
+//#endregion
+export { OTC_CLIENT_ENDPOINTS, OTC_RFQ_WS_CLIENT_ENDPOINTS };
+//# sourceMappingURL=endpoints.d.ts.map

package/dist/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","names":[],"sources":["../src/src/endpoints.ts"],"mappings":";;;;;AAMA;;cAAa,oBAAA,EAAsB,MAAM,CAAC,QAAA;;AAAQ;AASlD;cAAa,2BAAA,EAA6B,MAAM,CAAC,QAAA"}

package/dist/endpoints.js

@@ -0,0 +1,22 @@
+//#region src/endpoints.ts
+/**
+* OTC service origin per chain env. `local` uses the testnet service; there is no localhost
+* deployment.
+*/
+const OTC_CLIENT_ENDPOINTS = {
+	local: "https://otc.test.nado-backend.xyz",
+	inkTestnet: "https://otc.test.nado-backend.xyz",
+	inkMainnet: "https://otc.prod.nado-backend.xyz"
+};
+/**
+* Taker quote socket per chain env. The caller opens it.
+*/
+const OTC_RFQ_WS_CLIENT_ENDPOINTS = {
+	local: "wss://otc.test.nado-backend.xyz/v1/rfqs/ws",
+	inkTestnet: "wss://otc.test.nado-backend.xyz/v1/rfqs/ws",
+	inkMainnet: "wss://otc.prod.nado-backend.xyz/v1/rfqs/ws"
+};
+//#endregion
+export { OTC_CLIENT_ENDPOINTS, OTC_RFQ_WS_CLIENT_ENDPOINTS };
+
+//# sourceMappingURL=endpoints.js.map

package/dist/endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.js","names":[],"sources":["../src/endpoints.ts"],"sourcesContent":["import { ChainEnv } from '@nadohq/shared';\n\n/**\n * OTC service origin per chain env. `local` uses the testnet service; there is no localhost\n * deployment.\n */\nexport const OTC_CLIENT_ENDPOINTS: Record<ChainEnv, string> = {\n  local: 'https://otc.test.nado-backend.xyz',\n  inkTestnet: 'https://otc.test.nado-backend.xyz',\n  inkMainnet: 'https://otc.prod.nado-backend.xyz',\n};\n\n/**\n * Taker quote socket per chain env. The caller opens it.\n */\nexport const OTC_RFQ_WS_CLIENT_ENDPOINTS: Record<ChainEnv, string> = {\n  local: 'wss://otc.test.nado-backend.xyz/v1/rfqs/ws',\n  inkTestnet: 'wss://otc.test.nado-backend.xyz/v1/rfqs/ws',\n  inkMainnet: 'wss://otc.prod.nado-backend.xyz/v1/rfqs/ws',\n};\n"],"mappings":";;;;;AAMA,MAAa,uBAAiD;CAC5D,OAAO;CACP,YAAY;CACZ,YAAY;AACd;;;;AAKA,MAAa,8BAAwD;CACnE,OAAO;CACP,YAAY;CACZ,YAAY;AACd"}

package/dist/index.cjs

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_OtcClient = require("./OtcClient-qUPYb1BP.cjs");
+const require_endpoints = require("./endpoints.cjs");
+const require_rfqSubscription = require("./rfqSubscription.cjs");
+require("./types/index.cjs");
+exports.OTC_CLIENT_ENDPOINTS = require_endpoints.OTC_CLIENT_ENDPOINTS;
+exports.OTC_RFQ_WS_CLIENT_ENDPOINTS = require_endpoints.OTC_RFQ_WS_CLIENT_ENDPOINTS;
+exports.OtcClient = require_OtcClient.OtcClient;
+exports.buildOtcRfqSubscriptionMessage = require_rfqSubscription.buildOtcRfqSubscriptionMessage;

package/dist/index.d.cts

@@ -0,0 +1,6 @@
+import { a as OtcServerExecutionSuccess, c as OtcServerQuoteStream, d as OtcServerRfqSubscribeStreamRequest, f as OtcServerRfqSubscribeStreamsRequest, h as OtcServerRfqUnsubscribeStreamsRequest, i as OtcServerExecutionResponse, l as OtcServerRfqAck, m as OtcServerRfqUnsubscribeStreamRequest, n as OtcServerExecutionFailure, o as OtcServerQuote, p as OtcServerRfqSubscriptionRequest, r as OtcServerExecutionPendingResolution, s as OtcServerQuoteBatch, t as OtcQuoteSizeUnit, u as OtcServerRfqMessage } from "./serverTypes-CZOJ78c_.cjs";
+import { a as OtcReadyResult, c as OtcRfqSubscriptionStreamsParams, i as OtcQuoteStream, l as OtcServerTakerOrderParams, n as OtcGetExecutionStatusParams, o as OtcRfqSubscriptionParams, r as OtcGetReadyParams, s as OtcRfqSubscriptionStreamParams, t as OtcExecuteParams } from "./clientTypes-B7w3RxqK.cjs";
+import { OtcClient, OtcClientOpts } from "./OtcClient.cjs";
+import { OTC_CLIENT_ENDPOINTS, OTC_RFQ_WS_CLIENT_ENDPOINTS } from "./endpoints.cjs";
+import { buildOtcRfqSubscriptionMessage } from "./rfqSubscription.cjs";
+export { OTC_CLIENT_ENDPOINTS, OTC_RFQ_WS_CLIENT_ENDPOINTS, OtcClient, OtcClientOpts, OtcExecuteParams, OtcGetExecutionStatusParams, OtcGetReadyParams, OtcQuoteSizeUnit, OtcQuoteStream, OtcReadyResult, OtcRfqSubscriptionParams, OtcRfqSubscriptionStreamParams, OtcRfqSubscriptionStreamsParams, OtcServerExecutionFailure, OtcServerExecutionPendingResolution, OtcServerExecutionResponse, OtcServerExecutionSuccess, OtcServerQuote, OtcServerQuoteBatch, OtcServerQuoteStream, OtcServerRfqAck, OtcServerRfqMessage, OtcServerRfqSubscribeStreamRequest, OtcServerRfqSubscribeStreamsRequest, OtcServerRfqSubscriptionRequest, OtcServerRfqUnsubscribeStreamRequest, OtcServerRfqUnsubscribeStreamsRequest, OtcServerTakerOrderParams, buildOtcRfqSubscriptionMessage };

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { a as OtcServerExecutionSuccess, c as OtcServerQuoteStream, d as OtcServerRfqSubscribeStreamRequest, f as OtcServerRfqSubscribeStreamsRequest, h as OtcServerRfqUnsubscribeStreamsRequest, i as OtcServerExecutionResponse, l as OtcServerRfqAck, m as OtcServerRfqUnsubscribeStreamRequest, n as OtcServerExecutionFailure, o as OtcServerQuote, p as OtcServerRfqSubscriptionRequest, r as OtcServerExecutionPendingResolution, s as OtcServerQuoteBatch, t as OtcQuoteSizeUnit, u as OtcServerRfqMessage } from "./serverTypes-CZOJ78c_.js";
+import { a as OtcReadyResult, c as OtcRfqSubscriptionStreamsParams, i as OtcQuoteStream, l as OtcServerTakerOrderParams, n as OtcGetExecutionStatusParams, o as OtcRfqSubscriptionParams, r as OtcGetReadyParams, s as OtcRfqSubscriptionStreamParams, t as OtcExecuteParams } from "./clientTypes-DVAoYtGx.js";
+import { OtcClient, OtcClientOpts } from "./OtcClient.js";
+import { OTC_CLIENT_ENDPOINTS, OTC_RFQ_WS_CLIENT_ENDPOINTS } from "./endpoints.js";
+import { buildOtcRfqSubscriptionMessage } from "./rfqSubscription.js";
+export { OTC_CLIENT_ENDPOINTS, OTC_RFQ_WS_CLIENT_ENDPOINTS, OtcClient, OtcClientOpts, OtcExecuteParams, OtcGetExecutionStatusParams, OtcGetReadyParams, OtcQuoteSizeUnit, OtcQuoteStream, OtcReadyResult, OtcRfqSubscriptionParams, OtcRfqSubscriptionStreamParams, OtcRfqSubscriptionStreamsParams, OtcServerExecutionFailure, OtcServerExecutionPendingResolution, OtcServerExecutionResponse, OtcServerExecutionSuccess, OtcServerQuote, OtcServerQuoteBatch, OtcServerQuoteStream, OtcServerRfqAck, OtcServerRfqMessage, OtcServerRfqSubscribeStreamRequest, OtcServerRfqSubscribeStreamsRequest, OtcServerRfqSubscriptionRequest, OtcServerRfqUnsubscribeStreamRequest, OtcServerRfqUnsubscribeStreamsRequest, OtcServerTakerOrderParams, buildOtcRfqSubscriptionMessage };

package/dist/index.js

@@ -0,0 +1,5 @@
+import { OtcClient } from "./OtcClient.js";
+import { OTC_CLIENT_ENDPOINTS, OTC_RFQ_WS_CLIENT_ENDPOINTS } from "./endpoints.js";
+import { buildOtcRfqSubscriptionMessage } from "./rfqSubscription.js";
+import "./types/index.js";
+export { OTC_CLIENT_ENDPOINTS, OTC_RFQ_WS_CLIENT_ENDPOINTS, OtcClient, buildOtcRfqSubscriptionMessage };

package/dist/rfqSubscription.cjs

@@ -0,0 +1,28 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/rfqSubscription.ts
+function toServerStream(stream) {
+	return {
+		type: "quote",
+		product_id: stream.productId,
+		wallet: stream.wallet,
+		size: stream.size,
+		size_unit: stream.sizeUnit,
+		...stream.pricerId ? { pricer_id: stream.pricerId } : {}
+	};
+}
+/**
+* Builds a subscribe or unsubscribe message for the RFQ socket.
+* `unsubscribe` uses the same stream fields as the original `subscribe`.
+*/
+function buildOtcRfqSubscriptionMessage(method, params) {
+	const body = "stream" in params ? { stream: toServerStream(params.stream) } : { streams: params.streams.map(toServerStream) };
+	return {
+		method,
+		id: params.id,
+		...body
+	};
+}
+//#endregion
+exports.buildOtcRfqSubscriptionMessage = buildOtcRfqSubscriptionMessage;
+
+//# sourceMappingURL=rfqSubscription.cjs.map