@aegis-engine/core 0.1.3 → 0.3.0

package/dist/backendAdapters.d.ts

@@ -0,0 +1,41 @@
+import type { AegisBackendConfig, AegisBackendMarket, AegisBackendToken } from './contract/backendClient.js';
+import { type AegisSwapChainConfig, type AegisSwapChainConfigInput, type AegisSwapPoolConfig, type AegisSwapToken } from './config/index.js';
+/**
+ * The adapters below drop chains/markets that arrive incomplete or inconsistent
+ * (missing contracts, no RPC, or a poolKey that doesn't hash to its poolId).
+ * Two visibility channels:
+ * - `onSkip` (per call, additive): structured diagnostics so hosts can emit
+ *   telemetry and distinguish "backend returned nothing" from "client dropped
+ *   everything".
+ * - `globalThis.__AEGIS_SWAP_DEBUG__ = true`: opt-in console breadcrumb for
+ *   local debugging. Off by default, so production stays silent.
+ */
+export type AegisBackendAdapterSkip = {
+    kind: 'chain' | 'market';
+    chainId: number;
+    /** Present for market skips only. */
+    marketId?: string;
+    reason: string;
+    /** The raw breadcrumb payload (booleans/messages behind the reason). */
+    context: Record<string, unknown>;
+};
+export type AegisBackendAdapterSkipHandler = (skip: AegisBackendAdapterSkip) => void;
+export type AegisBackendChainOptions = {
+    rpcUrls?: readonly string[] | Partial<Record<number, readonly string[]>>;
+    metadataEndpoint?: string | null;
+    /** Backend chain ids the host project exposes. Omit to use every backend chain. */
+    enabledChainIds?: readonly number[];
+    /** Structured diagnostics for every chain the adapter drops. */
+    onSkip?: AegisBackendAdapterSkipHandler;
+};
+export declare function backendTokenToAegisSwapToken(token: AegisBackendToken): AegisSwapToken;
+export declare function backendTokensToAegisSwapTokens(tokens: readonly AegisBackendToken[]): AegisSwapToken[];
+export declare function createAegisSwapChainsFromBackendConfig(config: AegisBackendConfig, hostChains?: Partial<Record<number, AegisSwapChainConfigInput>>, options?: AegisBackendChainOptions): Record<number, AegisSwapChainConfig>;
+export declare function createAegisSwapPoolsFromBackendMarkets({ config, markets, tokens, enabledOnly, onSkip }: {
+    config: AegisBackendConfig;
+    markets: readonly AegisBackendMarket[];
+    tokens: readonly AegisBackendToken[];
+    enabledOnly?: boolean;
+    /** Structured diagnostics for every market the adapter drops. */
+    onSkip?: AegisBackendAdapterSkipHandler;
+}): AegisSwapPoolConfig[];

package/dist/config/chains.d.ts

@@ -1,5 +1,5 @@
 import { type Hex } from 'viem';
-import type { AegisSwapChainConfig, AegisSwapChainConfigInput } from './types';
+import type { AegisSwapChainConfig, AegisSwapChainConfigInput } from './types.js';
 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>;

package/dist/config/constants.d.ts

@@ -1,5 +1,7 @@
+import { type Address } from 'viem';
 export declare const AEGIS_SWAP_CHAIN_ID = 1;
 export declare const AEGIS_SWAP_ROUTER: `0x${string}`;
+export declare const AEGIS_SWAP_TRUSTED_ROUTERS_BY_CHAIN: Partial<Record<number, readonly Address[]>>;
 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;
