@aegis-engine/core 0.13.0 → 0.14.0

package/dist/contract/generated/aegis-swap.d.ts

@@ -100,6 +100,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/markets/{marketId}/tvl-history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read bounded observed core-principal TVL history
+         * @description Reads one existing historical-records item. Only qualified ReservesLens TVL observations are served; legacy rows without observation provenance are counted separately; invalid qualified frames and duplicate buckets create gaps. Values retain their original token-config valuation and custom-accounting limitation; they are not repriced, complete hook assets, OHLC or personal earnings. The rolling window is at most 60 days with twelve-hour buckets. The current bucket is included only if observed. A smaller limit returns the latest points with truncated=true; missing buckets refer to the full requested window. Malformed records and database/deadline failures return 503, not empty history. No RPC or write occurs.
+         */
+        get: operations["getPoolTvlHistory"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/engine/markets/{marketId}/history": {
         parameters: {
             query?: never;
@@ -329,7 +349,7 @@ export interface paths {
         };
         /**
          * List open and closed Engine position identities for history
-         * @description A bounded catalog retaining zero-balance lender rows and burned vaults, independent of current portfolio discovery. A lending position is closed when its indexed share balance is zero; a vault is closed only when burned. By default vaults belong to the current or last indexed owner. ownerScope=ever-owned also includes transferred-away vaults through indexed registry transfers and requires the ownership schema. No ownership epochs, valuation, PnL or wallet cash-flow claims. Ordering is vaults first, then lending, with lexical source IDs within each family. Cursors bind account, chain, limit, ownerScope, server-configured deployment and exact indexed block for ten minutes; continuation never refreshes to a newer head. All payloads and metadata are hash-pinned. This is indexer evidence, not RPC canonicality or finality. At most 50 positions, three Graph queries, a shared five-second deadline and 1 MiB upstream-response budget. More positions produce explicit partial coverage and a cursor; missing or malformed indexer data is unavailable, not an empty catalog. No history table, wallet RPC or price access. All responses are private/no-store.
+         * @description A bounded catalog retaining zero-balance lender rows and burned vaults, independent of current portfolio discovery. A lending position is closed when its indexed share balance is zero; a vault is closed only when burned. By default vaults belong to the current or last indexed owner. ownerScope=ever-owned also includes transferred-away vaults through indexed registry transfers and requires the ownership schema. No ownership epochs, valuation, PnL or wallet cash-flow claims. Ordering is vaults first, then lending, with lexical source IDs within each family. Select an alternate deployment by its hook; omitted hook selects the canonical deployment. Cursors bind account, chain, limit, ownerScope, selected deployment and exact indexed block for ten minutes; continuation never refreshes to a newer head. All payloads and metadata are hash-pinned. This is indexer evidence, not RPC canonicality or finality. At most 50 positions, three Graph queries, a shared five-second deadline and 1 MiB upstream-response budget. More positions produce explicit partial coverage and a cursor; missing or malformed indexer data is unavailable, not an empty catalog. No history table, wallet RPC or price access. All responses are private/no-store.
          */
         get: operations["listEngineHistoryPositions"];
         put?: never;
@@ -389,7 +409,7 @@ export interface paths {
         };
         /**
          * Discover owned Engine positions in one indexed block frame
-         * @description Hash-pinned discovery of borrow vaults and lender shares, including hidden or unknown markets. Raw indexed amounts are not live valuation or a canonicality/finality verdict. Verify the frame hash against RPC before hydration. Coverage reports rejected malformed rows; a successful empty result is distinct from an unavailable read. Each request has a five-second deadline, a 1,000 evaluated-row cap and a 2 MiB upstream-response budget. Wallet responses are private/no-store. Rows are under coverage.positions only for complete accounts, otherwise coverage.partialPositions. Follow coverage.nextCursor for truncated reads; resumed pages remain partial and retain the original frame. Legacy positions v1/v2 schemas are unchanged.
+         * @description Hash-pinned discovery of borrow vaults and lender shares, including hidden or unknown markets. Select an alternate deployment by its hook; omitted hook selects the canonical deployment. Raw indexed amounts are not live valuation or a canonicality/finality verdict. Verify the frame hash against RPC before hydration. Coverage reports rejected malformed rows; a successful empty result is distinct from an unavailable read. Each request has a five-second deadline, a 1,000 evaluated-row cap and a 2 MiB upstream-response budget. Wallet responses are private/no-store. Rows are under coverage.positions only for complete accounts, otherwise coverage.partialPositions. Follow coverage.nextCursor for truncated reads; resumed pages remain partial and retain the original frame. Legacy positions v1/v2 schemas are unchanged.
          */
         get: operations["discoverEngineAccount"];
         put?: never;
@@ -966,6 +986,54 @@ export interface components {
                     feesUsd: number;
                 }[];
             };
+            /** @description Optional current pool principal composition, excluding fees. Absent for older producers; null with observations.composition.reason when the stored snapshot is unusable. A stale last-good snapshot retains its original state time; use observations.composition.stale, which is also true when the block state time is more than 15 minutes old. */
+            composition?: {
+                /** @enum {number} */
+                schemaVersion: 1;
+                /** @enum {string} */
+                source: "uniswap-v4-reserves-lens";
+                /** @enum {string} */
+                definition: "v4_core_pool_fee_excluded";
+                chainId: number;
+                poolId: string;
+                token0: {
+                    address: string;
+                    decimals: number;
+                    /** @description Exact unsigned principal amount in token base units; excludes fees. */
+                    amountRaw: string;
+                };
+                token1: {
+                    address: string;
+                    decimals: number;
+                    /** @description Exact unsigned principal amount in token base units; excludes fees. */
+                    amountRaw: string;
+                };
+                /** @description Prices used by the producer for this TVL, not independently qualified historical marks. */
+                valuation: {
+                    /** @enum {string} */
+                    source: "token-config";
+                    token0PriceUsd: number;
+                    token1PriceUsd: number;
+                    tvlUsd: number;
+                };
+                /** @description State was read at a block number; the observed header is not proof of canonical state or finality. */
+                observation: {
+                    /** Format: date-time */
+                    observedAt: string;
+                    /** @description Exact RPC block number as a canonical decimal string. */
+                    blockNumber: string;
+                    blockTimestamp: number;
+                    observedHeaderHash: string | null;
+                    /** @enum {string} */
+                    blockReference: "number";
+                    /** @enum {string} */
+                    headerStateConsistency: "unchecked";
+                    /** @enum {string} */
+                    finality: "unconfirmed";
+                };
+                /** @description Custom-accounting limitation; independent of token-price confidence. */
+                approximate: boolean;
+            } | null;
         };
         MarketV2: {
             id: string;
@@ -1048,14 +1116,76 @@ export interface components {
                         feesUsd: number;
                     }[];
                 };
