@symmio/trading-core 0.1.0

package/dist/quotes/upnl/calculate-quote-pnl.d.ts

@@ -0,0 +1,45 @@
+import { PositionType } from '../../symmio-contracts/symmio/types';
+/**
+ * Inputs for {@link calculateQuotePnl}. Bigint fields are 18-decimal wei.
+ */
+export interface CalculateQuotePnlInputs {
+    positionType: PositionType;
+    /** Already-closed quantity, wei. */
+    closedAmount: bigint;
+    /** Average close price for the realized closes, wei. */
+    closedPrice: bigint;
+    /** Original opened price, wei. */
+    openedPrice: bigint;
+    /** Decimal-string leverage. */
+    leverage: string;
+}
+/**
+ * Return value of {@link calculateQuotePnl}.
+ */
+export interface CalculateQuotePnlReturnType {
+    /** Realized PNL in collateral units, decimal string. `"0"` when nothing has closed. */
+    pnl: string;
+    /** Decimal percent (e.g. `"12.34"`). `"0"` when indeterminate. */
+    pnlPercent: string;
+}
+/**
+ * Realized PNL for a single quote — i.e. the closed-out portion only.
+ *
+ * - `sideSign = positionType === SHORT ? -1 : 1`
+ * - `pnl = closedAmount × (closedPrice − openedPrice) × sideSign`
+ * - `pnlPercent = pnl / closedAmount / openedPrice × leverage × 100`
+ *   (only when `closedAmount > 0` and `openedPrice > 0`; else `"0"`).
+ *
+ * @example
+ * ```ts
+ * const { pnl, pnlPercent } = calculateQuotePnl({
+ *   positionType: PositionType.LONG,
+ *   closedAmount: 50n * 10n ** 18n,
+ *   closedPrice: 90_000_000_000_000_000n,        // 0.09
+ *   openedPrice: 80_000_000_000_000_000n,        // 0.08
+ *   leverage: "10",
+ * });
+ * ```
+ */
+export declare function calculateQuotePnl(inputs: CalculateQuotePnlInputs): CalculateQuotePnlReturnType;
+//# sourceMappingURL=calculate-quote-pnl.d.ts.map

package/dist/quotes/upnl/calculate-quote-pnl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate-quote-pnl.d.ts","sourceRoot":"","sources":["../../../src/quotes/upnl/calculate-quote-pnl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAInE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,YAAY,CAAC;IAC3B,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,2BAA2B,CA0B9F"}

package/dist/quotes/upnl/calculate-quote-pnl.js

@@ -0,0 +1,32 @@
+import { PositionType as e } from "../../symmio-contracts/symmio/types.js";
+import { formatUnits as t } from "viem";
+//#region src/quotes/upnl/calculate-quote-pnl.ts
+var n = 18;
+function r(r) {
+	let i = Number(t(r.closedAmount, n)), a = Number(t(r.closedPrice, n)), o = Number(t(r.openedPrice, n)), s = Number(r.leverage), c = r.positionType === e.SHORT ? -1 : 1;
+	if (!Number.isFinite(i) || !Number.isFinite(a) || !Number.isFinite(o) || i <= 0) return {
+		pnl: "0",
+		pnlPercent: "0"
+	};
+	let l = i * (a - o) * c;
+	if (!Number.isFinite(l)) return {
+		pnl: "0",
+		pnlPercent: "0"
+	};
+	if (o <= 0 || !Number.isFinite(s)) return {
+		pnl: String(l),
+		pnlPercent: "0"
+	};
+	let u = l / i / o * s * 100;
+	return Number.isFinite(u) ? {
+		pnl: String(l),
+		pnlPercent: u.toFixed(2)
+	} : {
+		pnl: String(l),
+		pnlPercent: "0"
+	};
+}
+//#endregion
+export { r as calculateQuotePnl };
+
+//# sourceMappingURL=calculate-quote-pnl.js.map

