@symmio/trading-react 0.1.0

package/dist/collateral/use-collateral-allowance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-collateral-allowance.d.ts","sourceRoot":"","sources":["../../src/collateral/use-collateral-allowance.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,6BAA6B,EAClC,KAAK,gCAAgC,EACtC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE;;;GAGG;AACH,MAAM,MAAM,gCAAgC,GAAG,6BAA6B,GAAG,eAAe,CAAC;AAE/F,qDAAqD;AACrD,MAAM,MAAM,gCAAgC,GAAG,cAAc,CAAC,gCAAgC,EAAE,kBAAkB,CAAC,CAAC;AAEpH;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,GAAE,gCAAqC,GAChD,gCAAgC,CAkBlC"}

package/dist/collateral/use-collateral-allowance.js

@@ -0,0 +1,27 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
+import { getCollateralAllowanceQueryOptions as r } from "@symmio/trading-core";
+import { useQuery as i } from "@tanstack/react-query";
+//#region src/collateral/use-collateral-allowance.ts
+function a(a = {}) {
+	let o = t(a), s = e(), c = r(o, {
+		...a,
+		chainId: a.chainId ?? s
+	});
+	return i({
+		...c,
+		queryFn: async () => {
+			try {
+				return await c.queryFn();
+			} catch (e) {
+				throw n(e);
+			}
+		}
+	});
+}
+//#endregion
+export { a as useCollateralAllowance };
+
+//# sourceMappingURL=use-collateral-allowance.js.map

package/dist/collateral/use-collateral-allowance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-collateral-allowance.js","names":[],"sources":["../../src/collateral/use-collateral-allowance.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getCollateralAllowanceQueryOptions,\n  type ConfigParameter,\n  type GetCollateralAllowanceOptions,\n  type GetCollateralAllowanceReturnType,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/**\n * Parameters for {@link useCollateralAllowance}: the core query options (owner,\n * chain id, TanStack `query` overrides) plus an optional `config`.\n */\nexport type UseCollateralAllowanceParameters = GetCollateralAllowanceOptions & ConfigParameter;\n\n/** Return type of {@link useCollateralAllowance}. */\nexport type UseCollateralAllowanceReturnType = UseQueryResult<GetCollateralAllowanceReturnType, SymmioRequestError>;\n\n/**\n * Read how much collateral `owner` has approved the SYMMIO core to spend. The\n * query is disabled until `owner` is set. `chainId` defaults to the connected\n * chain. Use it to decide whether a `useApproveCollateral` call is needed before\n * depositing.\n *\n * @example\n * ```tsx\n * const { data: allowance } = useCollateralAllowance({ owner: address });\n * const needsApproval = (allowance ?? 0n) < amount;\n * ```\n */\nexport function useCollateralAllowance(\n  parameters: UseCollateralAllowanceParameters = {},\n): UseCollateralAllowanceReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const options = getCollateralAllowanceQueryOptions(config, {\n    ...parameters,\n    chainId: parameters.chainId ?? chainId,\n  });\n\n  return useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseCollateralAllowanceReturnType;\n}\n"],"mappings":";;;;;;;AAmCA,SAAgB,EACd,IAA+C,CAAC,GACd;CAClC,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAU,EAAmC,GAAQ;EACzD,GAAG;EACH,SAAS,EAAW,WAAW;CACjC,CAAC;CAED,OAAO,EAAS;EACd,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;AACH"}

package/dist/collateral/use-collateral-balance.d.ts

@@ -0,0 +1,22 @@
+import { ConfigParameter, GetCollateralBalanceOptions, GetCollateralBalanceReturnType } from '@symmio/trading-core';
+import { UseQueryResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error';
+/**
+ * Parameters for {@link useCollateralBalance}: the core query options (owner,
+ * chain id, TanStack `query` overrides) plus an optional `config`.
+ */
+export type UseCollateralBalanceParameters = GetCollateralBalanceOptions & ConfigParameter;
+/** Return type of {@link useCollateralBalance}. */
+export type UseCollateralBalanceReturnType = UseQueryResult<GetCollateralBalanceReturnType, SymmioRequestError>;
+/**
+ * Read `owner`'s wallet balance of the chain's collateral token (e.g. USDC) — the
+ * funds available to deposit. The query is disabled until `owner` is set.
+ * `chainId` defaults to the connected chain.
+ *
+ * @example
+ * ```tsx
+ * const { data: balance } = useCollateralBalance({ owner: address });
+ * ```
+ */
+export declare function useCollateralBalance(parameters?: UseCollateralBalanceParameters): UseCollateralBalanceReturnType;
+//# sourceMappingURL=use-collateral-balance.d.ts.map

package/dist/collateral/use-collateral-balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-collateral-balance.d.ts","sourceRoot":"","sources":["../../src/collateral/use-collateral-balance.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE;;;GAGG;AACH,MAAM,MAAM,8BAA8B,GAAG,2BAA2B,GAAG,eAAe,CAAC;AAE3F,mDAAmD;AACnD,MAAM,MAAM,8BAA8B,GAAG,cAAc,CAAC,8BAA8B,EAAE,kBAAkB,CAAC,CAAC;AAEhH;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,GAAE,8BAAmC,GAAG,8BAA8B,CAkBpH"}

package/dist/collateral/use-collateral-balance.js

@@ -0,0 +1,27 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
+import { getCollateralBalanceQueryOptions as r } from "@symmio/trading-core";
+import { useQuery as i } from "@tanstack/react-query";
+//#region src/collateral/use-collateral-balance.ts
+function a(a = {}) {
+	let o = t(a), s = e(), c = r(o, {
+		...a,
+		chainId: a.chainId ?? s
+	});
+	return i({
+		...c,
+		queryFn: async () => {
+			try {
+				return await c.queryFn();
+			} catch (e) {
+				throw n(e);
+			}
+		}
+	});
+}
+//#endregion
+export { a as useCollateralBalance };
+
+//# sourceMappingURL=use-collateral-balance.js.map

package/dist/collateral/use-collateral-balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-collateral-balance.js","names":[],"sources":["../../src/collateral/use-collateral-balance.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getCollateralBalanceQueryOptions,\n  type ConfigParameter,\n  type GetCollateralBalanceOptions,\n  type GetCollateralBalanceReturnType,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/**\n * Parameters for {@link useCollateralBalance}: the core query options (owner,\n * chain id, TanStack `query` overrides) plus an optional `config`.\n */\nexport type UseCollateralBalanceParameters = GetCollateralBalanceOptions & ConfigParameter;\n\n/** Return type of {@link useCollateralBalance}. */\nexport type UseCollateralBalanceReturnType = UseQueryResult<GetCollateralBalanceReturnType, SymmioRequestError>;\n\n/**\n * Read `owner`'s wallet balance of the chain's collateral token (e.g. USDC) — the\n * funds available to deposit. The query is disabled until `owner` is set.\n * `chainId` defaults to the connected chain.\n *\n * @example\n * ```tsx\n * const { data: balance } = useCollateralBalance({ owner: address });\n * ```\n */\nexport function useCollateralBalance(parameters: UseCollateralBalanceParameters = {}): UseCollateralBalanceReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const options = getCollateralBalanceQueryOptions(config, {\n    ...parameters,\n    chainId: parameters.chainId ?? chainId,\n  });\n\n  return useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseCollateralBalanceReturnType;\n}\n"],"mappings":";;;;;;;AAiCA,SAAgB,EAAqB,IAA6C,CAAC,GAAmC;CACpH,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAU,EAAiC,GAAQ;EACvD,GAAG;EACH,SAAS,EAAW,WAAW;CACjC,CAAC;CAED,OAAO,EAAS;EACd,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;AACH"}

