@sodax/wallet-sdk-react 2.0.0-rc.3 → 2.0.0-rc.4

package/dist/xchains/sui/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/core/XService.ts","../../../src/utils/index.ts","../../../src/shared/guards.ts","../../../src/xchains/sui/SuiXService.ts","../../../src/core/XConnector.ts","../../../src/xchains/sui/SuiXConnector.ts"],"names":["address","SuiWalletProvider"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ChainType, IXServiceBase, XToken } from '@sodax/types';\nimport type { IXConnector } from '@/types/interfaces.js';\n\n/**\n * Abstract base class for blockchain service implementations.\n *\n * The XService class serves as a foundation for implementing blockchain-specific services\n * in a multi-chain environment. It provides a standardized interface for:\n * 1. Managing wallet connectors for different blockchain types\n * 2. Querying token balances across different chains\n *\n * Each blockchain implementation (e.g., Solana, EVM chains) extends this class\n * to provide chain-specific functionality while maintaining a consistent interface.\n *\n * @abstract\n * @class XService\n * @property {ChainType} xChainType - The blockchain type this service handles (e.g., 'SOLANA', 'EVM')\n * @property {XConnector[]} xConnectors - Available wallet connectors for this chain\n *\n */\nexport abstract class XService implements IXServiceBase {\n  /** The blockchain type this service handles */\n  public readonly xChainType: ChainType;\n\n  /** Available wallet connectors for this chain */\n  private xConnectors: IXConnector[] = [];\n\n  constructor(xChainType: ChainType) {\n    this.xChainType = xChainType;\n  }\n\n  /**\n   * Gets the balance of a specific token for an address\n   * @param address The wallet address to check\n   * @param xToken The token to get the balance for\n   * @returns Promise resolving to the token balance as a bigint\n   */\n  public async getBalance(address: string | undefined, xToken: XToken): Promise<bigint> {\n    return 0n;\n  }\n\n  /**\n   * Gets balances for multiple tokens for an address\n   * @param address The wallet address to check\n   * @param xTokens Array of tokens to get balances for\n   * @returns Promise resolving to object mapping token addresses to balances\n   */\n  public async getBalances(address: string | undefined, xTokens: readonly XToken[]): Promise<Record<string, bigint>> {\n    if (!address) return {};\n\n    const balancePromises = xTokens.map(async xToken => {\n      const balance = await this.getBalance(address, xToken);\n      return { address: xToken.address, balance };\n    });\n\n    const balances = await Promise.all(balancePromises);\n    return balances.reduce<Record<string, bigint>>((acc, { address, balance }) => {\n      acc[address] = balance;\n      return acc;\n    }, {});\n  }\n\n  /**\n   * Gets all available connectors for this chain\n   */\n  public getXConnectors(): IXConnector[] {\n    return this.xConnectors;\n  }\n\n  /**\n   * Sets the available connectors for this chain\n   */\n  public setXConnectors(xConnectors: IXConnector[]): void {\n    this.xConnectors = xConnectors;\n  }\n\n  /**\n   * Gets a specific connector by its ID\n   * @param xConnectorId The connector ID to look up\n   * @returns The matching connector or undefined if not found\n   */\n  public getXConnectorById(xConnectorId: string): IXConnector | undefined {\n    return this.getXConnectors().find(xConnector => xConnector.id === xConnectorId);\n  }\n}\n","import { baseChainInfo, type SpokeChainKey, type XToken } from '@sodax/types';\n\nexport { sortConnectors, type SortConnectorsOptions } from './sortConnectors.js';\nexport {\n  getEntryDefaults,\n  getRpcUrl,\n  resolveEvmDefaults,\n  type WalletDefaultsByKey,\n} from './walletRpcConfig.js';\n\nexport const isNativeToken = (xToken: XToken): boolean => {\n  const nativeAddresses = [\n    'cx0000000000000000000000000000000000000000',\n    '0x0000000000000000000000000000000000000000',\n    'inj',\n    '0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI',\n    'hx0000000000000000000000000000000000000000',\n    '11111111111111111111111111111111', // solana\n    'CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA', // stellar\n    'ST000000000000000000002AMW42H.nativetoken', // stacks\n    '0:0', // bitcoin\n  ];\n\n  return nativeAddresses.includes(xToken.address);\n};\n\nexport const getWagmiChainId = (xChainId: SpokeChainKey): number => {\n  const chainId = baseChainInfo[xChainId].chainId;\n  if (typeof chainId !== 'number') {\n    throw new Error(`[wallet-sdk-react] getWagmiChainId: expected numeric chainId, got ${typeof chainId}`);\n  }\n  return chainId;\n};\n","// packages/wallet-sdk-react/src/shared/guards.ts\n\n/**\n * Tiny runtime type guards used to safely narrow `unknown` values.\n *\n * Why this exists:\n * - In wallets land, many values come from outside TypeScript (window injections, 3rd-party SDKs, serialized state).\n * - Writing `as SomeType` skips checks and can crash later in confusing places.\n * - Guards + `assert(...)` let us fail fast with a clear error message at the boundary.\n */\n\nexport type UnknownRecord = Record<string, unknown>;\n\n/** True if value is a non-null object (Record-like). */\nexport function isRecord(value: unknown): value is UnknownRecord {\n  return typeof value === 'object' && value !== null;\n}\n\n/** True if the object has a string property at `key`. */\nexport function hasStringProperty<Key extends string>(\n  value: unknown,\n  key: Key,\n): value is UnknownRecord & Record<Key, string> {\n  return isRecord(value) && typeof value[key] === 'string';\n}\n\n/** True if the object has an optional string property at `key`. */\nexport function hasOptionalStringProperty<Key extends string>(\n  value: unknown,\n  key: Key,\n): value is UnknownRecord & Partial<Record<Key, string>> {\n  return isRecord(value) && (value[key] === undefined || typeof value[key] === 'string');\n}\n\n/** True if the object has a boolean property at `key`. */\nexport function hasBooleanProperty<Key extends string>(\n  value: unknown,\n  key: Key,\n): value is UnknownRecord & Record<Key, boolean> {\n  return isRecord(value) && typeof value[key] === 'boolean';\n}\n\n/** True if the object has a function property at `key`. */\nexport function hasFunctionProperty<Key extends string>(\n  value: unknown,\n  key: Key,\n): value is UnknownRecord & Record<Key, (...args: unknown[]) => unknown> {\n  return isRecord(value) && typeof value[key] === 'function';\n}\n\n/**\n * Throws if condition is false.\n * Use this after guards to stop execution early with an actionable error message.\n */\nexport function assert(condition: unknown, message: string): asserts condition {\n  if (!condition) {\n    throw new Error(message);\n  }\n}\n\n/**\n * Validates the runtime shape of Sui provider dependencies before passing them to wallet-sdk-core.\n * Used by both SuiHydrator (render path) and SuiXService.createWalletProvider (imperative path).\n */\nexport function assertSuiProviderShape(caller: string, client: unknown, wallet: unknown, account: unknown): void {\n  const clientOk =\n    isRecord(client) &&\n    hasFunctionProperty(client, 'executeTransactionBlock') &&\n    hasFunctionProperty(client, 'devInspectTransactionBlock') &&\n    hasFunctionProperty(client, 'getCoins');\n  assert(clientOk, `[${caller}] invalid Sui client shape`);\n\n  const walletOk = isRecord(wallet) && hasStringProperty(wallet, 'name');\n  assert(walletOk, `[${caller}] invalid Sui wallet shape`);\n\n  const accountOk = isRecord(account) && hasStringProperty(account, 'address');\n  assert(accountOk, `[${caller}] invalid Sui account shape`);\n}\n","import { XService } from '@/core/XService.js';\nimport type { XToken, ISuiWalletProvider } from '@sodax/types';\nimport { SuiWalletProvider } from '@sodax/wallet-sdk-core';\nimport { isNativeToken } from '@/utils/index.js';\nimport { assertSuiProviderShape } from '@/shared/guards.js';\n\n// These fields are hydrated by SuiHydrator from @mysten/dapp-kit hooks.\n// We use structural interfaces instead of importing nominal types from @mysten/wallet-standard\n// because dapp-kit may resolve a different version than wallet-sdk-core, causing nominal mismatch.\n// The `getBalance` method is the only field we call directly — the rest are passed through.\ninterface SuiClientLike {\n  getBalance(input: { owner: string; coinType: string }): Promise<{ totalBalance: string }>;\n}\n\nexport class SuiXService extends XService {\n  private static instance: SuiXService;\n\n  // Hydrated by SuiHydrator. Start undefined because wallet may not be connected yet.\n  // suiClient is typed structurally for the methods we call directly.\n  // suiWallet/suiAccount are opaque — stored and passed through to SuiWalletProvider.\n  public suiClient: SuiClientLike | undefined;\n  public suiWallet: unknown;\n  public suiAccount: unknown;\n\n  private constructor() {\n    super('SUI');\n  }\n\n  public static getInstance(): SuiXService {\n    if (!SuiXService.instance) {\n      SuiXService.instance = new SuiXService();\n    }\n    return SuiXService.instance;\n  }\n\n  createWalletProvider(): ISuiWalletProvider | undefined {\n    if (!this.suiClient || !this.suiWallet || !this.suiAccount) {\n      console.warn(\n        '[SuiXService] createWalletProvider: missing dependencies — wallet not connected yet',\n        { hasClient: !!this.suiClient, hasWallet: !!this.suiWallet, hasAccount: !!this.suiAccount },\n      );\n      return undefined;\n    }\n\n    // Runtime validation before passing data to wallet-sdk-core. This avoids \"trust me bro\" casting.\n    // Note: we validate the minimum shape we rely on; the exact nominal types may differ by package version.\n    assertSuiProviderShape('SuiXService', this.suiClient, this.suiWallet, this.suiAccount);\n\n    // Version mismatch cast: dapp-kit hooks return types from their bundled @mysten/wallet-standard,\n    // which differs nominally from wallet-sdk-core's version. Structurally identical at runtime.\n    type SuiWalletProviderConfig = ConstructorParameters<typeof SuiWalletProvider>[0];\n    return new SuiWalletProvider({\n      client: this.suiClient,\n      wallet: this.suiWallet,\n      account: this.suiAccount,\n    } as unknown as SuiWalletProviderConfig);\n  }\n\n  // getBalance is not used because getBalances uses getAllBalances which returns all balances\n\n  override async getBalances(address: string | undefined, xTokens: readonly XToken[]): Promise<Record<string, bigint>> {\n    if (!address || !this.suiClient) return {};\n    // Capture in local so the closure sees a narrowed (non-undefined) reference.\n    const client = this.suiClient;\n    try {\n      const balancePromises = xTokens.map(async xToken => {\n        let coinType = isNativeToken(xToken) ? '0x2::sui::SUI' : xToken.address;\n\n        //  TODO: hard coded for getting legacy bnUSD balance\n        if (\n          coinType ===\n          '0x03917a812fe4a6d6bc779c5ab53f8a80ba741f8af04121193fc44e0f662e2ceb::balanced_dollar::BALANCED_DOLLAR'\n        ) {\n          coinType =\n            '0x3917a812fe4a6d6bc779c5ab53f8a80ba741f8af04121193fc44e0f662e2ceb::balanced_dollar::BALANCED_DOLLAR';\n        }\n\n        const balance = await client.getBalance({\n          owner: address,\n          coinType: coinType,\n        });\n\n        return {\n          address: xToken.address,\n          balance: balance ? BigInt(balance.totalBalance) : undefined,\n        };\n      });\n\n      const results = await Promise.all(balancePromises);\n\n      const tokenMap: Record<string, bigint> = {};\n      results.forEach(result => {\n        if (result.balance !== undefined) {\n          tokenMap[result.address] = result.balance;\n        }\n      });\n\n      return tokenMap;\n    } catch (error) {\n      console.error('[wallet-sdk-react] SUI getBalances failed:', error);\n      return {};\n    }\n  }\n}\n","import type { ChainType } from '@sodax/types';\nimport type { XAccount } from '@/types/index.js';\nimport type { IXConnector } from '@/types/interfaces.js';\n\n/**\n * Base class for wallet provider connectors that handles connection management and wallet interactions\n *\n * @abstract\n * @class XConnector\n * @property {ChainType} xChainType - The blockchain type this connector supports\n * @property {string} name - Display name of the wallet provider\n * @property {string} _id - Unique identifier for the connector\n * @property {string | undefined} _icon - Optional icon URL for the wallet provider\n */\n\nexport abstract class XConnector implements IXConnector {\n  /** The blockchain type this connector supports */\n  public readonly xChainType: ChainType;\n\n  /** Display name of the wallet provider */\n  public readonly name: string;\n\n  /** Unique identifier for the connector */\n  public readonly _id: string;\n\n  /** Optional icon URL for the wallet provider */\n  public readonly _icon?: string;\n\n  constructor(xChainType: ChainType, name: string, id: string) {\n    this.xChainType = xChainType;\n    this.name = name;\n    this._id = id;\n  }\n\n  /**\n   * Connects to the wallet provider\n   * @returns Promise resolving to the connected account, or undefined if connection fails\n   */\n  abstract connect(): Promise<XAccount | undefined>;\n\n  /**\n   * Disconnects from the wallet provider\n   */\n  abstract disconnect(): Promise<void>;\n\n  /** Get the unique identifier for this connector */\n  public get id(): string {\n    return this._id;\n  }\n\n  /** Get the optional icon URL for this wallet provider */\n  public get icon(): string | undefined {\n    return this._icon;\n  }\n\n  /**\n   * True when the wallet extension backing this connector is installed.\n   * Default: true (for provider-managed chains where connector presence already\n   * implies install — EVM via EIP-6963, Solana/Sui via adapter discovery).\n   * Subclasses backed by extension injection (Bitcoin, ICON, Stacks) override\n   * this with a window probe.\n   */\n  public get isInstalled(): boolean {\n    return true;\n  }\n\n  /** URL to install the wallet extension when missing. Subclasses override. */\n  public get installUrl(): string | undefined {\n    return undefined;\n  }\n}\n","import type { XAccount } from '@/types/index.js';\n\nimport { XConnector } from '@/core/index.js';\nimport { SuiXService } from './SuiXService.js';\nimport { assert, hasOptionalStringProperty, hasStringProperty, isRecord } from '@/shared/guards.js';\n\n// Structural interface for what we actually use from a Sui wallet.\n// We don't import the nominal type from @mysten/wallet-standard because\n// @mysten/dapp-kit may resolve a different version, causing nominal mismatch.\n// Structural typing avoids this: as long as the object has these fields, it works.\ninterface SuiWalletInfo {\n  id?: string;\n  name: string;\n  icon?: string;\n}\n\nconst isSuiWalletInfo = (value: unknown): value is SuiWalletInfo => {\n  return (\n    isRecord(value) &&\n    hasStringProperty(value, 'name') &&\n    // Some wallets may not expose `id` — in that case we fall back to `name` for stability.\n    // We still validate if it exists.\n    hasOptionalStringProperty(value, 'id') &&\n    hasOptionalStringProperty(value, 'icon')\n  );\n};\n\nexport class SuiXConnector extends XConnector {\n  public readonly wallet: SuiWalletInfo;\n\n  constructor(wallet: unknown) {\n    assert(isSuiWalletInfo(wallet), '[SuiXConnector] invalid wallet object');\n\n    const id = wallet.id ?? wallet.name;\n    // After the fallback, `id` is always defined.\n    assert(typeof id === 'string' && id.length > 0, '[SuiXConnector] invalid wallet id');\n\n    super('SUI', wallet.name, id);\n    this.wallet = { id, name: wallet.name, icon: wallet.icon };\n  }\n\n  getXService(): SuiXService {\n    return SuiXService.getInstance();\n  }\n\n  async connect(): Promise<XAccount | undefined> {\n    return;\n  }\n\n  async disconnect(): Promise<void> {}\n\n  public override get icon(): string | undefined {\n    return this.wallet.icon;\n  }\n}\n"]}

