@aegis-engine/core 0.1.1 → 0.1.3

package/dist/backendApi.d.ts

@@ -0,0 +1,201 @@
+import type { Address, Hex } from 'viem';
+import type { z } from 'zod';
+import type { AegisPoolKey } from './config';
+export type AegisBackendSwapProvider = 'aegis-direct-v4' | 'kyber';
+export type AegisBackendQuoteMode = 'exactIn' | 'exactOut';
+export type AegisBackendMarketStatus = 'enabled' | 'disabled';
+export type AegisBackendTxStatus = 'pending' | 'success' | 'reverted' | 'not_found';
+export type AegisBackendChain = {
+    chainId: number;
+    slug: string;
+    name: string;
+};
+export type AegisBackendQuoteDefaults = {
+    ttlSeconds: number;
+    defaultSlippageBps: number;
+    maxSlippageBps: number;
+};
+export type AegisBackendContractRegistry = {
+    aegisRouter?: Address;
+    permit2?: Address;
+    v4Quoter?: Address;
+    v4PoolManager?: Address;
+    [contractName: string]: Address | undefined;
+};
+export type AegisBackendAddressAllowlist = {
+    routers: Address[];
+    spenders: Address[];
+};
+export type AegisBackendFeeConfig = {
+    outputFeeBps: number;
+    recipient: Address;
+};
+export type AegisBackendConfig = {
+    schemaVersion: string;
+    chains: AegisBackendChain[];
+    providers: AegisBackendSwapProvider[];
+    quote: AegisBackendQuoteDefaults;
+    contracts: Record<string, AegisBackendContractRegistry>;
+    allowlists: Record<string, AegisBackendAddressAllowlist>;
+    fee: AegisBackendFeeConfig;
+};
+export type AegisBackendToken = {
+    id: string;
+    chainId: number;
+    address: Address;
+    symbol: string;
+    displayName: string;
+    fullName: string;
+    decimals: number;
+    priceUsd?: number | null;
+    iconUrl?: string | null;
+    stable?: boolean;
+};
+export type AegisBackendMarketMetrics = {
+    tvlUsd?: number | null;
+    volumeUsd7d?: number | null;
+    feeApr7d?: number | null;
+};
+export type AegisBackendMarket = {
+    id: string;
+    chainId: number;
+    status: AegisBackendMarketStatus;
+    kind: AegisBackendSwapProvider;
+    label: string;
+    baseToken: Address;
+    quoteToken: Address;
+    poolId: Hex;
+    poolKey: AegisPoolKey;
+    metrics?: AegisBackendMarketMetrics;
+    warnings: string[];
+};
+type AegisBackendSwapQuoteRequestBase = {
+    chainId: number;
+    provider: AegisBackendSwapProvider;
+    marketId?: string;
+    tokenIn: Address;
+    tokenOut: Address;
+    slippageBps: number;
+    account?: Address | null;
+};
+export type AegisBackendSwapQuoteRequest = (AegisBackendSwapQuoteRequestBase & {
+    mode: 'exactIn';
+    amountIn: string;
+    amountOut?: never;
+}) | (AegisBackendSwapQuoteRequestBase & {
+    mode: 'exactOut';
+    amountOut: string;
+    amountIn?: never;
+});
+export type AegisBackendSwapApproval = {
+    required: boolean;
+    model: 'permit2' | 'erc20' | 'native' | 'none';
+    spender?: Address | null;
+};
+export type AegisBackendSwapQuoteResponse = {
+    quoteId: string;
+    quoteHash: Hex;
+    routeHash: Hex;
+    expiresAt: string;
+    quoteBlockNumber: string;
+    provider: AegisBackendSwapProvider;
+    marketId?: string;
+    amountIn: string;
+    amountOut: string;
+    minAmountOut: string;
+    gasEstimate?: string | null;
+    approval: AegisBackendSwapApproval;
+    fee: AegisBackendFeeConfig;
+    warnings: string[];
+};
+export type AegisBackendSwapBuildRequest = {
+    quoteId: string;
+    account: Address;
+    recipient: Address;
+    permitSignature?: Hex;
+};
+export type AegisBackendUnsignedSwapTx = {
+    chainId: number;
+    to: Address;
+    data: Hex;
+    value: string;
+};
+export type AegisBackendSwapBuildResponse = {
+    buildId: string;
+    quoteId: string;
+    routeHash: Hex;
+    expectedCalldataHash: Hex;
+    expiresAt: string;
+    tx: AegisBackendUnsignedSwapTx;
+    allowance: {
+        spender: Address;
+        permit2Required: boolean;
+    };
+    simulation: {
+        ok: boolean;
+        blockNumber?: string;
+    };
+    warnings: string[];
+};
+export type AegisBackendTxStatusResponse = {
+    status: AegisBackendTxStatus;
+    blockNumber?: string | null;
+    gasUsed?: string | null;
+    effectiveGasPrice?: string | null;
+    feeWei?: string | null;
+    explorerUrl?: string | null;
+};
+export type AegisBackendApiClientOptions = {
+    baseUrl: string;
+    fetch?: typeof fetch;
+    headers?: Record<string, string>;
+    validate?: boolean;
+};
+export type AegisBackendRequestOptions = {
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+};
+export declare class AegisBackendApiError extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    readonly body: unknown;
+    constructor({ status, statusText, body }: {
+        status: number;
+        statusText: string;
+        body: unknown;
+    });
+}
+export declare class AegisBackendContractError extends Error {
+    readonly endpoint: string;
+    readonly issues: z.core.$ZodIssue[];
+    constructor({ endpoint, issues }: {
+        endpoint: string;
+        issues: z.core.$ZodIssue[];
+    });
+}
+export declare function isRetryableAegisBackendApiError(error: unknown): boolean;
+export type AegisBackendApiClient = {
+    health: (options?: AegisBackendRequestOptions) => Promise<{
+        ok: boolean;
+    }>;
+    config: (options?: AegisBackendRequestOptions) => Promise<AegisBackendConfig>;
+    tokens: (args: {
+        chainId: number;
+    }, options?: AegisBackendRequestOptions) => Promise<AegisBackendToken[]>;
+    tokensByAddress: (args: {
+        chainId: number;
+        addresses: Address[];
+    }, options?: AegisBackendRequestOptions) => Promise<AegisBackendToken[]>;
+    markets: (args: {
+        chainId: number;
+    }, options?: AegisBackendRequestOptions) => Promise<AegisBackendMarket[]>;
+    quote: (args: AegisBackendSwapQuoteRequest, options?: AegisBackendRequestOptions) => Promise<AegisBackendSwapQuoteResponse>;
+    build: (args: AegisBackendSwapBuildRequest, options?: AegisBackendRequestOptions) => Promise<AegisBackendSwapBuildResponse>;
+    txStatus: (args: {
+        chainId: number;
+        txHash: Hex;
+    }, options?: AegisBackendRequestOptions) => Promise<AegisBackendTxStatusResponse>;
+};
+export declare function createAegisBackendApiClient(options: AegisBackendApiClientOptions): AegisBackendApiClient;
+export {};