package/dist/collateral/use-simulate-approve-collateral.d.ts

@@ -0,0 +1,26 @@
+import { ConfigParameter, SimulateApproveCollateralParameters, SimulateApproveCollateralReturnType } from '@symmio/trading-core';
+import { UseMutationResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error';
+/**
+ * Parameters for {@link useSimulateApproveCollateral}: an optional `config` override. The dry-run's
+ * inputs are passed as the mutation `variables`.
+ */
+export type UseSimulateApproveCollateralParameters = ConfigParameter;
+/** Return type of {@link useSimulateApproveCollateral}. */
+export type UseSimulateApproveCollateralReturnType = UseMutationResult<SimulateApproveCollateralReturnType, SymmioRequestError, SimulateApproveCollateralParameters>;
+/**
+ * On-demand dry-run (`simulateContract`) of `approveCollateral` (the ERC20
+ * `approve`). Call `mutate(args)` to run it; `data` holds viem's
+ * `{ request, result }` (a would-be revert surfaces as a normalized
+ * {@link SymmioRequestError}). `from` defaults to the connected wallet and
+ * `chainId` to the connected chain.
+ *
+ * @example
+ * ```tsx
+ * const sim = useSimulateApproveCollateral();
+ * sim.mutate({ ...args });
+ * // sim.data?.result, sim.isPending, sim.error
+ * ```
+ */
+export declare function useSimulateApproveCollateral(parameters?: UseSimulateApproveCollateralParameters): UseSimulateApproveCollateralReturnType;
+//# sourceMappingURL=use-simulate-approve-collateral.d.ts.map

package/dist/collateral/use-simulate-approve-collateral.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-simulate-approve-collateral.d.ts","sourceRoot":"","sources":["../../src/collateral/use-simulate-approve-collateral.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,mCAAmC,EACxC,KAAK,mCAAmC,EACzC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE;;;GAGG;AACH,MAAM,MAAM,sCAAsC,GAAG,eAAe,CAAC;AAErE,2DAA2D;AAC3D,MAAM,MAAM,sCAAsC,GAAG,iBAAiB,CACpE,mCAAmC,EACnC,kBAAkB,EAClB,mCAAmC,CACpC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,GAAE,sCAA2C,GACtD,sCAAsC,CAoBxC"}

package/dist/collateral/use-simulate-approve-collateral.js

@@ -0,0 +1,29 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
+import { simulateApproveCollateralMutationOptions as r } from "@symmio/trading-core";
+import { useConnection as i } from "wagmi";
+import { useMutation as a } from "@tanstack/react-query";
+//#region src/collateral/use-simulate-approve-collateral.ts
+function o(o = {}) {
+	let s = t(o), c = e(), { address: l } = i(), u = r(s);
+	return a({
+		mutationKey: u.mutationKey,
+		mutationFn: async (e) => {
+			try {
+				return await u.mutationFn({
+					...e,
+					chainId: e.chainId ?? c,
+					from: e.from ?? l
+				});
+			} catch (e) {
+				throw n(e);
+			}
+		}
+	});
+}
+//#endregion
+export { o as useSimulateApproveCollateral };
+
+//# sourceMappingURL=use-simulate-approve-collateral.js.map

package/dist/collateral/use-simulate-approve-collateral.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-simulate-approve-collateral.js","names":[],"sources":["../../src/collateral/use-simulate-approve-collateral.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  simulateApproveCollateralMutationOptions,\n  type ConfigParameter,\n  type SimulateApproveCollateralParameters,\n  type SimulateApproveCollateralReturnType,\n} from \"@symmio/trading-core\";\nimport { useMutation, type UseMutationResult } from \"@tanstack/react-query\";\nimport { useConnection } from \"wagmi\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/**\n * Parameters for {@link useSimulateApproveCollateral}: an optional `config` override. The dry-run's\n * inputs are passed as the mutation `variables`.\n */\nexport type UseSimulateApproveCollateralParameters = ConfigParameter;\n\n/** Return type of {@link useSimulateApproveCollateral}. */\nexport type UseSimulateApproveCollateralReturnType = UseMutationResult<\n  SimulateApproveCollateralReturnType,\n  SymmioRequestError,\n  SimulateApproveCollateralParameters\n>;\n\n/**\n * On-demand dry-run (`simulateContract`) of `approveCollateral` (the ERC20\n * `approve`). Call `mutate(args)` to run it; `data` holds viem's\n * `{ request, result }` (a would-be revert surfaces as a normalized\n * {@link SymmioRequestError}). `from` defaults to the connected wallet and\n * `chainId` to the connected chain.\n *\n * @example\n * ```tsx\n * const sim = useSimulateApproveCollateral();\n * sim.mutate({ ...args });\n * // sim.data?.result, sim.isPending, sim.error\n * ```\n */\nexport function useSimulateApproveCollateral(\n  parameters: UseSimulateApproveCollateralParameters = {},\n): UseSimulateApproveCollateralReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const { address } = useConnection();\n  const base = simulateApproveCollateralMutationOptions(config);\n\n  return useMutation<SimulateApproveCollateralReturnType, SymmioRequestError, SimulateApproveCollateralParameters>({\n    mutationKey: base.mutationKey,\n    mutationFn: async (variables) => {\n      try {\n        return await base.mutationFn({\n          ...variables,\n          chainId: variables.chainId ?? chainId,\n          from: variables.from ?? address,\n        });\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  });\n}\n"],"mappings":";;;;;;;;AA0CA,SAAgB,EACd,IAAqD,CAAC,GACd;CACxC,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,EAAE,eAAY,EAAc,GAC5B,IAAO,EAAyC,CAAM;CAE5D,OAAO,EAA0G;EAC/G,aAAa,EAAK;EAClB,YAAY,OAAO,MAAc;GAC/B,IAAI;IACF,OAAO,MAAM,EAAK,WAAW;KAC3B,GAAG;KACH,SAAS,EAAU,WAAW;KAC9B,MAAM,EAAU,QAAQ;IAC1B,CAAC;GACH,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;AACH"}

