@gauntlet-xyz/sdk 2.5.0 → 3.0.1

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

@@ -0,0 +1,2068 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/health": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Liveness check
+         * @description Returns service version + uptime. Use `/health/chains` for indexer freshness per chain.
+         */
+        get: operations["health"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/health/chains": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Chain sync status
+         * @description Returns per-chain indexer sync status with freshness indicators.
+         */
+        get: operations["chain_sync_status"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/prices": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get latest token price
+         * @description Returns the latest USD price for a token. Query parameters: `address` (required), `chain_id` (required), `at` (optional ISO 8601 timestamp).
+         */
+        get: operations["get_latest_price"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/prices/timeseries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get historical token prices
+         * @description Returns a USD price timeseries for a token. Query parameters: `address` (required), `chain_id` (required), `start` (required ISO 8601), `end` (required ISO 8601), `granularity` (optional: `raw` | `hour` | `day` | `week` | `month`), `limit` (optional, default 1000, max 5000).
+         */
+        get: operations["get_price_history"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/strategies": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List curated strategies
+         * @description Returns one card per curated strategy (Earn, Prime Lending, …) with aggregate metrics across the strategy's visible vaults: total TVL in USD, the highest 7/30/90-day APY ("APY up to"), and the vault count. TVL sums only vaults whose numeraire has a USD price; unpriced vaults still count toward `vault_count` and the APY maxes. Strategy membership and visibility are curated by Gauntlet; metrics come from the indexer and are refreshed continuously. Ordered by curated display order.
+         */
+        get: operations["list_strategies"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/tvl": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get live aggregate TVL
+         * @description Returns live aggregate Gauntlet TVL composed from indexed Gaia vault data and configured external TVL sources. `totals` always carries three coarse tranches: `vault_curation` (indexed non-Aera vaults, Symbiotic and Solana), `aera_v2` and `aera` (Aera V3). The `vault_curation` row spans several protocols. The Aera generations are separate product lines, not part of `vault_curation`. Pass `?mode=chain` for one `breakdown` row per chain, `?mode=protocol` for rows that map to Aera, Morpho V1, Morpho V2, Lista, Kamino and curated Symbiotic TVL, or `?mode=strategy` for one row per curated strategy from the admin registry, with indexed vaults no strategy claims under `uncategorized`. Protocol mode combines Aera V2 and V3 as `aera` and names the Solana source `kamino`. Symbiotic reads onchain `activeStake()`. Other modes keep these sources separate. The rows always sum to the headline total. Without `mode` no `breakdown` is returned.
+         */
+        get: operations["get_tvl"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/tvl/timeseries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the daily aggregate TVL timeseries
+         * @description Returns a fixed trailing 3-month daily series of aggregate Gauntlet TVL. Without `mode` each point's `sources` carry the same three coarse tranches the live `/v1/tvl` totals report: `vault_curation` (indexed non-Aera vaults, Symbiotic and Solana), `aera_v2` and `aera` (Aera V3). Pass `?mode=strategy` for a per-point `sources` breakdown with one entry per curated strategy (`prime_lending`, `balanced_lending`, `frontier_lending`, …), or `?mode=chain` for one entry per chain, or `?mode=protocol` for one entry per tracked vault protocol; indexed vaults that no curated strategy claims roll up under `uncategorized`. Protocol mode combines Aera V2 and V3 as `aera` and names the Solana source `kamino`. Other modes keep `aera` (Aera V3), `aera_v2`, `solana` and `symbiotic` as separate rows. The last three come from the `tvl_history` table. The hourly TVL job writes them. Symbiotic history starts with the first recorded snapshot. The rest is derived at read time from indexed Envio vault history plus historical USD pricing. Every point carries the same source ids in the same order, and they sum to that point's total, which does not depend on `mode`. A day with no data for a source contributes 0 to that day's total rather than carrying the last known value forward.
+         *
+         *     Served from a cached snapshot that is refreshed off the request path, so no caller pays for a recompute. `meta.data_as_of` is set when the snapshot is past its refresh window and a refresh is running behind the response; it is absent when the series is current.
+         *
+         *     A numeraire token with no USD price for part of the window is named in `meta.partial_errors`, and the balances it backs are excluded from the totals on those days. `TOKEN_PRICE_UNAVAILABLE` is a gap that should close, so it is retried on the next read; `TOKEN_PRICE_UNAVAILABLE_ACCEPTED` is one that cannot, with the reason in its message. Both mean the totals are short by that token; only the first is worth alerting on.
+         */
+        get: operations["get_tvl_timeseries"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/users/{wallet_address}/activity": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get user wallet activity (deposits, withdrawals, transfers)
+         * @description Immutable log of on-chain events that affected the wallet's vault position. Each row is a frozen-in-time record; rows never mutate after emission.
+         *
+         *     `?vault_id=` narrows to one vault; omitted = activity across every vault the wallet has touched, scoped to the Gauntlet-curated vault set (listed vaults by default, `include_hidden=true` widens to hidden vaults; disabled vaults never appear). Each row echoes its `vault_id` so wallet-wide consumers can distinguish per-vault activity.
+         *
+         *     Async deposit/redeem lifecycles emit multiple rows (one at request time with `status=pending`, a later one with `status=settled` or `refunded`). Consumers correlate them via `request_hash` to follow a single action across rows. Sync flows emit one row directly in the settled state.
+         *
+         *     Pagination is cursor-only. Default order is `desc` (newest first). Default page size 100, max 1000.
+         */
+        get: operations["get_user_activity"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/users/{wallet_address}/positions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get all current positions for a wallet
+         * @description Returns every vault position the wallet currently holds or has pending exposure in (pending deposit or redeem). Fully-exited positions (zero shares, no pending escrow) are excluded. Scoped to the Gauntlet-curated vault set: only positions in publicly listed vaults are returned by default, `include_hidden=true` widens to hidden (enabled but unlisted) vaults, and positions in disabled vaults are never returned.
+         *
+         *     All monetary metrics include a `usd` field (null when pricing is unavailable). `value.usd` and `pending_deposit_assets.usd` use the current spot price. `cost_basis.usd` and `pnl.realized.usd` are computed by replaying on-chain events against the token's historical price series — the same method used by `GET /v1/users/{wallet}/positions/{vault_id}`. `pnl.unrealized.usd`, `pnl.total.usd`, and `roi_pct.usd` are derived from those.
+         *
+         *     Cursor-paginated on internal position ID. Default page size 100, max 500.
+         */
+        get: operations["get_user_all_positions"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/users/{wallet_address}/positions/{vault_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get user position in a specific vault
+         * @description Returns the current position snapshot for a wallet in a single vault. Historical points live on `/positions/{vault_id}/timeseries`.
+         */
+        get: operations["get_user_vault_position"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/users/{wallet_address}/positions/{vault_id}/timeseries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get user position timeseries for a specific vault
+         * @description Returns historical value, cost basis, grouped PnL, and ROI data for a single vault position. Default order is `asc` (oldest first, chart-friendly); pass `?order=desc` for newest-first list views. Cursor-paginated — pass `meta.next_cursor` back as `?next=` for the next page (cursor is bound to the order it was created with). Defaults to `granularity=day` (one UTC-midnight snapshot per day); `week` returns Monday 00:00 UTC snapshots, `month` returns first-of-month 00:00 UTC snapshots, and `hour` returns the raw hourly cadence. Default page size is 1000.
+         */
+        get: operations["get_user_vault_position_timeseries"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/vaults": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Gauntlet-curated vaults
+         * @description Returns identification-only rows for the admin-curated visible vaults, ordered most-recent-first; pass `?include_hidden=true` for every enabled vault (hidden included, disabled never). Each row's `group.id` groups deployments of the same logical Admin vault, `group.slug` is its unique public route, and `group.is_primary` identifies its representative. Use `/{vault_id}` for current metrics, `/{vault_id}/definition` for the full vault definition, `/{vault_id}/timeseries` for history.
+         *
+         *     Cursor-paginated, but the default page size is the cap so most callers don't need to think about it — pass `meta.next_cursor` back as `?next=` only if the result exceeds 1000 vaults.
+         */
+        get: operations["list_vaults"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/vaults/{vault_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get current vault metrics
+         * @description Returns the current metrics snapshot for a vault — same metric shape that `/timeseries` emits per point, so this is `current point` and timeseries is `historical points`. The vault's Admin grouping is included when the deployment is associated. The protocol-specific definition (fees, hooks, curator, etc.) lives on `/{vault_id}/definition`.
+         */
+        get: operations["get_vault"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/vaults/{vault_id}/allocations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get current vault allocations
+         * @description Returns current allocations through a Gaia-owned, source-independent contract. Aera API is the initial source, but its metric-group schema is normalized into flat allocation values with discriminated targets. Use `/{vault_id}` or `/{vault_id}/timeseries` for vault-level metrics.
+         */
+        get: operations["get_vault_allocations"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/vaults/{vault_id}/definition": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get vault definition
+         * @description Returns the vault's identity + protocol-specific definition: name, owner, numeraire token, hooks, fees, curator, etc., merged inline based on `vault_type`. Aera carries hooks/feeCalculator, Morpho V1/V2 carry curator + WAD-scaled fees, Symbiotic carries identity only.
+         */
+        get: operations["get_vault_definition"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/vaults/{vault_id}/timeseries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get vault timeseries data
+         * @description Returns historical metric data points. Default order is `asc` (oldest first, chart-friendly); pass `?order=desc` for newest-first list views. Supports date range filtering and cursor pagination — pass `meta.next_cursor` back as `?next=` for the next page (cursor is bound to the order it was created with). Defaults to `granularity=day` (one UTC-midnight snapshot per day); `week` returns Monday 00:00 UTC snapshots, `month` returns first-of-month 00:00 UTC snapshots, and `hour` returns the raw hourly cadence. Default page size is 1000.
+         */
+        get: operations["get_vault_timeseries"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/vaults/featured": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List featured vaults
+         * @description Returns the admin-curated featured shortlist, one card per logical vault in curated order: display name, marketing description, deployed chains (highest-TVL first), supply token, aggregate TVL, and the highest 7/30/90-day APY across deployments. `vault_ids` carries per-deployment `{chainId}:{address}` ids for `/v1/vaults/{vault_id}` links, in the same order as `chains`.
+         */
+        get: operations["list_featured_vaults"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/vaults/slug/{slug}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get vault deployments by slug
+         * @description Returns every indexed deployment associated with one exact Admin vault slug. The lookup serves visible and hidden enabled vaults without making hidden vaults enumerable; disabled and unknown slugs return 404. Each item has the same shape as an item from `GET /v1/vaults`.
+         */
+        get: operations["get_vaults_by_slug"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/vaults/slug/{slug}/primary/timeseries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get primary deployment timeseries by vault slug
+         * @description Returns historical metric data for the Admin-selected primary deployment of an enabled logical vault. `meta.resolved_vault_id` identifies the concrete deployment. The response and query parameters are otherwise identical to `/{vault_id}/timeseries`; use this route when callers know the stable public vault slug but should not depend on its current chain or address.
+         */
+        get: operations["get_primary_vault_timeseries_by_slug"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/vaults/slug/{slug}/timeseries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get vault history by slug
+         * @description Returns USD TVL and outstanding share supply summed across every currently linked deployment of an enabled logical vault, including hidden vaults. Uses UTC-aligned snapshots and timestamp pagination. A deployment contributes zero before its indexed creation time; after creation, missing snapshots or USD prices produce null TVL, never a partial sum. Does not carry values forward. Missing supply or a missing snapshot after deployment creation produces null total_supply, independent of USD price availability. APY and unit_price come from the Admin-selected primary deployment at the same timestamp, identified by meta.resolved_vault_id. Missing primary snapshots yield null primary metrics; APY respects Admin visibility. TVL is USD-only because deployment numeraires may differ; native TVL remains available on the primary/per-deployment endpoints. This is a sum of deployment TVLs, not the legacy asset-position valuation. Unknown or disabled slugs return 404; incomplete deployment metadata returns 503.
+         */
+        get: operations["get_vault_timeseries_by_slug"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        Allocation: {
+            /**
+             * Format: double
+             * @description Fraction of the parent vault allocated to this target (1.0 = 100%).
+             */
+            allocation?: number | null;
+            /** Format: double */
+            amount?: number | null;
+            /** Format: double */
+            amount_usd?: number | null;
+            /** @description Source-independent category used by consumers to select allocation sections. */
+            category: string;
+            target: components["schemas"]["AllocationTarget"];
+        };
+        AllocationFlow: {
+            kind: components["schemas"]["AllocationFlowKind"];
+            target_vault_address: string;
+        };
+        /** @enum {string} */
+        AllocationFlowKind: "pending_deposit" | "pending_redemption";
+        AllocationProtocol: {
+            id: string;
+            name: string;
+        };
+        AllocationTarget: {
+            address: string;
+            /** Format: int64 */
+            chain_id: number;
+            flow?: null | components["schemas"]["AllocationFlow"];
+            /** @enum {string} */
+            kind: "asset";
+            name?: string | null;
+            protocol?: null | components["schemas"]["AllocationProtocol"];
+            strategy_type: string;
+            symbol: string;
+        };
+        /**
+         * @description Decimal-string metric paired across native (numeraire-token) and USD.
+         *     `native` is always present; `usd` is JSON null when pricing is unavailable.
+         */
+        AmountPair: {
+            native: string;
+            usd?: string | null;
+        };
+        /**
+         * @description Asset-delta envelope on user activity rows. `native` is always present;
+         *     `token` is present when the indexer knows the row's asset token.
+         *     The struct shape is kept stable so derived denominations (usd,
+         *     numeraire token) can be added later without breaking integrators.
+         */
+        AssetDelta: {
+            native: string;
+            token?: null | components["schemas"]["TokenRef"];
+        };
+        BasicMeta: {
+            /** Format: date-time */
+            refreshed_at: string;
+            request_id: string;
+        };
+        ChainSyncStatus: {
+            /** Format: int64 */
+            chain_id: number;
+            freshness: string;
+            /** Format: int64 */
+            lag_seconds: number;
+            /** Format: int64 */
+            latest_block: number;
+            /** Format: int64 */
+            latest_timestamp: number;
+        };
+        /**
+         * @description USD amount on curated aggregates: decimal string, `null` when the
+         *     pricing service is not configured.
+         */
+        CuratedTvl: {
+            usd?: string | null;
+        };
+        ErrorBody: {
+            /** @description Machine-readable error code (e.g. `NOT_FOUND`, `UNAUTHORIZED`) */
+            code: string;
+            details?: unknown;
+            /** @description Human-readable error message */
+            message: string;
+        };
+        /** @description Standard error response envelope returned on 4xx/5xx */
+        ErrorResponse: {
+            error: components["schemas"]["ErrorBody"];
+        };
+        FeaturedVault: {
+            /**
+             * Format: double
+             * @description Highest 7-day APY across the vault's deployments, fraction
+             *     (0.0573 = 5.73%). `null` while every window is warming up or APY
+             *     display is disabled for this vault.
+             */
+            apy_7d_max?: number | null;
+            /**
+             * Format: double
+             * @description Highest 30-day APY across the vault's deployments.
+             */
+            apy_30d_max?: number | null;
+            /**
+             * Format: double
+             * @description Highest 90-day APY across the vault's deployments.
+             */
+            apy_90d_max?: number | null;
+            /** @description Chain slugs the vault is deployed on, highest-TVL first. */
+            chains: string[];
+            /**
+             * @description Curated marketing description; `null` when the curator hasn't
+             *     written one.
+             */
+            description?: string | null;
+            /**
+             * @description Curated display name; falls back to the registry id when the
+             *     curator hasn't named the vault yet. `vault_id` carries the
+             *     stable logical identifier.
+             */
+            name: string;
+            /**
+             * @description Card-length copy (e.g. "Conservative lending yield with low
+             *     risk"). `null` when the curator hasn't written any; consumers
+             *     decide whether to fall back to `description`.
+             */
+            short_description?: string | null;
+            /** @description Stable public route for the logical vault group. */
+            slug: string;
+            /**
+             * @description Supply (numeraire) token symbol, from the highest-TVL deployment
+             *     that reports one.
+             */
+            supply_token?: string | null;
+            /** @description Aggregate TVL across the vault's deployments ("Total Supply"). */
+            tvl: components["schemas"]["CuratedTvl"];
+            /**
+             * Format: date-time
+             * @description Most recent indexer snapshot among the vault's deployments;
+             *     `null` when no deployment carried a usable timestamp.
+             */
+            updated_at?: string | null;
+            /** @description Stable logical vault id assigned by Admin. */
+            vault_id: string;
+            /**
+             * @description Per-deployment API vault ids (`{chainId}:{address}`, same order
+             *     as `chains`) for `/v1/vaults/{vault_id}` links.
+             */
+            vault_ids: string[];
+        };
+        FeaturedVaultsResponse: {
+            data: components["schemas"]["FeaturedVault"][];
+            meta: components["schemas"]["ListMeta"];
+        };
+        HealthResponse: {
+            status: string;
+            /** Format: int64 */
+            uptime_seconds: number;
+            version: string;
+        };
+        HistoricalPriceValue: {
+            /** Format: double */
+            usd: number;
+        };
+        LatestPriceResponse: {
+            address: string;
+            /** Format: int64 */
+            chain_id: number;
+            currency: string;
+            price: components["schemas"]["PriceValue"];
+            symbol: string;
+            timestamp: string;
+        };
+        /**
+         * @description Documented metadata for list endpoints; pagination fields are omitted
+         *     by unpaginated responses.
+         */
+        ListMeta: {
+            /**
+             * Format: int64
+             * @description Number of items in this response.
+             */
+            count: number;
+            /**
+             * Format: int64
+             * @description Page-size cap actually applied to paginated lists.
+             */
+            limit?: number | null;
+            /** @description Set when more pages exist; pass back as `?next=`. */
+            next_cursor?: string | null;
+            /** @description Item-scoped failures isolated from an aggregate response. */
+            partial_errors?: components["schemas"]["PartialResponseError"][] | null;
+            /** Format: date-time */
+            refreshed_at: string;
+            request_id: string;
+        };
+        PartialResponseError: {
+            /** @description Machine-readable error code for the isolated item failure. */
+            code: string;
+            /** @description Human-readable error message. */
+            message: string;
+            /** @description Resource that failed inside the aggregate response, when known. */
+            resource_id?: string | null;
+        };
+        PnlBreakdown: {
+            /** @description Locked-in PnL from past disposals. */
+            realized: components["schemas"]["AmountPair"];
+            /** @description `unrealized` + `realized`. */
+            total: components["schemas"]["AmountPair"];
+            /** @description `value` − `cost_basis`. */
+            unrealized: components["schemas"]["AmountPair"];
+        };
+        PositionTimeseriesPoint: {
+            /** @description Cumulative cost of held shares (`usd` uses per-event historical pricing). */
+            cost_basis: components["schemas"]["AmountPair"];
+            /** @description Profit and loss grouped by total, unrealized, and realized values. */
+            pnl: components["schemas"]["PnlBreakdown"];
+            /** @description ROI ratio (`native` is in-kind; `usd` is null when pricing unavailable). */
+            roi_pct: components["schemas"]["RatioPair"];
+            /** @description Shares currently held by the wallet at this timestamp. */
+            shares_owned: string;
+            /** Format: date-time */
+            timestamp: string;
+            /**
+             * @description Position value at this timestamp (`native` = numeraire-token units,
+             *     `usd` = `native` × historical USD price; null when unavailable).
+             */
+            value: components["schemas"]["AmountPair"];
+        };
+        PriceValue: {
+            /** Format: int32 */
+            decimals: number;
+            /** Format: double */
+            usd: number;
+        };
+        /**
+         * @description Deployment-local metrics. Null when the primary has no snapshot at this
+         *     timestamp; APY also respects the Admin visibility setting.
+         */
+        PrimaryVaultTimeseriesMetrics: {
+            /** Format: double */
+            apy_7d?: number | null;
+            /** Format: double */
+            apy_30d?: number | null;
+            /** Format: double */
+            apy_90d?: number | null;
+            /** @description Numeraire-token units per share on the primary deployment. */
+            unit_price?: string | null;
+        };
+        /**
+         * @description JSON-number ratio paired across native (in-kind) and USD denominations.
+         *     Null when event history is unavailable or cannot support ROI replay.
+         */
+        RatioPair: {
+            /** Format: double */
+            native?: number | null;
+            /** Format: double */
+            usd?: number | null;
+        };
+        StrategyCard: {
+            /**
+             * Format: double
+             * @description Highest 7-day APY across the strategy's vaults ("APY Up To"),
+             *     fraction (0.0953 = 9.53%). `null` while every vault's window is
+             *     still warming up. Vaults with APY display disabled do not
+             *     contribute to this aggregate.
+             */
+            apy_7d_max?: number | null;
+            /**
+             * Format: double
+             * @description Highest 30-day APY across the strategy's vaults.
+             */
+            apy_30d_max?: number | null;
+            /**
+             * Format: double
+             * @description Highest 90-day APY across the strategy's vaults.
+             */
+            apy_90d_max?: number | null;
+            /** @description Marketing description of the strategy. */
+            description?: string | null;
+            /**
+             * @description Strategy identifier from the admin vocabulary (e.g. `earn`,
+             *     `prime_lending`).
+             */
+            id: string;
+            /** @description Display name (e.g. "Prime Lending"). */
+            name: string;
+            /**
+             * @description Card-length copy (e.g. "Conservative lending yield with low
+             *     risk"). `null` when the curator hasn't written any; consumers
+             *     decide whether to fall back to `description`.
+             */
+            short_description?: string | null;
+            /**
+             * @description Aggregate TVL across the strategy's priced vaults ("Total
+             *     Supply"). Vaults whose numeraire has no USD price are left out of
+             *     the sum but still count toward `vault_count` and the APY maxes.
+             */
+            tvl: components["schemas"]["CuratedTvl"];
+            /**
+             * Format: date-time
+             * @description Most recent indexer snapshot among the strategy's vaults; `null`
+             *     in the degenerate case where no matched row carried a timestamp.
+             */
+            updated_at?: string | null;
+            /**
+             * Format: int64
+             * @description Visible curated vaults in this strategy that matched at least one
+             *     indexed deployment.
+             */
+            vault_count: number;
+        };
+        StrategyListResponse: {
+            data: components["schemas"]["StrategyCard"][];
+            meta: components["schemas"]["ListMeta"];
+        };
+        /** @description Curated strategy assignment from the admin registry. */
+        StrategyRef: {
+            /**
+             * @description Strategy label id (`prime_lending`, `earn`, …) — matches
+             *     `/v1/strategies` card ids.
+             */
+            id: string;
+            /** @description Display name (`Prime Lending`). */
+            name: string;
+        };
+        TimeseriesMeta: {
+            /**
+             * Format: int64
+             * @description Number of points in this response.
+             */
+            count: number;
+            /** Format: date-time */
+            end?: string | null;
+            /**
+             * Format: int64
+             * @description Page-size cap actually applied.
+             */
+            limit: number;
+            /** @description Set when more pages exist; pass back as `?next=`. */
+            next_cursor?: string | null;
+            /** @description Item-scoped failures isolated from an aggregate response. */
+            partial_errors?: components["schemas"]["PartialResponseError"][] | null;
+            /** Format: date-time */
+            refreshed_at: string;
+            request_id: string;
+            /**
+             * @description Primary deployment selected for deployment-local metrics by a slug
+             *     route. The aggregate slug route still sums TVL and supply across deployments.
+             *     Omitted when the deployment is already identified in the request path.
+             */
+            resolved_vault_id?: string | null;
+            /**
+             * Format: date-time
+             * @description Window bounds the response covers (echoes the request when set).
+             */
+            start?: string | null;
+        };
+        TimeseriesPoint: {
+            price: components["schemas"]["HistoricalPriceValue"];
+            timestamp: string;
+        };
+        TimeseriesResponse: {
+            data: components["schemas"]["TimeseriesPoint"][];
+        };
+        TokenRef: {
+            address: string;
+            /** Format: int32 */
+            decimals?: number | null;
+            symbol?: string | null;
+        };
+        TvlAmount: {
+            usd: string;
+        };
+        TvlBreakdown: {
+            id: string;
+            label: string;
+            source_id: string;
+            tvl: components["schemas"]["TvlAmount"];
+            /** Format: date-time */
+            updated_at: string;
+        };
+        /**
+         * @description Which partition of indexed vault TVL the caller asked for. Absent
+         *     from a request means the headline figures only, with no breakdown.
+         * @enum {string}
+         */
+        TvlBreakdownMode: "chain" | "strategy" | "protocol";
+        TvlResponse: {
+            data: components["schemas"]["TvlSummary"];
+            meta: components["schemas"]["BasicMeta"];
+        };
+        TvlSummary: {
+            breakdown?: components["schemas"]["TvlBreakdown"][] | null;
+            totals: components["schemas"]["TvlTotal"][];
+            tvl: components["schemas"]["TvlAmount"];
+            /** Format: date-time */
+            updated_at: string;
+        };
+        TvlTimeseriesPoint: {
+            /**
+             * @description The day's breakdown. `?mode=` picks how it is partitioned; the
+             *     total above never depends on that choice.
+             */
+            sources: components["schemas"]["TvlTimeseriesSourceAmount"][];
+            /** Format: date-time */
+            timestamp: string;
+            tvl: components["schemas"]["TvlAmount"];
+        };
+        TvlTimeseriesResponse: {
+            data: components["schemas"]["TvlTimeseriesPoint"][];
+            meta: components["schemas"]["WindowMeta"];
+        };
+        /**
+         * @description One series of the day's breakdown. `id` is a curated strategy id
+         *     (`prime_lending`, `balanced_lending`, `frontier_lending`, …) in
+         *     `mode=strategy`, an admin chain slug (`ethereum`, `base`, …) in
+         *     `mode=chain`, or one of the reserved ids `aera`, `aera_v2`,
+         *     `solana`, `uncategorized`. Every point carries the same ids in the
+         *     same order, and they sum to the point's `tvl`.
+         */
+        TvlTimeseriesSourceAmount: {
+            id: string;
+            label: string;
+            tvl: components["schemas"]["TvlAmount"];
+        };
+        TvlTotal: {
+            id: string;
+            label: string;
+            tvl: components["schemas"]["TvlAmount"];
+            /** Format: date-time */
+            updated_at: string;
+        };
+        /**
+         * @description One immutable entry in the wallet's activity log.
+         *
+         *     Each row represents a single on-chain event that affected the
+         *     wallet's vault position. Async deposit/redeem lifecycles emit
+         *     multiple rows (one per lifecycle event — request, solve, refund);
+         *     each row is frozen at emission time and never mutates. To follow
+         *     an async action across rows, correlate via `request_hash`.
+         */
+        UserActivity: {
+            /**
+             * @description Signed asset delta in the row's asset-token units, using a
+             *     deposit-ledger sign convention (NOT wallet-flow direction):
+             *     - Positive = a deposit-direction action (`deposit`,
+             *       `deposit_pending`, `transfer_in`).
+             *     - Negative = a withdraw-direction action (`withdraw`,
+             *       `deposit_refunded`, `transfer_out`).
+             *     - `0` = no asset movement at this event
+             *       (`deposit` on Aera async solve, `withdraw_pending`,
+             *       `withdraw_refunded`).
+             *
+             *     Note: under this convention `deposit_refunded` is negative
+             *     (a deposit was unwound) even though tokens flow back INTO the
+             *     wallet, and async `withdraw` (Aera redeem_solved) is negative
+             *     even though tokens flow back INTO the wallet — the sign tracks
+             *     the deposit-ledger direction, not the user's wallet balance.
+             *
+             *     Summing across rows for a single async lifecycle gives the net
+             *     signed asset movement of that lifecycle (no double-counting).
+             *     `assets_delta.token` identifies the asset token when known. Emitted
+             *     as a struct (`{ native: "...", token: { address, symbol } }`) so
+             *     derived denominations (e.g. usd) can be added later without breaking
+             *     the response shape.
+             */
+            assets_delta: components["schemas"]["AssetDelta"];
+            /**
+             * @description Block hash — 1:1 identifier for the block this event was mined
+             *     in. Consumers needing to detect reorgs should key off this rather
+             *     than `block_number` (multiple blocks can share a number across a
+             *     reorg).
+             */
+            block_hash: string;
+            /**
+             * Format: int64
+             * @description Block number — kept alongside `block_timestamp` for on-chain
+             *     reconciliation / explorer linking.
+             */
+            block_number: number;
+            /**
+             * Format: int64
+             * @description Unix seconds, block time (`block.timestamp` from the chain).
+             */
+            block_timestamp: number;
+            /**
+             * @description Aera async-flow correlation hash. Links a `*_pending` row to
+             *     its later terminal row (bare `deposit`/`withdraw` for settled,
+             *     or `*_refunded`) of the same lifecycle. Emitted only on rows
+             *     that participate in an async flow; omitted on sync rows and on
+             *     secondary-market transfers.
+             */
+            request_hash?: string | null;
+            /**
+             * @description Signed share delta in 18-decimal units, reported at the event
+             *     where the shares actually moved. Conventions by row type:
+             *     - `deposit` — positive (shares minted to the wallet).
+             *     - `deposit_pending` / `deposit_refunded` — `0` (no share
+             *       movement; deposit requests touch assets only).
+             *     - `withdraw_pending` — negative for Aera async redeems (shares
+             *       leave the wallet at request time, escrowed to the Provisioner).
+             *     - `withdraw` — negative for sync (Morpho) withdraws (shares
+             *       burn on the same row that pays out assets); `0` for Aera
+             *       async redeems (the share movement is recorded on the paired
+             *       `withdraw_pending` row).
+             *     - `withdraw_refunded` — positive (escrowed shares return).
+             *     - `transfer_in` — positive; `transfer_out` — negative.
+             *
+             *     Summing across rows for a single async lifecycle gives the net
+             *     share movement of that lifecycle — there is no double-counting.
+             */
+            shares_delta: string;
+            /** @description Transaction hash of the on-chain event. */
+            tx_hash: string;
+            /**
+             * @description What happened. One of:
+             *     - `deposit` — settled deposit (sync vault flow or async terminal solve).
+             *     - `deposit_pending` — async deposit request submitted; awaiting solver.
+             *     - `deposit_refunded` — async deposit returned without settling; assets bounced back.
+             *     - `withdraw` — settled withdrawal (sync vault flow or async terminal solve).
+             *     - `withdraw_pending` — async redeem request submitted; awaiting solver.
+             *     - `withdraw_refunded` — async redeem returned without settling; shares bounced back.
+             *     - `transfer_in` — vault shares received from another EOA (secondary market).
+             *     - `transfer_out` — vault shares sent to another EOA.
+             *
+             *     Async deposit/redeem lifecycles emit two rows (a `*_pending` at
+             *     request time, then a separate terminal row — bare `deposit` or
+             *     `_refunded` — at solve time). Rows are immutable; the pending
+             *     row never mutates. Correlate the pair via `request_hash`.
+             */
+            type: string;
+            /** @description CAIP-10 vault identifier this row belongs to. Always emitted. */
+            vault_id: string;
+        };
+        UserActivityResponse: {
+            data: components["schemas"]["UserActivity"][];
+            meta: components["schemas"]["TimeseriesMeta"];
+        };
+        UserAllPositionsResponse: {
+            data: components["schemas"]["UserPosition"][];
+            meta: components["schemas"]["TimeseriesMeta"];
+        };
+        UserPosition: {
+            metrics: components["schemas"]["UserPositionMetrics"];
+            numeraire_token?: null | components["schemas"]["TokenRef"];
+            vault_id: string;
+            wallet_address: string;
+        };
+        UserPositionLatestResponse: {
+            data: components["schemas"]["UserPosition"];
+            meta: components["schemas"]["BasicMeta"];
+        };
+        UserPositionMetrics: {
+            /** @description Cumulative cost of currently-held shares. */
+            cost_basis: components["schemas"]["AmountPair"];
+            /**
+             * @description Assets escrowed at the Aera Provisioner pending share mint
+             *     (`native` = numeraire-token units, `usd` = `native` × current USD price).
+             */
+            pending_deposit_assets: components["schemas"]["AmountPair"];
+            /** @description Shares escrowed at the Aera Provisioner pending asset return. */
+            pending_redeem_shares: string;
+            /** @description Profit and loss grouped by total, unrealized, and realized values. */
+            pnl: components["schemas"]["PnlBreakdown"];
+            /** @description Time-weighted ROI from user deposit/redeem history. */
+            roi_pct: components["schemas"]["RatioPair"];
+            /** @description Shares currently held by the wallet. */
+            shares_owned: string;
+            /**
+             * @description Current market value of held shares (`native` = numeraire-token
+             *     units, `usd` = `native` × current USD price).
+             */
+            value: components["schemas"]["AmountPair"];
+        };
+        UserPositionsTimeseriesResponse: {
+            data: components["schemas"]["PositionTimeseriesPoint"][];
+            meta: components["schemas"]["TimeseriesMeta"];
+        };
+        VaultAllocations: {
+            allocations: components["schemas"]["Allocation"][];
+            /** Format: date-time */
+            as_of?: string | null;
+            vault_id: string;
+        };
+        VaultAllocationsResponse: {
+            data: components["schemas"]["VaultAllocations"];
+            meta: components["schemas"]["BasicMeta"];
+        };
+        VaultDetail: {
+            address: string;
+            /** Format: int64 */
+            chain_id: number;
+            group?: null | components["schemas"]["VaultGroupRef"];
+            metrics: components["schemas"]["VaultMetrics"];
+            name: string;
+            numeraire_token: components["schemas"]["TokenRef"];
+            strategy?: null | components["schemas"]["StrategyRef"];
+            /**
+             * @description CAIP id of the vault that replaces this one on the same chain
+             *     (Morpho V1 to V2 today); `null` when there is no visible
+             *     successor. Consumers use it to point holders at the new vault.
+             */
+            successor_vault_id?: string | null;
+            symbol: string;
+            vault_id: string;
+            vault_type: string;
+        };
+        VaultDetailResponse: {
+            data: components["schemas"]["VaultDetail"];
+            meta: components["schemas"]["BasicMeta"];
+        };
+        /** @description Admin-curated logical grouping for a deployment-level vault row. */
+        VaultGroupRef: {
+            /** @description Admin-curated deployment date (`YYYY-MM-DD`). */
+            deployment_date?: string | null;
+            /** @description Admin-curated long-form detail-page copy. */
+            description?: string | null;
+            /** @description Stable internal group id from the Admin vault registry (`vlt_176`). */
+            id: string;
+            /** @description Whether this deployment is the group's primary representative. */
+            is_primary: boolean;
+            /** @description Whether performance views should use a stable-denominated basis. */
+            is_stable: boolean;
+            /** @description Unique, curator-managed public route (`stgusda`). */
+            slug: string;
+        };
+        VaultGroupTimeseriesPoint: components["schemas"]["PrimaryVaultTimeseriesMetrics"] & {
+            /** Format: date-time */
+            timestamp: string;
+            /**
+             * @description Outstanding shares summed across linked deployments. Null if an existing
+             *     deployment has a missing snapshot or supply; independent of USD pricing.
+             */
+            total_supply?: string | null;
+            /**
+             * @description Sum across all linked deployments. Null if an existing deployment
+             *     has a missing snapshot or USD price; never a partial sum.
+             */
+            tvl: components["schemas"]["CuratedTvl"];
+        };
+        VaultGroupTimeseriesResponse: {
+            data: components["schemas"]["VaultGroupTimeseriesPoint"][];
+            meta: components["schemas"]["TimeseriesMeta"];
+        };
+        VaultListResponse: {
+            data: components["schemas"]["VaultDetail"][];
+            meta: components["schemas"]["ListMeta"];
+        };
+        VaultMetrics: {
+            /** Format: double */
+            apy_7d?: number | null;
+            /** Format: double */
+            apy_30d?: number | null;
+            /** Format: double */
+            apy_90d?: number | null;
+            /** Format: int64 */
+            as_of?: number | null;
+            total_supply: string;
+            tvl: components["schemas"]["AmountPair"];
+            unit_price: string;
+        };
+        VaultTimeseriesPoint: {
+            /** Format: double */
+            apy_7d?: number | null;
+            /** Format: double */
+            apy_30d?: number | null;
+            /** Format: double */
+            apy_90d?: number | null;
+            /** Format: date-time */
+            timestamp: string;
+            total_supply: string;
+            tvl: components["schemas"]["AmountPair"];
+            unit_price: string;
+        };
+        VaultTimeseriesResponse: {
+            data: components["schemas"]["VaultTimeseriesPoint"][];
+            meta: components["schemas"]["TimeseriesMeta"];
+        };
+        /**
+         * @description Doc type for a windowed timeseries served as one fixed grid: every
+         *     point in the window, so there is no page cap and no cursor. Split
+         *     from [`TimeseriesMeta`], whose required `limit` those handlers leave
+         *     `None`. That would put a never-populated required field in the
+         *     generated SDK types.
+         */
+        WindowMeta: {
+            /**
+             * Format: int64
+             * @description Number of points in this response.
+             */
+            count: number;
+            /**
+             * Format: date-time
+             * @description When the served data was computed, on endpoints that serve a
+             *     cached snapshot past its refresh window while a refresh runs
+             *     behind the response. Absent means the data is current.
+             */
+            data_as_of?: string | null;
+            /** Format: date-time */
+            end: string;
+            /** @description Item-scoped failures isolated from an aggregate response. */
+            partial_errors?: components["schemas"]["PartialResponseError"][] | null;
+            /** Format: date-time */
+            refreshed_at: string;
+            request_id: string;
+            /**
+             * Format: date-time
+             * @description Window bounds the response covers.
+             */
+            start: string;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    health: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Service is live */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HealthResponse"];
+                };
+            };
+        };
+    };
+    chain_sync_status: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Chain sync status */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ChainSyncStatus"][];
+                };
+            };
+        };
+    };
+    get_latest_price: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Token price */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LatestPriceResponse"];
+                };
+            };
+            /** @description Token not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid parameters */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Pricing service not configured */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_price_history: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Price timeseries */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TimeseriesResponse"];
+                };
+            };
+            /** @description Invalid parameters */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Pricing service not configured */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    list_strategies: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of strategy cards */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StrategyListResponse"];
+                };
+            };
+            /** @description Missing or invalid auth */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Data source unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    get_tvl: {
+        parameters: {
+            query?: {
+                /** @description Breakdown to return: `chain`, `protocol` or `strategy`. Omit for the headline figures only. */
+                mode?: components["schemas"]["TvlBreakdownMode"];
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Live aggregate TVL */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TvlResponse"];
+                };
+            };
+            /** @description Missing or invalid auth */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Data source unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    get_tvl_timeseries: {
+        parameters: {
+            query?: {
+                /** @description Per-point breakdown to return: `chain`, `protocol` or `strategy`. Omit for the daily total only. */
+                mode?: components["schemas"]["TvlBreakdownMode"];
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Daily aggregate TVL timeseries */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TvlTimeseriesResponse"];
+                };
+            };
+            /** @description Missing or invalid auth */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Data source unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    get_user_activity: {
+        parameters: {
+            query?: {
+                /** @description Wallet-wide feeds only: include activity in hidden (enabled but unlisted) vaults alongside visible ones. Activity in disabled vaults is never returned. Ignored when `vault_id` is set. */
+                include_hidden?: boolean;
+                /** @description Page size (1–1000, default 100). */
+                limit?: number;
+                /** @description Opaque cursor from previous `meta.next_cursor`. */
+                next?: string;
+                /** @description Sort direction: `desc` (default) or `asc`. */
+                order?: string;
+                /** @description CAIP-10 vault identifier. Optional — omit for wallet-wide activity across every vault the wallet has touched. */
+                vault_id?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Ethereum wallet address */
+                wallet_address: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description User wallet activity */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UserActivityResponse"];
+                };
+            };
+            /** @description Missing or invalid auth */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Invalid cursor */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    get_user_all_positions: {
+        parameters: {
+            query?: {
+                /** @description Include positions in hidden (enabled but unlisted) vaults alongside visible ones. Positions in disabled vaults are never returned. */
+                include_hidden?: boolean;
+                /** @description Page size (1–500, default 100). */
+                limit?: number;
+                /** @description Opaque cursor from previous `meta.next_cursor`. */
+                next?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Ethereum wallet address */
+                wallet_address: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description All wallet positions */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UserAllPositionsResponse"];
+                };
+            };
+            /** @description Missing or invalid auth */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Invalid cursor */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    get_user_vault_position: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Vault identifier */
+                vault_id: string;
+                /** @description Ethereum wallet address */
+                wallet_address: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Single vault position */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UserPositionLatestResponse"];
+                };
+            };
+            /** @description Missing or invalid auth */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Position not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    get_user_vault_position_timeseries: {
+        parameters: {
+            query?: {
+                /** @description Window end: ISO 8601 date (`2026-01-01`, read as 00:00:00 UTC) or RFC 3339 timestamp (`2026-01-01T00:00:00Z`). */
+                end?: string;
+                /** @description Sampling granularity: `day` (default), `hour`, `week`, or `month`. Day/week/month buckets start at 00:00 UTC; weeks start Monday and months start on the 1st. */
+                granularity?: string;
+                /** @description Page size (1–10000, default 1000). */
+                limit?: number;
+                /** @description Opaque cursor from previous `meta.next_cursor`. */
+                next?: string;
+                /** @description Sort direction: `asc` (default) or `desc`. */
+                order?: string;
+                /** @description Window start: ISO 8601 date (`2026-01-01`, read as 00:00:00 UTC) or RFC 3339 timestamp (`2026-01-01T00:00:00Z`). */
+                start?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Vault identifier */
+                vault_id: string;
+                /** @description Ethereum wallet address */
+                wallet_address: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Position timeseries */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UserPositionsTimeseriesResponse"];
+                };
+            };
+            /** @description Missing or invalid auth */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Invalid cursor */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    list_vaults: {
+        parameters: {
+            query?: {
+                /** @description Include hidden (enabled but unlisted) vaults alongside visible ones. Disabled vaults are never listed. */
+                include_hidden?: boolean;
+                /** @description Page size (1–1000, default 1000). */
+                limit?: number;
+                /** @description Opaque cursor from previous `meta.next_cursor`. */
+                next?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of vaults */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["VaultListResponse"];
+                };
+            };
+            /** @description Missing or invalid auth */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Invalid cursor */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    get_vault: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Vault identifier (CAIP-10 `chainId:address`) */
+                vault_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Current vault metrics */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["VaultDetailResponse"];
+                };
+            };
+            /** @description Missing or invalid auth */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Vault not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    get_vault_allocations: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Vault identifier (CAIP-10 `chainId:address`) */
+                vault_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Current vault allocations */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["VaultAllocationsResponse"];
+                };
+            };
+            /** @description Missing or invalid auth */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Vault not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Invalid vault identifier or non-Aera vault */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Allocation data source unavailable */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Vault metadata source unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    get_vault_definition: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Vault identifier (CAIP-10 `chainId:address`) */
+                vault_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Vault definition */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Missing or invalid auth */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Vault not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    get_vault_timeseries: {
+        parameters: {
+            query?: {
+                /** @description Window end: ISO 8601 date (`2026-01-01`, read as 00:00:00 UTC) or RFC 3339 timestamp (`2026-01-01T00:00:00Z`). */
+                end?: string;
+                /** @description Sampling granularity: `day` (default), `hour`, `week`, or `month`. Day/week/month buckets start at 00:00 UTC; weeks start Monday and months start on the 1st. */
+                granularity?: string;
+                /** @description Page size (1–10000, default 1000). */
+                limit?: number;
+                /** @description Opaque cursor from previous `meta.next_cursor`. */
+                next?: string;
+                /** @description Sort direction: `asc` (default) or `desc`. */
+                order?: string;
+                /** @description Window start: ISO 8601 date (`2026-01-01`, read as 00:00:00 UTC) or RFC 3339 timestamp (`2026-01-01T00:00:00Z`). */
+                start?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Vault identifier */
+                vault_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Timeseries data points */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["VaultTimeseriesResponse"];
+                };
+            };
+            /** @description Missing or invalid auth */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Vault not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Invalid parameters */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    list_featured_vaults: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Featured vault cards */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FeaturedVaultsResponse"];
+                };
+            };
+            /** @description Missing or invalid auth */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Data source unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    get_vaults_by_slug: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Admin-curated public vault slug */
+                slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Deployments for the vault slug */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["VaultListResponse"];
+                };
+            };
+            /** @description Missing or invalid auth */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Vault slug not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Data source unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    get_primary_vault_timeseries_by_slug: {
+        parameters: {
+            query?: {
+                /** @description Window end: ISO 8601 date or RFC 3339 timestamp. */
+                end?: string;
+                /** @description Sampling granularity: `day` (default), `hour`, `week`, or `month`. */
+                granularity?: string;
+                /** @description Page size (1–10000, default 1000). */
+                limit?: number;
+                /** @description Opaque cursor from previous `meta.next_cursor`. */
+                next?: string;
+                /** @description Sort direction: `asc` (default) or `desc`. */
+                order?: string;
+                /** @description Window start: ISO 8601 date or RFC 3339 timestamp. */
+                start?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Admin-curated public vault slug */
+                slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Primary deployment timeseries data points */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["VaultTimeseriesResponse"];
+                };
+            };
+            /** @description Missing or invalid auth */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Vault slug not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Invalid parameters */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Data source or vault curation unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    get_vault_timeseries_by_slug: {
+        parameters: {
+            query?: {
+                /** @description Window end: ISO 8601 date or RFC 3339 timestamp. */
+                end?: string;
+                /** @description Sampling granularity: `day` (default), `hour`, `week`, or `month`. */
+                granularity?: string;
+                /** @description Page size (1–10000, default 1000). */
+                limit?: number;
+                /** @description Opaque cursor from previous `meta.next_cursor`. */
+                next?: string;
+                /** @description Sort direction: `asc` (default) or `desc`. */
+                order?: string;
+                /** @description Window start: ISO 8601 date or RFC 3339 timestamp. */
+                start?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Admin-curated public vault slug */
+                slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Aggregate USD TVL and share supply with primary deployment metrics */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["VaultGroupTimeseriesResponse"];
+                };
+            };
+            /** @description Missing or invalid auth */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Vault slug not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Invalid parameters */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Data source or vault curation unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+}
+//# sourceMappingURL=generated.d.ts.map