package/dist/quotes/upnl/calculate-quote-pnl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate-quote-pnl.js","names":[],"sources":["../../../src/quotes/upnl/calculate-quote-pnl.ts"],"sourcesContent":["import { formatUnits } from \"viem\";\nimport { PositionType } from \"../../symmio-contracts/symmio/types\";\n\nconst WEI_DECIMALS = 18;\n\n/**\n * Inputs for {@link calculateQuotePnl}. Bigint fields are 18-decimal wei.\n */\nexport interface CalculateQuotePnlInputs {\n  positionType: PositionType;\n  /** Already-closed quantity, wei. */\n  closedAmount: bigint;\n  /** Average close price for the realized closes, wei. */\n  closedPrice: bigint;\n  /** Original opened price, wei. */\n  openedPrice: bigint;\n  /** Decimal-string leverage. */\n  leverage: string;\n}\n\n/**\n * Return value of {@link calculateQuotePnl}.\n */\nexport interface CalculateQuotePnlReturnType {\n  /** Realized PNL in collateral units, decimal string. `\"0\"` when nothing has closed. */\n  pnl: string;\n  /** Decimal percent (e.g. `\"12.34\"`). `\"0\"` when indeterminate. */\n  pnlPercent: string;\n}\n\n/**\n * Realized PNL for a single quote — i.e. the closed-out portion only.\n *\n * - `sideSign = positionType === SHORT ? -1 : 1`\n * - `pnl = closedAmount × (closedPrice − openedPrice) × sideSign`\n * - `pnlPercent = pnl / closedAmount / openedPrice × leverage × 100`\n *   (only when `closedAmount > 0` and `openedPrice > 0`; else `\"0\"`).\n *\n * @example\n * ```ts\n * const { pnl, pnlPercent } = calculateQuotePnl({\n *   positionType: PositionType.LONG,\n *   closedAmount: 50n * 10n ** 18n,\n *   closedPrice: 90_000_000_000_000_000n,        // 0.09\n *   openedPrice: 80_000_000_000_000_000n,        // 0.08\n *   leverage: \"10\",\n * });\n * ```\n */\nexport function calculateQuotePnl(inputs: CalculateQuotePnlInputs): CalculateQuotePnlReturnType {\n  const closedAmount = Number(formatUnits(inputs.closedAmount, WEI_DECIMALS));\n  const closedPrice = Number(formatUnits(inputs.closedPrice, WEI_DECIMALS));\n  const openedPrice = Number(formatUnits(inputs.openedPrice, WEI_DECIMALS));\n  const leverage = Number(inputs.leverage);\n  const sideSign = inputs.positionType === PositionType.SHORT ? -1 : 1;\n\n  if (\n    !Number.isFinite(closedAmount) ||\n    !Number.isFinite(closedPrice) ||\n    !Number.isFinite(openedPrice) ||\n    closedAmount <= 0\n  ) {\n    return { pnl: \"0\", pnlPercent: \"0\" };\n  }\n\n  const pnl = closedAmount * (closedPrice - openedPrice) * sideSign;\n  if (!Number.isFinite(pnl)) return { pnl: \"0\", pnlPercent: \"0\" };\n\n  if (openedPrice <= 0 || !Number.isFinite(leverage)) {\n    return { pnl: String(pnl), pnlPercent: \"0\" };\n  }\n  const pnlPercent = (pnl / closedAmount / openedPrice) * leverage * 100;\n  if (!Number.isFinite(pnlPercent)) return { pnl: String(pnl), pnlPercent: \"0\" };\n\n  return { pnl: String(pnl), pnlPercent: pnlPercent.toFixed(2) };\n}\n"],"mappings":";;;AAGA,IAAM,IAAe;AA8CrB,SAAgB,EAAkB,GAA8D;CAC9F,IAAM,IAAe,OAAO,EAAY,EAAO,cAAc,CAAY,CAAC,GACpE,IAAc,OAAO,EAAY,EAAO,aAAa,CAAY,CAAC,GAClE,IAAc,OAAO,EAAY,EAAO,aAAa,CAAY,CAAC,GAClE,IAAW,OAAO,EAAO,QAAQ,GACjC,IAAW,EAAO,iBAAiB,EAAa,QAAQ,KAAK;CAEnE,IACE,CAAC,OAAO,SAAS,CAAY,KAC7B,CAAC,OAAO,SAAS,CAAW,KAC5B,CAAC,OAAO,SAAS,CAAW,KAC5B,KAAgB,GAEhB,OAAO;EAAE,KAAK;EAAK,YAAY;CAAI;CAGrC,IAAM,IAAM,KAAgB,IAAc,KAAe;CACzD,IAAI,CAAC,OAAO,SAAS,CAAG,GAAG,OAAO;EAAE,KAAK;EAAK,YAAY;CAAI;CAE9D,IAAI,KAAe,KAAK,CAAC,OAAO,SAAS,CAAQ,GAC/C,OAAO;EAAE,KAAK,OAAO,CAAG;EAAG,YAAY;CAAI;CAE7C,IAAM,IAAc,IAAM,IAAe,IAAe,IAAW;CAGnE,OAFK,OAAO,SAAS,CAAU,IAExB;EAAE,KAAK,OAAO,CAAG;EAAG,YAAY,EAAW,QAAQ,CAAC;CAAE,IAFpB;EAAE,KAAK,OAAO,CAAG;EAAG,YAAY;CAAI;AAG/E"}

package/dist/quotes/upnl/calculate-quote-upnl.d.ts

@@ -0,0 +1,52 @@
+import { PositionType } from '../../symmio-contracts/symmio/types';
+/**
+ * Inputs for {@link calculateQuoteUpnl}. Bigint fields are 18-decimal wei.
+ */
+export interface CalculateQuoteUpnlInputs {
+    /** Decimal-string mark price for the quote's market. */
+    markPrice: string;
+    positionType: PositionType;
+    /** Original quote quantity, wei. */
+    quantity: bigint;
+    /** Already-closed quantity, wei. */
+    closedAmount: bigint;
+    /** Quote's opened price, wei. */
+    openedPrice: bigint;
+    /** Decimal-string leverage. Used for the percent term. */
+    leverage: string;
+}
+/**
+ * Return value of {@link calculateQuoteUpnl}.
+ */
+export interface CalculateQuoteUpnlReturnType {
+    /** Unrealized PNL in collateral units, decimal string. `"0"` when no open size. */
+    upnl: string;
+    /** Decimal percent (e.g. `"12.34"`). `"0"` when indeterminate. */
+    upnlPercent: string;
+}
+/**
+ * Unrealized PNL for a single quote against the current mark price.
+ *
+ * - `openQty = quantity − closedAmount`
+ * - `sideSign = positionType === SHORT ? -1 : 1`
+ * - `upnl = openQty × (markPrice − openedPrice) × sideSign`
+ * - `upnlPercent = upnl / openQty / openedPrice × leverage × 100`
+ *   (only when `openQty > 0` and `openedPrice > 0`; else `"0"`).
+ *
+ * All wei inputs are normalized to decimals (`formatUnits(value, 18)`) before
+ * the math. Returns `"0"` for any non-finite intermediate.
+ *
+ * @example
+ * ```ts
+ * const { upnl, upnlPercent } = calculateQuoteUpnl({
+ *   markPrice: "0.0085",
+ *   positionType: PositionType.LONG,
+ *   quantity: 100n * 10n ** 18n,
+ *   closedAmount: 0n,
+ *   openedPrice: 80_000_000_000_000_000n,        // 0.08
+ *   leverage: "10",
+ * });
+ * ```
+ */
+export declare function calculateQuoteUpnl(inputs: CalculateQuoteUpnlInputs): CalculateQuoteUpnlReturnType;
+//# sourceMappingURL=calculate-quote-upnl.d.ts.map

package/dist/quotes/upnl/calculate-quote-upnl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate-quote-upnl.d.ts","sourceRoot":"","sources":["../../../src/quotes/upnl/calculate-quote-upnl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAInE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,4BAA4B,CAqBjG"}

package/dist/quotes/upnl/calculate-quote-upnl.js

