aegis-swap-widget 0.6.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.8.0
+
+### Minor Changes
+
+- 127be2b: Add trusted Aegis Engine v1.0.3 deployment support for Robinhood Chain, upgrade the Engine SDK to 0.33.0, and bundle Robinhood Chain network artwork in the widget. Redeem quotes now return execution fields only for an SDK-verified frame, and an execution-gated redeem that the Engine assessed above the post-redeem utilization cap reports `utilization-blocked`.
+
+### Patch Changes
+
+- Updated dependencies [127be2b]
+  - @aegis-engine/core@0.4.0
+
+## 0.7.0
+
+### Minor Changes
+
+- 0416588: Add controlled Engine market lookup by exact token resource identity so partner apps can switch Lend and Borrow markets without storing Engine market ids.
+
 ## 0.6.0
 
 ### Minor Changes

package/README.md

@@ -4,7 +4,9 @@ Embed Amplifi Swap or Aegis Engine directly in a React application. Import the
 component and CSS, then configure networks, REST data, wallet handoff, and host
 styling through props.
 
-The host app normally only renders `<AegisSwapWidget />`. Quoting, token approval, Permit2 signing, and swap submission are handled inside the widget.
+Choose `<AegisSwapWidget />` for a swap-only embed or
+`<AegisEngineWidget />` for Buy, Borrow, Lend, and Positions. Quoting, token
+approval, Permit2 signing, and transaction submission stay inside the widget.
 
 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
@@ -60,6 +62,9 @@ export function Engine({ account, provider }) {
 
 ## Partner context and host action requirements
 
+Wolf Game partners can use the canonical
+[live Wolf preview](https://swap.widget.aegis.markets/wolf).
+
 `partnerContext` adds optional, display-only facts from a game or partner. The
 host must normalize this data on its server. Do not pass API keys, private
 vendor responses, or wallet-specific context through shared URLs.
@@ -164,13 +169,41 @@ silent unless the host supplies an `actionRequirement`; then the widget places
 one compact purpose row beside the active Buy or Borrow transaction content.
 Partner identity, weather, aggregate balances, activities, secondary details,
 and navigation remain available only in the default `showroom` variant. If the
-host already owns resource selection, pass its exact Engine `marketId`. This
-controlled form hides the widget market picker and prevents partner actions from
-selecting another market. Use `defaultMarketId` when the widget should own
-selection.
+host already owns resource selection, pass the selected token through
+`marketResource`. The widget resolves its eligible Lend/Borrow market from live
+Engine discovery on the active chain by exact address and symbol:
+
+```tsx
+const wolfResources = {
+  WATER: {
+    chainId: 1,
+    address: '0x828B22c9ea1c20B551EeFC6198174C4bb7a8CBF6',
+    symbol: 'WATER',
+  },
+  // WOOD, GRASS, and STONE use the same shape.
+} as const
+
+<AegisEngineWidget
+  chainId={1}
+  enabledChainIds={[1]}
+  marketResource={wolfResources[selectedResource]}
+/>
+```
 
-Wolf Game's current aggregate API provides Community 12 balances, weather, and
-harvesting data. It does not provide wallet-specific inventory, claimable
+The resource chain must be the widget's active chain; Valley uses `chainId={1}`.
+This controlled form hides the widget market picker. It selects only one exact,
+surface-compatible match and fails closed when discovery returns none or more
+than one. The host does not need to store Engine market ids. `marketResource`
+locates the market; it does not lock which of the market's two tokens the user
+chooses inside Lend or Borrow. If several Engine markets intentionally use the
+same resource, add `marketId` only to disambiguate within those matches. A
+mismatched id never bypasses resource identity. Use `defaultMarketId` when the
+widget should own selection. The nested Buy surface remains independently
+controlled through `buySwapConfig`; one-shot partner Buy intents already
+resolve their matching direct pool.
+
+Wolf Game's aggregate API provides game-wide balances plus weather and
+harvesting data for a selected community. It does not provide wallet-specific inventory, claimable
 resources, energy timing, or a concrete action requirement. A Wolf host must
 therefore create `actionRequirement` only from real game state. Do not derive it
 from aggregate weather or inventory alone.
@@ -900,6 +933,7 @@ No other props changed. See the [CHANGELOG](./CHANGELOG.md) for the full entry.
 - `title`: optional widget heading. Swap and Engine default to empty for compact embedded chrome.
 - `showNetworkSelector`: Engine header-network visibility: `'never'` (default), `'auto'`, or `'always'`. Cross-chain markets and tokens remain available in the full selectors when the header rail is hidden.
 - `onSurfaceChange`: Engine callback fired when the active unified tab changes (`'buy'`, `'borrow'`, `'lend'`, or `'positions'`).
+- `marketResource`: controlled Lend/Borrow market locator (`chainId`, token `address`, and `symbol`). On the active chain, the widget resolves one eligible Engine market, hides its picker, and fails closed on missing or ambiguous matches. It does not lock token direction. Use `marketId` only as an optional disambiguator for the same resource.
 - `buySwapConfig`: optional host overrides for the nested Engine Buy surface only. Use it to constrain Buy to a chain, pool set, or controlled `poolId` without changing Engine market discovery or the Lend/Borrow/Positions surfaces.
 - `showBuySettings`: show the Engine Buy surface's slippage-settings control. Defaults to `false`.
 - `showAmountSlider`: amount-slider visibility on the Engine lend/borrow amount boxes: `'auto'` (default) shows sliders on the borrow surface only, sized against the wallet's borrowing limit; `'always'` adds the lend deposit slider; `'never'` hides every amount slider.