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

package/ai-exported/AGENTS.md

@@ -4,7 +4,7 @@
 
 ## Project
 
-`@sodax/dapp-kit` is a React hooks library that wraps `@sodax/sdk` with React Query. It provides ~95 hooks across 11 feature domains (swap, money market, staking, bridge, dex, migration, partner, recovery, bitcoin/Radfi, backend queries, shared) for consumer dApps. It is **React-only** — Node.js scripts and backend services use `@sodax/sdk` directly.
+`@sodax/dapp-kit` is a React hooks library that wraps `@sodax/sdk` with React Query. It provides hooks across 11 feature domains (swap, money market, staking, bridge, dex, migration, partner, recovery, bitcoin/Radfi, backend queries, shared) for consumer dApps. It is **React-only** — Node.js scripts and backend services use `@sodax/sdk` directly.
 
 This package is **v2**. v2 was a deep canonicalization pass over v1's hook shapes — single-object params, mandatory `mutateAsyncSafe`, hook-owned invalidations, throw-on-`Result.!ok` inside `mutationFn`, canonical queryKey/mutationKey conventions. Plus the entire SDK underneath was reshaped (chain-key-driven routing, `Result<T>` everywhere, `WalletProviderSlot<K, Raw>`). Code written against v1 dapp-kit will not compile against v2.
 

package/ai-exported/integration/architecture.md

