aegis-swap-widget 0.3.2 → 0.3.4

package/CHANGELOG.md

@@ -1,13 +1,31 @@
 # Changelog
 
+## 0.3.4
+
+### Patch Changes
+
+- effa726: Consume shared logic from @aegis-engine/core via workspace dependency; new ./core subpath re-export; GRASS_USDC routes through the 30-tick reference pool
+- Updated dependencies [effa726]
+  - @aegis-engine/core@0.1.2
+
 All notable changes to this project are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.3] - 2026-06-08
+
+### Fixed
+
+- Re-pointed the bundled `GRASS_USDC` market to the 30-tick-spacing pool
+  (`0xc516dba7bd70aa2dcb986bb1c27208ea29ecd097fa0ce636611e88e54ae4444d`)
+  designated by the Aegis pools API as the reference pool holding the deep
+  liquidity.
+
 ## [0.3.2] - 2026-06-08
 
 ### Added
+
 - Added controlled Trade details drawer state via `executionDetailsOpen` and
   `onExecutionDetailsOpenChange`. Hosts can now coordinate the drawer with
   their own layout while the widget keeps its existing uncontrolled
@@ -16,6 +34,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.3.1] - 2026-06-08
 
 ### Added
+
 - Added a `Trade` / `Latest tx` switch inside the Trade details drawer. After a
   successful swap, the drawer opens to a session-local receipt showing the
   latest confirmed transaction's received amount, network fee, gas price, gas
@@ -24,6 +43,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   wallet-step hint before approval or Permit2 signing.
 
 ### Changed
+
 - Softened the widget chrome by replacing several resting borders with tonal
   elevation, quieter segmented controls, and a tighter Trade details surface.
 - Reskinned the local demo surface so the playground reads like a host app demo
@@ -31,6 +51,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Resolved OS theme changes through `useSyncExternalStore`.
 
 ### Documentation
+
 - Clarified the widget integration contract: production props stay real, while
   demo wallets, fake transaction flows, scenario controls, and mock host shells
   belong in the separate playground.
@@ -38,15 +59,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.3.0] - 2026-06-08
 
 ### Removed (breaking)
+
 - `targets` prop — use `poolIds` (identical `string[]` shape).
 - `markets` prop — use `pools`; `Object.values(markets)` migrates an existing map.
 - `defaultDirection` values `'intoTarget'` / `'outOfTarget'` — use `'buy'` / `'sell'`.
 
 ### Changed (breaking)
+
 - Renamed `showApprovalModeControl` → `showApprovalMode`, pairing it with
   `defaultApprovalMode`.
 
 ### Migration
+
 - `targets={ids}` → `poolIds={ids}`
 - `markets={map}` → `pools={Object.values(map)}`
 - `defaultDirection="intoTarget"` → `defaultDirection="buy"`
@@ -54,6 +78,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `showApprovalModeControl={x}` → `showApprovalMode={x}`
 
 ### Internal
+
 - Refactored the widget into a `useSwapController` hook (state, derivation, and
   hook orchestration) over a thin presentational component, decomposed the swap
   money path into pure `src/swap/` modules (`authorizePermit`,
@@ -61,6 +86,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   single `useChangeEmitter` primitive. No public behavior change.
 
 ### Added
+
 - Toast notifications as an alternative transaction-status surface: new
   `statusSurface` prop (`'rail'` default, `'toast'`, `'both'`, `'none'`) plus
   `toastPosition`. One toast per swap attempt morphs loading → success/error in
@@ -116,6 +142,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   `SubmitStatus`, `TransactionProgressState`, and the `isUserRejectedError` helper.
 
 ### Changed
+
 - The branded header (`title`/`subtitle`) is now text-only: the Aegis logomark no longer
   renders next to host-provided titles. Aegis attribution lives solely in the
   "Powered by Aegis" footer.
@@ -147,6 +174,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   labels.
 
 ### Fixed
+
 - Keyboard focus no longer reshapes controls: the global `:focus-visible` rule forced
   a 6px border-radius onto every focused element, visibly squaring the circular flip
   button; the ring now follows each element's own radius.
@@ -157,6 +185,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.2.0] - 2026-06-05
 
 ### Added
+
 - Premium embeddable swap surface with collapsible trade details, route chip, token icons,
   Ethereum light/dark assets, and host-controlled execution details.
 - Exact-vs-max approval mode support, defaulting to exact approvals with Permit2 fallback.
@@ -166,6 +195,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   organized under `tests/`.
 
 ### Changed
