@aegis-engine/core 0.9.2 → 0.11.0

package/README.md

@@ -597,6 +597,36 @@ const executableQuote = await fetchAggregatedSwapQuote(
 )
 ```
 
+Aggregated quotes are available on chains 1, 56, 130 and 8453
+(`AGGREGATED_SWAP_SUPPORTED_CHAIN_IDS`). To route only through Aegis pools
+(Uniswap v4 pools with the Aegis hook), pass `{ liquiditySources: 'aegis' }` as
+the last argument. Pass the same `liquiditySources` to `executeKyberSwap`:
+
+```ts
+const aegisQuote = await fetchAggregatedSwapQuote(
+  inputToken, outputToken, amount, slippageBps, 'exactIn',
+  null, undefined, undefined, undefined,
+  { liquiditySources: 'aegis' }
+)
+```
+
+Aegis mode sends `includedSources=uniswap-v4-aegis` and requires every hop to
+carry the `uniswap-v4-aegis` tag. It checks this before build and, in
+`executeKyberSwap`, again before signing. If there is no all-Aegis path, or a
+hop is tagged with any other source, it throws `NoAegisRouteError`
+(`reason: 'no-route' | 'non-aegis-leg'`).
+
+Ink (57073) has no Kyber coverage, so it uses an in-house provider that accepts
+only `liquiditySources: 'aegis'` (`'any'` is rejected). It enumerates every path
+of up to three hops through the shipped Ink pool catalogue, quotes all of them
+(at most 32) in one Multicall3 `eth_call` to the V4 quoter, and takes the best
+output net of the 50 bps fee. Pass a `publicClient` (the eighth argument) to
+reuse your RPC. The swap goes to the Aegis router, which pulls input through
+Permit2: `executeKyberSwap` approves Permit2 for the exact input, signs a
+Permit2 grant for the router, re-quotes, and simulates before sending. The
+calldata ends with a fixed `TAKE` of the reviewed minimum, so a short fill
+reverts.
+
 ## KyberSwap Execution
 
 ```ts
@@ -681,6 +711,8 @@ Execution returns:
 - User rejection errors normalize through `errorMessage(error, fallback)`.
 - Kyber temporary failures can be mapped with
   `aggregatedSwapErrorMessage(error, fallback)`.
+- `NoAegisRouteError`: Aegis-only routing found no all-Aegis path, or the
+  route included a hop outside Aegis pools.
 
 ## Publishing
 

package/dist/abis.d.ts

@@ -114,6 +114,22 @@ export declare const PERMIT2_ABI: readonly [{
         readonly type: "uint48";
     }];
 }];
+export declare const V4_PATH_KEY_COMPONENTS: readonly [{
+    readonly name: "intermediateCurrency";
+    readonly type: "address";
+}, {
+    readonly name: "fee";
+    readonly type: "uint24";
+}, {
+    readonly name: "tickSpacing";
+    readonly type: "int24";
+}, {
+    readonly name: "hooks";
+    readonly type: "address";
+}, {
+    readonly name: "hookData";
+    readonly type: "bytes";
+}];
 export declare const UNISWAP_V4_QUOTER_ABI: readonly [{
     readonly type: "function";
     readonly name: "quoteExactInputSingle";
@@ -202,4 +218,45 @@ export declare const UNISWAP_V4_QUOTER_ABI: readonly [{
         readonly name: "gasEstimate";
         readonly type: "uint256";
     }];
+}, {
+    readonly type: "function";
+    readonly name: "quoteExactInput";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "params";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "exactCurrency";
+            readonly type: "address";
+        }, {
+            readonly name: "path";
+            readonly type: "tuple[]";
+            readonly components: readonly [{
+                readonly name: "intermediateCurrency";
+                readonly type: "address";
+            }, {
+                readonly name: "fee";
+                readonly type: "uint24";
+            }, {
+                readonly name: "tickSpacing";
+                readonly type: "int24";
+            }, {
+                readonly name: "hooks";
+                readonly type: "address";
+            }, {
+                readonly name: "hookData";
+                readonly type: "bytes";
+            }];
+        }, {
+            readonly name: "exactAmount";
+            readonly type: "uint128";
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "amountOut";
+        readonly type: "uint256";
+    }, {
+        readonly name: "gasEstimate";
+        readonly type: "uint256";
+    }];
 }];

package/dist/account.js

@@ -1,5 +1,5 @@
-import { w as u, o as b, n as A, s as I, l as P, E as g, A as h, r as f, a as x, i as c, b as E, c as S, d as C, e as _, P as T, f as D } from "./transactionHistory-D3PDVGkr.js";
-import { g as M, h as j, j as J, k as O, m as U, p as G, q as Z, t as Q, u as V, v as W, x as X, y as Y, z as ee, B as ae, C as oe, D as se, F as ne, G as te, H as re } from "./transactionHistory-D3PDVGkr.js";
+import { w as u, o as b, n as A, s as I, l as P, E as g, A as h, r as f, a as x, i as c, b as E, c as S, d as C, e as _, P as T, f as D } from "./transactionHistory-B-F6o9hW.js";
+import { g as M, h as j, j as J, k as O, m as U, p as G, q as Z, t as Q, u as V, v as W, x as X, y as Y, z as ee, B as ae, C as oe, D as se, F as ne, G as te, H as re } from "./transactionHistory-B-F6o9hW.js";
 import { keccak256 as k, encodeAbiParameters as y } from "viem";
 const H = b({ version: P(1), snapshotId: I().uuid(), page: A().int().min(1).max(95) }).strict();
 function v(e) {

package/dist/actions/kyberSwap.d.ts

@@ -1,6 +1,7 @@
 import { type Address, type Hex, type PublicClient } from 'viem';
 import { UserFacingError } from '../errors.js';
 import type { AegisSwapChainConfig, AegisSwapToken } from '../config/index.js';
+import type { AggregatedSwapLiquiditySources } from '../services/kyberSwap.js';
 import type { AegisSwapApprovalMode, WalletSession } from '../swap/types.js';
 import type { AggregatedSwapQuote } from '../types/aggregatedSwap.js';
 import type { AegisSwapActionCallbacks, AegisSwapActionResult } from './types.js';
@@ -36,6 +37,8 @@ export declare function executeKyberSwap(args: {
     slippageBps: number;
     displayedQuote?: AggregatedSwapQuote | null;
     approvalMode?: AegisSwapApprovalMode;
+    /** `'aegis'` routes only through Aegis pools and fails closed otherwise. Defaults to `'any'`. */
+    liquiditySources?: AggregatedSwapLiquiditySources;
     signal?: AbortSignal;
     onWalletChainId?: (chainId: number | null) => void;
 } & AegisSwapActionCallbacks): Promise<AegisSwapActionResult<AggregatedSwapQuote>>;