package/dist/config/chains.d.ts

@@ -0,0 +1,9 @@
+import { type Hex } from 'viem';
+import type { AegisSwapChainConfig, AegisSwapChainConfigInput } from './types';
+export declare function getExplorerUrl(hash: Hex, chain: AegisSwapChainConfig): string;
+export declare const AEGIS_SWAP_MAINNET_CHAIN: AegisSwapChainConfig;
+export declare const AEGIS_SWAP_CHAINS: Record<number, AegisSwapChainConfig>;
+export declare function createAegisSwapChainConfig(input: AegisSwapChainConfigInput & {
+    chainId: number;
+}, base?: AegisSwapChainConfig): AegisSwapChainConfig;
+export declare function createAegisSwapChains(chains?: Partial<Record<number, AegisSwapChainConfigInput>>): Record<number, AegisSwapChainConfig>;

package/dist/config/constants.d.ts

@@ -0,0 +1,10 @@
+export declare const AEGIS_SWAP_CHAIN_ID = 1;
+export declare const AEGIS_SWAP_ROUTER: `0x${string}`;
+export declare const AEGIS_SWAP_HOOK: `0x${string}`;
+export declare const AEGIS_DYNAMIC_FEE_FLAG = 8388608;
+export declare const AEGIS_SWAP_DEFAULT_FEE_BPS = 50;
+export declare const AEGIS_SWAP_DEFAULT_FEE_RECIPIENT: `0x${string}`;
+export declare const AEGIS_SWAP_DEFAULT_RPC_URLS: string[];
+export declare const AEGIS_SWAP_DEFAULT_METADATA_ENDPOINT = "https://aegis.markets/graphql/meta";
+export declare const AGGREGATED_SWAP_FEE_BPS = 50;
+export declare const AGGREGATED_SWAP_FEE_RECIPIENT: `0x${string}`;

