@aegis-engine/core 0.11.0 → 0.13.0

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

@@ -47,7 +47,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List curated tokens for a chain */
+        /**
+         * List curated tokens for a chain
+         * @description Returns curated token metadata, including priceUsd, for the chain. Responses are shared-cacheable for 60 seconds with a 60-second stale-while-revalidate window, so priceUsd can lag the price writer by about two minutes.
+         */
         get: operations["listTokens"];
         put?: never;
         post?: never;
@@ -66,7 +69,7 @@ export interface paths {
         };
         /**
          * List curated tokens by address
-         * @description Filters curated token metadata to the requested comma-separated EVM token addresses. Matching is case-insensitive and unknown addresses are omitted.
+         * @description Filters curated token metadata to the requested comma-separated EVM token addresses. Matching is case-insensitive and unknown addresses are omitted. Responses are shared-cacheable for 60 seconds with a 60-second stale-while-revalidate window, so priceUsd can lag the price writer by about two minutes.
          */
         get: operations["listTokensByAddress"];
         put?: never;
@@ -166,7 +169,7 @@ export interface paths {
         };
         /**
          * Get pool candles or a labelled token reference line
-         * @description Returns processor-owned Uniswap v4 pair candles for 1d, 7d, 30d, 90d, or 180d. The 1d window uses exact five-minute Swap-event candles. The 7d window uses copied Uniswap PoolHourData; 30d, 90d, and 180d use copied PoolDayData. Prices remain canonical token1 per token0 (quote_per_base). Exact five-minute rows expose swapCount and first/last swap provenance. Upstream aggregate rows expose txCount under its real meaning and may include volumeUSD, feesUSD, and tvlUSD. Dense five-minute coverage reports missing stored buckets as indexing gaps. Sparse upstream series treat absent keys as quiet intervals; malformed stored rows are dropped and reported as invalid_row gaps. Metadata absence returns 404. HTTP 200 and metadata-absent 404 responses are shared-cacheable for 30 seconds. This display series is not an execution quote or transaction input. The Lambda does not call a subgraph or RPC. basis=token_market_reference explicitly selects a display-only line of matching TokenHourData or TokenDayData close ratios for 7d/30d/90d/180d. The reference has no 1d/5m series, no pair OHLC, and no automatic fallback. Component close trades need not be simultaneous. Historical venue independence is unknown and must not be presented as independent fair value.
+         * @description Returns processor-owned Uniswap v4 pair candles for 1d, 7d, 30d, 90d, or 180d. The 1d window uses exact five-minute Swap-event candles. By default, the 7d window uses copied Uniswap PoolHourData; 30d, 90d, and 180d use copied PoolDayData. aggregation=exact_swaps explicitly selects qualified dense PoolManager RPC rollups for those longer windows, retaining swapCount and first/last swap provenance with no copied USD fields. Without that parameter, longer RPC rollups are unavailable to preserve existing client validators. A requested representation that is not stored returns 404 before reading buckets, with no automatic source substitution. Prices remain canonical token1 per token0 (quote_per_base). Exact five-minute rows expose swapCount and first/last swap provenance. Upstream aggregate rows expose txCount under its real meaning and may include volumeUSD, feesUSD, and tvlUSD. Dense exact-swap coverage reports missing stored buckets as indexing gaps. Sparse upstream series treat absent keys as quiet intervals; malformed stored rows are dropped and reported as invalid_row gaps. Metadata or requested-representation absence returns 404. HTTP 200 and metadata-absent 404 responses are shared-cacheable for 30 seconds. This display series is not an execution quote or transaction input. The Lambda does not call a subgraph or RPC. basis=token_market_reference explicitly selects a display-only line of matching TokenHourData or TokenDayData close ratios for 7d/30d/90d/180d. The reference has no 1d/5m series, no pair OHLC, and no automatic fallback. Component close trades need not be simultaneous. Historical venue independence is unknown and must not be presented as independent fair value.
          */
         get: operations["getEngineMarketCandles"];
         put?: never;
