@symmio/trading-core 1.1.0 → 2.0.0

package/dist/pools/markets/index.d.ts

@@ -0,0 +1,5 @@
+export * from './get-listing-markets.js';
+export * from './query.js';
+export * from './to-listing-market.js';
+export * from './to-search-params.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/pools/markets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pools/markets/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/pools/markets/query.d.ts

@@ -0,0 +1,36 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ConfigKeyParameter } from '../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query.js';
+import { GetListingMarketsParameters, GetListingMarketsReturnType } from './get-listing-markets.js';
+/** Data resolved by the {@link getListingMarketsQueryOptions} query. */
+export type GetListingMarketsData = GetListingMarketsReturnType;
+/**
+ * Build the TanStack Query key for {@link getListingMarketsQueryOptions}.
+ *
+ * @param options - Search parameters plus the resolved config key.
+ * @returns A stable, hashable query key.
+ */
+export declare function getListingMarketsQueryKey(options: Compute<GetListingMarketsParameters & ConfigKeyParameter>): readonly ["getListingMarkets", Record<string, unknown>];
+/** Query-key type produced by {@link getListingMarketsQueryKey}. */
+export type GetListingMarketsQueryKey = ReturnType<typeof getListingMarketsQueryKey>;
+/**
+ * Options accepted by {@link getListingMarketsQueryOptions}: the action's
+ * parameters, an optional cache scope, and TanStack overrides.
+ */
+export type GetListingMarketsOptions = Compute<GetListingMarketsParameters & QueryParameter<GetListingMarketsData, Error, GetListingMarketsData, GetListingMarketsQueryKey>>;
+/** TanStack Query options returned by {@link getListingMarketsQueryOptions}. */
+export type GetListingMarketsQueryOptions = SymmioQueryOptions<GetListingMarketsData, Error, GetListingMarketsData, GetListingMarketsQueryKey>;
+/**
+ * Build TanStack Query options for {@link getListingMarkets}.
+ *
+ * @param config - The SDK config.
+ * @param options - Search parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(getListingMarketsQueryOptions(config, { sortBy: "tvl", limit: 50 }));
+ * ```
+ */
+export declare function getListingMarketsQueryOptions(config: Config, options?: GetListingMarketsOptions): GetListingMarketsQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/pools/markets/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/pools/markets/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EACjC,MAAM,uBAAuB,CAAC;AAE/B,wEAAwE;AACxE,MAAM,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,CAAC,2BAA2B,GAAG,kBAAkB,CAAC,2DAE3G;AAED,oEAAoE;AACpE,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAErF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAC5C,2BAA2B,GACzB,cAAc,CAAC,qBAAqB,EAAE,KAAK,EAAE,qBAAqB,EAAE,yBAAyB,CAAC,CACjG,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,6BAA6B,GAAG,kBAAkB,CAC5D,qBAAqB,EACrB,KAAK,EACL,qBAAqB,EACrB,yBAAyB,CAC1B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,wBAA6B,GACrC,6BAA6B,CAqB/B"}

package/dist/pools/markets/query.js

@@ -0,0 +1,31 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { getListingMarkets as t } from "./get-listing-markets.js";
+//#region src/pools/markets/query.ts
+function n(t) {
+	return ["getListingMarkets", e(t)];
+}
+function r(e, r = {}) {
+	return {
+		...r.query,
+		queryKey: n({
+			...r,
+			configKey: e.getChainConfigKey(r.chainId)
+		}),
+		enabled: r.query?.enabled ?? !0,
+		queryFn: () => t(e, {
+			chainId: r.chainId,
+			search: r.search,
+			chainIds: r.chainIds,
+			marketStatus: r.marketStatus,
+			limit: r.limit,
+			offset: r.offset,
+			sortBy: r.sortBy,
+			orderBy: r.orderBy,
+			filters: r.filters
+		})
+	};
+}
+//#endregion
+export { n as getListingMarketsQueryKey, r as getListingMarketsQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/pools/markets/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/pools/markets/query.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { Compute, ConfigKeyParameter } from \"../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../shared/types/query\";\nimport { filterQueryOptions } from \"../../shared/utils/query\";\nimport {\n  getListingMarkets,\n  type GetListingMarketsParameters,\n  type GetListingMarketsReturnType,\n} from \"./get-listing-markets\";\n\n/** Data resolved by the {@link getListingMarketsQueryOptions} query. */\nexport type GetListingMarketsData = GetListingMarketsReturnType;\n\n/**\n * Build the TanStack Query key for {@link getListingMarketsQueryOptions}.\n *\n * @param options - Search parameters plus the resolved config key.\n * @returns A stable, hashable query key.\n */\nexport function getListingMarketsQueryKey(options: Compute<GetListingMarketsParameters & ConfigKeyParameter>) {\n  return [\"getListingMarkets\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getListingMarketsQueryKey}. */\nexport type GetListingMarketsQueryKey = ReturnType<typeof getListingMarketsQueryKey>;\n\n/**\n * Options accepted by {@link getListingMarketsQueryOptions}: the action's\n * parameters, an optional cache scope, and TanStack overrides.\n */\nexport type GetListingMarketsOptions = Compute<\n  GetListingMarketsParameters &\n    QueryParameter<GetListingMarketsData, Error, GetListingMarketsData, GetListingMarketsQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getListingMarketsQueryOptions}. */\nexport type GetListingMarketsQueryOptions = SymmioQueryOptions<\n  GetListingMarketsData,\n  Error,\n  GetListingMarketsData,\n  GetListingMarketsQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getListingMarkets}.\n *\n * @param config - The SDK config.\n * @param options - Search parameters and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * useQuery(getListingMarketsQueryOptions(config, { sortBy: \"tvl\", limit: 50 }));\n * ```\n */\nexport function getListingMarketsQueryOptions(\n  config: Config,\n  options: GetListingMarketsOptions = {},\n): GetListingMarketsQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getListingMarketsQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () =>\n      getListingMarkets(config, {\n        chainId: options.chainId,\n        search: options.search,\n        chainIds: options.chainIds,\n        marketStatus: options.marketStatus,\n        limit: options.limit,\n        offset: options.offset,\n        sortBy: options.sortBy,\n        orderBy: options.orderBy,\n        filters: options.filters,\n      }),\n  };\n}\n"],"mappings":";;;AAmBA,SAAgB,EAA0B,GAAoE;CAC5G,OAAO,CAAC,qBAAqB,EAAmB,CAAO,CAAC;AAC1D;AAkCA,SAAgB,EACd,GACA,IAAoC,CAAC,GACN;CAC/B,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA0B;GAClC,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,SAAS,EAAQ,OAAO,WAAW;EACnC,eACE,EAAkB,GAAQ;GACxB,SAAS,EAAQ;GACjB,QAAQ,EAAQ;GAChB,UAAU,EAAQ;GAClB,cAAc,EAAQ;GACtB,OAAO,EAAQ;GACf,QAAQ,EAAQ;GAChB,QAAQ,EAAQ;GAChB,SAAS,EAAQ;GACjB,SAAS,EAAQ;EACnB,CAAC;CACL;AACF"}

package/dist/pools/markets/to-listing-market.d.ts

