@aegis-engine/core 0.6.0 → 0.8.0

package/dist/engine/rateHistorySchemas.d.ts

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+export declare const RateHistoryPointSchema: z.ZodObject<{
+    t: z.ZodNumber;
+    observedAt: z.ZodString;
+    evmBlockNumber: z.ZodNumber;
+    borrowAprPct: z.ZodNullable<z.ZodNumber>;
+    lendAprPct: z.ZodNullable<z.ZodNumber>;
+    lendingRateBasis: z.ZodLiteral<"simple-borrow-interest-apr">;
+    utilizationPct: z.ZodNullable<z.ZodNumber>;
+    ratePerSecondWad: z.ZodNullable<z.ZodString>;
+    fullUtilizationRate: z.ZodNullable<z.ZodString>;
+    sharePriceWad: z.ZodNullable<z.ZodString>;
+    rateObservation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"verified">;
+        basis: z.ZodLiteral<"irm-accrual-preview">;
+        rpcBlockNumber: z.ZodNumber;
+        blockHash: z.ZodString;
+        observedAt: z.ZodString;
+        elapsedSeconds: z.ZodString;
+        canonicality: z.ZodLiteral<"rpc-checked-at-read">;
+        finality: z.ZodLiteral<"not-a-finality-verdict">;
+    }, z.core.$strict>, z.ZodObject<{
+        status: z.ZodLiteral<"unavailable">;
+        reason: z.ZodEnum<{
+            "legacy-unpinned": "legacy-unpinned";
+            "invalid-provenance": "invalid-provenance";
+        }>;
+    }, z.core.$strict>], "status">;
+}, z.core.$strict>;
+export declare const RateHistoryResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1">;
+    marketId: z.ZodString;
+    resolution: z.ZodLiteral<"12h">;
+    window: z.ZodEnum<{
+        "7d": "7d";
+        "30d": "30d";
+        "60d": "60d";
+    }>;
+    status: z.ZodEnum<{
+        ready: "ready";
+        warming_up: "warming_up";
+        no_data: "no_data";
+        partial: "partial";
+    }>;
+    pointCount: z.ZodNumber;
+    points: z.ZodArray<z.ZodObject<{
+        t: z.ZodNumber;
+        observedAt: z.ZodString;
+        evmBlockNumber: z.ZodNumber;
+        borrowAprPct: z.ZodNullable<z.ZodNumber>;
+        lendAprPct: z.ZodNullable<z.ZodNumber>;
+        lendingRateBasis: z.ZodLiteral<"simple-borrow-interest-apr">;
+        utilizationPct: z.ZodNullable<z.ZodNumber>;
+        ratePerSecondWad: z.ZodNullable<z.ZodString>;
+        fullUtilizationRate: z.ZodNullable<z.ZodString>;
+        sharePriceWad: z.ZodNullable<z.ZodString>;
+        rateObservation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"verified">;
+            basis: z.ZodLiteral<"irm-accrual-preview">;
+            rpcBlockNumber: z.ZodNumber;
+            blockHash: z.ZodString;
+            observedAt: z.ZodString;
+            elapsedSeconds: z.ZodString;
+            canonicality: z.ZodLiteral<"rpc-checked-at-read">;
+            finality: z.ZodLiteral<"not-a-finality-verdict">;
+        }, z.core.$strict>, z.ZodObject<{
+            status: z.ZodLiteral<"unavailable">;
+            reason: z.ZodEnum<{
+                "legacy-unpinned": "legacy-unpinned";
+                "invalid-provenance": "invalid-provenance";
+            }>;
+        }, z.core.$strict>], "status">;
+    }, z.core.$strict>>;
+    updatedAt: z.ZodNullable<z.ZodString>;
+    coverage: z.ZodObject<{
+        fromBucket: z.ZodNumber;
+        throughClosedBucket: z.ZodNumber;
+        expectedClosedBuckets: z.ZodNumber;
+        firstObservedBucket: z.ZodNullable<z.ZodNumber>;
+        leadingMissingBucketCount: z.ZodNumber;
+        presentClosedBuckets: z.ZodNumber;
+        missingBuckets: z.ZodArray<z.ZodNumber>;
+        missingRateBuckets: z.ZodArray<z.ZodNumber>;
+        verifiedRatePoints: z.ZodNumber;
+        legacyRatePoints: z.ZodNumber;
+        invalidRows: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;

package/dist/engine/reads.d.ts

@@ -1,4 +1,4 @@
-import type { Address } from 'viem';
+import { type Address } from 'viem';
 import { UserFacingError } from '../errors.js';
 import type { AegisEngineBorrowQuoteContext, AegisEngineMarket, AegisEngineMarketMark, AegisEngineMarketReadInput, AegisEngineMarketSnapshot, AegisEnginePositionsHydration, AegisEnginePositionsHydrationInput, AegisEngineVaultActivityEntry } from './types.js';
 export declare class AegisEngineMarketNotReadyError extends UserFacingError {

package/dist/engine/registry.d.ts

@@ -1,4 +1,4 @@
-import type { Address } from 'viem';
+import { type Address } from 'viem';
 import type { AegisEngineVersion } from './types.js';
 /** Engine hard utilization cap as a percentage of supplied liquidity.
  *  Mirrors the SDK's UTILIZATION_CAP_PIPS (950_000/1_000_000), inlined so

package/dist/engine/restSchemas.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+export declare const engineAdaptiveTickThresholdModeSchema: z.ZodLiteral<"post_swap_surge_trigger">;
 export declare const enginePoolIdSchema: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
 export declare const engineMarketsRestResponseSchema: z.ZodObject<{
     schemaVersion: z.ZodLiteral<"1">;
@@ -9,8 +10,21 @@ export declare const engineMarketsRestResponseSchema: z.ZodObject<{
         updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
         blockNumber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         marketCount: z.ZodNumber;
-    }, z.core.$strip>;
+    }, z.core.$strict>;
 }, z.core.$strip>;
+/** Opt-in market envelope from GET /v1/engine/markets/v2. Market rows are
+ * validated by marketAdapter because static and REST rows share normalization. */
+export declare const engineMarketsV2RestResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"2">;
+    chainId: z.ZodNumber;
+    markets: z.ZodArray<z.ZodUnknown>;
+    freshness: z.ZodObject<{
+        source: z.ZodLiteral<"canopy">;
+        updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        blockNumber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        marketCount: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
 export declare const engineMarketIdSchema: z.ZodString;
 export declare const engineMetricHistoryRestResponseSchema: z.ZodObject<{
     marketId: z.ZodString;
@@ -52,6 +66,50 @@ export declare const engineMetricHistoryRestResponseSchema: z.ZodObject<{
     }, z.core.$strict>>;
     updatedAt: z.ZodNullable<z.ZodISODateTime>;
 }, z.core.$strict>;
+export declare const engineMetricHistoryV2RestResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"2">;
+    marketId: z.ZodString;
+    resolution: z.ZodLiteral<"12h">;
+    window: z.ZodEnum<{
+        "7d": "7d";
+        "30d": "30d";
+        "60d": "60d";
+    }>;
+    status: z.ZodEnum<{
+        ready: "ready";
+        warming_up: "warming_up";
+        no_data: "no_data";
+    }>;
+    pointCount: z.ZodNumber;
+    points: z.ZodArray<z.ZodObject<{
+        t: z.ZodNumber;
+        observedAt: z.ZodISODateTime;
+        blockNumber: z.ZodNumber;
+        utilizationPct: z.ZodNullable<z.ZodNumber>;
+        borrowAprPct: z.ZodNullable<z.ZodNumber>;
+        lendApyPct: z.ZodNullable<z.ZodNumber>;
+        ratePerSecondWad: z.ZodNullable<z.ZodString>;
+        rateSource: z.ZodNullable<z.ZodString>;
+        fullUtilizationRate: z.ZodNullable<z.ZodString>;
+        sharePriceWad: z.ZodNullable<z.ZodString>;
+        suppliedUsd: z.ZodNullable<z.ZodNumber>;
+        borrowedUsd: z.ZodNullable<z.ZodNumber>;
+        availableToBorrowUsd: z.ZodNullable<z.ZodNumber>;
+        baseFeePpm: z.ZodNullable<z.ZodNumber>;
+        activeFeePpm: z.ZodNullable<z.ZodNumber>;
+        surgeFeePpm: z.ZodNullable<z.ZodNumber>;
+        feeSource: z.ZodNullable<z.ZodString>;
+        surgeActive: z.ZodNullable<z.ZodBoolean>;
+        inCapEvent: z.ZodNullable<z.ZodBoolean>;
+        manualOverride: z.ZodNullable<z.ZodBoolean>;
+        perSwapMode: z.ZodNullable<z.ZodBoolean>;
+        warnings: z.ZodArray<z.ZodString>;
+        adaptiveTickThresholdTicks: z.ZodNullable<z.ZodNumber>;
+        adaptiveTickThresholdMode: z.ZodNullable<z.ZodLiteral<"post_swap_surge_trigger">>;
+        feeObservedAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strict>>;
+    updatedAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strict>;
 export declare const enginePositionsRestResponseSchema: z.ZodObject<{
     schemaVersion: z.ZodLiteral<"1">;
     chainId: z.ZodNumber;

package/dist/engine/tradeExecutionSession.d.ts

@@ -0,0 +1,155 @@
+import type { Address, Hex, PublicClient } from 'viem';
+import type { AegisSwapChainConfig } from '../config/index.js';
+import { type ClassifiedError } from '../errors.js';
+import { type AegisTransactionObservation } from '../swap/receiptWait.js';
+import { type Eip1193Provider } from '../wallet.js';
+import type { AegisEngineApprovalInput, AegisEngineAuthorizationPlan, AegisEngineAuthorizationStepKind, AegisEngineMarket, AegisEngineToken, AegisEngineTradeDirection, AegisEngineTradeOpenQuote, AegisEngineTransactionResult } from './types.js';
+export type AegisEngineTradeOpenIntent = Readonly<{
+    owner: Address;
+    market: AegisEngineMarket;
+    direction: AegisEngineTradeDirection;
+    token: AegisEngineToken;
+    amount: bigint;
+    leverage?: number;
+    horizonSeconds: number;
+    priceMove: number;
+    slippageBps: number;
+    maxPriceImpactBps: number;
+    approvalMode: 'exact' | 'max';
+}>;
+export type AegisEngineTradeExecutionStepStatus = 'planned' | 'wallet-requested' | 'submitted' | 'confirmed' | 'failed' | 'cancelled';
+export type AegisEngineTradeExecutionStep = Readonly<{
+    kind: AegisEngineAuthorizationStepKind;
+    status: AegisEngineTradeExecutionStepStatus;
+    hash: Hex | null;
+}>;
+export type AegisEngineTradeExecutionFailure = ClassifiedError & Readonly<{
+    step: AegisEngineAuthorizationStepKind | null;
+    hash: Hex | null;
+    /**
+     * Last execution boundary observed before this failure.
+     *
+     * `submission` means the wallet transaction request started but returned no
+     * hash. It does not claim that signing completed or that the transaction
+     * reached the network. Optional only so existing v1 consumers that
+     * construct failure fixtures remain source-compatible; sessions created by
+     * this version always publish it.
+     */
+    failurePhase?: 'preparation' | 'wallet-request' | 'submission' | 'confirmation';
+}>;
+export type AegisEngineTradeExecutionRecovery = Readonly<{
+    kind: 'retry-wallet';
+}> | Readonly<{
+    kind: 'switch-network';
+    chainId: number;
+}> | Readonly<{
+    kind: 'review-quote';
+}> | Readonly<{
+    kind: 'view-transaction';
+    hash: Hex;
+}> | Readonly<{
+    kind: 'resume-remaining';
+}> | Readonly<{
+    kind: 'none';
+}>;
+export type AegisEngineAuthorizationReviewReason = Readonly<{
+    kind: 'intent-changed';
+}> | Readonly<{
+    kind: 'wallet-chain-switch-added';
+}> | Readonly<{
+    kind: 'permission-added' | 'permission-changed' | 'unexpected-wallet-request';
+    step: AegisEngineAuthorizationStepKind;
+}>;
+export type AegisEngineTradeQuoteReviewReason = Readonly<{
+    kind: 'intent-changed';
+}> | Readonly<{
+    kind: 'position-availability-changed' | 'swap-route-changed' | 'minimum-output-lower' | 'price-impact-higher' | 'displayed-leverage-changed' | 'opening-ltv-higher' | 'interest-higher' | 'target-return-lower' | 'borrow-limit-lower' | 'liquidation-threshold-lower' | 'utilization-worse-or-missing' | 'runway-shorter' | 'adaptive-fee-evidence-unavailable' | 'adaptive-fee-mode-changed' | 'adaptive-manual-override-changed' | 'adaptive-threshold-lower' | 'adaptive-surge-entered' | 'active-fee-higher';
+}>;
+export type AegisEngineTradeExecutionReview = Readonly<{
+    kind: 'permissions';
+    revision: number;
+    reasons: readonly AegisEngineAuthorizationReviewReason[];
+}> | Readonly<{
+    kind: 'quote';
+    revision: number;
+    reasons: readonly AegisEngineTradeQuoteReviewReason[];
+}>;
+export type AegisEngineTradeExecutionPhase = 'ready' | 'executing' | 'quote-review-required' | 'awaiting-receipt' | 'resume-required' | 'success' | 'failed' | 'cancelled';
+export type AegisEngineTradeExecutionNext = Readonly<{
+    kind: 'continue';
+}> | Readonly<{
+    kind: 'accept-review';
+    revision: number;
+}> | Readonly<{
+    kind: 'check-receipt';
+    hash: Hex;
+}> | Readonly<{
+    kind: 'cancel';
+}> | Readonly<{
+    kind: 'none';
+}>;
+export type AegisEngineTradeExecutionSnapshot = Readonly<{
+    schemaVersion: '1';
+    kind: 'engine-trade-open-execution';
+    sessionId: string;
+    sequence: number;
+    occurredAt: string;
+    chainId: number;
+    quoteRevision: number;
+    phase: AegisEngineTradeExecutionPhase;
+    plan: AegisEngineAuthorizationPlan;
+    quote: AegisEngineTradeOpenQuote;
+    review: AegisEngineTradeExecutionReview | null;
+    next: AegisEngineTradeExecutionNext;
+    steps: readonly AegisEngineTradeExecutionStep[];
+    currentStep: AegisEngineTradeExecutionStep | null;
+    completedPermissions: readonly AegisEngineAuthorizationStepKind[];
+    completedTransactions: readonly Readonly<{
+        kind: AegisEngineAuthorizationStepKind;
+        hash: Hex;
+    }>[];
+    transactionHash: Hex | null;
+    receiptSummary?: AegisEngineTransactionResult['summary'];
+    quoteReviewRequired: boolean;
+    failure: AegisEngineTradeExecutionFailure | null;
+    recovery: AegisEngineTradeExecutionRecovery;
+}>;
+export type AegisEngineTradeExecutionCommand = Readonly<{
+    kind: 'continue';
+}> | Readonly<{
+    kind: 'accept-review';
+    revision: number;
+}> | Readonly<{
+    kind: 'check-receipt';
+}> | Readonly<{
+    kind: 'cancel';
+}>;
+export type AegisEngineTradeOpenExecutionSession = Readonly<{
+    getSnapshot: () => AegisEngineTradeExecutionSnapshot;
+    subscribe: (listener: () => void) => () => void;
+    dispatch: (command: AegisEngineTradeExecutionCommand, options?: Readonly<{
+        signal?: AbortSignal;
+    }>) => Promise<AegisEngineTradeExecutionSnapshot>;
+}>;
+export type AegisEngineTradeOpenExecutionSessionOptions = Readonly<{
+    wallet: Readonly<{
+        provider: Eip1193Provider;
+        account: Address;
+    }>;
+    publicClient: PublicClient;
+    activeChain: AegisSwapChainConfig;
+    intent: AegisEngineTradeOpenIntent;
+    reviewed: Readonly<{
+        plan: AegisEngineAuthorizationPlan;
+        quote: AegisEngineTradeOpenQuote;
+    }>;
+    onTransactionObservation?: (event: AegisTransactionObservation, stage: 'authorization' | 'action') => void;
+    onAuthorizationExecution?: AegisEngineApprovalInput['onAuthorizationExecution'];
+    sessionId?: string;
+    onChange?: (snapshot: AegisEngineTradeExecutionSnapshot) => void;
+}>;
+/** Pure review policy for newly introduced or materially changed wallet authority. */
+export declare function engineAuthorizationPlanReviewReasons(reviewed: AegisEngineAuthorizationPlan, fresh: AegisEngineAuthorizationPlan): readonly AegisEngineAuthorizationReviewReason[];
+/** Pure zero-tolerance policy for weaker or materially different quote facts. */
+export declare function engineTradeQuoteReviewReasons(reviewed: AegisEngineTradeOpenQuote, fresh: AegisEngineTradeOpenQuote): readonly AegisEngineTradeQuoteReviewReason[];
+export declare function createEngineTradeOpenExecutionSession(options: AegisEngineTradeOpenExecutionSessionOptions): AegisEngineTradeOpenExecutionSession;