@aegis-engine/core 0.9.1 → 0.10.0

package/dist/config/constants.d.ts

@@ -19,4 +19,4 @@ export declare const AEGIS_SWAP_DEFAULT_METADATA_ENDPOINT = "https://aegis.marke
 export declare const AGGREGATED_SWAP_FEE_BPS = 50;
 export declare const AGGREGATED_SWAP_FEE_RECIPIENT: `0x${string}`;
 export declare const AGGREGATED_SWAP_KYBER_ROUTER: `0x${string}`;
-export declare const AGGREGATED_SWAP_SUPPORTED_CHAIN_IDS: readonly [1];
+export declare const AGGREGATED_SWAP_SUPPORTED_CHAIN_IDS: readonly [1, 56, 130, 8453];

package/dist/encoding.d.ts

@@ -49,6 +49,8 @@ export declare function buildExactOutSwapTransaction(args: {
     poolKey: AegisPoolKey;
     zeroForOne: boolean;
     amountOut: bigint;
+    /** Required net payout. Defaults to gross amountOut minus the configured fee. */
+    amountOutNet?: bigint;
     amountInMaximum: bigint;
     recipient: Address;
     deadline: bigint;

package/dist/index.d.ts

@@ -4,12 +4,14 @@ export { assertUint128, buildExactInSwapTransaction, buildExactOutSwapTransactio
 export type { BuiltSwapTransaction, ExecutionBatch, PermitBatch, PermitDetails, SignedPermitBatch, SwapOutputFee } from './encoding.js';
 export { getZeroForOne, outputFeeForQuote, quoteSpendAmount, reconcileSubmitQuote, sameQuote } from './quote.js';
 export type { DirectSwapQuote, ReconciledSubmitQuote, SwapQuoteMode } from './quote.js';
-export { AggregatedSwapBuildMismatchError, aggregatedSwapErrorMessage, fetchAggregatedSwapQuote } from './quote/aggregatedSwapQuote.js';
+export { AggregatedSwapBuildMismatchError, aggregatedSwapErrorMessage, assertAggregatedQuoteLiquidity, fetchAggregatedSwapQuote } from './quote/aggregatedSwapQuote.js';
+export { NoAegisRouteError, assertAegisOnlyRouteLegs } from './quote/routeProvider.js';
+export type { NoAegisRouteReason } from './quote/routeProvider.js';
 export type { AggregatedSwapExecutionIntent } from './quote/aggregatedSwapQuote.js';
 export { AggregatedSwapCalldataError } from './quote/kyberCalldata.js';
 export type { AggregatedSwapQuote, AggregatedSwapRoute, HopInfo } from './types/aggregatedSwap.js';
-export { KyberSwapApiError, KyberSwapContractError, KyberSwapResourceLimitError, buildKyberSwapRoute, fetchKyberSwapRoute, isRetryableKyberSwapError } from './services/kyberSwap.js';
-export type { KyberSwapBuild, KyberSwapError, KyberSwapFeeParams, KyberSwapRoute, KyberSwapRouteLeg, KyberSwapRouteSummary } from './services/kyberSwap.js';
+export { KYBER_AEGIS_LIQUIDITY_SOURCE, KyberSwapApiError, KyberSwapContractError, KyberSwapResourceLimitError, buildKyberSwapRoute, fetchKyberSwapRoute, isRetryableKyberSwapError } from './services/kyberSwap.js';
+export type { AggregatedSwapLiquiditySources, KyberSwapBuild, KyberSwapError, KyberSwapFeeParams, KyberSwapRoute, KyberSwapRouteLeg, KyberSwapRouteSummary } from './services/kyberSwap.js';
 export { approveErc20Spender, approveErc20ToPermit2, approvePermit2ToRouter, buildSignedPermitBatch, DEFAULT_PERMIT_EXPIRATION_SECONDS, hasUsablePermit2Allowance, isUnlimitedErc20Approval, isUnlimitedPermit2Approval, MAX_UINT160, MAX_UINT256, PERMIT2_FAR_FUTURE_EXPIRATION, readErc20Allowance, readPermit2RouterAllowance, SWAP_TX_DEADLINE_SECONDS, UNLIMITED_ERC20_FLOOR, UNLIMITED_PERMIT2_FLOOR } from './permit.js';
 export { fetchGlobalTokenMetadata, resolveTokenIconUrl } from './metadata.js';
 export type { AegisSwapGlobalTokenMetadata, TokenMetadataByAddress } from './metadata.js';

package/dist/quote/aggregatedSwapQuote.d.ts

@@ -1,6 +1,7 @@
 import { type Address, type PublicClient } from 'viem';
 import { type AegisSwapToken } from '../config/index.js';
 import { UserFacingError } from '../errors.js';
+import { type AggregatedSwapLiquiditySources } from '../services/kyberSwap.js';
 import type { AggregatedSwapQuote } from '../types/aggregatedSwap.js';
 export declare function aggregatedSwapErrorMessage(error: unknown, fallbackMessage: string): string;
 export declare class AggregatedSwapBuildMismatchError extends UserFacingError {
@@ -18,4 +19,12 @@ export type AggregatedSwapExecutionIntent = Readonly<{
     reviewedAmountOutMinimum: bigint;
 }>;
 export declare function assertAggregatedRouterTrusted(router: Address, chainId: number): void;
-export declare function fetchAggregatedSwapQuote(inputToken: AegisSwapToken, outputToken: AegisSwapToken, amount: bigint, slippageBps: number, mode?: 'exactIn' | 'exactOut', account?: Address | null, signal?: AbortSignal, _publicClient?: PublicClient, executionIntent?: AggregatedSwapExecutionIntent): Promise<AggregatedSwapQuote>;
+/**
+ * Re-checks, immediately before signing, that an executable quote was built
+ * under Aegis-only routing and that every hop it reports is an Aegis pool.
+ * Host-constructed quotes without the commitment fail closed.
+ */
+export declare function assertAggregatedQuoteLiquidity(quote: Pick<AggregatedSwapQuote, 'hops' | 'liquiditySources'>, liquiditySources: AggregatedSwapLiquiditySources): void;
+export declare function fetchAggregatedSwapQuote(inputToken: AegisSwapToken, outputToken: AegisSwapToken, amount: bigint, slippageBps: number, mode?: 'exactIn' | 'exactOut', account?: Address | null, signal?: AbortSignal, _publicClient?: PublicClient, executionIntent?: AggregatedSwapExecutionIntent, options?: {
+    liquiditySources?: AggregatedSwapLiquiditySources;
+}): Promise<AggregatedSwapQuote>;

package/dist/quote/routeProvider.d.ts

@@ -0,0 +1,54 @@
+import type { Address } from 'viem';
+import { UserFacingError } from '../errors.js';
+import { type AggregatedSwapLiquiditySources, type KyberSwapBuild, type KyberSwapFeeParams, type KyberSwapRoute, type KyberSwapRouteSummary } from '../services/kyberSwap.js';
+import { assertKyberCalldataMatchesQuote } from './kyberCalldata.js';
+export type NoAegisRouteReason = 'no-route' | 'non-aegis-leg';
+/**
+ * Aegis-only routing found no executable path. `reason` separates "the
+ * provider has no all-Aegis path" from "the provider answered with a path that
+ * leaves Aegis pools", which is refused rather than trusted.
+ */
+export declare class NoAegisRouteError extends UserFacingError {
+    readonly reason: NoAegisRouteReason;
+    readonly detail?: string;
+    constructor(reason: NoAegisRouteReason, detail?: string);
+}
+/**
+ * Fails closed unless the route is non-empty and every hop of every split is
+ * tagged with Kyber's Aegis source. The tag is Kyber's own attribution; there
+ * is deliberately no pool-id allowlist on top of it.
+ */
+export declare function assertAegisOnlyRouteLegs(route: KyberSwapRouteSummary['route']): void;
+/** Maps a provider "no route under these sources" failure to NoAegisRouteError. */
+export declare function toNoAegisRouteError(error: unknown): unknown;
+/**
+ * Internal seam behind fetchAggregatedSwapQuote: quote → build → validate.
+ * KyberSwap is the only implementation. Another provider (for example an
+ * in-house Ink router) slots in by returning the same route/build shapes and
+ * its own router-specific calldata check, without UI changes.
+ */
+export type AggregatedRouteProvider = {
+    readonly id: string;
+    trustedRouter(chainId: number): Address | undefined;
+    quote(args: {
+        chainId: number;
+        tokenIn: Address;
+        tokenOut: Address;
+        amountIn: bigint;
+        origin?: Address | null;
+        fee: KyberSwapFeeParams | null;
+        liquiditySources: AggregatedSwapLiquiditySources;
+        signal?: AbortSignal;
+    }): Promise<KyberSwapRoute>;
+    build(args: {
+        chainId: number;
+        route: KyberSwapRoute;
+        sender: Address;
+        recipient: Address;
+        slippageBps: number;
+        signal?: AbortSignal;
+    }): Promise<KyberSwapBuild>;
+    validateRoute(route: KyberSwapRoute, liquiditySources: AggregatedSwapLiquiditySources): void;
+    validateCalldata(args: Parameters<typeof assertKyberCalldataMatchesQuote>[0]): void;
+};
+export declare function aggregatedRouteProviderForChain(chainId: number): AggregatedRouteProvider;

package/dist/quote.d.ts

@@ -15,13 +15,13 @@ export type DirectSwapQuote = {
      * Swap-action output floor, enforced on-chain. Semantics differ by mode:
      * - exactIn: gross floor sized so the user still nets `userAmountOutMinimum`
      *   after the fee portion is taken.
-     * - exactOut: equals `grossAmountOut` (output is fixed; the on-chain
-     *   protection is `amountInMaximum`). Informational only.
+     * - exactOut: equals `grossAmountOut`; the encoder separately requires the
+     *   net payout after fees as well as enforcing `amountInMaximum`.
      */
     amountOutMinimum: bigint;
     /** exactOut: input ceiling enforced on-chain. exactIn: equals `amountIn`. */
     amountInMaximum: bigint;
-    /** Minimum the user nets after slippage and fee. Display/reconciliation value. */
+    /** Minimum net receipt after slippage and fee; enforced by the swap recipe. */
     userAmountOutMinimum: bigint;
     /** Estimated widget fee in output currency (exact for exactOut, quote-time estimate for exactIn). */
     feeAmount: bigint;

package/dist/{sdkRuntime-CIhmlpGl.js → sdkRuntime-UJvZ2vPs.js}

@@ -3,7 +3,7 @@ var _s = (e, t, n) => t in e ? Ps(e, t, { enumerable: !0, configurable: !0, writ
 var ie = (e, t, n) => _s(e, typeof t != "symbol" ? t + "" : t, n);
 import { keccak256 as Et, zeroAddress as Ee, erc721Abi as Wt, hashTypedData as Cs, isAddress as on, erc20Abi as Or, encodeFunctionData as Dn, BaseError as ra, ContractFunctionRevertedError as Qi, numberToHex as Ms, encodeAbiParameters as Xi, parseAbiParameters as Rs, RpcRequestError as Zi, isHex as Ji, decodeErrorResult as Ss, ExecutionRevertedError as Ga, getEventSelector as Ze, getAbiItem as Je, parseAbi as aa, toEventSelector as Os } from "viem";
 import "viem/actions";
-import { X as ja, J as Ka } from "./transactionHistory-BhNsDpNJ.js";
+import { X as ja, J as Ka } from "./transactionHistory-D3PDVGkr.js";
 class f extends Array {
   constructor(t, n) {
     if (super(t), this.sign = n, t > f.__kMaxLength) throw new RangeError("Maximum BigInt size exceeded");

package/dist/services/kyberSwap.d.ts

@@ -55,6 +55,14 @@ export type KyberSwapBuild = {
      */
     deadline?: number;
 };
+/**
+ * Liquidity the aggregator may route through. `'aegis'` restricts Kyber to the
+ * Aegis-hooked Uniswap v4 pools it indexes as {@link KYBER_AEGIS_LIQUIDITY_SOURCE};
+ * `'any'` leaves source selection to Kyber.
+ */
+export type AggregatedSwapLiquiditySources = 'aegis' | 'any';
+/** Kyber's liquidity-source id for Uniswap v4 pools that use the Aegis hook. */
+export declare const KYBER_AEGIS_LIQUIDITY_SOURCE = "uniswap-v4-aegis";
 export type KyberSwapError = {
     code?: number;
     message?: string;
@@ -93,13 +101,15 @@ export declare class KyberSwapResourceLimitError extends Error {
     });
 }
 export declare function isRetryableKyberSwapError(error: unknown): boolean;
-export declare function fetchKyberSwapRoute({ tokenIn, tokenOut, amountIn, chainId, origin, fee, signal, timeoutMs }: {
+export declare function fetchKyberSwapRoute({ tokenIn, tokenOut, amountIn, chainId, origin, fee, liquiditySources, signal, timeoutMs }: {
     tokenIn: Address;
     tokenOut: Address;
     amountIn: string;
     chainId?: number;
     origin?: Address | null;
     fee?: KyberSwapFeeParams | null;
+    /** `'aegis'` sends `includedSources=uniswap-v4-aegis`; defaults to `'any'`. */
+    liquiditySources?: AggregatedSwapLiquiditySources;
     signal?: AbortSignal;
     /** Abort after this many ms (composes with `signal`); defaults to 20s. */
     timeoutMs?: number;