aegis-swap-widget 0.15.0 → 0.17.0

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # Changelog
 
+## 0.17.0
+
+### Minor Changes
+
+- 04a2e9d: Show the path behind aggregated swap quotes. `AggregatedSwapQuote` gains
+  display-only `routePaths` (each path's input share and its pool legs, as Kyber
+  or the Ink router reported them); it is omitted unless every path is complete
+  and chained, matches the quoted endpoints, and conserves known input allocations;
+  execution never reads it. `AegisAggregatedSwapWidget` adds a
+  Route row to Trade details that previews the path with real token artwork and
+  opens a diagram of the input, intermediate tokens and pools, with ribbons sized
+  by each path's share and colored from that artwork. Intermediate tokens outside
+  the token list resolve their symbol and icon through the token metadata
+  service. The diagram draws in along the flow, streams liquidity through
+  whatever pool or token is inspected by hover, tap or keyboard, morphs when only
+  the split shares change, and stays still under reduced motion. A refresh that
+  re-routes the same amounts now redraws it. The Route row is on by default;
+  hosts pass `showRoutePreview={false}` to hide it and skip the intermediate-token
+  metadata request.
+
+  Split percentages stay nonnegative and total 100% after rounding. Escape also
+  dismisses a hovered pool note while focus remains on the Route toggle, and both
+  system and host reduced-motion settings reveal the diagram with opacity only.
+
+### Patch Changes
+
+- 7246abf: `AegisAggregatedSwapWidget` quotes and executes aggregated swaps with the
+  deployment fee from `/v1/config` (`fee.outputFeeBps`). The displayed quote is
+  keyed on the resolved fee and execution passes that same fee, so the two never
+  disagree. Quoting waits briefly for config on first load; with no backend, a
+  failed config read, or a slow one (over 3 s), it keeps the bundled 50 bps.
+- Updated dependencies [04a2e9d]
+- Updated dependencies [90c5b68]
+- Updated dependencies [9af37b3]
+- Updated dependencies [4c32cc7]
+  - @aegis-engine/core@0.13.0
+
+## 0.16.0
+
+### Minor Changes
+
+- 4af9f9c: Open action-specific loan and deposit reviews from live positions without authorizing or submitting. Reuse quoted Engine state for ordinary-loan collateral and repayment previews, qualify missing NFT valuation, and keep fresh position review controls usable while balances refresh.
+
+  Show withdrawal guidance only when the live market and position can support its review. Start collateral withdrawal on a funded idle token, explain balance versus collateral-risk bounds, distinguish confirmed transactions from delayed position data, and label receipt-gas costs as execution fees.
+
+- b235549: Breaking: `AggregatedSwapQuote.priceImpact` is now `number | null` (was `number`). Consumers that call methods on it (for example `quote.priceImpact.toFixed()`), including Widget onQuote callback handlers, must handle `null` first. An omitted provider impact is preserved as null instead of inventing zero. Kyber routes, which report no impact field, now derive it from Kyber's amountInUsd/amountOutUsd with the Aegis output fee added back (covers market impact and pool fees; excludes the Aegis fee and gas) and stay null when those values are missing or zero; Ink routes report null. The Widget shows unknown impact as "Unavailable" with a warning tone while retaining explicit zero and existing nonzero tones.
+
+### Patch Changes
+
+- e4d675e: Clear a previously displayed Aegis quote when a background refresh or fresh submit quote reports no Aegis route or rejects a non-Aegis leg. Show the unavailable state and disable swapping until a valid route returns, while retaining quotes during transient refresh failures.
+- dd93234: Round borrowing limits down in the headline and limits ledger so compact token amounts never exceed the SDK's executable wallet, market or effective capacity.
+- Updated dependencies [b235549]
+  - @aegis-engine/core@0.12.0
+
 ## 0.15.0
 
 ### Minor Changes

package/README.md

@@ -101,7 +101,8 @@ Simple Borrow shows the SDK's wallet/collateral limit separately from its market
 limit in the Borrowing limit disclosure. Independently quoted limits can appear
 before connecting; wallet-specific bounds remain unavailable until the wallet
 balance is known. Custom Borrow shows the effective limit for the entered
-collateral. Its slider and Max action use the SDK token bound even when a dollar
+collateral. Numeric limit summaries round down so the displayed cap never exceeds
+the SDK token bound. Its slider and Max action use the SDK token bound even when a dollar
 price is unavailable; dollar-denominated room and health stay unavailable. Editing
 the Custom borrow amount refreshes its
 execution quote without repeating the collateral-capacity read. Simple Borrow
@@ -133,6 +134,37 @@ Hosts should preserve the mounted widget during an interaction and use
 `onInteractionLockChange` to suspend conflicting navigation. Successful wallet
 authorization does not mean the loan or deposit has been submitted or confirmed.
 