@@ -206,7 +209,7 @@ export interface paths {
         };
         /**
          * List curated Aegis v4 pools with explicit metric availability
-         * @description Opt-in market reads for all curated-data chains. Unavailable or unproven metrics are null; measured zero remains zero. TVL availability is independent of rolling history. A retained Lens TVL marked stale keeps its last value; observations.tvl reports its source time (null when unknown) and the recorded stale flag (any recorded value other than false is stale), not an age-based freshness verdict. observations is optional and additive: clients must tolerate its absence. Fee APR and indexed history require explicit v4HistoryAvailable=true or, when the flag is absent, v4-subgraph provenance. Ink volume can independently use qualified first-party PoolManager RPC volume (producer policy version 1, window end at most three hours old); its USD valuation is an estimate, unqualified values remain null, and it does not enable fee APR. Frozen /v1/markets serves the same qualified Ink volume, else 0. Data-only chains return disabled swap status and swap-unavailable; this route does not enable quoting or execution. Swap status requires a visible, unpaused market; on Ink it also requires a positive recorded uint128 V4 liquidity snapshot. feeApr7d is annualized percentage points and dynamic-fee APR is an estimate, not realized LP earnings. Existing core clients must continue using /v1/markets until they support this nullable contract.
+         * @description Opt-in market reads for all curated-data chains. Unavailable or unproven metrics are null; measured zero remains zero. TVL availability is independent of rolling history. A retained Lens TVL marked stale keeps its last value; observations.tvl reports its source time (null when unknown) and the recorded stale flag (any recorded value other than false is stale), not an age-based freshness verdict. observations is optional and additive: clients must tolerate its absence. Indexed fee APR and history require explicit v4HistoryAvailable=true or, when the flag is absent, v4-subgraph provenance. Ink volume can independently use qualified first-party PoolManager RPC volume (producer policy version 1, window end at most three hours old); its USD valuation is an estimate, unqualified values remain null, and it does not enable fee APR. Optional metrics.flowHistory adds processor-recorded Uniswap LiquidityService analytics on Ink: policyVersion 1, matching chain/pool identity, seven complete UTC daily volumeUsd/feesUsd points and their sums, windowStart/windowEnd/resolution in Unix seconds, and asOf as provider fetch time (not an indexed head or canonicality proof). The current completed seven-day window ending at today UTC midnight and fetched within three hours is admitted; before 00:30 UTC, the immediately previous window is also admitted with its actual dates unchanged and the same fetch-age limit. Malformed, stale or incomplete history is omitted without hiding TVL. This adds no polling. Charts use flowHistory.volumeUsd and its daily points. Both market versions retain rolling 168h indexed/RPC volumeUsd7d; daily history never overrides a rolling positive, zero or unavailable value (0 in frozen v1, null in v2). Fees are provider USD estimates, not verified LP earnings. Without indexed history, feeApr7d may derive from flowHistory; see metrics.feeApr7dSource. Provider flow history is v2-only. Data-only chains return disabled swap status and swap-unavailable; this route does not enable quoting or execution. Swap status requires a visible, unpaused market; on Ink it also requires a positive recorded uint128 V4 liquidity snapshot. feeApr7d is annualized percentage points and dynamic-fee APR is an estimate, not realized LP earnings. Existing core clients must continue using /v1/markets until they support this nullable contract.
          */
         get: operations["listMarketsV2"];
         put?: never;