package/dist/error-codes/index.d.ts

@@ -0,0 +1,3 @@
+export * from './use-solver-error-codes';
+export * from './use-solver-error-message';
+//# sourceMappingURL=index.d.ts.map

package/dist/error-codes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/error-codes/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC"}

package/dist/error-codes/use-solver-error-codes.d.ts

@@ -0,0 +1,27 @@
+import { ConfigParameter, GetSolverErrorCodesOptions, GetSolverErrorCodesReturnType } from '@symmio/trading-core';
+import { UseQueryResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error';
+/**
+ * Parameters for {@link useSolverErrorCodes}: the core query options (chain id,
+ * TanStack `query` overrides) plus an optional `config`.
+ */
+export type UseSolverErrorCodesParameters = GetSolverErrorCodesOptions & ConfigParameter;
+/** Return type of {@link useSolverErrorCodes}. */
+export type UseSolverErrorCodesReturnType = UseQueryResult<GetSolverErrorCodesReturnType, SymmioRequestError>;
+/**
+ * Fetch the chain solver's error-code → message map (the `/error_codes`
+ * endpoint). The map is effectively static, so it is cached with
+ * `staleTime: Infinity`; prefer the {@link useSolverErrorMessage} selector to
+ * resolve a single code.
+ *
+ * Returns react-query's full {@link UseQueryResult}. Errors are normalized to
+ * {@link SymmioRequestError} so `error.kind` is always a documented value.
+ *
+ * @example
+ * ```tsx
+ * const { data: codes } = useSolverErrorCodes();
+ * const message = codes?.[2000];
+ * ```
+ */
+export declare function useSolverErrorCodes(parameters?: UseSolverErrorCodesParameters): UseSolverErrorCodesReturnType;
+//# sourceMappingURL=use-solver-error-codes.d.ts.map

package/dist/error-codes/use-solver-error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-solver-error-codes.d.ts","sourceRoot":"","sources":["../../src/error-codes/use-solver-error-codes.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EACnC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,0BAA0B,GAAG,eAAe,CAAC;AAEzF,kDAAkD;AAClD,MAAM,MAAM,6BAA6B,GAAG,cAAc,CAAC,6BAA6B,EAAE,kBAAkB,CAAC,CAAC;AAE9G;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,GAAE,6BAAkC,GAAG,6BAA6B,CAkBjH"}

package/dist/error-codes/use-solver-error-codes.js

@@ -0,0 +1,27 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
+import { getSolverErrorCodesQueryOptions as r } from "@symmio/trading-core";
+import { useQuery as i } from "@tanstack/react-query";
+//#region src/error-codes/use-solver-error-codes.ts
+function a(a = {}) {
+	let o = t(a), s = e(), c = r(o, {
+		...a,
+		chainId: a.chainId ?? s
+	});
+	return i({
+		...c,
+		queryFn: async () => {
+			try {
+				return await c.queryFn();
+			} catch (e) {
+				throw n(e);
+			}
+		}
+	});
+}
+//#endregion
+export { a as useSolverErrorCodes };
+
+//# sourceMappingURL=use-solver-error-codes.js.map

package/dist/error-codes/use-solver-error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-solver-error-codes.js","names":[],"sources":["../../src/error-codes/use-solver-error-codes.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getSolverErrorCodesQueryOptions,\n  type ConfigParameter,\n  type GetSolverErrorCodesOptions,\n  type GetSolverErrorCodesReturnType,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/**\n * Parameters for {@link useSolverErrorCodes}: the core query options (chain id,\n * TanStack `query` overrides) plus an optional `config`.\n */\nexport type UseSolverErrorCodesParameters = GetSolverErrorCodesOptions & ConfigParameter;\n\n/** Return type of {@link useSolverErrorCodes}. */\nexport type UseSolverErrorCodesReturnType = UseQueryResult<GetSolverErrorCodesReturnType, SymmioRequestError>;\n\n/**\n * Fetch the chain solver's error-code → message map (the `/error_codes`\n * endpoint). The map is effectively static, so it is cached with\n * `staleTime: Infinity`; prefer the {@link useSolverErrorMessage} selector to\n * resolve a single code.\n *\n * Returns react-query's full {@link UseQueryResult}. Errors are normalized to\n * {@link SymmioRequestError} so `error.kind` is always a documented value.\n *\n * @example\n * ```tsx\n * const { data: codes } = useSolverErrorCodes();\n * const message = codes?.[2000];\n * ```\n */\nexport function useSolverErrorCodes(parameters: UseSolverErrorCodesParameters = {}): UseSolverErrorCodesReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const options = getSolverErrorCodesQueryOptions(config, {\n    ...parameters,\n    chainId: parameters.chainId ?? chainId,\n  });\n\n  return useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseSolverErrorCodesReturnType;\n}\n"],"mappings":";;;;;;;AAsCA,SAAgB,EAAoB,IAA4C,CAAC,GAAkC;CACjH,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAU,EAAgC,GAAQ;EACtD,GAAG;EACH,SAAS,EAAW,WAAW;CACjC,CAAC;CAED,OAAO,EAAS;EACd,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;AACH"}

