@gauntlet-xyz/sdk 1.0.6 → 2.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @gauntlet-xyz/sdk
 
-Official Gauntlet SDK for interacting with Gauntlet-managed vaults — deposits, withdrawals, and on-chain attribution.
+Official Gauntlet SDK for interacting with Gauntlet-managed vaults — deposits, withdrawals, on-chain attribution, and the Gauntlet REST API (vaults, positions, PnL, activity).
 
 ## Documentation
 
@@ -15,3 +15,84 @@ yarn add @gauntlet-xyz/sdk viem
 ```
 
 > `viem` is a required peer dependency.
+
+## Quick start
+
+```ts
+import { createPublicClient, createWalletClient, custom, http } from 'viem';
+import { base } from 'viem/chains';
+import { GauntletClient, getVaults, getDepositTx } from '@gauntlet-xyz/sdk';
+
+const client = new GauntletClient({
+  evmClients: { [base.id]: createPublicClient({ chain: base, transport: http() }) },
+  wallet: createWalletClient({ chain: base, transport: custom(window.ethereum) }),
+  builderCode: 'my-app', // ERC-8021 attribution
+});
+
+const vaults = await getVaults(client, { chainId: base.id });
+const steps = await getDepositTx(client, { vaultId: vaults[0].vaultId, amount: 100_000_000n });
+for (const step of steps) {
+  await client.wallet!.sendTransaction({
+    to: step.payload.to,
+    data: step.payload.data, // attribution suffix already applied
+    account: step.payload.account!,
+    chain: base,
+  });
+}
+```
+
+Using [Privy](https://privy.io)? `@gauntlet-xyz/sdk/privy` builds the client in one call:
+
+```ts
+import { createGauntletClientFromPrivy } from '@gauntlet-xyz/sdk/privy';
+import { base } from 'viem/chains';
+
+const client = await createGauntletClientFromPrivy({
+  wallet: wallets[0], // from useWallets()
+  chains: [base],
+  builderCode: 'my-app',
+});
+```
+
+## REST API (`client.api`)
+
+`client.api` is a typed client for the Gauntlet API at `api.gauntlet.xyz` — indexed vault metrics, user positions with PnL, the wallet activity log, TVL, and token prices. Response types are generated from the service's OpenAPI spec and verified in CI, so they cannot drift.
+
+```ts
+const client = new GauntletClient({ apiKey: process.env.GAUNTLET_API_KEY });
+
+const { data: vaults } = await client.api.vaults(); // live TVL / APY / unit price
+const { data: positions } = await client.api.positions(wallet); // value, cost basis, PnL, ROI
+const { data: history } = await client.api.positionTimeseries(wallet, vaultId);
+```
+
+Vault ids on the API are CAIP-10 (`"{chainId}:{address}"`); convert to and from manifest vault ids with `apiVaultIdFromVaultId` / `vaultIdFromApiVaultId`. Monetary values are human-unit decimal strings; convert exactly with `decimalToBigInt` / `sharesToBigInt` (throws instead of rounding).
+
+### Activity flows
+
+`getActivityFlows` stitches the raw activity log into lifecycle-aware flows — Aera async requests are paired with their settlement or refund via `request_hash`, replacing client-side event-log scanning:
+
+```ts
+import { getActivityFlows, waitForRequestSettlement } from '@gauntlet-xyz/sdk';
+
+const flows = await getActivityFlows(client.api, wallet);
+// [{ kind: 'deposit', status: 'pending', requestedAt, settledAt, assets, shares, txHashes, ... }]
+
+// After submitting a requestDeposit / requestRedeem transaction:
+const settled = await waitForRequestSettlement(client.api, wallet, requestHash);
+```
+
+### Position history
+
+`getPositionHistory` replays a wallet's indexed events into a chronological position timeline — running share balance, escrowed pending amounts, and net asset flows:
+
+```ts
+import { getPositionHistory, apiVaultIdFromVaultId } from '@gauntlet-xyz/sdk';
+
+const vaultId = await apiVaultIdFromVaultId(client, 'gtusda');
+const { points } = await getPositionHistory(client.api, wallet, vaultId);
+```
+
+## Development
+
+`src/api/generated.ts` is generated from `services/gaia/api/openapi.json` — regenerate with `yarn generate:api-types` after API changes; CI fails if it drifts.

package/dist/api/activity.d.ts

@@ -0,0 +1,70 @@
+import type { ActivityOptions, GauntletApi, TokenRef, UserActivity } from './client';
+export type ActivityFlowKind = 'deposit' | 'withdraw' | 'transfer_in' | 'transfer_out';
+export type ActivityFlowStatus = 'settled' | 'pending' | 'refunded';
+/** A signed token amount as reported by the API, with base-unit conversion when possible. */
+export interface AssetAmount {
+    /** Human-unit decimal string exactly as the API emits it, e.g. `"1250.5"`. */
+    decimal: string;
+    /** Base-unit integer (`decimal × 10^token.decimals`); null when the token's decimals are unknown. */
+    raw: bigint | null;
+    token: TokenRef | null;
+}
+/**
+ * One user action against a vault, stitched from the activity log's immutable
+ * rows. Sync flows (Morpho, secondary-market transfers) come from a single
+ * row; Aera async flows pair a `*_pending` request row with its terminal
+ * settle/refund row via `request_hash`.
+ */
+export interface ActivityFlow {
+    kind: ActivityFlowKind;
+    status: ActivityFlowStatus;
+    /** CAIP-10 vault id (`"{chainId}:{address}"`). */
+    vaultId: string;
+    /** Aera async correlation hash; null for sync flows and transfers. */
+    requestHash: string | null;
+    /** When the request row landed. Null when the flow's pending row is outside the fetched window. */
+    requestedAt: Date | null;
+    /** When the terminal (settle/refund) row landed. Null while pending. */
+    settledAt: Date | null;
+    /** Magnitude of the flow's asset movement (requested amount for refunded flows). */
+    assets: AssetAmount;
+    /** Magnitude of the flow's share movement in 18-decimal base units. */
+    shares: bigint;
+    /** Transaction hashes in row order (request first, then settlement, when both are known). */
+    txHashes: string[];
+}
+/**
+ * Pure stitcher: folds raw activity rows into `ActivityFlow`s. Rows may be in
+ * any order and may span multiple vaults; async lifecycles are paired by
+ * `request_hash`. Flows are returned newest-first (by the flow's latest row).
+ */
+export declare function stitchActivityFlows(rows: UserActivity[]): ActivityFlow[];
+export interface ActivityFlowsOptions extends Pick<ActivityOptions, 'vaultId' | 'limit'> {
+    /** Stop paginating once this many rows have been fetched. Defaults to 1000. */
+    maxRows?: number;
+}
+/**
+ * Fetches the wallet's activity log and stitches it into lifecycle-aware
+ * flows — the replacement for scanning vault event logs over RPC.
+ *
+ * ```ts
+ * const flows = await getActivityFlows(client.api, wallet);
+ * const open = flows.filter((f) => f.status === 'pending');
+ * ```
+ */
+export declare function getActivityFlows(api: GauntletApi, walletAddress: string, options?: ActivityFlowsOptions): Promise<ActivityFlow[]>;
+export interface WaitForSettlementOptions {
+    /** CAIP-10 vault id — narrows polling to one vault's activity. */
+    vaultId?: string;
+    /** Polling interval. Defaults to 5s. */
+    pollIntervalMs?: number;
+    /** Overall deadline. Defaults to 10 minutes. Throws `SettlementTimeoutError` on expiry. */
+    timeoutMs?: number;
+}
+/**
+ * Polls the activity log until the Aera async request identified by
+ * `requestHash` reaches a terminal state, and returns the settled or refunded
+ * flow. Use after submitting a `requestDeposit` / `requestRedeem` transaction.
+ */
+export declare function waitForRequestSettlement(api: GauntletApi, walletAddress: string, requestHash: string, options?: WaitForSettlementOptions): Promise<ActivityFlow>;
+//# sourceMappingURL=activity.d.ts.map

package/dist/api/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/api/activity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAIrF,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,cAAc,CAAC;AACvF,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAEpE,6FAA6F;AAC7F,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,qGAAqG;IACrG,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mGAAmG;IACnG,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,wEAAwE;IACxE,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,oFAAoF;IACpF,MAAM,EAAE,WAAW,CAAC;IACpB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,6FAA6F;IAC7F,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA4CD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAoDxE;AAED,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,OAAO,CAAC;IACtF,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,YAAY,EAAE,CAAC,CAqBzB;AAED,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,WAAW,EAChB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,YAAY,CAAC,CAevB"}

package/dist/api/activity.js

@@ -0,0 +1,154 @@
+import { GauntletSDKError } from '../errors';
+import { decimalToBigInt, sharesToBigInt } from './decimal';
+import { SettlementTimeoutError } from './errors';
+const PENDING_TYPES = new Set(['deposit_pending', 'withdraw_pending']);
+const REFUNDED_TYPES = new Set(['deposit_refunded', 'withdraw_refunded']);
+function flowKind(rowType) {
+    if (rowType.startsWith('deposit'))
+        return 'deposit';
+    if (rowType.startsWith('withdraw'))
+        return 'withdraw';
+    if (rowType === 'transfer_in' || rowType === 'transfer_out')
+        return rowType;
+    throw new GauntletSDKError(`Unknown activity row type "${rowType}"`);
+}
+function abs(value) {
+    return value < 0n ? -value : value;
+}
+/**
+ * Comparison scale for asset amounts. The API emits human-unit decimal strings
+ * with at most `token.decimals` fractional digits, so 18 digits is exact for
+ * every supported asset.
+ */
+const ASSET_SCALE = 18;
+function toAssetAmount(rows) {
+    // Per the API contract, at most one row of an async lifecycle carries the
+    // asset movement (the other legs are "0"), so the max magnitude is the
+    // flow's amount. For refunded flows this surfaces the requested amount
+    // instead of the useless net of zero.
+    let best = rows[0];
+    let bestMagnitude = abs(decimalToBigInt(best.assets_delta.native, ASSET_SCALE));
+    for (const row of rows.slice(1)) {
+        const magnitude = abs(decimalToBigInt(row.assets_delta.native, ASSET_SCALE));
+        if (magnitude > bestMagnitude) {
+            best = row;
+            bestMagnitude = magnitude;
+        }
+    }
+    const token = best.assets_delta.token ?? rows.find((r) => r.assets_delta.token)?.assets_delta.token ?? null;
+    const decimal = best.assets_delta.native.replace(/^-/, '');
+    const raw = token?.decimals != null ? decimalToBigInt(decimal, token.decimals) : null;
+    return { decimal, raw, token };
+}
+/**
+ * Pure stitcher: folds raw activity rows into `ActivityFlow`s. Rows may be in
+ * any order and may span multiple vaults; async lifecycles are paired by
+ * `request_hash`. Flows are returned newest-first (by the flow's latest row).
+ */
+export function stitchActivityFlows(rows) {
+    const groups = new Map();
+    for (const [index, row] of rows.entries()) {
+        // Rows without a request_hash are standalone sync flows: each one is its
+        // own group, so two same-type events in one transaction (e.g. a multicall
+        // doing two deposits) stay two flows.
+        const key = row.request_hash ?? `row:${index}`;
+        const group = groups.get(key);
+        if (group)
+            group.push(row);
+        else
+            groups.set(key, [row]);
+    }
+    const flows = [];
+    for (const group of groups.values()) {
+        group.sort((a, b) => a.block_timestamp - b.block_timestamp);
+        const pendingRow = group.find((r) => PENDING_TYPES.has(r.type)) ?? null;
+        const terminalRow = group.find((r) => !PENDING_TYPES.has(r.type)) ?? null;
+        const isAsync = group.some((r) => r.request_hash != null);
+        let status;
+        if (!terminalRow)
+            status = 'pending';
+        else if (REFUNDED_TYPES.has(terminalRow.type))
+            status = 'refunded';
+        else
+            status = 'settled';
+        let sharesMagnitude = 0n;
+        for (const row of group) {
+            const shares = abs(sharesToBigInt(row.shares_delta));
+            if (shares > sharesMagnitude)
+                sharesMagnitude = shares;
+        }
+        flows.push({
+            kind: flowKind((terminalRow ?? pendingRow ?? group[0]).type),
+            status,
+            vaultId: group[0].vault_id,
+            requestHash: group[0].request_hash ?? null,
+            requestedAt: pendingRow
+                ? new Date(pendingRow.block_timestamp * 1000)
+                : isAsync
+                    ? null
+                    : new Date(group[0].block_timestamp * 1000),
+            settledAt: terminalRow ? new Date(terminalRow.block_timestamp * 1000) : null,
+            assets: toAssetAmount(group),
+            shares: sharesMagnitude,
+            txHashes: [...new Set(group.map((r) => r.tx_hash))],
+        });
+    }
+    return flows.sort((a, b) => {
+        const aAt = (a.settledAt ?? a.requestedAt)?.getTime() ?? 0;
+        const bAt = (b.settledAt ?? b.requestedAt)?.getTime() ?? 0;
+        return bAt - aAt;
+    });
+}
+/**
+ * Fetches the wallet's activity log and stitches it into lifecycle-aware
+ * flows — the replacement for scanning vault event logs over RPC.
+ *
+ * ```ts
+ * const flows = await getActivityFlows(client.api, wallet);
+ * const open = flows.filter((f) => f.status === 'pending');
+ * ```
+ */
+export async function getActivityFlows(api, walletAddress, options = {}) {
+    const maxRows = options.maxRows ?? 1000;
+    const rows = [];
+    for await (const row of api.activityRows(walletAddress, {
+        vaultId: options.vaultId,
+        // The API caps page size at 1000; request maxRows per page so the common
+        // case is a single round trip instead of ten default-100 pages.
+        limit: options.limit ?? Math.min(maxRows, 1000),
+        order: 'desc',
+    })) {
+        rows.push(row);
+        if (rows.length >= maxRows)
+            break;
+    }
+    const flows = stitchActivityFlows(rows);
+    if (rows.length >= maxRows) {
+        // The window cut may have split an async lifecycle, keeping a terminal
+        // row whose request leg (the one carrying the amount) fell outside the
+        // window. Drop those flows rather than reporting zeroed amounts.
+        return flows.filter((f) => f.requestHash === null || f.requestedAt !== null);
+    }
+    return flows;
+}
+/**
+ * Polls the activity log until the Aera async request identified by
+ * `requestHash` reaches a terminal state, and returns the settled or refunded
+ * flow. Use after submitting a `requestDeposit` / `requestRedeem` transaction.
+ */
+export async function waitForRequestSettlement(api, walletAddress, requestHash, options = {}) {
+    const pollIntervalMs = options.pollIntervalMs ?? 5000;
+    const timeoutMs = options.timeoutMs ?? 600000;
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        const flows = await getActivityFlows(api, walletAddress, { vaultId: options.vaultId });
+        const flow = flows.find((f) => f.requestHash === requestHash);
+        if (flow && flow.status !== 'pending')
+            return flow;
+        if (Date.now() + pollIntervalMs > deadline) {
+            throw new SettlementTimeoutError(requestHash, timeoutMs);
+        }
+        await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+    }
+}
+//# sourceMappingURL=activity.js.map

package/dist/api/activity.js.map

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

package/dist/api/caip.d.ts

@@ -0,0 +1,29 @@
+import type { GauntletClient } from '../client';
+/**
+ * The Gaia API identifies vaults as `"{chainId}:{address}"` with a lowercase
+ * address (a CAIP-10-style account id without the `eip155` namespace prefix).
+ */
+export interface ApiVaultId {
+    chainId: number;
+    /** Lowercase EVM address. */
+    address: string;
+}
+export declare function parseApiVaultId(id: string): ApiVaultId;
+export declare function formatApiVaultId(chainId: number, address: string): string;
+/**
+ * Resolves a manifest vault id (e.g. `VaultId.AeraUsdAlpha` / `'gtusda'`) to
+ * the Gaia API's CAIP-10 id for the vault's deployment on `chainId`.
+ *
+ * Deployment resolution is `resolveVault` — the same rules tx-building uses:
+ * single-deployment vaults resolve directly (a mismatched explicit `chainId`
+ * throws `ChainMismatchError`), multi-chain vaults default to Base when
+ * `chainId` is omitted.
+ */
+export declare function apiVaultIdFromVaultId(client: GauntletClient, vaultId: string, chainId?: number): Promise<string>;
+/**
+ * Resolves a Gaia API CAIP-10 vault id back to the manifest vault id, or
+ * `undefined` when the vault is not in the bundled manifest (the API indexes
+ * more vaults than the manifest lists).
+ */
+export declare function vaultIdFromApiVaultId(client: GauntletClient, apiVaultId: string): Promise<string | undefined>;
+//# sourceMappingURL=caip.d.ts.map

package/dist/api/caip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip.d.ts","sourceRoot":"","sources":["../../src/api/caip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAItD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ7B"}

package/dist/api/caip.js

@@ -0,0 +1,38 @@
+import { VaultNotFoundError } from '../errors';
+import { resolveVault } from '../evm/vaults';
+import { InvalidCaipIdError } from './errors';
+export function parseApiVaultId(id) {
+    const match = /^(?:eip155:)?(\d+):(0x[0-9a-fA-F]{40})$/.exec(id);
+    if (!match)
+        throw new InvalidCaipIdError(id);
+    return { chainId: Number(match[1]), address: match[2].toLowerCase() };
+}
+export function formatApiVaultId(chainId, address) {
+    return `${chainId}:${address.toLowerCase()}`;
+}
+/**
+ * Resolves a manifest vault id (e.g. `VaultId.AeraUsdAlpha` / `'gtusda'`) to
+ * the Gaia API's CAIP-10 id for the vault's deployment on `chainId`.
+ *
+ * Deployment resolution is `resolveVault` — the same rules tx-building uses:
+ * single-deployment vaults resolve directly (a mismatched explicit `chainId`
+ * throws `ChainMismatchError`), multi-chain vaults default to Base when
+ * `chainId` is omitted.
+ */
+export async function apiVaultIdFromVaultId(client, vaultId, chainId) {
+    const resolved = await resolveVault(client, vaultId, chainId);
+    if (!resolved)
+        throw new VaultNotFoundError(vaultId, chainId);
+    return formatApiVaultId(resolved.vault.chainId, resolved.vault.vaultAddress);
+}
+/**
+ * Resolves a Gaia API CAIP-10 vault id back to the manifest vault id, or
+ * `undefined` when the vault is not in the bundled manifest (the API indexes
+ * more vaults than the manifest lists).
+ */
+export async function vaultIdFromApiVaultId(client, apiVaultId) {
+    const { chainId, address } = parseApiVaultId(apiVaultId);
+    const manifest = await client.manifest;
+    return manifest.vaults.find((v) => v.deployments.some((d) => d.chain === 'evm' && d.chainId === chainId && d.vaultAddress.toLowerCase() === address))?.vaultId;
+}
+//# sourceMappingURL=caip.js.map

package/dist/api/caip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip.js","sourceRoot":"","sources":["../../src/api/caip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAY9C,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,MAAM,KAAK,GAAG,yCAAyC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjE,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,OAAe;IAC/D,OAAO,GAAG,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAsB,EACtB,OAAe,EACf,OAAgB;IAEhB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9D,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9D,OAAO,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAsB,EACtB,UAAkB;IAElB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;IACvC,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAChC,CAAC,CAAC,WAAW,CAAC,IAAI,CAChB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,IAAI,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,OAAO,CAC9F,CACF,EAAE,OAAO,CAAC;AACb,CAAC"}

package/dist/api/client.d.ts

@@ -0,0 +1,114 @@
+import type { components } from './generated';
+import { type GauntletApiConfig } from './http';
+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 VaultTimeseriesResponse = Schemas['VaultTimeseriesResponse'];
+export type VaultTimeseriesPoint = Schemas['VaultTimeseriesPoint'];
+export type VaultMetrics = Schemas['VaultMetrics'];
+export type TvlResponse = Schemas['TvlResponse'];
+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;
+}
+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?: PageOptions): Promise<{
+        data: VaultDetail[];
+        meta: TimeseriesMeta;
+    }>;
+    /** 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}/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?: PageOptions): 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, optionally with per-source breakdown. */
+    tvl(options?: {
+        includeBreakdown?: boolean;
+    }): Promise<TvlResponse>;
+    /** 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/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/api/client.js

@@ -0,0 +1,109 @@
+import { apiGet } from './http';
+/**
+ * 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 class GauntletApi {
+    constructor(config = {}) {
+        this.config = config;
+    }
+    get(path, query) {
+        return 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 });
+    }
+    /** 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}/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,
+        });
+    }
+    /** 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, ...page } = options;
+        return this.get(`/v1/users/${encodeURIComponent(walletAddress)}/activity`, {
+            vault_id: vaultId,
+            ...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 ?? undefined;
+        } while (next);
+    }
+    /** GET /v1/tvl — aggregate Gauntlet TVL, optionally with per-source breakdown. */
+    tvl(options = {}) {
+        return this.get('/v1/tvl', { include_breakdown: options.includeBreakdown });
+    }
+    /** 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,
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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