@@ -8,3 +10,5 @@ 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}`;
+export declare const AGGREGATED_SWAP_KYBER_ROUTER: `0x${string}`;
+export declare const AGGREGATED_SWAP_SUPPORTED_CHAIN_IDS: readonly [1];

package/dist/config/contracts.d.ts

@@ -1,4 +1,4 @@
-import type { AegisSwapUniswapV4Contracts, AegisSwapUniswapV4ContractsInput } from './types';
+import type { AegisSwapUniswapV4Contracts, AegisSwapUniswapV4ContractsInput } from './types.js';
 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;

package/dist/config/index.d.ts

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

package/dist/config/markets.d.ts

@@ -1,3 +1,3 @@
-import type { AegisSwapChainConfig, AegisSwapMarket, AegisSwapPoolConfig } from './types';
+import type { AegisSwapChainConfig, AegisSwapMarket, AegisSwapPoolConfig } from './types.js';
 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

@@ -1,4 +1,4 @@
-import type { AegisSwapBuiltInTokenSymbol, AegisSwapToken, AggregatedSwapDefaultTokenSymbol, AggregatedSwapToken, AggregatedSwapWolfGameTokenSymbol } from './types';
+import type { AegisSwapBuiltInTokenSymbol, AegisSwapToken, AggregatedSwapDefaultTokenSymbol, AggregatedSwapToken, AggregatedSwapWolfGameTokenSymbol } from './types.js';
 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>;

package/dist/config/types.d.ts

@@ -12,6 +12,11 @@ export type AegisSwapToken = {
     symbol: AegisSwapTokenSymbol;
     decimals: number;
     iconUrl?: string | null;
+    /** Spot USD price per whole token, when the source provides one. Optional so
+        host-supplied token lists without pricing still type-check. */
+    priceUsd?: number;
+    /** Marks a USD-pegged stablecoin (from the backend); presentational only. */
+    stable?: boolean;
 };
 export type AegisPoolKey = {
     currency0: Address;

package/dist/contract/backendClient.d.ts

@@ -0,0 +1,118 @@
+import type { z } from 'zod';
+import type { Address, Hex } from 'viem';
+import type { AegisPoolKey } from '../config/index.js';
+import { aegisBackendSwapQuoteRequestSchema } from './schemas.js';
+import type { components, paths } from './generated/aegis-swap.js';
+export type AegisBackendOpenApiPaths = paths;
+export type AegisBackendOpenApiComponents = components;
+type AegisBackendWireConfig = components['schemas']['SwapConfig'];
+type AegisBackendWireToken = components['schemas']['Token'];
+type AegisBackendWireMarket = components['schemas']['Market'];
+type AegisBackendWireSwapQuoteRequest = components['schemas']['SwapQuoteRequest'];
+type AegisBackendWireSwapQuoteResponse = components['schemas']['SwapQuoteResponse'];
+export type AegisBackendSwapProvider = AegisBackendWireConfig['providers'][number];
+export type AegisBackendQuoteMode = AegisBackendWireSwapQuoteRequest['mode'];
+export type AegisBackendMarketStatus = AegisBackendWireMarket['status'];
+export declare const AEGIS_BACKEND_PROD_BASE_URL = "https://nlkvpvkx9h.execute-api.us-east-1.amazonaws.com/prod";
+export type AegisBackendChain = Omit<AegisBackendWireConfig['chains'][number], 'chainId'> & {
+    chainId: number;
+};
+export type AegisBackendQuoteDefaults = {
+    [Field in keyof AegisBackendWireConfig['quote']]: 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 AegisBackendContractsByChain = {
+    [ChainId in keyof AegisBackendWireConfig['contracts']]: AegisBackendContractRegistry;
+};
+export type AegisBackendAllowlistsByChain = {
+    [ChainId in keyof AegisBackendWireConfig['allowlists']]: AegisBackendAddressAllowlist;
+};
+export type AegisBackendFeeConfig = Omit<AegisBackendWireConfig['fee'], 'recipient' | 'outputFeeBps'> & {
+    recipient: Address;
+    outputFeeBps: number;
+};
+export type AegisBackendConfig = Omit<AegisBackendWireConfig, 'chains' | 'quote' | 'contracts' | 'allowlists' | 'fee'> & {
+    chains: AegisBackendChain[];
+    quote: AegisBackendQuoteDefaults;
+    contracts: AegisBackendContractsByChain;
+    allowlists: AegisBackendAllowlistsByChain;
+    fee: AegisBackendFeeConfig;
+};
+export type AegisBackendToken = Omit<AegisBackendWireToken, 'address' | 'chainId'> & {
+    address: Address;
+    chainId: number;
+};
+export type AegisBackendMarketMetrics = AegisBackendWireMarket['metrics'];
+export type AegisBackendMarket = Omit<AegisBackendWireMarket, 'baseToken' | 'quoteToken' | 'poolId' | 'poolKey' | 'chainId'> & {
+    baseToken: Address;
+    quoteToken: Address;
+    poolId: Hex;
+    poolKey: AegisPoolKey;
+    chainId: number;
+};
+export type AegisBackendSwapQuoteRequest = z.infer<typeof aegisBackendSwapQuoteRequestSchema>;
+export type AegisBackendSwapQuoteResponse = Omit<AegisBackendWireSwapQuoteResponse, 'tokenIn' | 'tokenOut' | 'fee'> & {
+    tokenIn: Address;
+    tokenOut: Address;
+    fee: AegisBackendFeeConfig;
+};
+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>;
+};
+export declare function normalizeAegisBackendBaseUrl(baseUrl: string): string;
+export declare function createAegisBackendApiClient(options: AegisBackendApiClientOptions): AegisBackendApiClient;
+export {};