package/dist/error-codes/use-solver-error-message.d.ts

@@ -0,0 +1,23 @@
+import { UseSolverErrorCodesParameters } from './use-solver-error-codes';
+/**
+ * Resolve a single solver error code — the `errorCode` reported on a failed
+ * open/close notification or carried on a failed `UnifiedQuote` — to its
+ * human-readable message.
+ *
+ * Returns `undefined` while the code map is loading, when `code` is `null` /
+ * absent, or when the solver does not register the code. Wraps
+ * {@link useSolverErrorCodes}; `parameters` (chain id, `config`, TanStack
+ * `query` overrides) are forwarded to the underlying map query.
+ *
+ * @param code - The numeric solver error code to resolve.
+ * @param parameters - Optional chain id, `config`, and TanStack `query` overrides.
+ * @returns The resolved message, or `undefined` when it cannot be resolved.
+ *
+ * @example
+ * ```tsx
+ * const message = useSolverErrorMessage(quote.errorCode);
+ * if (message) return <ResultError message={message} />;
+ * ```
+ */
+export declare function useSolverErrorMessage(code?: number | null, parameters?: UseSolverErrorCodesParameters): string | undefined;
+//# sourceMappingURL=use-solver-error-message.d.ts.map

package/dist/error-codes/use-solver-error-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-solver-error-message.d.ts","sourceRoot":"","sources":["../../src/error-codes/use-solver-error-message.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAEnG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EACpB,UAAU,GAAE,6BAAkC,GAC7C,MAAM,GAAG,SAAS,CAIpB"}

package/dist/error-codes/use-solver-error-message.js

@@ -0,0 +1,11 @@
+"use client";
+import { useSolverErrorCodes as e } from "./use-solver-error-codes.js";
+//#region src/error-codes/use-solver-error-message.ts
+function t(t, n = {}) {
+	let { data: r } = e(n);
+	if (!(t == null || !r)) return r[t];
+}
+//#endregion
+export { t as useSolverErrorMessage };
+
+//# sourceMappingURL=use-solver-error-message.js.map

package/dist/error-codes/use-solver-error-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-solver-error-message.js","names":[],"sources":["../../src/error-codes/use-solver-error-message.ts"],"sourcesContent":["\"use client\";\n\nimport { useSolverErrorCodes, type UseSolverErrorCodesParameters } from \"./use-solver-error-codes\";\n\n/**\n * Resolve a single solver error code — the `errorCode` reported on a failed\n * open/close notification or carried on a failed `UnifiedQuote` — to its\n * human-readable message.\n *\n * Returns `undefined` while the code map is loading, when `code` is `null` /\n * absent, or when the solver does not register the code. Wraps\n * {@link useSolverErrorCodes}; `parameters` (chain id, `config`, TanStack\n * `query` overrides) are forwarded to the underlying map query.\n *\n * @param code - The numeric solver error code to resolve.\n * @param parameters - Optional chain id, `config`, and TanStack `query` overrides.\n * @returns The resolved message, or `undefined` when it cannot be resolved.\n *\n * @example\n * ```tsx\n * const message = useSolverErrorMessage(quote.errorCode);\n * if (message) return <ResultError message={message} />;\n * ```\n */\nexport function useSolverErrorMessage(\n  code?: number | null,\n  parameters: UseSolverErrorCodesParameters = {},\n): string | undefined {\n  const { data } = useSolverErrorCodes(parameters);\n  if (code == null || !data) return undefined;\n  return data[code];\n}\n"],"mappings":";;;AAwBA,SAAgB,EACd,GACA,IAA4C,CAAC,GACzB;CACpB,IAAM,EAAE,YAAS,EAAoB,CAAU;CAC3C,WAAQ,QAAQ,CAAC,IACrB,OAAO,EAAK;AACd"}

package/dist/errors/index.d.ts

@@ -0,0 +1,4 @@
+export * from './normalize-symm-error';
+export * from './symmio-request-error';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,14 @@
+import { SymmioRequestError } from './symmio-request-error';
+/**
+ * Classify any thrown value into a {@link SymmioRequestError}. Hooks call this
+ * inside their `queryFn` / `mutationFn` so consumers always see the same
+ * discriminated shape, regardless of which viem error type fired underneath.
+ *
+ * The order of `walk` matters: a wallet-popup dismissal nests inside a
+ * `TransactionExecutionError`, so the rejection check has to consider every
+ * level of the cause chain, not just the topmost throw.
+ *
+ * @param err - The thrown value (typed `unknown` because Promises can reject with anything).
+ */
+export declare function normalizeSymmError(err: unknown): SymmioRequestError;
+//# sourceMappingURL=normalize-symm-error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-symm-error.d.ts","sourceRoot":"","sources":["../../src/errors/normalize-symm-error.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAsFnE"}

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