@@ -0,0 +1,65 @@
+import { ListingMarket, ListingMarketPage } from '../types.js';
+import { MarketSearchItem, PaginationResponseMarketSearchItem } from '../types/generated/listing-backend.js';
+/**
+ * Parse one of the service's 18-decimal value strings into a `bigint`.
+ *
+ * Returns `null` for `null`, `undefined`, and the empty string — an absent
+ * figure is not zero, and collapsing the two would make a market with no 30-day
+ * history indistinguishable from one that earned nothing.
+ *
+ * The service's own schema types these as plain unsigned decimal strings, but
+ * live responses are looser than that in three ways, all handled here:
+ *
+ * - **Signs.** APY and uPnL fields go negative; a leading `-` is preserved.
+ * - **Fractional tails.** `long_position_upnl` arrives as
+ *   `"22411664984426494286154.904298"`, which `BigInt()` would reject. The
+ *   fraction is truncated toward zero.
+ * - **Scientific notation.** uPnL fields also arrive as `"0E-36"` (a Python
+ *   `Decimal` serialization). Every live instance is zero today, so a parser
+ *   that rejected the form would still *look* correct — but a tiny non-zero
+ *   uPnL would then silently read as `0`. The exponent is applied instead.
+ */
+export declare function toListingValue(raw: string | null | undefined): bigint | null;
+/**
+ * Parse a **human-decimal** listing figure — a plain dollar/token amount like
+ * `"0.037699391270769714"` — into a `bigint` at {@link LISTING_VALUE_DECIMALS}
+ * (18), scaling it **up** by `1e18`.
+ *
+ * This is the counterpart to {@link toListingValue}, not a variant of it. Most of
+ * the listing API's money fields arrive already 1e18-scaled (`"5300000000000000000"`
+ * = `5.3`), and `toListingValue` reads those by truncating a fractional dust tail.
+ * A few fields — notably `claimable_reward` on `/v2/profit` — instead arrive in
+ * **plain units** (`"0.0377"` = `$0.0377`); feeding those to `toListingValue`
+ * would truncate the whole value to its integer part (here `0n`). Use this to
+ * scale them into the SDK's uniform 18-decimal `bigint` instead.
+ *
+ * Returns `null` for a null / empty / unparseable value; a value with more than
+ * 18 fractional digits is rounded by `parseUnits`.
+ *
+ * @param raw - The wire string, in plain (un-scaled) decimal units.
+ * @returns The value at `LISTING_VALUE_DECIMALS`, or `null`.
+ */
+export declare function parseListingValue(raw: string | null | undefined): bigint | null;
+/**
+ * Map one raw `MarketSearchItem` from the listing service into the SDK's
+ * {@link ListingMarket}.
+ *
+ * Value fields become `bigint` at {@link ListingMarket} scale, absent figures
+ * stay `null`, and the wire's snake_case becomes the SDK's camelCase.
+ *
+ * @param raw - One row of the service's `/v2/market/search` response.
+ * @returns The normalized market.
+ */
+export declare function toListingMarket(raw: MarketSearchItem): ListingMarket;
+/**
+ * Map the service's paginated envelope into a {@link ListingMarketPage}.
+ *
+ * The generated schema marks every envelope field optional (the service declares
+ * defaults rather than requiring them), so each is defaulted here: counts to `0`
+ * and `items` to an empty array.
+ *
+ * @param raw - The service's `/v2/market/search` response body.
+ * @returns The normalized page.
+ */
+export declare function toListingMarketPage(raw: PaginationResponseMarketSearchItem): ListingMarketPage;
+//# sourceMappingURL=to-listing-market.d.ts.map

package/dist/pools/markets/to-listing-market.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-listing-market.d.ts","sourceRoot":"","sources":["../../../src/pools/markets/to-listing-market.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EAEvB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,gBAAgB,EAAE,kCAAkC,EAAE,MAAM,oCAAoC,CAAC;AAE/G;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CA2B5E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAW/E;AA2BD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,gBAAgB,GAAG,aAAa,CAqBpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,kCAAkC,GAAG,iBAAiB,CAO9F"}

package/dist/pools/markets/to-listing-market.js

@@ -0,0 +1,76 @@
+import "../types.js";
+import { parseUnits as e } from "viem";
+//#region src/pools/markets/to-listing-market.ts
+function t(e) {
+	if (e == null) return null;
+	let t = e.trim();
+	if (t === "") return null;
+	let n = /^([+-]?)(\d*)(?:\.(\d*))?(?:[eE]([+-]?\d+))?$/.exec(t);
+	if (n === null) return null;
+	let [, r = "", i = "", a = "", o] = n;
+	if (i === "" && a === "") return null;
+	let s = `${i}${a}`, c = i.length + (o === void 0 ? 0 : Number(o));
+	if (c <= 0) return 0n;
+	let l = c >= s.length ? s.padEnd(c, "0") : s.slice(0, c), u = BigInt(l);
+	return r === "-" ? -u : u;
+}
+function n(t) {
+	if (t == null) return null;
+	let n = t.trim();
+	if (n === "") return null;
+	try {
+		return e(n, 18);
+	} catch {
+		return null;
+	}
+}
+function r(e, n) {
+	let r = e;
+	return {
+		h1: t(r[`${n}_1h`]),
+		h6: t(r[`${n}_6h`]),
+		h24: t(r[`${n}_24h`]),
+		d30: t(r[`${n}_30d`])
+	};
+}
+function i(e, n) {
+	let i = e;
+	return {
+		...r(e, n),
+		lifetime: t(i[`${n}_lifetime`])
+	};
+}
+function a(e) {
+	return {
+		contractAddress: e.contract_address,
+		chainId: e.chain_id,
+		symbolId: e.symbol_id ?? null,
+		tokenTicker: e.token_ticker,
+		tokenName: e.token_name,
+		maxLeverage: e.max_leverage,
+		marketCap: t(e.market_cap),
+		vol24h: t(e.vol24h),
+		tvl: t(e.tvl),
+		liquidity: t(e.liquidity),
+		openInterest: t(e.open_interest),
+		reward24h: t(e.reward_24h),
+		apr: t(e.apr),
+		aprByWindow: r(e, "apr"),
+		tvlDrivenApy: i(e, "tvl_driven_apy"),
+		priceDrivenApy: i(e, "price_driven_apy"),
+		listingTime: e.listing_time ?? null,
+		marketStatus: e.market_status
+	};
+}
+function o(e) {
+	return {
+		total: e.total ?? 0,
+		limit: e.limit ?? 0,
+		offset: e.offset ?? 0,
+		items: (e.items ?? []).map(a)
+	};
+}
+//#endregion
+export { n as parseListingValue, a as toListingMarket, o as toListingMarketPage, t as toListingValue };
+
+//# sourceMappingURL=to-listing-market.js.map