+                /** @description Optional current pool principal composition, excluding fees. Absent for older producers; null with observations.composition.reason when the stored snapshot is unusable. A stale last-good snapshot retains its original state time; use observations.composition.stale, which is also true when the block state time is more than 15 minutes old. */
+                composition?: {
+                    /** @enum {number} */
+                    schemaVersion: 1;
+                    /** @enum {string} */
+                    source: "uniswap-v4-reserves-lens";
+                    /** @enum {string} */
+                    definition: "v4_core_pool_fee_excluded";
+                    chainId: number;
+                    poolId: string;
+                    token0: {
+                        address: string;
+                        decimals: number;
+                        /** @description Exact unsigned principal amount in token base units; excludes fees. */
+                        amountRaw: string;
+                    };
+                    token1: {
+                        address: string;
+                        decimals: number;
+                        /** @description Exact unsigned principal amount in token base units; excludes fees. */
+                        amountRaw: string;
+                    };
+                    /** @description Prices used by the producer for this TVL, not independently qualified historical marks. */
+                    valuation: {
+                        /** @enum {string} */
+                        source: "token-config";
+                        token0PriceUsd: number;
+                        token1PriceUsd: number;
+                        tvlUsd: number;
+                    };
+                    /** @description State was read at a block number; the observed header is not proof of canonical state or finality. */
+                    observation: {
+                        /** Format: date-time */
+                        observedAt: string;
+                        /** @description Exact RPC block number as a canonical decimal string. */
+                        blockNumber: string;
+                        blockTimestamp: number;
+                        observedHeaderHash: string | null;
+                        /** @enum {string} */
+                        blockReference: "number";
+                        /** @enum {string} */
+                        headerStateConsistency: "unchecked";
+                        /** @enum {string} */
+                        finality: "unconfirmed";
+                    };
+                    /** @description Custom-accounting limitation; independent of token-price confidence. */
+                    approximate: boolean;
+                } | null;
             };
             warnings: ("paused" | "surge-active" | "cap-event" | "swap-unavailable")[];
             observations?: {
                 tvl: {
-                    /** Format: date-time */
+                    /**
+                     * Format: date-time
+                     * @description Qualified Lens state block time; legacy rows without block time retain their recorded observation time. Null when unknown or invalid.
+                     */
                     updatedAt: string | null;
                     stale: boolean;
                 };
+                composition?: {
+                    /**
+                     * Format: date-time
+                     * @description Normalized blockTimestamp state time; the snapshot observedAt is the separate fetch receipt.
+                     */
+                    updatedAt: string | null;
+                    /** @description True when the producer flagged the paired TVL stale, or when the block state time is more than 15 minutes older than the API read time. A stale snapshot keeps its values and state time. */
+                    stale: boolean;
+                    /** @enum {string} */
+                    reason?: "invalid-composition" | "inconsistent-composition" | "tvl-unavailable";
+                };
             };
         };
         MarketListV2: {
@@ -1139,16 +1269,131 @@ export interface components {
                         feesUsd: number;
                     }[];
                 };