@@ -0,0 +1,86 @@
+import { SymmioRequestError as e } from "./symmio-request-error.js";
+import { SymmApiError as t, SymmError as n } from "@symmio/trading-core";
+import { BaseError as r, ContractFunctionRevertedError as i, EstimateGasExecutionError as a, HttpRequestError as o, InsufficientFundsError as s, TimeoutError as c, TransactionExecutionError as l, UserRejectedRequestError as u } from "viem";
+//#region src/errors/normalize-symm-error.ts
+function d(r) {
+	if (r instanceof e) return r;
+	if (r instanceof t) return new e({
+		kind: "api",
+		message: r.message,
+		code: r.code,
+		status: r.status,
+		responseData: r.responseData,
+		cause: r
+	});
+	if (r instanceof n) return new e({
+		kind: "sdk",
+		message: r.message,
+		code: r.code,
+		cause: r
+	});
+	let d = f(r);
+	if (d) {
+		let t = p(d, u);
+		if (t) return new e({
+			kind: "user-rejected",
+			message: t.shortMessage || "Wallet request was rejected.",
+			cause: r
+		});
+		let n = p(d, i);
+		if (n) {
+			let t = n.reason ?? n.data?.errorName;
+			return new e({
+				kind: "contract-revert",
+				message: n.shortMessage || `Contract reverted${t ? `: ${t}` : "."}`,
+				reason: t,
+				cause: r
+			});
+		}
+		let f = p(d, s);
+		if (f) return new e({
+			kind: "insufficient-funds",
+			message: f.shortMessage || "Insufficient funds for gas.",
+			cause: r
+		});
+		let m = p(d, o) || p(d, c) || p(d, a) || p(d, l);
+		return m ? new e({
+			kind: "rpc",
+			message: m.shortMessage || m.message,
+			shortMessage: m.shortMessage,
+			cause: r
+		}) : new e({
+			kind: "rpc",
+			message: d.shortMessage || d.message,
+			shortMessage: d.shortMessage,
+			cause: r
+		});
+	}
+	return r instanceof Error ? new e({
+		kind: "unknown",
+		message: r.message,
+		cause: r
+	}) : new e({
+		kind: "unknown",
+		message: typeof r == "string" ? r : "An unknown error occurred.",
+		cause: r
+	});
+}
+function f(e) {
+	let t = e, n = 0;
+	for (; t && n < 16;) {
+		if (t instanceof r) return t;
+		if (t instanceof Error && t.cause) {
+			t = t.cause, n += 1;
+			continue;
+		}
+		return;
+	}
+}
+function p(e, t) {
+	let n = e.walk((e) => e instanceof t);
+	return n instanceof t ? n : void 0;
+}
+//#endregion
+export { d as normalizeSymmError };
+
+//# sourceMappingURL=normalize-symm-error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-symm-error.js","names":[],"sources":["../../src/errors/normalize-symm-error.ts"],"sourcesContent":["import { SymmApiError, SymmError } from \"@symmio/trading-core\";\nimport {\n  BaseError,\n  ContractFunctionRevertedError,\n  EstimateGasExecutionError,\n  HttpRequestError,\n  InsufficientFundsError,\n  TimeoutError,\n  TransactionExecutionError,\n  UserRejectedRequestError,\n} from \"viem\";\nimport { SymmioRequestError } from \"./symmio-request-error\";\n\n/**\n * Classify any thrown value into a {@link SymmioRequestError}. Hooks call this\n * inside their `queryFn` / `mutationFn` so consumers always see the same\n * discriminated shape, regardless of which viem error type fired underneath.\n *\n * The order of `walk` matters: a wallet-popup dismissal nests inside a\n * `TransactionExecutionError`, so the rejection check has to consider every\n * level of the cause chain, not just the topmost throw.\n *\n * @param err - The thrown value (typed `unknown` because Promises can reject with anything).\n */\nexport function normalizeSymmError(err: unknown): SymmioRequestError {\n  if (err instanceof SymmioRequestError) return err;\n\n  if (err instanceof SymmApiError) {\n    return new SymmioRequestError({\n      kind: \"api\",\n      message: err.message,\n      code: err.code,\n      status: err.status,\n      responseData: err.responseData,\n      cause: err,\n    });\n  }\n\n  if (err instanceof SymmError) {\n    return new SymmioRequestError({\n      kind: \"sdk\",\n      message: err.message,\n      code: err.code,\n      cause: err,\n    });\n  }\n\n  const viemErr = findViemError(err);\n\n  if (viemErr) {\n    const userRejected = findInCauseChain(viemErr, UserRejectedRequestError);\n    if (userRejected) {\n      return new SymmioRequestError({\n        kind: \"user-rejected\",\n        message: userRejected.shortMessage || \"Wallet request was rejected.\",\n        cause: err,\n      });\n    }\n\n    const revert = findInCauseChain(viemErr, ContractFunctionRevertedError);\n    if (revert) {\n      const reason = revert.reason ?? revert.data?.errorName;\n      return new SymmioRequestError({\n        kind: \"contract-revert\",\n        message: revert.shortMessage || `Contract reverted${reason ? `: ${reason}` : \".\"}`,\n        reason,\n        cause: err,\n      });\n    }\n\n    const insufficient = findInCauseChain(viemErr, InsufficientFundsError);\n    if (insufficient) {\n      return new SymmioRequestError({\n        kind: \"insufficient-funds\",\n        message: insufficient.shortMessage || \"Insufficient funds for gas.\",\n        cause: err,\n      });\n    }\n\n    const transport =\n      findInCauseChain(viemErr, HttpRequestError) ||\n      findInCauseChain(viemErr, TimeoutError) ||\n      findInCauseChain(viemErr, EstimateGasExecutionError) ||\n      findInCauseChain(viemErr, TransactionExecutionError);\n    if (transport) {\n      return new SymmioRequestError({\n        kind: \"rpc\",\n        message: transport.shortMessage || transport.message,\n        shortMessage: transport.shortMessage,\n        cause: err,\n      });\n    }\n\n    return new SymmioRequestError({\n      kind: \"rpc\",\n      message: viemErr.shortMessage || viemErr.message,\n      shortMessage: viemErr.shortMessage,\n      cause: err,\n    });\n  }\n\n  if (err instanceof Error) {\n    return new SymmioRequestError({ kind: \"unknown\", message: err.message, cause: err });\n  }\n\n  return new SymmioRequestError({\n    kind: \"unknown\",\n    message: typeof err === \"string\" ? err : \"An unknown error occurred.\",\n    cause: err,\n  });\n}\n\n/**\n * Walk an error and its `cause` chain looking for a viem `BaseError`. Returns\n * the first one found, or `undefined`.\n *\n * @internal\n */\nfunction findViemError(err: unknown): BaseError | undefined {\n  let current: unknown = err;\n  let depth = 0;\n  while (current && depth < 16) {\n    if (current instanceof BaseError) return current;\n    if (current instanceof Error && current.cause) {\n      current = current.cause;\n      depth += 1;\n      continue;\n    }\n    return undefined;\n  }\n  return undefined;\n}\n\n/**\n * Walk a viem `BaseError`'s `walk()` chain looking for a specific subclass.\n *\n * @internal\n */\nfunction findInCauseChain<T extends BaseError>(err: BaseError, ctor: new (...args: never[]) => T): T | undefined {\n  const found = err.walk((candidate) => candidate instanceof ctor);\n  return found instanceof ctor ? (found as T) : undefined;\n}\n"],"mappings":";;;;AAwBA,SAAgB,EAAmB,GAAkC;CACnE,IAAI,aAAe,GAAoB,OAAO;CAE9C,IAAI,aAAe,GACjB,OAAO,IAAI,EAAmB;EAC5B,MAAM;EACN,SAAS,EAAI;EACb,MAAM,EAAI;EACV,QAAQ,EAAI;EACZ,cAAc,EAAI;EAClB,OAAO;CACT,CAAC;CAGH,IAAI,aAAe,GACjB,OAAO,IAAI,EAAmB;EAC5B,MAAM;EACN,SAAS,EAAI;EACb,MAAM,EAAI;EACV,OAAO;CACT,CAAC;CAGH,IAAM,IAAU,EAAc,CAAG;CAEjC,IAAI,GAAS;EACX,IAAM,IAAe,EAAiB,GAAS,CAAwB;EACvE,IAAI,GACF,OAAO,IAAI,EAAmB;GAC5B,MAAM;GACN,SAAS,EAAa,gBAAgB;GACtC,OAAO;EACT,CAAC;EAGH,IAAM,IAAS,EAAiB,GAAS,CAA6B;EACtE,IAAI,GAAQ;GACV,IAAM,IAAS,EAAO,UAAU,EAAO,MAAM;GAC7C,OAAO,IAAI,EAAmB;IAC5B,MAAM;IACN,SAAS,EAAO,gBAAgB,oBAAoB,IAAS,KAAK,MAAW;IAC7E;IACA,OAAO;GACT,CAAC;EACH;EAEA,IAAM,IAAe,EAAiB,GAAS,CAAsB;EACrE,IAAI,GACF,OAAO,IAAI,EAAmB;GAC5B,MAAM;GACN,SAAS,EAAa,gBAAgB;GACtC,OAAO;EACT,CAAC;EAGH,IAAM,IACJ,EAAiB,GAAS,CAAgB,KAC1C,EAAiB,GAAS,CAAY,KACtC,EAAiB,GAAS,CAAyB,KACnD,EAAiB,GAAS,CAAyB;EAUrD,OATI,IACK,IAAI,EAAmB;GAC5B,MAAM;GACN,SAAS,EAAU,gBAAgB,EAAU;GAC7C,cAAc,EAAU;GACxB,OAAO;EACT,CAAC,IAGI,IAAI,EAAmB;GAC5B,MAAM;GACN,SAAS,EAAQ,gBAAgB,EAAQ;GACzC,cAAc,EAAQ;GACtB,OAAO;EACT,CAAC;CACH;CAMA,OAJI,aAAe,QACV,IAAI,EAAmB;EAAE,MAAM;EAAW,SAAS,EAAI;EAAS,OAAO;CAAI,CAAC,IAG9E,IAAI,EAAmB;EAC5B,MAAM;EACN,SAAS,OAAO,KAAQ,WAAW,IAAM;EACzC,OAAO;CACT,CAAC;AACH;AAQA,SAAS,EAAc,GAAqC;CAC1D,IAAI,IAAmB,GACnB,IAAQ;CACZ,OAAO,KAAW,IAAQ,KAAI;EAC5B,IAAI,aAAmB,GAAW,OAAO;EACzC,IAAI,aAAmB,SAAS,EAAQ,OAAO;GAE7C,AADA,IAAU,EAAQ,OAClB,KAAS;GACT;EACF;EACA;CACF;AAEF;AAOA,SAAS,EAAsC,GAAgB,GAAkD;CAC/G,IAAM,IAAQ,EAAI,MAAM,MAAc,aAAqB,CAAI;CAC/D,OAAO,aAAiB,IAAQ,IAAc,KAAA;AAChD"}