package/dist/config/contracts.d.ts

@@ -0,0 +1,6 @@
+import type { AegisSwapUniswapV4Contracts, AegisSwapUniswapV4ContractsInput } from './types';
+export declare function createAegisSwapUniswapV4Contracts(input: AegisSwapUniswapV4ContractsInput): AegisSwapUniswapV4Contracts;
+export declare const UNISWAP_V4_CONTRACTS_BY_CHAIN: Record<number, AegisSwapUniswapV4Contracts>;
+export declare const AEGIS_SWAP_MAINNET_UNISWAP_V4_CONTRACTS: AegisSwapUniswapV4Contracts;
+export declare const AEGIS_SWAP_PERMIT2: `0x${string}`;
+export declare const AEGIS_SWAP_V4_QUOTER: `0x${string}`;

package/dist/config/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types';
+export * from './constants';
+export * from './contracts';
+export * from './chains';
+export * from './tokens';
+export * from './markets';

package/dist/config/markets.d.ts

@@ -0,0 +1,3 @@
+import type { AegisSwapChainConfig, AegisSwapMarket, AegisSwapPoolConfig } from './types';
+export declare function createAegisSwapPoolMarket(input: AegisSwapPoolConfig, chains?: Record<number, AegisSwapChainConfig>): AegisSwapMarket;
+export declare function createAegisSwapMarketsFromPools(pools: AegisSwapPoolConfig[] | undefined, chains?: Record<number, AegisSwapChainConfig>): Record<string, AegisSwapMarket>;

package/dist/config/tokens.d.ts

@@ -0,0 +1,11 @@
+import type { AegisSwapBuiltInTokenSymbol, AegisSwapToken, AggregatedSwapDefaultTokenSymbol, AggregatedSwapToken, AggregatedSwapWolfGameTokenSymbol } from './types';
+export declare const AEGIS_SWAP_TOKENS: Record<AegisSwapBuiltInTokenSymbol, AegisSwapToken>;
+export declare const AGGREGATED_SWAP_DEFAULT_TOKENS: Record<AggregatedSwapDefaultTokenSymbol, AggregatedSwapToken>;
+export declare const AGGREGATED_SWAP_WOLFGAME_TOKENS: Record<AggregatedSwapWolfGameTokenSymbol, AggregatedSwapToken>;
+export declare const AGGREGATED_SWAP_DEFAULT_TOKEN_LIST: AegisSwapToken[];
+export declare const AGGREGATED_SWAP_WOLFGAME_TOKEN_LIST: AegisSwapToken[];
+export declare const AGGREGATED_SWAP_TOKEN_PRESETS: {
+    readonly default: AegisSwapToken[];
+    readonly wolfgame: AegisSwapToken[];
+};
+export declare const AGGREGATED_SWAP_CURATED_TOKENS: Record<AggregatedSwapDefaultTokenSymbol, AegisSwapToken>;

package/dist/config/types.d.ts

