@sodax/dapp-kit 2.0.0-rc.1 → 2.0.0-rc.3

package/ai-exported/migration/features/swap.md

@@ -27,7 +27,9 @@ Pair: [`../../integration/features/swap.md`](../../integration/features/swap.md)
 +     if (!walletProvider) return;
 -     const result = await swap.mutateAsync({ params: intentParams });
 -     if (result.ok) {
--       const { intent, intentDeliveryInfo } = result.value;
+-       // v1: result.value was a TUPLE — destructure positionally
+-       const [executionResponse] = result.value;
+-       const txHash = executionResponse.intent_hash;
 -       /* ... */
 -     } else {
 -       toast.error(result.error.message);
@@ -37,12 +39,25 @@ Pair: [`../../integration/features/swap.md`](../../integration/features/swap.md)
 +       toast.error(result.error instanceof Error ? result.error.message : 'Swap failed');
 +       return;
 +     }
-+     const { intent, intentDeliveryInfo } = result.value;
++     // v2: result.value is a NAMED OBJECT (SwapResponse) — destructure by name
++     const { solverExecutionResponse, intent, intentDeliveryInfo } = result.value;
++     const intentHash = solverExecutionResponse.intent_hash;       // protocol-level intent id (v1 ≈ executionResponse.intent_hash)
++     const spokeTxHash = intentDeliveryInfo.srcTxHash;             // on-chain tx hash on srcChainKey — use for tx-history display
 +     /* ... */
     };
   }
 ```
 
+#### `SwapResponse` field map (`result.value`)
+
+| Field | Type | Use it for |
+|---|---|---|
+| `solverExecutionResponse` | `{ answer: 'OK'; intent_hash: Hex }` | Protocol-level intent identifier. **`solverExecutionResponse.intent_hash` is the v2 equivalent of v1's `executionResponse.intent_hash`.** Pass it to `useStatus({ params: { intentTxHash } })` to poll execution status. |
+| `intent` | `Intent` | Intent metadata (`intentId: bigint`, `creator`, tokens, amounts, `srcChain`/`dstChain` as `IntentRelayChainId` bigints). **No transaction hashes on this object** — don't read `intent.intent_hash` (does not exist) or `intent.tx_hash`. |
+| `intentDeliveryInfo` | `{ srcChainKey, srcTxHash, srcAddress, dstChainKey, dstTxHash, dstAddress }` | **On-chain transaction hashes.** `srcTxHash` is the spoke-chain tx on `srcChainKey` (the one that typically feeds a user-facing transaction history); `dstTxHash` is the delivery tx on `dstChainKey`. |
+
+**Porting `[executionResponse] = result.value` (v1 tuple) → v2:** rename to `{ solverExecutionResponse } = result.value`. Any `executionResponse.intent_hash` read becomes `solverExecutionResponse.intent_hash`. If the value was being used as the **transaction hash** in a transaction-history row (not as the intent identifier), switch to `intentDeliveryInfo.srcTxHash` instead — `intent_hash` and `srcTxHash` are not interchangeable.
+
 ### `useSwapApprove` — return shape
 
 ```diff

package/ai-exported/migration/recipes.md