package/dist/pools/markets/to-listing-market.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-listing-market.js","names":[],"sources":["../../../src/pools/markets/to-listing-market.ts"],"sourcesContent":["import { parseUnits } from \"viem\";\nimport {\n  LISTING_VALUE_DECIMALS,\n  ListingDepositChainId,\n  ListingMarketStatus,\n  type ListingApyWindows,\n  type ListingMarket,\n  type ListingMarketPage,\n  type ListingTrailingWindows,\n} from \"../types\";\nimport type { MarketSearchItem, PaginationResponseMarketSearchItem } from \"../types/generated/listing-backend\";\n\n/**\n * Parse one of the service's 18-decimal value strings into a `bigint`.\n *\n * Returns `null` for `null`, `undefined`, and the empty string — an absent\n * figure is not zero, and collapsing the two would make a market with no 30-day\n * history indistinguishable from one that earned nothing.\n *\n * The service's own schema types these as plain unsigned decimal strings, but\n * live responses are looser than that in three ways, all handled here:\n *\n * - **Signs.** APY and uPnL fields go negative; a leading `-` is preserved.\n * - **Fractional tails.** `long_position_upnl` arrives as\n *   `\"22411664984426494286154.904298\"`, which `BigInt()` would reject. The\n *   fraction is truncated toward zero.\n * - **Scientific notation.** uPnL fields also arrive as `\"0E-36\"` (a Python\n *   `Decimal` serialization). Every live instance is zero today, so a parser\n *   that rejected the form would still *look* correct — but a tiny non-zero\n *   uPnL would then silently read as `0`. The exponent is applied instead.\n */\nexport function toListingValue(raw: string | null | undefined): bigint | null {\n  if (raw === null || raw === undefined) return null;\n\n  const trimmed = raw.trim();\n  if (trimmed === \"\") return null;\n\n  const match = /^([+-]?)(\\d*)(?:\\.(\\d*))?(?:[eE]([+-]?\\d+))?$/.exec(trimmed);\n  if (match === null) return null;\n\n  const [, sign = \"\", intPart = \"\", fracPart = \"\", exponentPart] = match;\n  if (intPart === \"\" && fracPart === \"\") return null;\n\n  /**\n   * Shift the decimal point by the exponent, then truncate. Working on the digit\n   * string rather than via `10n ** exponent` keeps a large negative exponent\n   * (`E-36`) from being an expensive division, and truncates toward zero for\n   * free.\n   */\n  const digits = `${intPart}${fracPart}`;\n  const pointIndex = intPart.length + (exponentPart === undefined ? 0 : Number(exponentPart));\n\n  if (pointIndex <= 0) return 0n;\n\n  const integerDigits = pointIndex >= digits.length ? digits.padEnd(pointIndex, \"0\") : digits.slice(0, pointIndex);\n\n  const magnitude = BigInt(integerDigits);\n  return sign === \"-\" ? -magnitude : magnitude;\n}\n\n/**\n * Parse a **human-decimal** listing figure — a plain dollar/token amount like\n * `\"0.037699391270769714\"` — into a `bigint` at {@link LISTING_VALUE_DECIMALS}\n * (18), scaling it **up** by `1e18`.\n *\n * This is the counterpart to {@link toListingValue}, not a variant of it. Most of\n * the listing API's money fields arrive already 1e18-scaled (`\"5300000000000000000\"`\n * = `5.3`), and `toListingValue` reads those by truncating a fractional dust tail.\n * A few fields — notably `claimable_reward` on `/v2/profit` — instead arrive in\n * **plain units** (`\"0.0377\"` = `$0.0377`); feeding those to `toListingValue`\n * would truncate the whole value to its integer part (here `0n`). Use this to\n * scale them into the SDK's uniform 18-decimal `bigint` instead.\n *\n * Returns `null` for a null / empty / unparseable value; a value with more than\n * 18 fractional digits is rounded by `parseUnits`.\n *\n * @param raw - The wire string, in plain (un-scaled) decimal units.\n * @returns The value at `LISTING_VALUE_DECIMALS`, or `null`.\n */\nexport function parseListingValue(raw: string | null | undefined): bigint | null {\n  if (raw === null || raw === undefined) return null;\n\n  const trimmed = raw.trim();\n  if (trimmed === \"\") return null;\n\n  try {\n    return parseUnits(trimmed, LISTING_VALUE_DECIMALS);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Map the four trailing windows of a metric whose wire keys share `prefix`.\n *\n * @param raw - The response row.\n * @param prefix - Wire key prefix, e.g. `\"apr\"` for `apr_1h` … `apr_30d`.\n */\nfunction toTrailingWindows(raw: MarketSearchItem, prefix: string): ListingTrailingWindows {\n  const row = raw as unknown as Record<string, string | null | undefined>;\n  return {\n    h1: toListingValue(row[`${prefix}_1h`]),\n    h6: toListingValue(row[`${prefix}_6h`]),\n    h24: toListingValue(row[`${prefix}_24h`]),\n    d30: toListingValue(row[`${prefix}_30d`]),\n  };\n}\n\n/** Map the trailing windows plus the lifetime column of an APY series. */\nfunction toApyWindows(raw: MarketSearchItem, prefix: string): ListingApyWindows {\n  const row = raw as unknown as Record<string, string | null | undefined>;\n  return {\n    ...toTrailingWindows(raw, prefix),\n    lifetime: toListingValue(row[`${prefix}_lifetime`]),\n  };\n}\n\n/**\n * Map one raw `MarketSearchItem` from the listing service into the SDK's\n * {@link ListingMarket}.\n *\n * Value fields become `bigint` at {@link ListingMarket} scale, absent figures\n * stay `null`, and the wire's snake_case becomes the SDK's camelCase.\n *\n * @param raw - One row of the service's `/v2/market/search` response.\n * @returns The normalized market.\n */\nexport function toListingMarket(raw: MarketSearchItem): ListingMarket {\n  return {\n    contractAddress: raw.contract_address,\n    chainId: raw.chain_id as ListingDepositChainId,\n    symbolId: raw.symbol_id ?? null,\n    tokenTicker: raw.token_ticker,\n    tokenName: raw.token_name,\n    maxLeverage: raw.max_leverage,\n    marketCap: toListingValue(raw.market_cap),\n    vol24h: toListingValue(raw.vol24h),\n    tvl: toListingValue(raw.tvl),\n    liquidity: toListingValue(raw.liquidity),\n    openInterest: toListingValue(raw.open_interest),\n    reward24h: toListingValue(raw.reward_24h),\n    apr: toListingValue(raw.apr),\n    aprByWindow: toTrailingWindows(raw, \"apr\"),\n    tvlDrivenApy: toApyWindows(raw, \"tvl_driven_apy\"),\n    priceDrivenApy: toApyWindows(raw, \"price_driven_apy\"),\n    listingTime: raw.listing_time ?? null,\n    marketStatus: raw.market_status as unknown as ListingMarketStatus,\n  };\n}\n\n/**\n * Map the service's paginated envelope into a {@link ListingMarketPage}.\n *\n * The generated schema marks every envelope field optional (the service declares\n * defaults rather than requiring them), so each is defaulted here: counts to `0`\n * and `items` to an empty array.\n *\n * @param raw - The service's `/v2/market/search` response body.\n * @returns The normalized page.\n */\nexport function toListingMarketPage(raw: PaginationResponseMarketSearchItem): ListingMarketPage {\n  return {\n    total: raw.total ?? 0,\n    limit: raw.limit ?? 0,\n    offset: raw.offset ?? 0,\n    items: (raw.items ?? []).map(toListingMarket),\n  };\n}\n"],"mappings":";;;AA+BA,SAAgB,EAAe,GAA+C;CAC5E,IAAI,KAAQ,MAA2B,OAAO;CAE9C,IAAM,IAAU,EAAI,KAAK;CACzB,IAAI,MAAY,IAAI,OAAO;CAE3B,IAAM,IAAQ,gDAAgD,KAAK,CAAO;CAC1E,IAAI,MAAU,MAAM,OAAO;CAE3B,IAAM,GAAG,IAAO,IAAI,IAAU,IAAI,IAAW,IAAI,KAAgB;CACjE,IAAI,MAAY,MAAM,MAAa,IAAI,OAAO;CAQ9C,IAAM,IAAS,GAAG,IAAU,KACtB,IAAa,EAAQ,UAAU,MAAiB,KAAA,IAAY,IAAI,OAAO,CAAY;CAEzF,IAAI,KAAc,GAAG,OAAO;CAE5B,IAAM,IAAgB,KAAc,EAAO,SAAS,EAAO,OAAO,GAAY,GAAG,IAAI,EAAO,MAAM,GAAG,CAAU,GAEzG,IAAY,OAAO,CAAa;CACtC,OAAO,MAAS,MAAM,CAAC,IAAY;AACrC;AAqBA,SAAgB,EAAkB,GAA+C;CAC/E,IAAI,KAAQ,MAA2B,OAAO;CAE9C,IAAM,IAAU,EAAI,KAAK;CACzB,IAAI,MAAY,IAAI,OAAO;CAE3B,IAAI;EACF,OAAO,EAAW,GAAA,EAA+B;CACnD,QAAQ;EACN,OAAO;CACT;AACF;AAQA,SAAS,EAAkB,GAAuB,GAAwC;CACxF,IAAM,IAAM;CACZ,OAAO;EACL,IAAI,EAAe,EAAI,GAAG,EAAO,KAAK;EACtC,IAAI,EAAe,EAAI,GAAG,EAAO,KAAK;EACtC,KAAK,EAAe,EAAI,GAAG,EAAO,MAAM;EACxC,KAAK,EAAe,EAAI,GAAG,EAAO,MAAM;CAC1C;AACF;AAGA,SAAS,EAAa,GAAuB,GAAmC;CAC9E,IAAM,IAAM;CACZ,OAAO;EACL,GAAG,EAAkB,GAAK,CAAM;EAChC,UAAU,EAAe,EAAI,GAAG,EAAO,WAAW;CACpD;AACF;AAYA,SAAgB,EAAgB,GAAsC;CACpE,OAAO;EACL,iBAAiB,EAAI;EACrB,SAAS,EAAI;EACb,UAAU,EAAI,aAAa;EAC3B,aAAa,EAAI;EACjB,WAAW,EAAI;EACf,aAAa,EAAI;EACjB,WAAW,EAAe,EAAI,UAAU;EACxC,QAAQ,EAAe,EAAI,MAAM;EACjC,KAAK,EAAe,EAAI,GAAG;EAC3B,WAAW,EAAe,EAAI,SAAS;EACvC,cAAc,EAAe,EAAI,aAAa;EAC9C,WAAW,EAAe,EAAI,UAAU;EACxC,KAAK,EAAe,EAAI,GAAG;EAC3B,aAAa,EAAkB,GAAK,KAAK;EACzC,cAAc,EAAa,GAAK,gBAAgB;EAChD,gBAAgB,EAAa,GAAK,kBAAkB;EACpD,aAAa,EAAI,gBAAgB;EACjC,cAAc,EAAI;CACpB;AACF;AAYA,SAAgB,EAAoB,GAA4D;CAC9F,OAAO;EACL,OAAO,EAAI,SAAS;EACpB,OAAO,EAAI,SAAS;EACpB,QAAQ,EAAI,UAAU;EACtB,QAAQ,EAAI,SAAS,CAAC,GAAG,IAAI,CAAe;CAC9C;AACF"}