package/dist/xchains/sui/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/skills/SKILLS.md

@@ -1,84 +0,0 @@
-# @sodax/wallet-sdk-react Skills
-
-Scaffolding guides that let you wire SODAX wallet connectivity into a React app in one prompt. Built for and tested with [Claude Code](https://docs.anthropic.com/en/docs/claude-code) — point it at a skill file and it generates the correct providers, hooks, and types.
-
-## Quick Start
-
-Skills ship with the npm package. After installing `@sodax/wallet-sdk-react`:
-
-**1. Set up providers** (do this first)
-
-> Read `node_modules/@sodax/wallet-sdk-react/skills/setup.md` and wire `SodaxWalletProvider` into my app.
-
-**2. Pick a connect UX**
-
-> Read `node_modules/@sodax/wallet-sdk-react/skills/connect-button.md` and add a single-chain connect button.
-
-> Read `node_modules/@sodax/wallet-sdk-react/skills/multi-chain-modal.md` and add a multi-chain wallet modal.
-
-**3. Add advanced features as needed**
-
-> Read `node_modules/@sodax/wallet-sdk-react/skills/evm-only-walletconnect.md` and enable WalletConnect for enterprise custody (Fireblocks, etc.).
-
-> Read `node_modules/@sodax/wallet-sdk-react/skills/bridge-to-sdk.md` and pass the connected wallet provider to a `@sodax/sdk` swap call.
-
-The pattern is always: `Read node_modules/@sodax/wallet-sdk-react/skills/<skill>.md` + what you want to build.
-
-### Tips
-
-- One skill per prompt gets better results than asking for everything at once.
-- Always do setup before any other skill.
-- Pair `connect-button.md` (one chain at a time) OR `multi-chain-modal.md` (chain picker + connector picker) — they're alternatives, not additive.
-
----
-
-*Internal devs working in this monorepo: use `skills/<skill>.md` instead of the `node_modules` path, and reference sibling docs in `docs/` for the underlying API.*
-
-## Dependency Graph
-
-```
-setup
-  ├── connect-button         (single-chain connect/disconnect)
-  ├── multi-chain-modal      (modal-driven multi-chain UX)
-  ├── evm-only-walletconnect (Fireblocks / custody opt-in)
-  └── bridge-to-sdk          (pass walletProvider to @sodax/sdk calls)
-```
-
-## Skill Index
-
-| Skill | File | Description | Depends On |
-|-------|------|-------------|------------|
-| Setup | [setup.md](setup.md) | Install + wire `SodaxWalletProvider` with chain-type slots | None |
-| Connect Button | [connect-button.md](connect-button.md) | `useXConnectors` + `useXConnect` + `useXDisconnect` for one chain | `setup` |
-| Multi-chain Modal | [multi-chain-modal.md](multi-chain-modal.md) | `useWalletModal` headless state machine + `useChainGroups` | `setup` |
-| EVM-only WalletConnect | [evm-only-walletconnect.md](evm-only-walletconnect.md) | Enable WalletConnect for Fireblocks / Ledger / mobile-only wallets | `setup` |
-| Bridge to SDK | [bridge-to-sdk.md](bridge-to-sdk.md) | `useWalletProvider` → typed `IXxxWalletProvider` for `@sodax/sdk` calls | `setup`, one of `connect-button` / `multi-chain-modal` |
-
-## Conventions
-
-### Single object parameter
-
-Every hook in `@sodax/wallet-sdk-react` accepts one options object:
-
-```typescript
-useXConnectors({ xChainType: 'EVM' });
-useXAccount({ xChainId: ChainKeys.BSC_MAINNET });
-useWalletProvider({ xChainType: 'EVM' });
-```
-
-`useXAccount` / `useWalletProvider` accept either `xChainId` (chain key) **or** `xChainType` (family) — never both.
-
-### Mutation pattern (`useXConnect`)
-
-`useXConnect` is a React Query mutation. Pass an `IXConnector` to `mutate` / `mutateAsync`:
-
-```typescript
-const { mutateAsync: connect } = useXConnect();
-await connect(connector);
-```
-
-For provider-managed chains (EVM/Solana/Sui), the resolved value is `undefined` — read the connected account via `useXAccount` after the mutation lands. See [Connect Flow caveat](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/CONNECT_FLOW.md#provider-managed-chains-caveat).
-
-### Persisted connections
-
-Connections survive page reloads via `localStorage` (key `xwagmi-store`). Gate UI on hydration to avoid flicker — `useConnectedChains().status === 'ready'` is the official signal.

package/skills/bridge-to-sdk.md

@@ -1,148 +0,0 @@
-# Skill: Bridge to SDK
-
-Pass the user's connected wallet to `@sodax/sdk` calls — `useWalletProvider` returns a typed `IXxxWalletProvider` ready to plug into any SDK method.
-
-**Depends on:** [setup.md](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/skills/setup.md), one of [connect-button.md](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/skills/connect-button.md) / [multi-chain-modal.md](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/skills/multi-chain-modal.md)
-
-## Hooks
-
-| Hook | Purpose |
-|------|---------|
-| `useWalletProvider({ xChainId })` | Typed `IXxxWalletProvider` (chain-narrowed by chain id) |
-| `useWalletProvider({ xChainType })` | Family-level provider (same shape for every chain id in family) |
-| `useXAccount({ xChainId })` | Read connected address |
-| `useXService({ xChainType })` | Lower-level — chain `XService` instance for advanced reads |
-
-Pass either `xChainId` (a `SpokeChainKey`) or `xChainType` (a `ChainType`), never both.
-
-## Pattern — drive an SDK swap from a connected wallet
-
-```tsx
-import { useWalletProvider, useXAccount } from '@sodax/wallet-sdk-react';
-import { Sodax, ChainKeys } from '@sodax/sdk';
-import type { CreateIntentParams } from '@sodax/sdk';
-
-const sodax = new Sodax(); // or hold one in context / pass via @sodax/dapp-kit
-
-export function SwapButton({ params }: { params: CreateIntentParams<typeof ChainKeys.BSC_MAINNET> }) {
-  const walletProvider = useWalletProvider({ xChainId: ChainKeys.BSC_MAINNET });
-  const account = useXAccount({ xChainId: ChainKeys.BSC_MAINNET });
-
-  const handleSwap = async () => {
-    if (!walletProvider) return;
-    const result = await sodax.swaps.swap({
-      params,
-      walletProvider, // typed as IEvmWalletProvider — must match BSC src chain
-    });
-    if (!result.ok) {
-      console.error('swap failed:', result.error);
-      return;
-    }
-    console.log('swap submitted:', result.value);
-  };
-
-  return (
-    <button onClick={handleSwap} disabled={!walletProvider || !account.address}>
-      Swap
-    </button>
-  );
-}
-```
-
-The pattern works for every SDK feature service:
-
-```typescript
-sodax.swaps.swap({ params, walletProvider });
-sodax.bridge.bridge({ params, walletProvider });
-sodax.moneyMarket.supply({ params, walletProvider });
-sodax.staking.stake({ params, walletProvider });
-sodax.dex.deposit({ params, walletProvider });
-```
-
-See [`packages/sdk/docs/`](https://github.com/icon-project/sodax-sdks/blob/main/packages/sdk/docs/) for per-feature method signatures.
-
-## TypeScript narrowing
-
-```typescript
-import { useWalletProvider } from '@sodax/wallet-sdk-react';
-import { ChainKeys } from '@sodax/types';
-
-// By chain id — narrowest typing
-const evm = useWalletProvider({ xChainId: ChainKeys.BSC_MAINNET });
-// evm: IEvmWalletProvider | undefined
-
-const sol = useWalletProvider({ xChainId: ChainKeys.SOLANA_MAINNET });
-// sol: ISolanaWalletProvider | undefined
-
-// By chain type — family-level (one wagmi connection covers all EVM chains)
-const evmFamily = useWalletProvider({ xChainType: 'EVM' });
-// evmFamily: IEvmWalletProvider | undefined
-```
-
-The chain-narrowing is automatic — passing the wrong wallet provider type to an SDK call (e.g. `ISolanaWalletProvider` to a `srcChainKey: BSC_MAINNET` swap) is a **compile error**.
-
-## EVM — single connection across all networks
-
-`useWalletProvider({ xChainId: ChainKeys.BSC_MAINNET })` and `useWalletProvider({ xChainId: ChainKeys.ARBITRUM_MAINNET })` return the **same** `EvmWalletProvider` instance — wagmi maintains one connection across all configured EVM networks. To switch the **active** EVM network, see [`useEvmSwitchChain`](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/EVM_SWITCH_CHAIN.md):
-
-```tsx
-import { useEvmSwitchChain } from '@sodax/wallet-sdk-react';
-
-const { isWrongChain, handleSwitchChain } = useEvmSwitchChain({
-  xChainId: ChainKeys.BSC_MAINNET,
-});
-
-if (isWrongChain) {
-  return <button onClick={handleSwitchChain}>Switch to BSC</button>;
-}
-```
-
-## Disabled chains return `undefined`
-
-If `xChainType` resolves to a chain not enabled in `SodaxWalletProvider` config, `useWalletProvider` returns `undefined` and logs a one-time warning:
-
-```
-[useWalletProvider] chain "BITCOIN" is not enabled in SodaxWalletProvider config.chains — returning undefined
-```
-
-Always null-check before passing to an SDK call.
-
-## Raw transactions — skip the bridge
-
-If you only need unsigned transaction data (manual relay, gas estimation, external signing), pass `raw: true` to the SDK and skip `walletProvider`:
-
-```typescript
-const result = await sodax.swaps.createIntent({
-  params,
-  raw: true, // walletProvider must be absent — compile error if passed
-});
-// result.value.tx is an EvmRawTransaction
-```
-
-See [`packages/sdk/docs/SWAPS.md`](https://github.com/icon-project/sodax-sdks/blob/main/packages/sdk/docs/SWAPS.md) for the full raw-vs-signed matrix per method.
-
-## Server / scripts — use `@sodax/wallet-sdk-core` directly
-
-For Node.js scripts / bots, skip wallet-sdk-react entirely:
-
-```typescript
-import { Sodax } from '@sodax/sdk';
-import { EvmWalletProvider } from '@sodax/wallet-sdk-core';
-import { ChainKeys } from '@sodax/types';
-
-const sodax = new Sodax();
-const walletProvider = new EvmWalletProvider({
-  privateKey: process.env.PRIVATE_KEY!,
-  chainId: ChainKeys.BSC_MAINNET,
-  rpcUrl: 'https://bsc-dataseed.binance.org',
-});
-const result = await sodax.swaps.swap({ params, walletProvider });
-```
-
-## Reference docs
-
-- [Wallet Provider Bridge](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/WALLET_PROVIDER_BRIDGE.md) — `useWalletProvider` + `useXService` reference
-- [SDK Wallet Providers Reference](https://github.com/icon-project/sodax-sdks/blob/main/packages/sdk/docs/WALLET_PROVIDERS.md) — per-chain `IXxxWalletProvider` interfaces
-- [SDK Swaps](https://github.com/icon-project/sodax-sdks/blob/main/packages/sdk/docs/SWAPS.md) — example consumer of a wallet provider
-- [EVM Switch Chain](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/EVM_SWITCH_CHAIN.md) — switch active EVM network
-- [`packages/dapp-kit`](https://github.com/icon-project/sodax-sdks/blob/main/packages/dapp-kit/README.md) — higher-level React hooks that wrap SDK calls + `useWalletProvider`

package/skills/connect-button.md

@@ -1,116 +0,0 @@
-# Skill: Connect Button
-
-Single-chain connect/disconnect button — pick a connector, connect, read the account, disconnect.
-
-**Depends on:** [setup.md](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/skills/setup.md)
-
-## Hooks
-
-| Hook | Purpose |
-|------|---------|
-| `useXConnectors({ xChainType })` | List available connectors for the chain family |
-| `useXConnect()` | React Query mutation — `mutate(connector)` |
-| `useXAccount({ xChainType })` | Read connected account (always returns object — `address` is `undefined` when disconnected) |
-| `useXDisconnect()` | Returns `(args) => Promise<void>` |
-| `sortConnectors(list, { preferred })` | Optional — rank installed/preferred wallets first |
-
-## Connect button
-
-```tsx
-import {
-  useXConnectors,
-  useXConnect,
-  useXAccount,
-  useXDisconnect,
-  sortConnectors,
-  type IXConnector,
-} from '@sodax/wallet-sdk-react';
-
-const PREFERRED = ['hana', 'metamask'] as const;
-
-export function EvmConnectButton() {
-  const raw = useXConnectors({ xChainType: 'EVM' });
-  const connectors = sortConnectors(raw, { preferred: PREFERRED });
-  const { mutateAsync: connect, isPending, error } = useXConnect();
-  const account = useXAccount({ xChainType: 'EVM' });
-  const disconnect = useXDisconnect();
-
-  if (account.address) {
-    return (
-      <div>
-        <code>{account.address}</code>
-        <button onClick={() => disconnect({ xChainType: 'EVM' })}>Disconnect</button>
-      </div>
-    );
-  }
-
-  return (
-    <div>
-      {connectors.map((connector) => (
-        <button
-          key={connector.id}
-          onClick={() => connect(connector).catch(() => {})}
-          disabled={isPending}
-        >
-          {connector.icon && <img src={connector.icon} alt="" width={20} height={20} />}
-          {connector.name}
-          {!connector.isInstalled && ' (not installed)'}
-        </button>
-      ))}
-      {error && <p style={{ color: 'red' }}>{error.message}</p>}
-    </div>
-  );
-}
-```
-
-## Install CTA for missing wallets
-
-```tsx
-{connectors.map((connector) =>
-  connector.isInstalled ? (
-    <button key={connector.id} onClick={() => connect(connector)}>
-      {connector.name}
-    </button>
-  ) : (
-    <a key={connector.id} href={connector.installUrl} target="_blank" rel="noreferrer">
-      Install {connector.name}
-    </a>
-  ),
-)}
-```
-
-`isInstalled` reads `window.*` at render time (no extra subscription). For batch install detection across wallet brands, use [`useIsWalletInstalled`](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/CHAIN_DETECTION.md#useiswalletinstalled--install-detection).
-
-## Caveat — provider-managed chains resolve with `undefined`
-
-For EVM, Solana, and Sui, `connect(connector)` resolves with `undefined` because connection state is set by the chain's Hydrator after the native SDK reports `connected`. Always read the account via `useXAccount`, not the mutation's return value:
-
-```typescript
-const { mutateAsync: connect } = useXConnect();
-const account = useXAccount({ xChainType: 'EVM' });
-
-await connect(connector); // resolves with undefined for EVM
-// account.address is populated on the next render
-```
-
-Non-provider chains (Bitcoin, ICON, Injective, Stellar, NEAR, Stacks) return the resolved `XAccount` from `connect()` — but reading via `useXAccount` works for both, so default to it.
-
-## Multiple chains, one button
-
-For a "connect EVM + Solana + Bitcoin in one click" pattern, use [`useBatchConnect`](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/BATCH_OPERATIONS.md):
-
-```tsx
-import { useBatchConnect } from '@sodax/wallet-sdk-react';
-
-const { run, status } = useBatchConnect({ connectors: ['hana'] });
-// Connects every chain Hana supports — sequential, errors collected.
-<button onClick={run} disabled={status === 'running'}>
-  Connect Hana on all chains
-</button>;
-```
-
-## Reference docs
-
-- [Connect Flow](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/CONNECT_FLOW.md) — full lifecycle reference + error handling
-- [Connectors](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/CONNECTORS.md) — `IXConnector` shape, deep imports for concrete classes
-- [Batch Operations](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/BATCH_OPERATIONS.md) — multi-chain connect by wallet identifier

package/skills/evm-only-walletconnect.md

@@ -1,111 +0,0 @@
-# Skill: EVM-only WalletConnect
-
-Enable WalletConnect protocol on the EVM slot for partners using enterprise custody (Fireblocks, Ledger Live, mobile-only wallets). Default EVM discovery (EIP-6963) only finds browser-extension wallets — WalletConnect lets users pair via QR/deep-link.
-
-**Depends on:** [setup.md](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/skills/setup.md)
-
-## When to use
-
-| Scenario | Need WalletConnect? |
-|----------|---------------------|
-| MetaMask / Hana / Rabby browser extension | ❌ — EIP-6963 covers them |
-| Fireblocks workspace | ✅ |
-| Ledger Live | ✅ |
-| MetaMask Mobile / Trust / Rainbow (paired via QR) | ✅ |
-| Coinbase Smart Wallet | ✅ (fallback path) |
-
-If your dApp only targets desktop browser-extension wallets, omit `walletConnect` entirely.
-
-## 1. Get a WalletConnect Cloud project id
-
-Sign up at [https://cloud.walletconnect.com](https://cloud.walletconnect.com) and copy your project id. Add it to `.env`:
-
-```bash
-NEXT_PUBLIC_WC_PROJECT_ID=your-project-id
-```
-
-## 2. Add `walletConnect` to the `EVM` slot
-
-```typescript
-import { type SodaxWalletConfig } from '@sodax/wallet-sdk-react';
-import { ChainKeys } from '@sodax/types';
-
-const walletConfig: SodaxWalletConfig = {
-  EVM: {
-    ssr: true,
-    chains: {
-      [ChainKeys.SONIC_MAINNET]: { rpcUrl: 'https://rpc.soniclabs.com' },
-      [ChainKeys.ARBITRUM_MAINNET]: { rpcUrl: 'https://arb1.arbitrum.io/rpc' },
-    },
-    walletConnect: {
-      projectId: process.env.NEXT_PUBLIC_WC_PROJECT_ID!,
-      // showQrModal: true is the default — wagmi/WalletConnect own the QR display
-    },
-  },
-};
-```
-
-A WalletConnect connector now surfaces alongside EIP-6963 wallets. `useXConnectors({ xChainType: 'EVM' })` returns it with `id === 'walletConnect'`. **No UI changes required** — the existing connect-button or modal already handles it.
-
-## 3. Restrict the QR modal — Fireblocks-only
-
-To show **only** Fireblocks (no Trust / Rainbow / etc. clutter), filter the WalletConnect Explorer list:
-
-```typescript
-const walletConfig: SodaxWalletConfig = {
-  EVM: {
-    walletConnect: {
-      projectId: process.env.NEXT_PUBLIC_WC_PROJECT_ID!,
-      qrModalOptions: {
-        explorerRecommendedWalletIds: [
-          '225affb176778569276e484e1b92637ad061b01e13a048b35a9d280c3b58970f', // Fireblocks
-        ],
-        explorerExcludedWalletIds: 'ALL', // hide everything except recommended
-      },
-    },
-  },
-};
-```
-
-Find wallet IDs at the [WalletConnect Explorer](https://walletconnect.com/explorer) — they're the long hex strings in URLs, not the human names.
-
-## 4. Hide the Sodax modal during WalletConnect QR
-
-When the user picks the WalletConnect connector, wagmi opens its own QR modal — two dialogs would stack. Detect WC by connector id and render `null`:
-
-```typescript
-import { useWalletModal } from '@sodax/wallet-sdk-react';
-
-const modal = useWalletModal();
-
-if (
-  modal.state.kind === 'connecting' &&
-  modal.state.connector.id === 'walletConnect'
-) {
-  return null; // wagmi's QR modal owns the screen
-}
-```
-
-The `useWalletModal` state machine handles the `connecting → success | error` transition normally — only the rendering is conditionally blanked.
-
-## Missing `projectId` — silent skip
-
-Setting `walletConnect: {}` without a `projectId` (or with an empty string) **silently skips** the WalletConnect connector and logs a warning:
-
-```
-[wallet-sdk-react] walletConnect.projectId is required — WalletConnect connector skipped.
-```
-
-EIP-6963 wallets continue to work normally — the dApp degrades gracefully. This intentionally avoids forcing local-dev environments to plumb the env var.
-
-## EVM-only
-
-The `walletConnect` field only exists on the `EVM` slot. Solana, Bitcoin, etc. use their own native wallet adapters and don't share the WalletConnect protocol layer. Don't attempt `SOLANA: { walletConnect: ... }` — TypeScript will reject it.
-
-## Reference docs
-
-- [WalletConnect](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/WALLETCONNECT.md) — full integration reference
-- [Configure SodaxWalletProvider](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/CONFIGURE_PROVIDER.md#walletconnect-evm-only) — per-chain config
-- [Wallet Modal QR caveat](https://github.com/icon-project/sodax-sdks/blob/main/packages/wallet-sdk-react/docs/WALLET_MODAL.md#walletconnect-qr-modal-caveat) — modal stacking handling
-- [wagmi `WalletConnectParameters`](https://wagmi.sh/core/api/connectors/walletConnect) — full options reference
-- [WalletConnect Cloud](https://cloud.walletconnect.com) — get a `projectId`