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

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/{XConnector-B9YQTVJ4.d.ts → XConnector-12q0OVe5.d.ts}

@@ -143,4 +143,4 @@ declare abstract class XConnector implements IXConnector {
     get installUrl(): string | undefined;
 }
 
-export { type IXConnector as I, type XAccount as X, type XConnection as a, XService as b, XConnector as c, type IXService as d };
+export { type IXConnector as I, type XAccount as X, type IXService as a, type XConnection as b, XConnector as c, XService as d };

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-BKJB527E.mjs → chunk-MWWVB7TD.mjs}

@@ -1,10 +1,10 @@
-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';
 import { MsgBroadcaster } from '@injectivelabs/wallet-core';
 import { mainnet } from 'wagmi/chains';
-import { WalletStrategy } from '@injectivelabs/wallet-strategy';
+import { WalletStrategy } from '@sodax/libs/injective/wallet-strategy';
 import { isCosmosBrowserWallet, isEvmBrowserWallet } from '@injectivelabs/wallet-base';
 import { isCosmosWalletInstalled } from '@injectivelabs/wallet-cosmos';
 
@@ -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-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-PJLEJVAU.mjs → chunk-OPYSVPRW.mjs}

@@ -1,7 +1,6 @@
-import { XService, XConnector } from './chunk-X2MHIWXO.mjs';
-import { fetchCallReadOnlyFunction, Cl } from '@stacks/transactions';
-import { networkFrom } from '@stacks/network';
-import { request, disconnect } from '@stacks/connect';
+import { XService, XConnector } from './chunk-IFXZQW4C.mjs';
+import { networkFrom, fetchCallReadOnlyFunction, Cl } from '@sodax/libs/stacks/core';
+import { request, disconnect } from '@sodax/libs/stacks/connect';
 import { useMemo } from 'react';
 
 var StacksXService = class _StacksXService extends XService {
@@ -19,6 +18,12 @@ var StacksXService = class _StacksXService extends XService {
     }
     return _StacksXService.instance;
   }
