@aegis-engine/core 0.7.0 → 0.8.1

package/dist/index.d.ts

@@ -1,37 +1,40 @@
-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 { AEGIS_DYNAMIC_FEE_FLAG, AEGIS_SWAP_BSC_CHAIN, AEGIS_SWAP_BSC_CHAIN_ID, AEGIS_SWAP_BSC_HOOK, AEGIS_SWAP_BSC_ROUTER, AEGIS_SWAP_BSC_RPC_URLS, AEGIS_SWAP_BSC_TOKENS, 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, AegisSwapBscTokenSymbol, 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 { AggregatedSwapBuildMismatchError, aggregatedSwapErrorMessage, fetchAggregatedSwapQuote } from './quote/aggregatedSwapQuote.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, buildKyberSwapRoute, fetchKyberSwapRoute, isRetryableKyberSwapError } from './services/kyberSwap.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 { 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 { 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';
-export { clearTokenPriceHistoryCache, fetchTokenPriceHistory, peekTokenPriceHistory } from './historicalPrices.js';
+export { clearTokenPriceHistoryCache, fetchTokenPriceHistory, peekTokenPriceHistory, tokenPriceHistoryRestResponseSchema } 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 { createSwapPublicClient, getInjectedProvider, getProviderAccount, getProviderChainId, isEip1193Provider, normalizeAccount, normalizeWalletConnection, requestProviderAccount, SDK_RPC_MULTICALL_RULE_ID, 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 { erc20ApprovalRequest, requiresErc20ApprovalReset } from './actions/allowance.js';
 export { ensureWalletChain, resolveWalletSession, waitForProviderChain } from './actions/wallet.js';
 export type { AegisSwapActionCallbacks, AegisSwapActionResult, AegisSwapApprovalProgress, AegisSwapApprovalRequest, AegisSwapAuthorizationProgress } from './actions/types.js';
 export { estimateSwapGasWithBuffer } from './swap/gas.js';
 export type { SwapGasRequest } from './swap/gas.js';
+export { assertDirectSwapMarketTrusted, authorizeHostDirectSwapMarket, DIRECT_SWAP_MARKET_TRUST_RULE_ID, DirectSwapMarketTrustError, isDirectSwapMarketTrusted } from './swap/trustedMarket.js';
 export type { AegisSwapApprovalMode, AegisSwapSubmitDetails, WalletSession } from './swap/types.js';
 export { classifyError, errorMessage, isSubmittedTransactionReceiptError, isUserRejectedError, SubmittedTransactionReceiptError, TransactionReceiptTimeoutError, USER_REJECTED_MESSAGE, UserFacingError } from './errors.js';
 export type { ClassifiedError, UserFacingErrorKind } from './errors.js';
 export { isBusy, progressRailSteps, transactionProgressView, transactionSequenceProgress } from './transactionProgress.js';
 export type { AegisSwapReceiptSummary, AegisSwapStatusSnapshot, AegisSwapStatusTransactionContext, AegisSwapStatusTransactionToken, AegisSwapWalletPromptProgress, SubmitStatus, TransactionProgressState, TransactionProgressView } from './transactionProgress.js';
 export { reconcileSubmittedReceipt } from './swap/receiptWait.js';
-export type { SubmittedReceiptOutcome } from './swap/receiptWait.js';
+export type { SubmittedReceiptOutcome, AegisTransactionObservation } from './swap/receiptWait.js';
 export { summarizeTransactionReceipt } from './swap/sendSwapTransaction.js';
 export { isDocumentVisible, pollUntil, retryOnError } from './polling.js';
 export { AEGIS_BACKEND_PROD_BASE_URL, AegisBackendApiError, AegisBackendContractError, createAegisBackendApiClient, isRetryableAegisBackendApiError, normalizeAegisBackendBaseUrl } from './contract/backendClient.js';
@@ -42,3 +45,4 @@ export { aegisBackendAddressAllowlistSchema, aegisBackendAddressSchema, aegisBac
 export type { AegisContractGuardCode } from './contract/index.js';
 export { engineMarketsRestResponseSchema } from './engine/restSchemas.js';
 export * from './engine/index.js';
+export { PortfolioQuerySchema, PortfolioPageQuerySchema, PortfolioResponseSchema, PortfolioPageSchema } from './engine/account/portfolioSchemas.js';

package/dist/internal/guardedWalletTransaction.d.ts

@@ -0,0 +1,31 @@
+import type { Chain, Hex, PublicClient, TransactionReceipt } from 'viem';
+import { type Eip1193Provider } from '../wallet.js';
+import { type AegisTransactionObservation } from '../swap/receiptWait.js';
+/**
+ * Sends one already-prepared wallet transaction through the safety boundary
+ * shared by swaps and authorization writes.
+ *
+ * Preparation and simulation stay with the caller. This helper owns the
+ * invariants that begin immediately before the wallet prompt: verify the
+ * active chain, honor cancellation until a hash exists, publish submitted and
+ * replacement hashes without trusting host callbacks, and reconcile the
+ * receipt. Once submitted, caller cancellation cannot hide the mined result.
+ */
+export declare function runGuardedWalletTransaction(args: {
+    provider: Eip1193Provider;
+    publicClient: PublicClient;
+    chain: Chain;
+    signal?: AbortSignal;
+    timeoutMs: number;
+    submit: () => Promise<Hex>;
+    unreadableChainMessage: string;
+    cancelledMessage: string;
+    revertedMessage: string;
+    onWalletRequest?: () => void;
+    onHash?: (hash: Hex, replacement?: {
+        replacesHash: Hex;
+        executionChanged: boolean;
+    }) => void;
+    onTransactionObservation?: (event: AegisTransactionObservation) => void;
+    onSubmitted?: (hash: Hex) => void;
+}): Promise<TransactionReceipt>;

package/dist/permit.d.ts

@@ -1,8 +1,20 @@
 import { type Address, type Chain, type Hex, type PublicClient } from 'viem';
-import type { Eip1193Provider } from './wallet.js';
+import { type Eip1193Provider } from './wallet.js';
 import type { SignedPermitBatch } from './encoding.js';
 export declare const MAX_UINT160: bigint;
 export declare const MAX_UINT256: bigint;
+/** "No limit" only counts once the standing grant still reads as effectively
+ *  unlimited. Half the type maximum tolerates tokens and Permit2 flows that
+ *  decrement a max grant on spend — an equality test against the maximum would
+ *  re-approve before every swap — while an exact-sized allowance, however large
+ *  against today's amount, never qualifies. */
+export declare const UNLIMITED_ERC20_FLOOR: bigint;
+export declare const UNLIMITED_PERMIT2_FLOOR: bigint;
+/** Whether an ERC-20 grant reads as "no limit" rather than a number worth
+ *  showing — formatting the integer yields a quantity nobody can read. */
+export declare function isUnlimitedErc20Approval(amount: bigint): boolean;
+/** The Permit2 counterpart, against the uint160 wire type's own floor. */
+export declare function isUnlimitedPermit2Approval(amount: bigint): boolean;
 export declare const SWAP_TX_DEADLINE_SECONDS = 600;
 export declare const DEFAULT_PERMIT_EXPIRATION_SECONDS: number;
 export declare const PERMIT2_FAR_FUTURE_EXPIRATION: number;
@@ -14,8 +26,14 @@ export declare function approveErc20ToPermit2(args: {
     token: Address;
     permit2: Address;
     amount?: bigint;
+    /** Stops preparation before the approval is handed to the wallet. */
+    signal?: AbortSignal;
     onWalletRequest?: () => void;
-    onHash?: (hash: Hex) => void;
+    onHash?: (hash: Hex, replacement?: {
+        replacesHash: Hex;
+        executionChanged: boolean;
+    }) => void;
+    onSubmitted?: (hash: Hex) => void;
 }): Promise<Hex>;
 export declare function readErc20Allowance(args: {
     publicClient: PublicClient;
@@ -30,9 +48,25 @@ export declare function approveErc20Spender(args: {
     chain: Chain;
     token: Address;
     spender: Address;
-    onHash?: (hash: Hex) => void;
     amount?: bigint;
+    /** Stops preparation before the approval is handed to the wallet. */
+    signal?: AbortSignal;
+    onWalletRequest?: () => void;
+    onHash?: (hash: Hex, replacement?: {
+        replacesHash: Hex;
+        executionChanged: boolean;
+    }) => void;
+    onSubmitted?: (hash: Hex) => void;
 }): Promise<Hex>;
+/**
+ * Installs a Permit2 -> router spending cap on-chain: the fallback for wallets
+ * whose typed-data signature Permit2 will not accept.
+ *
+ * `amount` follows the same convention as the ERC-20 writers above — omitted
+ * means maximum authority (MAX_UINT160), and an explicit `0n` revokes. Anything
+ * wider than the uint160 wire type is clamped. `expiration` defaults to
+ * Permit2's far-future sentinel.
+ */
 export declare function approvePermit2ToRouter(args: {
     provider: Eip1193Provider;
     publicClient: PublicClient;
@@ -43,8 +77,14 @@ export declare function approvePermit2ToRouter(args: {
     router: Address;
     amount?: bigint;
     expiration?: number;
+    /** Stops preparation before the approval is handed to the wallet. */
+    signal?: AbortSignal;
     onWalletRequest?: () => void;
-    onHash?: (hash: Hex) => void;
+    onHash?: (hash: Hex, replacement?: {
+        replacesHash: Hex;
+        executionChanged: boolean;
+    }) => void;
+    onSubmitted?: (hash: Hex) => void;
 }): Promise<Hex>;
 export declare function readPermit2RouterAllowance(args: {
     publicClient: PublicClient;
@@ -53,7 +93,36 @@ 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 hasUsablePermit2Allowance(allowance: Awaited<ReturnType<typeof readPermit2RouterAllowance>>, amount: bigint, sizing?: 'exact' | 'max'): boolean;
+/**
+ * True only when Permit2's own `SignatureVerification` would accept this
+ * signature. It branches on the owner's code, not on the signature's shape: an
+ * address with code is checked through ERC-1271 alone, with no ecrecover
+ * fallback, so an EIP-7702-delegated EOA whose delegate does not implement
+ * `isValidSignature` rejects the ordinary 65-byte signature its own key just
+ * produced. A codeless owner takes the other branch and reverts on any length
+ * other than 64 or 65, which is where an ERC-6492 wrapper from an undeployed
+ * smart account dies.
+ *
+ * viem's `verifyTypedData` is used only for the codeless branch it models
+ * exactly, in `eoa` mode: its default `auto` mode opens with an `eth_call` that
+ * deploys viem's ERC-6492 validator, a blocking round trip sitting between the
+ * wallet signature and the submit on every ordinary swap.
+ *
+ * `false` means the owner refused, never "the check could not run": an RPC
+ * failure throws so the caller cannot mistake it for an unsignable wallet.
+ */
+export declare function isPermit2AcceptableSignature(args: {
+    publicClient: PublicClient;
+    chainId: number;
+    permit2: Address;
+    signed: SignedPermitBatch;
+    /**
+     * The owner's deployed code, read by the caller so a failed read propagates
+     * instead of arriving here as a `false`.
+     */
+    ownerCode: Hex | undefined;
+}): Promise<boolean>;
 export declare function buildSignedPermitBatch(args: {
     provider: Eip1193Provider;
     publicClient: PublicClient;
@@ -67,11 +136,15 @@ export declare function buildSignedPermitBatch(args: {
     /**
      * 'max' signs a MAX_UINT160 permit (still expiring in 30 minutes) so quick
      * follow-up swaps reuse it instead of prompting for a new signature each
-     * time — Permit2 decrements exact-sized permits to zero on transfer.
-     * Defaults to 'exact'.
+     * time — Permit2 decrements exact-sized permits to zero on transfer. It also
+     * re-signs over a merely amount-covering standing cap, because that cap is
+     * not the unlimited authority 'max' asked for. Defaults to 'exact'.
      */
     sizing?: 'exact' | 'max';
     /** Pre-started readPermit2RouterAllowance result to overlap with other RPC work. */
     allowanceRead?: ReturnType<typeof readPermit2RouterAllowance>;
+    /** Stops preparation before typed data is handed to the wallet. */
+    signal?: AbortSignal;
+    /** Fires only when a new typed-data signature is actually requested. */
     onWalletRequest?: () => void;
 }): Promise<SignedPermitBatch | null>;

package/dist/quote/aggregatedSwapQuote.d.ts

@@ -13,5 +13,9 @@ export declare class AggregatedSwapBuildMismatchError extends UserFacingError {
         actual: bigint;
     });
 }
+/** Absolute settlement floor established by the quote the user approved. */
+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): Promise<AggregatedSwapQuote>;
+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>;

package/dist/quote/kyberCalldata.d.ts

@@ -189,6 +189,10 @@ export declare const KYBER_META_AGGREGATION_ROUTER_V2_ABI: readonly [{
         readonly type: "uint256";
     }];
 }];
+export type KyberSettlementFeePolicy = Readonly<{
+    receiver: Address;
+    feeBps: number;
+}>;
 export declare class AggregatedSwapCalldataError extends UserFacingError {
     readonly reason: string;
     constructor(reason: string);
@@ -207,5 +211,5 @@ export declare function assertKyberCalldataMatchesQuote(args: {
     recipient: Address;
     /** Lowest acceptable value for the calldata's embedded minReturnAmount. */
     minReturnFloor: bigint;
-    feeRecipient: Address | null;
+    feePolicy: KyberSettlementFeePolicy | null;
 }): void;