@aegis-engine/core 0.6.0 → 0.7.0

package/dist/swap/settlement.d.ts

@@ -4,6 +4,7 @@ export type SwapSettlementContext = {
     recipient: Address;
     /** Output token address; zero address or the 0xEeee… sentinel means native. */
     outputToken: Address;
+    inputToken?: Address;
 };
 /**
  * Best-effort decode of what the swap actually settled to the recipient:
@@ -13,3 +14,6 @@ export type SwapSettlementContext = {
  * never failed retroactively over display data.
  */
 export declare function resolveSettledAmountOut(publicClient: PublicClient, receipt: TransactionReceipt, settlement: SwapSettlementContext): Promise<bigint | undefined>;
+/** Receipt-local input transfers, net of token refunds. Native spends have no
+ * Transfer logs and remain unknown here rather than using a block balance guess. */
+export declare function resolveSettledAmountIn(receipt: TransactionReceipt, settlement: SwapSettlementContext): bigint | undefined;

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

@@ -27,7 +27,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.7.0",
   "description": "React-free Aegis Swap and Engine quoting, risk, approval, and execution operations.",
   "license": "MIT",
   "type": "module",