@aegis-engine/core 0.1.3 → 0.2.0

package/README.md

@@ -102,15 +102,18 @@ simple integrations and demos.
 ## Backend V1 API
 
 The V1 backend/indexer contract is exposed as typed REST helpers. This is the
-public boundary for widget/core integrations once the backend service is live:
-AppSync, DynamoDB, indexer reads, provider adapters, quote storage, route hashes,
-allowlists, and final simulation stay behind the backend.
+public boundary for widget/core integrations: backend-owned config, token
+metadata, market discovery, allowlists, and fee policy come from REST. Swap
+execution remains client-side.
 
 ```ts
-import { createAegisBackendApiClient } from '@aegis-engine/core'
+import {
+  AEGIS_BACKEND_PROD_BASE_URL,
+  createAegisBackendApiClient
+} from '@aegis-engine/core'
 
 const aegisApi = createAegisBackendApiClient({
-  baseUrl: 'https://api.aegis.markets'
+  baseUrl: AEGIS_BACKEND_PROD_BASE_URL
 })
 
 const config = await aegisApi.config()
@@ -125,14 +128,7 @@ const quote = await aegisApi.quote({
   tokenIn: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
   tokenOut: '0x828B22c9ea1c20B551EeFC6198174C4bb7a8CBF6',
   amountIn: '1000000',
-  slippageBps: config.quote.defaultSlippageBps,
-  account
-})
-
-const build = await aegisApi.build({
-  quoteId: quote.quoteId,
-  account,
-  recipient: account
+  slippageBps: config.quote.defaultSlippageBps
 })
 ```
 
@@ -144,22 +140,12 @@ The backend endpoints are:
 - `GET /v1/tokens/by-address?chainId=1&addresses=0x...,0x...`
 - `GET /v1/markets?chainId=1`
 - `POST /v1/swap/quote`
-- `POST /v1/swap/build`
-- `GET /v1/status/tx/:chainId/:txHash`
-
-`quote` returns a short-lived `quoteId`, `quoteHash`, `routeHash`, expiry, gas,
-approval, and normalized fee data. `build` accepts only `quoteId`, `account`,
-`recipient`, and an optional Permit2 signature; token amounts, slippage, provider
-route data, router addresses, and spender addresses are not accepted in the
-build request. The backend must reject expired or tampered quotes, validate the
-chain/router/spender/pool allowlists, and simulate the unsigned transaction
-before returning wallet-ready `tx` data.
-
-Core still includes direct-pool and Kyber client-side helpers for the current
-widget flow. Those helpers are transitional for swap execution: once the backend
-service is available, production widget paths should fetch config, tokens,
-markets, quotes, builds, and transaction status through this REST client while
-wallet signing and transaction sending remain client-side.
+
+`quote` is indicative only. It returns normalized pricing, output fee policy,
+`asOf`, and warnings for fast first paint; it does not return executable route
+truth, calldata, or a transaction status handle. The widget/core must still
+re-quote, build, simulate, sign, and send client-side through the wallet/RPC
+execution helpers and validate execution against `/v1/config` allowlists.
 
 ## Direct Pool Market Config
 

package/dist/actions/directPoolSwap.d.ts

@@ -1,8 +1,8 @@
 import { type Hex, type PublicClient } from 'viem';
-import type { AegisSwapChainConfig, AegisSwapMarket, AegisSwapToken } from '../config';
-import { type DirectSwapQuote, type SwapQuoteMode } from '../quote';
-import type { AegisSwapApprovalMode, WalletSession } from '../swap/types';
-import type { AegisSwapActionCallbacks, AegisSwapActionResult } from './types';
+import type { AegisSwapChainConfig, AegisSwapMarket, AegisSwapToken } from '../config/index.js';
+import { type DirectSwapQuote, type SwapQuoteMode } from '../quote.js';
+import type { AegisSwapApprovalMode, WalletSession } from '../swap/types.js';
+import type { AegisSwapActionCallbacks, AegisSwapActionResult } from './types.js';
 export declare class DirectPoolSwapPriceMovedError extends Error {
     readonly quote: DirectSwapQuote;
     constructor(quote: DirectSwapQuote);

package/dist/actions/kyberSwap.d.ts

@@ -1,8 +1,8 @@
 import { type Address, type Hex, type PublicClient } from 'viem';
-import type { AegisSwapChainConfig, AegisSwapToken } from '../config';
-import type { AegisSwapApprovalMode, WalletSession } from '../swap/types';
-import type { AggregatedSwapQuote } from '../types/aggregatedSwap';
-import type { AegisSwapActionCallbacks, AegisSwapActionResult } from './types';
+import type { AegisSwapChainConfig, AegisSwapToken } from '../config/index.js';
+import type { AegisSwapApprovalMode, WalletSession } from '../swap/types.js';
+import type { AggregatedSwapQuote } from '../types/aggregatedSwap.js';
+import type { AegisSwapActionCallbacks, AegisSwapActionResult } from './types.js';
 export declare const NATIVE_TOKEN_ADDRESS: Address;
 export declare function isNativeToken(token: AegisSwapToken): boolean;
 export declare class KyberSwapPriceMovedError extends Error {

package/dist/actions/types.d.ts

@@ -1,8 +1,8 @@
 import type { Hex } from 'viem';
-import type { DirectSwapQuote } from '../quote';
-import type { AegisSwapReceiptSummary, SubmitStatus } from '../transactionProgress';
-import type { AggregatedSwapQuote } from '../types/aggregatedSwap';
-import type { AegisSwapSubmitDetails } from '../swap/types';
+import type { DirectSwapQuote } from '../quote.js';
+import type { AegisSwapReceiptSummary, SubmitStatus } from '../transactionProgress.js';
+import type { AggregatedSwapQuote } from '../types/aggregatedSwap.js';
+import type { AegisSwapSubmitDetails } from '../swap/types.js';
 export type AegisSwapActionCallbacks<TSwapDetails = AegisSwapSubmitDetails> = {
     onStatus?: (status: SubmitStatus) => void;
     onTxHash?: (hash: Hex | null) => void;

package/dist/actions/wallet.d.ts

@@ -1,7 +1,7 @@
 import type { Address } from 'viem';
-import type { AegisSwapChainConfig } from '../config';
-import type { WalletSession } from '../swap/types';
-import { type AegisSwapProviderResolver, type AegisSwapWalletConnection, type Eip1193Provider } from '../wallet';
+import type { AegisSwapChainConfig } from '../config/index.js';
+import type { WalletSession } from '../swap/types.js';
+import { type AegisSwapProviderResolver, type AegisSwapWalletConnection, type Eip1193Provider } from '../wallet.js';
 export declare function waitForProviderChain(provider: Eip1193Provider, targetChainId: number, attempts?: number, delayMs?: number): Promise<boolean>;
 export declare function ensureWalletChain(args: {
     provider: Eip1193Provider;