@aegis-engine/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aegis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# Aegis Core
+
+React-free swap operations for Aegis integrations.
+
+This package exposes the operational pieces that the widget uses internally:
+direct pool quotes and execution, KyberSwap quotes and execution, Permit2
+authorization helpers, chain/wallet helpers, token and market config, and
+transaction progress types.
+
+```ts
+import {
+  AEGIS_SWAP_MAINNET_CHAIN,
+  AEGIS_SWAP_MARKETS,
+  AEGIS_SWAP_TOKENS,
+  createSwapPublicClient,
+  executeDirectPoolSwap,
+  resolveWalletSession
+} from '@aegis-engine/core'
+
+const publicClient = createSwapPublicClient(
+  AEGIS_SWAP_MAINNET_CHAIN.chain,
+  AEGIS_SWAP_MAINNET_CHAIN.rpcUrls
+)
+const wallet = await resolveWalletSession()
+
+const result = await executeDirectPoolSwap({
+  wallet,
+  publicClient,
+  activeChain: AEGIS_SWAP_MAINNET_CHAIN,
+  market: AEGIS_SWAP_MARKETS.WATER_USDC,
+  inputToken: AEGIS_SWAP_TOKENS.USDC,
+  outputToken: AEGIS_SWAP_TOKENS.WATER,
+  mode: 'exactIn',
+  amount: 1_000_000n,
+  slippageBps: 100
+})
+```
+
+For Kyber routes, call `executeKyberSwap` with an input token, output token,
+amount, and slippage. Both execution actions accept callbacks for status,
+transaction hash, and submitted swap details so a host UI can render its own
+progress surfaces.

package/dist/abis.d.ts

@@ -0,0 +1,205 @@
+export declare const AEGIS_ROUTER_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "execute";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly name: "batches";
+        readonly type: "tuple[]";
+        readonly components: readonly [{
+            readonly name: "requiresV4Unlock";
+            readonly type: "bool";
+        }, {
+            readonly name: "actions";
+            readonly type: "bytes";
+        }, {
+            readonly name: "params";
+            readonly type: "bytes[]";
+        }];
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "multicall";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly name: "data";
+        readonly type: "bytes[]";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "results";
+        readonly type: "bytes[]";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "permitBatch";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "permitBatch";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "details";
+            readonly type: "tuple[]";
+            readonly components: readonly [{
+                readonly name: "token";
+                readonly type: "address";
+            }, {
+                readonly name: "amount";
+                readonly type: "uint160";
+            }, {
+                readonly name: "expiration";
+                readonly type: "uint48";
+            }, {
+                readonly name: "nonce";
+                readonly type: "uint48";
+            }];
+        }, {
+            readonly name: "spender";
+            readonly type: "address";
+        }, {
+            readonly name: "sigDeadline";
+            readonly type: "uint256";
+        }];
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}];
+export declare const PERMIT2_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "approve";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint160";
+    }, {
+        readonly name: "expiration";
+        readonly type: "uint48";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "allowance";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint160";
+    }, {
+        readonly name: "expiration";
+        readonly type: "uint48";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint48";
+    }];
+}];
+export declare const UNISWAP_V4_QUOTER_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "quoteExactInputSingle";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "params";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "poolKey";
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly name: "currency0";
+                readonly type: "address";
+            }, {
+                readonly name: "currency1";
+                readonly type: "address";
+            }, {
+                readonly name: "fee";
+                readonly type: "uint24";
+            }, {
+                readonly name: "tickSpacing";
+                readonly type: "int24";
+            }, {
+                readonly name: "hooks";
+                readonly type: "address";
+            }];
+        }, {
+            readonly name: "zeroForOne";
+            readonly type: "bool";
+        }, {
+            readonly name: "exactAmount";
+            readonly type: "uint128";
+        }, {
+            readonly name: "hookData";
+            readonly type: "bytes";
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "amountOut";
+        readonly type: "uint256";
+    }, {
+        readonly name: "gasEstimate";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "quoteExactOutputSingle";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "params";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "poolKey";
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly name: "currency0";
+                readonly type: "address";
+            }, {
+                readonly name: "currency1";
+                readonly type: "address";
+            }, {
+                readonly name: "fee";
+                readonly type: "uint24";
+            }, {
+                readonly name: "tickSpacing";
+                readonly type: "int24";
+            }, {
+                readonly name: "hooks";
+                readonly type: "address";
+            }];
+        }, {
+            readonly name: "zeroForOne";
+            readonly type: "bool";
+        }, {
+            readonly name: "exactAmount";
+            readonly type: "uint128";
+        }, {
+            readonly name: "hookData";
+            readonly type: "bytes";
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "amountIn";
+        readonly type: "uint256";
+    }, {
+        readonly name: "gasEstimate";
+        readonly type: "uint256";
+    }];
+}];

package/dist/actions/directPoolSwap.d.ts

