aegis-swap-widget 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 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

@@ -164,10 +164,38 @@ 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]}
+/>
+```
+
+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 current aggregate API provides Community 12 balances, weather, and
 harvesting data. It does not provide wallet-specific inventory, claimable
@@ -900,6 +928,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.