@sodax/wallet-sdk-react 2.0.0-rc.1 → 2.0.0-rc.11

package/dist/xchains/evm/index.mjs

@@ -1,5 +1,3 @@
-export { EvmXConnector, EvmXService, createWagmiConfig as createWagmi, createWagmiConfig } from '../../chunk-E5IAZ7E6.mjs';
-import '../../chunk-NY7U7OJW.mjs';
-import '../../chunk-X2MHIWXO.mjs';
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map
+export { EvmXConnector, EvmXService, createWagmiConfig as createWagmi, createWagmiConfig } from '../../chunk-Z5GXDHGL.mjs';
+import '../../chunk-7V7O3Q7Y.mjs';
+import '../../chunk-IFXZQW4C.mjs';

package/dist/xchains/icon/index.d.ts

@@ -1,4 +1,4 @@
-import { b as XService, c as XConnector, X as XAccount } from '../../XConnector-B9YQTVJ4.js';
+import { d as XService, c as XConnector, X as XAccount } from '../../XConnector-12q0OVe5.js';
 import { IconService } from 'icon-sdk-js';
 import { XToken } from '@sodax/types';
 

package/dist/xchains/icon/index.mjs

@@ -1,7 +1,5 @@
-export { CHAIN_INFO, IconHanaXConnector, IconXService, SupportedChainId } from '../../chunk-2BOUGCJ7.mjs';
-import '../../chunk-MAQ47Q52.mjs';
-import '../../chunk-MXZVF5HR.mjs';
-import '../../chunk-NY7U7OJW.mjs';
-import '../../chunk-X2MHIWXO.mjs';
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map
+export { CHAIN_INFO, IconHanaXConnector, IconXService, SupportedChainId } from '../../chunk-WPZOLGVB.mjs';
+import '../../chunk-TACW7Z4D.mjs';
+import '../../chunk-NAKCAL2M.mjs';
+import '../../chunk-7V7O3Q7Y.mjs';
+import '../../chunk-IFXZQW4C.mjs';

package/dist/xchains/injective/index.d.ts

@@ -1,8 +1,8 @@
-import { b as XService, c as XConnector, X as XAccount } from '../../XConnector-B9YQTVJ4.js';
+import { d as XService, c as XConnector, X as XAccount } from '../../XConnector-12q0OVe5.js';
 import { IndexerGrpcAccountPortfolioApi, ChainGrpcWasmApi } from '@injectivelabs/sdk-ts';
 import { MsgBroadcaster } from '@injectivelabs/wallet-core';
 import { InjectiveRpcConfig, XToken } from '@sodax/types';
