@aegis-engine/core 0.5.0 → 0.7.0

package/README.md

@@ -122,6 +122,54 @@ remaining collateral stays in the vault until a separate withdrawal. A
 one-token lend is a zap into a two-sided full-range LP, not single-token
 lending.
 
+### Simple-yield position summaries
+
+Use `summarizeEngineSimpleYieldPosition` when a custom UI needs one honest,
+React-free summary of an Engine lender-share position. The helper values live
+shares first, falls back to trusted indexed shares, projects an optional added
+USD amount, and converts realized share-price growth into a weekly estimate.
+
+```ts
+import {
+  readEnginePositionsHydration,
+  summarizeEngineSimpleYieldPosition
+} from '@aegis-engine/core'
+
+const market = markets[0]
+const positionsHydration = await readEnginePositionsHydration({
+  publicClient,
+  chainId: market.chainId,
+  expectedAccount: account,
+  positions: positions.positions,
+  lendPositions: positions.lendPositions
+})
+const position = positions.lendPositions.find(
+  (entry) =>
+    entry.chainId === market.chainId &&
+    entry.poolId.toLowerCase() === market.poolId.toLowerCase()
+) ?? null
+const live = position
+  ? positionsHydration.lendPositions.find(
+      (entry) => entry.positionId === position.id
+    )
+  : undefined
+
+const summary = summarizeEngineSimpleYieldPosition({
+  market,
+  position,
+  hydration: live,
+  history: marketHistory,
+  additionalValueUsd: 100
+})
+```
+
+`summary.valuation` identifies whether live or indexed shares produced the
+current USD value. `summary.projection` is null when an existing position cannot
+be valued, so an add-funds UI cannot mislabel it as a new deposit.
+`summary.growth.weeklyEarningsPer100Usd` is a historical share-growth estimate,
+not a promise. `market.metrics.lendApyPct` is the current modeled lender rate;
+it is a different metric and is never substituted for realized history.
+
 ### Directional Engine positions
 
 `quoteEngineTradeOpen` sizes a fresh-vault Long or Short against one
@@ -525,9 +573,29 @@ Execution returns:
 
 ## Publishing
 
-This package is configured with `prepack`, so `npm publish` builds `dist` before
-creating the tarball.
+Releases use Changesets and npm trusted publishing. The release workflow builds
+all publishable packages once, validates their tarballs, then publishes the
+prebuilt artifacts with package lifecycle scripts disabled. This prevents
+concurrent package publishes from rebuilding shared workspace artifacts.
 
 ```sh
-npm publish --access public
+pnpm build
+pnpm pack:check
 ```
+
+## Borrow collateral sizing
+
+`quoteEngineBorrowCapacity` reports `collateralFloor` as a settled result:
+`not-requested`, `ready-positive`, `ready-zero`, `infeasible`, or `unavailable`.
+Unavailable results include a reason and whether a fresh read may help. A null
+closed-form result is terminal for that request; it does not mean the request is
+still running. Zero means no additional collateral is needed at the sizing
+inputs; it is not permission to submit a new borrow. Its `outputSource`
+distinguishes existing idle tokens from new debt or an unknown legacy result.
+Only confirmed idle output supports a withdrawal review through the normal
+protected quote and authorization flow.
+`minimumNoSwapCollateralIn` remains available for compatibility, and
+`resolveEngineBorrowCollateralFloor` adapts older capacity snapshots.
+
+The result's `frame` identifies the market read used for sizing. Caller-supplied
+vault inputs and any executable transaction still require fresh validation.

package/dist/actions/directPoolSwap.d.ts

