@aegis-engine/core 0.3.1 → 0.5.0

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

@@ -263,6 +263,16 @@ export interface components {
          * @enum {string}
          */
         ChainIdQuery: "1" | "130" | "8453";
+        /**
+         * @example 4663
+         * @enum {string}
+         */
+        EngineChainIdQuery: "1" | "130" | "4663" | "8453";
+        /**
+         * @example 4663
+         * @enum {string}
+         */
+        DataChainIdQuery: "1" | "130" | "8453" | "4663";
         HealthResponse: {
             /** @enum {boolean} */
             ok: true;
@@ -406,10 +416,10 @@ export interface components {
         Token: {
             id: string;
             /**
-             * @example 130
+             * @example 4663
              * @enum {integer}
              */
-            chainId: 1 | 130 | 8453;
+            chainId: 1 | 130 | 8453 | 4663;
             address: string;
             symbol: string;
             displayName: string;
@@ -422,10 +432,10 @@ export interface components {
         TokenList: {
             id: string;
             /**
-             * @example 130
+             * @example 4663
              * @enum {integer}
              */
-            chainId: 1 | 130 | 8453;
+            chainId: 1 | 130 | 8453 | 4663;
             address: string;
             symbol: string;
             displayName: string;
@@ -521,10 +531,10 @@ export interface components {
         }[];
         EngineToken: {
             /**
-             * @example 130
+             * @example 4663
              * @enum {integer}
              */
-            chainId: 1 | 130 | 8453;
+            chainId: 1 | 130 | 4663 | 8453;
             address: string;
             symbol: string;
             name: string;
@@ -619,10 +629,10 @@ export interface components {
         EngineMarket: {
             id: string;
             /**
-             * @example 130
+             * @example 4663
              * @enum {integer}
              */
-            chainId: 1 | 130 | 8453;
+            chainId: 1 | 130 | 4663 | 8453;
             /** @enum {string} */
             source: "rest";
             /** @enum {string} */
@@ -632,10 +642,10 @@ export interface components {
             poolId: string;
             token0: {
                 /**
-                 * @example 130
+                 * @example 4663
                  * @enum {integer}
                  */
-                chainId: 1 | 130 | 8453;
+                chainId: 1 | 130 | 4663 | 8453;
                 address: string;
                 symbol: string;
                 name: string;
@@ -646,10 +656,10 @@ export interface components {
             };
             token1: {
                 /**
-                 * @example 130
+                 * @example 4663
                  * @enum {integer}
                  */
-                chainId: 1 | 130 | 8453;
+                chainId: 1 | 130 | 4663 | 8453;
                 address: string;
                 symbol: string;
                 name: string;
@@ -782,17 +792,17 @@ export interface components {
             /** @enum {string} */
             schemaVersion: "1";
             /**
-             * @example 130
+             * @example 4663
              * @enum {integer}
              */
-            chainId: 1 | 130 | 8453;
+            chainId: 1 | 130 | 4663 | 8453;
             markets: {
                 id: string;
                 /**
-                 * @example 130
+                 * @example 4663
                  * @enum {integer}
                  */
-                chainId: 1 | 130 | 8453;
+                chainId: 1 | 130 | 4663 | 8453;
                 /** @enum {string} */
                 source: "rest";
                 /** @enum {string} */
@@ -802,10 +812,10 @@ export interface components {
                 poolId: string;
                 token0: {
                     /**
-                     * @example 130
+                     * @example 4663
                      * @enum {integer}
                      */
-                    chainId: 1 | 130 | 8453;
+                    chainId: 1 | 130 | 4663 | 8453;
                     address: string;
                     symbol: string;
                     name: string;
@@ -816,10 +826,10 @@ export interface components {
                 };
                 token1: {
                     /**
-                     * @example 130
+                     * @example 4663
                      * @enum {integer}
                      */
-                    chainId: 1 | 130 | 8453;
+                    chainId: 1 | 130 | 4663 | 8453;
                     address: string;
                     symbol: string;
                     name: string;
@@ -981,10 +991,10 @@ export interface components {
         EnginePosition: {
             id: string;
             /**
-             * @example 130
+             * @example 4663
              * @enum {integer}
              */
-            chainId: 1 | 130 | 8453;
+            chainId: 1 | 130 | 4663 | 8453;
             account: string;
             vaultId: string;
             /** @enum {string} */
@@ -995,10 +1005,10 @@ export interface components {
             poolId: string;
             token0?: {
                 /**
-                 * @example 130
+                 * @example 4663
                  * @enum {integer}
                  */
-                chainId: 1 | 130 | 8453;
+                chainId: 1 | 130 | 4663 | 8453;
                 address: string;
                 symbol: string;
                 name: string;
@@ -1009,10 +1019,10 @@ export interface components {
             } | null;
             token1?: {
                 /**
-                 * @example 130
+                 * @example 4663
                  * @enum {integer}
                  */
-                chainId: 1 | 130 | 8453;
+                chainId: 1 | 130 | 4663 | 8453;
                 address: string;
                 symbol: string;
                 name: string;
@@ -1076,10 +1086,10 @@ export interface components {
         EngineBorrowVaultPositionV2: {
             id: string;
             /**
-             * @example 130
+             * @example 4663
              * @enum {integer}
              */
-            chainId: 1 | 130 | 8453;
+            chainId: 1 | 130 | 4663 | 8453;
             account: string;
             vaultId: string;
             /** @enum {string} */
@@ -1090,10 +1100,10 @@ export interface components {
             poolId: string;
             token0?: {
                 /**
-                 * @example 130
+                 * @example 4663
                  * @enum {integer}
                  */
-                chainId: 1 | 130 | 8453;
+                chainId: 1 | 130 | 4663 | 8453;
                 address: string;
                 symbol: string;
                 name: string;
@@ -1104,10 +1114,10 @@ export interface components {
             } | null;
             token1?: {
                 /**
-                 * @example 130
+                 * @example 4663
                  * @enum {integer}
                  */
-                chainId: 1 | 130 | 8453;
+                chainId: 1 | 130 | 4663 | 8453;
                 address: string;
                 symbol: string;
                 name: string;
@@ -1176,10 +1186,10 @@ export interface components {
             /** @example engine-lend:1:0x… */
             id: string;
             /**
-             * @example 130
+             * @example 4663
              * @enum {integer}
              */
-            chainId: 1 | 130 | 8453;
+            chainId: 1 | 130 | 4663 | 8453;
             account: string;
             marketId: string | null;
             marketName: string | null;
@@ -1187,10 +1197,10 @@ export interface components {
             poolId: string;
             token0: {
                 /**
-                 * @example 130
+                 * @example 4663
                  * @enum {integer}
                  */
-                chainId: 1 | 130 | 8453;
+                chainId: 1 | 130 | 4663 | 8453;
                 address: string;
                 symbol: string;
                 name: string;
@@ -1201,10 +1211,10 @@ export interface components {
             } | null;
             token1: {
                 /**
-                 * @example 130
+                 * @example 4663
                  * @enum {integer}
                  */
-                chainId: 1 | 130 | 8453;
+                chainId: 1 | 130 | 4663 | 8453;
                 address: string;
                 symbol: string;
                 name: string;
@@ -1226,10 +1236,10 @@ export interface components {
         EnginePositionV2: {
             id: string;
             /**
-             * @example 130
+             * @example 4663
              * @enum {integer}
              */
-            chainId: 1 | 130 | 8453;
+            chainId: 1 | 130 | 4663 | 8453;
             account: string;
             vaultId: string;
             /** @enum {string} */
@@ -1240,10 +1250,10 @@ export interface components {
             poolId: string;
             token0?: {
                 /**
-                 * @example 130
+                 * @example 4663
                  * @enum {integer}
                  */
-                chainId: 1 | 130 | 8453;
+                chainId: 1 | 130 | 4663 | 8453;
                 address: string;
                 symbol: string;
                 name: string;
@@ -1254,10 +1264,10 @@ export interface components {
             } | null;
             token1?: {
                 /**
-                 * @example 130
+                 * @example 4663
                  * @enum {integer}
                  */
-                chainId: 1 | 130 | 8453;
+                chainId: 1 | 130 | 4663 | 8453;
                 address: string;
                 symbol: string;
                 name: string;
@@ -1325,10 +1335,10 @@ export interface components {
             /** @example engine-lend:1:0x… */
             id: string;
             /**
-             * @example 130
+             * @example 4663
              * @enum {integer}
              */
-            chainId: 1 | 130 | 8453;
+            chainId: 1 | 130 | 4663 | 8453;
             account: string;
             marketId: string | null;
             marketName: string | null;
@@ -1336,10 +1346,10 @@ export interface components {
             poolId: string;
             token0: {
                 /**
-                 * @example 130
+                 * @example 4663
                  * @enum {integer}
                  */
-                chainId: 1 | 130 | 8453;
+                chainId: 1 | 130 | 4663 | 8453;
                 address: string;
                 symbol: string;
                 name: string;
@@ -1350,10 +1360,10 @@ export interface components {
             } | null;
             token1: {
                 /**
-                 * @example 130
+                 * @example 4663
                  * @enum {integer}
                  */
-                chainId: 1 | 130 | 8453;
+                chainId: 1 | 130 | 4663 | 8453;
                 address: string;
                 symbol: string;
                 name: string;
@@ -1376,18 +1386,18 @@ export interface components {
             /** @enum {string} */
             schemaVersion: "1";
             /**
-             * @example 130
+             * @example 4663
              * @enum {integer}
              */
-            chainId: 1 | 130 | 8453;
+            chainId: 1 | 130 | 4663 | 8453;
             account: string;
             positions: {
                 id: string;
                 /**
-                 * @example 130
+                 * @example 4663
                  * @enum {integer}
                  */
-                chainId: 1 | 130 | 8453;
+                chainId: 1 | 130 | 4663 | 8453;
                 account: string;
                 vaultId: string;
                 /** @enum {string} */
@@ -1398,10 +1408,10 @@ export interface components {
                 poolId: string;
                 token0?: {
                     /**
-                     * @example 130
+                     * @example 4663
                      * @enum {integer}
                      */
-                    chainId: 1 | 130 | 8453;
+                    chainId: 1 | 130 | 4663 | 8453;
                     address: string;
                     symbol: string;
                     name: string;
@@ -1412,10 +1422,10 @@ export interface components {
                 } | null;
                 token1?: {
                     /**
-                     * @example 130
+                     * @example 4663
                      * @enum {integer}
                      */
-                    chainId: 1 | 130 | 8453;
+                    chainId: 1 | 130 | 4663 | 8453;
                     address: string;
                     symbol: string;
                     name: string;
@@ -1492,18 +1502,18 @@ export interface components {
             /** @enum {string} */
             schemaVersion: "2";
             /**
-             * @example 130
+             * @example 4663
              * @enum {integer}
              */
-            chainId: 1 | 130 | 8453;
+            chainId: 1 | 130 | 4663 | 8453;
             account: string;
             positions: ({
                 id: string;
                 /**
-                 * @example 130
+                 * @example 4663
                  * @enum {integer}
                  */
-                chainId: 1 | 130 | 8453;
+                chainId: 1 | 130 | 4663 | 8453;
                 account: string;
                 vaultId: string;
                 /** @enum {string} */
@@ -1514,10 +1524,10 @@ export interface components {
                 poolId: string;
                 token0?: {
                     /**
-                     * @example 130
+                     * @example 4663
                      * @enum {integer}
                      */
-                    chainId: 1 | 130 | 8453;
+                    chainId: 1 | 130 | 4663 | 8453;
                     address: string;
                     symbol: string;
                     name: string;
@@ -1528,10 +1538,10 @@ export interface components {
                 } | null;
                 token1?: {
                     /**
-                     * @example 130
+                     * @example 4663
                      * @enum {integer}
                      */
-                    chainId: 1 | 130 | 8453;
+                    chainId: 1 | 130 | 4663 | 8453;
                     address: string;
                     symbol: string;
                     name: string;
@@ -1599,10 +1609,10 @@ export interface components {
                 /** @example engine-lend:1:0x… */
                 id: string;
                 /**
-                 * @example 130
+                 * @example 4663
                  * @enum {integer}
                  */
-                chainId: 1 | 130 | 8453;
+                chainId: 1 | 130 | 4663 | 8453;
                 account: string;
                 marketId: string | null;
                 marketName: string | null;
@@ -1610,10 +1620,10 @@ export interface components {
                 poolId: string;
                 token0: {
                     /**
-                     * @example 130
+                     * @example 4663
                      * @enum {integer}
                      */
-                    chainId: 1 | 130 | 8453;
+                    chainId: 1 | 130 | 4663 | 8453;
                     address: string;
                     symbol: string;
                     name: string;
@@ -1624,10 +1634,10 @@ export interface components {
                 } | null;
                 token1: {
                     /**
-                     * @example 130
+                     * @example 4663
                      * @enum {integer}
                      */
-                    chainId: 1 | 130 | 8453;
+                    chainId: 1 | 130 | 4663 | 8453;
                     address: string;
                     symbol: string;
                     name: string;
@@ -2242,10 +2252,10 @@ export interface components {
             /** @enum {string} */
             schemaVersion: "1";
             /**
-             * @example 130
+             * @example 4663
              * @enum {integer}
              */
-            chainId: 1 | 130 | 8453;
+            chainId: 1 | 130 | 4663 | 8453;
             account: string;
             marketState: {
                 marketId: string | null;
@@ -2874,6 +2884,16 @@ export interface components {
          * @example 130
          */
         ChainIdQuery: components["schemas"]["ChainIdQuery"];
+        /**
+         * @description Engine/data chain ID as a string query parameter. JSON response bodies use numeric chainId values.
+         * @example 4663
+         */
+        EngineChainIdQuery: components["schemas"]["EngineChainIdQuery"];
+        /**
+         * @description Curated-data chain ID as a string query parameter. JSON response bodies use numeric chainId values.
+         * @example 4663
+         */
+        DataChainIdQuery: components["schemas"]["DataChainIdQuery"];
         /**
          * @description Comma-separated EVM token addresses.
          * @example 0x078d782b760474a361dda0af3839290b0ef57ad6,0x83f31af747189c2fa9e5deb253200c505eff6ed2
@@ -2969,10 +2989,10 @@ export interface operations {
         parameters: {
             query: {
                 /**
-                 * @description EVM chain ID as a string query parameter. JSON response bodies use numeric chainId values.
-                 * @example 130
+                 * @description Curated-data chain ID as a string query parameter. JSON response bodies use numeric chainId values.
+                 * @example 4663
                  */
-                chainId: components["parameters"]["ChainIdQuery"];
+                chainId: components["parameters"]["DataChainIdQuery"];
             };
             header?: never;
             path?: never;
@@ -2997,10 +3017,10 @@ export interface operations {
         parameters: {
             query: {
                 /**
-                 * @description EVM chain ID as a string query parameter. JSON response bodies use numeric chainId values.
-                 * @example 130
+                 * @description Curated-data chain ID as a string query parameter. JSON response bodies use numeric chainId values.
+                 * @example 4663
                  */
-                chainId: components["parameters"]["ChainIdQuery"];
+                chainId: components["parameters"]["DataChainIdQuery"];
                 /**
                  * @description Comma-separated EVM token addresses.
                  * @example 0x078d782b760474a361dda0af3839290b0ef57ad6,0x83f31af747189c2fa9e5deb253200c505eff6ed2
@@ -3131,10 +3151,10 @@ export interface operations {
         parameters: {
             query: {
                 /**
-                 * @description EVM chain ID as a string query parameter. JSON response bodies use numeric chainId values.
-                 * @example 130
+                 * @description Engine/data chain ID as a string query parameter. JSON response bodies use numeric chainId values.
+                 * @example 4663
                  */
-                chainId: components["parameters"]["ChainIdQuery"];
+                chainId: components["parameters"]["EngineChainIdQuery"];
             };
             header?: never;
             path?: never;
@@ -3159,10 +3179,10 @@ export interface operations {
         parameters: {
             query: {
                 /**
-                 * @description EVM chain ID as a string query parameter. JSON response bodies use numeric chainId values.
-                 * @example 130
+                 * @description Engine/data chain ID as a string query parameter. JSON response bodies use numeric chainId values.
+                 * @example 4663
                  */
-                chainId: components["parameters"]["ChainIdQuery"];
+                chainId: components["parameters"]["EngineChainIdQuery"];
                 /**
                  * @description Wallet address whose Engine positions should be returned.
                  * @example 0x8a5c4fa037a583b057be7a46e7e94ec496702f25
@@ -3192,10 +3212,10 @@ export interface operations {
         parameters: {
             query: {
                 /**
-                 * @description EVM chain ID as a string query parameter. JSON response bodies use numeric chainId values.
-                 * @example 130
+                 * @description Engine/data chain ID as a string query parameter. JSON response bodies use numeric chainId values.
+                 * @example 4663
                  */
-                chainId: components["parameters"]["ChainIdQuery"];
+                chainId: components["parameters"]["EngineChainIdQuery"];
                 /**
                  * @description Wallet address whose Engine positions should be returned.
                  * @example 0x8a5c4fa037a583b057be7a46e7e94ec496702f25
@@ -3225,10 +3245,10 @@ export interface operations {
         parameters: {
             query: {
                 /**
-                 * @description EVM chain ID as a string query parameter. JSON response bodies use numeric chainId values.
-                 * @example 130
+                 * @description Engine/data chain ID as a string query parameter. JSON response bodies use numeric chainId values.
+                 * @example 4663
                  */
-                chainId: components["parameters"]["ChainIdQuery"];
+                chainId: components["parameters"]["EngineChainIdQuery"];
                 /**
                  * @description Wallet address whose Engine activity ledger should be returned — every vault and lend action the account has made, including burned vaults and fully withdrawn lend positions.
                  * @example 0x8a5c4fa037a583b057be7a46e7e94ec496702f25

package/dist/engine/actions.d.ts

@@ -1,5 +1,24 @@
 import { type Address, type Hex } from 'viem';
-import type { AegisEngineActionCallbacks, AegisEngineApprovalInput, AegisEngineMarket, AegisEnginePositionTarget, AegisEngineSendInput, AegisEngineSignedPermitBatch, AegisEngineTransactionResult } from './types.js';
+import { readPermit2RouterAllowance } from '../permit.js';
+import type { AegisEngineActionCallbacks, AegisEngineApprovalInput, AegisEngineAuthorizationPlan, AegisEngineAuthorizationPlanInput, AegisEngineMarket, AegisEnginePositionTarget, AegisEngineSendInput, AegisEngineSignedPermitBatch, AegisEngineTransactionResult } from './types.js';
+/**
+ * Mode-aware satisfaction for the ERC-20 → Permit2 grant. `exact` asks
+ * whether the current draft is covered; `max` asks whether the standing
+ * allowance is effectively unlimited — the check the "No limit" toggle
+ * reports, so it must not pass on a merely amount-covering grant.
+ */
+export declare function engineTokenGrantSatisfies(args: {
+    currentAmount: bigint;
+    spendAmount: bigint;
+    approvalMode: 'exact' | 'max';
+}): boolean;
+/** Mode-aware satisfaction for the Permit2 → router cap. `max` requires an
+ *  effectively unlimited amount that is also not about to expire. */
+export declare function enginePermit2GrantSatisfies(args: {
+    allowance: Awaited<ReturnType<typeof readPermit2RouterAllowance>>;
+    spendAmount: bigint;
+    approvalMode: 'exact' | 'max';
+}): boolean;
 export type AegisEnginePositionRouterAuthorizationInput = {
     wallet: AegisEngineSendInput['wallet'];
     publicClient: AegisEngineSendInput['publicClient'];
@@ -8,9 +27,35 @@ export type AegisEnginePositionRouterAuthorizationInput = {
     target: AegisEnginePositionTarget;
     /** Exact ERC-6909 share allowance required for a lender-position action. */
     amount?: bigint;
+    /** Cancels preparation before the authorization transaction is broadcast. */
+    signal?: AegisEngineSendInput['signal'];
     onStatus?: AegisEngineActionCallbacks['onStatus'];
     onTxHash?: AegisEngineActionCallbacks['onTxHash'];
 };
+/**
+ * Read the wallet actions required to open a fresh Long/Short position.
+ *
+ * Trade-open only. The plan always includes blanket vault-operator
+ * (`isApprovedForAll`, no `vaultId`) plus the final open. ERC-20→Permit2 and
+ * Permit2→router appear only for non-native collateral. This is not a borrow,
+ * lend-deposit, or lend-redeem plan: those operations have different
+ * on-chain gates and must not reuse this result.
+ *
+ * Amount 0 is a glance read: Access and already-granted token allowances are
+ * still reported. Exact-mode amount-sized grants are omitted until the deposit
+ * is known — never invented as a 0 exact allowance.
+ *
+ * Presentation-safe planning, not authorization evidence for a send.
+ * The submit boundary must still re-read every permission and obtain a fresh
+ * executable quote after prerequisite receipts are mined.
+ */
+export declare function readEngineAuthorizationPlan(args: AegisEngineAuthorizationPlanInput): Promise<AegisEngineAuthorizationPlan>;
+/** Grants only the ERC-20 allowance from the token to Permit2. */
+export declare function approveEngineTokenToPermit2(args: AegisEngineApprovalInput): Promise<{
+    approvalHash: Hex | null;
+}>;
+/** Grants only the Permit2 spending cap from Permit2 to the Engine router. */
+export declare function approveEnginePermit2ToRouter(args: AegisEngineApprovalInput): Promise<void>;
 export declare function prepareEnginePermit(args: AegisEngineApprovalInput): Promise<{
     approvalHash: Hex | null;
     permit: AegisEngineSignedPermitBatch | null;

package/dist/engine/activityLotDisplay.d.ts

@@ -0,0 +1,8 @@
+import type { AegisEngineActivityLotDisplay, AegisEngineActivityMarketState, AegisEnginePositionActivitySnapshot, AegisEnginePositionVaultActivity } from './types.js';
+/** Indexed lot facts from the account activity ledger already loaded for
+ *  Long/Short identity. Interest uses the market's last-step borrow index,
+ *  not a live RPC debt read. */
+export declare function deriveEngineActivityLotDisplay(vault: AegisEnginePositionVaultActivity, market: AegisEngineActivityMarketState | null | undefined): AegisEngineActivityLotDisplay;
+/** Attaches indexed lot display fields to every vault on a parsed REST
+ *  snapshot. One walk of the ledger already in memory — no second fetch. */
+export declare function attachEngineActivityLotDisplays(snapshot: AegisEnginePositionActivitySnapshot): AegisEnginePositionActivitySnapshot;

package/dist/engine/index.d.ts

@@ -1,4 +1,5 @@
 export * from './types.js';
+export * from './activityLotDisplay.js';
 export * from './dataSource.js';
 export * from './marketAdapter.js';
 export * from './registry.js';
@@ -6,3 +7,4 @@ export * from './reads.js';
 export * from './quotes.js';
 export * from './actions.js';
 export * from './positionAmounts.js';
+export * from './positionStrategy.js';

package/dist/engine/positionStrategy.d.ts

@@ -0,0 +1,15 @@
+import type { AegisEnginePosition, AegisEnginePositionVaultActivity, AegisEngineTradePositionIntent, AegisEngineTradePositionStrategy } from './types.js';
+/** Runtime boundary for host-provided or browser-persisted strategy intent. */
+export declare function isAegisEngineTradePositionIntent(value: unknown): value is AegisEngineTradePositionIntent;
+/**
+ * Recognize the current Tap Long/Short opening recipe from indexed Engine
+ * actions. The discriminator is deliberately strict:
+ *
+ * create → one-sided deposit → positive debt → internal swap withdrawal →
+ * opposite-side swap deposit → lock, with no later idle withdrawal.
+ *
+ * A normal Borrow swap has a final user-side withdrawal after its swap output,
+ * so it does not satisfy this shape. Direction comes from the swap input side:
+ * selling token1 for token0 is Long token0; selling token0 is Short token0.
+ */
+export declare function deriveEngineTradePositionStrategy(position: AegisEnginePosition, vault: AegisEnginePositionVaultActivity, intents?: readonly AegisEngineTradePositionIntent[]): AegisEngineTradePositionStrategy | null;