package/dist/errors/symmio-request-error.d.ts

@@ -0,0 +1,54 @@
+import { SymmioNormalizedErrorKind } from './types';
+/**
+ * Options accepted by the {@link SymmioRequestError} constructor. Carries
+ * the discriminator-specific fields the UI cares about.
+ */
+export interface SymmioRequestErrorOptions {
+    kind: SymmioNormalizedErrorKind;
+    message: string;
+    /** SDK error code (e.g., "FETCH_MARKETS_FAILED", "UNSUPPORTED_CHAIN"). */
+    code?: string;
+    /** HTTP status code. Only meaningful when `kind === "api"`. */
+    status?: number;
+    /**
+     * Raw response body returned by the server. Only meaningful when `kind === "api"`.
+     * Forwarded verbatim from `SymmApiError.responseData` so the UI can render the
+     * server's structured error fields without unwrapping `cause`.
+     */
+    responseData?: unknown;
+    /** Solidity revert reason. Only meaningful when `kind === "contract-revert"`. */
+    reason?: string;
+    /** viem's human-readable short message. Only meaningful when `kind === "rpc"`. */
+    shortMessage?: string;
+    /** The original underlying error, kept for debugging. */
+    cause?: unknown;
+}
+/**
+ * The single error class every SYMMIO React hook throws when a read or write
+ * fails. Carries a discriminator (`kind`) the UI can switch on without
+ * inspecting viem's internal error hierarchy.
+ *
+ * @example
+ * const { error } = useUserSubAccounts({ user });
+ * if (error?.kind === "user-rejected") return null;       // silent
+ * if (error?.kind === "contract-revert") return <ShowReason reason={error.reason} />;
+ * if (error?.kind === "api") return <ApiError status={error.status} code={error.code} />;
+ * if (error) return <GenericError message={error.message} />;
+ */
+export declare class SymmioRequestError extends Error {
+    readonly name = "SymmioRequestError";
+    /** Classification used by the UI to branch on this failure. */
+    readonly kind: SymmioNormalizedErrorKind;
+    /** SDK error code (e.g., "FETCH_MARKETS_FAILED"). */
+    readonly code?: string;
+    /** HTTP status code when `kind === "api"`. */
+    readonly status?: number;
+    /** Raw response body returned by the server when `kind === "api"`. */
+    readonly responseData?: unknown;
+    /** Solidity revert reason when `kind === "contract-revert"`. */
+    readonly reason?: string;
+    /** viem's short message when `kind === "rpc"`. */
+    readonly shortMessage?: string;
+    constructor(options: SymmioRequestErrorOptions);
+}
+//# sourceMappingURL=symmio-request-error.d.ts.map