package/dist/pools/markets/to-search-params.d.ts

@@ -0,0 +1,36 @@
+import { ListingMarketFilters } from '../types.js';
+import { MarketSearchV2MarketSearchGetParams } from '../types/generated/listing-backend.js';
+/**
+ * Flatten {@link ListingMarketFilters} into the service's `{field}__ge` /
+ * `{field}__le` query params.
+ *
+ * `bigint` bounds are stringified rather than passed through: an 18-decimal
+ * value exceeds `Number.MAX_SAFE_INTEGER`, so serializing it as a number would
+ * round the bound. The service accepts the string form.
+ *
+ * @param filters - The SDK-shaped filters, or `undefined` for none.
+ * @returns A flat bag of wire params; empty when nothing is filtered.
+ */
+export declare function toFilterParams(filters?: ListingMarketFilters): Record<string, string>;
+/** Non-filter query inputs {@link toSearchParams} accepts. */
+export interface ToSearchParamsInput {
+    query?: string;
+    chainIds?: readonly number[];
+    marketStatus?: string;
+    limit?: number;
+    offset?: number;
+    sortBy?: string;
+    orderBy?: "asc" | "desc";
+    filters?: ListingMarketFilters;
+}
+/**
+ * Build the full `/v2/market/search` query bag from SDK-shaped inputs.
+ *
+ * Undefined inputs are omitted entirely rather than sent as empty values, so the
+ * service applies its own defaults (`limit=20`, `offset=0`, `order_by=desc`).
+ *
+ * @param input - SDK-shaped search inputs.
+ * @returns The wire query params.
+ */
+export declare function toSearchParams(input: ToSearchParamsInput): MarketSearchV2MarketSearchGetParams;
+//# sourceMappingURL=to-search-params.d.ts.map

package/dist/pools/markets/to-search-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-search-params.d.ts","sourceRoot":"","sources":["../../../src/pools/markets/to-search-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAuC,MAAM,UAAU,CAAC;AAC1F,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,oCAAoC,CAAC;AAoC9F;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcrF;AAED,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,mCAAmC,CAY9F"}

package/dist/pools/markets/to-search-params.js

@@ -0,0 +1,42 @@
+//#region src/pools/markets/to-search-params.ts
+var e = {
+	marketCap: "market_cap",
+	vol24h: "vol24h",
+	tvl: "tvl",
+	liquidity: "liquidity",
+	openInterest: "open_interest",
+	reward24h: "reward_24h",
+	apr: "apr",
+	apr1h: "apr_1h",
+	apr6h: "apr_6h",
+	apr24h: "apr_24h",
+	apr30d: "apr_30d",
+	tvlDrivenApy1h: "tvl_driven_apy_1h",
+	tvlDrivenApy6h: "tvl_driven_apy_6h",
+	tvlDrivenApy24h: "tvl_driven_apy_24h",
+	tvlDrivenApy30d: "tvl_driven_apy_30d",
+	tvlDrivenApy: "tvl_driven_apy",
+	priceDrivenApy1h: "price_driven_apy_1h",
+	priceDrivenApy6h: "price_driven_apy_6h",
+	priceDrivenApy24h: "price_driven_apy_24h",
+	priceDrivenApy30d: "price_driven_apy_30d",
+	priceDrivenApy: "price_driven_apy",
+	listingTime: "listing_time"
+};
+function t(t) {
+	if (t === void 0) return {};
+	let n = {};
+	for (let [r, i] of Object.entries(e)) {
+		let e = t[r];
+		e !== void 0 && (e.min !== void 0 && (n[`${i}__ge`] = String(e.min)), e.max !== void 0 && (n[`${i}__le`] = String(e.max)));
+	}
+	return n;
+}
+function n(e) {
+	let n = { ...t(e.filters) };
+	return e.query !== void 0 && (n.query = e.query), e.chainIds !== void 0 && (n.chain_ids = [...e.chainIds]), e.marketStatus !== void 0 && (n.market_status = e.marketStatus), e.limit !== void 0 && (n.limit = e.limit), e.offset !== void 0 && (n.offset = e.offset), e.sortBy !== void 0 && (n.sort_by = e.sortBy), e.orderBy !== void 0 && (n.order_by = e.orderBy), n;
+}
+//#endregion
+export { n as toSearchParams };
+
+//# sourceMappingURL=to-search-params.js.map