@@ -0,0 +1,32 @@
+import { PositionType as e } from "../../symmio-contracts/symmio/types.js";
+import { formatUnits as t } from "viem";
+//#region src/quotes/upnl/calculate-quote-upnl.ts
+var n = 18;
+function r(r) {
+	let i = Number(r.markPrice), a = Number(t(r.openedPrice, n)), o = Number(t(r.quantity - r.closedAmount, n)), s = Number(r.leverage), c = r.positionType === e.SHORT ? -1 : 1;
+	if (!Number.isFinite(i) || !Number.isFinite(a) || !Number.isFinite(o) || o <= 0) return {
+		upnl: "0",
+		upnlPercent: "0"
+	};
+	let l = o * (i - a) * c;
+	if (!Number.isFinite(l)) return {
+		upnl: "0",
+		upnlPercent: "0"
+	};
+	if (a <= 0 || !Number.isFinite(s)) return {
+		upnl: String(l),
+		upnlPercent: "0"
+	};
+	let u = l / o / a * s * 100;
+	return Number.isFinite(u) ? {
+		upnl: String(l),
+		upnlPercent: u.toFixed(2)
+	} : {
+		upnl: String(l),
+		upnlPercent: "0"
+	};
+}
+//#endregion
+export { r as calculateQuoteUpnl };
+
+//# sourceMappingURL=calculate-quote-upnl.js.map

package/dist/quotes/upnl/calculate-quote-upnl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate-quote-upnl.js","names":[],"sources":["../../../src/quotes/upnl/calculate-quote-upnl.ts"],"sourcesContent":["import { formatUnits } from \"viem\";\nimport { PositionType } from \"../../symmio-contracts/symmio/types\";\n\nconst WEI_DECIMALS = 18;\n\n/**\n * Inputs for {@link calculateQuoteUpnl}. Bigint fields are 18-decimal wei.\n */\nexport interface CalculateQuoteUpnlInputs {\n  /** Decimal-string mark price for the quote's market. */\n  markPrice: string;\n  positionType: PositionType;\n  /** Original quote quantity, wei. */\n  quantity: bigint;\n  /** Already-closed quantity, wei. */\n  closedAmount: bigint;\n  /** Quote's opened price, wei. */\n  openedPrice: bigint;\n  /** Decimal-string leverage. Used for the percent term. */\n  leverage: string;\n}\n\n/**\n * Return value of {@link calculateQuoteUpnl}.\n */\nexport interface CalculateQuoteUpnlReturnType {\n  /** Unrealized PNL in collateral units, decimal string. `\"0\"` when no open size. */\n  upnl: string;\n  /** Decimal percent (e.g. `\"12.34\"`). `\"0\"` when indeterminate. */\n  upnlPercent: string;\n}\n\n/**\n * Unrealized PNL for a single quote against the current mark price.\n *\n * - `openQty = quantity − closedAmount`\n * - `sideSign = positionType === SHORT ? -1 : 1`\n * - `upnl = openQty × (markPrice − openedPrice) × sideSign`\n * - `upnlPercent = upnl / openQty / openedPrice × leverage × 100`\n *   (only when `openQty > 0` and `openedPrice > 0`; else `\"0\"`).\n *\n * All wei inputs are normalized to decimals (`formatUnits(value, 18)`) before\n * the math. Returns `\"0\"` for any non-finite intermediate.\n *\n * @example\n * ```ts\n * const { upnl, upnlPercent } = calculateQuoteUpnl({\n *   markPrice: \"0.0085\",\n *   positionType: PositionType.LONG,\n *   quantity: 100n * 10n ** 18n,\n *   closedAmount: 0n,\n *   openedPrice: 80_000_000_000_000_000n,        // 0.08\n *   leverage: \"10\",\n * });\n * ```\n */\nexport function calculateQuoteUpnl(inputs: CalculateQuoteUpnlInputs): CalculateQuoteUpnlReturnType {\n  const markPrice = Number(inputs.markPrice);\n  const openedPrice = Number(formatUnits(inputs.openedPrice, WEI_DECIMALS));\n  const openQty = Number(formatUnits(inputs.quantity - inputs.closedAmount, WEI_DECIMALS));\n  const leverage = Number(inputs.leverage);\n  const sideSign = inputs.positionType === PositionType.SHORT ? -1 : 1;\n\n  if (!Number.isFinite(markPrice) || !Number.isFinite(openedPrice) || !Number.isFinite(openQty) || openQty <= 0) {\n    return { upnl: \"0\", upnlPercent: \"0\" };\n  }\n\n  const upnl = openQty * (markPrice - openedPrice) * sideSign;\n  if (!Number.isFinite(upnl)) return { upnl: \"0\", upnlPercent: \"0\" };\n\n  if (openedPrice <= 0 || !Number.isFinite(leverage)) {\n    return { upnl: String(upnl), upnlPercent: \"0\" };\n  }\n  const upnlPercent = (upnl / openQty / openedPrice) * leverage * 100;\n  if (!Number.isFinite(upnlPercent)) return { upnl: String(upnl), upnlPercent: \"0\" };\n\n  return { upnl: String(upnl), upnlPercent: upnlPercent.toFixed(2) };\n}\n"],"mappings":";;;AAGA,IAAM,IAAe;AAqDrB,SAAgB,EAAmB,GAAgE;CACjG,IAAM,IAAY,OAAO,EAAO,SAAS,GACnC,IAAc,OAAO,EAAY,EAAO,aAAa,CAAY,CAAC,GAClE,IAAU,OAAO,EAAY,EAAO,WAAW,EAAO,cAAc,CAAY,CAAC,GACjF,IAAW,OAAO,EAAO,QAAQ,GACjC,IAAW,EAAO,iBAAiB,EAAa,QAAQ,KAAK;CAEnE,IAAI,CAAC,OAAO,SAAS,CAAS,KAAK,CAAC,OAAO,SAAS,CAAW,KAAK,CAAC,OAAO,SAAS,CAAO,KAAK,KAAW,GAC1G,OAAO;EAAE,MAAM;EAAK,aAAa;CAAI;CAGvC,IAAM,IAAO,KAAW,IAAY,KAAe;CACnD,IAAI,CAAC,OAAO,SAAS,CAAI,GAAG,OAAO;EAAE,MAAM;EAAK,aAAa;CAAI;CAEjE,IAAI,KAAe,KAAK,CAAC,OAAO,SAAS,CAAQ,GAC/C,OAAO;EAAE,MAAM,OAAO,CAAI;EAAG,aAAa;CAAI;CAEhD,IAAM,IAAe,IAAO,IAAU,IAAe,IAAW;CAGhE,OAFK,OAAO,SAAS,CAAW,IAEzB;EAAE,MAAM,OAAO,CAAI;EAAG,aAAa,EAAY,QAAQ,CAAC;CAAE,IAFvB;EAAE,MAAM,OAAO,CAAI;EAAG,aAAa;CAAI;AAGnF"}

