@gauntlet-xyz/sdk 2.5.0 → 3.0.1

package/dist/cjs/api/client.js

@@ -0,0 +1,171 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var client_exports = {};
+__export(client_exports, {
+  GauntletApi: () => GauntletApi
+});
+module.exports = __toCommonJS(client_exports);
+var import_http = require("./http");
+class GauntletApi {
+  constructor(config = {}) {
+    this.config = config;
+  }
+  get(path, query) {
+    return (0, import_http.apiGet)(this.config, path, query);
+  }
+  /** GET /health — service liveness (version + uptime). */
+  health() {
+    return this.get("/health");
+  }
+  /** GET /health/chains — per-chain indexer sync freshness. */
+  chainSyncStatus() {
+    return this.get("/health/chains");
+  }
+  /** GET /v1/vaults — all indexed vaults with live metrics (TVL, APY, unit price). */
+  vaults(options = {}) {
+    return this.get("/v1/vaults", {
+      next: options.next,
+      limit: options.limit,
+      include_hidden: options.includeHidden
+    });
+  }
+  /** GET /v1/vaults/slug/{slug} — all enabled deployments for one exact vault slug. */
+  vaultsBySlug(slug) {
+    return this.get(`/v1/vaults/slug/${encodeURIComponent(slug)}`);
+  }
+  /** GET /v1/vaults/slug/{slug}/timeseries — aggregate USD TVL and supply, plus primary-deployment metrics.
+   * APY and unit price come from meta.resolved_vault_id; null marks missing data.
+   */
+  vaultTimeseriesBySlug(slug, options = {}) {
+    return this.get(`/v1/vaults/slug/${encodeURIComponent(slug)}/timeseries`, { ...options });
+  }
+  /** GET /v1/vaults/slug/{slug}/primary/timeseries — primary deployment history. */
+  primaryVaultTimeseriesBySlug(slug, options = {}) {
+    return this.get(`/v1/vaults/slug/${encodeURIComponent(slug)}/primary/timeseries`, {
+      ...options
+    });
+  }
+  /** GET /v1/vaults/featured — admin-curated featured vault cards. */
+  featuredVaults() {
+    return this.get("/v1/vaults/featured");
+  }
+  /** GET /v1/strategies — admin-curated strategy cards. */
+  strategies() {
+    return this.get("/v1/strategies");
+  }
+  /** GET /v1/vaults/{vault_id} — one vault with live metrics. `vaultId` is CAIP-10. */
+  vault(vaultId) {
+    return this.get(`/v1/vaults/${encodeURIComponent(vaultId)}`);
+  }
+  /** GET /v1/vaults/{vault_id}/definition — raw indexed vault definition. */
+  vaultDefinition(vaultId) {
+    return this.get(`/v1/vaults/${encodeURIComponent(vaultId)}/definition`);
+  }
+  /** GET /v1/vaults/{vault_id}/allocations — current Aera allocations with source lineage. */
+  vaultAllocations(vaultId) {
+    return this.get(`/v1/vaults/${encodeURIComponent(vaultId)}/allocations`);
+  }
+  /** GET /v1/vaults/{vault_id}/timeseries — TVL / unit-price / APY history. */
+  vaultTimeseries(vaultId, options = {}) {
+    return this.get(`/v1/vaults/${encodeURIComponent(vaultId)}/timeseries`, { ...options });
+  }
+  /** GET /v1/users/{wallet}/positions — all of a wallet's indexed positions with PnL. */
+  positions(walletAddress, options = {}) {
+    return this.get(`/v1/users/${encodeURIComponent(walletAddress)}/positions`, {
+      next: options.next,
+      limit: options.limit,
+      include_hidden: options.includeHidden
+    });
+  }
+  /** GET /v1/users/{wallet}/positions/{vault_id} — one position with PnL breakdown. */
+  position(walletAddress, vaultId) {
+    return this.get(
+      `/v1/users/${encodeURIComponent(walletAddress)}/positions/${encodeURIComponent(vaultId)}`
+    );
+  }
+  /** GET /v1/users/{wallet}/positions/{vault_id}/timeseries — value / cost-basis / PnL / ROI history. */
+  positionTimeseries(walletAddress, vaultId, options = {}) {
+    return this.get(
+      `/v1/users/${encodeURIComponent(walletAddress)}/positions/${encodeURIComponent(vaultId)}/timeseries`,
+      { ...options }
+    );
+  }
+  /** GET /v1/users/{wallet}/activity — one page of the wallet's immutable event log. */
+  activity(walletAddress, options = {}) {
+    const { vaultId, includeHidden, ...page } = options;
+    return this.get(`/v1/users/${encodeURIComponent(walletAddress)}/activity`, {
+      vault_id: vaultId,
+      include_hidden: includeHidden,
+      ...page
+    });
+  }
+  /**
+   * Iterates the wallet's full activity log, following `meta.next_cursor`
+   * across pages so callers never handle cursors.
+   */
+  async *activityRows(walletAddress, options = {}) {
+    let next;
+    do {
+      const page = await this.activity(walletAddress, { ...options, next });
+      yield* page.data;
+      next = page.meta.next_cursor ?? void 0;
+    } while (next);
+  }
+  /**
+   * GET /v1/tvl — aggregate Gauntlet TVL. Pass `mode` for a `breakdown`:
+   * `chain` for one row per chain, `strategy` for one row per curated
+   * strategy. Omit it for the headline totals only.
+   */
+  tvl(options = {}) {
+    return this.get("/v1/tvl", { mode: options.mode });
+  }
+  /**
+   * GET /v1/tvl/timeseries — daily aggregate Gauntlet TVL over a fixed
+   * 3-month trailing window. `mode` partitions each point's `sources` the
+   * same way `tvl()` partitions its `breakdown`; a point's total never
+   * depends on it.
+   */
+  tvlTimeseries(options = {}) {
+    return this.get("/v1/tvl/timeseries", { mode: options.mode });
+  }
+  /** GET /v1/prices — latest USD price for a token. */
+  latestPrice(options) {
+    return this.get("/v1/prices", {
+      address: options.address,
+      chain_id: options.chainId,
+      at: options.at
+    });
+  }
+  /** GET /v1/prices/timeseries — USD price history for a token. */
+  priceTimeseries(options) {
+    return this.get("/v1/prices/timeseries", {
+      address: options.address,
+      chain_id: options.chainId,
+      start: options.start,
+      end: options.end,
+      granularity: options.granularity,
+      limit: options.limit
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GauntletApi
+});
+//# sourceMappingURL=client.js.map

package/dist/cjs/api/client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/api/client.ts"],
+  "sourcesContent": ["import type { components } from './generated';\nimport { apiGet, type GauntletApiConfig, type QueryParams } from './http';\n\ntype Schemas = components['schemas'];\n\nexport type UserActivity = Schemas['UserActivity'];\nexport type UserActivityResponse = Schemas['UserActivityResponse'];\nexport type UserPosition = Schemas['UserPosition'];\nexport type UserAllPositionsResponse = Schemas['UserAllPositionsResponse'];\nexport type UserPositionLatestResponse = Schemas['UserPositionLatestResponse'];\nexport type UserPositionsTimeseriesResponse = Schemas['UserPositionsTimeseriesResponse'];\nexport type PositionTimeseriesPoint = Schemas['PositionTimeseriesPoint'];\nexport type VaultDetail = Schemas['VaultDetail'];\nexport type VaultDetailResponse = Schemas['VaultDetailResponse'];\nexport type VaultListResponse = Schemas['VaultListResponse'];\nexport type VaultAllocations = Schemas['VaultAllocations'];\nexport type VaultAllocationsResponse = Schemas['VaultAllocationsResponse'];\nexport type VaultTimeseriesResponse = Schemas['VaultTimeseriesResponse'];\nexport type VaultGroupTimeseriesResponse = Schemas['VaultGroupTimeseriesResponse'];\nexport type VaultGroupTimeseriesPoint = Schemas['VaultGroupTimeseriesPoint'];\nexport type VaultTimeseriesPoint = Schemas['VaultTimeseriesPoint'];\nexport type VaultMetrics = Schemas['VaultMetrics'];\nexport type FeaturedVault = Schemas['FeaturedVault'];\nexport type FeaturedVaultsResponse = Schemas['FeaturedVaultsResponse'];\nexport type StrategyCard = Schemas['StrategyCard'];\nexport type StrategyListResponse = Schemas['StrategyListResponse'];\nexport type TvlResponse = Schemas['TvlResponse'];\nexport type TvlBreakdownMode = Schemas['TvlBreakdownMode'];\nexport type TvlTimeseriesResponse = Schemas['TvlTimeseriesResponse'];\nexport type TvlTimeseriesPoint = Schemas['TvlTimeseriesPoint'];\nexport type LatestPriceResponse = Schemas['LatestPriceResponse'];\nexport type PriceTimeseriesResponse = Schemas['TimeseriesResponse'];\nexport type TokenRef = Schemas['TokenRef'];\nexport type PartialResponseError = Schemas['PartialResponseError'];\nexport type AmountPair = Schemas['AmountPair'];\nexport type TimeseriesMeta = Schemas['TimeseriesMeta'];\nexport type HealthResponse = Schemas['HealthResponse'];\nexport type ChainSyncStatus = Schemas['ChainSyncStatus'];\n\nexport interface PageOptions {\n  /** Opaque cursor from a previous response's `meta.next_cursor`. */\n  next?: string;\n  limit?: number;\n  order?: 'asc' | 'desc';\n}\n\nexport interface TimeWindowOptions extends PageOptions {\n  /** ISO 8601 date (`2026-01-01`) or RFC 3339 timestamp. */\n  start?: string;\n  end?: string;\n  granularity?: 'hour' | 'day' | 'week' | 'month';\n}\n\nexport interface ActivityOptions extends PageOptions {\n  /** CAIP-10 vault id (`\"{chainId}:{address}\"`). Omit for wallet-wide activity. */\n  vaultId?: string;\n  /**\n   * Wallet-wide feeds only: include activity in hidden (enabled but unlisted)\n   * vaults alongside visible ones. Activity in disabled vaults is never\n   * returned. Ignored when `vaultId` is set.\n   */\n  includeHidden?: boolean;\n}\n\nexport interface PositionsOptions extends PageOptions {\n  /**\n   * Include positions in hidden (enabled but unlisted) vaults alongside\n   * visible ones. Positions in disabled vaults are never returned.\n   */\n  includeHidden?: boolean;\n}\n\nexport interface VaultsOptions extends PageOptions {\n  /**\n   * Include hidden (enabled but unlisted) vaults alongside visible ones.\n   * Disabled vaults are never listed.\n   */\n  includeHidden?: boolean;\n}\n\nexport interface LatestPriceOptions {\n  address: string;\n  chainId: number;\n  /** Optional ISO 8601 timestamp for a point-in-time price. */\n  at?: string;\n}\n\nexport interface PriceTimeseriesOptions {\n  address: string;\n  chainId: number;\n  start: string;\n  end: string;\n  granularity?: 'raw' | 'hour' | 'day' | 'week' | 'month';\n  limit?: number;\n}\n\n/**\n * Typed client for the Gaia REST API (api.gauntlet.xyz).\n *\n * All response types are generated from the service's OpenAPI spec\n * (`src/api/generated.ts`, regenerated via `yarn generate:api-types`) so they\n * cannot drift from the server models. Values are returned exactly as the API\n * emits them \u2014 human-unit decimal strings and CAIP-10 vault ids; use\n * `decimalToBigInt` / `sharesToBigInt` and `apiVaultIdFromVaultId` /\n * `vaultIdFromApiVaultId` to convert, or the higher-level `activityFlows` /\n * `positionHistory` helpers for pre-normalized values.\n *\n * Available on a configured client as `client.api`, or standalone:\n * ```ts\n * const api = new GauntletApi({ apiKey: process.env.GAUNTLET_API_KEY });\n * const { data } = await api.vaults();\n * ```\n */\nexport class GauntletApi {\n  private readonly config: GauntletApiConfig;\n\n  constructor(config: GauntletApiConfig = {}) {\n    this.config = config;\n  }\n\n  private get<T>(path: string, query?: QueryParams): Promise<T> {\n    return apiGet<T>(this.config, path, query);\n  }\n\n  /** GET /health \u2014 service liveness (version + uptime). */\n  health(): Promise<HealthResponse> {\n    return this.get('/health');\n  }\n\n  /** GET /health/chains \u2014 per-chain indexer sync freshness. */\n  chainSyncStatus(): Promise<ChainSyncStatus[]> {\n    return this.get('/health/chains');\n  }\n\n  /** GET /v1/vaults \u2014 all indexed vaults with live metrics (TVL, APY, unit price). */\n  vaults(options: VaultsOptions = {}): Promise<{ data: VaultDetail[]; meta: TimeseriesMeta }> {\n    return this.get('/v1/vaults', {\n      next: options.next,\n      limit: options.limit,\n      include_hidden: options.includeHidden,\n    });\n  }\n\n  /** GET /v1/vaults/slug/{slug} \u2014 all enabled deployments for one exact vault slug. */\n  vaultsBySlug(slug: string): Promise<VaultListResponse> {\n    return this.get(`/v1/vaults/slug/${encodeURIComponent(slug)}`);\n  }\n\n  /** GET /v1/vaults/slug/{slug}/timeseries \u2014 aggregate USD TVL and supply, plus primary-deployment metrics.\n   * APY and unit price come from meta.resolved_vault_id; null marks missing data.\n   */\n  vaultTimeseriesBySlug(\n    slug: string,\n    options: TimeWindowOptions = {}\n  ): Promise<VaultGroupTimeseriesResponse> {\n    return this.get(`/v1/vaults/slug/${encodeURIComponent(slug)}/timeseries`, { ...options });\n  }\n\n  /** GET /v1/vaults/slug/{slug}/primary/timeseries \u2014 primary deployment history. */\n  primaryVaultTimeseriesBySlug(\n    slug: string,\n    options: TimeWindowOptions = {}\n  ): Promise<VaultTimeseriesResponse> {\n    return this.get(`/v1/vaults/slug/${encodeURIComponent(slug)}/primary/timeseries`, {\n      ...options,\n    });\n  }\n\n  /** GET /v1/vaults/featured \u2014 admin-curated featured vault cards. */\n  featuredVaults(): Promise<FeaturedVaultsResponse> {\n    return this.get('/v1/vaults/featured');\n  }\n\n  /** GET /v1/strategies \u2014 admin-curated strategy cards. */\n  strategies(): Promise<StrategyListResponse> {\n    return this.get('/v1/strategies');\n  }\n\n  /** GET /v1/vaults/{vault_id} \u2014 one vault with live metrics. `vaultId` is CAIP-10. */\n  vault(vaultId: string): Promise<VaultDetailResponse> {\n    return this.get(`/v1/vaults/${encodeURIComponent(vaultId)}`);\n  }\n\n  /** GET /v1/vaults/{vault_id}/definition \u2014 raw indexed vault definition. */\n  vaultDefinition(vaultId: string): Promise<unknown> {\n    return this.get(`/v1/vaults/${encodeURIComponent(vaultId)}/definition`);\n  }\n\n  /** GET /v1/vaults/{vault_id}/allocations \u2014 current Aera allocations with source lineage. */\n  vaultAllocations(vaultId: string): Promise<VaultAllocationsResponse> {\n    return this.get(`/v1/vaults/${encodeURIComponent(vaultId)}/allocations`);\n  }\n\n  /** GET /v1/vaults/{vault_id}/timeseries \u2014 TVL / unit-price / APY history. */\n  vaultTimeseries(\n    vaultId: string,\n    options: TimeWindowOptions = {}\n  ): Promise<VaultTimeseriesResponse> {\n    return this.get(`/v1/vaults/${encodeURIComponent(vaultId)}/timeseries`, { ...options });\n  }\n\n  /** GET /v1/users/{wallet}/positions \u2014 all of a wallet's indexed positions with PnL. */\n  positions(\n    walletAddress: string,\n    options: PositionsOptions = {}\n  ): Promise<UserAllPositionsResponse> {\n    return this.get(`/v1/users/${encodeURIComponent(walletAddress)}/positions`, {\n      next: options.next,\n      limit: options.limit,\n      include_hidden: options.includeHidden,\n    });\n  }\n\n  /** GET /v1/users/{wallet}/positions/{vault_id} \u2014 one position with PnL breakdown. */\n  position(walletAddress: string, vaultId: string): Promise<UserPositionLatestResponse> {\n    return this.get(\n      `/v1/users/${encodeURIComponent(walletAddress)}/positions/${encodeURIComponent(vaultId)}`\n    );\n  }\n\n  /** GET /v1/users/{wallet}/positions/{vault_id}/timeseries \u2014 value / cost-basis / PnL / ROI history. */\n  positionTimeseries(\n    walletAddress: string,\n    vaultId: string,\n    options: TimeWindowOptions = {}\n  ): Promise<UserPositionsTimeseriesResponse> {\n    return this.get(\n      `/v1/users/${encodeURIComponent(walletAddress)}/positions/${encodeURIComponent(vaultId)}/timeseries`,\n      { ...options }\n    );\n  }\n\n  /** GET /v1/users/{wallet}/activity \u2014 one page of the wallet's immutable event log. */\n  activity(walletAddress: string, options: ActivityOptions = {}): Promise<UserActivityResponse> {\n    const { vaultId, includeHidden, ...page } = options;\n    return this.get(`/v1/users/${encodeURIComponent(walletAddress)}/activity`, {\n      vault_id: vaultId,\n      include_hidden: includeHidden,\n      ...page,\n    });\n  }\n\n  /**\n   * Iterates the wallet's full activity log, following `meta.next_cursor`\n   * across pages so callers never handle cursors.\n   */\n  async *activityRows(\n    walletAddress: string,\n    options: Omit<ActivityOptions, 'next'> = {}\n  ): AsyncGenerator<UserActivity> {\n    let next: string | undefined;\n    do {\n      const page = await this.activity(walletAddress, { ...options, next });\n      yield* page.data;\n      next = page.meta.next_cursor ?? undefined;\n    } while (next);\n  }\n\n  /**\n   * GET /v1/tvl \u2014 aggregate Gauntlet TVL. Pass `mode` for a `breakdown`:\n   * `chain` for one row per chain, `strategy` for one row per curated\n   * strategy. Omit it for the headline totals only.\n   */\n  tvl(options: { mode?: TvlBreakdownMode } = {}): Promise<TvlResponse> {\n    return this.get('/v1/tvl', { mode: options.mode });\n  }\n\n  /**\n   * GET /v1/tvl/timeseries \u2014 daily aggregate Gauntlet TVL over a fixed\n   * 3-month trailing window. `mode` partitions each point's `sources` the\n   * same way `tvl()` partitions its `breakdown`; a point's total never\n   * depends on it.\n   */\n  tvlTimeseries(options: { mode?: TvlBreakdownMode } = {}): Promise<TvlTimeseriesResponse> {\n    return this.get('/v1/tvl/timeseries', { mode: options.mode });\n  }\n\n  /** GET /v1/prices \u2014 latest USD price for a token. */\n  latestPrice(options: LatestPriceOptions): Promise<LatestPriceResponse> {\n    return this.get('/v1/prices', {\n      address: options.address,\n      chain_id: options.chainId,\n      at: options.at,\n    });\n  }\n\n  /** GET /v1/prices/timeseries \u2014 USD price history for a token. */\n  priceTimeseries(options: PriceTimeseriesOptions): Promise<PriceTimeseriesResponse> {\n    return this.get('/v1/prices/timeseries', {\n      address: options.address,\n      chain_id: options.chainId,\n      start: options.start,\n      end: options.end,\n      granularity: options.granularity,\n      limit: options.limit,\n    });\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/api/decimal.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Converts an API decimal string (human units, e.g. `"1250.5"`) into base-unit
+ * bigint at the given token decimals (e.g. `1250500000n` for 6 decimals).
+ *
+ * The conversion is exact: a value with more significant fractional digits
+ * than `decimals` throws `DecimalPrecisionError` rather than rounding.
+ * Hand-rolled instead of viem's `parseUnits`, which silently rounds excess
+ * precision (`parseUnits('1.0000005', 6)` → `1000001n`) — unacceptable for
+ * financial amounts.
+ */
+export declare function decimalToBigInt(value: string, decimals: number): bigint;
+/**
+ * Formats a base-unit bigint back into the API's human decimal-string
+ * representation (no trailing fractional zeros, no exponent notation).
+ */
+export declare function bigIntToDecimal(value: bigint, decimals: number): string;
+/** Vault shares are always reported in 18-decimal units by the Gaia API. */
+export declare const SHARE_DECIMALS = 18;
+/** Parses an API share amount (decimal string) into base-unit bigint (1e18). */
+export declare function sharesToBigInt(value: string): bigint;
+//# sourceMappingURL=decimal.d.ts.map

package/dist/cjs/api/decimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../../../src/api/decimal.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAcvE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED,4EAA4E;AAC5E,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/cjs/api/decimal.js

@@ -0,0 +1,60 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var decimal_exports = {};
+__export(decimal_exports, {
+  SHARE_DECIMALS: () => SHARE_DECIMALS,
+  bigIntToDecimal: () => bigIntToDecimal,
+  decimalToBigInt: () => decimalToBigInt,
+  sharesToBigInt: () => sharesToBigInt
+});
+module.exports = __toCommonJS(decimal_exports);
+var import_viem = require("viem");
+var import_errors = require("./errors");
+const DECIMAL_RE = /^(-?)(\d+)(?:\.(\d+))?$/;
+function decimalToBigInt(value, decimals) {
+  if (!Number.isInteger(decimals) || decimals < 0) {
+    throw new import_errors.InvalidDecimalError(`decimals=${decimals}`);
+  }
+  const match = DECIMAL_RE.exec(value);
+  if (!match) throw new import_errors.InvalidDecimalError(value);
+  const [, sign, whole, frac = ""] = match;
+  if (frac.length > decimals && !/^0*$/.test(frac.slice(decimals))) {
+    throw new import_errors.DecimalPrecisionError(value, decimals);
+  }
+  const scaled = BigInt(whole + frac.slice(0, decimals).padEnd(decimals, "0"));
+  return sign === "-" ? -scaled : scaled;
+}
+function bigIntToDecimal(value, decimals) {
+  if (!Number.isInteger(decimals) || decimals < 0) {
+    throw new import_errors.InvalidDecimalError(`decimals=${decimals}`);
+  }
+  return (0, import_viem.formatUnits)(value, decimals);
+}
+const SHARE_DECIMALS = 18;
+function sharesToBigInt(value) {
+  return decimalToBigInt(value, SHARE_DECIMALS);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SHARE_DECIMALS,
+  bigIntToDecimal,
+  decimalToBigInt,
+  sharesToBigInt
+});
+//# sourceMappingURL=decimal.js.map

package/dist/cjs/api/decimal.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/api/decimal.ts"],
+  "sourcesContent": ["import { formatUnits } from 'viem';\nimport { DecimalPrecisionError, InvalidDecimalError } from './errors';\n\nconst DECIMAL_RE = /^(-?)(\\d+)(?:\\.(\\d+))?$/;\n\n/**\n * Converts an API decimal string (human units, e.g. `\"1250.5\"`) into base-unit\n * bigint at the given token decimals (e.g. `1250500000n` for 6 decimals).\n *\n * The conversion is exact: a value with more significant fractional digits\n * than `decimals` throws `DecimalPrecisionError` rather than rounding.\n * Hand-rolled instead of viem's `parseUnits`, which silently rounds excess\n * precision (`parseUnits('1.0000005', 6)` \u2192 `1000001n`) \u2014 unacceptable for\n * financial amounts.\n */\nexport function decimalToBigInt(value: string, decimals: number): bigint {\n  if (!Number.isInteger(decimals) || decimals < 0) {\n    throw new InvalidDecimalError(`decimals=${decimals}`);\n  }\n  const match = DECIMAL_RE.exec(value);\n  if (!match) throw new InvalidDecimalError(value);\n\n  const [, sign, whole, frac = ''] = match;\n  if (frac.length > decimals && !/^0*$/.test(frac.slice(decimals))) {\n    throw new DecimalPrecisionError(value, decimals);\n  }\n\n  const scaled = BigInt(whole + frac.slice(0, decimals).padEnd(decimals, '0'));\n  return sign === '-' ? -scaled : scaled;\n}\n\n/**\n * Formats a base-unit bigint back into the API's human decimal-string\n * representation (no trailing fractional zeros, no exponent notation).\n */\nexport function bigIntToDecimal(value: bigint, decimals: number): string {\n  if (!Number.isInteger(decimals) || decimals < 0) {\n    throw new InvalidDecimalError(`decimals=${decimals}`);\n  }\n  return formatUnits(value, decimals);\n}\n\n/** Vault shares are always reported in 18-decimal units by the Gaia API. */\nexport const SHARE_DECIMALS = 18;\n\n/** Parses an API share amount (decimal string) into base-unit bigint (1e18). */\nexport function sharesToBigInt(value: string): bigint {\n  return decimalToBigInt(value, SHARE_DECIMALS);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAA4B;AAC5B,oBAA2D;AAE3D,MAAM,aAAa;AAYZ,SAAS,gBAAgB,OAAe,UAA0B;AACvE,MAAI,CAAC,OAAO,UAAU,QAAQ,KAAK,WAAW,GAAG;AAC/C,UAAM,IAAI,kCAAoB,YAAY,QAAQ,EAAE;AAAA,EACtD;AACA,QAAM,QAAQ,WAAW,KAAK,KAAK;AACnC,MAAI,CAAC,MAAO,OAAM,IAAI,kCAAoB,KAAK;AAE/C,QAAM,CAAC,EAAE,MAAM,OAAO,OAAO,EAAE,IAAI;AACnC,MAAI,KAAK,SAAS,YAAY,CAAC,OAAO,KAAK,KAAK,MAAM,QAAQ,CAAC,GAAG;AAChE,UAAM,IAAI,oCAAsB,OAAO,QAAQ;AAAA,EACjD;AAEA,QAAM,SAAS,OAAO,QAAQ,KAAK,MAAM,GAAG,QAAQ,EAAE,OAAO,UAAU,GAAG,CAAC;AAC3E,SAAO,SAAS,MAAM,CAAC,SAAS;AAClC;AAMO,SAAS,gBAAgB,OAAe,UAA0B;AACvE,MAAI,CAAC,OAAO,UAAU,QAAQ,KAAK,WAAW,GAAG;AAC/C,UAAM,IAAI,kCAAoB,YAAY,QAAQ,EAAE;AAAA,EACtD;AACA,aAAO,yBAAY,OAAO,QAAQ;AACpC;AAGO,MAAM,iBAAiB;AAGvB,SAAS,eAAe,OAAuB;AACpD,SAAO,gBAAgB,OAAO,cAAc;AAC9C;",
+  "names": []
+}

package/dist/cjs/api/errors.d.ts

@@ -0,0 +1,32 @@
+import { GauntletSDKError } from "../errors.js";
+export declare class GauntletApiError extends GauntletSDKError {
+    readonly status: number;
+    readonly path: string;
+    /** Machine-readable code from the API error envelope (e.g. `NOT_FOUND`), when present. */
+    readonly code?: string;
+    constructor(params: {
+        status: number;
+        path: string;
+        message: string;
+        code?: string;
+    });
+}
+export declare class InvalidDecimalError extends GauntletSDKError {
+    readonly value: string;
+    constructor(value: string);
+}
+export declare class DecimalPrecisionError extends GauntletSDKError {
+    readonly value: string;
+    readonly decimals: number;
+    constructor(value: string, decimals: number);
+}
+export declare class InvalidCaipIdError extends GauntletSDKError {
+    readonly id: string;
+    constructor(id: string);
+}
+export declare class SettlementTimeoutError extends GauntletSDKError {
+    readonly requestHash: string;
+    readonly timeoutMs: number;
+    constructor(requestHash: string, timeoutMs: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/cjs/api/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/api/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,qBAAkB;AAE7C,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;CASrF;AAED,qBAAa,mBAAoB,SAAQ,gBAAgB;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,KAAK,EAAE,MAAM;CAK1B;AAED,qBAAa,qBAAsB,SAAQ,gBAAgB;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAQ5C;AAED,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;gBAER,EAAE,EAAE,MAAM;CAKvB;AAED,qBAAa,sBAAuB,SAAQ,gBAAgB;IAC1D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAMnD"}

package/dist/cjs/api/errors.js

@@ -0,0 +1,80 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var errors_exports = {};
+__export(errors_exports, {
+  DecimalPrecisionError: () => DecimalPrecisionError,
+  GauntletApiError: () => GauntletApiError,
+  InvalidCaipIdError: () => InvalidCaipIdError,
+  InvalidDecimalError: () => InvalidDecimalError,
+  SettlementTimeoutError: () => SettlementTimeoutError
+});
+module.exports = __toCommonJS(errors_exports);
+var import_errors = require("../errors");
+class GauntletApiError extends import_errors.GauntletSDKError {
+  constructor(params) {
+    super(
+      `Gauntlet API request to "${params.path}" failed with ${params.status}: ${params.message}`
+    );
+    this.name = "GauntletApiError";
+    this.status = params.status;
+    this.path = params.path;
+    this.code = params.code;
+  }
+}
+class InvalidDecimalError extends import_errors.GauntletSDKError {
+  constructor(value) {
+    super(`Value "${value}" is not a valid decimal string`);
+    this.name = "InvalidDecimalError";
+    this.value = value;
+  }
+}
+class DecimalPrecisionError extends import_errors.GauntletSDKError {
+  constructor(value, decimals) {
+    super(
+      `Decimal "${value}" has more fractional digits than the token's ${decimals} decimals; converting would lose precision`
+    );
+    this.name = "DecimalPrecisionError";
+    this.value = value;
+    this.decimals = decimals;
+  }
+}
+class InvalidCaipIdError extends import_errors.GauntletSDKError {
+  constructor(id) {
+    super(`"${id}" is not a valid CAIP-10 vault id (expected "{chainId}:{address}")`);
+    this.name = "InvalidCaipIdError";
+    this.id = id;
+  }
+}
+class SettlementTimeoutError extends import_errors.GauntletSDKError {
+  constructor(requestHash, timeoutMs) {
+    super(`Request "${requestHash}" did not settle within ${timeoutMs}ms`);
+    this.name = "SettlementTimeoutError";
+    this.requestHash = requestHash;
+    this.timeoutMs = timeoutMs;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DecimalPrecisionError,
+  GauntletApiError,
+  InvalidCaipIdError,
+  InvalidDecimalError,
+  SettlementTimeoutError
+});
+//# sourceMappingURL=errors.js.map

package/dist/cjs/api/errors.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/api/errors.ts"],
+  "sourcesContent": ["import { GauntletSDKError } from '../errors';\n\nexport class GauntletApiError extends GauntletSDKError {\n  readonly status: number;\n  readonly path: string;\n  /** Machine-readable code from the API error envelope (e.g. `NOT_FOUND`), when present. */\n  readonly code?: string;\n\n  constructor(params: { status: number; path: string; message: string; code?: string }) {\n    super(\n      `Gauntlet API request to \"${params.path}\" failed with ${params.status}: ${params.message}`\n    );\n    this.name = 'GauntletApiError';\n    this.status = params.status;\n    this.path = params.path;\n    this.code = params.code;\n  }\n}\n\nexport class InvalidDecimalError extends GauntletSDKError {\n  readonly value: string;\n\n  constructor(value: string) {\n    super(`Value \"${value}\" is not a valid decimal string`);\n    this.name = 'InvalidDecimalError';\n    this.value = value;\n  }\n}\n\nexport class DecimalPrecisionError extends GauntletSDKError {\n  readonly value: string;\n  readonly decimals: number;\n\n  constructor(value: string, decimals: number) {\n    super(\n      `Decimal \"${value}\" has more fractional digits than the token's ${decimals} decimals; converting would lose precision`\n    );\n    this.name = 'DecimalPrecisionError';\n    this.value = value;\n    this.decimals = decimals;\n  }\n}\n\nexport class InvalidCaipIdError extends GauntletSDKError {\n  readonly id: string;\n\n  constructor(id: string) {\n    super(`\"${id}\" is not a valid CAIP-10 vault id (expected \"{chainId}:{address}\")`);\n    this.name = 'InvalidCaipIdError';\n    this.id = id;\n  }\n}\n\nexport class SettlementTimeoutError extends GauntletSDKError {\n  readonly requestHash: string;\n  readonly timeoutMs: number;\n\n  constructor(requestHash: string, timeoutMs: number) {\n    super(`Request \"${requestHash}\" did not settle within ${timeoutMs}ms`);\n    this.name = 'SettlementTimeoutError';\n    this.requestHash = requestHash;\n    this.timeoutMs = timeoutMs;\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAAiC;AAE1B,MAAM,yBAAyB,+BAAiB;AAAA,EAMrD,YAAY,QAA0E;AACpF;AAAA,MACE,4BAA4B,OAAO,IAAI,iBAAiB,OAAO,MAAM,KAAK,OAAO,OAAO;AAAA,IAC1F;AACA,SAAK,OAAO;AACZ,SAAK,SAAS,OAAO;AACrB,SAAK,OAAO,OAAO;AACnB,SAAK,OAAO,OAAO;AAAA,EACrB;AACF;AAEO,MAAM,4BAA4B,+BAAiB;AAAA,EAGxD,YAAY,OAAe;AACzB,UAAM,UAAU,KAAK,iCAAiC;AACtD,SAAK,OAAO;AACZ,SAAK,QAAQ;AAAA,EACf;AACF;AAEO,MAAM,8BAA8B,+BAAiB;AAAA,EAI1D,YAAY,OAAe,UAAkB;AAC3C;AAAA,MACE,YAAY,KAAK,iDAAiD,QAAQ;AAAA,IAC5E;AACA,SAAK,OAAO;AACZ,SAAK,QAAQ;AACb,SAAK,WAAW;AAAA,EAClB;AACF;AAEO,MAAM,2BAA2B,+BAAiB;AAAA,EAGvD,YAAY,IAAY;AACtB,UAAM,IAAI,EAAE,oEAAoE;AAChF,SAAK,OAAO;AACZ,SAAK,KAAK;AAAA,EACZ;AACF;AAEO,MAAM,+BAA+B,+BAAiB;AAAA,EAI3D,YAAY,aAAqB,WAAmB;AAClD,UAAM,YAAY,WAAW,2BAA2B,SAAS,IAAI;AACrE,SAAK,OAAO;AACZ,SAAK,cAAc;AACnB,SAAK,YAAY;AAAA,EACnB;AACF;",
+  "names": []
+}