@@ -42,28 +42,25 @@ for (const file of project.getSourceFiles('src/**/*.{ts,tsx}')) {
 await project.save();
 ```
 
-## Codemod 2: useSpokeProvider deletion
+## Codemod 2: useSpokeProvider deletion (2-arg → 1-arg)
 
-`useSpokeProvider` is gone in v2. Delete the import + usage; replace with `useWalletProvider` from `@sodax/wallet-sdk-react`.
+`useSpokeProvider` is gone in v2. Replace with `useWalletProvider` from `@sodax/wallet-sdk-react`.
 
-```bash
-# 1. Find all usages first.
-grep -rE '\buseSpokeProvider\b' src/
-
-# 2. Manual delete + rewrite each (no safe sed for this — context varies).
-```
-
-Per call site, the rewrite:
+v1 had **two positional args**: `useSpokeProvider(spokeChainId, walletProvider)`. v2 collapses to a single options object: `useWalletProvider({ xChainId })`. The second v1 argument is **dropped entirely** — v2 resolves the wallet provider from the wallet-sdk-react store internally based on `xChainId`. If your v1 code constructed a wallet provider separately to pass in, delete that construction code too.
 
 ```diff
+- // v1 — 2 positional args (chainKey + walletProvider)
 - import { useSpokeProvider } from '@sodax/dapp-kit';
-- const spokeProvider = useSpokeProvider({ chainId: BSC_MAINNET_CHAIN_ID });
+- const spokeProvider = useSpokeProvider(srcChainId, walletProvider);
+
++ // v2 — 1 options arg, no external walletProvider
 + import { useWalletProvider } from '@sodax/wallet-sdk-react';
-+ import { ChainKeys } from '@sodax/sdk';
-+ const walletProvider = useWalletProvider({ xChainId: ChainKeys.BSC_MAINNET });
++ const walletProvider = useWalletProvider({ xChainId: srcChainId });
 ```
 
-Then update consumers of `spokeProvider` to use `walletProvider` instead — usually inside `mutate(vars)` payloads, sometimes inside query hook params.
+A naive single-pass regex over `useSpokeProvider\(([^)]+)\)` eats both args and produces invalid `useWalletProvider({ xChainId: chainKey, walletProvider })`. Do the rewrite in two passes: first the call shape (drop the second positional arg), then the import (from `@sodax/dapp-kit` → `@sodax/wallet-sdk-react`). A small number of v1 callers used the single-arg form `useSpokeProvider(chainId)` — handle those separately since they don't have a second arg to drop.
+
+Update downstream consumers of `spokeProvider` to use `walletProvider` instead — usually inside `mutate(vars)` payloads or query hook params. The field name on payloads also renamed `spokeProvider:` → `walletProvider:` (see `@sodax/sdk/ai-exported/migration/checklist.md` step 7b).
 
 ## Codemod 3: invalidate*Queries utilities deletion
 

package/ai-exported/migration/reference/renamed-hooks.md

@@ -29,6 +29,8 @@ These keep their name but their TypeScript signature is different. Usually requi
 | `useMMAllowance` | Query params: `{ params: { payload: MoneyMarketParams<K> } }`. For `'borrow'` / `'withdraw'` actions: `enabled: false` — `data` stays `undefined`. |
 | `useUserReservesData` | Param key rename: `address → userAddress`; chain key is `spokeChainKey`. |
 | `useUserFormattedSummary` | Same. |
+| `useATokensBalances` | Params: `{ aTokens, spokeProvider, userAddress } → { params: { aTokens, spokeChainKey, userAddress } }`. `spokeProvider` dropped; chain key is **`spokeChainKey`** (NOT `srcChainKey`); user field is **`userAddress`** (NOT `address`). Data: `Map<Address, bigint> \| undefined` (already unwrapped). |
+| `useAToken` | Unaffected by the position-hook renames — takes only `{ aToken }`. Data: `Erc20Token & { chainKey }` (`hubAsset` / `vault` NOT included). |
 | All staking mutations | Same as MM. Plus dedicated approve hooks per token (`useStakeApprove` ↔ `useUnstakeApprove` ↔ `useInstantUnstakeApprove`). |
 | `useStakeRatio` | Return: `Result<bigint> → [xSodaAmount, previewDepositAmount]` (unwrapped tuple — NOT Result-wrapped in v2). |
 | `useStakingInfo` / `useUnstakingInfo` / `useUnstakingInfoWithPenalty` / `useStakingConfig` / `useInstantUnstakeRatio` / `useConvertedAssets` | All unwrapped in v2 (hooks throw on SDK `!ok`). Branch on `isError`/`error`, not `data?.ok`. |

package/dist/index.cjs

@@ -2484,10 +2484,9 @@ function useClaimRewards({
   });
 }
 var SodaxProvider = ({ children, config }) => {
-  const configRef = react.useRef(config);
-  const frozen = configRef.current;
-  const sodax = react.useMemo(() => new sdk.Sodax(frozen), [frozen]);
-  return /* @__PURE__ */ jsxRuntime.jsx(SodaxContext.Provider, { value: { sodax }, children });
+  const sodax = react.useMemo(() => new sdk.Sodax(config), [config]);
+  const contextValue = react.useMemo(() => ({ sodax }), [sodax]);
+  return /* @__PURE__ */ jsxRuntime.jsx(SodaxContext.Provider, { value: contextValue, children });
 };
 var defaultOnMutationError = (error) => {
   console.error("[sodax] Mutation error:", error);