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

package/README.md

@@ -4,8 +4,8 @@ React layer over [`@sodax/wallet-sdk-core`](https://github.com/icon-project/soda
 
 ## Features
 
-- **Unified wallet connectivity** for 9 chain families across 20 chains
-  - EVM (Sonic hub, Ethereum, Arbitrum, Base, BSC, Optimism, Polygon, Avalanche, HyperEVM, Lightlink, Redbelly, Kaia) — EIP-6963 + WalletConnect
+- **Unified wallet connectivity** for 9 chain families across 21 chains
+  - EVM (Sonic hub, Ethereum, Arbitrum, Base, BSC, Optimism, Polygon, Avalanche, HyperEVM, Lightlink, Redbelly, Kaia, Hedera) — EIP-6963 + WalletConnect
   - Solana, Sui, Stellar, ICON, Injective, Bitcoin, NEAR, Stacks
 - **Single-store state** — `useXAccount`, `useXConnection`, `useXAccounts` all read the same Zustand slice; persisted to `localStorage`
 - **Bridge to `@sodax/sdk`** — `useWalletProvider` returns a typed `IXxxWalletProvider` ready to plug into any SDK call
@@ -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-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-PLCA4ZDJ.mjs → chunk-JTQGKX65.mjs}

@@ -1,16 +1,16 @@
-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 { ChainTypeArr, baseChainInfo, ChainKeys, detectBitcoinAddressType, CHAIN_KEYS } from '@sodax/types';
+import { SuiXService } from './chunk-JQ4H4GJ5.mjs';
+import { NearXConnector, NearXService } from './chunk-C6M34IVL.mjs';
+import { EvmXService } from './chunk-LM7R5APS.mjs';
+import { IconHanaXConnector, CHAIN_INFO, IconXService } from './chunk-WX23SYR6.mjs';
+import { assert, isRecord, hasFunctionProperty } from './chunk-TACW7Z4D.mjs';
+import { InjectiveXConnector, InjectiveXService } from './chunk-MWWVB7TD.mjs';
+import { SolanaXService } from './chunk-VPNYFVP6.mjs';
+import { isNativeToken, getEntryDefaults, getRpcUrl } from './chunk-7V7O3Q7Y.mjs';
+import { StacksXConnector, STACKS_PROVIDERS, StacksXService } from './chunk-OPX55MQO.mjs';
+import { StellarWalletsKitXConnector, StellarXService } from './chunk-X7BHR7WS.mjs';
+import { BITCOIN_DEFAULT_RPC_URL, WALLET_METADATA } from './chunk-NAKCAL2M.mjs';
+import { XConnector, XService } from './chunk-IFXZQW4C.mjs';
+import { ChainTypeArr, baseChainInfo, ChainKeys, usesBip322MessageSigning, detectBitcoinAddressType, CHAIN_KEYS } from '@sodax/types';
 import { AddressPurpose, MessageSigningProtocols } from 'sats-connect';
 import { createContext, useMemo, useSyncExternalStore, useCallback, useState, useRef, useContext, useEffect } from 'react';
 import { create } from 'zustand';