+
 - The public widget entrypoint now delegates to focused widget modules instead of carrying
   the entire implementation in `src/index.tsx`.
 - Quote and router encoding paths are hardened around calldata construction, stale quote
@@ -174,12 +204,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - The default approval mode is `exact`; hosts can still opt into `max`.
 
 ### Deprecated
+
 - `targets` remains available as a backwards-compatible alias for `poolIds` and will be
   removed in `0.3.0`.
 
 ## [0.1.3] - 2026-06-05
 
 ### Added
+
 - Per-chain internal fee: `fee` field on `AegisSwapChainConfig`, so the output-token
   fee applies to any bundled chain that sets one (mainnet keeps its 50 bps fee).
 - Package metadata (`license`, `repository`, `homepage`, `bugs`, `keywords`) and a
@@ -190,6 +222,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   tarballs always contain a fresh build.
 
 ### Changed
+
 - `resolveWidgetFee` now reads the per-chain `fee` from the resolved chain config
   instead of hardcoding Ethereum mainnet. Default mainnet behavior is unchanged.
 - Swap submission re-quotes immediately before building calldata so the on-chain
@@ -200,6 +233,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   from the bundle).
 
 ### Removed
+
 - `dist/` build artifacts are no longer committed to git (rebuilt on pack/publish).
 
 ## [0.1.2] - 2026-06-04
@@ -209,16 +243,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 > next published version.
 
 ### Added
+
 - Adjustable internal widget swap fee, fixed to Ethereum mainnet (50 bps).
 - Exact-output swaps and a 5-second quote refresh.
 - Per-chain Uniswap v4 contract config (`UNISWAP_V4_CONTRACTS_BY_CHAIN`).
 
 ### Changed
+
 - Display token amounts are rounded (local only; not in the published 0.1.2 tarball).
 
 ## [0.1.0] - 2026-06-04
 
 ### Added
+
 - Initial embeddable direct-pool Aegis swap widget for WATER, WOOD, GRASS, and STONE.
 - Generic pool widget API; ERC-20 → Permit2 approval and Permit2 batch signing.
 

package/README.md

@@ -4,9 +4,9 @@ Embeddable React swap widget for Aegis direct pools. Import the component, impor
 
 The host app normally only renders `<AegisSwapWidget />`. Quoting, token approval, Permit2 signing, and swap submission are handled inside the widget.
 
-Typing in the Sell field creates an exact-input swap. Typing in the Buy field
-creates an exact-output swap. Active quotes refresh every five seconds while the
-amount is valid.
+In the direct-pool widget, typing in the Sell field creates an exact-input swap
+and typing in the Buy field creates an exact-output swap. Active quotes refresh
+every five seconds while the amount is valid.
 
 Widget swaps apply an internal output-token fee per configured chain. The bundled
 Ethereum mainnet config carries a fixed 50 bps fee to
@@ -48,8 +48,9 @@ Token icons are hydrated from the same metadata table used by the Aegis website:
 pool config, approvals, Permit2 authorization, swap submission, and callbacks.
 
 Demo wallets, fake transaction flows, scenario controls, and mock host shells
-belong in the separate playground. They are not exposed as production widget
-props, so an embedded widget cannot accidentally run in a fake mode.
+belong in the playground app (`apps/playground` in this monorepo). They are not
+exposed as production widget props, so an embedded widget cannot accidentally
+run in a fake mode.
 
 Hosts should customize through `pools`, `chains`, `rpcUrls`,
 `metadataEndpoint`, wallet/provider callbacks, status surfaces, `accentColor`,
@@ -90,26 +91,19 @@ tokens — is documented in [DESIGN.md](./DESIGN.md).
 
 ## Configure Pools
 
-Pass the direct pools you want to expose. This is the recommended integration path because it is not tied to any specific asset list.
-
-For the first WATER, WOOD, GRASS, and STONE implementors, use the bundled mainnet pool configs:
+Out of the box, `<AegisSwapWidget />` exposes the bundled WATER, WOOD, GRASS,
+and STONE mainnet pools. Use `poolIds` when a host wants a different built-in
+pool order or subset:
 
 ```tsx
-import { AegisSwapWidget, AEGIS_SWAP_MARKETS } from 'aegis-swap-widget'
+import { AegisSwapWidget } from 'aegis-swap-widget'
 import 'aegis-swap-widget/styles.css'
 
-const pools = [
-  AEGIS_SWAP_MARKETS.WATER_USDC,
-  AEGIS_SWAP_MARKETS.WOOD_USDC,
-  AEGIS_SWAP_MARKETS.GRASS_USDC,
-  AEGIS_SWAP_MARKETS.STONE_USDC,
-]
-
 export function Swap() {
   return (
     <AegisSwapWidget
-      pools={pools}
       defaultPoolId="WATER_USDC"
+      poolIds={['WATER_USDC', 'WOOD_USDC', 'GRASS_USDC', 'STONE_USDC']}
       theme="dark"
       accentColor="#31d48a"
     />
@@ -117,16 +111,68 @@ export function Swap() {
 }
 ```
 