+                /** @description Optional current pool principal composition, excluding fees. Absent for older producers; null with observations.composition.reason when the stored snapshot is unusable. A stale last-good snapshot retains its original state time; use observations.composition.stale, which is also true when the block state time is more than 15 minutes old. */
+                composition?: {
+                    /** @enum {number} */
+                    schemaVersion: 1;
+                    /** @enum {string} */
+                    source: "uniswap-v4-reserves-lens";
+                    /** @enum {string} */
+                    definition: "v4_core_pool_fee_excluded";
+                    chainId: number;
+                    poolId: string;
+                    token0: {
+                        address: string;
+                        decimals: number;
+                        /** @description Exact unsigned principal amount in token base units; excludes fees. */
+                        amountRaw: string;
+                    };
+                    token1: {
+                        address: string;
+                        decimals: number;
+                        /** @description Exact unsigned principal amount in token base units; excludes fees. */
+                        amountRaw: string;
+                    };
+                    /** @description Prices used by the producer for this TVL, not independently qualified historical marks. */
+                    valuation: {
+                        /** @enum {string} */
+                        source: "token-config";
+                        token0PriceUsd: number;
+                        token1PriceUsd: number;
+                        tvlUsd: number;
+                    };
+                    /** @description State was read at a block number; the observed header is not proof of canonical state or finality. */
+                    observation: {
+                        /** Format: date-time */
+                        observedAt: string;
+                        /** @description Exact RPC block number as a canonical decimal string. */
+                        blockNumber: string;
+                        blockTimestamp: number;
+                        observedHeaderHash: string | null;
+                        /** @enum {string} */
+                        blockReference: "number";
+                        /** @enum {string} */
+                        headerStateConsistency: "unchecked";
+                        /** @enum {string} */
+                        finality: "unconfirmed";
+                    };
+                    /** @description Custom-accounting limitation; independent of token-price confidence. */
+                    approximate: boolean;
+                } | null;
             };
             warnings: ("paused" | "surge-active" | "cap-event" | "swap-unavailable")[];
             observations?: {
                 tvl: {
-                    /** Format: date-time */
+                    /**
+                     * Format: date-time
+                     * @description Qualified Lens state block time; legacy rows without block time retain their recorded observation time. Null when unknown or invalid.
+                     */
                     updatedAt: string | null;
                     stale: boolean;
                 };
+                composition?: {
+                    /**
+                     * Format: date-time
+                     * @description Normalized blockTimestamp state time; the snapshot observedAt is the separate fetch receipt.
+                     */
+                    updatedAt: string | null;
+                    /** @description True when the producer flagged the paired TVL stale, or when the block state time is more than 15 minutes older than the API read time. A stale snapshot keeps its values and state time. */
+                    stale: boolean;
+                    /** @enum {string} */
+                    reason?: "invalid-composition" | "inconsistent-composition" | "tvl-unavailable";
+                };
             };
         }[];
