@aegis-engine/core 0.6.0 → 0.8.0

package/dist/transactionProgress.d.ts

@@ -19,6 +19,8 @@ export type AegisSwapReceiptSummary = {
      * case UIs should keep showing the quote estimate with a "~" affordance.
      */
     settledAmountOut?: bigint;
+    /** Net input-token transfers from the payer in this receipt, after refunds. */
+    settledAmountIn?: bigint;
 };
 export declare function isBusy(status: SubmitStatus): boolean;
 export type TransactionProgressState = 'pending' | 'mining' | 'success' | 'error';
@@ -51,12 +53,42 @@ export type TransactionProgressView = {
     state: TransactionProgressState;
     label: string;
     walletPrompts: AegisSwapWalletPromptProgress;
-    /** Calm fill showing completed wallet-provider prompts. */
+    /** Calm fill showing settled rail steps; the final action settles on receipt. */
     completePct: number;
     /** Visual activity layer width; pending/mining sweeps full-width by default. */
     activeWidthPct: number;
+    /**
+     * Steps the rail divides itself into, so a three-step flow reads
+     * 33/66/100 instead of one indivisible half. Presentation only, and separate
+     * from `walletPrompts`: the Engine counts settlement steps it can name, not
+     * provider prompts it cannot predict. Absent when the total is not known
+     * before the first prompt — the rail then stays one continuous bar rather
+     * than inventing a denominator that could grow mid-flight.
+     */
+    steps?: number;
+};
+/**
+ * Chips the top rail divides itself into. Explicit settlement steps when a
+ * producer counts them, else the wallet-prompt plan — which is the swap path's
+ * step count already. Fewer than two is not a division worth drawing, so the
+ * rail stays one continuous bar. Where along those chips the bar sits comes
+ * from `completePct`, so only the count is needed here.
+ */
+export declare function progressRailSteps(view: TransactionProgressView | null | undefined): number | undefined;
+export declare function normalizeProgressCount(value: number): number;
+/** Shared geometry for every widget and host rail. The final action is only
+ * complete after confirmation, even if every wallet prompt has finished. */
+export declare function transactionSequenceProgress({ total, completed, confirmed }: {
+    total: number;
+    completed: number;
+    confirmed?: boolean;
+}): {
+    total: number;
+    completed: number;
+    completePct: number;
+    steps?: number;
 };
-export declare function transactionProgressView({ status, inputSymbol, txHash, transactionStage, actionError, approvalRequired, approvalDone, resetRequired, approvalsCompleted, authorizationRequired, authorizationPrompts, authorizationsCompleted }: {
+export declare function transactionProgressView({ status, inputSymbol, txHash, transactionStage, actionError, approvalRequired, approvalPrompts, approvalDone, resetRequired, approvalsCompleted, authorizationRequired, authorizationPrompts, authorizationsCompleted }: {
     status: SubmitStatus;
     inputSymbol: string;
     txHash: Hex | null;
@@ -64,6 +96,8 @@ export declare function transactionProgressView({ status, inputSymbol, txHash, t
     transactionStage?: 'permission' | 'swap' | null;
     actionError: string | null;
     approvalRequired: boolean;
+    /** Explicit executor plan, including every prerequisite approval. */
+    approvalPrompts?: number;
     approvalDone: boolean;
     /** Whether the approval spends an extra approve(0) prompt first. */
     resetRequired?: boolean;
@@ -89,6 +123,11 @@ export type AegisSwapStatusSnapshot = {
     /** Rail geometry; null while idle. */
     completePct: number | null;
     activeWidthPct: number | null;
+    /**
+     * Segmented rail chip count; null for a continuous or hidden rail.
+     * Optional so existing host-authored snapshot fixtures may omit it.
+     */
+    steps?: number | null;
     txHash: Hex | null;
     /**
      * Submission-time chain, account, and asset identity for `txHash`. Null

package/dist/wallet.d.ts

@@ -1,10 +1,14 @@
 import { type Address, type Chain, type PublicClient } from 'viem';
+export declare const SDK_RPC_MULTICALL_RULE_ID: "SDK-RPC-001";
 export type Eip1193Provider = {
     request<T = unknown>(args: {
         method: string;
         params?: unknown[] | Record<string, unknown>;
     }): Promise<T>;
 };
+/** Stop later requests, including requests viem starts after an internal await.
+ * A request already handed to the wallet retains its result for receipt tracking. */
+export declare function withWalletRequestSignal(provider: Eip1193Provider, signal?: AbortSignal): Eip1193Provider;
 export type ProviderChainConfig = {
     chainId: number;
     name?: string;
@@ -27,7 +31,7 @@ export declare function getProviderAccount(provider: Eip1193Provider): Promise<A
 export declare function requestProviderAccount(provider: Eip1193Provider): Promise<Address | null>;
 export declare function getProviderChainId(provider: Eip1193Provider): Promise<number | null>;
 export declare function switchProviderChain(provider: Eip1193Provider, chain: number | ProviderChainConfig): Promise<void>;
-export declare function createSwapPublicClient(chain: Chain, rpcUrls: readonly string[]): PublicClient;
+export declare function createSwapPublicClient(chain: Chain, rpcUrls: readonly string[], readProvider?: Eip1193Provider): PublicClient;
 export declare function subscribeProvider(provider: Eip1193Provider, handlers: {
     onAccountsChanged?: () => void;
     onChainChanged?: () => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aegis-engine/core",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "React-free Aegis Swap and Engine quoting, risk, approval, and execution operations.",
   "license": "MIT",
   "type": "module",
@@ -14,7 +14,13 @@
       "require": null,
       "default": "./dist/aegis-core.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./account": {
+      "types": "./dist/account.d.ts",
+      "import": "./dist/account.js",
+      "require": null,
+      "default": "./dist/account.js"
+    }
   },
   "publishConfig": {
     "access": "public"
@@ -29,8 +35,9 @@
     "viem": "^2.23.1"
   },
   "devDependencies": {
-    "@labs-solo/aegis-engine-sdk": "0.33.0",
+    "@labs-solo/aegis-engine-sdk": "0.40.0",
     "@types/node": "^25.9.1",
+    "fast-check": "^4.9.0",
     "openapi-typescript": "^7.13.0",
     "typescript": "~5.6.2",
     "viem": "^2.54.3",
@@ -52,8 +59,8 @@
   },
   "bugs": "https://github.com/amplifi-liquidity/aegis-widget/issues",
   "scripts": {
-    "openapi:generate": "openapi-typescript ./openapi/aegis-swap.json -o ./src/contract/generated/aegis-swap.ts",
-    "openapi:check": "pnpm run openapi:generate && git diff --exit-code -- src/contract/generated/aegis-swap.ts",
+    "openapi:generate": "openapi-typescript ./openapi/aegis-swap.json -o ./src/contract/generated/aegis-swap.ts && openapi-typescript ./openapi/market-data.json -o ./src/contract/generated/market-data.ts",
+    "openapi:check": "pnpm run openapi:generate && git diff --exit-code -- src/contract/generated/aegis-swap.ts src/contract/generated/market-data.ts",
     "typecheck": "tsc -p tsconfig.build.json --noEmit",
     "typecheck:test": "tsc -p tsconfig.test.json --noEmit",
     "test": "vitest run",