+  /**
+   * @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.
+   */
   async getBalance(address, xToken) {
     if (!address) return 0n;
     if (xToken.symbol === "STX") {
@@ -55,6 +60,7 @@ var StacksXService = class _StacksXService extends XService {
   }
 };
 function getProviderFromId(id) {
+  if (typeof window === "undefined") return void 0;
   return id.split(".").reduce((acc, part) => acc?.[part], window);
 }
 var StacksXConnector = class extends XConnector {
@@ -136,5 +142,3 @@ function useStacksXConnectors() {
 }
 
 export { STACKS_PROVIDERS, StacksXConnector, StacksXService, useStacksXConnectors };
-//# sourceMappingURL=chunk-PJLEJVAU.mjs.map
-//# sourceMappingURL=chunk-PJLEJVAU.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-PLCA4ZDJ.mjs → chunk-VCESC6QT.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-MWWVB7TD.mjs';
+import { NearXConnector, NearXService } from './chunk-C6M34IVL.mjs';
+import { IconHanaXConnector, CHAIN_INFO, IconXService } from './chunk-WPZOLGVB.mjs';
+import { assert, isRecord, hasFunctionProperty } from './chunk-TACW7Z4D.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 { StacksXConnector, STACKS_PROVIDERS, StacksXService } from './chunk-OPYSVPRW.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-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,8 +1,8 @@
-import { STELLAR_DEFAULT_HORIZON_RPC_URL, STELLAR_DEFAULT_SOROBAN_RPC_URL } from './chunk-MXZVF5HR.mjs';
-import { XService, XConnector } from './chunk-X2MHIWXO.mjs';
-import { StellarWalletsKit, allowAllModules, WalletNetwork } from '@creit.tech/stellar-wallets-kit';
+import { STELLAR_DEFAULT_HORIZON_RPC_URL, STELLAR_DEFAULT_SOROBAN_RPC_URL } from './chunk-NAKCAL2M.mjs';
+import { XService, XConnector } from './chunk-IFXZQW4C.mjs';
+import { StellarWalletsKit, WalletNetwork, allowAllModules } from '@creit.tech/stellar-wallets-kit';
 import * as StellarSdk from '@stellar/stellar-sdk';
-import { rpc, Address, Contract, TimeoutInfinite, scValToBigInt } from '@stellar/stellar-sdk';
+import { rpc, Contract, TimeoutInfinite, scValToBigInt, Address } from '@stellar/stellar-sdk';
 
 var CustomSorobanServer = class extends rpc.Server {
   customHeaders;
@@ -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,9 +1,9 @@
-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 { erc20Abi, defineChain } from 'viem';
 import { getPublicClient } from 'wagmi/actions';
-import { createConfig, createStorage, http, cookieStorage } from 'wagmi';
+import { createConfig, createStorage, cookieStorage, http } from 'wagmi';
 import { mainnet, avalanche, arbitrum, base, bsc, sonic, optimism, polygon, lightlinkPhoenix, kaia, redbellyMainnet } from 'wagmi/chains';
 
 var hyper = /* @__PURE__ */ defineChain({
@@ -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-DEsqgrG1.d.ts}

@@ -1,8 +1,8 @@
-import { ChainType, EvmChainKey, SolanaChainKey, SuiChainKey, IconChainKey, NearChainKey, StellarChainKey, StellarRpcConfig, BitcoinChainKey, BitcoinRpcConfig, InjectiveChainKey, InjectiveRpcConfig, StacksChainKey, StacksNetworkName, StacksNetworkLike, ChainKey, baseChainInfo } from '@sodax/types';
-import { EvmWalletDefaults, SolanaWalletDefaults, SuiWalletDefaults, IconWalletDefaults, NearWalletDefaults, StellarWalletDefaults, BitcoinWalletDefaults, InjectiveWalletDefaults, StacksWalletDefaults } from '@sodax/wallet-sdk-core';
+import { BitcoinRpcConfig, ChainType, EvmChainKey, SolanaChainKey, SuiChainKey, IconChainKey, NearChainKey, StellarChainKey, StellarRpcConfig, BitcoinChainKey, InjectiveChainKey, InjectiveRpcConfig, StacksChainKey, StacksNetworkName, StacksNetworkLike, ChainKey, baseChainInfo } from '@sodax/types';
+import { BitcoinWalletDefaults, EvmWalletDefaults, SolanaWalletDefaults, SuiWalletDefaults, IconWalletDefaults, NearWalletDefaults, StellarWalletDefaults, InjectiveWalletDefaults, StacksWalletDefaults } from '@sodax/wallet-sdk-core';
 import { State } from 'wagmi';
 import { WalletConnectParameters } from 'wagmi/connectors';
-import { I as IXConnector } from './XConnector-B9YQTVJ4.js';
+import { I as IXConnector } from './XConnector-12q0OVe5.js';
 
 type SimpleChainEntry<D> = {
     rpcUrl?: string;
@@ -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;
@@ -143,4 +148,4 @@ type SodaxWalletConfig = {
     [T in ChainType]?: ChainTypeConfig<T>;
 };
 
-export type { BitcoinChainEntry as B, ChainEntry as C, EvmChainEntry as E, IconChainEntry as I, NearChainEntry as N, SodaxWalletConfig as S, WalletDefaultsByKey as W, SolanaChainEntry as a, SuiChainEntry as b, StellarChainEntry as c, InjectiveChainEntry as d, StacksChainEntry as e, EvmAdapterFields as f, SolanaAdapterFields as g, SuiAdapterFields as h, ChainMeta as i, ChainTypeOf as j, ChainTypeConfig as k, EvmTypeConfig as l, SolanaTypeConfig as m, SuiTypeConfig as n, BitcoinTypeConfig as o, StellarTypeConfig as p, InjectiveTypeConfig as q, IconTypeConfig as r, NearTypeConfig as s, StacksTypeConfig as t };
+export type { BitcoinChainEntry as B, ChainEntry as C, EvmAdapterFields as E, IconChainEntry as I, NearChainEntry as N, SodaxWalletConfig as S, WalletDefaultsByKey as W, BitcoinTypeConfig as a, ChainMeta as b, ChainTypeConfig as c, ChainTypeOf as d, EvmChainEntry as e, EvmTypeConfig as f, IconTypeConfig as g, InjectiveChainEntry as h, InjectiveTypeConfig as i, NearTypeConfig as j, SolanaAdapterFields as k, SolanaChainEntry as l, SolanaTypeConfig as m, StacksChainEntry as n, StacksTypeConfig as o, StellarChainEntry as p, StellarTypeConfig as q, SuiAdapterFields as r, SuiChainEntry as s, SuiTypeConfig as t };

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 import { SpokeChainKey, GetChainType, ChainType, ChainKey, EvmChainKey, XToken, GetWalletProviderType } from '@sodax/types';
 export { IWalletProvider } from '@sodax/types';
-import { X as XAccount, I as IXConnector, a as XConnection, b as XService, c as XConnector } from './XConnector-B9YQTVJ4.js';
-export { d as IXService } from './XConnector-B9YQTVJ4.js';
+import { X as XAccount, I as IXConnector, b as XConnection, d as XService, c as XConnector } from './XConnector-12q0OVe5.js';
+export { a as IXService } from './XConnector-12q0OVe5.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-DEsqgrG1.js';
+export { B as BitcoinChainEntry, a as BitcoinTypeConfig, b as ChainMeta, c as ChainTypeConfig, d as ChainTypeOf, E as EvmAdapterFields, f as EvmTypeConfig, I as IconChainEntry, g as IconTypeConfig, h as InjectiveChainEntry, i as InjectiveTypeConfig, N as NearChainEntry, j as NearTypeConfig, k as SolanaAdapterFields, l as SolanaChainEntry, m as SolanaTypeConfig, n as StacksChainEntry, o as StacksTypeConfig, p as StellarChainEntry, q as StellarTypeConfig, r as SuiAdapterFields, s as SuiChainEntry, t as SuiTypeConfig } from './config-DEsqgrG1.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-VCESC6QT.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-VCESC6QT.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-MWWVB7TD.mjs';
+import './chunk-C6M34IVL.mjs';
+import { request } from './chunk-WPZOLGVB.mjs';
+import { assertSuiProviderShape } from './chunk-TACW7Z4D.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-OPYSVPRW.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.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, IBitcoinWalletProvider, BtcWalletAddressType } from '@sodax/types';
 export { BtcWalletAddressType } from '@sodax/types';
 import { BitcoinWalletDefaults } from '@sodax/wallet-sdk-core';

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-VCESC6QT.mjs';
+import '../../chunk-X7BHR7WS.mjs';
+import '../../chunk-JQ4H4GJ5.mjs';
+import '../../chunk-Z5GXDHGL.mjs';
+import '../../chunk-MWWVB7TD.mjs';
+import '../../chunk-C6M34IVL.mjs';
+import '../../chunk-WPZOLGVB.mjs';
+import '../../chunk-TACW7Z4D.mjs';
+import '../../chunk-NAKCAL2M.mjs';
+import '../../chunk-FSOGMSJH.mjs';
+import '../../chunk-7V7O3Q7Y.mjs';
+import '../../chunk-OPYSVPRW.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 { d as XService, c as XConnector, X as XAccount } from '../../XConnector-12q0OVe5.js';
 import { XToken } from '@sodax/types';
-import { l as EvmTypeConfig } from '../../config-OlnzyEUE.js';
+import { f as EvmTypeConfig } from '../../config-DEsqgrG1.js';
 import { Config, CreateConnectorFn, Connector } from 'wagmi';
 import '@sodax/wallet-sdk-core';
 import 'wagmi/connectors';
@@ -9,7 +9,7 @@ type WagmiOptions = {
     reconnectOnMount?: boolean;
     ssr?: boolean;
 };
-declare const createWagmiConfig: (evmChains: EvmTypeConfig["chains"], options?: WagmiOptions & {
+declare const createWagmiConfig: (evmChains?: EvmTypeConfig["chains"], options?: WagmiOptions & {
     connectors?: CreateConnectorFn[];
 }) => Config;
 /**

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';