@hardkas/react 0.5.1-alpha → 0.5.3-alpha

package/README.md

@@ -4,7 +4,7 @@ React hooks and provider context for integrating with the HardKAS deterministic
 
 ## ⚠️ Alpha-Only Local-Runtime Coupling Warning
 
-Please note that in the `v0.5.1-alpha` release, this package has direct dependencies on the **`@hardkas/bridge-local`** package to facilitate local bridge payload planning and prefix-mining simulations directly within hooks like `useBridgeLocalPlan` and `useBridgeLocalSimulation`.
+Please note that in the `v0.5.3-alpha` release, this package has direct dependencies on the **`@hardkas/bridge-local`** package to facilitate local bridge payload planning and prefix-mining simulations directly within hooks like `useBridgeLocalPlan` and `useBridgeLocalSimulation`.
 
 ### 🛡️ Production & Browser Safety
 

package/dist/index.d.ts

@@ -163,6 +163,7 @@ type MetaMaskLocalState = {
 declare function useMetaMaskLocal(): {
     state: MetaMaskLocalState;
     refresh: () => Promise<void>;
+    connect: () => Promise<void>;
 };
 declare function useSwitchToLocalIgra(): {
     switchChain: () => Promise<void>;

package/dist/index.js

@@ -69,7 +69,9 @@ function HardKasProvider({ config, children, queryClient: externalQueryClient })
       "sandbox-session-created",
       "sandbox-session-paired",
       "sandbox-session-expired",
-      "sandbox-session-disconnected"
+      "sandbox-session-disconnected",
+      "ping",
+      "heartbeat"
     ];
     namedEvents.forEach((type) => {
       es.addEventListener(type, (e) => {
@@ -235,7 +237,7 @@ function HardKasProvider({ config, children, queryClient: externalQueryClient })
           default: { http: [config.igraRpcUrl || "http://127.0.0.1:8545"] }
         }
       },
-      transport: http(config.igraRpcUrl || "http://127.0.0.1:8545")
+      transport: http(config.igraRpcUrl || "http://127.0.0.1:8545", { retryCount: 0 })
     });
   }, [config.igraRpcUrl]);
   const value = useMemo(() => ({
@@ -372,11 +374,64 @@ function useKaspaWallet() {
 function useKaspaBalance(options = {}) {
   const { config } = useHardKas();
   const { address, name } = useKaspaWallet();
+  const { data: health } = useHardKasHealth();
+  const l1Status = health?.kaspa?.status || health?.l1?.status;
+  const isL1Online = l1Status === "healthy" || l1Status === "simulated-mode" || l1Status === "ok" || l1Status === "running" || l1Status === "online" || !!address && address.startsWith("kaspa:sim_");
   return useQuery3({
     queryKey: ["kaspa", "balance", address, config.kaspaRpcUrl, name],
     queryFn: async () => {
       if (!address) return 0n;
-      const url = config.kaspaRpcUrl || "http://127.0.0.1:16110";
+      if (address.startsWith("kaspa:sim_") || l1Status === "simulated-mode") {
+        return 100000000000n;
+      }
+      let url = config.kaspaRpcUrl || "http://127.0.0.1:16110";
+      if (url.includes("127.0.0.1:16110") || url.includes("localhost:16110")) {
+        url = "ws://127.0.0.1:18210";
+      } else if (url.includes("127.0.0.1:18210") || url.includes("localhost:18210")) {
+        url = "ws://127.0.0.1:18210";
+      }
+      if (url.startsWith("ws://") || url.startsWith("wss://")) {
+        try {
+          return await new Promise((resolve, reject) => {
+            const ws = new WebSocket(url);
+            const timer = setTimeout(() => {
+              ws.close();
+              reject(new Error("WebSocket timeout"));
+            }, 3e3);
+            ws.onopen = () => {
+              ws.send(JSON.stringify({
+                id: 1,
+                method: "getBalanceByAddressRequest",
+                params: { address }
+              }));
+            };
+            ws.onmessage = (event) => {
+              clearTimeout(timer);
+              try {
+                const response = JSON.parse(event.data);
+                ws.close();
+                if (response.error) {
+                  reject(new Error(response.error.message));
+                } else {
+                  const data = response.result !== void 0 ? response.result : response.params;
+                  resolve(BigInt(data?.balance || 0));
+                }
+              } catch (err) {
+                ws.close();
+                reject(err);
+              }
+            };
+            ws.onerror = (err) => {
+              clearTimeout(timer);
+              ws.close();
+              reject(err);
+            };
+          });
+        } catch (e) {
+          console.warn("Failed to fetch Kaspa balance via WebSocket, falling back to 0:", e);
+          return 0n;
+        }
+      }
       try {
         const response = await fetch(url, {
           method: "POST",
@@ -391,11 +446,10 @@ function useKaspaBalance(options = {}) {
         const json = await response.json();
         return BigInt(json.result?.balance || 0);
       } catch (e) {
-        console.error("Failed to fetch Kaspa balance:", e);
         return 0n;
       }
     },
-    enabled: !!address,
+    enabled: !!address && isL1Online,
     refetchInterval: options.refetchInterval ?? false
   });
 }
@@ -439,13 +493,23 @@ function useIgraBalance(options = {}) {
   const { address } = useIgraAccount();
   const { data: session } = useHardKasSession();
   const { config } = useHardKas();
+  const { data: health } = useHardKasHealth();
+  const l2Status = health?.igra?.status || health?.l2?.status;
+  const isL2Online = l2Status === "healthy" || l2Status === "ok" || l2Status === "running" || l2Status === "online" || !!address && (address.startsWith("0xsim_") || address.startsWith("kaspa:sim_") || !address.startsWith("0x"));
   return useQuery4({
     queryKey: ["igra", "balance", address, config.igraRpcUrl, session?.name],
     queryFn: async () => {
       if (!address) return 0n;
-      return await igraClient.getBalance({ address });
+      if (address.startsWith("0xsim_") || !address.startsWith("0x") || l2Status === "simulated-mode") {
+        return 500000000000000000000n;
+      }
+      try {
+        return await igraClient.getBalance({ address });
+      } catch (e) {
+        return 0n;
+      }
     },
-    enabled: !!address,
+    enabled: !!address && isL2Online,
     refetchInterval: options.refetchInterval ?? false
   });
 }
@@ -523,6 +587,15 @@ function useMetaMaskLocal() {
       setState((s) => ({ ...s, errors: [e.message] }));
     }
   }, []);
+  const connect = useCallback(async () => {
+    if (typeof window === "undefined" || !window.ethereum) return;
+    try {
+      await window.ethereum.request({ method: "eth_requestAccounts" });
+      await checkStatus();
+    } catch (e) {
+      setState((s) => ({ ...s, errors: [...s.errors, e.message] }));
+    }
+  }, [checkStatus]);
   useEffect3(() => {
     if (typeof window === "undefined" || !window.ethereum) return;
     const provider = window.ethereum;
@@ -539,7 +612,7 @@ function useMetaMaskLocal() {
       }
     };
   }, [checkStatus]);
-  return { state, refresh: checkStatus };
+  return { state, refresh: checkStatus, connect };
 }
 function useSwitchToLocalIgra() {
   const switchChain = async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardkas/react",
-  "version": "0.5.1-alpha",
+  "version": "0.5.3-alpha",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,11 +14,11 @@
   "dependencies": {
     "@tanstack/react-query": "^5.61.5",
     "viem": "^2.21.51",
-    "@hardkas/bridge-local": "0.5.1-alpha",
-    "@hardkas/sessions": "0.5.1-alpha",
-    "@hardkas/kaspa-rpc": "0.5.1-alpha",
-    "@hardkas/core": "0.5.1-alpha",
-    "@hardkas/l2": "0.5.1-alpha"
+    "@hardkas/bridge-local": "0.5.3-alpha",
+    "@hardkas/kaspa-rpc": "0.5.3-alpha",
+    "@hardkas/sessions": "0.5.3-alpha",
+    "@hardkas/l2": "0.5.3-alpha",
+    "@hardkas/core": "0.5.3-alpha"
   },
   "devDependencies": {
     "@testing-library/dom": "^10.4.1",