-import { WalletStrategy } from '@injectivelabs/wallet-strategy';
+import { WalletStrategy } from '@sodax/libs/injective/wallet-strategy';
 import { Wallet } from '@injectivelabs/wallet-base';
 
 declare class InjectiveXService extends XService {

package/dist/xchains/injective/index.mjs

@@ -1,5 +1,3 @@
-export { InjectiveXConnector, InjectiveXService } from '../../chunk-BKJB527E.mjs';
-import '../../chunk-TZMKDXFA.mjs';
-import '../../chunk-X2MHIWXO.mjs';
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map
+export { InjectiveXConnector, InjectiveXService } from '../../chunk-MWWVB7TD.mjs';
+import '../../chunk-QMXBY3UI.mjs';
+import '../../chunk-IFXZQW4C.mjs';

package/dist/xchains/near/index.d.ts

@@ -1,4 +1,4 @@
-import { b as XService, c as XConnector, X as XAccount } from '../../XConnector-B9YQTVJ4.js';
+import { d as XService, c as XConnector, X as XAccount } from '../../XConnector-12q0OVe5.js';
 import { XToken } from '@sodax/types';
 import { NearConnector, NearWalletBase } from '@hot-labs/near-connect';
 

package/dist/xchains/near/index.mjs

@@ -1,6 +1,4 @@
-export { NearXConnector, NearXService } from '../../chunk-BXJLBR4G.mjs';
-import '../../chunk-MXZVF5HR.mjs';
-import '../../chunk-TZMKDXFA.mjs';
-import '../../chunk-X2MHIWXO.mjs';
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map
+export { NearXConnector, NearXService } from '../../chunk-C6M34IVL.mjs';
+import '../../chunk-NAKCAL2M.mjs';
+import '../../chunk-QMXBY3UI.mjs';
+import '../../chunk-IFXZQW4C.mjs';

package/dist/xchains/solana/index.d.ts

@@ -1,4 +1,4 @@
-import { b as XService, c as XConnector, X as XAccount } from '../../XConnector-B9YQTVJ4.js';
+import { d as XService, c as XConnector, X as XAccount } from '../../XConnector-12q0OVe5.js';
 import { XToken } from '@sodax/types';
 import { Connection } from '@solana/web3.js';
 import { WalletContextState, Wallet } from '@solana/wallet-adapter-react';

package/dist/xchains/solana/index.mjs

@@ -1,7 +1,5 @@
-export { SolanaXConnector } from '../../chunk-N5A2TMF6.mjs';
-export { SolanaXService } from '../../chunk-XZ7CHO2S.mjs';
-import '../../chunk-NY7U7OJW.mjs';
-import '../../chunk-TZMKDXFA.mjs';
-import '../../chunk-X2MHIWXO.mjs';
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map
+export { SolanaXConnector } from '../../chunk-XJA2MJMG.mjs';
+export { SolanaXService } from '../../chunk-VPNYFVP6.mjs';
+import '../../chunk-7V7O3Q7Y.mjs';
+import '../../chunk-QMXBY3UI.mjs';
+import '../../chunk-IFXZQW4C.mjs';

package/dist/xchains/stacks/index.d.ts

@@ -1,13 +1,19 @@
-import { b as XService, c as XConnector, X as XAccount } from '../../XConnector-B9YQTVJ4.js';
-import { XToken } from '@sodax/types';
-import { StacksNetwork, StacksNetworkName } from '@stacks/network';
-import { StacksProvider } from '@stacks/connect';
+import { d as XService, c as XConnector, X as XAccount } from '../../XConnector-12q0OVe5.js';
+import { StacksNetworkName, XToken } from '@sodax/types';
+import { StacksNetwork } from '@sodax/libs/stacks/core';
+import { StacksProvider } from '@sodax/libs/stacks/connect';
 
 declare class StacksXService extends XService {
     private static instance;
     network: StacksNetwork;
     private constructor();
     static getInstance(network?: StacksNetworkName | StacksNetwork): StacksXService;
+    /**
+     * @warning Network / fetch / contract-read failures are silently swallowed —
+     * `0n` is returned on any error. Callers cannot distinguish "zero balance"
+     * from "fetch failed"; UI that needs to surface the failure must wrap this
+     * call externally and re-fetch on its own error path.
+     */
     getBalance(address: string | undefined, xToken: XToken): Promise<bigint>;
 }
 

package/dist/xchains/stacks/index.mjs

@@ -1,5 +1,3 @@
-export { STACKS_PROVIDERS, StacksXConnector, StacksXService, useStacksXConnectors } from '../../chunk-PJLEJVAU.mjs';
-import '../../chunk-TZMKDXFA.mjs';
-import '../../chunk-X2MHIWXO.mjs';
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map
+export { STACKS_PROVIDERS, StacksXConnector, StacksXService, useStacksXConnectors } from '../../chunk-OPYSVPRW.mjs';
+import '../../chunk-QMXBY3UI.mjs';
+import '../../chunk-IFXZQW4C.mjs';

package/dist/xchains/stellar/index.d.ts

@@ -1,4 +1,4 @@
-import { b as XService, c as XConnector, X as XAccount } from '../../XConnector-B9YQTVJ4.js';
+import { d as XService, c as XConnector, X as XAccount } from '../../XConnector-12q0OVe5.js';
 import { StellarWalletsKit } from '@creit.tech/stellar-wallets-kit';
 import * as StellarSdk from '@stellar/stellar-sdk';
 import { rpc, Transaction, Memo, MemoType, Operation, FeeBumpTransaction } from '@stellar/stellar-sdk';

package/dist/xchains/stellar/index.mjs

@@ -1,6 +1,4 @@
-export { StellarWalletsKitXConnector, StellarXService } from '../../chunk-66BAUK56.mjs';
-import '../../chunk-MXZVF5HR.mjs';
-import '../../chunk-TZMKDXFA.mjs';
-import '../../chunk-X2MHIWXO.mjs';
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map
+export { StellarWalletsKitXConnector, StellarXService } from '../../chunk-X7BHR7WS.mjs';
+import '../../chunk-NAKCAL2M.mjs';
+import '../../chunk-QMXBY3UI.mjs';
+import '../../chunk-IFXZQW4C.mjs';

package/dist/xchains/sui/index.d.ts

@@ -1,4 +1,4 @@
-import { b as XService, c as XConnector, X as XAccount } from '../../XConnector-B9YQTVJ4.js';
+import { d as XService, c as XConnector, X as XAccount } from '../../XConnector-12q0OVe5.js';
 import { ISuiWalletProvider, XToken } from '@sodax/types';
 
 interface SuiClientLike {

package/dist/xchains/sui/index.mjs

@@ -1,7 +1,5 @@
-export { SuiXConnector, SuiXService } from '../../chunk-7ULB6DW4.mjs';
-import '../../chunk-MAQ47Q52.mjs';
-import '../../chunk-NY7U7OJW.mjs';
-import '../../chunk-TZMKDXFA.mjs';
-import '../../chunk-X2MHIWXO.mjs';
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map
+export { SuiXConnector, SuiXService } from '../../chunk-JQ4H4GJ5.mjs';
+import '../../chunk-TACW7Z4D.mjs';
+import '../../chunk-7V7O3Q7Y.mjs';
+import '../../chunk-QMXBY3UI.mjs';
+import '../../chunk-IFXZQW4C.mjs';

package/package.json

@@ -1,29 +1,45 @@
 {
   "name": "@sodax/wallet-sdk-react",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "license": "MIT",
-  "version": "2.0.0-rc.1",
+  "version": "2.0.0-rc.11",
   "description": "Wallet SDK of Sodax",
+  "keywords": [
+    "sodax",
+    "wallet",
+    "sdk",
+    "react",
+    "multichain",
+    "web3"
+  ],
+  "homepage": "https://github.com/icon-project/sodax-sdks/tree/main/packages/wallet-sdk-react",
+  "bugs": {
+    "url": "https://github.com/icon-project/sodax-sdks/issues"
+  },
   "type": "module",
-  "main": "./dist/index.cjs",
+  "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=20.12.0"
+  },
   "files": [
     "dist",
-    "README.md",
-    "docs",
-    "skills",
-    "ai-exported"
+    "!dist/**/*.map",
+    "README.md"
   ],
+  "sideEffects": false,
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs"
+      "import": "./dist/index.mjs"
     },
     "./xchains/*": {
       "types": "./dist/xchains/*/index.d.ts",
-      "import": "./dist/xchains/*/index.mjs",
-      "require": "./dist/xchains/*/index.cjs"
+      "import": "./dist/xchains/*/index.mjs"
     }
   },
   "typesVersions": {
@@ -38,9 +54,6 @@
     "url": "https://github.com/icon-project/sodax-sdks"
   },
   "dependencies": {
-    "@stacks/connect": "8.2.6",
-    "@stacks/network": "7.3.1",
-    "@stacks/transactions": "7.3.1",
     "@creit.tech/stellar-wallets-kit": "^1.7.5",
     "@hot-labs/near-connect": "0.10.0",
     "@injectivelabs/networks": "1.18.14",
@@ -49,57 +62,52 @@
     "@injectivelabs/wallet-base": "1.18.14",
     "@injectivelabs/wallet-core": "1.18.14",
     "@injectivelabs/wallet-cosmos": "1.18.14",
-    "@injectivelabs/wallet-evm": "1.18.14",
-    "@injectivelabs/wallet-strategy": "1.18.14",
     "@mysten/dapp-kit": "0.14.18",
     "@mysten/sui": "1.21.2",
     "near-api-js": "7.2.0",
     "@solana/spl-token": "0.4.9",
     "@solana/wallet-adapter-react": "0.15.35",
-    "@solana/wallet-adapter-wallets": "0.19.30",
     "@solana/web3.js": "1.98.0",
     "@stellar/stellar-sdk": "15.1.0",
-    "@walletconnect/ethereum-provider": "^2.23.9",
     "icon-sdk-js": "1.5.3",
     "immer": "10.1.1",
     "sats-connect": "^4.2.1",
     "viem": "2.29.2",
     "wagmi": "2.16.9",
     "zustand": "4.5.2",
-    "bs58": "6.0.0",
-    "@sodax/types": "2.0.0-rc.1",
-    "@sodax/wallet-sdk-core": "2.0.0-rc.1"
+    "@sodax/libs": "2.0.0-rc.11",
+    "@sodax/wallet-sdk-core": "2.0.0-rc.11",
+    "@sodax/types": "2.0.0-rc.11"
   },
   "devDependencies": {
+    "@arethetypeswrong/cli": "0.17.4",
     "@testing-library/react": "^16.1.0",
     "@types/react": "^19.0.8",
     "@types/react-dom": "^19.0.3",
+    "cross-env": "7.0.3",
     "happy-dom": "^20.8.9",
     "knip": "5.30.5",
+    "madge": "8.0.0",
     "react-dom": "19.1.4",
+    "tslib": "2.8.1",
     "tsup": "8.5.0",
     "typescript": "5.5.4",
-    "vitest": "2.1.9"
+    "vitest": "3.2.4"
   },
   "peerDependencies": {
     "@tanstack/react-query": "5.x",
     "react": ">=19"
   },