@@ -0,0 +1,39 @@
+import { type Hex, type PublicClient } from 'viem';
+import type { AegisSwapChainConfig, AegisSwapFeeConfig, AegisSwapMarket, AegisSwapToken } from '../config';
+import { type DirectSwapQuote, type SwapQuoteMode } from '../quote';
+import type { AegisSwapApprovalMode, WalletSession } from '../swap/types';
+import type { AegisSwapActionCallbacks, AegisSwapActionResult } from './types';
+export declare class DirectPoolSwapPriceMovedError extends Error {
+    readonly quote: DirectSwapQuote;
+    constructor(quote: DirectSwapQuote);
+}
+export type DirectPoolSwapApprovalResult = {
+    approvalHash: Hex | null;
+    allowance: bigint;
+};
+export declare function approveDirectPoolSwapInput(args: {
+    wallet: WalletSession;
+    publicClient: PublicClient;
+    activeChain: AegisSwapChainConfig;
+    token: AegisSwapToken;
+    permit2: AegisSwapMarket['permit2'];
+    amount: bigint;
+    approvalMode?: AegisSwapApprovalMode;
+    onStatus?: AegisSwapActionCallbacks['onStatus'];
+}): Promise<DirectPoolSwapApprovalResult>;
+export declare function executeDirectPoolSwap(args: {
+    wallet: WalletSession;
+    publicClient: PublicClient;
+    activeChain: AegisSwapChainConfig;
+    market: AegisSwapMarket;
+    inputToken: AegisSwapToken;
+    outputToken: AegisSwapToken;
+    mode: SwapQuoteMode;
+    amount: bigint;
+    slippageBps: number;
+    fee?: AegisSwapFeeConfig | null;
+    displayedQuote?: DirectSwapQuote | null;
+    approvalMode?: AegisSwapApprovalMode;
+    signal?: AbortSignal;
+    onWalletChainId?: (chainId: number | null) => void;
+} & AegisSwapActionCallbacks): Promise<AegisSwapActionResult<DirectSwapQuote>>;

package/dist/actions/kyberSwap.d.ts

@@ -0,0 +1,38 @@
+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';
+export declare const NATIVE_TOKEN_ADDRESS: Address;
+export declare function isNativeToken(token: AegisSwapToken): boolean;
+export declare class KyberSwapPriceMovedError extends Error {
+    readonly quote: AggregatedSwapQuote;
+    constructor(quote: AggregatedSwapQuote);
+}
+export type KyberSwapApprovalResult = {
+    approvalHashes: Hex[];
+    allowance: bigint;
+};
+export declare function approveKyberSwapInput(args: {
+    wallet: WalletSession;
+    publicClient: PublicClient;
+    activeChain: AegisSwapChainConfig;
+    inputToken: AegisSwapToken;
+    spender: Address;
+    amount: bigint;
+    approvalMode?: AegisSwapApprovalMode;
+    onStatus?: AegisSwapActionCallbacks['onStatus'];
+}): Promise<KyberSwapApprovalResult>;
+export declare function executeKyberSwap(args: {
+    wallet: WalletSession;
+    publicClient: PublicClient;
+    activeChain: AegisSwapChainConfig;
+    inputToken: AegisSwapToken;
+    outputToken: AegisSwapToken;
+    amount: bigint;
+    slippageBps: number;
+    displayedQuote?: AggregatedSwapQuote | null;
+    approvalMode?: AegisSwapApprovalMode;
+    signal?: AbortSignal;
+    onWalletChainId?: (chainId: number | null) => void;
+} & AegisSwapActionCallbacks): Promise<AegisSwapActionResult<AggregatedSwapQuote>>;

package/dist/actions/types.d.ts

@@ -0,0 +1,17 @@
+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';
+export type AegisSwapActionCallbacks<TSwapDetails = AegisSwapSubmitDetails> = {
+    onStatus?: (status: SubmitStatus) => void;
+    onTxHash?: (hash: Hex | null) => void;
+    onSubmitted?: (hash: Hex, swap?: TSwapDetails) => void;
+};
+export type AegisSwapActionResult<TQuote = DirectSwapQuote | AggregatedSwapQuote> = {
+    hash: Hex;
+    explorerUrl: string;
+    quote: TQuote;
+    receiptSummary: AegisSwapReceiptSummary;
+    swap: AegisSwapSubmitDetails;
+};

package/dist/actions/wallet.d.ts

@@ -0,0 +1,17 @@
+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';
+export declare function waitForProviderChain(provider: Eip1193Provider, targetChainId: number, attempts?: number, delayMs?: number): Promise<boolean>;
+export declare function ensureWalletChain(args: {
+    provider: Eip1193Provider;
+    chain: AegisSwapChainConfig;
+    onChainId?: (chainId: number | null) => void;
+}): Promise<void>;
+export declare function resolveWalletSession(args?: {
+    provider?: Eip1193Provider | null;
+    account?: Address | string | null;
+    getProvider?: AegisSwapProviderResolver;
+    connectWallet?: () => Promise<AegisSwapWalletConnection | void>;
+    requestAccount?: boolean;
+}): Promise<WalletSession>;

package/dist/address.d.ts

@@ -0,0 +1,5 @@
+import type { Address, Hex } from 'viem';
+export declare function addressKey(address: Address | null | undefined): string;
+export declare function sameAddress(a: Address, b: Address): boolean;
+export declare function sameOptionalAddress(a: Address | null, b: Address | null): boolean;
+export declare function samePoolId(a: Hex, b: Hex): boolean;