@@ -912,7 +915,57 @@ export interface components {
         MarketMetricsV2: {
             tvlUsd: number | null;
             volumeUsd7d: number | null;
+            /** @description Annualized percentage points (12.3 means 12.3%). From indexed history when available; otherwise derived from flowHistory (see feeApr7dSource). An estimate, not realized LP earnings. Null when unavailable; measured zero stays zero. */
             feeApr7d: number | null;
+            /**
+             * @description Present only when feeApr7d is derived from flowHistory: its feesUsd over windowStart..windowEnd annualized over non-stale, dated Lens TVL, in percentage points: feesUsd / 7 * 365 / tvlUsd * 100. Gross pool fees (including any protocol share) over current TVL, so a pool whose TVL changed during the window can be skewed. Absent, with feeApr7d null, for stale, undated, future-dated, unavailable or zero TVL, or a rate above 1000 (withheld as implausible); also absent when feeApr7d comes from indexed history.
+             * @enum {string}
+             */
+            feeApr7dSource?: "flow-history";
+            /** @description Optional Ink daily volume and fee history from Uniswap provider analytics over the last seven completed UTC days. Omitted when unavailable, stale, malformed or incomplete. Provider estimates; does not affect volumeUsd7d. Without indexed history, its feesUsd derives feeApr7d (see feeApr7dSource). */
+            flowHistory?: {
+                /**
+                 * @description Ink chain ID.
+                 * @enum {number}
+                 */
+                chainId: 57073;
+                /** @description Uniswap v4 pool ID (bytes32 PoolKey hash). */
+                poolId: string;
+                /**
+                 * @description Uniswap LiquidityService pool history, recorded by the processor.
+                 * @enum {string}
+                 */
+                source: "uniswap-liquidity-service";
+                /**
+                 * @description Producer policy version; consumers gate on this value.
+                 * @enum {number}
+                 */
+                policyVersion: 1;
+                /** @description Unix seconds when the processor fetched the provider. A fetch time, not an indexed chain head or completeness proof; admitted for at most three hours. */
+                asOf: number;
+                /** @description Inclusive window start in Unix seconds (UTC midnight), windowEnd minus seven days. */
+                windowStart: number;
+                /** @description Exclusive window end in Unix seconds: the UTC midnight ending the last completed day. Today is excluded. The current window is admitted, plus the previous one before 00:30 UTC. */
+                windowEnd: number;
+                /**
+                 * @description Seconds per daily point (86400).
+                 * @enum {number}
+                 */
+                resolution: 86400;
+                /** @description Sum of the seven daily volumeUsd points. Uniswap provider estimate of swap volume in USD (historical analytics valuation). Separate from the rolling 168-hour volumeUsd7d. */
+                volumeUsd: number;
+                /** @description Sum of the seven daily feesUsd points. Uniswap provider estimate of swap fees in USD, including any protocol share; not LP fees, wallet earnings or APR. */
+                feesUsd: number;
+                /** @description Seven contiguous completed UTC days, oldest first, from windowStart. */
+                daily: {
+                    /** @description UTC midnight starting this day, in Unix seconds. */
+                    timestamp: number;
+                    /** @description Uniswap provider estimate of swap volume in USD (historical analytics valuation). */
+                    volumeUsd: number;
+                    /** @description Uniswap provider estimate of swap fees in USD, including any protocol share; not LP fees, wallet earnings or APR. */
+                    feesUsd: number;
+                }[];
+            };
         };
         MarketV2: {
             id: string;
@@ -944,7 +997,57 @@ export interface components {
             metrics: {
                 tvlUsd: number | null;
                 volumeUsd7d: number | null;
+                /** @description Annualized percentage points (12.3 means 12.3%). From indexed history when available; otherwise derived from flowHistory (see feeApr7dSource). An estimate, not realized LP earnings. Null when unavailable; measured zero stays zero. */
                 feeApr7d: number | null;
+                /**
+                 * @description Present only when feeApr7d is derived from flowHistory: its feesUsd over windowStart..windowEnd annualized over non-stale, dated Lens TVL, in percentage points: feesUsd / 7 * 365 / tvlUsd * 100. Gross pool fees (including any protocol share) over current TVL, so a pool whose TVL changed during the window can be skewed. Absent, with feeApr7d null, for stale, undated, future-dated, unavailable or zero TVL, or a rate above 1000 (withheld as implausible); also absent when feeApr7d comes from indexed history.
+                 * @enum {string}
+                 */
+                feeApr7dSource?: "flow-history";
+                /** @description Optional Ink daily volume and fee history from Uniswap provider analytics over the last seven completed UTC days. Omitted when unavailable, stale, malformed or incomplete. Provider estimates; does not affect volumeUsd7d. Without indexed history, its feesUsd derives feeApr7d (see feeApr7dSource). */
+                flowHistory?: {
+                    /**
+                     * @description Ink chain ID.
+                     * @enum {number}
+                     */
+                    chainId: 57073;
+                    /** @description Uniswap v4 pool ID (bytes32 PoolKey hash). */
+                    poolId: string;
+                    /**
+                     * @description Uniswap LiquidityService pool history, recorded by the processor.
+                     * @enum {string}
+                     */
+                    source: "uniswap-liquidity-service";
+                    /**
+                     * @description Producer policy version; consumers gate on this value.
+                     * @enum {number}
+                     */
+                    policyVersion: 1;
+                    /** @description Unix seconds when the processor fetched the provider. A fetch time, not an indexed chain head or completeness proof; admitted for at most three hours. */
+                    asOf: number;
+                    /** @description Inclusive window start in Unix seconds (UTC midnight), windowEnd minus seven days. */
+                    windowStart: number;
+                    /** @description Exclusive window end in Unix seconds: the UTC midnight ending the last completed day. Today is excluded. The current window is admitted, plus the previous one before 00:30 UTC. */
+                    windowEnd: number;
+                    /**
+                     * @description Seconds per daily point (86400).
+                     * @enum {number}
+                     */
+                    resolution: 86400;
+                    /** @description Sum of the seven daily volumeUsd points. Uniswap provider estimate of swap volume in USD (historical analytics valuation). Separate from the rolling 168-hour volumeUsd7d. */
+                    volumeUsd: number;
+                    /** @description Sum of the seven daily feesUsd points. Uniswap provider estimate of swap fees in USD, including any protocol share; not LP fees, wallet earnings or APR. */
+                    feesUsd: number;
+                    /** @description Seven contiguous completed UTC days, oldest first, from windowStart. */
+                    daily: {
+                        /** @description UTC midnight starting this day, in Unix seconds. */
+                        timestamp: number;
+                        /** @description Uniswap provider estimate of swap volume in USD (historical analytics valuation). */
+                        volumeUsd: number;
+                        /** @description Uniswap provider estimate of swap fees in USD, including any protocol share; not LP fees, wallet earnings or APR. */
+                        feesUsd: number;
+                    }[];
+                };
             };
             warnings: ("paused" | "surge-active" | "cap-event" | "swap-unavailable")[];
             observations?: {
@@ -985,7 +1088,57 @@ export interface components {
             metrics: {
                 tvlUsd: number | null;
                 volumeUsd7d: number | null;
+                /** @description Annualized percentage points (12.3 means 12.3%). From indexed history when available; otherwise derived from flowHistory (see feeApr7dSource). An estimate, not realized LP earnings. Null when unavailable; measured zero stays zero. */
                 feeApr7d: number | null;
+                /**
+                 * @description Present only when feeApr7d is derived from flowHistory: its feesUsd over windowStart..windowEnd annualized over non-stale, dated Lens TVL, in percentage points: feesUsd / 7 * 365 / tvlUsd * 100. Gross pool fees (including any protocol share) over current TVL, so a pool whose TVL changed during the window can be skewed. Absent, with feeApr7d null, for stale, undated, future-dated, unavailable or zero TVL, or a rate above 1000 (withheld as implausible); also absent when feeApr7d comes from indexed history.
+                 * @enum {string}
+                 */
+                feeApr7dSource?: "flow-history";
+                /** @description Optional Ink daily volume and fee history from Uniswap provider analytics over the last seven completed UTC days. Omitted when unavailable, stale, malformed or incomplete. Provider estimates; does not affect volumeUsd7d. Without indexed history, its feesUsd derives feeApr7d (see feeApr7dSource). */
+                flowHistory?: {
+                    /**
+                     * @description Ink chain ID.
+                     * @enum {number}
+                     */
+                    chainId: 57073;
+                    /** @description Uniswap v4 pool ID (bytes32 PoolKey hash). */
+                    poolId: string;
+                    /**
+                     * @description Uniswap LiquidityService pool history, recorded by the processor.
+                     * @enum {string}
+                     */
+                    source: "uniswap-liquidity-service";
+                    /**
+                     * @description Producer policy version; consumers gate on this value.
+                     * @enum {number}
+                     */
+                    policyVersion: 1;
+                    /** @description Unix seconds when the processor fetched the provider. A fetch time, not an indexed chain head or completeness proof; admitted for at most three hours. */
+                    asOf: number;
+                    /** @description Inclusive window start in Unix seconds (UTC midnight), windowEnd minus seven days. */
+                    windowStart: number;
+                    /** @description Exclusive window end in Unix seconds: the UTC midnight ending the last completed day. Today is excluded. The current window is admitted, plus the previous one before 00:30 UTC. */
+                    windowEnd: number;
+                    /**
+                     * @description Seconds per daily point (86400).
+                     * @enum {number}
+                     */
+                    resolution: 86400;
+                    /** @description Sum of the seven daily volumeUsd points. Uniswap provider estimate of swap volume in USD (historical analytics valuation). Separate from the rolling 168-hour volumeUsd7d. */
+                    volumeUsd: number;
+                    /** @description Sum of the seven daily feesUsd points. Uniswap provider estimate of swap fees in USD, including any protocol share; not LP fees, wallet earnings or APR. */
+                    feesUsd: number;
+                    /** @description Seven contiguous completed UTC days, oldest first, from windowStart. */
+                    daily: {
+                        /** @description UTC midnight starting this day, in Unix seconds. */
+                        timestamp: number;
+                        /** @description Uniswap provider estimate of swap volume in USD (historical analytics valuation). */
+                        volumeUsd: number;
+                        /** @description Uniswap provider estimate of swap fees in USD, including any protocol share; not LP fees, wallet earnings or APR. */
+                        feesUsd: number;
+                    }[];
+                };
             };
             warnings: ("paused" | "surge-active" | "cap-event" | "swap-unavailable")[];
             observations?: {
@@ -7098,6 +7251,7 @@ export interface operations {
             /** @description Curated token metadata */
             200: {
                 headers: {
+                    "Cache-Control"?: "public, max-age=60, stale-while-revalidate=60";
                     [name: string]: unknown;
                 };
                 content: {
@@ -7132,6 +7286,7 @@ export interface operations {
             /** @description Curated token metadata */
             200: {
                 headers: {
+                    "Cache-Control"?: "public, max-age=60, stale-while-revalidate=60";
                     [name: string]: unknown;
                 };
                 content: {
@@ -7294,6 +7449,8 @@ export interface operations {
                 window?: components["parameters"]["EngineCandleWindowQuery"];
                 /** @description pool is the default. token_market_reference selects a display-only line of matching hourly/daily token USD close ratios for 7d/30d/90d/180d; 1d is unsupported. No automatic fallback. */
                 basis?: components["parameters"]["EngineCandleBasisQuery"];
+                /** @description Opt into exact swap candles. For 7d/30d/90d/180d, requires qualified dense pool_manager_rpc rollups; absent keeps copied Uniswap semantics. Existing exact 1d/5m remains unchanged. Incompatible with token_market_reference. Never synthesizes OHLC for quiet buckets. */
+                aggregation?: "exact_swaps";
                 /** @description price_line opts into a versioned envelope with the unchanged history response and verified price-hold segments. Only pool/1d is supported. No value is inferred before a retained close or verified pool-state checkpoint; seed lookback is bounded to one additional day. */
                 format?: "candles" | "price_line";
             };
@@ -7711,7 +7868,7 @@ export interface operations {
     getEnginePositionAccounting: {
         parameters: {
             query: {
-                chainId: "1" | "56" | "130" | "8453" | "4663";
+                chainId: "1" | "56" | "130" | "8453" | "4663" | "57073";
                 account: string;
                 poolId: string;
                 kind: "lend_shares" | "borrow_vault";
@@ -7901,7 +8058,7 @@ export interface operations {
                  */
                 account: components["parameters"]["AccountQuery"];
                 /**
-                 * @description One to five distinct supported chains; order is normalized.
+                 * @description One to six distinct supported chains, including Ink (57073); order is normalized.
                  * @example 8453,4663
                  */
                 chainIds: string;
@@ -7969,7 +8126,7 @@ export interface operations {
             };
             header?: never;
             path: {
-                chainId: 1 | 56 | 130 | 8453 | 4663;
+                chainId: 1 | 56 | 130 | 8453 | 4663 | 57073;
                 txHash: string;
             };
             cookie?: never;
@@ -8034,7 +8191,7 @@ export interface operations {
             };
             header?: never;
             path: {
-                chainId: 1 | 56 | 130 | 8453 | 4663;
+                chainId: 1 | 56 | 130 | 8453 | 4663 | 57073;
                 txHash: string;
             };
             cookie?: never;
@@ -8232,7 +8389,7 @@ export interface operations {
                  */
                 account: components["parameters"]["AccountQuery"];
                 /**
-                 * @description One to five distinct supported chains, comma separated: 1,56,130,8453,4663. Order is normalized.
+                 * @description One to six distinct supported chains, comma separated: 1,56,130,8453,4663,57073. Order is normalized.
                  * @example 8453,4663
                  */
                 chainIds: string;
@@ -8290,7 +8447,7 @@ export interface operations {
                  */
                 account: components["parameters"]["AccountQuery"];
                 /**
-                 * @description One to five distinct supported chains, comma separated: 1,56,130,8453,4663. Order is normalized.
+                 * @description One to six distinct supported chains, comma separated: 1,56,130,8453,4663,57073. Order is normalized.
                  * @example 8453,4663
                  */
                 chainIds: string;