package/dist/quotes/upnl/index.d.ts

@@ -0,0 +1,4 @@
+export * from './calculate-quote-leverage';
+export * from './calculate-quote-pnl';
+export * from './calculate-quote-upnl';
+//# sourceMappingURL=index.d.ts.map

package/dist/quotes/upnl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/quotes/upnl/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}

package/dist/shared/errors/symm-error.d.ts

@@ -0,0 +1,94 @@
+import { AxiosError } from 'axios';
+/**
+ * Broad classification of SDK errors.
+ *
+ * - `config` — SDK configuration issues (missing chain, no wallet client).
+ * - `api` — HTTP/REST API failures (solver, price service).
+ * - `validation` — Input validation failures (missing required params).
+ */
+export type SymmErrorKind = "config" | "api" | "validation";
+/**
+ * Base error class for SDK-level failures.
+ *
+ * Every SDK error includes:
+ * - `kind` — broad category for error handling branches
+ * - `code` — specific error identifier within that kind
+ *
+ * On-chain failures surface as viem errors and are not wrapped.
+ */
+export declare class SymmError extends Error {
+    readonly name: string;
+    /** Broad classification (e.g., "config", "api", "validation"). */
+    readonly kind: SymmErrorKind;
+    /** Specific error identifier (e.g., "UNSUPPORTED_CHAIN", "MISSING_USER"). */
+    readonly code: string;
+    constructor(kind: SymmErrorKind, code: string, message: string, options?: ErrorOptions);
+}
+/**
+ * Error class for HTTP/API failures from solver or other REST endpoints.
+ *
+ * Captures full request/response context for debugging and error handling.
+ * Always has `kind: "api"`.
+ */
+export declare class SymmApiError extends SymmError {
+    /** HTTP status code (e.g., 400, 401, 500). */
+    readonly status: number;
+    /** HTTP status text (e.g., "Bad Request", "Unauthorized"). */
+    readonly statusText: string;
+    /**
+     * Raw response body from the server.
+     *
+     * For solver/hedger endpoints this is typically the documented
+     * `XfiberErrorResponse`-style payload: `{code?, error_category?,
+     * error_message?, error_detail?}`. Consumers cast it to the shape they expect
+     * and render whatever fields they care about.
+     */
+    readonly responseData: unknown;
+    /** Request URL that failed. */
+    readonly url: string;
+    /** HTTP method (e.g., "GET", "POST"). */
+    readonly method: string;
+    constructor(options: {
+        code: string;
+        message: string;
+        status: number;
+        statusText: string;
+        responseData?: unknown;
+        url: string;
+        method: string;
+        cause?: Error;
+    });
+    /**
+     * Build a `SymmApiError` from an axios error.
+     *
+     * Pulls `status`, `statusText`, `url`, `method`, and `responseData` off the
+     * axios error and keeps the original axios error as `cause`. The composed
+     * message is `"<code>: <axios message> (<METHOD> <URL> → <status> <statusText>)"`
+     * so a single log line carries the code, original message, and request
+     * coordinates.
+     *
+     * Use inside an action's `catch` after re-throwing any pre-existing
+     * `SymmError`:
+     *
+     * @example
+     * ```ts
+     * try {
+     *   const response = await getMarketsApi({ baseURL });
+     *   return response.data;
+     * } catch (err) {
+     *   if (err instanceof SymmError) throw err;
+     *   if (isAxiosError(err)) {
+     *     throw SymmApiError.fromAxios(err, { code: "FETCH_MARKETS_FAILED", baseURL });
+     *   }
+     *   throw new SymmError("api", "FETCH_MARKETS_FAILED", `Failed to fetch markets: ${String(err)}`);
+     * }
+     * ```
+     */
+    static fromAxios(err: AxiosError, options: {
+        /** Specific error identifier (e.g., `"FETCH_MARKETS_FAILED"`). */
+        code: string;
+        /** Base URL of the request; combined with `err.config.url` for the full URL. */
+        baseURL: string;
+    }): SymmApiError;
+}
+//# sourceMappingURL=symm-error.d.ts.map

package/dist/shared/errors/symm-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symm-error.d.ts","sourceRoot":"","sources":["../../../src/shared/errors/symm-error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,YAAY,CAAC;AAE5D;;;;;;;;GAQG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,SAAkB,IAAI,EAAE,MAAM,CAAe;IAE7C,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAE7B,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKvF;AAED,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAE/B,+BAA+B;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;IASD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CAAC,SAAS,CACd,GAAG,EAAE,UAAU,EACf,OAAO,EAAE;QACP,kEAAkE;QAClE,IAAI,EAAE,MAAM,CAAC;QACb,gFAAgF;QAChF,OAAO,EAAE,MAAM,CAAC;KACjB,GACA,YAAY;CAiBhB"}

package/dist/shared/errors/symm-error.js