-Use `defaultPoolId` to choose which pool opens first. Use `poolIds` when a host wants a different pool order or subset:
+Use `defaultPoolId` to choose which pool opens first:
 
 ```tsx
-<AegisSwapWidget
-  pools={pools}
-  defaultPoolId="GRASS_USDC"
-  poolIds={['GRASS_USDC', 'WATER_USDC']}
-/>
+<AegisSwapWidget defaultPoolId="GRASS_USDC" />
 ```
 
+## Aggregated Token Presets
+
+`AegisAggregatedSwapWidget` exposes only the tokens passed through its `tokens`
+prop. The bundled widget currently defaults to the Wolf Game preset:
+
+- `USDC`
+- `ETH`
+- `WATER`
+- `WOOD`
+- `GRASS`
+- `STONE`
+
+The general Ethereum preset is exported for hosts that want the standard list:
+
+- `USDC`
+- `USDT`
+- `WETH`
+- `ETH`
+- `WBTC`
+- `stETH`
+
+```tsx
+import { AegisAggregatedSwapWidget } from 'aegis-swap-widget'
+import {
+  AGGREGATED_SWAP_DEFAULT_TOKEN_LIST,
+  AGGREGATED_SWAP_WOLFGAME_TOKEN_LIST,
+} from '@aegis-engine/core'
+
+export function WolfGameSwap() {
+  return <AegisAggregatedSwapWidget tokens={AGGREGATED_SWAP_WOLFGAME_TOKEN_LIST} />
+}
+
+export function DefaultEthereumSwap() {
+  return (
+    <AegisAggregatedSwapWidget
+      tokens={AGGREGATED_SWAP_DEFAULT_TOKEN_LIST}
+      defaultInputTokenSymbol="USDC"
+      defaultOutputTokenSymbol="USDT"
+    />
+  )
+}
+```
+
+## Kyber Exact-Output Limitation
+
+`AegisAggregatedSwapWidget` is exact-input only. The KyberSwap Aggregator V1 EVM
+route endpoint is built around `amountIn` route discovery and does not provide a
+native exact-output route request, so the widget does not let users type a fixed
+Buy amount for Kyber aggregated swaps.
+
+Practically, the Sell field is editable and the Buy field displays the quoted
+output. Direct-pool `AegisSwapWidget` can still support exact-output swaps
+because it quotes and encodes against the Uniswap V4 pool directly.
+
+Reference: [KyberSwap Aggregator API EVM swaps](https://docs.kyberswap.com/kyberswap-solutions/kyberswap-aggregator/aggregator-api-specification/evm-swaps).
+
 ## Fees
 
 The widget applies an internal output-token fee per chain. Each bundled chain config
@@ -139,15 +185,42 @@ This fee is internal to the widget and is not configured by host sites — host
 overrides cannot set or change it. Chains added later carry a fee only when their
 bundled config provides one.
 
+For `AegisAggregatedSwapWidget`, the fee is taken by the KyberSwap route itself.
+On Ethereum mainnet, every aggregated route request includes these Kyber fee
+parameters:
+
+```text
+feeAmount=50
+chargeFeeBy=currency_out
+isInBps=true
+feeReceiver=0x8ea2C7de60ef1Cd4dcE64ea2DDDe2f99F0127eFC
+```
+
+`chargeFeeBy=currency_out` means the fee is collected in the output token. The
+widget first asks Kyber for a route with those fee params, then passes Kyber's
+returned `routeSummary` unchanged into `route/build`. The calldata returned by
+Kyber is what the user's wallet signs, so fee collection is encoded in the
+router transaction rather than handled by a separate widget transfer. The swap
+recipient remains the user's wallet; the fee receiver receives the 50 bps
+output-token fee from the routed swap.
+
+The quoted output shown in the widget is the user's net output after Kyber's
+fee handling. `onSubmitted` includes `feeAmount` and `feeBps` for host analytics,
+but the widget does not render a separate fee row in Trade details.
+
+For direct-pool `AegisSwapWidget`, the same internal output-token fee is encoded
+directly into the Universal Router command. Exact-input direct swaps use a
+`TAKE_PORTION` output leg before the user's output `TAKE`.
+
 For custom assets, provide full pool and token metadata:
 
 ```tsx
+import { AegisSwapWidget } from 'aegis-swap-widget'
 import {
-  AegisSwapWidget,
   AEGIS_DYNAMIC_FEE_FLAG,
   AEGIS_SWAP_HOOK,
   type AegisSwapPoolConfig,
-} from 'aegis-swap-widget'
+} from '@aegis-engine/core'
 
 const pools: AegisSwapPoolConfig[] = [
   {
@@ -204,14 +277,15 @@ import { mainnet } from 'viem/chains'
 />
 ```
 
-Uniswap v4 deployments are configured per chain. The package exports
+Uniswap v4 deployments are configured per chain. `@aegis-engine/core` exports
 `UNISWAP_V4_CONTRACTS_BY_CHAIN` for the supported mainnet deployments listed in
 the official Uniswap v4 deployment docs: Ethereum, Optimism, Unichain, Polygon,
 Base, and Arbitrum.
 
 ```tsx
 import { base } from 'viem/chains'
-import { UNISWAP_V4_CONTRACTS_BY_CHAIN } from 'aegis-swap-widget'
+import { AegisSwapWidget } from 'aegis-swap-widget'
+import { UNISWAP_V4_CONTRACTS_BY_CHAIN } from '@aegis-engine/core'
 
 <AegisSwapWidget
   chainId={8453}
@@ -351,7 +425,7 @@ the pending/mining shimmer is always a full-width top-border sweep.
 
 Errors never appear in `status` (the submit machine resets to `'idle'`); read
 them from `progress === 'error'` plus `error`. For classifying the raw `Error`
-from `onError`, `isUserRejectedError` is exported.
+from `onError`, import `isUserRejectedError` from `@aegis-engine/core`.
 
 Success clears itself after confirming (by default a 3s hold plus the 420ms
 rail fade-out), the widget resets and emits a final
@@ -579,7 +653,7 @@ function Swap() {
 
 ## Default Markets
 
-The package ships mainnet direct-pool configs for:
+The widget includes built-in mainnet direct-pool configs for:
 
 - `USDC / WATER`
 - `USDC / WOOD`
@@ -587,8 +661,8 @@ The package ships mainnet direct-pool configs for:
 - `USDC / STONE`
 
 These use the Aegis mainnet router `0x00581261a1200956ea05d1810fF28ffd66D8E254`
-and the Ethereum entry in `UNISWAP_V4_CONTRACTS_BY_CHAIN` for Permit2 and the
-public Uniswap v4 Quoter.
+and the Ethereum Uniswap v4 Permit2 and Quoter addresses from
+`@aegis-engine/core`.
 
 ## License
 
@@ -597,23 +671,20 @@ MIT.
 ## Local Demo
 
 ```bash
-npm ci
-npm run dev
+pnpm install                              # at the monorepo root
+pnpm --filter aegis-swap-widget dev
 ```
 
 ## Releasing
 
-Maintainer release flow (publishes to npm). `dist/` is not committed — the `prepack`
-hook rebuilds it on every `npm pack`/`npm publish`, and `prepublishOnly` runs the
-typecheck + test gate.
+Releases are automated with [changesets](https://github.com/changesets/changesets)
+from the monorepo root — no manual `npm version`/`npm publish`. `dist/` is not
+committed; the `prepack` hook rebuilds it on every pack/publish, and
+`prepublishOnly` runs the typecheck + test gate.
 
 ```bash
-git switch main && git pull
-npm ci
-npm run typecheck && npm run test && npm run build
-# Move CHANGELOG [Unreleased] entries under the new version heading.
-npm version minor            # e.g. 0.2.1 -> 0.3.0 for a breaking 0.x release; commits and tags vX.Y.Z
-git push origin main --follow-tags
-npm publish --access public  # prepublishOnly gate + prepack build run automatically
+pnpm changeset               # in your PR: pick aegis-swap-widget + bump, write the entry
+# Merge the PR; the Release workflow opens a "Version Packages" PR on main.
+# Merging that PR publishes to npm via OIDC trusted publishing.
 npm view aegis-swap-widget version
 ```

package/dist/abis.d.ts

@@ -1,76 +1,3 @@
-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";