+### Managing positions
+
+The Positions surface offers Add collateral, Repay loan, Withdraw collateral,
+Close loan and Withdraw deposit directly from the corresponding live position.
+Each shortcut opens the existing manager with that action selected. Opening a
+review does not authorize or submit it. Unavailable markets and missing live
+position data do not expose these shortcuts. Loan and deposit shortcuts stay
+available during a refresh while their previous live balances are still fresh;
+the manager verifies action-specific readiness and refreshes its quote before execution.
+
+Loan reviews reuse the current Engine state and the selected action to show
+collateral and debt after the change, alongside the existing Engine risk preview.
+Repayment uses the quote's projected state, never a proportional slider estimate.
+When NFT collateral cannot be valued, the loan review labels its idle balances
+as token collateral and withholds an incomplete total USD value.
+Collateral withdrawal explains whether the current conservative bound is limited
+by the Engine collateral requirement or by the position's token balance.
+
+A deposit's displayed value is not a promise that it can all be withdrawn now.
+The withdrawal manager reads current redeemable shares, supports a partial
+selection, shows the minimum token outputs and checks liquidity again before
+submission. A changed liquidity bound requires review instead of silently
+shrinking the requested withdrawal.
+
+Keep the transaction hash, chain receipt and refreshed position data distinct in
+host UI. The widget's confirmation callback reports the receipt; the API/indexer
+may catch up later. A confirmed transaction awaiting position data offers a
+lookup retry, not another transaction. Pending hashes remain scoped to the
+original wallet and chain across reloads; recovery checks the submitted
+hash and does not reconstruct an executable intent from storage.
+
 ## Wolf Game Trade and Earn preset
 
 The Wolf preset reproduces the focused gamer flow: a resource Store under
@@ -828,6 +860,20 @@ in-house provider instead: up to three hops over the bundled Ink Aegis pools,
 quoted in one Multicall3 call, settled on the Aegis router through Permit2.
 Ink requires `liquiditySources="aegis"`; `'any'` shows an error.
 
+When the current quote reports its path, **Trade details** adds a **Route** row
+that previews the tokens the swap passes through. Opening it draws the input,
+each intermediate token, the pools between them and, for split routes, each
+path's share of the input. Hover, tap or focus a pool for its source, or a token
+to light up every path through it; **Technical details** lists each pool id.
+Intermediate tokens outside your `tokens` list take their symbol and artwork
+from the same token metadata service as the pair (one batched request, cached
+for the session). The diagram otherwise makes no requests, follows the current
+quote only, honours reduced motion, and is omitted when the provider reports no
+complete path or more than five parallel paths.
+
+The Route row is on by default. Pass `showRoutePreview={false}` to hide it; the
+widget then also skips the intermediate-token metadata request.
+
 ## Fees
 
 The widget applies an internal output-token fee per chain. Each bundled chain config

package/dist/{EngineTradeMarketChart-COTq5iKO.js → EngineTradeMarketChart-Bs5NYOGg.js}

@@ -1,7 +1,7 @@
 import { jsxs as h, jsx as i, Fragment as Pe } from "react/jsx-runtime";
 import * as E from "react";
 import { useState as H, useEffect as ue, useRef as F, useId as kt, useMemo as ce } from "react";
-import { E as St, u as _t, a as Ye, b as $t, c as Ft, d as Pt, e as Ot, F as mt, f as gt, g as ft, C as Ut, h as Ht, i as pt, j as Vt } from "./index-B0agjrrs.js";
+import { E as St, u as _t, a as Ye, b as $t, c as Ft, d as Pt, e as Ot, F as mt, f as gt, g as ft, C as Ut, h as Ht, i as pt, j as Vt } from "./index-BcjYe1-F.js";
 import { enginePoolPriceSegments as Xt, splitEngineMarketCandleSegments as Yt, fetchTokenPriceHistory as jt } from "@aegis-engine/core";
 import { m as Wt } from "./marketOrientation-B6SD7xSk.js";
 function qt({

package/dist/aegis-swap-widget.js

@@ -1,4 +1,4 @@
-import { A as s, k as i, l as o, m as n, n as r, o as t, p as A, q as E, r as g, s as u, t as S, S as _, v as c, k as m, w as l, x as P, y as p, z as d, B as W } from "./index-B0agjrrs.js";
+import { A as s, k as i, l as o, m as n, n as r, o as t, p as A, q as E, r as g, s as u, t as S, S as _, v as c, k as m, w as l, x as P, y as p, z as d, B as W } from "./index-BcjYe1-F.js";
 import { u as R, a as T, b as G, c as I, d as O, e as L, f as x, g as D } from "./useEngineActivity-BkhItrUI.js";
 import { WOLF_GAME_ENGINE_WIDGET_PRESET as k, WOLF_GAME_RESOURCES as v, WOLF_GAME_RESOURCE_ORDER as w, resolveWolfGameResource as M, wolfGameResourceWidgetProps as y } from "./presets/wolf-game.js";
 import { normalizePartnerActionRequirement as N, normalizePartnerResourceAmount as z, partnerLaunchIntentForRequirement as C, partnerResourceAssetKey as U } from "./partner-context.js";

package/dist/hooks/useBackendOutputFee.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The deployment output fee from `/v1/config` (`fee.outputFeeBps`) for the
+ * aggregated swap path.
+ *
+ * - `settled` is false only while the first config read for this backend is
+ *   pending, and never for longer than {@link OUTPUT_FEE_CONFIG_WAIT_MS}:
+ *   quoting waits for it so the first displayed quote already carries the
+ *   deployment fee, but a slow or broken backend never blocks quoting.
+ * - `outputFeeBps` is `undefined` when there is no backend, the read failed,
+ *   or the wait ran out; core then applies its bundled default (50 bps).
+ */
+export type BackendOutputFee = {
+    settled: boolean;
+    outputFeeBps: number | undefined;
+};
+export declare function __clearBackendOutputFeeCacheForTests(): void;
+export declare function useBackendOutputFee({ baseUrl, timeoutMs }: {
+    baseUrl: string | null;
+    timeoutMs?: number;
+}): BackendOutputFee;