@@ -0,0 +1,35 @@
+//#region src/shared/errors/symm-error.ts
+var e = class extends Error {
+	name = "SymmError";
+	kind;
+	code;
+	constructor(e, t, n, r) {
+		super(n, r), this.kind = e, this.code = t;
+	}
+}, t = class t extends e {
+	status;
+	statusText;
+	responseData;
+	url;
+	method;
+	constructor(e) {
+		super("api", e.code, e.message, { cause: e.cause }), this.status = e.status, this.statusText = e.statusText, this.responseData = e.responseData, this.url = e.url, this.method = e.method;
+	}
+	static fromAxios(e, n) {
+		let r = e.response?.status ?? 0, i = e.response?.statusText ?? "Unknown", a = e.config?.url ? `${n.baseURL}${e.config.url}` : n.baseURL, o = e.config?.method?.toUpperCase() ?? "GET";
+		return new t({
+			code: n.code,
+			message: `${n.code}: ${e.message} (${o} ${a} → ${r} ${i})`,
+			status: r,
+			statusText: i,
+			responseData: e.response?.data,
+			url: a,
+			method: o,
+			cause: e
+		});
+	}
+};
+//#endregion
+export { t as SymmApiError, e as SymmError };
+
+//# sourceMappingURL=symm-error.js.map

package/dist/shared/errors/symm-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symm-error.js","names":[],"sources":["../../../src/shared/errors/symm-error.ts"],"sourcesContent":["/**\n * Broad classification of SDK errors.\n *\n * - `config` — SDK configuration issues (missing chain, no wallet client).\n * - `api` — HTTP/REST API failures (solver, price service).\n * - `validation` — Input validation failures (missing required params).\n */\nexport type SymmErrorKind = \"config\" | \"api\" | \"validation\";\n\n/**\n * Base error class for SDK-level failures.\n *\n * Every SDK error includes:\n * - `kind` — broad category for error handling branches\n * - `code` — specific error identifier within that kind\n *\n * On-chain failures surface as viem errors and are not wrapped.\n */\nexport class SymmError extends Error {\n  override readonly name: string = \"SymmError\";\n\n  /** Broad classification (e.g., \"config\", \"api\", \"validation\"). */\n  readonly kind: SymmErrorKind;\n\n  /** Specific error identifier (e.g., \"UNSUPPORTED_CHAIN\", \"MISSING_USER\"). */\n  readonly code: string;\n\n  constructor(kind: SymmErrorKind, code: string, message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.kind = kind;\n    this.code = code;\n  }\n}\n\nimport type { AxiosError } from \"axios\";\n\n/**\n * Error class for HTTP/API failures from solver or other REST endpoints.\n *\n * Captures full request/response context for debugging and error handling.\n * Always has `kind: \"api\"`.\n */\nexport class SymmApiError extends SymmError {\n  /** HTTP status code (e.g., 400, 401, 500). */\n  readonly status: number;\n\n  /** HTTP status text (e.g., \"Bad Request\", \"Unauthorized\"). */\n  readonly statusText: string;\n\n  /**\n   * Raw response body from the server.\n   *\n   * For solver/hedger endpoints this is typically the documented\n   * `XfiberErrorResponse`-style payload: `{code?, error_category?,\n   * error_message?, error_detail?}`. Consumers cast it to the shape they expect\n   * and render whatever fields they care about.\n   */\n  readonly responseData: unknown;\n\n  /** Request URL that failed. */\n  readonly url: string;\n\n  /** HTTP method (e.g., \"GET\", \"POST\"). */\n  readonly method: string;\n\n  constructor(options: {\n    code: string;\n    message: string;\n    status: number;\n    statusText: string;\n    responseData?: unknown;\n    url: string;\n    method: string;\n    cause?: Error;\n  }) {\n    super(\"api\", options.code, options.message, { cause: options.cause });\n    this.status = options.status;\n    this.statusText = options.statusText;\n    this.responseData = options.responseData;\n    this.url = options.url;\n    this.method = options.method;\n  }\n\n  /**\n   * Build a `SymmApiError` from an axios error.\n   *\n   * Pulls `status`, `statusText`, `url`, `method`, and `responseData` off the\n   * axios error and keeps the original axios error as `cause`. The composed\n   * message is `\"<code>: <axios message> (<METHOD> <URL> → <status> <statusText>)\"`\n   * so a single log line carries the code, original message, and request\n   * coordinates.\n   *\n   * Use inside an action's `catch` after re-throwing any pre-existing\n   * `SymmError`:\n   *\n   * @example\n   * ```ts\n   * try {\n   *   const response = await getMarketsApi({ baseURL });\n   *   return response.data;\n   * } catch (err) {\n   *   if (err instanceof SymmError) throw err;\n   *   if (isAxiosError(err)) {\n   *     throw SymmApiError.fromAxios(err, { code: \"FETCH_MARKETS_FAILED\", baseURL });\n   *   }\n   *   throw new SymmError(\"api\", \"FETCH_MARKETS_FAILED\", `Failed to fetch markets: ${String(err)}`);\n   * }\n   * ```\n   */\n  static fromAxios(\n    err: AxiosError,\n    options: {\n      /** Specific error identifier (e.g., `\"FETCH_MARKETS_FAILED\"`). */\n      code: string;\n      /** Base URL of the request; combined with `err.config.url` for the full URL. */\n      baseURL: string;\n    },\n  ): SymmApiError {\n    const status = err.response?.status ?? 0;\n    const statusText = err.response?.statusText ?? \"Unknown\";\n    const url = err.config?.url ? `${options.baseURL}${err.config.url}` : options.baseURL;\n    const method = err.config?.method?.toUpperCase() ?? \"GET\";\n\n    return new SymmApiError({\n      code: options.code,\n      message: `${options.code}: ${err.message} (${method} ${url} → ${status} ${statusText})`,\n      status,\n      statusText,\n      responseData: err.response?.data,\n      url,\n      method,\n      cause: err,\n    });\n  }\n}\n"],"mappings":";AAkBA,IAAa,IAAb,cAA+B,MAAM;CACnC,OAAiC;CAGjC;CAGA;CAEA,YAAY,GAAqB,GAAc,GAAiB,GAAwB;EAGtF,AAFA,MAAM,GAAS,CAAO,GACtB,KAAK,OAAO,GACZ,KAAK,OAAO;CACd;AACF,GAUa,IAAb,MAAa,UAAqB,EAAU;CAE1C;CAGA;CAUA;CAGA;CAGA;CAEA,YAAY,GAST;EAMD,AALA,MAAM,OAAO,EAAQ,MAAM,EAAQ,SAAS,EAAE,OAAO,EAAQ,MAAM,CAAC,GACpE,KAAK,SAAS,EAAQ,QACtB,KAAK,aAAa,EAAQ,YAC1B,KAAK,eAAe,EAAQ,cAC5B,KAAK,MAAM,EAAQ,KACnB,KAAK,SAAS,EAAQ;CACxB;CA4BA,OAAO,UACL,GACA,GAMc;EACd,IAAM,IAAS,EAAI,UAAU,UAAU,GACjC,IAAa,EAAI,UAAU,cAAc,WACzC,IAAM,EAAI,QAAQ,MAAM,GAAG,EAAQ,UAAU,EAAI,OAAO,QAAQ,EAAQ,SACxE,IAAS,EAAI,QAAQ,QAAQ,YAAY,KAAK;EAEpD,OAAO,IAAI,EAAa;GACtB,MAAM,EAAQ;GACd,SAAS,GAAG,EAAQ,KAAK,IAAI,EAAI,QAAQ,IAAI,EAAO,GAAG,EAAI,KAAK,EAAO,GAAG,EAAW;GACrF;GACA;GACA,cAAc,EAAI,UAAU;GAC5B;GACA;GACA,OAAO;EACT,CAAC;CACH;AACF"}

