@aegis-engine/core 0.9.2 → 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/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/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;

package/dist/types/aggregatedSwap.d.ts

@@ -1,5 +1,6 @@
 import type { Address, Hex } from 'viem';
 import type { AegisSwapToken } from '../config/index.js';
+import type { AggregatedSwapLiquiditySources } from '../services/kyberSwap.js';
 export type HopInfo = {
     dex: string;
     inputToken: AegisSwapToken;
@@ -13,6 +14,12 @@ export type AggregatedSwapQuote = {
     amountOut: bigint;
     gasEstimate: bigint;
     hops: HopInfo[];
+    /**
+     * Liquidity set the route was requested and validated under. `'aegis'`
+     * quotes passed the all-Aegis leg check; execution in Aegis-only mode
+     * re-checks it (and every hop) before signing.
+     */
+    liquiditySources?: AggregatedSwapLiquiditySources;
     routerAddress: Address;
     calldata: Hex | null;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aegis-engine/core",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "React-free Aegis Swap and Engine quoting, risk, approval, and execution operations.",
   "license": "MIT",
   "type": "module",