package/dist/pools/markets/to-search-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-search-params.js","names":[],"sources":["../../../src/pools/markets/to-search-params.ts"],"sourcesContent":["import type { ListingMarketFilters, ListingTimeRange, ListingValueRange } from \"../types\";\nimport type { MarketSearchV2MarketSearchGetParams } from \"../types/generated/listing-backend\";\n\n/**\n * SDK filter key to the wire field its `__ge` / `__le` bounds attach to.\n *\n * Kept as an explicit table rather than derived from the key name: several\n * fields do not round-trip through a naive camel-to-snake conversion\n * (`vol24h`, `apr24h` → `apr_24h`, `tvlDrivenApy` → `tvl_driven_apy`), and a\n * silent mismatch here is invisible — the service ignores unknown query params\n * and returns the unfiltered catalog.\n */\nconst FILTER_WIRE_FIELD = {\n  marketCap: \"market_cap\",\n  vol24h: \"vol24h\",\n  tvl: \"tvl\",\n  liquidity: \"liquidity\",\n  openInterest: \"open_interest\",\n  reward24h: \"reward_24h\",\n  apr: \"apr\",\n  apr1h: \"apr_1h\",\n  apr6h: \"apr_6h\",\n  apr24h: \"apr_24h\",\n  apr30d: \"apr_30d\",\n  tvlDrivenApy1h: \"tvl_driven_apy_1h\",\n  tvlDrivenApy6h: \"tvl_driven_apy_6h\",\n  tvlDrivenApy24h: \"tvl_driven_apy_24h\",\n  tvlDrivenApy30d: \"tvl_driven_apy_30d\",\n  tvlDrivenApy: \"tvl_driven_apy\",\n  priceDrivenApy1h: \"price_driven_apy_1h\",\n  priceDrivenApy6h: \"price_driven_apy_6h\",\n  priceDrivenApy24h: \"price_driven_apy_24h\",\n  priceDrivenApy30d: \"price_driven_apy_30d\",\n  priceDrivenApy: \"price_driven_apy\",\n  listingTime: \"listing_time\",\n} as const satisfies Record<keyof ListingMarketFilters, string>;\n\n/**\n * Flatten {@link ListingMarketFilters} into the service's `{field}__ge` /\n * `{field}__le` query params.\n *\n * `bigint` bounds are stringified rather than passed through: an 18-decimal\n * value exceeds `Number.MAX_SAFE_INTEGER`, so serializing it as a number would\n * round the bound. The service accepts the string form.\n *\n * @param filters - The SDK-shaped filters, or `undefined` for none.\n * @returns A flat bag of wire params; empty when nothing is filtered.\n */\nexport function toFilterParams(filters?: ListingMarketFilters): Record<string, string> {\n  if (filters === undefined) return {};\n\n  const params: Record<string, string> = {};\n\n  for (const [key, wireField] of Object.entries(FILTER_WIRE_FIELD)) {\n    const range = filters[key as keyof ListingMarketFilters] as ListingValueRange | ListingTimeRange | undefined;\n    if (range === undefined) continue;\n\n    if (range.min !== undefined) params[`${wireField}__ge`] = String(range.min);\n    if (range.max !== undefined) params[`${wireField}__le`] = String(range.max);\n  }\n\n  return params;\n}\n\n/** Non-filter query inputs {@link toSearchParams} accepts. */\nexport interface ToSearchParamsInput {\n  query?: string;\n  chainIds?: readonly number[];\n  marketStatus?: string;\n  limit?: number;\n  offset?: number;\n  sortBy?: string;\n  orderBy?: \"asc\" | \"desc\";\n  filters?: ListingMarketFilters;\n}\n\n/**\n * Build the full `/v2/market/search` query bag from SDK-shaped inputs.\n *\n * Undefined inputs are omitted entirely rather than sent as empty values, so the\n * service applies its own defaults (`limit=20`, `offset=0`, `order_by=desc`).\n *\n * @param input - SDK-shaped search inputs.\n * @returns The wire query params.\n */\nexport function toSearchParams(input: ToSearchParamsInput): MarketSearchV2MarketSearchGetParams {\n  const params: Record<string, unknown> = { ...toFilterParams(input.filters) };\n\n  if (input.query !== undefined) params.query = input.query;\n  if (input.chainIds !== undefined) params.chain_ids = [...input.chainIds];\n  if (input.marketStatus !== undefined) params.market_status = input.marketStatus;\n  if (input.limit !== undefined) params.limit = input.limit;\n  if (input.offset !== undefined) params.offset = input.offset;\n  if (input.sortBy !== undefined) params.sort_by = input.sortBy;\n  if (input.orderBy !== undefined) params.order_by = input.orderBy;\n\n  return params as MarketSearchV2MarketSearchGetParams;\n}\n"],"mappings":";AAYA,IAAM,IAAoB;CACxB,WAAW;CACX,QAAQ;CACR,KAAK;CACL,WAAW;CACX,cAAc;CACd,WAAW;CACX,KAAK;CACL,OAAO;CACP,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,gBAAgB;CAChB,gBAAgB;CAChB,iBAAiB;CACjB,iBAAiB;CACjB,cAAc;CACd,kBAAkB;CAClB,kBAAkB;CAClB,mBAAmB;CACnB,mBAAmB;CACnB,gBAAgB;CAChB,aAAa;AACf;AAaA,SAAgB,EAAe,GAAwD;CACrF,IAAI,MAAY,KAAA,GAAW,OAAO,CAAC;CAEnC,IAAM,IAAiC,CAAC;CAExC,KAAK,IAAM,CAAC,GAAK,MAAc,OAAO,QAAQ,CAAiB,GAAG;EAChE,IAAM,IAAQ,EAAQ;EAClB,MAAU,KAAA,MAEV,EAAM,QAAQ,KAAA,MAAW,EAAO,GAAG,EAAU,SAAS,OAAO,EAAM,GAAG,IACtE,EAAM,QAAQ,KAAA,MAAW,EAAO,GAAG,EAAU,SAAS,OAAO,EAAM,GAAG;CAC5E;CAEA,OAAO;AACT;AAuBA,SAAgB,EAAe,GAAiE;CAC9F,IAAM,IAAkC,EAAE,GAAG,EAAe,EAAM,OAAO,EAAE;CAU3E,OARI,EAAM,UAAU,KAAA,MAAW,EAAO,QAAQ,EAAM,QAChD,EAAM,aAAa,KAAA,MAAW,EAAO,YAAY,CAAC,GAAG,EAAM,QAAQ,IACnE,EAAM,iBAAiB,KAAA,MAAW,EAAO,gBAAgB,EAAM,eAC/D,EAAM,UAAU,KAAA,MAAW,EAAO,QAAQ,EAAM,QAChD,EAAM,WAAW,KAAA,MAAW,EAAO,SAAS,EAAM,SAClD,EAAM,WAAW,KAAA,MAAW,EAAO,UAAU,EAAM,SACnD,EAAM,YAAY,KAAA,MAAW,EAAO,WAAW,EAAM,UAElD;AACT"}

package/dist/pools/profit/get-user-profit.d.ts