-  "engines": {
-    "node": ">=18.0.0"
-  },
   "scripts": {
-    "build": "NODE_OPTIONS=--max-old-space-size=8192 tsup",
+    "build": "cross-env NODE_OPTIONS=--max-old-space-size=8192 tsup",
     "dev": "tsup --watch ./src",
     "clean": "rm -rf dist && rm -rf node_modules && rm -rf .turbo",
     "pretty": "biome format . --write",
     "checkTs": "tsc --noEmit",
-    "checkTs:examples": "tsc --noEmit -p tsconfig.examples.json",
+    "check-exports": "attw --pack --profile esm-only",
     "test": "vitest run",
-    "knip": "knip",
-    "lint": "biome lint . --write",
-    "check:ai-exported": "bash ./scripts/check-ai-exported.sh",
-    "check:ai-links": "bash ./scripts/check-ai-links.sh",
-    "check:ai-imports": "bash ./scripts/check-ai-imports.sh"
+    "check:knip": "knip",
+    "check:circular-deps": "madge --circular $(find ./src -name '*.ts' -o -name '*.tsx')",
+    "lint": "biome lint . --write"
   }
 }

package/ai-exported/AGENTS.md

@@ -1,122 +0,0 @@
-# AGENTS.md — `@sodax/wallet-sdk-react` AI Export
-
-You are a coding agent helping a developer **integrate** or **migrate** the `@sodax/wallet-sdk-react` package. This document is your entry point. Read this first, then route to the right sub-folder.
-
-The files in this `ai-exported/` directory are designed for AI consumption: short, table-heavy, self-contained recipes, and machine-checkable checklists. Human-readable narrative lives in each folder's `README.md`.
-
----
-
-## Step 1 — Identify the task
-
-| User says... | Path | Start at |
-|---|---|---|
-| "upgrade to v2", "migrate from v1", "old hooks no longer work", "useXWagmiStore is gone" | **migration** | `migration/ai-rules.md` |
-| "add wallet connect", "set up SodaxWalletProvider", "first time using this lib" | **integration** | `integration/ai-rules.md` |
-| Looking up a v1 → v2 symbol mapping | direct | `migration/reference/*.md` |
-| Looking up a hook signature or available connector | direct | `integration/reference/*.md` |
-
-The package name **did not change** between v1 and v2 — both versions publish as `@sodax/wallet-sdk-react`. Migration is detected by import surface (`useXWagmiStore`, positional hook args, `rpcConfig` / `options` / `initialState` props on `SodaxWalletProvider`), not by package name.
-
-If both signals appear (project has v1 patterns AND wants new features), **migration first, then integration**.
-
----
-
-## Step 2 — Load the right context
-
-**For migration tasks:**
-
-1. `migration/ai-rules.md` — DO/DON'T + workflow + stop conditions
-2. `migration/breaking-changes.md` — narrative WHY behind each change
-3. `migration/reference/*.md` — lookup tables (imports, hooks, config, components)
-4. `migration/recipes/<task>.md` — paired before/after for the specific use case
-5. `migration/checklist.md` — verification loop
-
-**For integration tasks:**
-
-1. `integration/ai-rules.md` — DO/DON'T + workflow
-2. `integration/recipes/setup.md` — always read this first (everything else depends on it)
-3. `integration/recipes/<task>.md` — task-specific guide
-4. `integration/reference/*.md` — API surface lookup
-
----
-
-## Step 3 — Honor flow-specific stop conditions
-
-Each flow has its own list of conditions that **HARD STOP** code generation and require asking the user:
-
-- Migration stops → [`migration/ai-rules.md`](./migration/ai-rules.md) § "Stop conditions"
-- Integration stops → [`integration/ai-rules.md`](./integration/ai-rules.md) § "Stop conditions"
-
-Read the relevant list **before** applying any change. When stopping, quote the offending file/line and present the user with concrete options. Do **not** guess.
-
-Cross-flow signals (true regardless of flow):
-
-- User explicitly requests a behavior that v2 does not support (custom chain not in [`integration/reference/chain-support.md`](./integration/reference/chain-support.md), custom `XService` / `XConnector` subclass with non-trivial logic).
-- User mixes both v1 and v2 patterns in new code being written — do migration first, then integration.
-
----
-
-## Step 4 — Verification protocol
-
-After **every** code change you make:
-
-1. Run `pnpm checkTs` from the user's app root (or the package the change touched).
-2. If errors mention `@sodax/wallet-sdk-react`, look up the symbol in `migration/reference/` or `integration/reference/`.
-3. If a symbol isn't in any reference file, **stop and ask**. Do not invent migrations.
-4. After all errors resolve, mark the relevant items in `migration/checklist.md` (for migrations) or move to the next recipe.
-
-You are **done** when:
-- `pnpm checkTs` exits clean for the user's project.
-- All items in `migration/checklist.md` are checked (migration only).
-- The user has confirmed the changed flow works in their dev environment.
-
----
-
-## Conventions in this directory
-
-- **Recipes are self-contained.** A recipe file in `recipes/` contains everything needed to apply the change — before/after code, steps, verification. Do not jump between files.
-- **Reference files are tables.** `reference/*.md` contains markdown tables and paired code blocks marked `// v1 ❌` and `// v2 ✅`. Treat them as lookup, not narrative.
-- **Token budget**: Each file is sized to fit comfortably in your context. If you find yourself loading more than 3 files for a single task, you are probably doing it wrong — re-route via the table above.
-- **Single source of truth**: Behavioral / breaking-change *explanations* live only in `migration/breaking-changes.md`. Other files reference it but do not duplicate the prose.
-
----
-
-## Quick symbol lookup
-
-If the user mentions a symbol you don't recognize, grep these files in order:
-
-```
-migration/reference/imports.md      — import path changes
-migration/reference/hooks.md        — hook renames + signature changes
-migration/reference/config.md       — SodaxWalletProvider config changes
-migration/reference/components.md   — component / provider renames
-integration/reference/hooks.md      — full v2 hook surface
-integration/reference/connectors.md — available wallet connectors per chain
-integration/reference/chain-support.md — supported chains + slots
-```
-
-If still not found: the symbol may be **internal** (not exported from v2) or **removed**. Ask the user to share the v1 file/line so you can decide.
-
----
-
-## Package context
-
-- **Name**: `@sodax/wallet-sdk-react` (same package name in v1 and v2)
-- **Version target**: v2.x (current).
-- **Peer deps**: `react >= 19`, `@tanstack/react-query 5.x`
-- **Install**: `pnpm add @sodax/wallet-sdk-react @tanstack/react-query`
-- **Audience**: dApp builders integrating multi-chain wallet connectivity (9 chain types: EVM, Solana, Sui, Bitcoin, Stellar, ICON, Injective, NEAR, Stacks).
-
-For internal architecture (only relevant if you're modifying the package itself, not consuming it), see `../CLAUDE.md` in the parent directory.
-
----
-
-## Pointers
-
-- [`integration/README.md`](./integration/README.md) — start here for new integrations: file index, recommended reading order, install snippet, provider-stack ordering.
-- [`migration/README.md`](./migration/README.md) — start here for v1 → v2 ports: file index, reading order, cross-cutting checklist pointer.
-- [`integration/recipes/setup.md`](./integration/recipes/setup.md) — install, mount `SodaxWalletProvider`, pick chain slots.
-- [`integration/architecture.md`](./integration/architecture.md) — mental model: provider mount tree, frozen config, EVM single-connection, `xChainType` vs `xChainId`.
-- [`integration/reference/`](./integration/reference/) — hooks, connectors, chain-support, wallet-brand identifiers lookup tables.
-- [`integration/reference/wallet-brands.md`](./integration/reference/wallet-brands.md) — known wallet brand identifiers (`'hana'`, `'phantom'`, `'xverse'`, …) for batch hooks, plus a runtime discovery snippet.
-- [`migration/breaking-changes.md`](./migration/breaking-changes.md) — full narrative of every v1 → v2 change.

package/ai-exported/integration/README.md

@@ -1,102 +0,0 @@
-# Integration: First-time setup (Human-readable overview)
-
-This folder helps you integrate `@sodax/wallet-sdk-react` into a fresh React app. It is the **human-facing** entry point for new integrations. If you are a coding agent, read [`ai-rules.md`](./ai-rules.md) first.
-
-If you are migrating from v1 instead, see `../migration/`.
-
----
-
-## What this package does
-
-`@sodax/wallet-sdk-react` is the React layer over `@sodax/wallet-sdk-core`. It gives you:
-
-- **Multi-chain wallet connect** across 9 chain types (EVM, Solana, Sui, Bitcoin, Stellar, ICON, Injective, NEAR, Stacks).
-- **Hooks** (`useXConnect`, `useXAccount`, `useXDisconnect`, `useXSignMessage`, etc.) backed by a Zustand store — composable and SSR-safe.
-- **Headless modal primitives** (`useWalletModal`, `useChainGroups`, `useBatchConnect`) — bring your own UI.
-- **Typed wallet providers** for hand-off to `@sodax/sdk` calls (`useWalletProvider`).
-
----
-
-## Recommended path (in order)
-
-If this is your first time using the package:
-
-1. [`recipes/setup.md`](./recipes/setup.md) — install, wire `SodaxWalletProvider`, pick chain slots. **Always do this first**.
-2. Pick a connect UX (one, not both):
-   - [`recipes/connect-button.md`](./recipes/connect-button.md) — single chain, simplest UX.
-   - [`recipes/multi-chain-modal.md`](./recipes/multi-chain-modal.md) — chain picker + connector picker, headless.
-3. [`recipes/sign-message.md`](./recipes/sign-message.md) — sign messages cross-chain (auth flows).
-4. [`recipes/bridge-to-sdk.md`](./recipes/bridge-to-sdk.md) — pass `walletProvider` to `@sodax/sdk` calls (swaps, lending, staking, etc.).
-5. [`recipes/switch-chain.md`](./recipes/switch-chain.md) — switch the active EVM network when source chain doesn't match.
-6. [`recipes/chain-detection.md`](./recipes/chain-detection.md) — list enabled chains, render connected list with hydration gate, install detection.
-7. Add advanced features as needed:
-   - [`recipes/walletconnect-setup.md`](./recipes/walletconnect-setup.md) — enable WalletConnect for enterprise-custody / mobile-only wallets.
-   - [`recipes/batch-operations.md`](./recipes/batch-operations.md) — batch connect / disconnect across multiple chains.
-   - [`recipes/sub-path-imports.md`](./recipes/sub-path-imports.md) — deep imports from `xchains/<chain>` for `instanceof` checks or custom connector lists.
-8. Reference docs (lookup as needed):
-   - [`reference/hooks.md`](./reference/hooks.md) — full hook surface with signatures.
-   - [`reference/connectors.md`](./reference/connectors.md) — available wallet connectors per chain.
-   - [`reference/chain-support.md`](./reference/chain-support.md) — supported chains, slots, and adapter notes.
-9. Copy-paste examples (runnable code, minimal narrative):
-   - [`examples/`](./examples/) — 4 self-contained `.tsx` files: minimal EVM setup, multi-chain modal, Next.js App Router, WalletConnect setup.
-
----
-
-## Install
-
-```bash
-pnpm add @sodax/wallet-sdk-react @tanstack/react-query
-```
-
-Peer dependencies:
-
-```json
-{
-  "react": ">=19",
-  "@tanstack/react-query": "5.x"
-}
-```
-
----
-
-## Pair with `@sodax/sdk` and `@sodax/dapp-kit`
-
-Most apps integrate this package together with the SDK and dapp-kit:
-
-```
-@sodax/sdk            ← business logic (swaps, lending, staking, etc.)
-@sodax/dapp-kit       ← high-level React hooks combining SDK + wallet-sdk
-@sodax/wallet-sdk-react  ← wallet connectivity (this package)
-```
-
-If you are using all three, mount providers in this order at the app root:
-
-```tsx
-<SodaxProvider config={sodaxConfig}>            {/* @sodax/dapp-kit */}
-  <QueryClientProvider client={queryClient}>
-    <SodaxWalletProvider config={walletConfig}>  {/* this package */}
-      {children}
-    </SodaxWalletProvider>
-  </QueryClientProvider>
-</SodaxProvider>
-```
-
-`SodaxProvider` (from dapp-kit) wraps the lot. `QueryClientProvider` must wrap `SodaxWalletProvider` because hooks inside use React Query.
-
----
-
-## Conventions worth knowing
-
-- **Hooks use a single options object.** `useXConnectors({ xChainType: 'EVM' })`, not positional args.
-- **`xChainId` (chain key) and `xChainType` (family) are both accepted** by `useXAccount` and `useWalletProvider`. Pass one, not both.
-- **`useXConnect` is a React Query mutation.** Pass an `IXConnector` to `mutateAsync`.
-- **Persisted connections.** Connections survive reload via `localStorage` key `xwagmi-store`. Gate UI on `useConnectedChains().status === 'ready'` to avoid hydration flicker.
-- **EVM is one connection across all networks.** wagmi treats every configured EVM chain as part of one connector — there is no per-network connect/disconnect.
-
----
-
-## Getting help
-
-- API surface lookup: [`reference/`](./reference/).
-- Bug or missing feature: [open an issue](https://github.com/icon-project/sodax-sdks/issues).
-- Internal architecture (only relevant for SODAX maintainers): `../CLAUDE.md` in the package root.