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

package/README.md

@@ -117,14 +117,21 @@ The full guide lives in [`docs/`](docs/). Start with the topic that matches what
 
 ## AI agent docs
 
-This package ships with AI-consumable integration & migration docs at `node_modules/@sodax/wallet-sdk-react/ai-exported/`. Point your AI coding agent at [`ai-exported/AGENTS.md`](ai-exported/AGENTS.md) to start — it routes to integration recipes (new consumers), migration recipes (v1 → v2), and reference tables.
+AI-readable docs for `@sodax/wallet-sdk-react` (and the other `@sodax/*` packages) are shipped via [`@sodax/skills`](https://github.com/icon-project/sodax-sdks/tree/main/packages/skills) — a separate npm package bundling Claude-Code SKILL.md files and a long-form knowledge tree.
 
+**Recommended: [`skills` CLI](https://github.com/vercel-labs/skills)** — from your project root:
+
+```bash
+npx skills@latest add icon-project/sodax-sdks/packages/skills
 ```
-> Read node_modules/@sodax/wallet-sdk-react/ai-exported/AGENTS.md and integrate
-> SODAX wallet connectivity into my Next.js app.
+
+**npm + `AGENTS.md` pointer** (fallback for web chats, or when you prefer a devDependency over the CLI):
+
+```bash
+pnpm add -D @sodax/skills
 ```
 
-The CI guard `scripts/check-ai-exported.sh` validates that every hook reference and sub-path in those docs resolves to a real export.
+Then point your agent at `node_modules/@sodax/skills/AGENTS.md`. See [docs/ai-integration-guide.md](https://github.com/icon-project/sodax-sdks/blob/main/docs/ai-integration-guide.md) for all install modes and per-tool wiring.
 
 ---
 
@@ -147,7 +154,7 @@ See [Connectors](docs/CONNECTORS.md) for the full list of deep-import sub-paths.
 
 ## Requirements
 
-- Node.js >= 18.0.0
+- Node.js >= 20.12.0
 - React >= 19
 - TypeScript
 

package/dist/{chunk-BKJB527E.mjs → chunk-3QETHO6P.mjs}

@@ -1,4 +1,4 @@
-import { XService, XConnector } from './chunk-X2MHIWXO.mjs';
+import { XService, XConnector } from './chunk-IFXZQW4C.mjs';
 import { getNetworkEndpoints, Network } from '@injectivelabs/networks';
 import { IndexerGrpcAccountPortfolioApi, ChainGrpcWasmApi, getInjectiveAddress } from '@injectivelabs/sdk-ts';
 import { ChainId } from '@injectivelabs/ts-types';
@@ -121,5 +121,3 @@ var InjectiveXConnector = class extends XConnector {
 };
 
 export { InjectiveXConnector, InjectiveXService };
-//# sourceMappingURL=chunk-BKJB527E.mjs.map
-//# sourceMappingURL=chunk-BKJB527E.mjs.map

package/dist/{chunk-PJLEJVAU.mjs → chunk-42LTUHMZ.mjs}

@@ -1,4 +1,4 @@
-import { XService, XConnector } from './chunk-X2MHIWXO.mjs';
+import { XService, XConnector } from './chunk-IFXZQW4C.mjs';
 import { fetchCallReadOnlyFunction, Cl } from '@stacks/transactions';
 import { networkFrom } from '@stacks/network';
 import { request, disconnect } from '@stacks/connect';
@@ -136,5 +136,3 @@ function useStacksXConnectors() {
 }
 
 export { STACKS_PROVIDERS, StacksXConnector, StacksXService, useStacksXConnectors };
-//# sourceMappingURL=chunk-PJLEJVAU.mjs.map
-//# sourceMappingURL=chunk-PJLEJVAU.mjs.map

package/dist/{chunk-NY7U7OJW.mjs → chunk-7V7O3Q7Y.mjs}

@@ -60,5 +60,3 @@ var getWagmiChainId = (xChainId) => {
 };
 
 export { getEntryDefaults, getRpcUrl, getWagmiChainId, isNativeToken, resolveEvmDefaults, sortConnectors };
-//# sourceMappingURL=chunk-NY7U7OJW.mjs.map
-//# sourceMappingURL=chunk-NY7U7OJW.mjs.map

package/dist/{chunk-BXJLBR4G.mjs → chunk-C6M34IVL.mjs}

@@ -1,5 +1,5 @@
-import { NEAR_DEFAULT_RPC_URL } from './chunk-MXZVF5HR.mjs';
-import { XService, XConnector } from './chunk-X2MHIWXO.mjs';
+import { NEAR_DEFAULT_RPC_URL } from './chunk-NAKCAL2M.mjs';
+import { XService, XConnector } from './chunk-IFXZQW4C.mjs';
 import { NearConnector } from '@hot-labs/near-connect';
 import { JsonRpcProvider } from 'near-api-js';
 
@@ -84,5 +84,3 @@ var NearXConnector = class extends XConnector {
 };
 
 export { NearXConnector, NearXService };
-//# sourceMappingURL=chunk-BXJLBR4G.mjs.map
-//# sourceMappingURL=chunk-BXJLBR4G.mjs.map

package/dist/{chunk-XZ7CHO2S.mjs → chunk-FSOGMSJH.mjs}

@@ -1,5 +1,5 @@
-import { isNativeToken } from './chunk-NY7U7OJW.mjs';
-import { XService } from './chunk-X2MHIWXO.mjs';
+import { isNativeToken } from './chunk-7V7O3Q7Y.mjs';
+import { XService } from './chunk-IFXZQW4C.mjs';
 import { PublicKey } from '@solana/web3.js';
 import { getAssociatedTokenAddressSync, getAccount } from '@solana/spl-token';
 
@@ -37,5 +37,3 @@ var SolanaXService = class _SolanaXService extends XService {
 };
 
 export { SolanaXService };
-//# sourceMappingURL=chunk-XZ7CHO2S.mjs.map
-//# sourceMappingURL=chunk-XZ7CHO2S.mjs.map

package/dist/{chunk-X2MHIWXO.mjs → chunk-IFXZQW4C.mjs}

@@ -96,5 +96,3 @@ var XConnector = class {
 };
 
 export { XConnector, XService };
-//# sourceMappingURL=chunk-X2MHIWXO.mjs.map
-//# sourceMappingURL=chunk-X2MHIWXO.mjs.map

package/dist/{chunk-7ULB6DW4.mjs → chunk-JQ4H4GJ5.mjs}

@@ -1,6 +1,6 @@
-import { assertSuiProviderShape, assert, isRecord, hasStringProperty, hasOptionalStringProperty } from './chunk-MAQ47Q52.mjs';
-import { isNativeToken } from './chunk-NY7U7OJW.mjs';
-import { XService, XConnector } from './chunk-X2MHIWXO.mjs';
+import { assertSuiProviderShape, assert, isRecord, hasStringProperty, hasOptionalStringProperty } from './chunk-TACW7Z4D.mjs';
+import { isNativeToken } from './chunk-7V7O3Q7Y.mjs';
+import { XService, XConnector } from './chunk-IFXZQW4C.mjs';
 import { SuiWalletProvider } from '@sodax/wallet-sdk-core';
 
 var SuiXService = class _SuiXService extends XService {
@@ -98,5 +98,3 @@ var SuiXConnector = class extends XConnector {
 };
 
 export { SuiXConnector, SuiXService };
-//# sourceMappingURL=chunk-7ULB6DW4.mjs.map
-//# sourceMappingURL=chunk-7ULB6DW4.mjs.map

package/dist/{chunk-N5A2TMF6.mjs → chunk-LKSSME2J.mjs}

@@ -1,5 +1,5 @@
-import { SolanaXService } from './chunk-XZ7CHO2S.mjs';
-import { XConnector } from './chunk-X2MHIWXO.mjs';
+import { SolanaXService } from './chunk-FSOGMSJH.mjs';
+import { XConnector } from './chunk-IFXZQW4C.mjs';
 
 // src/xchains/solana/SolanaXConnector.ts
 var SolanaXConnector = class extends XConnector {
@@ -29,5 +29,3 @@ var SolanaXConnector = class extends XConnector {
 };
 
 export { SolanaXConnector };
-//# sourceMappingURL=chunk-N5A2TMF6.mjs.map
-//# sourceMappingURL=chunk-N5A2TMF6.mjs.map

package/dist/{chunk-PLCA4ZDJ.mjs → chunk-LUKR7YKV.mjs}

@@ -1,15 +1,15 @@
-import { StellarWalletsKitXConnector, StellarXService } from './chunk-66BAUK56.mjs';
-import { SuiXService } from './chunk-7ULB6DW4.mjs';
-import { EvmXService } from './chunk-E5IAZ7E6.mjs';
-import { IconHanaXConnector, IconXService, CHAIN_INFO } from './chunk-2BOUGCJ7.mjs';
-import { assert, isRecord, hasFunctionProperty } from './chunk-MAQ47Q52.mjs';
-import { InjectiveXConnector, InjectiveXService } from './chunk-BKJB527E.mjs';
-import { NearXService, NearXConnector } from './chunk-BXJLBR4G.mjs';
-import { BITCOIN_DEFAULT_RPC_URL, WALLET_METADATA } from './chunk-MXZVF5HR.mjs';
-import { SolanaXService } from './chunk-XZ7CHO2S.mjs';
-import { isNativeToken, getEntryDefaults, getRpcUrl } from './chunk-NY7U7OJW.mjs';
-import { STACKS_PROVIDERS, StacksXService, StacksXConnector } from './chunk-PJLEJVAU.mjs';
-import { XConnector, XService } from './chunk-X2MHIWXO.mjs';
+import { StellarWalletsKitXConnector, StellarXService } from './chunk-X7BHR7WS.mjs';
+import { SuiXService } from './chunk-JQ4H4GJ5.mjs';
+import { EvmXService } from './chunk-Z5GXDHGL.mjs';
+import { InjectiveXConnector, InjectiveXService } from './chunk-3QETHO6P.mjs';
+import { IconHanaXConnector, IconXService, CHAIN_INFO } from './chunk-WPZOLGVB.mjs';
+import { assert, isRecord, hasFunctionProperty } from './chunk-TACW7Z4D.mjs';
+import { NearXService, NearXConnector } from './chunk-C6M34IVL.mjs';
+import { BITCOIN_DEFAULT_RPC_URL, WALLET_METADATA } from './chunk-NAKCAL2M.mjs';
+import { SolanaXService } from './chunk-FSOGMSJH.mjs';
+import { isNativeToken, getEntryDefaults, getRpcUrl } from './chunk-7V7O3Q7Y.mjs';
+import { STACKS_PROVIDERS, StacksXService, StacksXConnector } from './chunk-42LTUHMZ.mjs';
+import { XConnector, XService } from './chunk-IFXZQW4C.mjs';
 import { ChainTypeArr, baseChainInfo, ChainKeys, detectBitcoinAddressType, CHAIN_KEYS } from '@sodax/types';
 import { AddressPurpose, MessageSigningProtocols } from 'sats-connect';
 import { createContext, useMemo, useSyncExternalStore, useCallback, useState, useRef, useContext, useEffect } from 'react';
@@ -803,9 +803,20 @@ var useXWalletStore = create()(
         }
       })),
       {
-        // key kept as 'xwagmi-store' for backward compat — existing users won't lose persisted connections on upgrade
+        // key kept as 'xwagmi-store' for backward compat, existing users won't lose persisted connections on upgrade
         name: "xwagmi-store",
-        storage: createJSONStorage(() => localStorage),
+        // Throw on SSR or when localStorage rejects writes (Safari strict
+        // private mode, disabled storage). `createJSONStorage` catches the
+        // throw, zustand short-circuits `.persist`, and downstream falls back
+        // via `usePersistHydrated`. `setItem` probe is required because modern
+        // Safari only throws on writes, not reads.
+        storage: createJSONStorage(() => {
+          if (typeof window === "undefined") throw new Error("no window");
+          const probe = "__sodax_probe__";
+          window.localStorage.setItem(probe, "1");
+          window.localStorage.removeItem(probe);
+          return window.localStorage;
+        }),
         partialize: (state) => ({
           xConnections: state.xConnections,
           userDisconnected: state.userDisconnected
@@ -988,6 +999,33 @@ function useChainGroups({ order } = {}) {
     [enabledChains, xConnections, order]
   );
 }
+var NOOP = () => {
+};
+function subscribe(onChange) {
+  const api = useXWalletStore.persist;
+  if (!api) return NOOP;
+  const unsubHydrate = api.onHydrate(onChange);
+  const unsubFinish = api.onFinishHydration(onChange);
+  return () => {
+    unsubHydrate();
+    unsubFinish();
+  };
+}
+var getSnapshot = () => useXWalletStore.persist?.hasHydrated() ?? true;
+var getServerSnapshot = () => false;
+function usePersistHydrated() {
+  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+function whenPersistReady(cb) {
+  const api = useXWalletStore.persist;
+  if (!api || api.hasHydrated()) {
+    cb();
+    return;
+  }
+  api.onFinishHydration(cb);
+}
+
+// src/hooks/useConnectedChains.ts
 function buildConnectedChains(xConnections, xConnectorsByChain, isReady = true, order) {
   const chains = [];
   for (const chainType of ChainTypeArr) {
@@ -1012,22 +1050,10 @@ function buildConnectedChains(xConnections, xConnectorsByChain, isReady = true,
     status: isReady ? "ready" : "loading"
   };
 }
-function subscribeHydration(onChange) {
-  const unsubHydrate = useXWalletStore.persist.onHydrate(onChange);
-  const unsubFinish = useXWalletStore.persist.onFinishHydration(onChange);
-  return () => {
-    unsubHydrate();
-    unsubFinish();
-  };
-}
 function useConnectedChains({ order } = {}) {
   const xConnections = useXConnections();
   const xConnectorsByChain = useXConnectorsByChain();
-  const isReady = useSyncExternalStore(
-    subscribeHydration,
-    () => useXWalletStore.persist.hasHydrated(),
-    () => false
-  );
+  const isReady = usePersistHydrated();
   return useMemo(
     () => buildConnectedChains(xConnections, xConnectorsByChain, isReady, order),
     [xConnections, xConnectorsByChain, isReady, order]
@@ -1580,6 +1606,4 @@ function useBitcoinXConnectors() {
   }, [xService]);
 }
 
-export { BitcoinXConnector, BitcoinXService, OKXXConnector, UnisatXConnector, WalletConfigProvider, XverseXConnector, chainRegistry, getXChainType, getXService, useBatchConnect, useBatchDisconnect, useBitcoinXConnectors, useChainGroups, useConnectedChains, useConnectionFlow, useEnabledChainTypes, useEnabledChains, useEvmSwitchChain, useIsChainEnabled, useIsWalletInstalled, useWalletConfig, useWalletModal, useWalletProvider, useXAccount, useXAccounts, useXConnect, useXConnection, useXConnections, useXConnectors, useXConnectorsByChain, useXDisconnect, useXService, useXServices, useXSignMessage, useXWalletStore };
-//# sourceMappingURL=chunk-PLCA4ZDJ.mjs.map
-//# sourceMappingURL=chunk-PLCA4ZDJ.mjs.map
+export { BitcoinXConnector, BitcoinXService, OKXXConnector, UnisatXConnector, WalletConfigProvider, XverseXConnector, chainRegistry, getXChainType, getXService, useBatchConnect, useBatchDisconnect, useBitcoinXConnectors, useChainGroups, useConnectedChains, useConnectionFlow, useEnabledChainTypes, useEnabledChains, useEvmSwitchChain, useIsChainEnabled, useIsWalletInstalled, usePersistHydrated, useWalletConfig, useWalletModal, useWalletProvider, useXAccount, useXAccounts, useXConnect, useXConnection, useXConnections, useXConnectors, useXConnectorsByChain, useXDisconnect, useXService, useXServices, useXSignMessage, useXWalletStore, whenPersistReady };

package/dist/{chunk-MXZVF5HR.mjs → chunk-NAKCAL2M.mjs}

@@ -30,5 +30,3 @@ var WALLET_METADATA = {
 };
 
 export { BITCOIN_DEFAULT_RPC_URL, EVM_DEFAULT_RECONNECT_ON_MOUNT, EVM_DEFAULT_SSR, NEAR_DEFAULT_RPC_URL, SOLANA_DEFAULT_AUTO_CONNECT, SOLANA_DEFAULT_RPC_URL, SOLANA_METAMASK_CONNECT_TIMEOUT_MS, STELLAR_DEFAULT_HORIZON_RPC_URL, STELLAR_DEFAULT_SOROBAN_RPC_URL, SUI_DEFAULT_AUTO_CONNECT, SUI_DEFAULT_NETWORK, WALLET_METADATA };
-//# sourceMappingURL=chunk-MXZVF5HR.mjs.map
-//# sourceMappingURL=chunk-MXZVF5HR.mjs.map

package/dist/chunk-QMXBY3UI.mjs

@@ -0,0 +1 @@
+

package/dist/{chunk-MAQ47Q52.mjs → chunk-TACW7Z4D.mjs}

@@ -29,5 +29,3 @@ function assertSuiProviderShape(caller, client, wallet, account) {
 }
 
 export { assert, assertSuiProviderShape, hasBooleanProperty, hasFunctionProperty, hasOptionalStringProperty, hasStringProperty, isRecord };
-//# sourceMappingURL=chunk-MAQ47Q52.mjs.map
-//# sourceMappingURL=chunk-MAQ47Q52.mjs.map

package/dist/{chunk-2BOUGCJ7.mjs → chunk-WPZOLGVB.mjs}

@@ -1,7 +1,7 @@
-import { assert, isRecord, hasBooleanProperty } from './chunk-MAQ47Q52.mjs';
-import { WALLET_METADATA } from './chunk-MXZVF5HR.mjs';
-import { isNativeToken } from './chunk-NY7U7OJW.mjs';
-import { XService, XConnector } from './chunk-X2MHIWXO.mjs';
+import { assert, isRecord, hasBooleanProperty } from './chunk-TACW7Z4D.mjs';
+import { WALLET_METADATA } from './chunk-NAKCAL2M.mjs';
+import { isNativeToken } from './chunk-7V7O3Q7Y.mjs';
+import { XService, XConnector } from './chunk-IFXZQW4C.mjs';
 import * as IconSdkRaw from 'icon-sdk-js';
 
 var IconSdk = "default" in IconSdkRaw.default ? IconSdkRaw.default : IconSdkRaw;
@@ -146,5 +146,3 @@ var IconHanaXConnector = class extends XConnector {
 };
 
 export { CHAIN_INFO, IconHanaXConnector, IconXService, SupportedChainId, request };
-//# sourceMappingURL=chunk-2BOUGCJ7.mjs.map
-//# sourceMappingURL=chunk-2BOUGCJ7.mjs.map

package/dist/{chunk-66BAUK56.mjs → chunk-X7BHR7WS.mjs}

@@ -1,5 +1,5 @@
-import { STELLAR_DEFAULT_HORIZON_RPC_URL, STELLAR_DEFAULT_SOROBAN_RPC_URL } from './chunk-MXZVF5HR.mjs';
-import { XService, XConnector } from './chunk-X2MHIWXO.mjs';
+import { STELLAR_DEFAULT_HORIZON_RPC_URL, STELLAR_DEFAULT_SOROBAN_RPC_URL } from './chunk-NAKCAL2M.mjs';
+import { XService, XConnector } from './chunk-IFXZQW4C.mjs';
 import { StellarWalletsKit, allowAllModules, WalletNetwork } from '@creit.tech/stellar-wallets-kit';
 import * as StellarSdk from '@stellar/stellar-sdk';
 import { rpc, Address, Contract, TimeoutInfinite, scValToBigInt } from '@stellar/stellar-sdk';
@@ -198,5 +198,3 @@ var StellarWalletsKitXConnector = class extends XConnector {
 };
 
 export { StellarWalletsKitXConnector, StellarXService };
-//# sourceMappingURL=chunk-66BAUK56.mjs.map
-//# sourceMappingURL=chunk-66BAUK56.mjs.map

package/dist/{chunk-E5IAZ7E6.mjs → chunk-Z5GXDHGL.mjs}

@@ -1,5 +1,5 @@
-import { getRpcUrl, getWagmiChainId, isNativeToken } from './chunk-NY7U7OJW.mjs';
-import { XService, XConnector } from './chunk-X2MHIWXO.mjs';
+import { getRpcUrl, getWagmiChainId, isNativeToken } from './chunk-7V7O3Q7Y.mjs';
+import { XService, XConnector } from './chunk-IFXZQW4C.mjs';
 import { ChainKeys } from '@sodax/types';
 import { defineChain, erc20Abi } from 'viem';
 import { getPublicClient } from 'wagmi/actions';
@@ -47,7 +47,13 @@ var createWagmiConfig = (evmChains, options) => {
       redbellyMainnet
     ],
     connectors: options?.connectors ?? [],
-    ssr: options?.ssr,
+    // NOTE: wagmi's `ssr` is a hydration-timing flag, not an "is host app SSR"
+    // flag. `true` defers `Hydrate.onMount()` into `useEffect` (safe for both
+    // CSR and SSR); `false` runs it in render and trips React's "setState
+    // during render" warning on subscribers like `EvmHydrator`. Default to
+    // `true` so direct callers of `createWagmiConfig` stay safe — only pass
+    // `false` if you have a specific reason. See issue #129.
+    ssr: options?.ssr ?? true,
     transports: {
       [mainnet.id]: http(getRpcUrl(evmChains?.[ChainKeys.ETHEREUM_MAINNET])),
       [avalanche.id]: http(getRpcUrl(evmChains?.[ChainKeys.AVALANCHE_MAINNET])),
@@ -182,5 +188,3 @@ var EvmXConnector = class extends XConnector {
 };
 
 export { EvmXConnector, EvmXService, createWagmiConfig };
-//# sourceMappingURL=chunk-E5IAZ7E6.mjs.map
-//# sourceMappingURL=chunk-E5IAZ7E6.mjs.map

package/dist/{config-OlnzyEUE.d.ts → config-GVKK8IfY.d.ts}

@@ -29,7 +29,12 @@ type StacksChainEntry = StacksNetworkName | (StacksNetworkLike & {
 type EvmAdapterFields = {
     /** Attempt to reconnect previously connected wallets on mount. @default false */
     reconnectOnMount?: boolean;
-    /** Enable SSR-safe hydration for Next.js. @default true */
+    /**
+     * wagmi hydration-timing flag (not an "app is SSR" flag).
+     * `true` defers wagmi reconnect into `useEffect`; `false` runs it in render
+     * and triggers React's "setState during render" warning. Keep `true` unless
+     * you know you need otherwise. @default true
+     */
     ssr?: boolean;
     /** Wagmi SSR hydration state — pass `cookieToInitialState()` to avoid disconnect flash on first load (Next.js only). */
     initialState?: State;

package/dist/index.d.ts

@@ -4,8 +4,8 @@ import { X as XAccount, I as IXConnector, a as XConnection, b as XService, c as
 export { d as IXService } from './XConnector-B9YQTVJ4.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { S as SodaxWalletConfig, C as ChainEntry, W as WalletDefaultsByKey, E as EvmChainEntry } from './config-OlnzyEUE.js';
-export { B as BitcoinChainEntry, o as BitcoinTypeConfig, i as ChainMeta, k as ChainTypeConfig, j as ChainTypeOf, f as EvmAdapterFields, l as EvmTypeConfig, I as IconChainEntry, r as IconTypeConfig, d as InjectiveChainEntry, q as InjectiveTypeConfig, N as NearChainEntry, s as NearTypeConfig, g as SolanaAdapterFields, a as SolanaChainEntry, m as SolanaTypeConfig, e as StacksChainEntry, t as StacksTypeConfig, c as StellarChainEntry, p as StellarTypeConfig, h as SuiAdapterFields, b as SuiChainEntry, n as SuiTypeConfig } from './config-OlnzyEUE.js';
+import { S as SodaxWalletConfig, C as ChainEntry, W as WalletDefaultsByKey, E as EvmChainEntry } from './config-GVKK8IfY.js';
+export { B as BitcoinChainEntry, o as BitcoinTypeConfig, i as ChainMeta, k as ChainTypeConfig, j as ChainTypeOf, f as EvmAdapterFields, l as EvmTypeConfig, I as IconChainEntry, r as IconTypeConfig, d as InjectiveChainEntry, q as InjectiveTypeConfig, N as NearChainEntry, s as NearTypeConfig, g as SolanaAdapterFields, a as SolanaChainEntry, m as SolanaTypeConfig, e as StacksChainEntry, t as StacksTypeConfig, c as StellarChainEntry, p as StellarTypeConfig, h as SuiAdapterFields, b as SuiChainEntry, n as SuiTypeConfig } from './config-GVKK8IfY.js';
 import { UseMutationResult } from '@tanstack/react-query';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { EvmWalletDefaults } from '@sodax/wallet-sdk-core';
@@ -317,7 +317,7 @@ type UseConnectedChainsOptions = {
  * metadata (name + icon) looked up from the store. Useful for "Manage
  * connections" UIs and status badges.
  *
- * Gate rendering on `status === 'ready'` to avoid the "Connect wallet" →
+ * Gate rendering on `status === 'ready'` to avoid the "Connect wallet" to
  * "Connected" flicker on reload while the store rehydrates from localStorage.
  *
  * @example
@@ -326,7 +326,7 @@ type UseConnectedChainsOptions = {
  * return total >= 1 ? <ConnectedChainsDisplay chains={chains} /> : <ConnectCta />;
  *
  * @example
- * // Deterministic display order — required if rendering a list that must
+ * // Deterministic display order, required if rendering a list that must
  * // be stable across page reloads (hydrator race otherwise randomizes
  * // insertion order).
  * const { chains } = useConnectedChains({ order: ['EVM', 'ICON', 'SOLANA'] });

package/dist/index.mjs

@@ -1,21 +1,21 @@
-import { WalletConfigProvider, useXWalletStore, chainRegistry, useWalletConfig } from './chunk-PLCA4ZDJ.mjs';
-export { WalletConfigProvider, getXChainType, getXService, useBatchConnect, useBatchDisconnect, useChainGroups, useConnectedChains, useConnectionFlow, useEnabledChainTypes, useEnabledChains, useEvmSwitchChain, useIsChainEnabled, useIsWalletInstalled, useWalletConfig, useWalletModal, useWalletProvider, useXAccount, useXAccounts, useXConnect, useXConnection, useXConnections, useXConnectors, useXConnectorsByChain, useXDisconnect, useXService, useXServices, useXSignMessage } from './chunk-PLCA4ZDJ.mjs';
-import { StellarXService } from './chunk-66BAUK56.mjs';
-import { SuiXService, SuiXConnector } from './chunk-7ULB6DW4.mjs';
-import { createWagmiConfig, EvmXService, EvmXConnector } from './chunk-E5IAZ7E6.mjs';
-import { request } from './chunk-2BOUGCJ7.mjs';
-import { assertSuiProviderShape } from './chunk-MAQ47Q52.mjs';
-import { InjectiveXService } from './chunk-BKJB527E.mjs';
-import './chunk-BXJLBR4G.mjs';
-import { SOLANA_DEFAULT_AUTO_CONNECT, SOLANA_DEFAULT_RPC_URL, SUI_DEFAULT_AUTO_CONNECT, SUI_DEFAULT_NETWORK, EVM_DEFAULT_RECONNECT_ON_MOUNT, EVM_DEFAULT_SSR, SOLANA_METAMASK_CONNECT_TIMEOUT_MS } from './chunk-MXZVF5HR.mjs';
-import { SolanaXConnector } from './chunk-N5A2TMF6.mjs';
-import { SolanaXService } from './chunk-XZ7CHO2S.mjs';
-import { getEntryDefaults, resolveEvmDefaults } from './chunk-NY7U7OJW.mjs';
-export { getEntryDefaults, getRpcUrl, getWagmiChainId, isNativeToken, resolveEvmDefaults, sortConnectors } from './chunk-NY7U7OJW.mjs';
-import './chunk-PJLEJVAU.mjs';
-import './chunk-TZMKDXFA.mjs';
-export { XConnector, XService } from './chunk-X2MHIWXO.mjs';
-import { useRef, useEffect, useMemo, useState } from 'react';
+import { WalletConfigProvider, useXWalletStore, whenPersistReady, chainRegistry, useWalletConfig, usePersistHydrated } from './chunk-LUKR7YKV.mjs';
+export { WalletConfigProvider, getXChainType, getXService, useBatchConnect, useBatchDisconnect, useChainGroups, useConnectedChains, useConnectionFlow, useEnabledChainTypes, useEnabledChains, useEvmSwitchChain, useIsChainEnabled, useIsWalletInstalled, useWalletConfig, useWalletModal, useWalletProvider, useXAccount, useXAccounts, useXConnect, useXConnection, useXConnections, useXConnectors, useXConnectorsByChain, useXDisconnect, useXService, useXServices, useXSignMessage } from './chunk-LUKR7YKV.mjs';
+import { StellarXService } from './chunk-X7BHR7WS.mjs';
+import { SuiXService, SuiXConnector } from './chunk-JQ4H4GJ5.mjs';
+import { createWagmiConfig, EvmXService, EvmXConnector } from './chunk-Z5GXDHGL.mjs';
+import { InjectiveXService } from './chunk-3QETHO6P.mjs';
+import { request } from './chunk-WPZOLGVB.mjs';
+import { assertSuiProviderShape } from './chunk-TACW7Z4D.mjs';
+import './chunk-C6M34IVL.mjs';
+import { SOLANA_DEFAULT_AUTO_CONNECT, SOLANA_DEFAULT_RPC_URL, SUI_DEFAULT_AUTO_CONNECT, SUI_DEFAULT_NETWORK, EVM_DEFAULT_RECONNECT_ON_MOUNT, EVM_DEFAULT_SSR, SOLANA_METAMASK_CONNECT_TIMEOUT_MS } from './chunk-NAKCAL2M.mjs';
+import { SolanaXConnector } from './chunk-LKSSME2J.mjs';
+import { SolanaXService } from './chunk-FSOGMSJH.mjs';
+import { getEntryDefaults, resolveEvmDefaults } from './chunk-7V7O3Q7Y.mjs';
+export { getEntryDefaults, getRpcUrl, getWagmiChainId, isNativeToken, resolveEvmDefaults, sortConnectors } from './chunk-7V7O3Q7Y.mjs';
+import './chunk-42LTUHMZ.mjs';
+import './chunk-QMXBY3UI.mjs';
+export { XConnector, XService } from './chunk-IFXZQW4C.mjs';
+import { useRef, useEffect, useMemo } from 'react';
 import { WagmiProvider, useConfig, useConnectors, useAccount, usePublicClient, useWalletClient, useReconnect, useConnect, useDisconnect, useSignMessage } from 'wagmi';
 import { walletConnect } from 'wagmi/connectors';
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
@@ -50,12 +50,7 @@ var EvmHydrator = () => {
     EvmXService.getInstance().setXConnectors(evmConnectors);
     useXWalletStore.getState().setXConnectors("EVM", evmConnectors);
   }, [evmConnectors]);
-  const [hydrated, setHydrated] = useState(() => useXWalletStore.persist.hasHydrated());
-  useEffect(() => {
-    if (hydrated) return;
-    const unsub = useXWalletStore.persist.onFinishHydration(() => setHydrated(true));
-    return unsub;
-  }, [hydrated]);
+  const hydrated = usePersistHydrated();
   useEffect(() => {
     if (!hydrated) return;
     if (status !== "disconnected") return;
@@ -509,11 +504,7 @@ function useInitChainServices(walletConfig) {
         reconnectStellar().catch((error) => console.warn("[wallet-sdk-react] Stellar reconnect failed:", error));
       }
     };
-    if (useXWalletStore.persist.hasHydrated()) {
-      afterHydration();
-    } else {
-      useXWalletStore.persist.onFinishHydration(afterHydration);
-    }
+    whenPersistReady(afterHydration);
   }, []);
 }
 var SodaxWalletProvider = ({ children, config }) => {
@@ -534,5 +525,3 @@ var SodaxWalletProvider = ({ children, config }) => {
 };
 
 export { SodaxWalletProvider };
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map

package/dist/xchains/bitcoin/index.mjs

@@ -1,16 +1,14 @@
-export { BitcoinXConnector, BitcoinXService, OKXXConnector, UnisatXConnector, XverseXConnector, useBitcoinXConnectors } from '../../chunk-PLCA4ZDJ.mjs';
-import '../../chunk-66BAUK56.mjs';
-import '../../chunk-7ULB6DW4.mjs';
-import '../../chunk-E5IAZ7E6.mjs';
-import '../../chunk-2BOUGCJ7.mjs';
-import '../../chunk-MAQ47Q52.mjs';
-import '../../chunk-BKJB527E.mjs';
-import '../../chunk-BXJLBR4G.mjs';
-import '../../chunk-MXZVF5HR.mjs';
-import '../../chunk-XZ7CHO2S.mjs';
-import '../../chunk-NY7U7OJW.mjs';
-import '../../chunk-PJLEJVAU.mjs';
-import '../../chunk-TZMKDXFA.mjs';
-import '../../chunk-X2MHIWXO.mjs';
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map
+export { BitcoinXConnector, BitcoinXService, OKXXConnector, UnisatXConnector, XverseXConnector, useBitcoinXConnectors } from '../../chunk-LUKR7YKV.mjs';
+import '../../chunk-X7BHR7WS.mjs';
+import '../../chunk-JQ4H4GJ5.mjs';
+import '../../chunk-Z5GXDHGL.mjs';
+import '../../chunk-3QETHO6P.mjs';
+import '../../chunk-WPZOLGVB.mjs';
+import '../../chunk-TACW7Z4D.mjs';
+import '../../chunk-C6M34IVL.mjs';
+import '../../chunk-NAKCAL2M.mjs';
+import '../../chunk-FSOGMSJH.mjs';
+import '../../chunk-7V7O3Q7Y.mjs';
+import '../../chunk-42LTUHMZ.mjs';
+import '../../chunk-QMXBY3UI.mjs';
+import '../../chunk-IFXZQW4C.mjs';

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

@@ -1,6 +1,6 @@
 import { b as XService, c as XConnector, X as XAccount } from '../../XConnector-B9YQTVJ4.js';
 import { XToken } from '@sodax/types';
-import { l as EvmTypeConfig } from '../../config-OlnzyEUE.js';
+import { l as EvmTypeConfig } from '../../config-GVKK8IfY.js';
 import { Config, CreateConnectorFn, Connector } from 'wagmi';
 import '@sodax/wallet-sdk-core';
 import 'wagmi/connectors';

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.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.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-3QETHO6P.mjs';
+import '../../chunk-QMXBY3UI.mjs';
+import '../../chunk-IFXZQW4C.mjs';

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.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-LKSSME2J.mjs';
+export { SolanaXService } from '../../chunk-FSOGMSJH.mjs';
+import '../../chunk-7V7O3Q7Y.mjs';
+import '../../chunk-QMXBY3UI.mjs';
+import '../../chunk-IFXZQW4C.mjs';

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-42LTUHMZ.mjs';
+import '../../chunk-QMXBY3UI.mjs';
+import '../../chunk-IFXZQW4C.mjs';

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.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/docs/ADDING_A_NEW_CHAIN.md

@@ -419,7 +419,7 @@ Before opening a PR, walk through each item:
 
 - [ ] `pnpm checkTs` passes — `SodaxWalletConfig.APTOS` is recognized; `useWalletProvider({ xChainType: 'APTOS' })` returns the right type.
 - [ ] `pnpm test` passes for new files.
-- [ ] `pnpm build:packages` produces `dist/xchains/aptos/index.{mjs,cjs,d.ts}`.
+- [ ] `pnpm build:packages` produces `dist/xchains/aptos/index.{mjs,d.ts}`.
 - [ ] `import { AptosXService } from '@sodax/wallet-sdk-react/xchains/aptos'` resolves in a consumer app.
 - [ ] `import { AptosXService } from '@sodax/wallet-sdk-react'` is **not** available (intentional — concrete classes stay behind deep imports).
 - [ ] Adding `APTOS: {}` to `SodaxWalletConfig` mounts the chain; omitting the slot skips it.