@@ -0,0 +1,81 @@
+import type { Address, Chain, Hex } from 'viem';
+export type AegisSwapBuiltInTokenSymbol = 'USDC' | 'WATER' | 'WOOD' | 'GRASS' | 'STONE';
+export type AegisSwapTokenSymbol = string;
+export type AegisSwapFeeConfig = {
+    bps: number;
+    recipient: Address;
+};
+export type AegisSwapToken = {
+    chainId: number;
+    address: Address;
+    name: string;
+    symbol: AegisSwapTokenSymbol;
+    decimals: number;
+    iconUrl?: string | null;
+};
+export type AegisPoolKey = {
+    currency0: Address;
+    currency1: Address;
+    fee: number;
+    tickSpacing: number;
+    hooks: Address;
+};
+export type AegisSwapUniswapV4Contracts = {
+    permit2: Address;
+    quoter: Address;
+    poolManager?: Address;
+    positionDescriptor?: Address;
+    positionManager?: Address;
+    stateView?: Address;
+    universalRouter?: Address;
+    universalRouterV2_1_1?: Address;
+};
+export type AegisSwapUniswapV4ContractsInput = Partial<AegisSwapUniswapV4Contracts>;
+export type AegisSwapMarket = {
+    id: string;
+    chainId: number;
+    symbol: AegisSwapTokenSymbol;
+    poolId: Hex;
+    poolKey: AegisPoolKey;
+    token: AegisSwapToken;
+    counterToken: AegisSwapToken;
+    router: Address;
+    permit2: Address;
+    quoter: Address;
+    label?: string;
+};
+export type AegisSwapChainConfig = {
+    chainId: number;
+    chain: Chain;
+    name: string;
+    router: Address;
+    permit2: Address;
+    quoter: Address;
+    v4Contracts: AegisSwapUniswapV4Contracts;
+    rpcUrls: string[];
+    explorerTxUrl?: (hash: Hex) => string;
+    poolExplorerUrl?: (poolId: Hex, market: AegisSwapMarket) => string;
+    metadataEndpoint?: string | null;
+    fee?: AegisSwapFeeConfig;
+};
+export type AegisSwapChainConfigInput = Partial<Omit<AegisSwapChainConfig, 'chainId' | 'v4Contracts' | 'fee'>> & {
+    chainId?: number;
+    v4Contracts?: AegisSwapUniswapV4ContractsInput;
+};
+export type AegisSwapPoolConfig = {
+    id: string;
+    symbol?: AegisSwapTokenSymbol;
+    chainId?: number;
+    poolKey: AegisPoolKey;
+    poolId?: Hex;
+    token: AegisSwapToken;
+    counterToken: AegisSwapToken;
+    router?: Address;
+    permit2?: Address;
+    quoter?: Address;
+    label?: string;
+};
+export type AggregatedSwapToken = AegisSwapToken;
+export type AggregatedSwapDefaultTokenSymbol = 'USDC' | 'USDT' | 'WETH' | 'ETH' | 'WBTC' | 'STETH';
+export type AggregatedSwapWolfGameTokenSymbol = AegisSwapBuiltInTokenSymbol | 'ETH';
+export type AggregatedSwapTokenSymbol = AggregatedSwapDefaultTokenSymbol | AggregatedSwapWolfGameTokenSymbol;

package/dist/contract/guards.d.ts

@@ -0,0 +1,13 @@
+import type { Address, Hex } from 'viem';
+export type AegisContractGuardCode = 'QUOTE_EXPIRED' | 'ROUTER_NOT_ALLOWLISTED' | 'SPENDER_NOT_ALLOWLISTED' | 'CALLDATA_HASH_MISMATCH' | 'CHAIN_MISMATCH';
+export declare class AegisContractGuardError extends Error {
+    readonly code: AegisContractGuardCode;
+    constructor(code: AegisContractGuardCode, message: string);
+}
+export declare function assertQuoteFresh(quote: {
+    expiresAt: string;
+}, nowMs?: number): void;
+export declare function assertRouterAllowlisted(to: Address, allowlistedRouters: readonly Address[]): void;
+export declare function assertSpenderAllowlisted(spender: Address, allowlistedSpenders: readonly Address[]): void;
+export declare function assertCalldataHash(data: Hex, expectedCalldataHash: Hex): void;
+export declare function assertChainMatches(walletChainId: number, txChainId: number): void;

package/dist/contract/index.d.ts

@@ -0,0 +1,2 @@
+export * from './guards';
+export * from './schemas';

package/dist/contract/schemas.d.ts