package/dist/shared/types/properties.d.ts

@@ -0,0 +1,107 @@
+import { Address } from 'viem';
+/**
+ * Flatten an intersection of object types into a single, readable object type.
+ *
+ * Purely cosmetic — it has no runtime effect, but it makes hover tooltips show
+ * `{ chainId?: number; user: Address }` instead of `ChainIdParameter & { ... }`.
+ */
+export type Compute<type> = {
+    [key in keyof type]: type[key];
+} & unknown;
+/**
+ * Optional chain-id override mixin. When omitted, an action falls back to the
+ * config's `defaultChainId`.
+ */
+export interface ChainIdParameter {
+    /** Target chain id. Defaults to the config's `defaultChainId` when omitted. */
+    chainId?: number;
+}
+/**
+ * Optional config-fingerprint mixin. `configKey` is folded into a query key so a
+ * runtime config override (which changes the resolved chain config but not the
+ * `chainId`) yields a fresh key — TanStack refetches with the new config instead
+ * of serving stale cache, and the previous config's data stays cached.
+ *
+ * The query option factories set this automatically from
+ * `config.getChainConfigKey(chainId)`; you do not normally pass it by hand.
+ */
+export interface ConfigKeyParameter {
+    /** Stable fingerprint of the resolved chain config; see {@link ConfigKeyParameter}. */
+    configKey?: string;
+}
+/**
+ * Optional sender mixin for simulations. `from` is the address a dry-run
+ * (`simulateContract`) executes as — it becomes `msg.sender` for the call. When
+ * omitted, viem simulates from the zero address. Named `from` (not `account`) so
+ * it never collides with an action's own `account` / `user` parameter.
+ */
+export interface FromParameter {
+    /** Address the simulation runs as (becomes `msg.sender`). Defaults to the connected wallet in the React layer. */
+    from?: Address;
+}
+/**
+ * Opt-out mixin for the pre-send dry-run on write actions. When the resolved
+ * value is `true`, a write runs `simulateContract` first and aborts (throwing the
+ * decoded revert) if the transaction would fail — so nothing is signed or
+ * broadcast. Resolution is `parameters.simulateBeforeWrite ?? config.simulateBeforeWrite`,
+ * and `config.simulateBeforeWrite` itself defaults to `true`.
+ */
+export interface SimulateBeforeWriteParameter {
+    /** Dry-run via `simulateContract` before sending; abort if it would revert. Defaults to the config's `simulateBeforeWrite` (`true` by default). */
+    simulateBeforeWrite?: boolean;
+}
+/**
+ * Standard mixin set every on-chain write action accepts.
+ *
+ * Bundles the three mixins every write supports — optional chain id, optional
+ * signer/from override, and the dry-run opt-out — into one alias so an action's
+ * parameter type stays focused on its action-specific fields:
+ *
+ * ```ts
+ * export type DepositForAccountParameters = Compute<
+ *   WriteContractParameter & {
+ *     account: Address;
+ *     amount: bigint;
+ *   }
+ * >;
+ * ```
+ */
+export type WriteContractParameter = ChainIdParameter & FromParameter & SimulateBeforeWriteParameter;
+/**
+ * Standard mixin set every off-chain solver/hedger write action accepts.
+ *
+ * Bundles the two mixins solver writes need — optional chain id and optional
+ * signer/from override — into one alias. Solver writes never simulate
+ * on-chain (they POST to an HTTP endpoint), so the `simulateBeforeWrite` flag
+ * is intentionally omitted; that's the only difference from
+ * {@link WriteContractParameter}.
+ *
+ * ```ts
+ * export type InstantCloseParameters = Compute<
+ *   WriteSolverParameter & {
+ *     partyA: Address;
+ *     order: InstantCloseOrder;
+ *   }
+ * >;
+ * ```
+ */
+export type WriteSolverParameter = ChainIdParameter & FromParameter;
+/**
+ * Like `Partial<T>`, but each property is also explicitly `| undefined`. Used
+ * for query-options shapes where every action parameter becomes optional.
+ */
+export type ExactPartial<type> = {
+    [key in keyof type]?: type[key] | undefined;
+};
+/**
+ * Recursive `Partial`. Used for per-chain config overrides passed to
+ * {@link createConfig}, where a consumer may override a single nested address.
+ *
+ * Arrays are treated as leaves: an array-valued field stays optional but its
+ * element type is left untouched (no `| undefined` is injected into items), so
+ * an overriding array is replaced wholesale rather than partially patched.
+ */
+export type DeepPartial<type> = type extends readonly unknown[] ? type : type extends object ? {
+    [key in keyof type]?: DeepPartial<type[key]>;
+} : type;
+//# sourceMappingURL=properties.d.ts.map

