@aegis-engine/core 0.9.1 → 0.10.0

package/README.md

@@ -525,8 +525,16 @@ const quote = await fetchDirectPoolSwapQuote({
 ```
 
 Amounts are raw token base units. `slippageBps: 100` means 1%.
-The Aegis 0.5% output fee is applied by the high-level quote and execution
-helpers.
+Exact-output execution enforces the input ceiling and required net receipt after
+fees, or reverts atomically. The low-level builder takes gross `amountOut`;
+optional `amountOutNet` must equal gross output minus the fee. Percentage fees
+become a fixed amount against requested gross output. Remaining output credit
+is then collected; a standard single-hop exact-output fill has no surplus.
+Native input change is swept to `recipient`, which may differ from the payer.
+Use the payer as recipient when that account should receive both output and
+native change. General multihop exact output requires separate per-hop router
+fulfillment checks. The high-level helpers apply the configured Aegis output fee.
+All low-level builders reject negative fixed output fees before encoding calldata.
 
 ## Direct Pool Execution
 
@@ -589,6 +597,25 @@ 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'`).
+
 ## KyberSwap Execution
 
 ```ts
@@ -673,6 +700,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/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-BhNsDpNJ.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-BhNsDpNJ.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-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 { 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>>;