@@ -0,0 +1,282 @@
+import { z } from 'zod';
+export declare const aegisBackendAddressSchema: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+export declare const aegisBackendHexSchema: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+export declare const aegisBackendDecimalStringSchema: z.ZodString;
+export declare const aegisBackendIsoDateTimeSchema: z.ZodISODateTime;
+export declare const aegisBackendSwapProviderSchema: z.ZodEnum<{
+    "aegis-direct-v4": "aegis-direct-v4";
+    kyber: "kyber";
+}>;
+export declare const aegisBackendQuoteModeSchema: z.ZodEnum<{
+    exactIn: "exactIn";
+    exactOut: "exactOut";
+}>;
+export declare const aegisBackendMarketStatusSchema: z.ZodEnum<{
+    enabled: "enabled";
+    disabled: "disabled";
+}>;
+export declare const aegisBackendTxStatusSchema: z.ZodEnum<{
+    pending: "pending";
+    success: "success";
+    reverted: "reverted";
+    not_found: "not_found";
+}>;
+export declare const aegisBackendChainSchema: z.ZodObject<{
+    chainId: z.ZodNumber;
+    slug: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+export declare const aegisBackendQuoteDefaultsSchema: z.ZodObject<{
+    ttlSeconds: z.ZodNumber;
+    defaultSlippageBps: z.ZodNumber;
+    maxSlippageBps: z.ZodNumber;
+}, z.core.$strip>;
+export declare const aegisBackendContractRegistrySchema: z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
+export declare const aegisBackendAddressAllowlistSchema: z.ZodObject<{
+    routers: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+    spenders: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+}, z.core.$strip>;
+export declare const aegisBackendFeeConfigSchema: z.ZodObject<{
+    outputFeeBps: z.ZodNumber;
+    recipient: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+}, z.core.$strip>;
+export declare const aegisBackendConfigSchema: z.ZodObject<{
+    schemaVersion: z.ZodString;
+    chains: z.ZodArray<z.ZodObject<{
+        chainId: z.ZodNumber;
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    providers: z.ZodArray<z.ZodEnum<{
+        "aegis-direct-v4": "aegis-direct-v4";
+        kyber: "kyber";
+    }>>;
+    quote: z.ZodObject<{
+        ttlSeconds: z.ZodNumber;
+        defaultSlippageBps: z.ZodNumber;
+        maxSlippageBps: z.ZodNumber;
+    }, z.core.$strip>;
+    contracts: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>>;
+    allowlists: z.ZodRecord<z.ZodString, z.ZodObject<{
+        routers: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+        spenders: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+    }, z.core.$strip>>;
+    fee: z.ZodObject<{
+        outputFeeBps: z.ZodNumber;
+        recipient: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const aegisBackendTokenSchema: z.ZodObject<{
+    id: z.ZodString;
+    chainId: z.ZodNumber;
+    address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    symbol: z.ZodString;
+    displayName: z.ZodString;
+    fullName: z.ZodString;
+    decimals: z.ZodNumber;
+    priceUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    iconUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    stable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const aegisBackendMarketMetricsSchema: z.ZodObject<{
+    tvlUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    volumeUsd7d: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    feeApr7d: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export declare const aegisPoolKeySchema: z.ZodObject<{
+    currency0: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    currency1: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    fee: z.ZodNumber;
+    tickSpacing: z.ZodNumber;
+    hooks: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+}, z.core.$strip>;
+export declare const aegisBackendMarketSchema: z.ZodObject<{
+    id: z.ZodString;
+    chainId: z.ZodNumber;
+    status: z.ZodEnum<{
+        enabled: "enabled";
+        disabled: "disabled";
+    }>;
+    kind: z.ZodEnum<{
+        "aegis-direct-v4": "aegis-direct-v4";
+        kyber: "kyber";
+    }>;
+    label: z.ZodString;
+    baseToken: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    quoteToken: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    poolId: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    poolKey: z.ZodObject<{
+        currency0: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        currency1: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        fee: z.ZodNumber;
+        tickSpacing: z.ZodNumber;
+        hooks: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    }, z.core.$strip>;
+    metrics: z.ZodOptional<z.ZodObject<{
+        tvlUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        volumeUsd7d: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        feeApr7d: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>;
+    warnings: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const aegisBackendSwapQuoteRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    mode: z.ZodLiteral<"exactIn">;
+    amountIn: z.ZodString;
+    amountOut: z.ZodOptional<z.ZodNever>;
+    chainId: z.ZodNumber;
+    provider: z.ZodEnum<{
+        "aegis-direct-v4": "aegis-direct-v4";
+        kyber: "kyber";
+    }>;
+    marketId: z.ZodOptional<z.ZodString>;
+    tokenIn: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    tokenOut: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    slippageBps: z.ZodNumber;
+    account: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
+}, z.core.$strip>, z.ZodObject<{
+    mode: z.ZodLiteral<"exactOut">;
+    amountOut: z.ZodString;
+    amountIn: z.ZodOptional<z.ZodNever>;
+    chainId: z.ZodNumber;
+    provider: z.ZodEnum<{
+        "aegis-direct-v4": "aegis-direct-v4";
+        kyber: "kyber";
+    }>;
+    marketId: z.ZodOptional<z.ZodString>;
+    tokenIn: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    tokenOut: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    slippageBps: z.ZodNumber;
+    account: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
+}, z.core.$strip>], "mode">;
+export declare const aegisBackendSwapApprovalSchema: z.ZodObject<{
+    required: z.ZodBoolean;
+    model: z.ZodEnum<{
+        permit2: "permit2";
+        erc20: "erc20";
+        native: "native";
+        none: "none";
+    }>;
+    spender: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
+}, z.core.$strip>;
+export declare const aegisBackendSwapQuoteResponseSchema: z.ZodObject<{
+    quoteId: z.ZodString;
+    quoteHash: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    routeHash: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    expiresAt: z.ZodISODateTime;
+    quoteBlockNumber: z.ZodString;
+    provider: z.ZodEnum<{
+        "aegis-direct-v4": "aegis-direct-v4";
+        kyber: "kyber";
+    }>;
+    marketId: z.ZodOptional<z.ZodString>;
+    amountIn: z.ZodString;
+    amountOut: z.ZodString;
+    minAmountOut: z.ZodString;
+    gasEstimate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    approval: z.ZodObject<{
+        required: z.ZodBoolean;
+        model: z.ZodEnum<{
+            permit2: "permit2";
+            erc20: "erc20";
+            native: "native";
+            none: "none";
+        }>;
+        spender: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
+    }, z.core.$strip>;
+    fee: z.ZodObject<{
+        outputFeeBps: z.ZodNumber;
+        recipient: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    }, z.core.$strip>;
+    warnings: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const aegisBackendSwapBuildRequestSchema: z.ZodObject<{
+    quoteId: z.ZodString;
+    account: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    recipient: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    permitSignature: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+}, z.core.$strip>;
+export declare const aegisBackendUnsignedSwapTxSchema: z.ZodObject<{
+    chainId: z.ZodNumber;
+    to: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    data: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    value: z.ZodString;
+}, z.core.$strip>;
+export declare const aegisBackendSwapBuildResponseSchema: z.ZodObject<{
+    buildId: z.ZodString;
+    quoteId: z.ZodString;
+    routeHash: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    expectedCalldataHash: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    expiresAt: z.ZodISODateTime;
+    tx: z.ZodObject<{
+        chainId: z.ZodNumber;
+        to: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        data: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        value: z.ZodString;
+    }, z.core.$strip>;
+    allowance: z.ZodObject<{
+        spender: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        permit2Required: z.ZodBoolean;
+    }, z.core.$strip>;
+    simulation: z.ZodObject<{
+        ok: z.ZodBoolean;
+        blockNumber: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    warnings: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const aegisBackendTxStatusResponseSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        pending: "pending";
+        success: "success";
+        reverted: "reverted";
+        not_found: "not_found";
+    }>;
+    blockNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    gasUsed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    effectiveGasPrice: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    feeWei: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    explorerUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const aegisBackendHealthResponseSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const aegisBackendTokensResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    chainId: z.ZodNumber;
+    address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    symbol: z.ZodString;
+    displayName: z.ZodString;
+    fullName: z.ZodString;
+    decimals: z.ZodNumber;
+    priceUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    iconUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    stable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>>;
+export declare const aegisBackendMarketsResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    chainId: z.ZodNumber;
+    status: z.ZodEnum<{
+        enabled: "enabled";
+        disabled: "disabled";
+    }>;
+    kind: z.ZodEnum<{
+        "aegis-direct-v4": "aegis-direct-v4";
+        kyber: "kyber";
+    }>;
+    label: z.ZodString;
+    baseToken: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    quoteToken: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    poolId: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    poolKey: z.ZodObject<{
+        currency0: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        currency1: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        fee: z.ZodNumber;
+        tickSpacing: z.ZodNumber;
+        hooks: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    }, z.core.$strip>;
+    metrics: z.ZodOptional<z.ZodObject<{
+        tvlUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        volumeUsd7d: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        feeApr7d: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>;
+    warnings: z.ZodArray<z.ZodString>;
+}, z.core.$strip>>;

package/dist/index.d.ts

@@ -26,3 +26,7 @@ export { errorMessage, isUserRejectedError } from './errors';
 export { isBusy, transactionProgressView } from './transactionProgress';
 export type { AegisSwapReceiptSummary, AegisSwapStatusSnapshot, AegisSwapWalletPromptProgress, SubmitStatus, TransactionProgressState, TransactionProgressView } from './transactionProgress';
 export { isDocumentVisible, pollUntil, retryOnError } from './polling';
+export { AegisBackendApiError, AegisBackendContractError, createAegisBackendApiClient, isRetryableAegisBackendApiError } from './backendApi';
+export type { AegisBackendAddressAllowlist, AegisBackendApiClient, AegisBackendApiClientOptions, AegisBackendChain, AegisBackendConfig, AegisBackendContractRegistry, AegisBackendFeeConfig, AegisBackendMarket, AegisBackendMarketMetrics, AegisBackendMarketStatus, AegisBackendQuoteDefaults, AegisBackendQuoteMode, AegisBackendRequestOptions, AegisBackendSwapApproval, AegisBackendSwapBuildRequest, AegisBackendSwapBuildResponse, AegisBackendSwapProvider, AegisBackendSwapQuoteRequest, AegisBackendSwapQuoteResponse, AegisBackendToken, AegisBackendTxStatus, AegisBackendTxStatusResponse, AegisBackendUnsignedSwapTx } from './backendApi';
+export { aegisBackendAddressAllowlistSchema, aegisBackendAddressSchema, aegisBackendChainSchema, aegisBackendConfigSchema, aegisBackendContractRegistrySchema, aegisBackendDecimalStringSchema, aegisBackendFeeConfigSchema, aegisBackendHealthResponseSchema, aegisBackendHexSchema, aegisBackendIsoDateTimeSchema, aegisBackendMarketMetricsSchema, aegisBackendMarketSchema, aegisBackendMarketStatusSchema, aegisBackendMarketsResponseSchema, aegisBackendQuoteDefaultsSchema, aegisBackendQuoteModeSchema, aegisBackendSwapApprovalSchema, aegisBackendSwapBuildRequestSchema, aegisBackendSwapBuildResponseSchema, aegisBackendSwapProviderSchema, aegisBackendSwapQuoteRequestSchema, aegisBackendSwapQuoteResponseSchema, aegisBackendTokenSchema, aegisBackendTokensResponseSchema, aegisBackendTxStatusResponseSchema, aegisBackendTxStatusSchema, aegisBackendUnsignedSwapTxSchema, aegisPoolKeySchema, AegisContractGuardError, assertCalldataHash, assertChainMatches, assertQuoteFresh, assertRouterAllowlisted, assertSpenderAllowlisted } from './contract';
+export type { AegisContractGuardCode } from './contract';

package/dist/swap/executeSwapTransaction.d.ts

@@ -16,12 +16,11 @@ export type SwapExecutionResult = {
 /**
  * Builds the swap calldata, sends it, and waits for the receipt.
  *
- * Estimates gas with a 20% headroom bump, surfaces the optimistic hash through
- * `setTxHash` (and `onSubmitted`) before mining, then tracks replacements: a
- * wallet speed-up swaps in the hash that actually mines, while a wallet cancel
- * mines a no-op whose "successful" receipt must not count as a swap — so a
- * cancelled or reverted receipt throws. Setting the success status and the
- * post-success refreshes stay with the caller.
+ * Estimates gas with a 20% headroom bump, then hands off to
+ * `sendSwapTransactionAndAwait`, which surfaces the optimistic hash through
+ * `setTxHash`/`onSubmitted`, tracks wallet replacements, and rejects a cancelled
+ * or reverted receipt. Setting the success status and the post-success refreshes
+ * stay with the caller.
  */
 export declare function executeSwapTransaction({ wallet, publicClient, activeChain, market, inputToken, outputToken, swapQuote, permit, setStatus, setTxHash, onSubmitted }: {
     wallet: WalletSession;