package/dist/errors/symmio-request-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symmio-request-error.d.ts","sourceRoot":"","sources":["../../src/errors/symmio-request-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,yBAAyB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAkB,IAAI,wBAAwB;IAC9C,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,yBAAyB;CAS/C"}

package/dist/errors/symmio-request-error.js

@@ -0,0 +1,17 @@
+//#region src/errors/symmio-request-error.ts
+var e = class extends Error {
+	name = "SymmioRequestError";
+	kind;
+	code;
+	status;
+	responseData;
+	reason;
+	shortMessage;
+	constructor(e) {
+		super(e.message, { cause: e.cause }), this.kind = e.kind, this.code = e.code, this.status = e.status, this.responseData = e.responseData, this.reason = e.reason, this.shortMessage = e.shortMessage;
+	}
+};
+//#endregion
+export { e as SymmioRequestError };
+
+//# sourceMappingURL=symmio-request-error.js.map

package/dist/errors/symmio-request-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symmio-request-error.js","names":[],"sources":["../../src/errors/symmio-request-error.ts"],"sourcesContent":["import type { SymmioNormalizedErrorKind } from \"./types\";\n\n/**\n * Options accepted by the {@link SymmioRequestError} constructor. Carries\n * the discriminator-specific fields the UI cares about.\n */\nexport interface SymmioRequestErrorOptions {\n  kind: SymmioNormalizedErrorKind;\n  message: string;\n  /** SDK error code (e.g., \"FETCH_MARKETS_FAILED\", \"UNSUPPORTED_CHAIN\"). */\n  code?: string;\n  /** HTTP status code. Only meaningful when `kind === \"api\"`. */\n  status?: number;\n  /**\n   * Raw response body returned by the server. Only meaningful when `kind === \"api\"`.\n   * Forwarded verbatim from `SymmApiError.responseData` so the UI can render the\n   * server's structured error fields without unwrapping `cause`.\n   */\n  responseData?: unknown;\n  /** Solidity revert reason. Only meaningful when `kind === \"contract-revert\"`. */\n  reason?: string;\n  /** viem's human-readable short message. Only meaningful when `kind === \"rpc\"`. */\n  shortMessage?: string;\n  /** The original underlying error, kept for debugging. */\n  cause?: unknown;\n}\n\n/**\n * The single error class every SYMMIO React hook throws when a read or write\n * fails. Carries a discriminator (`kind`) the UI can switch on without\n * inspecting viem's internal error hierarchy.\n *\n * @example\n * const { error } = useUserSubAccounts({ user });\n * if (error?.kind === \"user-rejected\") return null;       // silent\n * if (error?.kind === \"contract-revert\") return <ShowReason reason={error.reason} />;\n * if (error?.kind === \"api\") return <ApiError status={error.status} code={error.code} />;\n * if (error) return <GenericError message={error.message} />;\n */\nexport class SymmioRequestError extends Error {\n  override readonly name = \"SymmioRequestError\";\n  /** Classification used by the UI to branch on this failure. */\n  readonly kind: SymmioNormalizedErrorKind;\n  /** SDK error code (e.g., \"FETCH_MARKETS_FAILED\"). */\n  readonly code?: string;\n  /** HTTP status code when `kind === \"api\"`. */\n  readonly status?: number;\n  /** Raw response body returned by the server when `kind === \"api\"`. */\n  readonly responseData?: unknown;\n  /** Solidity revert reason when `kind === \"contract-revert\"`. */\n  readonly reason?: string;\n  /** viem's short message when `kind === \"rpc\"`. */\n  readonly shortMessage?: string;\n\n  constructor(options: SymmioRequestErrorOptions) {\n    super(options.message, { cause: options.cause });\n    this.kind = options.kind;\n    this.code = options.code;\n    this.status = options.status;\n    this.responseData = options.responseData;\n    this.reason = options.reason;\n    this.shortMessage = options.shortMessage;\n  }\n}\n"],"mappings":";AAuCA,IAAa,IAAb,cAAwC,MAAM;CAC5C,OAAyB;CAEzB;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA,YAAY,GAAoC;EAO9C,AANA,MAAM,EAAQ,SAAS,EAAE,OAAO,EAAQ,MAAM,CAAC,GAC/C,KAAK,OAAO,EAAQ,MACpB,KAAK,OAAO,EAAQ,MACpB,KAAK,SAAS,EAAQ,QACtB,KAAK,eAAe,EAAQ,cAC5B,KAAK,SAAS,EAAQ,QACtB,KAAK,eAAe,EAAQ;CAC9B;AACF"}