+        PoolTvlHistoryResponse: {
+            /** @enum {string} */
+            schemaVersion: "1";
+            marketId: string;
+            /** @enum {string} */
+            resolution: "12h";
+            /** @enum {string} */
+            window: "7d" | "30d" | "60d";
+            /** @enum {string} */
+            status: "ready" | "partial" | "no_data";
+            pointCount: number;
+            points: {
+                t: number;
+                tvlUsd: number;
+                observation: {
+                    /** @enum {number} */
+                    policyVersion: 1;
+                    /** @enum {string} */
+                    source: "uniswap-v4-reserves-lens";
+                    /** @enum {string} */
+                    definition: "v4_core_pool_fee_excluded";
+                    /** Format: date-time */
+                    observedAt: string;
+                    blockNumber: string;
+                    blockTimestamp: number;
+                    approximate: boolean;
+                    /** @enum {string} */
+                    priceSource: "token-config";
+                };
+            }[];
+            /** Format: date-time */
+            updatedAt: string | null;
+            coverage: {
+                requestedFrom: number;
+                requestedTo: number;
+                fromBucket: number;
+                throughBucket: number;
+                expectedBucketCount: number;
+                firstObservedBucket: number | null;
+                lastObservedBucket: number | null;
+                presentBucketCount: number;
+                missingBuckets: number[];
+                invalidPointCount: number;
+                legacyPointCount: number;
+                truncated: boolean;
+            };
+        };
+        PoolTvlHistoryReadFailure: {
+            /** @enum {string} */
+            error: "Pool TVL history temporarily unavailable";
+            /** @enum {string} */
+            code: "tvl-history-read-timeout" | "tvl-history-read-unavailable" | "tvl-history-invalid-record" | "tvl-history-budget-exceeded";
+        };
         EngineToken: {
             /**
              * @example 4663
@@ -7337,6 +7582,44 @@ export interface operations {
             500: components["responses"]["ServerError"];
         };
     };
+    getPoolTvlHistory: {
+        parameters: {
+            query?: {
+                window?: "7d" | "30d" | "60d";
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                /** @description Exact case-sensitive historical record ID from market discovery; no case normalization. */
+                marketId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Observed TVL with actual coverage and gaps */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PoolTvlHistoryResponse"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            /** @description Bounded history read unavailable */
+            503: {
+                headers: {
+                    "Retry-After"?: "5";
+                    "Cache-Control"?: "no-store";
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PoolTvlHistoryReadFailure"];
+                };
+            };
+        };
+    };
     getEngineMarketHistory: {
         parameters: {
             query?: {
@@ -7816,9 +8099,11 @@ export interface operations {
                  * @example 0x8a5c4fa037a583b057be7a46e7e94ec496702f25
                  */
                 account: components["parameters"]["AccountQuery"];
+                /** @description Aegis hook selecting an Engine deployment. Omit for the canonical deployment. */
+                hook?: string;
                 limit?: number;
                 ownerScope?: "current-or-last" | "ever-owned";
-                /** @description Opaque continuation returned by this catalog; preserve account, chainId, limit and ownerScope. */
+                /** @description Opaque continuation returned by this catalog; preserve account, chainId, hook, limit and ownerScope. */
                 cursor?: string;
             };
             header?: never;
@@ -7871,6 +8156,8 @@ export interface operations {
                 chainId: "1" | "56" | "130" | "8453" | "4663" | "57073";
                 account: string;
                 poolId: string;
+                /** @description Aegis hook selecting an Engine deployment. Omit for the canonical deployment. */
+                hook?: string;
                 kind: "lend_shares" | "borrow_vault";
                 /** @description Required only for borrow_vault. */
                 vaultId?: string;
@@ -7944,6 +8231,8 @@ export interface operations {
                  */
                 account: components["parameters"]["AccountQuery"];
                 poolId: string;
+                /** @description Aegis hook selecting an Engine deployment. Omit for the canonical deployment. */
+                hook?: string;
                 kind: "lend_shares" | "borrow_vault";
                 /** @description Required only for borrow_vault. */
                 vaultId?: string;
@@ -7991,6 +8280,8 @@ export interface operations {
                  * @example 0x8a5c4fa037a583b057be7a46e7e94ec496702f25
                  */
                 account: components["parameters"]["AccountQuery"];
+                /** @description Aegis hook selecting an Engine deployment. Omit for the canonical deployment. */
+                hook?: string;
                 /** @description Opaque page selector from coverage.nextCursor. Bound to wallet, chain, deployment and indexed frame. */
                 cursor?: string;
             };
@@ -8062,6 +8353,8 @@ export interface operations {
                  * @example 8453,4663
                  */
                 chainIds: string;
+                /** @description Select an alternate Engine deployment by hook. Requires a single chain; omitted for canonical deployment. */
+                hook?: string;
                 limit?: number;
                 /** @description Opaque continuation; reuse the original account, chains and limit. */
                 cursor?: string;
@@ -8120,6 +8413,8 @@ export interface operations {
                 account: components["parameters"]["AccountQuery"];
                 /** @description Portfolio chain set including the transaction chain. Defaults to only the transaction chain. */
                 chainIds?: string;
+                /** @description Select an Engine deployment by hook. Requires a single-chain portfolio; omitted for the canonical deployment. */
+                hook?: string;
                 /** @description Previously observed receipt block; provide together with observedBlockHash. */
                 observedBlockNumber?: string;
                 observedBlockHash?: string;
@@ -8188,6 +8483,8 @@ export interface operations {
                  * @example 0x8a5c4fa037a583b057be7a46e7e94ec496702f25
                  */
                 account: components["parameters"]["AccountQuery"];
+                /** @description Select an Engine deployment by hook; omitted for the canonical deployment. */
+                hook?: string;
             };
             header?: never;
             path: {
@@ -8253,6 +8550,8 @@ export interface operations {
                 kind: "borrow_vault";
                 vaultId: string;
                 snapshotId: string;
+                /** @description Use the same deployment hook as the accounting snapshot; omitted for the canonical deployment. */
+                hook?: string;
             };
             header?: never;
             path?: never;
@@ -8324,6 +8623,8 @@ export interface operations {
                 kind: "borrow_vault";
                 vaultId: string;
                 snapshotId: string;
+                /** @description Use the same deployment hook as the accounting and portfolio snapshots; omitted for the canonical deployment. */
+                hook?: string;
                 /** @description Required for open positions; capture portfolio before accounting. */
                 portfolioSnapshotId?: string;
             };
@@ -8393,6 +8694,8 @@ export interface operations {
                  * @example 8453,4663
                  */
                 chainIds: string;
+                /** @description Select an Engine deployment by hook. Requires one chain; omitted for the canonical deployment. */
+                hook?: string;
             };
             header?: never;
             path?: never;
@@ -8451,6 +8754,8 @@ export interface operations {
                  * @example 8453,4663
                  */
                 chainIds: string;
+                /** @description Select an Engine deployment by hook. Requires one chain; omitted for the canonical deployment. */
+                hook?: string;
                 snapshotId: string;
                 /** @description Opaque continuation bound to the snapshot and page limit. */
                 cursor?: string;