@aegis-engine/core 0.2.0 → 0.3.0

package/dist/errors.d.ts

@@ -1,3 +1,13 @@
+import type { Hex } from 'viem';
+export declare class UserFacingError extends Error {
+    constructor(message: string);
+}
+export declare class TransactionReceiptTimeoutError extends UserFacingError {
+    readonly hash: Hex;
+    constructor({ hash }: {
+        hash: Hex;
+    });
+}
 export declare function isUserRejectedError(error: unknown): boolean;
 export declare const USER_REJECTED_MESSAGE = "Request rejected.";
 export declare function errorMessage(error: unknown, fallbackMessage: string): string;

package/dist/historicalPrices.d.ts

@@ -0,0 +1,78 @@
+import { type Address } from 'viem';
+import { z } from 'zod';
+export type AegisTokenPriceHistoryWindow = '7d' | '30d' | '90d' | '180d';
+export type AegisTokenPriceHistoryStatus = 'ready' | 'warming_up' | 'no_data';
+export type AegisTokenPricePoint = {
+    /** Unix timestamp in seconds. */
+    timestamp: number;
+    /** USD price observed at this timestamp. */
+    priceUsd: number;
+};
+export type AegisTokenPriceHistory = {
+    networkType: 'evm';
+    chainId: number;
+    /** Caller-facing address. Native-token sentinels are retained here. */
+    tokenAddress: Address;
+    symbol: string | null;
+    resolution: '12h';
+    window: AegisTokenPriceHistoryWindow;
+    status: AegisTokenPriceHistoryStatus;
+    points: AegisTokenPricePoint[];
+    pointCount: number;
+    updatedAt: string | null;
+};
+export declare const tokenPriceHistoryRestResponseSchema: z.ZodObject<{
+    chainId: z.ZodNumber;
+    address: z.ZodString;
+    symbol: z.ZodNullable<z.ZodString>;
+    resolution: z.ZodLiteral<"12h">;
+    window: z.ZodEnum<{
+        "7d": "7d";
+        "30d": "30d";
+        "90d": "90d";
+        "180d": "180d";
+    }>;
+    status: z.ZodEnum<{
+        ready: "ready";
+        warming_up: "warming_up";
+        no_data: "no_data";
+    }>;
+    points: z.ZodArray<z.ZodObject<{
+        t: z.ZodNumber;
+        p: z.ZodNumber;
+    }, z.core.$strict>>;
+    pointCount: z.ZodNumber;
+    updatedAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strict>;
+export declare function clearTokenPriceHistoryCache(): void;
+/**
+ * Synchronous view of the shared TTL cache: the settled, unexpired history the
+ * same-argument {@link fetchTokenPriceHistory} would resolve from cache, else
+ * null. Lets a render seed itself in the same commit instead of waiting a
+ * microtask for the cached promise to replay.
+ */
+export declare function peekTokenPriceHistory(args: {
+    baseUrl: string;
+    chainId: number;
+    tokenAddress: Address;
+    window?: AegisTokenPriceHistoryWindow;
+    headers?: Record<string, string>;
+}): AegisTokenPriceHistory | null;
+/**
+ * Fetches one token's display-only USD history from the public REST backend.
+ * Native-token sentinels are looked up under the zero address used by the
+ * writer, while the returned domain object retains the caller's token address.
+ * Concurrent callers join one shared in-flight load per cache key, so the
+ * consumer's signal wraps the shared promise instead of cancelling the fetch
+ * for other consumers.
+ */
+export declare function fetchTokenPriceHistory(args: {
+    baseUrl: string;
+    chainId: number;
+    tokenAddress: Address;
+    window?: AegisTokenPriceHistoryWindow;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+    /** Abort after this many ms (composes with `signal`); defaults to 15s. */
+    timeoutMs?: number;
+}): Promise<AegisTokenPriceHistory | null>;

package/dist/index.d.ts

@@ -1,20 +1,24 @@
-export { AEGIS_DYNAMIC_FEE_FLAG, AEGIS_SWAP_CHAINS, AEGIS_SWAP_CHAIN_ID, AEGIS_SWAP_DEFAULT_FEE_BPS, AEGIS_SWAP_DEFAULT_FEE_RECIPIENT, AEGIS_SWAP_DEFAULT_METADATA_ENDPOINT, AEGIS_SWAP_DEFAULT_RPC_URLS, AEGIS_SWAP_HOOK, AEGIS_SWAP_MAINNET_CHAIN, AEGIS_SWAP_MAINNET_UNISWAP_V4_CONTRACTS, AEGIS_SWAP_PERMIT2, AEGIS_SWAP_ROUTER, AEGIS_SWAP_TOKENS, AEGIS_SWAP_V4_QUOTER, AGGREGATED_SWAP_CURATED_TOKENS, AGGREGATED_SWAP_DEFAULT_TOKEN_LIST, AGGREGATED_SWAP_DEFAULT_TOKENS, AGGREGATED_SWAP_TOKEN_PRESETS, AGGREGATED_SWAP_WOLFGAME_TOKEN_LIST, AGGREGATED_SWAP_WOLFGAME_TOKENS, UNISWAP_V4_CONTRACTS_BY_CHAIN, createAegisSwapChainConfig, createAegisSwapChains, createAegisSwapMarketsFromPools, createAegisSwapPoolMarket, createAegisSwapUniswapV4Contracts, getExplorerUrl } from './config/index.js';
+export { AEGIS_DYNAMIC_FEE_FLAG, AEGIS_SWAP_CHAINS, AEGIS_SWAP_CHAIN_ID, AEGIS_SWAP_DEFAULT_FEE_BPS, AEGIS_SWAP_DEFAULT_FEE_RECIPIENT, AEGIS_SWAP_DEFAULT_METADATA_ENDPOINT, AEGIS_SWAP_DEFAULT_RPC_URLS, AEGIS_SWAP_HOOK, AEGIS_SWAP_MAINNET_CHAIN, AEGIS_SWAP_MAINNET_UNISWAP_V4_CONTRACTS, AEGIS_SWAP_PERMIT2, AEGIS_SWAP_ROUTER, AEGIS_SWAP_TOKENS, AEGIS_SWAP_TRUSTED_ROUTERS_BY_CHAIN, AEGIS_SWAP_V4_QUOTER, AGGREGATED_SWAP_CURATED_TOKENS, AGGREGATED_SWAP_DEFAULT_TOKEN_LIST, AGGREGATED_SWAP_DEFAULT_TOKENS, AGGREGATED_SWAP_SUPPORTED_CHAIN_IDS, AGGREGATED_SWAP_TOKEN_PRESETS, AGGREGATED_SWAP_WOLFGAME_TOKEN_LIST, AGGREGATED_SWAP_WOLFGAME_TOKENS, UNISWAP_V4_CONTRACTS_BY_CHAIN, createAegisSwapChainConfig, createAegisSwapChains, createAegisSwapMarketsFromPools, createAegisSwapPoolMarket, createAegisSwapUniswapV4Contracts, getExplorerUrl } from './config/index.js';
 export type { AegisPoolKey, AegisSwapBuiltInTokenSymbol, AegisSwapChainConfig, AegisSwapChainConfigInput, AegisSwapFeeConfig, AegisSwapMarket, AegisSwapPoolConfig, AegisSwapToken, AegisSwapTokenSymbol, AegisSwapUniswapV4Contracts, AegisSwapUniswapV4ContractsInput, AggregatedSwapDefaultTokenSymbol, AggregatedSwapToken, AggregatedSwapTokenSymbol, AggregatedSwapWolfGameTokenSymbol } from './config/index.js';
 export { assertUint128, buildExactInSwapTransaction, buildExactOutSwapTransaction, computePoolId, MAX_UINT128 } from './encoding.js';
 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 { aggregatedSwapErrorMessage, fetchAggregatedSwapQuote } from './quote/aggregatedSwapQuote.js';
+export { AggregatedSwapBuildMismatchError, aggregatedSwapErrorMessage, fetchAggregatedSwapQuote } from './quote/aggregatedSwapQuote.js';
+export { AggregatedSwapCalldataError } from './quote/kyberCalldata.js';
 export type { AggregatedSwapQuote, AggregatedSwapRoute, HopInfo } from './types/aggregatedSwap.js';
-export { KyberSwapApiError, buildKyberSwapRoute, fetchKyberSwapRoute, isRetryableKyberSwapError } from './services/kyberSwap.js';
+export { KyberSwapApiError, KyberSwapContractError, buildKyberSwapRoute, fetchKyberSwapRoute, isRetryableKyberSwapError } from './services/kyberSwap.js';
 export type { KyberSwapBuild, KyberSwapError, KyberSwapFeeParams, KyberSwapRoute, KyberSwapRouteLeg, KyberSwapRouteSummary } from './services/kyberSwap.js';
 export { approveErc20Spender, approveErc20ToPermit2, approvePermit2ToRouter, buildSignedPermitBatch, DEFAULT_PERMIT_EXPIRATION_SECONDS, MAX_UINT160, MAX_UINT256, PERMIT2_FAR_FUTURE_EXPIRATION, readErc20Allowance, readPermit2RouterAllowance, SWAP_TX_DEADLINE_SECONDS } from './permit.js';
-export { fetchGlobalTokenMetadata, getIchiIconGuess, resolveTokenIconUrl } from './metadata.js';
+export { fetchGlobalTokenMetadata, resolveTokenIconUrl } from './metadata.js';
 export type { AegisSwapGlobalTokenMetadata, TokenMetadataByAddress } from './metadata.js';
+export { clearTokenPriceHistoryCache, fetchTokenPriceHistory, peekTokenPriceHistory } from './historicalPrices.js';
+export type { AegisTokenPriceHistory, AegisTokenPriceHistoryStatus, AegisTokenPriceHistoryWindow, AegisTokenPricePoint } from './historicalPrices.js';
 export { createSwapPublicClient, getInjectedProvider, getProviderAccount, getProviderChainId, isEip1193Provider, normalizeAccount, normalizeWalletConnection, requestProviderAccount, subscribeProvider, switchProviderChain } from './wallet.js';
 export type { AegisSwapProviderResolver, AegisSwapWalletConnection, Eip1193Provider, ProviderChainConfig } from './wallet.js';
 export { approveDirectPoolSwapInput, DirectPoolSwapPriceMovedError, executeDirectPoolSwap, fetchDirectPoolSwapQuote } from './actions/directPoolSwap.js';
 export type { DirectPoolSwapApprovalResult } from './actions/directPoolSwap.js';
+export { isNativeAssetAddress } from './address.js';
 export { approveKyberSwapInput, executeKyberSwap, isNativeToken, KyberSwapPriceMovedError, NATIVE_TOKEN_ADDRESS } from './actions/kyberSwap.js';
 export type { KyberSwapApprovalResult } from './actions/kyberSwap.js';
 export { ensureWalletChain, resolveWalletSession, waitForProviderChain } from './actions/wallet.js';
@@ -22,13 +26,14 @@ export type { AegisSwapActionCallbacks, AegisSwapActionResult } from './actions/
 export { estimateSwapGasWithBuffer } from './swap/gas.js';
 export type { SwapGasRequest } from './swap/gas.js';
 export type { AegisSwapApprovalMode, AegisSwapSubmitDetails, WalletSession } from './swap/types.js';
-export { errorMessage, isUserRejectedError } from './errors.js';
+export { errorMessage, isUserRejectedError, TransactionReceiptTimeoutError, UserFacingError } from './errors.js';
 export { isBusy, transactionProgressView } from './transactionProgress.js';
 export type { AegisSwapReceiptSummary, AegisSwapStatusSnapshot, AegisSwapWalletPromptProgress, SubmitStatus, TransactionProgressState, TransactionProgressView } from './transactionProgress.js';
 export { isDocumentVisible, pollUntil, retryOnError } from './polling.js';
-export { AEGIS_BACKEND_PROD_BASE_URL, AegisBackendApiError, AegisBackendContractError, createAegisBackendApiClient, isRetryableAegisBackendApiError } from './contract/backendClient.js';
-export type { AegisBackendAddressAllowlist, AegisBackendAllowlistsByChain, AegisBackendApiClient, AegisBackendApiClientOptions, AegisBackendChain, AegisBackendConfig, AegisBackendContractRegistry, AegisBackendContractsByChain, AegisBackendFeeConfig, AegisBackendMarket, AegisBackendMarketMetrics, AegisBackendMarketStatus, AegisBackendQuoteDefaults, AegisBackendQuoteMode, AegisBackendRequestOptions, AegisBackendSwapProvider, AegisBackendSwapQuoteRequest, AegisBackendSwapQuoteResponse, AegisBackendToken } from './contract/backendClient.js';
+export { AEGIS_BACKEND_PROD_BASE_URL, AegisBackendApiError, AegisBackendContractError, createAegisBackendApiClient, isRetryableAegisBackendApiError, normalizeAegisBackendBaseUrl } from './contract/backendClient.js';
+export type { AegisBackendAddressAllowlist, AegisBackendAllowlistsByChain, AegisBackendApiClient, AegisBackendApiClientOptions, AegisBackendChain, AegisBackendConfig, AegisBackendContractRegistry, AegisBackendContractsByChain, AegisBackendFeeConfig, AegisBackendMarket, AegisBackendMarketMetrics, AegisBackendMarketStatus, AegisBackendOpenApiComponents, AegisBackendOpenApiPaths, AegisBackendQuoteDefaults, AegisBackendQuoteMode, AegisBackendRequestOptions, AegisBackendSwapProvider, AegisBackendSwapQuoteRequest, AegisBackendSwapQuoteResponse, AegisBackendToken } from './contract/backendClient.js';
 export { backendTokenToAegisSwapToken, backendTokensToAegisSwapTokens, createAegisSwapChainsFromBackendConfig, createAegisSwapPoolsFromBackendMarkets } from './backendAdapters.js';
-export type { AegisBackendChainOptions } from './backendAdapters.js';
+export type { AegisBackendAdapterSkip, AegisBackendAdapterSkipHandler, AegisBackendChainOptions } from './backendAdapters.js';
 export { aegisBackendAddressAllowlistSchema, aegisBackendAddressSchema, aegisBackendAllowlistsByChainSchema, aegisBackendChainSchema, aegisBackendChainIdSchema, aegisBackendConfigSchema, aegisBackendContractsByChainSchema, aegisBackendContractRegistrySchema, aegisBackendDecimalStringSchema, aegisBackendFeeConfigSchema, aegisBackendHealthResponseSchema, aegisBackendHexSchema, aegisBackendIsoDateTimeSchema, aegisBackendMarketMetricsSchema, aegisBackendMarketSchema, aegisBackendMarketStatusSchema, aegisBackendMarketsResponseSchema, aegisBackendQuoteDefaultsSchema, aegisBackendQuoteModeSchema, aegisBackendSwapProviderSchema, aegisBackendSwapQuoteRequestSchema, aegisBackendSwapQuoteResponseSchema, aegisBackendTokenSchema, aegisBackendTokensResponseSchema, aegisPoolKeySchema, AegisContractGuardError, assertCalldataHash, assertChainMatches, assertQuoteFresh, assertRouterAllowlisted, assertSpenderAllowlisted } from './contract/index.js';
 export type { AegisContractGuardCode } from './contract/index.js';
+export * from './engine/index.js';

package/dist/internal/requestSignal.d.ts

@@ -0,0 +1,9 @@
+export type ComposedRequestSignal = {
+    signal: AbortSignal | undefined;
+    cleanup: () => void;
+};
+export declare function composeRequestSignal(options: {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    timeoutMessage: string;
+}): ComposedRequestSignal;

package/dist/internal/ttlCache.d.ts

@@ -0,0 +1,19 @@
+export type TtlPromiseCache<T> = {
+    read(key: string, load: () => Promise<T>, force?: boolean): Promise<T>;
+    /** Resolved value of a settled, unexpired entry — the synchronous view a
+     *  render can use without waiting a microtask for the cached promise. */
+    peek(key: string): T | undefined;
+    clear(): void;
+};
+export declare function createTtlPromiseCache<T>(config: {
+    ttlMs: number;
+    /** Oldest-first eviction bound; omit for an unbounded cache. */
+    maxEntries?: number;
+}): TtlPromiseCache<T>;
+/** Canonical cache-key serialization for optional request headers. */
+export declare function stableHeadersKey(headers?: Record<string, string>): string;
+/**
+ * Wraps a shared in-flight promise for one consumer: an abort rejects only
+ * that consumer's view, never the underlying load other consumers still join.
+ */
+export declare function withAbort<T>(promise: Promise<T>, signal: AbortSignal | undefined, abortMessage: string): Promise<T>;

package/dist/metadata.d.ts

@@ -8,6 +8,8 @@ export type AegisSwapGlobalTokenMetadata = {
     fullName: string | null;
     decimals: number | null;
     iconURL: string | null;
+    /** USD price the metadata service tracks; lets consumers refresh stale priceUsd. */
+    price?: number | null;
 };
 export declare function getIchiIconGuess(symbol: string | null | undefined): string | null;
 export type TokenMetadataByAddress = Record<string, AegisSwapGlobalTokenMetadata>;
@@ -22,4 +24,6 @@ export declare function fetchGlobalTokenMetadata(args: {
     chainId: number;
     addresses: Address[];
     signal?: AbortSignal;
+    /** Abort after this many ms (composes with `signal`); defaults to 15s. */
+    timeoutMs?: number;
 }): Promise<Map<string, AegisSwapGlobalTokenMetadata>>;

package/dist/permit.d.ts

@@ -48,6 +48,7 @@ export declare function readPermit2RouterAllowance(args: {
     token: Address;
     router: Address;
 }): Promise<readonly [amount: bigint, expiration: number, nonce: number]>;
+export declare function hasUsablePermit2Allowance(allowance: Awaited<ReturnType<typeof readPermit2RouterAllowance>>, amount: bigint): boolean;
 export declare function buildSignedPermitBatch(args: {
     provider: Eip1193Provider;
     publicClient: PublicClient;

package/dist/quote/aggregatedSwapQuote.d.ts

@@ -1,5 +1,17 @@
 import { type Address, type PublicClient } from 'viem';
 import { type AegisSwapToken } from '../config/index.js';
+import { UserFacingError } from '../errors.js';
 import type { AggregatedSwapQuote } from '../types/aggregatedSwap.js';
 export declare function aggregatedSwapErrorMessage(error: unknown, fallbackMessage: string): string;
+export declare class AggregatedSwapBuildMismatchError extends UserFacingError {
+    readonly field: 'amountIn' | 'amountOut';
+    readonly expected: bigint;
+    readonly actual: bigint;
+    constructor({ field, expected, actual }: {
+        field: 'amountIn' | 'amountOut';
+        expected: bigint;
+        actual: 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): Promise<AggregatedSwapQuote>;

package/dist/quote/kyberCalldata.d.ts

@@ -0,0 +1,211 @@
+import { type Address, type Hex } from 'viem';
+import { UserFacingError } from '../errors.js';
+export declare const KYBER_META_AGGREGATION_ROUTER_V2_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "swap";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly name: "execution";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "callTarget";
+            readonly type: "address";
+        }, {
+            readonly name: "approveTarget";
+            readonly type: "address";
+        }, {
+            readonly name: "targetData";
+            readonly type: "bytes";
+        }, {
+            readonly name: "desc";
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly name: "srcToken";
+                readonly type: "address";
+            }, {
+                readonly name: "dstToken";
+                readonly type: "address";
+            }, {
+                readonly name: "srcReceivers";
+                readonly type: "address[]";
+            }, {
+                readonly name: "srcAmounts";
+                readonly type: "uint256[]";
+            }, {
+                readonly name: "feeReceivers";
+                readonly type: "address[]";
+            }, {
+                readonly name: "feeAmounts";
+                readonly type: "uint256[]";
+            }, {
+                readonly name: "dstReceiver";
+                readonly type: "address";
+            }, {
+                readonly name: "amount";
+                readonly type: "uint256";
+            }, {
+                readonly name: "minReturnAmount";
+                readonly type: "uint256";
+            }, {
+                readonly name: "flags";
+                readonly type: "uint256";
+            }, {
+                readonly name: "permit";
+                readonly type: "bytes";
+            }];
+        }, {
+            readonly name: "clientData";
+            readonly type: "bytes";
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "returnAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "gasUsed";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "swapGeneric";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly name: "execution";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "callTarget";
+            readonly type: "address";
+        }, {
+            readonly name: "approveTarget";
+            readonly type: "address";
+        }, {
+            readonly name: "targetData";
+            readonly type: "bytes";
+        }, {
+            readonly name: "desc";
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly name: "srcToken";
+                readonly type: "address";
+            }, {
+                readonly name: "dstToken";
+                readonly type: "address";
+            }, {
+                readonly name: "srcReceivers";
+                readonly type: "address[]";
+            }, {
+                readonly name: "srcAmounts";
+                readonly type: "uint256[]";
+            }, {
+                readonly name: "feeReceivers";
+                readonly type: "address[]";
+            }, {
+                readonly name: "feeAmounts";
+                readonly type: "uint256[]";
+            }, {
+                readonly name: "dstReceiver";
+                readonly type: "address";
+            }, {
+                readonly name: "amount";
+                readonly type: "uint256";
+            }, {
+                readonly name: "minReturnAmount";
+                readonly type: "uint256";
+            }, {
+                readonly name: "flags";
+                readonly type: "uint256";
+            }, {
+                readonly name: "permit";
+                readonly type: "bytes";
+            }];
+        }, {
+            readonly name: "clientData";
+            readonly type: "bytes";
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "returnAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "gasUsed";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "swapSimpleMode";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "caller";
+        readonly type: "address";
+    }, {
+        readonly name: "desc";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "srcToken";
+            readonly type: "address";
+        }, {
+            readonly name: "dstToken";
+            readonly type: "address";
+        }, {
+            readonly name: "srcReceivers";
+            readonly type: "address[]";
+        }, {
+            readonly name: "srcAmounts";
+            readonly type: "uint256[]";
+        }, {
+            readonly name: "feeReceivers";
+            readonly type: "address[]";
+        }, {
+            readonly name: "feeAmounts";
+            readonly type: "uint256[]";
+        }, {
+            readonly name: "dstReceiver";
+            readonly type: "address";
+        }, {
+            readonly name: "amount";
+            readonly type: "uint256";
+        }, {
+            readonly name: "minReturnAmount";
+            readonly type: "uint256";
+        }, {
+            readonly name: "flags";
+            readonly type: "uint256";
+        }, {
+            readonly name: "permit";
+            readonly type: "bytes";
+        }];
+    }, {
+        readonly name: "executorData";
+        readonly type: "bytes";
+    }, {
+        readonly name: "clientData";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "returnAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "gasUsed";
+        readonly type: "uint256";
+    }];
+}];
+export declare class AggregatedSwapCalldataError extends UserFacingError {
+    readonly reason: string;
+    constructor(reason: string);
+}
+/**
+ * Decodes the /route/build calldata and asserts its settlement invariants
+ * match the quote the user reviewed: tokens, pulled amount, payout receiver,
+ * the embedded slippage floor, and (for fee-charged routes) that every fee
+ * receiver is the pinned recipient. Fails closed on unknown entrypoints.
+ */
+export declare function assertKyberCalldataMatchesQuote(args: {
+    data: Hex;
+    inputToken: Address;
+    outputToken: Address;
+    amount: bigint;
+    recipient: Address;
+    /** Lowest acceptable value for the calldata's embedded minReturnAmount. */
+    minReturnFloor: bigint;
+    feeRecipient: Address | null;
+}): void;

package/dist/quote.d.ts

@@ -29,6 +29,7 @@ export type DirectSwapQuote = {
     feeRecipient: Address | null;
     gasEstimate: bigint;
 };
+export declare function outputSlippageFloor(amountOut: bigint, slippageBps: number): bigint;
 export declare function getZeroForOne(poolKey: AegisPoolKey, tokenIn: AegisSwapToken): boolean;
 export declare function fetchDirectSwapQuote(args: {
     publicClient: PublicClient;