@@ -0,0 +1,54 @@
+import { Config } from '../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../shared/types/properties.js';
+import { UserPoolProfit } from '../types.js';
+/**
+ * Parameters for {@link getUserProfit}.
+ *
+ * Pool listing is chain-level, so this takes only a `chainId`: the listing
+ * backend is resolved from the chain.
+ */
+export type GetUserProfitParameters = Compute<ChainIdParameter & {
+    /**
+     * Bearer token from `authenticateListing`; required — the endpoint is authed.
+     * Sent as the `Authorization: Bearer <token>` header; a bad or expired token
+     * yields a `401`.
+     */
+    accessToken: string;
+    /**
+     * The pool's token contract address — the id that addresses a single market
+     * in the listing API. An EVM `0x…` address, or a Solana base58 address for a
+     * Solana-deposited listing.
+     */
+    tokenContractAddress: string;
+}>;
+/** Return type of {@link getUserProfit}: the signed-in user's position in one pool. */
+export type GetUserProfitReturnType = UserPoolProfit;
+/**
+ * Fetch the signed-in user's LP position and profit in a single pool — their LP
+ * shares, LP balance valued in tokens and USDC, claimable and claimed rewards,
+ * deposited token amount, and the LP shares queued for withdrawal.
+ *
+ * This hits the authed `/v2/profit/{token_contract_address}` endpoint with the
+ * caller's bearer token. Every value is normalized to a `bigint` at
+ * `LISTING_VALUE_DECIMALS`, absent ones defaulting to `0n` — even though the wire
+ * is not uniform: most fields are 1e18-scaled integers, but `claimable_reward`
+ * arrives in plain decimal units and is scaled up (see `toUserPoolProfit`).
+ * Enigma-only.
+ *
+ * @param config - The SDK config.
+ * @param parameters - The bearer token and the pool's token contract address.
+ * @returns The user's {@link UserPoolProfit} for the pool.
+ * @throws {SymmApiError} when the endpoint request fails, including a `401` on a bad or expired token.
+ * @throws {SymmError} `LISTING_NOT_CONFIGURED` when the chain has no listing
+ *   backend. Gate with `supportsListingService` to hide Pools instead.
+ *
+ * @example
+ * ```ts
+ * const profit = await getUserProfit(config, {
+ *   accessToken: token.accessToken,
+ *   tokenContractAddress: "0x1234…",
+ * });
+ * ```
+ */
+export declare function getUserProfit(config: Config, parameters: GetUserProfitParameters): Promise<GetUserProfitReturnType>;
+//# sourceMappingURL=get-user-profit.d.ts.map

package/dist/pools/profit/get-user-profit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user-profit.d.ts","sourceRoot":"","sources":["../../../src/pools/profit/get-user-profit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAE/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI/C;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAC3C,gBAAgB,GAAG;IACjB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CACF,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,uBAAuB,GAClC,OAAO,CAAC,uBAAuB,CAAC,CAwBlC"}

package/dist/pools/profit/get-user-profit.js

@@ -0,0 +1,24 @@
+import { SymmApiError as e, SymmError as t } from "../../shared/errors/symm-error.js";
+import { resolveListingService as n } from "../resolve-listing.js";
+import { getProfitByTokenV2ProfitTokenContractAddressGet as r } from "../types/generated/listing-backend.js";
+import { toUserPoolProfit as i } from "./to-user-pool-profit.js";
+import { isAxiosError as a } from "axios";
+//#region src/pools/profit/get-user-profit.ts
+async function o(o, s) {
+	let { url: c } = n(o, { chainId: s.chainId });
+	try {
+		return i((await r(s.tokenContractAddress, {
+			baseURL: c,
+			headers: { Authorization: `Bearer ${s.accessToken}` }
+		})).data);
+	} catch (n) {
+		throw n instanceof t ? n : a(n) ? e.fromAxios(n, {
+			code: "FETCH_USER_PROFIT_FAILED",
+			baseURL: c
+		}) : new t("api", "FETCH_USER_PROFIT_FAILED", `Failed to fetch user profit: ${n instanceof Error ? n.message : String(n)}`, { cause: n instanceof Error ? n : void 0 });
+	}
+}
+//#endregion
+export { o as getUserProfit };
+
+//# sourceMappingURL=get-user-profit.js.map

package/dist/pools/profit/get-user-profit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user-profit.js","names":[],"sources":["../../../src/pools/profit/get-user-profit.ts"],"sourcesContent":["import { isAxiosError } from \"axios\";\nimport type { Config } from \"../../core/config\";\nimport { SymmApiError, SymmError } from \"../../shared/errors/symm-error\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport { resolveListingService } from \"../resolve-listing\";\nimport type { UserPoolProfit } from \"../types\";\nimport { getProfitByTokenV2ProfitTokenContractAddressGet } from \"../types/generated/listing-backend\";\nimport { toUserPoolProfit } from \"./to-user-pool-profit\";\n\n/**\n * Parameters for {@link getUserProfit}.\n *\n * Pool listing is chain-level, so this takes only a `chainId`: the listing\n * backend is resolved from the chain.\n */\nexport type GetUserProfitParameters = Compute<\n  ChainIdParameter & {\n    /**\n     * Bearer token from `authenticateListing`; required — the endpoint is authed.\n     * Sent as the `Authorization: Bearer <token>` header; a bad or expired token\n     * yields a `401`.\n     */\n    accessToken: string;\n    /**\n     * The pool's token contract address — the id that addresses a single market\n     * in the listing API. An EVM `0x…` address, or a Solana base58 address for a\n     * Solana-deposited listing.\n     */\n    tokenContractAddress: string;\n  }\n>;\n\n/** Return type of {@link getUserProfit}: the signed-in user's position in one pool. */\nexport type GetUserProfitReturnType = UserPoolProfit;\n\n/**\n * Fetch the signed-in user's LP position and profit in a single pool — their LP\n * shares, LP balance valued in tokens and USDC, claimable and claimed rewards,\n * deposited token amount, and the LP shares queued for withdrawal.\n *\n * This hits the authed `/v2/profit/{token_contract_address}` endpoint with the\n * caller's bearer token. Every value is normalized to a `bigint` at\n * `LISTING_VALUE_DECIMALS`, absent ones defaulting to `0n` — even though the wire\n * is not uniform: most fields are 1e18-scaled integers, but `claimable_reward`\n * arrives in plain decimal units and is scaled up (see `toUserPoolProfit`).\n * Enigma-only.\n *\n * @param config - The SDK config.\n * @param parameters - The bearer token and the pool's token contract address.\n * @returns The user's {@link UserPoolProfit} for the pool.\n * @throws {SymmApiError} when the endpoint request fails, including a `401` on a bad or expired token.\n * @throws {SymmError} `LISTING_NOT_CONFIGURED` when the chain has no listing\n *   backend. Gate with `supportsListingService` to hide Pools instead.\n *\n * @example\n * ```ts\n * const profit = await getUserProfit(config, {\n *   accessToken: token.accessToken,\n *   tokenContractAddress: \"0x1234…\",\n * });\n * ```\n */\nexport async function getUserProfit(\n  config: Config,\n  parameters: GetUserProfitParameters,\n): Promise<GetUserProfitReturnType> {\n  const { url: baseURL } = resolveListingService(config, { chainId: parameters.chainId });\n\n  try {\n    const response = await getProfitByTokenV2ProfitTokenContractAddressGet(parameters.tokenContractAddress, {\n      baseURL,\n      headers: { Authorization: `Bearer ${parameters.accessToken}` },\n    });\n\n    return toUserPoolProfit(response.data);\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n\n    if (isAxiosError(err)) {\n      throw SymmApiError.fromAxios(err, { code: \"FETCH_USER_PROFIT_FAILED\", baseURL });\n    }\n\n    throw new SymmError(\n      \"api\",\n      \"FETCH_USER_PROFIT_FAILED\",\n      `Failed to fetch user profit: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;;;;AA8DA,eAAsB,EACpB,GACA,GACkC;CAClC,IAAM,EAAE,KAAK,MAAY,EAAsB,GAAQ,EAAE,SAAS,EAAW,QAAQ,CAAC;CAEtF,IAAI;EAMF,OAAO,GAAiB,MALD,EAAgD,EAAW,sBAAsB;GACtG;GACA,SAAS,EAAE,eAAe,UAAU,EAAW,cAAc;EAC/D,CAAC,GAEgC,IAAI;CACvC,SAAS,GAAK;EAOZ,MANI,aAAe,IAAiB,IAEhC,EAAa,CAAG,IACZ,EAAa,UAAU,GAAK;GAAE,MAAM;GAA4B;EAAQ,CAAC,IAG3E,IAAI,EACR,OACA,4BACA,gCAAgC,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KAC/E,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}