@@ -262,7 +262,7 @@ var XverseWalletProvider = class {
 var XVERSE_ADDRESS_TYPE_KEY = "xverse-address-type";
 var XverseXConnector = class _XverseXConnector extends BitcoinXConnector {
   walletProvider;
-  /** Address purpose used when connecting. Taproot (Ordinals) by default to match Radfi. */
+  /** Address purpose used when connecting. Taproot (Ordinals) by default to match Bound Exchange. */
   addressPurpose;
   constructor(defaults) {
     super("Xverse", "xverse", defaults);
@@ -416,6 +416,190 @@ var OKXXConnector = class _OKXXConnector extends BitcoinXConnector {
     return new OKXWalletProvider(xAccount.address, this.defaults);
   }
 };
+var HANA_PROVIDER_ID = "hanaWallet.bitcoin";
+var BitcoinHanaWalletProvider = class {
+  chainType = "BITCOIN";
+  address;
+  publicKey;
+  defaults;
+  constructor(address, publicKey, defaults) {
+    this.address = address;
+    this.publicKey = publicKey;
+    this.defaults = defaults;
+  }
+  async getWalletAddress() {
+    return this.address;
+  }
+  async getPublicKey() {
+    return this.publicKey;
+  }
+  async getAddressType(_address) {
+    return detectBitcoinAddressType(this.address);
+  }
+  /**
+   * Parse a base64-encoded PSBT to count the number of inputs.
+   * Reads the unsigned transaction from the PSBT global section.
+   */
+  countPsbtInputs(psbtBase64) {
+    const data = Buffer.from(psbtBase64, "base64");
+    let offset = 5;
+    const keyLen = data[offset++] ?? 0;
+    if (keyLen !== 1 || data[offset++] !== 0) {
+      return 1;
+    }
+    const firstByte = data[offset++] ?? 0;
+    if (firstByte === 253) offset += 2;
+    else if (firstByte === 254) offset += 4;
+    else if (firstByte === 255) offset += 8;
+    offset += 4;
+    const inputByte = data[offset] ?? 0;
+    if (inputByte < 253) return inputByte;
+    return 1;
+  }
+  async signTransaction(psbtBase64, finalize) {
+    const effectiveFinalize = finalize ?? this.defaults?.defaultFinalize ?? false;
+    const { request } = await import('sats-connect');
+    const inputCount = this.countPsbtInputs(psbtBase64);
+    const signingIndexes = Array.from({ length: inputCount }, (_, i) => i);
+    const response = await request(
+      "signPsbt",
+      {
+        psbt: psbtBase64,
+        broadcast: false,
+        signInputs: {
+          [this.address]: signingIndexes
+        }
+      },
+      HANA_PROVIDER_ID
+    );
+    if (response.status === "error") {
+      throw new Error(response.error?.message || "Hana PSBT signing failed");
+    }
+    const result = response.result;
+    if (effectiveFinalize) {
+      return Buffer.from(result.psbt, "base64").toString("hex");
+    }
+    return result.psbt;
+  }
+  async signEcdsaMessage(message) {
+    const { request } = await import('sats-connect');
+    const response = await request(
+      "signMessage",
+      {
+        address: this.address,
+        message,
+        protocol: MessageSigningProtocols.ECDSA
+      },
+      HANA_PROVIDER_ID
+    );
+    if (response.status === "error") {
+      throw new Error(response.error?.message || "Hana ECDSA signing failed");
+    }
+    return response.result.signature;
+  }
+  async signBip322Message(message) {
+    const { request } = await import('sats-connect');
+    const response = await request(
+      "signMessage",
+      {
+        address: this.address,
+        message,
+        protocol: MessageSigningProtocols.BIP322
+      },
+      HANA_PROVIDER_ID
+    );
+    if (response.status === "error") {
+      throw new Error(response.error?.message || "Hana BIP322 signing failed");
+    }
+    return response.result.signature;
+  }
+  async sendBitcoin(toAddress, satoshis) {
+    const { request } = await import('sats-connect');
+    const response = await request(
+      "sendTransfer",
+      {
+        recipients: [
+          {
+            address: toAddress,
+            amount: Number(satoshis)
+          }
+        ]
+      },
+      HANA_PROVIDER_ID
+    );
+    if (response.status === "error") {
+      throw new Error(response.error?.message || "Hana sendTransfer failed");
+    }
+    return response.result.txid;
+  }
+};
+var HANA_ADDRESS_TYPE_KEY = "hana-address-type";
+var BitcoinHanaXConnector = class _BitcoinHanaXConnector extends BitcoinXConnector {
+  walletProvider;
+  /** Address purpose used when connecting. Taproot (Ordinals) by default to match Bound Exchange. */
+  addressPurpose;
+  constructor(defaults) {
+    super("Hana Wallet", "hana-bitcoin", defaults);
+    const saved = typeof window !== "undefined" ? localStorage.getItem(HANA_ADDRESS_TYPE_KEY) : null;
+    this.addressPurpose = saved === "segwit" ? AddressPurpose.Payment : AddressPurpose.Ordinals;
+  }
+  /** Set address purpose and persist to localStorage. */
+  setAddressPurpose(type) {
+    this.addressPurpose = type === "taproot" ? AddressPurpose.Ordinals : AddressPurpose.Payment;
+    if (typeof window !== "undefined") {
+      localStorage.setItem(HANA_ADDRESS_TYPE_KEY, type);
+    }
+  }
+  static isAvailable() {
+    if (typeof window === "undefined") return false;
+    return !!window.hanaWallet?.bitcoin;
+  }
+  get isInstalled() {
+    return _BitcoinHanaXConnector.isAvailable();
+  }
+  get installUrl() {
+    return WALLET_METADATA.hana.installUrl;
+  }
+  get icon() {
+    return WALLET_METADATA.hana.icon;
+  }
+  async connect() {
+    if (!_BitcoinHanaXConnector.isAvailable()) {
+      throw new Error("Hana wallet is not installed");
+    }
+    const { request } = await import('sats-connect');
+    const response = await request(
+      "getAccounts",
+      {
+        purposes: [this.addressPurpose],
+        message: "Connect to Sodax"
+      },
+      HANA_PROVIDER_ID
+    );
+    if (response.status === "error") {
+      throw new Error(response.error?.message || "Hana connection failed");
+    }
+    const accounts = response.result;
+    const paymentAccount = accounts.find((a) => a.purpose === this.addressPurpose) || accounts[0];
+    if (!paymentAccount) return void 0;
+    this.walletProvider = new BitcoinHanaWalletProvider(paymentAccount.address, paymentAccount.publicKey, this.defaults);
+    return {
+      address: paymentAccount.address,
+      publicKey: paymentAccount.publicKey,
+      xChainType: "BITCOIN"
+    };
+  }
+  async disconnect() {
+    this.walletProvider = void 0;
+  }
+  getWalletProvider() {
+    return this.walletProvider;
+  }
+  recreateWalletProvider(xAccount) {
+    if (!xAccount.address || !xAccount.publicKey) return void 0;
+    return new BitcoinHanaWalletProvider(xAccount.address, xAccount.publicKey, this.defaults);
+  }
+};
 function getXChainType(xChainId) {
   if (!xChainId) {
     return void 0;
@@ -496,7 +680,12 @@ var chainRegistry = {
       const defaults = getEntryDefaults(
         walletConfig?.BITCOIN?.chains?.[ChainKeys.BITCOIN_MAINNET]
       );
-      return [new UnisatXConnector(defaults), new XverseXConnector(defaults), new OKXXConnector(defaults)];
+      return [
+        new UnisatXConnector(defaults),
+        new XverseXConnector(defaults),
+        new OKXXConnector(defaults),
+        new BitcoinHanaXConnector(defaults)
+      ];
     },
     providerManaged: false,
     createActions: (service, getStore) => ({
@@ -510,27 +699,16 @@ var chainRegistry = {
         }
         const address = connection?.xAccount.address;
         if (!address) throw new Error("Bitcoin address not found");
-        const addressType = detectBitcoinAddressType(address);
-        switch (addressType) {
-          case "P2WPKH":
-          case "P2TR": {
-            if (!hasSignBip322(connector)) {
-              throw new Error(`${connector.id} does not support BIP-322 signing`);
-            }
-            return connector.signBip322Message(message);
-          }
-          case "P2SH":
-          case "P2PKH": {
-            if (!hasSignEcdsa(connector)) {
-              throw new Error(`${connector.id} does not support ECDSA signing`);
-            }
-            return connector.signEcdsaMessage(message);
-          }
-          default: {
-            const _exhaustiveCheck = addressType;
-            throw new Error(`Unhandled Bitcoin address type: ${_exhaustiveCheck}`);
+        if (usesBip322MessageSigning(detectBitcoinAddressType(address))) {
+          if (!hasSignBip322(connector)) {
+            throw new Error(`${connector.id} does not support BIP-322 signing`);
           }
+          return connector.signBip322Message(message);
+        }
+        if (!hasSignEcdsa(connector)) {
+          throw new Error(`${connector.id} does not support ECDSA signing`);
         }
+        return connector.signEcdsaMessage(message);
       }
     }),
     createWalletProvider: (service, getStore) => {
@@ -803,9 +981,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 +1177,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 +1228,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 +1784,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 { BitcoinHanaXConnector, 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-E5IAZ7E6.mjs → chunk-LM7R5APS.mjs}

@@ -1,11 +1,12 @@
-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 { mainnet, avalanche, arbitrum, base, bsc, sonic, optimism, polygon, lightlinkPhoenix, kaia, redbellyMainnet } from 'wagmi/chains';
+import { createConfig, createStorage, cookieStorage, http } from 'wagmi';
+import { mainnet, avalanche, arbitrum, base, bsc, sonic, optimism, polygon, lightlinkPhoenix, kaia, redbellyMainnet, hedera } from 'wagmi/chains';
 
+var HEDERA_NATIVE_BALANCE_SCALE = 10n ** 10n;
 var hyper = /* @__PURE__ */ defineChain({
   id: 999,
   name: "HyperEVM",
@@ -44,10 +45,17 @@ var createWagmiConfig = (evmChains, options) => {
       hyper,
       lightlinkPhoenix,
       kaia,
-      redbellyMainnet
+      redbellyMainnet,
+      hedera
     ],
     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])),
@@ -60,7 +68,8 @@ var createWagmiConfig = (evmChains, options) => {
       [hyper.id]: http(getRpcUrl(evmChains?.[ChainKeys.HYPEREVM_MAINNET])),
       [lightlinkPhoenix.id]: http(getRpcUrl(evmChains?.[ChainKeys.LIGHTLINK_MAINNET])),
       [redbellyMainnet.id]: http(getRpcUrl(evmChains?.[ChainKeys.REDBELLY_MAINNET])),
-      [kaia.id]: http(getRpcUrl(evmChains?.[ChainKeys.KAIA_MAINNET]))
+      [kaia.id]: http(getRpcUrl(evmChains?.[ChainKeys.KAIA_MAINNET])),
+      [hedera.id]: http(getRpcUrl(evmChains?.[ChainKeys.HEDERA_MAINNET]))
     },
     storage: createStorage({
       storage: cookieStorage,
@@ -104,7 +113,11 @@ var EvmXService = class _EvmXService extends XService {
     if (!this.wagmiConfig) return 0n;
     const chainId = getWagmiChainId(xToken.chainKey);
     if (isNativeToken(xToken)) {
-      return this._getChainBalance(address, chainId);
+      const balance = await this._getChainBalance(address, chainId);
+      if (xToken.chainKey === ChainKeys.HEDERA_MAINNET) {
+        return balance / HEDERA_NATIVE_BALANCE_SCALE;
+      }
+      return balance;
     }
     throw new Error(`Unsupported token: ${xToken.symbol}`);
   }
@@ -182,5 +195,3 @@ var EvmXConnector = class extends XConnector {
 };
 
 export { EvmXConnector, EvmXService, createWagmiConfig };
-//# sourceMappingURL=chunk-E5IAZ7E6.mjs.map
-//# sourceMappingURL=chunk-E5IAZ7E6.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-OPX55MQO.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 {
@@ -79,6 +85,7 @@ var StacksXConnector = class extends XConnector {
     }
     return {
       address: stxAddress.address,
+      publicKey: stxAddress.publicKey,
       xChainType: this.xChainType
     };
   }
@@ -136,5 +143,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