@aegis-engine/core 0.11.0 → 0.13.0

package/README.md

@@ -583,6 +583,16 @@ const quote = await fetchAggregatedSwapQuote(
 )
 ```
 
+`AggregatedSwapQuote.priceImpact` is `number | null`: an omitted provider impact
+remains unavailable, while an explicitly reported zero remains zero. Kyber routes
+report no impact field, so it is derived from Kyber's USD values as
+`(amountInUsd - grossOutUsd) / amountInUsd`, where `grossOutUsd` adds the Aegis
+output fee back to `amountOutUsd` (covers market impact and pool fees; excludes
+the Aegis fee and gas)
+and is `null` when either value is missing or zero. Hosts must handle `null`
+before formatting the value. The Widget displays it as “Unavailable” with a
+warning tone.
+
 For a display-only quote, omit the account. For executable calldata, pass the
 user account:
 
@@ -616,17 +626,32 @@ carry the `uniswap-v4-aegis` tag. It checks this before build and, in
 hop is tagged with any other source, it throws `NoAegisRouteError`
 (`reason: 'no-route' | 'non-aegis-leg'`).
 
+Mainnet and Ink charge an output fee. Pass the deployment's `/v1/config`
+`fee.outputFeeBps` as `outputFeeBps` in the same options object (an integer from
+0 to 200; `0` charges no fee) and to `executeKyberSwap`; the route request,
+build and calldata check all use it. `executeKyberSwap` rejects a displayed
+quote at any other fee before any wallet prompt, approval or signature, and
+refuses to sign if the submitted fee differs. Omit it when config is
+unavailable to keep the bundled 50 bps (`AGGREGATED_SWAP_FEE_BPS`).
+
 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
+output net of the output 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.
 
+Quotes carry `routePaths` for display: each path's input share (`amountIn`) and
+its legs (`pool`, `tokenIn`, `tokenOut`, `source`), as the provider reported
+them. It is omitted unless every path is complete, its legs chain, and its
+endpoints match the quoted assets up to canonical native/wrapped aliases. Known
+input allocations must sum to the quoted input. Invalid metadata is omitted
+without rejecting the display quote. Execution never reads it.
+
 ## KyberSwap Execution
 
 ```ts
@@ -728,7 +753,13 @@ pnpm pack:check
 
 ## Engine account portfolio and activity
 
-`fetchEngineAccountPortfolio({ source, account, chainIds, signal })` reads one complete, bounded account snapshot from the versioned portfolio API. The returned positions, totals, prices and per-chain frames belong to the same snapshot. A failed or expired page rejects the read instead of mixing snapshots. Supported chain IDs are 1, 130, 8453 and 4663; pass the distinct host-selected set.
+`fetchEngineAccountPortfolio({ source, account, chainIds, signal })` reads one complete, bounded account snapshot from the versioned portfolio API. The returned positions, totals, prices and per-chain frames belong to the same snapshot. A failed or expired page rejects the read instead of mixing snapshots. Supported chain IDs are 1, 56, 130, 8453, 4663 and 57073 (Ink); pass the distinct host-selected set. The complete read is bounded to 300 positions, matching the backend's six-chain maximum of 50 positions per chain, with the existing 25-position page requests, response byte limits and shared deadline.
+
+Portfolio, paged activity and transaction acknowledgement reads are available through the existing `@aegis-engine/core/account` entrypoint. Ink support admits the source contract; it does not enable borrowing, activate an operator or establish a live wallet/accounting result. Hosts retain their existing action gates and must qualify the deployed backend separately.
+
+Ink account reads require a deployed Engine account API that supports Ink and
+the six-chain, 300-position contract. Hosts must qualify that backend before
+enabling the integration and retain their existing action gates.
 
 Metrics keep `usd: null`, a `knownUsd` subtotal and reasons when coverage is incomplete. Gross assets include supplied value; adding supply again would double count it. Debt and net equity remain separate. NFT principal, fees, unknown prices and unavailable chains retain their coverage reasons. `performance` explicitly reports unavailable cash-flow and cost-basis evidence.
 
@@ -755,6 +786,9 @@ change does not claim it is already available through the accounting endpoint.
 
 `fetchEngineMarketCandles`, `fetchEngineMarketReferenceHistory`, and
 `fetchEngineRateHistory` read public market data with a shared, bounded REST request.
+These display reads admit Ink (`57073`) through the same market identity, asset,
+coverage and provenance guards. Admission does not establish live source coverage;
+an unavailable history remains unavailable rather than falling back to another feed.
 Validated responses are cached for 30 seconds with at most 16 entries, keyed by
 endpoint, request headers, timeout, market, series and window. A missing endpoint
 backs off for 60 seconds; 429/503 responses back off for at least 30 seconds and

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-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 { 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-CFVVYJeo.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-CFVVYJeo.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

@@ -39,6 +39,11 @@ export declare function executeKyberSwap(args: {
     approvalMode?: AegisSwapApprovalMode;
     /** `'aegis'` routes only through Aegis pools and fails closed otherwise. Defaults to `'any'`. */
     liquiditySources?: AggregatedSwapLiquiditySources;
+    /**
+     * Output fee in bps from `/v1/config` (`fee.outputFeeBps`). Pass the value
+     * the displayed quote was fetched with; omit it to keep the bundled default.
+     */
+    outputFeeBps?: number;
     signal?: AbortSignal;
     onWalletChainId?: (chainId: number | null) => void;
 } & AegisSwapActionCallbacks): Promise<AegisSwapActionResult<AggregatedSwapQuote>>;