@@ -237,7 +237,7 @@ queryClient.invalidateQueries({ queryKey: ['dex', 'positionInfo', tokenId, poolK
 
 ## Hook organization
 
-~95 hooks (41 mutations + ~50 queries + utilities) organized by feature domain in `src/hooks/`:
+Hooks organized by feature domain in `src/hooks/`:
 
 ```
 hooks/
@@ -248,13 +248,13 @@ hooks/
 ├── swap/       # useQuote, useSwap, useStatus, useSwapAllowance, useSwapApprove,
 │               # useCancelSwap, useCreateLimitOrder, useCancelLimitOrder
 ├── mm/         # useSupply, useWithdraw, useBorrow, useRepay, useMMAllowance, useMMApprove,
-│               # reserves data hooks (13 hooks total)
+│               # reserves data hooks
 ├── bridge/     # useBridge, useBridgeAllowance, useBridgeApprove, bridgeable amounts/tokens
-├── staking/    # useStake, useUnstake, useInstantUnstake, useClaim, staking info hooks (~18)
-├── dex/        # usePools, useDexDeposit, useDexWithdraw, liquidity hooks (~13)
-├── bitcoin/    # useRadfiSession, fund/withdraw, UTXO management (~8)
-├── backend/    # Intent tracking, swap submission, orderbook, money market position queries (~13)
-├── partner/    # Partner fee claim, auto-swap preferences, token approval (6)
+├── staking/    # useStake, useUnstake, useInstantUnstake, useClaim, staking info hooks
+├── dex/        # usePools, useDexDeposit, useDexWithdraw, liquidity hooks
+├── bitcoin/    # useRadfiSession, fund/withdraw, UTXO management
+├── backend/    # Intent tracking, swap submission, orderbook, money market position queries
+├── partner/    # Partner fee claim, auto-swap preferences, token approval
 ├── recovery/   # useHubAssetBalances, useWithdrawHubAsset
 └── migrate/    # useMigrateIcxToSoda, useRevertMigrateSodaToIcx, useMigratebnUSD,
                 # useMigrateBaln, useMigrationApprove, useMigrationAllowance

package/ai-exported/integration/features/README.md

@@ -2,16 +2,16 @@
 
 Per-feature reference docs. Each file documents the hooks, params types, return types, and feature-specific gotchas — but doesn't include extended worked examples (those live in [`../recipes/`](../recipes/)).
 
-| File | Hook count | What's covered |
-|---|---|---|
-| [`swap.md`](swap.md) | 8 | Cross-chain swaps via the intent solver: `useQuote`, `useSwap`, allowance/approve, status polling, limit orders. |
-| [`money-market.md`](money-market.md) | 13 | Lending/borrowing on the cross-chain MM: `useSupply`, `useBorrow`, `useWithdraw`, `useRepay`, allowance/approve, reserves data hooks. |
-| [`staking.md`](staking.md) | ~18 | SODA → xSODA staking: `useStake`, `useUnstake`, `useInstantUnstake`, `useClaim`, `useCancelUnstake`, allowance/approve, info/ratio reads. |
-| [`bridge.md`](bridge.md) | 5 | Cross-chain token bridging: `useBridge`, allowance/approve, bridgeable amount/tokens. |
-| [`dex.md`](dex.md) | ~13 | Concentrated liquidity DEX: assets in/out, liquidity supply/decrease, claim rewards, position info, pool reads, param builders. |
-| [`migration.md`](migration.md) | 6 | Token migration: `useMigrateIcxToSoda`, `useRevertMigrateSodaToIcx`, `useMigratebnUSD`, `useMigrateBaln`, allowance/approve. |
-| [`bitcoin.md`](bitcoin.md) | ~8 | Radfi (dapp-kit-unique): session, trading wallet, fund/withdraw, UTXOs. |
-| [`auxiliary-services.md`](auxiliary-services.md) | ~30 | Partner fee claiming, recovery, backend queries (intent tracking, orderbook, MM data), shared utilities (xBalances, gas, trustlines). |
+| File | What's covered |
+|---|---|
+| [`swap.md`](swap.md) | Cross-chain swaps via the intent solver: `useQuote`, `useSwap`, allowance/approve, status polling, limit orders. |
+| [`money-market.md`](money-market.md) | Lending/borrowing on the cross-chain MM: `useSupply`, `useBorrow`, `useWithdraw`, `useRepay`, allowance/approve, reserves data hooks. |
+| [`staking.md`](staking.md) | SODA → xSODA staking: `useStake`, `useUnstake`, `useInstantUnstake`, `useClaim`, `useCancelUnstake`, allowance/approve, info/ratio reads. |
+| [`bridge.md`](bridge.md) | Cross-chain token bridging: `useBridge`, allowance/approve, bridgeable amount/tokens. |
+| [`dex.md`](dex.md) | Concentrated liquidity DEX: assets in/out, liquidity supply/decrease, claim rewards, position info, pool reads, param builders. |
+| [`migration.md`](migration.md) | Token migration: `useMigrateIcxToSoda`, `useRevertMigrateSodaToIcx`, `useMigratebnUSD`, `useMigrateBaln`, allowance/approve. |
+| [`bitcoin.md`](bitcoin.md) | Radfi (dapp-kit-unique): session, trading wallet, fund/withdraw, UTXOs. |
+| [`auxiliary-services.md`](auxiliary-services.md) | Partner fee claiming, recovery, backend queries (intent tracking, orderbook, MM data), shared utilities (xBalances, gas, trustlines). |
 
 ## Reference vs recipes
 

package/ai-exported/integration/features/auxiliary-services.md

@@ -6,7 +6,7 @@ Pair: [`../../migration/features/auxiliary-services.md`](../../migration/feature
 
 ## Partner
 
-Partner fee claiming and auto-swap preferences. 6 hooks.
+Partner fee claiming and auto-swap preferences.
 
 ```ts
 // @ai-snippets-skip
@@ -22,7 +22,7 @@ useFeeClaimSwap({ mutationOptions });               // Claim partner fees via sw
 
 ## Recovery
 
-Withdraw stuck hub-wallet assets back to a spoke chain. 2 hooks.
+Withdraw stuck hub-wallet assets back to a spoke chain.
 
 ```ts
 // @ai-snippets-skip
@@ -32,7 +32,7 @@ useWithdrawHubAsset({ mutationOptions });
 
 ## Backend queries (read-only data)
 
-12 hooks. No wallet connection required.
+No wallet connection required.
 
 ### Intent tracking
 

package/ai-exported/integration/reference/README.md

@@ -4,7 +4,7 @@ Lookup tables. Read while writing code; not a tutorial.
 
 | File | What's in it |
 |---|---|
-| [`hooks-index.md`](hooks-index.md) | Comprehensive hook table (95 hooks, organized by feature, with hook type and purpose). |
+| [`hooks-index.md`](hooks-index.md) | Comprehensive hook table (organized by feature, with hook type and purpose). |
 | [`querykey-conventions.md`](querykey-conventions.md) | Mandatory queryKey/mutationKey shape rules + per-feature key tables. |
 | [`public-api.md`](public-api.md) | What `@sodax/dapp-kit` exports + import rules. |
 | [`glossary.md`](glossary.md) | Type aliases (`ReadHookParams`, `MutationHookParams`, `SafeUseMutationResult`, `MutationHookOptions`, etc.). |

package/ai-exported/integration/reference/hooks-index.md

@@ -1,6 +1,6 @@
 # Hooks index — `@sodax/dapp-kit` v2
 
-Comprehensive hook table. ~95 hooks across 11 feature domains. Use this when you know the feature you're building but don't remember the exact hook name.
+Comprehensive hook table across 11 feature domains. Use this when you know the feature you're building but don't remember the exact hook name.
 
 ## Provider + context
 
@@ -11,7 +11,7 @@ Comprehensive hook table. ~95 hooks across 11 feature domains. Use this when you
 | `useSodaxContext` | Utility | Access the `Sodax` SDK instance |
 | `useHubProvider` | Utility | Hub chain (Sonic) provider |
 
-## Swap (8)
+## Swap
 
 | Hook | Type | Purpose |
 |---|---|---|
@@ -24,7 +24,7 @@ Comprehensive hook table. ~95 hooks across 11 feature domains. Use this when you
 | `useCreateLimitOrder` | Mutation | Create a limit order (no deadline) |
 | `useCancelLimitOrder` | Mutation | Cancel a limit order |
 
-## Money market (13)
+## Money market
 
 | Hook | Type | Purpose |
 |---|---|---|
@@ -43,7 +43,7 @@ Comprehensive hook table. ~95 hooks across 11 feature domains. Use this when you
 | `useAToken` | Query | aToken metadata |
 | `useATokensBalances` | Query | aToken balances |
 
-## Bridge (5)
+## Bridge
 
 | Hook | Type | Purpose |
 |---|---|---|
@@ -53,7 +53,7 @@ Comprehensive hook table. ~95 hooks across 11 feature domains. Use this when you
 | `useGetBridgeableAmount` | Query | Max bridgeable amount between two `XToken`s |
 | `useGetBridgeableTokens` | Query | Tokens bridgeable to a destination chain |
 
-## Staking (~18)
+## Staking
 
 | Hook | Type | Purpose |
 |---|---|---|
@@ -76,7 +76,7 @@ Comprehensive hook table. ~95 hooks across 11 feature domains. Use this when you
 | `useInstantUnstakeRatio` | Query | Instant unstake rate |
 | `useConvertedAssets` | Query | xSODA → SODA conversion |
 
-## DEX (~13)
+## DEX
 
 | Hook | Type | Purpose |
 |---|---|---|
@@ -97,7 +97,7 @@ Comprehensive hook table. ~95 hooks across 11 feature domains. Use this when you
 | `useCreateSupplyLiquidityParams` | Param builder | Build tick-range + liquidity params |
 | `useCreateDecreaseLiquidityParams` | Param builder | Build decrease params from position state |
 
-## Migration (6)
+## Migration
 
 | Hook | Type | Purpose |
 |---|---|---|
@@ -108,7 +108,7 @@ Comprehensive hook table. ~95 hooks across 11 feature domains. Use this when you
 | `useMigrationApprove` | Mutation | Approve before migration (action-discriminated) |
 | `useMigrationAllowance` | Query | Approval check (action-discriminated) |
 
-## Bitcoin / Radfi (~8)
+## Bitcoin / Radfi
 
 | Hook | Type | Purpose |
 |---|---|---|
@@ -122,7 +122,7 @@ Comprehensive hook table. ~95 hooks across 11 feature domains. Use this when you
 | `useExpiredUtxos` | Query | Expired UTXOs (polls 60s) |
 | `useRenewUtxos` | Mutation | Renew expired UTXOs |
 
-## Backend queries (~13)
+## Backend queries
 
 ### Intents
 
@@ -151,7 +151,7 @@ Comprehensive hook table. ~95 hooks across 11 feature domains. Use this when you
 | `useBackendMoneyMarketAssetBorrowers` | Borrowers for an asset |
 | `useBackendAllMoneyMarketBorrowers` | All borrowers |
 
-## Partner (6)
+## Partner
 
 | Hook | Type | Purpose |
 |---|---|---|
@@ -162,14 +162,14 @@ Comprehensive hook table. ~95 hooks across 11 feature domains. Use this when you
 | `useSetSwapPreference` | Mutation | Set swap preference |
 | `useFeeClaimSwap` | Mutation | Claim partner fees via swap |
 
-## Recovery (2)
+## Recovery
 
 | Hook | Type | Purpose |
 |---|---|---|
 | `useHubAssetBalances` | Query | Hub asset balances |
 | `useWithdrawHubAsset` | Mutation | Withdraw hub asset |
 
-## Shared (~9)
+## Shared
 
 | Hook | Type | Purpose |
 |---|---|---|
@@ -183,10 +183,6 @@ Comprehensive hook table. ~95 hooks across 11 feature domains. Use this when you
 | `unwrapResult` | Internal | `Result<T>` → throw / return |
 | `toResult` | Internal | `Promise<T>` → `Result<T>` |
 
-## Total
-
-41 mutations + ~50 queries + utilities + provider = **~95 hooks**.
-
 ## Cross-references
 
 - [`../features/`](../features/) — per-feature reference docs (params types, return shapes, gotchas).

package/ai-exported/integration/reference/public-api.md

@@ -8,14 +8,14 @@ The package's `src/index.ts` re-exports four buckets:
 
 ```ts
 // @ai-snippets-skip
-export * from './hooks/index.js';      // ~95 hooks across 11 feature dirs
+export * from './hooks/index.js';      // hooks across 11 feature dirs
 export * from './providers/index.js';  // SodaxProvider, createSodaxQueryClient
 export * from './utils/index.js';      // dex-utils param builders
 export * from '@sodax/sdk';            // FULL @sodax/sdk re-export
 ```
 
 Practical implications:
-- All ~95 hooks are importable from the root: `import { useSwap, useSupply, ... } from '@sodax/dapp-kit'`.
+- All hooks are importable from the root: `import { useSwap, useSupply, ... } from '@sodax/dapp-kit'`.
 - All `@sodax/sdk` types are importable from `@sodax/dapp-kit` directly: `import { ChainKeys, type SodaxConfig, type CreateIntentParams } from '@sodax/dapp-kit'`.
 - You may also import directly from `@sodax/sdk` — both work, both are stable.
 

package/ai-exported/migration/features/auxiliary-services.md

@@ -4,7 +4,7 @@ Pair: [`../../integration/features/auxiliary-services.md`](../../integration/fea
 
 Smaller surfaces grouped together: partner, recovery, backend queries, shared utilities. Most changes are mechanical — single-object params, mutateAsyncSafe — same as the other features.
 
-## Partner (6 hooks)
+## Partner
 
 ```diff
 - const claim = useFeeClaimSwap(spokeProvider);
@@ -18,7 +18,7 @@ Smaller surfaces grouped together: partner, recovery, backend queries, shared ut
 
 `useFetchAssetsBalances`, `useGetAutoSwapPreferences`, `useIsTokenApproved` — convert to single-object query shape.
 
-## Recovery (2 hooks)
+## Recovery
 
 ```diff
 - const withdraw = useWithdrawHubAsset(spokeProvider);
@@ -26,7 +26,7 @@ Smaller surfaces grouped together: partner, recovery, backend queries, shared ut
 + await withdraw({ params, walletProvider });
 ```
 
-## Backend queries (~13 hooks)
+## Backend queries
 
 Read-only. No `walletProvider` involved. Convert to single-object query shape.
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sodax/dapp-kit",
   "license": "MIT",
-  "version": "2.0.0-rc.1",
+  "version": "2.0.0-rc.2",
   "description": "dapp-kit of New World",
   "type": "module",
   "main": "dist/index.cjs",
@@ -18,7 +18,7 @@
   },
   "dependencies": {
     "viem": "2.29.2",
-    "@sodax/sdk": "2.0.0-rc.1"
+    "@sodax/sdk": "2.0.0-rc.2"
   },
   "devDependencies": {
     "@tanstack/react-query": "5.87.4",
@@ -33,7 +33,7 @@
     "react": ">=18"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "exports": {
     "./package.json": "./package.json",