package/dist/pools/profit/index.d.ts

@@ -0,0 +1,4 @@
+export * from './get-user-profit.js';
+export * from './query.js';
+export * from './to-user-pool-profit.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/pools/profit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pools/profit/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC"}

package/dist/pools/profit/query.d.ts

@@ -0,0 +1,41 @@
+import { Config } from '../../core/config/index.js';
+import { Compute, ConfigKeyParameter } from '../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query.js';
+import { GetUserProfitParameters, GetUserProfitReturnType } from './get-user-profit.js';
+/** Data resolved by the {@link getUserProfitQueryOptions} query. */
+export type GetUserProfitData = GetUserProfitReturnType;
+/**
+ * Build the TanStack Query key for {@link getUserProfitQueryOptions}.
+ *
+ * The bearer `accessToken` is dropped from the key by `filterQueryOptions` — it
+ * is a credential, not a cache dimension, so two calls that differ only by a
+ * refreshed token still hit the same cache entry (and the token never leaks into
+ * a devtools-visible key).
+ *
+ * @param options - The action's parameters (including `accessToken`) plus the resolved config key.
+ * @returns A stable, hashable query key.
+ */
+export declare function getUserProfitQueryKey(options: Compute<GetUserProfitParameters & ConfigKeyParameter>): readonly ["getUserProfit", Record<string, unknown>];
+/** Query-key type produced by {@link getUserProfitQueryKey}. */
+export type GetUserProfitQueryKey = ReturnType<typeof getUserProfitQueryKey>;
+/**
+ * Options accepted by {@link getUserProfitQueryOptions}: the action's parameters,
+ * an optional cache scope, and TanStack overrides.
+ */
+export type GetUserProfitOptions = Compute<GetUserProfitParameters & QueryParameter<GetUserProfitData, Error, GetUserProfitData, GetUserProfitQueryKey>>;
+/** TanStack Query options returned by {@link getUserProfitQueryOptions}. */
+export type GetUserProfitQueryOptions = SymmioQueryOptions<GetUserProfitData, Error, GetUserProfitData, GetUserProfitQueryKey>;
+/**
+ * Build TanStack Query options for {@link getUserProfit}.
+ *
+ * @param config - The SDK config.
+ * @param options - The action's parameters (including the required `accessToken`) and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(getUserProfitQueryOptions(config, { accessToken, tokenContractAddress: "0x1234…" }));
+ * ```
+ */
+export declare function getUserProfitQueryOptions(config: Config, options: GetUserProfitOptions): GetUserProfitQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/pools/profit/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/pools/profit/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,EAAiB,KAAK,uBAAuB,EAAE,KAAK,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE9G,oEAAoE;AACpE,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AAExD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,uBAAuB,GAAG,kBAAkB,CAAC,uDAEnG;AAED,gEAAgE;AAChE,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE7E;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,CACxC,uBAAuB,GAAG,cAAc,CAAC,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,CAAC,CAC7G,CAAC;AAEF,4EAA4E;AAC5E,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CACxD,iBAAiB,EACjB,KAAK,EACL,iBAAiB,EACjB,qBAAqB,CACtB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,yBAAyB,CAelH"}

package/dist/pools/profit/query.js

@@ -0,0 +1,25 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { getUserProfit as t } from "./get-user-profit.js";
+//#region src/pools/profit/query.ts
+function n(t) {
+	return ["getUserProfit", e(t)];
+}
+function r(e, r) {
+	return {
+		...r.query,
+		queryKey: n({
+			...r,
+			configKey: e.getChainConfigKey(r.chainId)
+		}),
+		enabled: r.query?.enabled ?? !0,
+		queryFn: () => t(e, {
+			chainId: r.chainId,
+			accessToken: r.accessToken,
+			tokenContractAddress: r.tokenContractAddress
+		})
+	};
+}
+//#endregion
+export { n as getUserProfitQueryKey, r as getUserProfitQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/pools/profit/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/pools/profit/query.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { Compute, ConfigKeyParameter } from \"../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../shared/types/query\";\nimport { filterQueryOptions } from \"../../shared/utils/query\";\nimport { getUserProfit, type GetUserProfitParameters, type GetUserProfitReturnType } from \"./get-user-profit\";\n\n/** Data resolved by the {@link getUserProfitQueryOptions} query. */\nexport type GetUserProfitData = GetUserProfitReturnType;\n\n/**\n * Build the TanStack Query key for {@link getUserProfitQueryOptions}.\n *\n * The bearer `accessToken` is dropped from the key by `filterQueryOptions` — it\n * is a credential, not a cache dimension, so two calls that differ only by a\n * refreshed token still hit the same cache entry (and the token never leaks into\n * a devtools-visible key).\n *\n * @param options - The action's parameters (including `accessToken`) plus the resolved config key.\n * @returns A stable, hashable query key.\n */\nexport function getUserProfitQueryKey(options: Compute<GetUserProfitParameters & ConfigKeyParameter>) {\n  return [\"getUserProfit\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getUserProfitQueryKey}. */\nexport type GetUserProfitQueryKey = ReturnType<typeof getUserProfitQueryKey>;\n\n/**\n * Options accepted by {@link getUserProfitQueryOptions}: the action's parameters,\n * an optional cache scope, and TanStack overrides.\n */\nexport type GetUserProfitOptions = Compute<\n  GetUserProfitParameters & QueryParameter<GetUserProfitData, Error, GetUserProfitData, GetUserProfitQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getUserProfitQueryOptions}. */\nexport type GetUserProfitQueryOptions = SymmioQueryOptions<\n  GetUserProfitData,\n  Error,\n  GetUserProfitData,\n  GetUserProfitQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getUserProfit}.\n *\n * @param config - The SDK config.\n * @param options - The action's parameters (including the required `accessToken`) and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * useQuery(getUserProfitQueryOptions(config, { accessToken, tokenContractAddress: \"0x1234…\" }));\n * ```\n */\nexport function getUserProfitQueryOptions(config: Config, options: GetUserProfitOptions): GetUserProfitQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getUserProfitQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () =>\n      getUserProfit(config, {\n        chainId: options.chainId,\n        accessToken: options.accessToken,\n        tokenContractAddress: options.tokenContractAddress,\n      }),\n  };\n}\n"],"mappings":";;;AAoBA,SAAgB,EAAsB,GAAgE;CACpG,OAAO,CAAC,iBAAiB,EAAmB,CAAO,CAAC;AACtD;AAiCA,SAAgB,EAA0B,GAAgB,GAA0D;CAClH,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAAsB;GAC9B,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,SAAS,EAAQ,OAAO,WAAW;EACnC,eACE,EAAc,GAAQ;GACpB,SAAS,EAAQ;GACjB,aAAa,EAAQ;GACrB,sBAAsB,EAAQ;EAChC,CAAC;CACL;AACF"}