package/dist/errors/types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Classification of a normalized SYMMIO SDK error. The discriminator the UI
+ * switches on to decide how to render a failed read or write.
+ *
+ * - `user-rejected` — the connected wallet popup was dismissed by the user.
+ *   UIs typically silence this case (no toast, no banner).
+ * - `contract-revert` — the on-chain call reverted. `reason` carries the
+ *   Solidity revert string when one was emitted.
+ * - `insufficient-funds` — the signing EOA had not enough native gas to send
+ *   the transaction. Distinct from `contract-revert` because there is no
+ *   revert reason and the remediation is "top up the wallet".
+ * - `rpc` — a transport-layer failure (network, RPC node unreachable, bad
+ *   response). `shortMessage` carries viem's human-readable form.
+ * - `api` — an HTTP/REST API failure (solver, price service, etc). `status`
+ *   carries the HTTP status code, `code` carries the SDK error code.
+ * - `sdk` — an SDK-level precondition failed: unknown chain, missing config,
+ *   missing wallet, etc. `code` carries the SDK error code.
+ * - `unknown` — fell through every classifier. Treat as a real bug to fix.
+ */
+export type SymmioNormalizedErrorKind = "user-rejected" | "contract-revert" | "insufficient-funds" | "rpc" | "api" | "sdk" | "unknown";
+//# sourceMappingURL=types.d.ts.map

package/dist/errors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/errors/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,yBAAyB,GACjC,eAAe,GACf,iBAAiB,GACjB,oBAAoB,GACpB,KAAK,GACL,KAAK,GACL,KAAK,GACL,SAAS,CAAC"}

package/dist/fees/index.d.ts

@@ -0,0 +1,2 @@
+export * from './use-fee-for-user';
+//# sourceMappingURL=index.d.ts.map

package/dist/fees/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fees/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/fees/use-fee-for-user.d.ts

@@ -0,0 +1,25 @@
+import { ConfigParameter, GetFeeForUserOptions, GetFeeForUserReturnType } from '@symmio/trading-core';
+import { UseQueryResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error';
+/**
+ * Parameters for {@link useFeeForUser}: the core query options (user, symbol id,
+ * optional affiliate, chain id, TanStack `query` overrides) plus an optional
+ * `config`.
+ */
+export type UseFeeForUserParameters = GetFeeForUserOptions & ConfigParameter;
+/** Return type of {@link useFeeForUser}. */
+export type UseFeeForUserReturnType = UseQueryResult<GetFeeForUserReturnType, SymmioRequestError>;
+/**
+ * Read SYMMIO fee settings for a user/account and symbol id.
+ *
+ * Omitted `affiliate` resolves through the chain config. Omitted `chainId`
+ * resolves through the connected SYMMIO chain. Errors are normalized to
+ * {@link SymmioRequestError}.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useFeeForUser({ user, symbolId: 1n });
+ * ```
+ */
+export declare function useFeeForUser(parameters: UseFeeForUserParameters): UseFeeForUserReturnType;
+//# sourceMappingURL=use-fee-for-user.d.ts.map

package/dist/fees/use-fee-for-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-fee-for-user.d.ts","sourceRoot":"","sources":["../../src/fees/use-fee-for-user.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,GAAG,eAAe,CAAC;AAE7E,4CAA4C;AAC5C,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAC,uBAAuB,EAAE,kBAAkB,CAAC,CAAC;AAElG;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,uBAAuB,GAAG,uBAAuB,CAkB1F"}

package/dist/fees/use-fee-for-user.js

@@ -0,0 +1,27 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
+import { getFeeForUserQueryOptions as r } from "@symmio/trading-core";
+import { useQuery as i } from "@tanstack/react-query";
+//#region src/fees/use-fee-for-user.ts
+function a(a) {
+	let o = t(a), s = e(), c = r(o, {
+		...a,
+		chainId: a.chainId ?? s
+	});
+	return i({
+		...c,
+		queryFn: async () => {
+			try {
+				return await c.queryFn();
+			} catch (e) {
+				throw n(e);
+			}
+		}
+	});
+}
+//#endregion
+export { a as useFeeForUser };
+
+//# sourceMappingURL=use-fee-for-user.js.map

package/dist/fees/use-fee-for-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-fee-for-user.js","names":[],"sources":["../../src/fees/use-fee-for-user.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getFeeForUserQueryOptions,\n  type ConfigParameter,\n  type GetFeeForUserOptions,\n  type GetFeeForUserReturnType,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/**\n * Parameters for {@link useFeeForUser}: the core query options (user, symbol id,\n * optional affiliate, chain id, TanStack `query` overrides) plus an optional\n * `config`.\n */\nexport type UseFeeForUserParameters = GetFeeForUserOptions & ConfigParameter;\n\n/** Return type of {@link useFeeForUser}. */\nexport type UseFeeForUserReturnType = UseQueryResult<GetFeeForUserReturnType, SymmioRequestError>;\n\n/**\n * Read SYMMIO fee settings for a user/account and symbol id.\n *\n * Omitted `affiliate` resolves through the chain config. Omitted `chainId`\n * resolves through the connected SYMMIO chain. Errors are normalized to\n * {@link SymmioRequestError}.\n *\n * @example\n * ```tsx\n * const { data } = useFeeForUser({ user, symbolId: 1n });\n * ```\n */\nexport function useFeeForUser(parameters: UseFeeForUserParameters): UseFeeForUserReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const options = getFeeForUserQueryOptions(config, {\n    ...parameters,\n    chainId: parameters.chainId ?? chainId,\n  });\n\n  return useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseFeeForUserReturnType;\n}\n"],"mappings":";;;;;;;AAoCA,SAAgB,EAAc,GAA8D;CAC1F,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAU,EAA0B,GAAQ;EAChD,GAAG;EACH,SAAS,EAAW,WAAW;CACjC,CAAC;CAED,OAAO,EAAS;EACd,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;AACH"}