package/dist/shared/types/properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../../src/shared/types/properties.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,MAAM,OAAO,CAAC,IAAI,IAAI;KAAG,GAAG,IAAI,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC;CAAE,GAAG,OAAO,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,kHAAkH;IAClH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,mJAAmJ;IACnJ,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG,aAAa,GAAG,4BAA4B,CAAC;AAErG;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAEpE;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,IAAI,IAAI;KAC9B,GAAG,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS;CAC5C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,CAAC,IAAI,IAAI,IAAI,SAAS,SAAS,OAAO,EAAE,GAC3D,IAAI,GACJ,IAAI,SAAS,MAAM,GACjB;KAAG,GAAG,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;CAAE,GAChD,IAAI,CAAC"}

package/dist/shared/types/query.d.ts

@@ -0,0 +1,30 @@
+import { DefaultError, QueryKey, QueryObserverOptions } from '@tanstack/query-core';
+/**
+ * Optional TanStack Query overrides accepted by an SDK query-options factory.
+ *
+ * The `queryKey` and `queryFn` are owned by the factory, so they are omitted
+ * here — a consumer may still pass `staleTime`, `gcTime`, `select`, `enabled`,
+ * `retry`, etc. through the `query` property.
+ *
+ * @example
+ * ```ts
+ * useMarkets({ query: { staleTime: 30_000, refetchOnWindowFocus: false } });
+ * ```
+ */
+export interface QueryParameter<queryFnData = unknown, error = DefaultError, data = queryFnData, queryKey extends QueryKey = QueryKey> {
+    query?: Partial<Omit<QueryObserverOptions<queryFnData, error, data, queryFnData, queryKey>, "queryFn" | "queryKey" | "queryHash" | "queryKeyHashFn">>;
+}
+/**
+ * The object an SDK query-options factory returns: a fully-formed TanStack
+ * query options bag with the SDK's `queryKey`, `queryFn`, and `enabled` set,
+ * plus any consumer `query` overrides merged in.
+ *
+ * Declared explicitly (rather than inferred) so the generated `.d.ts` stays
+ * portable — it names `QueryObserverOptions` instead of inlining query-core's
+ * internal helper types.
+ */
+export type SymmioQueryOptions<queryFnData = unknown, error = DefaultError, data = queryFnData, queryKey extends QueryKey = QueryKey> = Partial<Omit<QueryObserverOptions<queryFnData, error, data, queryFnData, queryKey>, "queryFn" | "queryKey" | "queryHash" | "queryKeyHashFn">> & {
+    queryKey: queryKey;
+    queryFn: () => Promise<queryFnData>;
+};
+//# sourceMappingURL=query.d.ts.map

package/dist/shared/types/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/shared/types/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEzF;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,cAAc,CAC7B,WAAW,GAAG,OAAO,EACrB,KAAK,GAAG,YAAY,EACpB,IAAI,GAAG,WAAW,EAClB,QAAQ,SAAS,QAAQ,GAAG,QAAQ;IAEpC,KAAK,CAAC,EAAE,OAAO,CACb,IAAI,CACF,oBAAoB,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,EACrE,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,gBAAgB,CACxD,CACF,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,CAC5B,WAAW,GAAG,OAAO,EACrB,KAAK,GAAG,YAAY,EACpB,IAAI,GAAG,WAAW,EAClB,QAAQ,SAAS,QAAQ,GAAG,QAAQ,IAClC,OAAO,CACT,IAAI,CACF,oBAAoB,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,EACrE,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,gBAAgB,CACxD,CACF,GAAG;IACF,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;CACrC,CAAC"}

package/dist/shared/types/websocket.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Minimal structural types for a WebSocket implementation the SDK can drive.
+ *
+ * Deliberately narrower than the DOM `WebSocket` lib type so `core` stays free
+ * of a DOM-lib dependency and works with any compatible implementation — the
+ * browser/Node global `WebSocket`, or the `ws` package in older Node. The
+ * consuming layer injects one via `createConfig({ webSocketConstructor })`; when
+ * omitted the SDK falls back to `globalThis.WebSocket`.
+ */
+/**
+ * The subset of a WebSocket instance the SDK's reconnecting socket relies on.
+ * Both the browser `WebSocket` and the `ws` package satisfy this shape.
+ */
+export interface WebSocketLike {
+    /** Current connection state (0 connecting, 1 open, 2 closing, 3 closed). */
+    readonly readyState: number;
+    /** Send a text frame. */
+    send(data: string): void;
+    /** Begin closing the connection. */
+    close(code?: number, reason?: string): void;
+    /** Fired once the connection opens. */
+    onopen: ((event: unknown) => void) | null;
+    /** Fired when the connection closes, cleanly or otherwise. */
+    onclose: ((event: {
+        code?: number;
+        reason?: string;
+        wasClean?: boolean;
+    }) => void) | null;
+    /** Fired on a transport-level error. */
+    onerror: ((event: unknown) => void) | null;
+    /** Fired for each inbound frame; `data` is typically a JSON string. */
+    onmessage: ((event: {
+        data: unknown;
+    }) => void) | null;
+}
+/**
+ * A WebSocket constructor compatible with {@link WebSocketLike}. `globalThis.WebSocket`
+ * and the `ws` package's export both match.
+ */
+export interface WebSocketConstructor {
+    new (url: string, protocols?: string | string[]): WebSocketLike;
+}
+//# sourceMappingURL=websocket.d.ts.map

package/dist/shared/types/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/shared/types/websocket.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,oCAAoC;IACpC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,uCAAuC;IACvC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,8DAA8D;IAC9D,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1F,wCAAwC;IACxC,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,uEAAuE;IACvE,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CACxD;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,aAAa,CAAC;CACjE"}

