@aegis-engine/core 0.2.0 → 0.3.0

package/dist/backendAdapters.d.ts

@@ -1,17 +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 }: {
+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/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/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

@@ -14,8 +14,12 @@ export type AegisBackendSwapProvider = AegisBackendWireConfig['providers'][numbe
 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 = AegisBackendWireConfig['chains'][number];
-export type AegisBackendQuoteDefaults = AegisBackendWireConfig['quote'];
+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;
@@ -33,23 +37,28 @@ export type AegisBackendContractsByChain = {
 export type AegisBackendAllowlistsByChain = {
     [ChainId in keyof AegisBackendWireConfig['allowlists']]: AegisBackendAddressAllowlist;
 };
-export type AegisBackendFeeConfig = Omit<AegisBackendWireConfig['fee'], 'recipient'> & {
+export type AegisBackendFeeConfig = Omit<AegisBackendWireConfig['fee'], 'recipient' | 'outputFeeBps'> & {
     recipient: Address;
+    outputFeeBps: number;
 };
-export type AegisBackendConfig = Omit<AegisBackendWireConfig, 'contracts' | 'allowlists' | 'fee'> & {
+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'> & {
+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'> & {
+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'> & {
@@ -104,5 +113,6 @@ export type AegisBackendApiClient = {
     }, 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 {};