@gauntlet-xyz/sdk 2.5.0 → 3.1.1

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/api/client.ts"],"names":[],"mappings":"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"}

package/dist/cjs/api/client.js

@@ -0,0 +1,199 @@
+"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_caip = require("./caip");
+var import_errors = require("./errors");
+var import_http = require("./http");
+function activityError(message, code) {
+  return new import_errors.GauntletApiError({ status: 200, path: "/v1/users/activity", message, code });
+}
+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 = {}) {
+    const vault = options.vaultId === void 0 ? void 0 : (0, import_caip.parseApiVaultId)(options.vaultId);
+    const descending = (options.order ?? "desc") === "desc";
+    let lastTimestamp;
+    let next;
+    const cursors = /* @__PURE__ */ new Set();
+    do {
+      const page = await this.activity(walletAddress, { ...options, next });
+      if (page.meta.partial_errors?.length) {
+        throw activityError("The activity response is incomplete", "INCOMPLETE_ACTIVITY");
+      }
+      for (const row of page.data) {
+        if (vault !== void 0) {
+          const rowVault = (0, import_caip.parseApiVaultId)(row.vault_id);
+          if (rowVault.chainId !== vault.chainId || rowVault.address !== vault.address) {
+            throw activityError("The activity vault does not match the request");
+          }
+        }
+        if (lastTimestamp !== void 0 && (descending ? row.block_timestamp > lastTimestamp : row.block_timestamp < lastTimestamp)) {
+          throw activityError("The activity rows are out of order");
+        }
+        lastTimestamp = row.block_timestamp;
+        yield row;
+      }
+      next = page.meta.next_cursor ?? void 0;
+      if (next !== void 0) {
+        if (cursors.has(next)) throw activityError("The activity cursor repeats");
+        cursors.add(next);
+      }
+    } 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 { parseApiVaultId } from './caip';\nimport { GauntletApiError } from './errors';\nimport type { components } from './generated';\nimport { apiGet, type GauntletApiConfig, type QueryParams } from './http';\n\ntype Schemas = components['schemas'];\n\nfunction activityError(message: string, code?: string): GauntletApiError {\n  return new GauntletApiError({ status: 200, path: '/v1/users/activity', message, code });\n}\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    const vault = options.vaultId === undefined ? undefined : parseApiVaultId(options.vaultId);\n    // Gaia pages on (timestamp, logIndex), which rows do not expose. Rows\n    // can repeat legitimately inside one transaction, so the boundary check\n    // is the timestamp order.\n    const descending = (options.order ?? 'desc') === 'desc';\n    let lastTimestamp: number | undefined;\n    let next: string | undefined;\n    const cursors = new Set<string>();\n    do {\n      const page = await this.activity(walletAddress, { ...options, next });\n      if (page.meta.partial_errors?.length) {\n        throw activityError('The activity response is incomplete', 'INCOMPLETE_ACTIVITY');\n      }\n      for (const row of page.data) {\n        if (vault !== undefined) {\n          const rowVault = parseApiVaultId(row.vault_id);\n          if (rowVault.chainId !== vault.chainId || rowVault.address !== vault.address) {\n            throw activityError('The activity vault does not match the request');\n          }\n        }\n        if (\n          lastTimestamp !== undefined &&\n          (descending ? row.block_timestamp > lastTimestamp : row.block_timestamp < lastTimestamp)\n        ) {\n          throw activityError('The activity rows are out of order');\n        }\n        lastTimestamp = row.block_timestamp;\n        yield row;\n      }\n      next = page.meta.next_cursor ?? undefined;\n      if (next !== undefined) {\n        if (cursors.has(next)) throw activityError('The activity cursor repeats');\n        cursors.add(next);\n      }\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,CAevE;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,61 @@
+"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}`);
+  }
+  if (typeof value !== "string") throw new import_errors.InvalidDecimalError(String(value));
+  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  if (typeof value !== 'string') throw new InvalidDecimalError(String(value));\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,MAAI,OAAO,UAAU,SAAU,OAAM,IAAI,kCAAoB,OAAO,KAAK,CAAC;AAC1E,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