package/dist/shared/utils/query.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Turn an options object into the plain, hashable payload that trails a query
+ * key. Strips TanStack control fields and functions, drops `undefined`, and
+ * recursively serializes `bigint` to its decimal string (TanStack's default key
+ * hash throws on `bigint`).
+ *
+ * @param options - The query-options object passed to a factory.
+ * @returns A plain object safe to embed in a query key.
+ *
+ * @example
+ * ```ts
+ * filterQueryOptions({ chainId: 999, user: "0x…", offset: 0n, query: { staleTime: 1 } });
+ * // → { chainId: 999, user: "0x…", offset: "0" }
+ * ```
+ */
+export declare function filterQueryOptions<type extends Record<string, unknown>>(options: type): Record<string, unknown>;
+//# sourceMappingURL=query.d.ts.map

package/dist/shared/utils/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/query.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAS/G"}

package/dist/shared/utils/query.js

@@ -0,0 +1,25 @@
+//#region src/shared/utils/query.ts
+var e = new Set([
+	"query",
+	"enabled",
+	"config"
+]);
+function t(t) {
+	let r = {};
+	for (let [i, a] of Object.entries(t)) e.has(i) || a !== void 0 && typeof a != "function" && (r[i] = n(a));
+	return r;
+}
+function n(e) {
+	if (typeof e == "bigint") return e.toString();
+	if (Array.isArray(e)) return e.map(n);
+	if (typeof e == "object" && e) {
+		let t = {};
+		for (let [r, i] of Object.entries(e)) t[r] = n(i);
+		return t;
+	}
+	return e;
+}
+//#endregion
+export { t as filterQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/shared/utils/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/shared/utils/query.ts"],"sourcesContent":["/**\n * Keys that configure TanStack Query behavior rather than identify the data.\n * They are stripped before an options object is turned into a query key so two\n * calls that differ only in, say, `staleTime` still share a cache entry.\n */\nconst NON_KEY_FIELDS = new Set([\"query\", \"enabled\", \"config\"]);\n\n/**\n * Turn an options object into the plain, hashable payload that trails a query\n * key. Strips TanStack control fields and functions, drops `undefined`, and\n * recursively serializes `bigint` to its decimal string (TanStack's default key\n * hash throws on `bigint`).\n *\n * @param options - The query-options object passed to a factory.\n * @returns A plain object safe to embed in a query key.\n *\n * @example\n * ```ts\n * filterQueryOptions({ chainId: 999, user: \"0x…\", offset: 0n, query: { staleTime: 1 } });\n * // → { chainId: 999, user: \"0x…\", offset: \"0\" }\n * ```\n */\nexport function filterQueryOptions<type extends Record<string, unknown>>(options: type): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(options)) {\n    if (NON_KEY_FIELDS.has(key)) continue;\n    if (value === undefined) continue;\n    if (typeof value === \"function\") continue;\n    result[key] = serializeBigInts(value);\n  }\n  return result;\n}\n\n/**\n * Recursively replace every `bigint` in a value with its decimal string form so\n * the result survives `JSON.stringify`-based query-key hashing.\n */\nfunction serializeBigInts(value: unknown): unknown {\n  if (typeof value === \"bigint\") return value.toString();\n  if (Array.isArray(value)) return value.map(serializeBigInts);\n  if (value !== null && typeof value === \"object\") {\n    const result: Record<string, unknown> = {};\n    for (const [key, nested] of Object.entries(value)) {\n      result[key] = serializeBigInts(nested);\n    }\n    return result;\n  }\n  return value;\n}\n"],"mappings":";AAKA,IAAM,IAAiB,IAAI,IAAI;CAAC;CAAS;CAAW;AAAQ,CAAC;AAiB7D,SAAgB,EAAyD,GAAwC;CAC/G,IAAM,IAAkC,CAAC;CACzC,KAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,CAAO,GAC3C,EAAe,IAAI,CAAG,KACtB,MAAU,KAAA,KACV,OAAO,KAAU,eACrB,EAAO,KAAO,EAAiB,CAAK;CAEtC,OAAO;AACT;AAMA,SAAS,EAAiB,GAAyB;CACjD,IAAI,OAAO,KAAU,UAAU,OAAO,EAAM,SAAS;CACrD,IAAI,MAAM,QAAQ,CAAK,GAAG,OAAO,EAAM,IAAI,CAAgB;CAC3D,IAAsB,OAAO,KAAU,YAAnC,GAA6C;EAC/C,IAAM,IAAkC,CAAC;EACzC,KAAK,IAAM,CAAC,GAAK,MAAW,OAAO,QAAQ,CAAK,GAC9C,EAAO,KAAO,EAAiB,CAAM;EAEvC,OAAO;CACT;CACA,OAAO;AACT"}

package/dist/shared/utils/simulate-before-write.d.ts

@@ -0,0 +1,22 @@
+import { Config } from '../../core/config';
+import { SimulateBeforeWriteParameter } from '../types/properties';
+/**
+ * Resolve whether a write should dry-run with `simulateContract` before sending.
+ *
+ * Precedence: the call's own `simulateBeforeWrite` wins; otherwise the config's
+ * `simulateBeforeWrite` default applies (itself `true` unless overridden in
+ * `createConfig`).
+ *
+ * @param config - The SDK config.
+ * @param parameters - The write action's parameters (only `simulateBeforeWrite` is read).
+ * @returns `true` when the write should pre-flight a simulation.
+ *
+ * @example
+ * ```ts
+ * if (shouldSimulateBeforeWrite(config, parameters)) {
+ *   await simulateCreateSubAccounts(config, { ...parameters, from });
+ * }
+ * ```
+ */
+export declare function shouldSimulateBeforeWrite(config: Config, parameters: SimulateBeforeWriteParameter): boolean;
+//# sourceMappingURL=simulate-before-write.d.ts.map

package/dist/shared/utils/simulate-before-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate-before-write.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/simulate-before-write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAExE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,4BAA4B,GAAG,OAAO,CAE3G"}

package/dist/shared/utils/simulate-before-write.js

@@ -0,0 +1,8 @@
+//#region src/shared/utils/simulate-before-write.ts
+function e(e, t) {
+	return t.simulateBeforeWrite ?? e.simulateBeforeWrite;
+}
+//#endregion
+export { e as shouldSimulateBeforeWrite };
+
+//# sourceMappingURL=simulate-before-write.js.map