@aegis-engine/core 0.4.0 → 0.6.0

package/dist/swap/authorizePermit.d.ts

@@ -3,6 +3,7 @@ import type { AegisSwapChainConfig } from '../config/index.js';
 import type { SignedPermitBatch } from '../encoding.js';
 import { readPermit2RouterAllowance } from '../permit.js';
 import type { SubmitStatus } from '../transactionProgress.js';
+import type { AegisSwapAuthorizationProgress } from '../actions/types.js';
 import type { AegisSwapApprovalMode, WalletSession } from './types.js';
 /**
  * Produces the Permit2 authorization the swap calldata needs.
@@ -15,7 +16,7 @@ import type { AegisSwapApprovalMode, WalletSession } from './types.js';
  * would have carried, and this returns `null` so the swap proceeds without an
  * inline permit. A user rejection is rethrown untouched.
  */
-export declare function authorizePermit({ wallet, publicClient, activeChain, permit2, router, token, amount, approvalMode, allowanceRead, setStatus }: {
+export declare function authorizePermit({ wallet, publicClient, activeChain, permit2, router, token, amount, approvalMode, allowanceRead, setStatus, onAuthorizationProgress, onWalletRequest, onHash }: {
     wallet: WalletSession;
     publicClient: PublicClient;
     activeChain: AegisSwapChainConfig;
@@ -26,4 +27,7 @@ export declare function authorizePermit({ wallet, publicClient, activeChain, per
     approvalMode: AegisSwapApprovalMode;
     allowanceRead: ReturnType<typeof readPermit2RouterAllowance>;
     setStatus: (status: SubmitStatus) => void;
+    onAuthorizationProgress?: (progress: AegisSwapAuthorizationProgress) => void;
+    onWalletRequest?: () => void;
+    onHash?: (hash: import('viem').Hex) => void;
 }): Promise<SignedPermitBatch | null>;

package/dist/swap/receiptWait.d.ts

@@ -4,9 +4,9 @@ export declare const SWAP_RECEIPT_TIMEOUT_MS: number;
 type OnReplacedParameter = NonNullable<Parameters<PublicClient['waitForTransactionReceipt']>[0]['onReplaced']>;
 /**
  * waitForTransactionReceipt with a hard timeout, mapping viem's timeout error
- * to the SDK's TransactionReceiptTimeoutError (which carries the tx hash so
- * the UI can degrade to an explorer link). Every other failure passes through
- * untouched.
+ * to a submitted-receipt error carrying the latest hash. Terminal replacement
+ * and revert errors remain terminal; every unresolved RPC failure stays
+ * receipt-recoverable instead of making the original call safe to resend.
  */
 export declare function waitForReceiptWithTimeout(args: {
     publicClient: PublicClient;
@@ -14,4 +14,27 @@ export declare function waitForReceiptWithTimeout(args: {
     timeoutMs: number;
     onReplaced?: OnReplacedParameter;
 }): Promise<TransactionReceipt>;
+export type SubmittedReceiptOutcome = Readonly<{
+    status: 'confirmed' | 'reverted' | 'cancelled';
+    hash: Hex;
+    replacesHash?: Hex;
+    receipt: TransactionReceipt;
+}> | Readonly<{
+    status: 'unresolved';
+    hash: Hex;
+    replacesHash?: Hex;
+}>;
+/**
+ * Reconciles one already-submitted transaction without any broadcast path.
+ *
+ * A speed-up (`repriced`) preserves the submitted call. A generic same-nonce
+ * replacement or wallet cancellation does not, so even a successful receipt
+ * for either is reported as cancelled. RPC and timeout failures stay
+ * unresolved because the original transaction may still mine.
+ */
+export declare function reconcileSubmittedReceipt(args: {
+    publicClient: Pick<PublicClient, 'waitForTransactionReceipt'>;
+    hash: Hex;
+    timeoutMs: number;
+}): Promise<SubmittedReceiptOutcome>;
 export {};

package/dist/swap/sendSwapTransaction.d.ts

@@ -2,6 +2,19 @@ import { type Address, type Chain, type Hex, type PublicClient, type Transaction
 import type { AegisSwapReceiptSummary } from '../transactionProgress.js';
 import { type SwapSettlementContext } from './settlement.js';
 import type { AegisSwapSubmitDetails, WalletSession } from './types.js';
+/**
+ * Settlement facts (gas, block, fee) lifted off a mined receipt.
+ *
+ * viem types gasUsed/effectiveGasPrice as required bigints, but a non-EIP-1559
+ * chain or a lean RPC can omit them; fall back to 0n so the summary degrades
+ * gracefully (the view hides zero rows) instead of throwing.
+ */
+export declare function summarizeTransactionReceipt(receipt: {
+    transactionHash: Hex;
+    blockNumber?: bigint;
+    gasUsed?: bigint;
+    effectiveGasPrice?: bigint;
+}): AegisSwapReceiptSummary;
 /**
  * Guarded send pipeline shared by the swap and engine planes.
  *
@@ -30,6 +43,8 @@ export declare function sendGuardedTransactionAndAwait(args: {
     data: Hex;
     value: bigint;
     gas?: bigint;
+    /** Cancels only before a transaction hash exists. */
+    signal?: AbortSignal;
     cancelledMessage: string;
     revertedMessage: string;
     onHash?: (hash: Hex | null) => void;

package/dist/transactionProgress.d.ts

@@ -1,4 +1,4 @@
-import type { Hex } from 'viem';
+import type { Address, Hex } from 'viem';
 export type SubmitStatus = 'idle' | 'approving' | 'signing' | 'submitting' | 'success';
 /**
  * On-chain settlement facts pulled from the swap's mined receipt. Raw base
@@ -29,6 +29,24 @@ export type AegisSwapWalletPromptProgress = {
     /** 1-based prompt currently awaiting the wallet; null while idle/mining/terminal. */
     active: number | null;
 };
+/** Immutable token identity recorded when the swap transaction is broadcast. */
+export type AegisSwapStatusTransactionToken = {
+    address: Address;
+    symbol: string;
+};
+/**
+ * Immutable execution identity attached to status snapshots once a transaction
+ * hash exists. Hosts can keep rendering and indexing the submitted swap even
+ * if controlled chain, account, or market props change while it confirms.
+ */
+export type AegisSwapStatusTransactionContext = {
+    hash: Hex;
+    chainId: number;
+    account: Address;
+    inputToken: AegisSwapStatusTransactionToken;
+    outputToken: AegisSwapStatusTransactionToken;
+    explorerUrl: string | null;
+};
 export type TransactionProgressView = {
     state: TransactionProgressState;
     label: string;
@@ -38,14 +56,28 @@ export type TransactionProgressView = {
     /** Visual activity layer width; pending/mining sweeps full-width by default. */
     activeWidthPct: number;
 };
-export declare function transactionProgressView({ status, inputSymbol, txHash, actionError, approvalRequired, approvalDone, authorizationRequired }: {
+export declare function transactionProgressView({ status, inputSymbol, txHash, transactionStage, actionError, approvalRequired, approvalDone, resetRequired, approvalsCompleted, authorizationRequired, authorizationPrompts, authorizationsCompleted }: {
     status: SubmitStatus;
     inputSymbol: string;
     txHash: Hex | null;
+    /** Which submitted transaction owns txHash during receipt recovery. */
+    transactionStage?: 'permission' | 'swap' | null;
     actionError: string | null;
     approvalRequired: boolean;
     approvalDone: boolean;
+    /** Whether the approval spends an extra approve(0) prompt first. */
+    resetRequired?: boolean;
+    /**
+     * Approval prompts already confirmed on-chain, from the executor's
+     * onApprovalProgress. Only read while approving — the later phases place the
+     * approval step behind them regardless.
+     */
+    approvalsCompleted?: number;
     authorizationRequired: boolean;
+    /** Executor-reported Permit2 prompts; overrides the boolean prediction. */
+    authorizationPrompts?: number;
+    /** Permit2 authorization prompts already completed by the wallet. */
+    authorizationsCompleted?: number;
 }): TransactionProgressView | null;
 export type AegisSwapStatusSnapshot = {
     status: SubmitStatus;
@@ -58,5 +90,11 @@ export type AegisSwapStatusSnapshot = {
     completePct: number | null;
     activeWidthPct: number | null;
     txHash: Hex | null;
+    /**
+     * Submission-time chain, account, and asset identity for `txHash`. Null
+     * before broadcast. Optional so existing host-authored snapshot fixtures
+     * remain source-compatible.
+     */
+    transaction?: AegisSwapStatusTransactionContext | null;
     error: string | null;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aegis-engine/core",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "React-free Aegis Swap and Engine quoting, risk, approval, and execution operations.",
   "license": "MIT",
   "type": "module",
@@ -57,6 +57,7 @@
     "typecheck": "tsc -p tsconfig.build.json --noEmit",
     "typecheck:test": "tsc -p tsconfig.test.json --noEmit",
     "test": "vitest run",
+    "test:fork": "vitest run --config vitest.fork.config.ts",
     "build": "vite build && tsc -p tsconfig.build.json && node ../../scripts/fix-dts-imports.mjs ."
   }
 }