package/dist/pools/profit/to-user-pool-profit.d.ts

@@ -0,0 +1,27 @@
+import { UserPoolProfit } from '../types.js';
+import { LPTokenProfitSchema } from '../types/generated/listing-backend.js';
+/**
+ * Map one raw `LPTokenProfitSchema` from the authed `/v2/profit/{token}` endpoint
+ * into the SDK's {@link UserPoolProfit}.
+ *
+ * Most fields arrive already 1e18-scaled and are read with {@link toListingValue}.
+ * The exception is `claimable_reward`, which the service reports in **plain
+ * decimal units** (`"0.0377"` = `$0.0377`, not `"37699391270769714"`) — it is
+ * scaled up with {@link parseListingValue} so the SDK still exposes a uniform
+ * 18-decimal `bigint`. Running it through `toListingValue` like the others would
+ * truncate the value to its integer part (`0n`).
+ *
+ * Every field is defaulted to `0n` when the service omits it or sends an empty
+ * value — a missing figure on this per-user read means "nothing here", so zero is
+ * the right collapse (unlike the catalog rows, where absent stays `null`).
+ *
+ * `availableLpAmount` is **derived**, not a wire field: the LP shares free to
+ * withdraw are the user's shares minus what is already queued
+ * (`userLpAmount − pendingWithdrawLpAmount`), floored at `0n` so a pending amount
+ * that meets or exceeds the balance never reads as negative.
+ *
+ * @param raw - The endpoint's `/v2/profit/{token_contract_address}` response body.
+ * @returns The normalized user pool profit.
+ */
+export declare function toUserPoolProfit(raw: LPTokenProfitSchema): UserPoolProfit;
+//# sourceMappingURL=to-user-pool-profit.d.ts.map

package/dist/pools/profit/to-user-pool-profit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-user-pool-profit.d.ts","sourceRoot":"","sources":["../../../src/pools/profit/to-user-pool-profit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,mBAAmB,GAAG,cAAc,CAczE"}

package/dist/pools/profit/to-user-pool-profit.js

@@ -0,0 +1,19 @@
+import { parseListingValue as e, toListingValue as t } from "../markets/to-listing-market.js";
+//#region src/pools/profit/to-user-pool-profit.ts
+function n(n) {
+	let r = t(n.user_lp_amount) ?? 0n, i = t(n.pending_withdraw_lp_amount) ?? 0n;
+	return {
+		userBalanceInTokens: t(n.user_balance_in_tokens) ?? 0n,
+		userBalanceInUsdc: t(n.user_balance_in_usdc) ?? 0n,
+		claimableReward: e(n.claimable_reward) ?? 0n,
+		claimedReward: t(n.claimed_reward) ?? 0n,
+		userDepositedTokenAmount: t(n.user_deposited_token_amount) ?? 0n,
+		userLpAmount: r,
+		pendingWithdrawLpAmount: i,
+		availableLpAmount: r > i ? r - i : 0n
+	};
+}
+//#endregion
+export { n as toUserPoolProfit };
+
+//# sourceMappingURL=to-user-pool-profit.js.map

package/dist/pools/profit/to-user-pool-profit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-user-pool-profit.js","names":[],"sources":["../../../src/pools/profit/to-user-pool-profit.ts"],"sourcesContent":["import { parseListingValue, toListingValue } from \"../markets/to-listing-market\";\nimport type { UserPoolProfit } from \"../types\";\nimport type { LPTokenProfitSchema } from \"../types/generated/listing-backend\";\n\n/**\n * Map one raw `LPTokenProfitSchema` from the authed `/v2/profit/{token}` endpoint\n * into the SDK's {@link UserPoolProfit}.\n *\n * Most fields arrive already 1e18-scaled and are read with {@link toListingValue}.\n * The exception is `claimable_reward`, which the service reports in **plain\n * decimal units** (`\"0.0377\"` = `$0.0377`, not `\"37699391270769714\"`) — it is\n * scaled up with {@link parseListingValue} so the SDK still exposes a uniform\n * 18-decimal `bigint`. Running it through `toListingValue` like the others would\n * truncate the value to its integer part (`0n`).\n *\n * Every field is defaulted to `0n` when the service omits it or sends an empty\n * value — a missing figure on this per-user read means \"nothing here\", so zero is\n * the right collapse (unlike the catalog rows, where absent stays `null`).\n *\n * `availableLpAmount` is **derived**, not a wire field: the LP shares free to\n * withdraw are the user's shares minus what is already queued\n * (`userLpAmount − pendingWithdrawLpAmount`), floored at `0n` so a pending amount\n * that meets or exceeds the balance never reads as negative.\n *\n * @param raw - The endpoint's `/v2/profit/{token_contract_address}` response body.\n * @returns The normalized user pool profit.\n */\nexport function toUserPoolProfit(raw: LPTokenProfitSchema): UserPoolProfit {\n  const userLpAmount = toListingValue(raw.user_lp_amount) ?? 0n;\n  const pendingWithdrawLpAmount = toListingValue(raw.pending_withdraw_lp_amount) ?? 0n;\n\n  return {\n    userBalanceInTokens: toListingValue(raw.user_balance_in_tokens) ?? 0n,\n    userBalanceInUsdc: toListingValue(raw.user_balance_in_usdc) ?? 0n,\n    claimableReward: parseListingValue(raw.claimable_reward) ?? 0n,\n    claimedReward: toListingValue(raw.claimed_reward) ?? 0n,\n    userDepositedTokenAmount: toListingValue(raw.user_deposited_token_amount) ?? 0n,\n    userLpAmount,\n    pendingWithdrawLpAmount,\n    availableLpAmount: userLpAmount > pendingWithdrawLpAmount ? userLpAmount - pendingWithdrawLpAmount : 0n,\n  };\n}\n"],"mappings":";;AA2BA,SAAgB,EAAiB,GAA0C;CACzE,IAAM,IAAe,EAAe,EAAI,cAAc,KAAK,IACrD,IAA0B,EAAe,EAAI,0BAA0B,KAAK;CAElF,OAAO;EACL,qBAAqB,EAAe,EAAI,sBAAsB,KAAK;EACnE,mBAAmB,EAAe,EAAI,oBAAoB,KAAK;EAC/D,iBAAiB,EAAkB,EAAI,gBAAgB,KAAK;EAC5D,eAAe,EAAe,EAAI,cAAc,KAAK;EACrD,0BAA0B,EAAe,EAAI,2BAA2B,KAAK;EAC7E;EACA;EACA,mBAAmB,IAAe,IAA0B,IAAe,IAA0B;CACvG;AACF"}