@@ -32,6 +32,7 @@ export declare function approveDirectPoolSwapInput(args: {
     amount: bigint;
     approvalMode?: AegisSwapApprovalMode;
     onStatus?: AegisSwapActionCallbacks['onStatus'];
+    onApprovalProgress?: AegisSwapActionCallbacks['onApprovalProgress'];
 }): Promise<DirectPoolSwapApprovalResult>;
 export declare function executeDirectPoolSwap(args: {
     wallet: WalletSession;
@@ -45,6 +46,8 @@ export declare function executeDirectPoolSwap(args: {
     slippageBps: number;
     displayedQuote?: DirectSwapQuote | null;
     approvalMode?: AegisSwapApprovalMode;
+    /** Finite cap for the next token and Permit2 approvals. Must cover the reviewed spend. */
+    approvalAmount?: bigint;
     signal?: AbortSignal;
     onWalletChainId?: (chainId: number | null) => void;
 } & AegisSwapActionCallbacks): Promise<AegisSwapActionResult<DirectSwapQuote>>;

package/dist/actions/kyberSwap.d.ts

@@ -23,6 +23,7 @@ export declare function approveKyberSwapInput(args: {
     amount: bigint;
     approvalMode?: AegisSwapApprovalMode;
     onStatus?: AegisSwapActionCallbacks['onStatus'];
+    onApprovalProgress?: AegisSwapActionCallbacks['onApprovalProgress'];
 }): Promise<KyberSwapApprovalResult>;
 export declare function executeKyberSwap(args: {
     wallet: WalletSession;

package/dist/actions/types.d.ts

@@ -3,10 +3,70 @@ import type { DirectSwapQuote } from '../quote.js';
 import type { AegisSwapReceiptSummary, SubmitStatus } from '../transactionProgress.js';
 import type { AggregatedSwapQuote } from '../types/aggregatedSwap.js';
 import type { AegisSwapSubmitDetails } from '../swap/types.js';
+/**
+ * The grant the approval prompt asks for, as the executor resolved it from the
+ * sizing rule. It travels with the progress report so a surface renders the
+ * number that will actually be signed instead of re-deriving one from form
+ * state — the input amount and the requested amount are the same only under
+ * 'exact' sizing. There is no `formatted` field: the unlimited case has no
+ * honest formatting and has to be rendered as a word.
+ */
+export type AegisSwapApprovalRequest = {
+    /** The exact value passed to `approve()`. */
+    value: bigint;
+    /** Decimals of the approved token, so `value` is renderable on its own. */
+    decimals: number;
+    /** True when `value` reads as no limit at all; render a word, not `value`. */
+    unlimited: boolean;
+};
+/**
+ * The approval step's wallet prompts: how many it will open, how many the
+ * wallet has already confirmed, and what they ask for. Only the executor can
+ * answer any of it — its allowance read decides whether a USDT-style zero-reset
+ * adds a second prompt, and only it sees that reset's receipt.
+ */
+export type AegisSwapApprovalProgress = {
+    /** Broadcast approval awaiting its receipt; absent before signing and after settlement. */
+    pendingHash?: Hex;
+    /** Prompts the approval step opens: 0, 1, or 2 when a zero-reset precedes it. */
+    planned: number;
+    /** How many of `planned` have landed on-chain. */
+    completed: number;
+    /** Absent exactly when `planned` is 0 — nothing will be approved. */
+    request?: AegisSwapApprovalRequest;
+};
+/**
+ * Wallet prompts used to authorize Permit2 for the router. Usually this is one
+ * typed-data signature. A wallet that explicitly reports typed-data as
+ * unsupported uses one on-chain spending-cap prompt instead. Returned invalid
+ * signatures fail closed, so this is a count rather than a boolean.
+ */
+export type AegisSwapAuthorizationProgress = {
+    /** On-chain Permit2 fallback awaiting its receipt; signatures have no hash. */
+    pendingHash?: Hex;
+    /** Prompts this authorization step will open from the executor's live state. */
+    planned: number;
+    /** Prompts already completed by the wallet/user. */
+    completed: number;
+};
 export type AegisSwapActionCallbacks<TSwapDetails = AegisSwapSubmitDetails> = {
     onStatus?: (status: SubmitStatus) => void;
     onTxHash?: (hash: Hex | null) => void;
     onSubmitted?: (hash: Hex, swap?: TSwapDetails) => void;
+    /**
+     * Fires with the plan before the first approval prompt opens, when each
+     * approval is broadcast, and after it mines. Once allowance resolution is
+     * reached, no required approval reports `{ planned: 0, completed: 0 }`.
+     * Earlier chain-validation or quote failures can stop before this callback.
+     */
+    onApprovalProgress?: (progress: AegisSwapApprovalProgress) => void;
+    /**
+     * Fires before the first Permit2 authorization prompt, whenever the plan
+     * changes, when an on-chain fallback is broadcast, and after each completed
+     * prompt. A reusable standing cap reports
+     * `{ planned: 0, completed: 0 }`.
+     */
+    onAuthorizationProgress?: (progress: AegisSwapAuthorizationProgress) => void;
 };
 export type AegisSwapActionResult<TQuote = DirectSwapQuote | AggregatedSwapQuote> = {
     hash: Hex;

package/dist/aegis-core.js

@@ -1,4 +1,4 @@
-import { A as s, b as i, c as r, d as n, e as t, f as o, g as c, h as E, i as A, j as S, k as g, l as d, m as _, n as l, o as P, p as b, q as p, r as T, t as u, u as h, v as k, w as I, x as C, y as R, z as m, B as w, C as G, D as B, E as D, F as N, G as M, H as y, K as v, I as W, J as U, M as O, L as F, N as L, O as f, P as K, S as H, T as V, U as x, Q, R as q, V as z, W as X, X as Y, Y as j, Z, _ as J, $, a0 as aa, a1 as ea, a2 as sa, a3 as ia, a4 as ra, a5 as na, a6 as ta, a7 as oa, a8 as ca, a9 as Ea, aa as Aa, ab as Sa, ac as ga, ad as da, ae as _a, af as la, ag as Pa, ah as ba, ai as pa, aj as Ta, ak as ua, al as ha, am as ka, an as Ia, ao as Ca, ap as Ra, aq as ma, ar as wa, as as Ga, at as Ba, au as Da, av as Na, aw as Ma, ax as ya, ay as va, az as Wa, aA as Ua, aB as Oa, aC as Fa, aD as La, aE as fa, aF as Ka, aG as Ha, aH as Va, aI as xa, aJ as Qa, aK as qa, aL as za, aM as Xa, aN as Ya, aO as ja, aP as Za, aQ as Ja, aR as $a, aS as ae, aT as ee, aU as se, aV as ie, aW as re, aX as ne, aY as te, aZ as oe, a_ as ce, a$ as Ee, b0 as Ae, b1 as Se, b2 as ge, b3 as de, b4 as _e, b5 as le, b6 as Pe, b7 as be, b8 as pe, b9 as Te, ba as ue, bb as he, bc as ke, bd as Ie, be as Ce, bf as Re, bg as me, bh as we, bi as Ge, bj as Be, bk as De, bl as Ne, bm as Me, bn as ye, bo as ve, bp as We, bq as Ue, br as Oe, bs as Fe, bt as Le, bu as fe, bv as Ke, bw as He, bx as Ve, by as xe, bz as Qe, bA as qe, bB as ze, bC as Xe, bD as Ye, bE as je, bF as Ze, bG as Je, bH as $e, bI as as, bJ as es, bK as ss, bL as is, bM as rs, bN as ns, bO as ts, bP as os, bQ as cs, bR as Es, bS as As, bT as Ss, bU as gs, bV as ds, bW as _s, bX as ls, bY as Ps, bZ as bs, b_ as ps, b$ as Ts, c0 as us, c1 as hs, c2 as ks, c3 as Is, c4 as Cs, c5 as Rs, c6 as ms, c7 as ws, c8 as Gs, c9 as Bs, ca as Ds, cb as Ns, cc as Ms, cd as ys } from "./index-DuoaODpB.js";
+import { A as s, b as i, c as r, d as n, e as t, f as o, g as c, h as E, i as S, j as A, k as g, l as d, m as l, n as _, o as p, p as b, q as P, r as T, t as u, u as h, v as m, w as k, x as R, y as I, z as C, B as w, C as G, D as B, E as D, F as N, G as M, H as v, K as y, I as W, J as U, M as O, L as F, N as L, O as f, P as K, S as H, Q as V, T as q, U as x, R as Q, V as z, W as X, X as Y, Y as j, Z, _ as J, $, a0 as aa, a1 as ea, a2 as sa, a3 as ia, a4 as ra, a5 as na, a6 as ta, a7 as oa, a8 as ca, a9 as Ea, aa as Sa, ab as Aa, ac as ga, ad as da, ae as la, af as _a, ag as pa, ah as ba, ai as Pa, aj as Ta, ak as ua, al as ha, am as ma, an as ka, ao as Ra, ap as Ia, aq as Ca, ar as wa, as as Ga, at as Ba, au as Da, av as Na, aw as Ma, ax as va, ay as ya, az as Wa, aA as Ua, aB as Oa, aC as Fa, aD as La, aE as fa, aF as Ka, aG as Ha, aH as Va, aI as qa, aJ as xa, aK as Qa, aL as za, aM as Xa, aN as Ya, aO as ja, aP as Za, aQ as Ja, aR as $a, aS as ae, aT as ee, aU as se, aV as ie, aW as re, aX as ne, aY as te, aZ as oe, a_ as ce, a$ as Ee, b0 as Se, b1 as Ae, b2 as ge, b3 as de, b4 as le, b5 as _e, b6 as pe, b7 as be, b8 as Pe, b9 as Te, ba as ue, bb as he, bc as me, bd as ke, be as Re, bf as Ie, bg as Ce, bh as we, bi as Ge, bj as Be, bk as De, bl as Ne, bm as Me, bn as ve, bo as ye, bp as We, bq as Ue, br as Oe, bs as Fe, bt as Le, bu as fe, bv as Ke, bw as He, bx as Ve, by as qe, bz as xe, bA as Qe, bB as ze, bC as Xe, bD as Ye, bE as je, bF as Ze, bG as Je, bH as $e, bI as as, bJ as es, bK as ss, bL as is, bM as rs, bN as ns, bO as ts, bP as os, bQ as cs, bR as Es, bS as Ss, bT as As, bU as gs, bV as ds, bW as ls, bX as _s, bY as ps, bZ as bs, b_ as Ps, b$ as Ts, c0 as us, c1 as hs, c2 as ms, c3 as ks, c4 as Rs, c5 as Is, c6 as Cs, c7 as ws, c8 as Gs, c9 as Bs, ca as Ds, cb as Ns, cc as Ms, cd as vs, ce as ys, cf as Ws, cg as Us, ch as Os, ci as Fs, cj as Ls, ck as fs, cl as Ks, cm as Hs, cn as Vs } from "./index-DofKgro2.js";
 export {
   s as AEGIS_BACKEND_PROD_BASE_URL,
   i as AEGIS_DYNAMIC_FEE_FLAG,
@@ -8,31 +8,31 @@ export {
   o as AEGIS_SWAP_DEFAULT_FEE_RECIPIENT,
   c as AEGIS_SWAP_DEFAULT_METADATA_ENDPOINT,
   E as AEGIS_SWAP_DEFAULT_RPC_URLS,
-  A as AEGIS_SWAP_HOOK,
-  S as AEGIS_SWAP_MAINNET_CHAIN,
+  S as AEGIS_SWAP_HOOK,
+  A as AEGIS_SWAP_MAINNET_CHAIN,
   g as AEGIS_SWAP_MAINNET_UNISWAP_V4_CONTRACTS,
   d as AEGIS_SWAP_PERMIT2,
-  _ as AEGIS_SWAP_ROUTER,
-  l as AEGIS_SWAP_TOKENS,
-  P as AEGIS_SWAP_TRUSTED_ROUTERS_BY_CHAIN,
+  l as AEGIS_SWAP_ROUTER,
+  _ as AEGIS_SWAP_TOKENS,
+  p as AEGIS_SWAP_TRUSTED_ROUTERS_BY_CHAIN,
   b as AEGIS_SWAP_V4_QUOTER,
-  p as AGGREGATED_SWAP_CURATED_TOKENS,
+  P as AGGREGATED_SWAP_CURATED_TOKENS,
   T as AGGREGATED_SWAP_DEFAULT_TOKENS,
   u as AGGREGATED_SWAP_DEFAULT_TOKEN_LIST,
   h as AGGREGATED_SWAP_SUPPORTED_CHAIN_IDS,
-  k as AGGREGATED_SWAP_TOKEN_PRESETS,
-  I as AGGREGATED_SWAP_WOLFGAME_TOKENS,
-  C as AGGREGATED_SWAP_WOLFGAME_TOKEN_LIST,
-  R as AegisBackendApiError,
-  m as AegisBackendContractError,
+  m as AGGREGATED_SWAP_TOKEN_PRESETS,
+  k as AGGREGATED_SWAP_WOLFGAME_TOKENS,
+  R as AGGREGATED_SWAP_WOLFGAME_TOKEN_LIST,
+  I as AegisBackendApiError,
+  C as AegisBackendContractError,
   w as AegisContractGuardError,
   G as AegisEngineMarketNotReadyError,
   B as AggregatedSwapBuildMismatchError,
   D as AggregatedSwapCalldataError,
   N as DEFAULT_PERMIT_EXPIRATION_SECONDS,
   M as DirectPoolSwapPriceMovedError,
-  y as ENGINE_UTILIZATION_CAP_PCT,
-  v as KyberSwapApiError,
+  v as ENGINE_UTILIZATION_CAP_PCT,
+  y as KyberSwapApiError,
   W as KyberSwapContractError,
   U as KyberSwapPriceMovedError,
   O as MAX_UINT128,
@@ -41,157 +41,167 @@ export {
   f as NATIVE_TOKEN_ADDRESS,
   K as PERMIT2_FAR_FUTURE_EXPIRATION,
   H as SWAP_TX_DEADLINE_SECONDS,
-  V as TransactionReceiptTimeoutError,
+  V as SubmittedTransactionReceiptError,
+  q as TransactionReceiptTimeoutError,
   x as UNISWAP_V4_CONTRACTS_BY_CHAIN,
   Q as USER_REJECTED_MESSAGE,
-  q as UserFacingError,
-  z as aegisBackendAddressAllowlistSchema,
-  X as aegisBackendAddressSchema,
-  Y as aegisBackendAllowlistsByChainSchema,
-  j as aegisBackendChainIdSchema,
-  Z as aegisBackendChainSchema,
-  J as aegisBackendConfigSchema,
-  $ as aegisBackendContractRegistrySchema,
-  aa as aegisBackendContractsByChainSchema,
-  ea as aegisBackendDecimalStringSchema,
-  sa as aegisBackendFeeConfigSchema,
-  ia as aegisBackendHealthResponseSchema,
-  ra as aegisBackendHexSchema,
-  na as aegisBackendIsoDateTimeSchema,
-  ta as aegisBackendMarketMetricsSchema,
-  oa as aegisBackendMarketSchema,
-  ca as aegisBackendMarketStatusSchema,
-  Ea as aegisBackendMarketsResponseSchema,
+  z as UserFacingError,
+  X as aegisBackendAddressAllowlistSchema,
+  Y as aegisBackendAddressSchema,
+  j as aegisBackendAllowlistsByChainSchema,
+  Z as aegisBackendChainIdSchema,
+  J as aegisBackendChainSchema,
+  $ as aegisBackendConfigSchema,
+  aa as aegisBackendContractRegistrySchema,
+  ea as aegisBackendContractsByChainSchema,
+  sa as aegisBackendDecimalStringSchema,
+  ia as aegisBackendFeeConfigSchema,
+  ra as aegisBackendHealthResponseSchema,
+  na as aegisBackendHexSchema,
+  ta as aegisBackendIsoDateTimeSchema,
+  oa as aegisBackendMarketMetricsSchema,
+  ca as aegisBackendMarketSchema,
+  Ea as aegisBackendMarketStatusSchema,
+  Sa as aegisBackendMarketsResponseSchema,
   Aa as aegisBackendQuoteDefaultsSchema,
-  Sa as aegisBackendQuoteModeSchema,
-  ga as aegisBackendSwapProviderSchema,
-  da as aegisBackendSwapQuoteRequestSchema,
+  ga as aegisBackendQuoteModeSchema,
+  da as aegisBackendSwapProviderSchema,
+  la as aegisBackendSwapQuoteRequestSchema,
   _a as aegisBackendSwapQuoteResponseSchema,
-  la as aegisBackendTokenSchema,
-  Pa as aegisBackendTokensResponseSchema,
-  ba as aegisPoolKeySchema,
-  pa as aggregatedSwapErrorMessage,
-  Ta as approveDirectPoolSwapInput,
-  ua as approveEnginePermit2ToRouter,
-  ha as approveEngineTokenToPermit2,
+  pa as aegisBackendTokenSchema,
+  ba as aegisBackendTokensResponseSchema,
+  Pa as aegisPoolKeySchema,
+  Ta as aggregatedSwapErrorMessage,
+  ua as approveDirectPoolSwapInput,
+  ha as approveEnginePermit2ToRouter,
+  ma as approveEngineTokenToPermit2,
   ka as approveErc20Spender,
-  Ia as approveErc20ToPermit2,
-  Ca as approveKyberSwapInput,
-  Ra as approvePermit2ToRouter,
-  ma as assertCalldataHash,
-  wa as assertChainMatches,
-  Ga as assertQuoteFresh,
-  Ba as assertRouterAllowlisted,
-  Da as assertSpenderAllowlisted,
-  Na as assertUint128,
-  Ma as attachEngineActivityLotDisplays,
+  Ra as approveErc20ToPermit2,
+  Ia as approveKyberSwapInput,
+  Ca as approvePermit2ToRouter,
+  wa as assertCalldataHash,
+  Ga as assertChainMatches,
+  Ba as assertQuoteFresh,
+  Da as assertRouterAllowlisted,
+  Na as assertSpenderAllowlisted,
+  Ma as assertUint128,
+  va as attachEngineActivityLotDisplays,
   ya as authorizeEnginePositionRouter,
-  va as authorizeEngineVaultOperator,
-  Wa as backendTokenToAegisSwapToken,
-  Ua as backendTokensToAegisSwapTokens,
-  Oa as buildExactInSwapTransaction,
-  Fa as buildExactOutSwapTransaction,
-  La as buildKyberSwapRoute,
-  fa as buildSignedPermitBatch,
-  Ka as classifyEngineVaultActivity,
-  Ha as classifyError,
-  Va as clearEngineMarketHistoryCache,
+  Wa as authorizeEngineVaultOperator,
+  Ua as backendTokenToAegisSwapToken,
+  Oa as backendTokensToAegisSwapTokens,
+  Fa as buildExactInSwapTransaction,
+  La as buildExactOutSwapTransaction,
+  fa as buildKyberSwapRoute,
+  Ka as buildSignedPermitBatch,
+  Ha as classifyEngineVaultActivity,
+  Va as classifyError,
+  qa as clearEngineMarketHistoryCache,
   xa as clearEngineMarketsCache,
   Qa as clearEnginePositionActivityCache,
-  qa as clearEnginePositionsCache,
-  za as clearEnginePositionsV2ProbeCache,
-  Xa as clearEngineReadCaches,
-  Ya as clearTokenPriceHistoryCache,
-  ja as computeEngineIdleWithdrawPostLtvPips,
-  Za as computeEngineMaxIdleWithdraw,
-  Ja as computePoolId,
-  $a as createAegisBackendApiClient,
-  ae as createAegisSwapChainConfig,
-  ee as createAegisSwapChains,
-  se as createAegisSwapChainsFromBackendConfig,
-  ie as createAegisSwapMarketsFromPools,
-  re as createAegisSwapPoolMarket,
-  ne as createAegisSwapPoolsFromBackendMarkets,
-  te as createAegisSwapUniswapV4Contracts,
-  oe as createSwapPublicClient,
-  ce as deriveEngineActivityLotDisplay,
-  Ee as deriveEngineTradePositionStrategy,
+  za as clearEnginePositionsCache,
+  Xa as clearEnginePositionsV2ProbeCache,
+  Ya as clearEngineReadCaches,
+  ja as clearTokenPriceHistoryCache,
+  Za as computeEngineIdleWithdrawPostLtvPips,
+  Ja as computeEngineMaxIdleWithdraw,
+  $a as computePoolId,
+  ae as createAegisBackendApiClient,
+  ee as createAegisSwapChainConfig,
+  se as createAegisSwapChains,
+  ie as createAegisSwapChainsFromBackendConfig,
+  re as createAegisSwapMarketsFromPools,
+  ne as createAegisSwapPoolMarket,
+  te as createAegisSwapPoolsFromBackendMarkets,
+  oe as createAegisSwapUniswapV4Contracts,
+  ce as createSwapPublicClient,
+  Ee as deriveEngineActivityLotDisplay,
+  Se as deriveEngineTradePositionStrategy,
   Ae as engineIdleWithdrawPassesResidualLtv,
-  Se as enginePermit2GrantSatisfies,
-  ge as enginePreviewMaxLtvPips,
-  de as engineRouterForChain,
-  _e as engineTokenGrantSatisfies,
-  le as ensureWalletChain,
+  ge as engineMarketsRestResponseSchema,
+  de as enginePermit2GrantSatisfies,
+  le as enginePreviewMaxLtvPips,
+  _e as engineRouterForChain,
+  pe as engineTokenGrantSatisfies,
+  be as ensureWalletChain,
   Pe as errorMessage,
-  be as estimateSwapGasWithBuffer,
-  pe as executeDirectPoolSwap,
-  Te as executeKyberSwap,
-  ue as executionLtvGuardPips,
-  he as fetchAggregatedSwapQuote,
-  ke as fetchDirectPoolSwapQuote,
+  Te as estimateSwapGasWithBuffer,
+  ue as executeDirectPoolSwap,
+  he as executeKyberSwap,
+  me as executionLtvGuardPips,
+  ke as fetchAggregatedSwapQuote,
+  Re as fetchDirectPoolSwapQuote,
   Ie as fetchEngineLendActivity,
   Ce as fetchEngineMarketHistory,
-  Re as fetchEngineMarkets,
-  me as fetchEnginePositionActivitySnapshot,
-  we as fetchEnginePositionsSnapshot,
-  Ge as fetchEngineVaultActivity,
-  Be as fetchGlobalTokenMetadata,
-  De as fetchKyberSwapRoute,
-  Ne as fetchTokenPriceHistory,
-  Me as getExplorerUrl,
-  ye as getInjectedProvider,
-  ve as getProviderAccount,
-  We as getProviderChainId,
-  Ue as getZeroForOne,
-  Oe as isAegisEngineTradePositionIntent,
-  Fe as isBusy,
-  Le as isDocumentVisible,
-  fe as isEip1193Provider,
-  Ke as isNativeAssetAddress,
-  He as isNativeToken,
-  Ve as isRetryableAegisBackendApiError,
-  xe as isRetryableKyberSwapError,
-  Qe as isUserRejectedError,
-  qe as missingEngineExecutionReason,
-  ze as normalizeAccount,
-  Xe as normalizeAegisBackendBaseUrl,
-  Ye as normalizeEngineMarkets,
-  je as normalizeWalletConnection,
-  Ze as outputFeeForQuote,
-  Je as peekTokenPriceHistory,
-  $e as pollUntil,
-  as as prepareEnginePermit,
-  es as quoteEngineAddCollateral,
-  ss as quoteEngineBorrow,
-  is as quoteEngineBorrowCapacity,
-  rs as quoteEngineCloseVault,
-  ns as quoteEngineDeposit,
-  ts as quoteEngineIdleWithdraw,
-  os as quoteEngineRedeem,
-  cs as quoteEngineRepay,
-  Es as quoteEngineTradeOpen,
-  As as quoteSpendAmount,
-  Ss as readEngineAuthorizationPlan,
-  gs as readEngineBorrowQuoteContext,
-  ds as readEngineLendQuoteContext,
-  _s as readEngineMarketMark,
-  ls as readEngineMarketSnapshot,
-  Ps as readEnginePositionsHydration,
-  bs as readEngineVaultActivity,
-  ps as readEngineVaultRouterApproved,
-  Ts as readErc20Allowance,
-  us as readPermit2RouterAllowance,
-  hs as reconcileSubmitQuote,
-  ks as requestProviderAccount,
-  Is as resolveTokenIconUrl,
-  Cs as resolveWalletSession,
-  Rs as retryOnError,
-  ms as sameQuote,
-  ws as sendEngineTransaction,
-  Gs as subscribeProvider,
-  Bs as switchProviderChain,
-  Ds as transactionProgressView,
-  Ns as trustedEngineRegistryForChain,
-  Ms as trustedEngineVersionForChain,
-  ys as waitForProviderChain
+  we as fetchEngineMarkets,
+  Ge as fetchEnginePositionActivitySnapshot,
+  Be as fetchEnginePositionsSnapshot,
+  De as fetchEngineVaultActivity,
+  Ne as fetchGlobalTokenMetadata,
+  Me as fetchKyberSwapRoute,
+  ve as fetchTokenPriceHistory,
+  ye as getExplorerUrl,
+  We as getInjectedProvider,
+  Ue as getProviderAccount,
+  Oe as getProviderChainId,
+  Fe as getZeroForOne,
+  Le as isAegisEngineTradePositionIntent,
+  fe as isBusy,
+  Ke as isDocumentVisible,
+  He as isEip1193Provider,
+  Ve as isNativeAssetAddress,
+  qe as isNativeToken,
+  xe as isRetryableAegisBackendApiError,
+  Qe as isRetryableKyberSwapError,
+  ze as isSubmittedTransactionReceiptError,
+  Xe as isUserRejectedError,
+  Ye as missingEngineExecutionReason,
+  je as normalizeAccount,
+  Ze as normalizeAegisBackendBaseUrl,
+  Je as normalizeEngineMarkets,
+  $e as normalizeWalletConnection,
+  as as outputFeeForQuote,
+  es as peekTokenPriceHistory,
+  ss as pollUntil,
+  is as prepareEnginePermit,
+  rs as progressRailSteps,
+  ns as quoteEngineAddCollateral,
+  ts as quoteEngineBorrow,
+  os as quoteEngineBorrowCapacity,
+  cs as quoteEngineCloseVault,
+  Es as quoteEngineDeposit,
+  Ss as quoteEngineIdleWithdraw,
+  As as quoteEngineRedeem,
+  gs as quoteEngineRepay,
+  ds as quoteEngineTradeOpen,
+  ls as quoteSpendAmount,
+  _s as readEngineAuthorizationPlan,
+  ps as readEngineBorrowQuoteContext,
+  bs as readEngineLendQuoteContext,
+  Ps as readEngineMarketMark,
+  Ts as readEngineMarketSnapshot,
+  us as readEnginePositionsHydration,
+  hs as readEngineVaultActivity,
+  ms as readEngineVaultRouterApproved,
+  ks as readErc20Allowance,
+  Rs as readPermit2RouterAllowance,
+  Is as reconcileSubmitQuote,
+  Cs as reconcileSubmittedReceipt,
+  ws as requestProviderAccount,
+  Gs as resolveEngineBorrowCollateralFloor,
+  Bs as resolveTokenIconUrl,
+  Ds as resolveWalletSession,
+  Ns as retryOnError,
+  Ms as sameQuote,
+  vs as sendEngineTransaction,
+  ys as subscribeProvider,
+  Ws as summarizeEngineLendShareGrowth,
+  Us as summarizeEngineSimpleYieldPosition,
+  Os as summarizeTransactionReceipt,
+  Fs as switchProviderChain,
+  Ls as transactionProgressView,
+  fs as transactionSequenceProgress,
+  Ks as trustedEngineRegistryForChain,
+  Hs as trustedEngineVersionForChain,
+  Vs as waitForProviderChain
 };

package/dist/engine/actions.d.ts

@@ -50,12 +50,16 @@ export type AegisEnginePositionRouterAuthorizationInput = {
  * executable quote after prerequisite receipts are mined.
  */
 export declare function readEngineAuthorizationPlan(args: AegisEngineAuthorizationPlanInput): Promise<AegisEngineAuthorizationPlan>;
+/** Explicit allowance edits; transaction preparation keeps sufficient grants. */
+type EngineAllowanceUpdateInput = AegisEngineApprovalInput & {
+    replaceAllowance?: boolean;
+};
 /** Grants only the ERC-20 allowance from the token to Permit2. */
-export declare function approveEngineTokenToPermit2(args: AegisEngineApprovalInput): Promise<{
+export declare function approveEngineTokenToPermit2(args: EngineAllowanceUpdateInput): 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 approveEnginePermit2ToRouter(args: EngineAllowanceUpdateInput): Promise<void>;
 export declare function prepareEnginePermit(args: AegisEngineApprovalInput): Promise<{
     approvalHash: Hex | null;
     permit: AegisEngineSignedPermitBatch | null;
@@ -99,3 +103,4 @@ export declare function missingEngineExecutionReason(market: {
     v4StateView?: Address;
     v4Quoter?: Address;
 }): string | null;
+export {};

package/dist/engine/borrowCollateralFloor.d.ts

@@ -0,0 +1,3 @@
+import type { AegisEngineBorrowCapacity, AegisEngineBorrowCollateralFloor } from './types.js';
+/** Compatibility boundary for hosts holding capacity snapshots from older Core versions. */
+export declare function resolveEngineBorrowCollateralFloor(capacity: AegisEngineBorrowCapacity): AegisEngineBorrowCollateralFloor;

package/dist/engine/borrowLimits.d.ts

@@ -0,0 +1,18 @@
+import type { engineSdkRuntime } from './sdkRuntime.js';
+type Sdk = typeof engineSdkRuntime;
+type Market = Parameters<Sdk['computeBorrowCapacity']>[0]['market'];
+type Vault = Parameters<Sdk['forwardFunctionNoSwap']>[0]['vault'];
+/** No-swap borrowing creates LP-shaped debt. A USD collateral × LTV ratio
+ * overstates the delivered asset, so size against the SDK's actual forward
+ * path and integer utilization headroom, in the same frame as the quote. */
+export declare function noSwapWalletBorrowLimit({ sdk, market, canonicalMarket, vault, deposit, upperBound, tauPips, slippageBps }: {
+    sdk: Pick<Sdk, 'forwardFunctionNoSwap' | 'utilizationHeadroomGammaNewLWad' | 'minDebtFloorRl'>;
+    market: Market;
+    canonicalMarket: Parameters<Sdk['forwardFunctionNoSwap']>[0]['market'];
+    vault: Vault;
+    deposit: bigint;
+    upperBound: bigint;
+    tauPips: number;
+    slippageBps: number;
+}): bigint;
+export {};

package/dist/engine/index.d.ts

@@ -1,10 +1,13 @@
 export * from './types.js';
 export * from './activityLotDisplay.js';
 export * from './dataSource.js';
+export * from './lendHistory.js';
+export * from './simpleYield.js';
 export * from './marketAdapter.js';
 export * from './registry.js';
 export * from './reads.js';
 export * from './quotes.js';
+export * from './borrowCollateralFloor.js';
 export * from './actions.js';
 export * from './positionAmounts.js';
 export * from './positionStrategy.js';

package/dist/engine/lendHistory.d.ts

@@ -0,0 +1,21 @@
+import type { AegisEngineMetricHistory } from './types.js';
+export type AegisEngineLendShareGrowthSummary = Readonly<{
+    startTimestamp: number;
+    endTimestamp: number;
+    coverageSeconds: number;
+    apyPct: number;
+    weeklyEarningsPer100Usd: number;
+    /** Historical average weekly dollars per $100, recalculated from the first
+     * usable share-price observation through each later observation. */
+    points: ReadonlyArray<Readonly<{
+        t: number;
+        v: number;
+    }>>;
+}>;
+/**
+ * Converts the Engine history plane's realized share-price growth into a
+ * player-readable historical earnings rate. This deliberately does not use
+ * `lendApyPct`: that field is the current borrower-interest model, while share
+ * growth records what actually accrued to one pool share during the window.
+ */
+export declare function summarizeEngineLendShareGrowth(history: AegisEngineMetricHistory): AegisEngineLendShareGrowthSummary | null;