@xyo-network/react-chain-client 1.20.15 → 1.20.17

package/LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

package/README.md

@@ -0,0 +1,24 @@
+# @xyo-network/react-chain-client
+
+[![npm][npm-badge]][npm-link]
+[![license][license-badge]][license-link]
+
+> XYO Layer One React SDK - Client/Wallet Hooks
+
+## Install
+
+```sh
+{{pm}} add {{name}}
+```
+
+
+## License
+
+See the [LICENSE](LICENSE) file for license rights and limitations (LGPL-3.0-only).
+
+
+
+[npm-badge]: https://img.shields.io/npm/v/@xyo-network/react-chain-client.svg
+[npm-link]: https://www.npmjs.com/package/@xyo-network/react-chain-client
+[license-badge]: https://img.shields.io/npm/l/@xyo-network/react-chain-client.svg
+[license-link]: https://github.com/xylabs/sdk-js/blob/main/LICENSE

package/dist/browser/hooks/client/permissions/usePermissions.d.ts

@@ -1,5 +1,5 @@
 export declare const usePermissions: () => {
-    permissions: import("@xyo-network/xl1-protocol-lib").XyoPermissions | undefined;
+    permissions: import("@xyo-network/xl1-sdk").XyoPermissions | undefined;
     isLoading: boolean;
     error: Error | null;
     timedout: boolean;

package/dist/browser/hooks/client/story/GatewayFromWalletStatus.d.ts

@@ -0,0 +1,7 @@
+import type { GatewayName } from '@xyo-network/xl1-sdk';
+import React from 'react';
+export interface GatewayFromWalletStatusProps {
+    gatewayName?: GatewayName;
+}
+export declare const GatewayFromWalletStatus: React.FC<GatewayFromWalletStatusProps>;
+//# sourceMappingURL=GatewayFromWalletStatus.d.ts.map

package/dist/browser/hooks/client/story/GatewayFromWalletStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GatewayFromWalletStatus.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/client/story/GatewayFromWalletStatus.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAaD,eAAO,MAAM,uBAAuB,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CAkC1E,CAAA"}

package/dist/browser/hooks/client/story/mockWalletDecorator.d.ts

@@ -0,0 +1,3 @@
+import type { Decorator } from '@storybook/react-vite';
+export declare const WithMockWallet: Decorator;
+//# sourceMappingURL=mockWalletDecorator.d.ts.map

package/dist/browser/hooks/client/story/mockWalletDecorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockWalletDecorator.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/client/story/mockWalletDecorator.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAyGtD,eAAO,MAAM,cAAc,EAAE,SAa5B,CAAA"}

package/dist/browser/hooks/client/useClientFromWallet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useClientFromWallet.d.ts","sourceRoot":"","sources":["../../../../src/hooks/client/useClientFromWallet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAOrD,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;IACzB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAsDD,eAAO,MAAM,mBAAmB,GAAI,UAAU,MAAM,gBA2BnD,CAAA;AAED,oDAAoD;AACpD,eAAO,MAAM,SAAS,aA9BwB,MAAM,gBA8BR,CAAA"}
+{"version":3,"file":"useClientFromWallet.d.ts","sourceRoot":"","sources":["../../../../src/hooks/client/useClientFromWallet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAKrD,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;IACzB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;CAClB;AASD,eAAO,MAAM,mBAAmB,GAAI,UAAU,MAAM,KAAG,WAqDtD,CAAA;AAED,oDAAoD;AACpD,eAAO,MAAM,SAAS,aAxDwB,MAAM,KAAG,WAwDX,CAAA"}

package/dist/browser/hooks/client/useGatewayFromWallet.d.ts

@@ -1,5 +1,19 @@
 import type { GatewayName } from '@xyo-network/xl1-sdk';
 import type { GatewayFromWallet } from '../../types/index.ts';
+/**
+ * Resolves a gateway from the injected XL1 Wallet extension.
+ *
+ * The returned `gateway` uses a three-state contract:
+ * - `undefined` — wallet detection is still in progress (isLoading=true),
+ *   or no gatewayName was provided. Consumers should treat this as "not yet known"
+ *   and avoid committing to either a present or absent UI state.
+ * - `null` — wallet is definitively absent. Either globalThis.xyo was never set,
+ *   or detection timed out. Safe to show fallback UI (e.g. "Get XL1 Wallet").
+ *   A late-recovery listener may still transition this to a real gateway if
+ *   the extension loads after the timeout.
+ * - `XyoGatewayRunner` — wallet is present and exposes this gateway for the
+ *   requested network. Ready to use for transactions and queries.
+ */
 export declare const useGatewayFromWallet: (gatewayName?: GatewayName, timeout?: number) => GatewayFromWallet;
 /** @deprecated - useGatewayFromWallet */
 export declare const useGateway: (gatewayName?: GatewayName, timeout?: number) => GatewayFromWallet;

package/dist/browser/hooks/client/useGatewayFromWallet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGatewayFromWallet.d.ts","sourceRoot":"","sources":["../../../../src/hooks/client/useGatewayFromWallet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAG7D,eAAO,MAAM,oBAAoB,GAAI,cAAc,WAAW,EAAE,UAAU,MAAM,KAAG,iBAoBlF,CAAA;AAED,yCAAyC;AACzC,eAAO,MAAM,UAAU,iBAvB4B,WAAW,YAAY,MAAM,KAAG,iBAuBrC,CAAA"}
+{"version":3,"file":"useGatewayFromWallet.d.ts","sourceRoot":"","sources":["../../../../src/hooks/client/useGatewayFromWallet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAG7D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,WAAW,EAAE,UAAU,MAAM,KAAG,iBAoBlF,CAAA;AAED,yCAAyC;AACzC,eAAO,MAAM,UAAU,iBAvB4B,WAAW,YAAY,MAAM,KAAG,iBAuBrC,CAAA"}

package/dist/browser/index.mjs

@@ -15,12 +15,12 @@ var findCaveat = /* @__PURE__ */ __name(async (permissions, targetCapability, ta
 }, "findCaveat");
 
 // src/hooks/client/useClientFromWallet.ts
-import { isNull } from "@xylabs/sdk-js";
-import { useCallback, useEffect, useSyncExternalStore } from "react";
+import { isUndefined as isUndefined2 } from "@xylabs/sdk-js";
+import { useEffect, useState } from "react";
 
 // src/hooks/helpers/getXyoClient.ts
 import { isUndefined } from "@xylabs/sdk-js";
-var CLIENT_LISTENER_TIMEOUT = 500;
+var CLIENT_LISTENER_TIMEOUT = 2e3;
 var hasXyoClient = /* @__PURE__ */ __name(() => {
   return "client" in globalThis.xyo;
 }, "hasXyoClient");
@@ -53,82 +53,73 @@ async function getXyoClient(timeout = CLIENT_LISTENER_TIMEOUT) {
 __name(getXyoClient, "getXyoClient");
 
 // src/hooks/client/useClientFromWallet.ts
-var currentState = {
+var initialState = {
   client: void 0,
   error: null,
   isLoading: false,
   timedout: false
 };
-var listeners = /* @__PURE__ */ new Set();
-var emitChange = /* @__PURE__ */ __name(() => {
-  for (const listener of listeners) listener();
-}, "emitChange");
-var updateState = /* @__PURE__ */ __name((newState) => {
-  currentState = {
-    ...currentState,
-    ...newState
-  };
-  emitChange();
-}, "updateState");
-var initializeClient = /* @__PURE__ */ __name(async (timeout) => {
-  if (currentState.isLoading || currentState.client) return;
-  updateState({
-    isLoading: true,
-    error: null
-  });
-  try {
-    const client = await getXyoClient(timeout);
-    if (client === null) {
-      updateState({
-        client: null,
-        timedout: true,
-        isLoading: false
-      });
-      return;
-    }
-    updateState({
-      client,
-      isLoading: false,
-      error: null
-    });
-  } catch (error) {
-    console.error("Error initializing XyoClient", error);
-    updateState({
-      error,
-      isLoading: false
-    });
-  }
-}, "initializeClient");
-var subscribe = /* @__PURE__ */ __name((listener, timeout) => {
-  listeners.add(listener);
-  void initializeClient(timeout);
-  return () => {
-    listeners.delete(listener);
-  };
-}, "subscribe");
-var getSnapshot = /* @__PURE__ */ __name(() => currentState, "getSnapshot");
 var useClientFromWallet = /* @__PURE__ */ __name((timeout) => {
-  const subscribeWithTimeout = useCallback((listener) => subscribe(listener, timeout), [
-    timeout
-  ]);
-  const clientState = useSyncExternalStore(subscribeWithTimeout, getSnapshot);
+  const [state, setState] = useState(initialState);
   useEffect(() => {
-    let listener = /* @__PURE__ */ __name(() => {
-      updateState({
-        client: globalThis.xyo?.client,
+    let cancelled = false;
+    const initialize = /* @__PURE__ */ __name(async () => {
+      setState((prev) => {
+        if (prev.isLoading) return prev;
+        return {
+          ...prev,
+          isLoading: true,
+          error: null
+        };
+      });
+      try {
+        const client = await getXyoClient(timeout);
+        if (cancelled) return;
+        if (client === null) {
+          setState({
+            client: null,
+            timedout: true,
+            isLoading: false,
+            error: null
+          });
+        } else {
+          setState({
+            client,
+            isLoading: false,
+            error: null,
+            timedout: false
+          });
+        }
+      } catch (error) {
+        if (cancelled) return;
+        setState({
+          client: void 0,
+          isLoading: false,
+          error,
+          timedout: false
+        });
+      }
+    }, "initialize");
+    void initialize();
+    const onPluginReady = /* @__PURE__ */ __name(() => {
+      if (cancelled) return;
+      const client = isUndefined2(globalThis.xyo) ? null : globalThis.xyo?.client ?? null;
+      setState({
+        client,
         isLoading: false,
+        timedout: false,
         error: null
       });
-      emitChange();
-    }, "listener");
-    if (clientState.timedout && isNull(clientState.client) && !clientState.isLoading) {
-      globalThis.addEventListener("xyo:plugin-ready", listener);
-    }
+    }, "onPluginReady");
+    globalThis.addEventListener("xyo:plugin-ready", onPluginReady);
     return () => {
-      globalThis.removeEventListener("xyo:plugin-ready", listener);
+      cancelled = true;
+      globalThis.removeEventListener("xyo:plugin-ready", onPluginReady);
     };
-  });
-  return clientState;
+  }, [
+    timeout
+  ]);
+  return state;
 }, "useClientFromWallet");
 var useClient = useClientFromWallet;
 
@@ -177,17 +168,15 @@ var useAccountPermissions = /* @__PURE__ */ __name(() => {
 }, "useAccountPermissions");
 
 // src/hooks/client/useGatewayFromWallet.ts
-import { isDefined as isDefined3, isNull as isNull2 } from "@xylabs/sdk-js";
+import { isNull } from "@xylabs/sdk-js";
 var useGatewayFromWallet = /* @__PURE__ */ __name((gatewayName, timeout) => {
   const { client, isLoading, error, timedout } = useClientFromWallet(timeout);
   const resolveGateway = /* @__PURE__ */ __name(() => {
-    if (isNull2(client)) return null;
-    if (timedout && !isLoading && isDefined3(gatewayName)) {
-      return null;
-    }
+    if (isNull(client)) return null;
     return client?.gateways?.[gatewayName];
   }, "resolveGateway");
   return {
+    // no gatewayName requested = undefined (opt-out, not "absent")
     gateway: gatewayName ? resolveGateway() : void 0,
     isLoading,
     error,

package/dist/browser/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/client/helpers/findCaveat.ts","../../src/hooks/client/useClientFromWallet.ts","../../src/hooks/helpers/getXyoClient.ts","../../src/hooks/client/permissions/usePermissions.ts","../../src/hooks/client/permissions/usePermissionsAccounts.ts","../../src/hooks/client/useGatewayFromWallet.ts"],"sourcesContent":["import { isDefined } from '@xylabs/sdk-js'\nimport type {\n  CaveatTypes, ParentCapability, XyoPermissions,\n} from '@xyo-network/xl1-sdk'\n\nexport const findCaveat = async (\n  permissions: XyoPermissions,\n  targetCapability: ParentCapability,\n  targetCaveatType: CaveatTypes,\n) => {\n  const existingPermissions = await permissions.getPermissions()\n  if (isDefined(existingPermissions) && existingPermissions.length > 0) {\n    const foundPermissions = existingPermissions\n      .find(p => p.parentCapability === targetCapability)\n    if (isDefined(foundPermissions)) {\n      return foundPermissions.caveats?.find(caveat => caveat.type === targetCaveatType)?.value ?? []\n    }\n  }\n  return existingPermissions\n}\n","import { isNull } from '@xylabs/sdk-js'\nimport type { XyoClient } from '@xyo-network/xl1-sdk'\nimport {\n  useCallback, useEffect, useSyncExternalStore,\n} from 'react'\n\nimport { getXyoClient } from '../helpers/index.ts'\n\ninterface ClientState {\n  client?: XyoClient | null\n  error: Error | null\n  isLoading: boolean\n  timedout: boolean\n}\n\nlet currentState: ClientState = {\n  client: undefined,\n  error: null,\n  isLoading: false,\n  timedout: false,\n}\n\nconst listeners = new Set<() => void>()\n\nconst emitChange = () => {\n  for (const listener of listeners) listener()\n}\n\nconst updateState = (newState: Partial<ClientState>) => {\n  currentState = { ...currentState, ...newState }\n  emitChange()\n}\n\nconst initializeClient = async (timeout?: number) => {\n  if (currentState.isLoading || currentState.client) return\n\n  updateState({ isLoading: true, error: null })\n\n  try {\n    const client = await getXyoClient(timeout)\n    if (client === null) {\n      updateState({\n        client: null, timedout: true, isLoading: false,\n      })\n      return\n    }\n    updateState({\n      client, isLoading: false, error: null,\n    })\n  } catch (error) {\n    console.error('Error initializing XyoClient', error)\n    updateState({ error: error as Error, isLoading: false })\n  }\n}\n\nconst subscribe = (listener: () => void, timeout?: number) => {\n  listeners.add(listener)\n\n  void initializeClient(timeout)\n\n  return () => {\n    listeners.delete(listener)\n  }\n}\n\nconst getSnapshot = (): ClientState => currentState\n\nexport const useClientFromWallet = (timeout?: number) => {\n  const subscribeWithTimeout = useCallback((listener: () => void) => subscribe(listener, timeout), [timeout])\n  const clientState = useSyncExternalStore(subscribeWithTimeout, getSnapshot)\n\n  useEffect(() => {\n    // if client appears after timeout\n    let listener = () => {\n      // Update state when client becomes available\n      updateState({\n        client: globalThis.xyo?.client,\n        isLoading: false,\n        error: null,\n      })\n      // Notify listeners of the change\n      emitChange()\n    }\n    // If we have timed out and still no client, listen for the plugin-ready event\n    if (clientState.timedout && isNull(clientState.client) && !clientState.isLoading) {\n      globalThis.addEventListener('xyo:plugin-ready', listener)\n    }\n\n    return () => {\n      globalThis.removeEventListener('xyo:plugin-ready', listener)\n    }\n  })\n\n  return clientState\n}\n\n/** @deprecated - use useClientFromWallet instead */\nexport const useClient = useClientFromWallet\n","import { isUndefined } from '@xylabs/sdk-js'\nimport type { XyoClient } from '@xyo-network/xl1-sdk'\n\nconst CLIENT_LISTENER_TIMEOUT = 500\n\nconst hasXyoClient = () => {\n  return 'client' in globalThis.xyo\n}\n\nexport const listenForClientInjection = (onClientReady: () => void, timeout: number, onTimeout: () => void) => {\n  let resolved = false\n  const listener: EventListener = () => {\n    onClientReady()\n    resolved = true\n  }\n  globalThis.addEventListener('xyo:plugin-ready', listener)\n  setTimeout(() => {\n    if (!resolved) {\n      globalThis.removeEventListener('xyo:plugin-ready', listener)\n      onTimeout()\n    }\n  }, timeout)\n}\n\ntype ReturnType = XyoClient | undefined | null\n\nexport async function getXyoClient(timeout = CLIENT_LISTENER_TIMEOUT): Promise<ReturnType> {\n  // if no xyo object, we can bail early\n  if (isUndefined(globalThis.xyo)) {\n    return null\n  }\n  return hasXyoClient()\n    ? globalThis.xyo.client\n    // listen for the XyoWallet to be injected\n    : await new Promise<ReturnType>((resolve) => {\n        listenForClientInjection(\n          () => {\n            resolve(globalThis.xyo.client)\n          },\n          timeout,\n          () => {\n            resolve(null)\n          },\n        )\n      })\n}\n","import { useClientFromWallet } from '../useClientFromWallet.ts'\n\nexport const usePermissions = () => {\n  const {\n    client, isLoading, error, timedout,\n  } = useClientFromWallet()\n  const permissions = client?.permissions\n  return {\n    permissions,\n    isLoading,\n    error,\n    timedout,\n  }\n}\n","import { usePromise } from '@xylabs/react-promise'\nimport type { JsonValue } from '@xylabs/sdk-js'\nimport {\n  isArray, isDefined, isDefinedNotNull, isString,\n} from '@xylabs/sdk-js'\n\nimport { findCaveat } from '../helpers/index.ts'\nimport { usePermissions } from './usePermissions.ts'\n\nconst validateRestrictedAccounts = (restrictedAccounts: JsonValue): readonly string [] => {\n  if (isDefined(restrictedAccounts)) {\n    if (isArray(restrictedAccounts) && restrictedAccounts.every(isString)) {\n      return restrictedAccounts\n    }\n    throw new Error(\n      `Unrecognized format for restrictReturnedAccounts caveat found on permissions.  \\n\n      Should be an array of strings: ${JSON.stringify(restrictedAccounts)}`,\n    )\n  }\n  return []\n}\n\nexport const useAccountPermissions = () => {\n  const { permissions, error } = usePermissions()\n\n  return usePromise(async () => {\n    if (isDefinedNotNull(error)) throw error\n    if (isDefined(permissions)) {\n      const restrictedAccounts = await findCaveat(\n        permissions,\n        // TODO - extract to constant in protocol package\n        'xyoWallet_getAccounts',\n        'restrictReturnedAccounts',\n      )\n      return validateRestrictedAccounts(restrictedAccounts)\n    }\n  }, [permissions])\n}\n","import { isDefined, isNull } from '@xylabs/sdk-js'\nimport type { GatewayName } from '@xyo-network/xl1-sdk'\n\nimport type { GatewayFromWallet } from '../../types/index.ts'\nimport { useClientFromWallet } from './useClientFromWallet.ts'\n\nexport const useGatewayFromWallet = (gatewayName?: GatewayName, timeout?: number): GatewayFromWallet => {\n  const {\n    client, isLoading, error, timedout,\n  } = useClientFromWallet(timeout)\n\n  const resolveGateway = () => {\n    // null client means we do not have to wait for timedout\n    if (isNull(client)) return null\n    if (timedout && !isLoading && isDefined(gatewayName)) {\n      return null\n    }\n    return client?.gateways?.[gatewayName!]\n  }\n\n  return {\n    gateway: gatewayName ? resolveGateway() : undefined,\n    isLoading,\n    error,\n    timedout,\n  }\n}\n\n/** @deprecated - useGatewayFromWallet */\nexport const useGateway = useGatewayFromWallet\n"],"mappings":"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","names":["isDefined","findCaveat","permissions","targetCapability","targetCaveatType","existingPermissions","getPermissions","isDefined","length","foundPermissions","find","p","parentCapability","caveats","caveat","type","value","isNull","useCallback","useEffect","useSyncExternalStore","isUndefined","CLIENT_LISTENER_TIMEOUT","hasXyoClient","globalThis","xyo","listenForClientInjection","onClientReady","timeout","onTimeout","resolved","listener","addEventListener","setTimeout","removeEventListener","getXyoClient","isUndefined","client","Promise","resolve","currentState","client","undefined","error","isLoading","timedout","listeners","Set","emitChange","listener","updateState","newState","initializeClient","timeout","getXyoClient","console","subscribe","add","delete","getSnapshot","useClientFromWallet","subscribeWithTimeout","useCallback","clientState","useSyncExternalStore","useEffect","globalThis","xyo","isNull","addEventListener","removeEventListener","useClient","usePermissions","client","isLoading","error","timedout","useClientFromWallet","permissions","usePromise","isArray","isDefined","isDefinedNotNull","isString","validateRestrictedAccounts","restrictedAccounts","isDefined","isArray","every","isString","Error","JSON","stringify","useAccountPermissions","permissions","error","usePermissions","usePromise","isDefinedNotNull","findCaveat","isDefined","isNull","useGatewayFromWallet","gatewayName","timeout","client","isLoading","error","timedout","useClientFromWallet","resolveGateway","isNull","isDefined","gateways","gateway","undefined","useGateway"]}
+{"version":3,"sources":["../../src/hooks/client/helpers/findCaveat.ts","../../src/hooks/client/useClientFromWallet.ts","../../src/hooks/helpers/getXyoClient.ts","../../src/hooks/client/permissions/usePermissions.ts","../../src/hooks/client/permissions/usePermissionsAccounts.ts","../../src/hooks/client/useGatewayFromWallet.ts"],"sourcesContent":["import { isDefined } from '@xylabs/sdk-js'\nimport type {\n  CaveatTypes, ParentCapability, XyoPermissions,\n} from '@xyo-network/xl1-sdk'\n\nexport const findCaveat = async (\n  permissions: XyoPermissions,\n  targetCapability: ParentCapability,\n  targetCaveatType: CaveatTypes,\n) => {\n  const existingPermissions = await permissions.getPermissions()\n  if (isDefined(existingPermissions) && existingPermissions.length > 0) {\n    const foundPermissions = existingPermissions\n      .find(p => p.parentCapability === targetCapability)\n    if (isDefined(foundPermissions)) {\n      return foundPermissions.caveats?.find(caveat => caveat.type === targetCaveatType)?.value ?? []\n    }\n  }\n  return existingPermissions\n}\n","import { isUndefined } from '@xylabs/sdk-js'\nimport type { XyoClient } from '@xyo-network/xl1-sdk'\nimport { useEffect, useState } from 'react'\n\nimport { getXyoClient } from '../helpers/index.ts'\n\ninterface ClientState {\n  client?: XyoClient | null\n  error: Error | null\n  isLoading: boolean\n  timedout: boolean\n}\n\nconst initialState: ClientState = {\n  client: undefined,\n  error: null,\n  isLoading: false,\n  timedout: false,\n}\n\nexport const useClientFromWallet = (timeout?: number): ClientState => {\n  const [state, setState] = useState<ClientState>(initialState)\n\n  useEffect(() => {\n    let cancelled = false\n\n    const initialize = async () => {\n      setState((prev) => {\n        if (prev.isLoading) return prev\n        return {\n          ...prev, isLoading: true, error: null,\n        }\n      })\n\n      try {\n        const client = await getXyoClient(timeout)\n        if (cancelled) return\n        if (client === null) {\n          setState({\n            client: null, timedout: true, isLoading: false, error: null,\n          })\n        } else {\n          setState({\n            client, isLoading: false, error: null, timedout: false,\n          })\n        }\n      } catch (error) {\n        if (cancelled) return\n        setState({\n          client: undefined, isLoading: false, error: error as Error, timedout: false,\n        })\n      }\n    }\n\n    void initialize()\n\n    // Late recovery: if wallet loads after timeout, update state\n    const onPluginReady = () => {\n      if (cancelled) return\n      const client = isUndefined(globalThis.xyo) ? null : globalThis.xyo?.client ?? null\n      setState({\n        client, isLoading: false, timedout: false, error: null,\n      })\n    }\n    globalThis.addEventListener('xyo:plugin-ready', onPluginReady)\n\n    return () => {\n      cancelled = true\n      globalThis.removeEventListener('xyo:plugin-ready', onPluginReady)\n    }\n  }, [timeout])\n\n  return state\n}\n\n/** @deprecated - use useClientFromWallet instead */\nexport const useClient = useClientFromWallet\n","import { isUndefined } from '@xylabs/sdk-js'\nimport type { XyoClient } from '@xyo-network/xl1-sdk'\n\nconst CLIENT_LISTENER_TIMEOUT = 2000\n\nconst hasXyoClient = () => {\n  return 'client' in globalThis.xyo\n}\n\nexport const listenForClientInjection = (onClientReady: () => void, timeout: number, onTimeout: () => void) => {\n  let resolved = false\n  const listener: EventListener = () => {\n    onClientReady()\n    resolved = true\n  }\n  globalThis.addEventListener('xyo:plugin-ready', listener)\n  setTimeout(() => {\n    if (!resolved) {\n      globalThis.removeEventListener('xyo:plugin-ready', listener)\n      onTimeout()\n    }\n  }, timeout)\n}\n\ntype ReturnType = XyoClient | undefined | null\n\nexport async function getXyoClient(timeout = CLIENT_LISTENER_TIMEOUT): Promise<ReturnType> {\n  // if no xyo object, we can bail early\n  if (isUndefined(globalThis.xyo)) {\n    return null\n  }\n  return hasXyoClient()\n    ? globalThis.xyo.client\n    // listen for the XyoWallet to be injected\n    : await new Promise<ReturnType>((resolve) => {\n        listenForClientInjection(\n          () => {\n            resolve(globalThis.xyo.client)\n          },\n          timeout,\n          () => {\n            resolve(null)\n          },\n        )\n      })\n}\n","import { useClientFromWallet } from '../useClientFromWallet.ts'\n\nexport const usePermissions = () => {\n  const {\n    client, isLoading, error, timedout,\n  } = useClientFromWallet()\n  const permissions = client?.permissions\n  return {\n    permissions,\n    isLoading,\n    error,\n    timedout,\n  }\n}\n","import { usePromise } from '@xylabs/react-promise'\nimport type { JsonValue } from '@xylabs/sdk-js'\nimport {\n  isArray, isDefined, isDefinedNotNull, isString,\n} from '@xylabs/sdk-js'\n\nimport { findCaveat } from '../helpers/index.ts'\nimport { usePermissions } from './usePermissions.ts'\n\nconst validateRestrictedAccounts = (restrictedAccounts: JsonValue): readonly string [] => {\n  if (isDefined(restrictedAccounts)) {\n    if (isArray(restrictedAccounts) && restrictedAccounts.every(isString)) {\n      return restrictedAccounts\n    }\n    throw new Error(\n      `Unrecognized format for restrictReturnedAccounts caveat found on permissions.  \\n\n      Should be an array of strings: ${JSON.stringify(restrictedAccounts)}`,\n    )\n  }\n  return []\n}\n\nexport const useAccountPermissions = () => {\n  const { permissions, error } = usePermissions()\n\n  return usePromise(async () => {\n    if (isDefinedNotNull(error)) throw error\n    if (isDefined(permissions)) {\n      const restrictedAccounts = await findCaveat(\n        permissions,\n        // TODO - extract to constant in protocol package\n        'xyoWallet_getAccounts',\n        'restrictReturnedAccounts',\n      )\n      return validateRestrictedAccounts(restrictedAccounts)\n    }\n  }, [permissions])\n}\n","import { isNull } from '@xylabs/sdk-js'\nimport type { GatewayName } from '@xyo-network/xl1-sdk'\n\nimport type { GatewayFromWallet } from '../../types/index.ts'\nimport { useClientFromWallet } from './useClientFromWallet.ts'\n\n/**\n * Resolves a gateway from the injected XL1 Wallet extension.\n *\n * The returned `gateway` uses a three-state contract:\n * - `undefined` — wallet detection is still in progress (isLoading=true),\n *   or no gatewayName was provided. Consumers should treat this as \"not yet known\"\n *   and avoid committing to either a present or absent UI state.\n * - `null` — wallet is definitively absent. Either globalThis.xyo was never set,\n *   or detection timed out. Safe to show fallback UI (e.g. \"Get XL1 Wallet\").\n *   A late-recovery listener may still transition this to a real gateway if\n *   the extension loads after the timeout.\n * - `XyoGatewayRunner` — wallet is present and exposes this gateway for the\n *   requested network. Ready to use for transactions and queries.\n */\nexport const useGatewayFromWallet = (gatewayName?: GatewayName, timeout?: number): GatewayFromWallet => {\n  const {\n    client, isLoading, error, timedout,\n  } = useClientFromWallet(timeout)\n\n  const resolveGateway = () => {\n    // null client = wallet confirmed absent (no globalThis.xyo or timed out)\n    if (isNull(client)) return null\n    // client is undefined (still loading) or defined (wallet present) —\n    // optional chain returns undefined while loading, or the gateway if available\n    return client?.gateways?.[gatewayName!]\n  }\n\n  return {\n    // no gatewayName requested = undefined (opt-out, not \"absent\")\n    gateway: gatewayName ? resolveGateway() : undefined,\n    isLoading,\n    error,\n    timedout,\n  }\n}\n\n/** @deprecated - useGatewayFromWallet */\nexport const useGateway = useGatewayFromWallet\n"],"mappings":"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","names":["isDefined","findCaveat","permissions","targetCapability","targetCaveatType","existingPermissions","getPermissions","isDefined","length","foundPermissions","find","p","parentCapability","caveats","caveat","type","value","isUndefined","useEffect","useState","isUndefined","CLIENT_LISTENER_TIMEOUT","hasXyoClient","globalThis","xyo","listenForClientInjection","onClientReady","timeout","onTimeout","resolved","listener","addEventListener","setTimeout","removeEventListener","getXyoClient","isUndefined","client","Promise","resolve","initialState","client","undefined","error","isLoading","timedout","useClientFromWallet","timeout","state","setState","useState","useEffect","cancelled","initialize","prev","getXyoClient","onPluginReady","isUndefined","globalThis","xyo","addEventListener","removeEventListener","useClient","usePermissions","client","isLoading","error","timedout","useClientFromWallet","permissions","usePromise","isArray","isDefined","isDefinedNotNull","isString","validateRestrictedAccounts","restrictedAccounts","isDefined","isArray","every","isString","Error","JSON","stringify","useAccountPermissions","permissions","error","usePermissions","usePromise","isDefinedNotNull","findCaveat","isNull","useGatewayFromWallet","gatewayName","timeout","client","isLoading","error","timedout","useClientFromWallet","resolveGateway","isNull","gateways","gateway","undefined","useGateway"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/react-chain-client",
-  "version": "1.20.15",
+  "version": "1.20.17",
   "description": "XYO Layer One React SDK - Client/Wallet Hooks",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -24,53 +24,113 @@
       "types": "./dist/browser/index.d.ts",
       "browser": {
         "types": "./dist/browser/index.d.ts",
-        "source": "./src/index.ts",
         "default": "./dist/browser/index.mjs"
       },
-      "source": "./src/index.ts",
       "default": "./dist/browser/index.mjs"
     },
     "./package.json": "./package.json"
   },
   "module": "./dist/browser/index.mjs",
-  "source": "./src/index.ts",
   "types": "./dist/browser/index.d.ts",
   "files": [
     "dist",
-    "src",
     "!**/*.bench.*",
     "!**/*.spec.*",
-    "!**/*.test.*"
+    "!**/*.test.*",
+    "README.md"
   ],
   "dependencies": {
-    "@xylabs/react-promise": "~7.1.17"
+    "@storybook/react-vite": "~10.3.5",
+    "@xyo-network/xl1-sdk": "^1.26.20"
   },
   "devDependencies": {
+    "@emotion/react": "^11.5.0",
+    "@emotion/styled": "^11.3.0",
+    "@mui/material": "^7.3.9",
+    "@opentelemetry/api": "^1",
+    "@types/node": "^25.5.2",
     "@types/react": "~19.2.14",
-    "@xylabs/sdk-js": "~5.0.90",
-    "@xylabs/ts-scripts-common": "~7.5.11",
-    "@xylabs/ts-scripts-yarn3": "~7.5.11",
-    "@xylabs/tsconfig": "~7.5.11",
-    "@xylabs/tsconfig-dom": "~7.5.11",
-    "@xylabs/tsconfig-react": "~7.5.11",
-    "@xyo-network/react-chain-model": "~1.20.15",
-    "@xyo-network/sdk-js": "~5.3.20",
-    "@xyo-network/xl1-sdk": "~1.26.11",
-    "axios": "^1.13.6",
+    "@xylabs/react-promise": "~7.1.20",
+    "@xylabs/sdk-js": "~5.0.95",
+    "@xylabs/ts-scripts-common": "~7.9.6",
+    "@xylabs/ts-scripts-pnpm": "~7.9.6",
+    "@xylabs/tsconfig": "~7.9.6",
+    "@xylabs/tsconfig-dom": "~7.9.6",
+    "@xylabs/tsconfig-react": "~7.9.6",
+    "@xyo-network/account": "~5.3.30",
+    "@xyo-network/account-model": "~5.3.30",
+    "@xyo-network/api-models": "~5.3.30",
+    "@xyo-network/archivist-abstract": "~5.3.30",
+    "@xyo-network/archivist-generic": "~5.3.30",
+    "@xyo-network/archivist-memory": "~5.3.30",
+    "@xyo-network/archivist-model": "~5.3.30",
+    "@xyo-network/archivist-view": "~5.3.30",
+    "@xyo-network/archivist-wrapper": "~5.3",
+    "@xyo-network/boundwitness-builder": "~5.3.30",
+    "@xyo-network/boundwitness-validator": "~5.3.30",
+    "@xyo-network/bridge-abstract": "~5.3.30",
+    "@xyo-network/bridge-model": "~5.3.30",
+    "@xyo-network/config-payload-plugin": "~5.3.30",
+    "@xyo-network/data": "~5.3.30",
+    "@xyo-network/diviner-abstract": "~5.3",
+    "@xyo-network/diviner-boundwitness-memory": "~5.3.30",
+    "@xyo-network/diviner-identity": "~5.3.30",
+    "@xyo-network/diviner-model": "~5.3.30",
+    "@xyo-network/diviner-payload-generic": "~5.3.30",
+    "@xyo-network/diviner-payload-model": "~5.3.30",
+    "@xyo-network/diviner-wrapper": "~5.3",
+    "@xyo-network/dns": "~5.3.30",
+    "@xyo-network/domain-payload-plugin": "~5.3.30",
+    "@xyo-network/elliptic": "~5.3.30",
+    "@xyo-network/hash": "~5.3.30",
+    "@xyo-network/huri": "~5.3.30",
+    "@xyo-network/manifest-model": "~5.3.30",
+    "@xyo-network/module-abstract": "~5.3.30",
+    "@xyo-network/module-model": "~5.3.30",
+    "@xyo-network/module-resolver": "~5.3.30",
+    "@xyo-network/module-wrapper": "~5.3",
+    "@xyo-network/network": "~5.3.30",
+    "@xyo-network/node-abstract": "~5.3.30",
+    "@xyo-network/node-memory": "~5.3.30",
+    "@xyo-network/node-model": "~5.3.30",
+    "@xyo-network/node-view": "~5.3.30",
+    "@xyo-network/node-wrapper": "~5.3",
+    "@xyo-network/payload-builder": "~5.3.30",
+    "@xyo-network/payload-model": "~5.3.30",
+    "@xyo-network/payload-validator": "~5.3.30",
+    "@xyo-network/previous-hash-store-model": "~5.3.30",
+    "@xyo-network/sdk-js": "~5.3.30",
+    "@xyo-network/sentinel-abstract": "~5.3.30",
+    "@xyo-network/sentinel-memory": "~5.3.30",
+    "@xyo-network/sentinel-model": "~5.3.30",
+    "@xyo-network/wallet-model": "~5.3.30",
+    "@xyo-network/wasm": "~5.3.30",
+    "@xyo-network/witness-adhoc": "~5.3.30",
+    "@xyo-network/witness-model": "~5.3.30",
+    "ajv": "^8",
+    "axios": "^1.15.0",
+    "esbuild": "*",
     "ethers": "^6.16.0",
-    "react": "~19.2.4",
+    "mongodb": "^7.1.1",
+    "pako": "~2.1.0",
+    "react": "~19.2.5",
+    "react-dom": "^19.2.5",
+    "storybook": "~10.3.5",
     "typescript": "~5.9.3",
-    "zod": "~4.3.6"
+    "vite": "^8.0.8",
+    "zod": "~4.3.6",
+    "@xyo-network/react-chain-model": "~1.20.17",
+    "@xyo-network/react-chain-shared": "~1.20.17"
   },
   "peerDependencies": {
-    "@xylabs/sdk-js": "^5",
-    "@xyo-network/xl1-sdk": "^1",
-    "react": "^19"
+    "@xylabs/react-promise": "~7.1.20",
+    "@xylabs/sdk-js": "~5.0.93",
+    "react": "~19.2.4"
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=24"
   },
   "publishConfig": {
     "access": "public"
   }
-}
+}

package/src/global.d.ts

@@ -1,9 +0,0 @@
-import type { XyoGlobal } from '@xyo-network/react-chain-model'
-
-export declare global {
-  interface Window {
-    xyo: XyoGlobal
-  }
-
-  var xyo: XyoGlobal
-}

package/src/hooks/client/helpers/findCaveat.ts

@@ -1,20 +0,0 @@
-import { isDefined } from '@xylabs/sdk-js'
-import type {
-  CaveatTypes, ParentCapability, XyoPermissions,
-} from '@xyo-network/xl1-sdk'
-
-export const findCaveat = async (
-  permissions: XyoPermissions,
-  targetCapability: ParentCapability,
-  targetCaveatType: CaveatTypes,
-) => {
-  const existingPermissions = await permissions.getPermissions()
-  if (isDefined(existingPermissions) && existingPermissions.length > 0) {
-    const foundPermissions = existingPermissions
-      .find(p => p.parentCapability === targetCapability)
-    if (isDefined(foundPermissions)) {
-      return foundPermissions.caveats?.find(caveat => caveat.type === targetCaveatType)?.value ?? []
-    }
-  }
-  return existingPermissions
-}

package/src/hooks/client/helpers/index.ts

@@ -1 +0,0 @@
-export * from './findCaveat.ts'

package/src/hooks/client/index.ts

@@ -1,4 +0,0 @@
-export * from './helpers/index.ts'
-export * from './permissions/index.ts'
-export * from './useClientFromWallet.ts'
-export * from './useGatewayFromWallet.ts'

package/src/hooks/client/permissions/index.ts

@@ -1,2 +0,0 @@
-export * from './usePermissions.ts'
-export * from './usePermissionsAccounts.ts'

package/src/hooks/client/permissions/usePermissions.ts

@@ -1,14 +0,0 @@
-import { useClientFromWallet } from '../useClientFromWallet.ts'
-
-export const usePermissions = () => {
-  const {
-    client, isLoading, error, timedout,
-  } = useClientFromWallet()
-  const permissions = client?.permissions
-  return {
-    permissions,
-    isLoading,
-    error,
-    timedout,
-  }
-}

package/src/hooks/client/permissions/usePermissionsAccounts.ts

@@ -1,38 +0,0 @@
-import { usePromise } from '@xylabs/react-promise'
-import type { JsonValue } from '@xylabs/sdk-js'
-import {
-  isArray, isDefined, isDefinedNotNull, isString,
-} from '@xylabs/sdk-js'
-
-import { findCaveat } from '../helpers/index.ts'
-import { usePermissions } from './usePermissions.ts'
-
-const validateRestrictedAccounts = (restrictedAccounts: JsonValue): readonly string [] => {
-  if (isDefined(restrictedAccounts)) {
-    if (isArray(restrictedAccounts) && restrictedAccounts.every(isString)) {
-      return restrictedAccounts
-    }
-    throw new Error(
-      `Unrecognized format for restrictReturnedAccounts caveat found on permissions.  \n
-      Should be an array of strings: ${JSON.stringify(restrictedAccounts)}`,
-    )
-  }
-  return []
-}
-
-export const useAccountPermissions = () => {
-  const { permissions, error } = usePermissions()
-
-  return usePromise(async () => {
-    if (isDefinedNotNull(error)) throw error
-    if (isDefined(permissions)) {
-      const restrictedAccounts = await findCaveat(
-        permissions,
-        // TODO - extract to constant in protocol package
-        'xyoWallet_getAccounts',
-        'restrictReturnedAccounts',
-      )
-      return validateRestrictedAccounts(restrictedAccounts)
-    }
-  }, [permissions])
-}

package/src/hooks/client/useClientFromWallet.ts

@@ -1,98 +0,0 @@
-import { isNull } from '@xylabs/sdk-js'
-import type { XyoClient } from '@xyo-network/xl1-sdk'
-import {
-  useCallback, useEffect, useSyncExternalStore,
-} from 'react'
-
-import { getXyoClient } from '../helpers/index.ts'
-
-interface ClientState {
-  client?: XyoClient | null
-  error: Error | null
-  isLoading: boolean
-  timedout: boolean
-}
-
-let currentState: ClientState = {
-  client: undefined,
-  error: null,
-  isLoading: false,
-  timedout: false,
-}
-
-const listeners = new Set<() => void>()
-
-const emitChange = () => {
-  for (const listener of listeners) listener()
-}
-
-const updateState = (newState: Partial<ClientState>) => {
-  currentState = { ...currentState, ...newState }
-  emitChange()
-}
-
-const initializeClient = async (timeout?: number) => {
-  if (currentState.isLoading || currentState.client) return
-
-  updateState({ isLoading: true, error: null })
-
-  try {
-    const client = await getXyoClient(timeout)
-    if (client === null) {
-      updateState({
-        client: null, timedout: true, isLoading: false,
-      })
-      return
-    }
-    updateState({
-      client, isLoading: false, error: null,
-    })
-  } catch (error) {
-    console.error('Error initializing XyoClient', error)
-    updateState({ error: error as Error, isLoading: false })
-  }
-}
-
-const subscribe = (listener: () => void, timeout?: number) => {
-  listeners.add(listener)
-
-  void initializeClient(timeout)
-
-  return () => {
-    listeners.delete(listener)
-  }
-}
-
-const getSnapshot = (): ClientState => currentState
-
-export const useClientFromWallet = (timeout?: number) => {
-  const subscribeWithTimeout = useCallback((listener: () => void) => subscribe(listener, timeout), [timeout])
-  const clientState = useSyncExternalStore(subscribeWithTimeout, getSnapshot)
-
-  useEffect(() => {
-    // if client appears after timeout
-    let listener = () => {
-      // Update state when client becomes available
-      updateState({
-        client: globalThis.xyo?.client,
-        isLoading: false,
-        error: null,
-      })
-      // Notify listeners of the change
-      emitChange()
-    }
-    // If we have timed out and still no client, listen for the plugin-ready event
-    if (clientState.timedout && isNull(clientState.client) && !clientState.isLoading) {
-      globalThis.addEventListener('xyo:plugin-ready', listener)
-    }
-
-    return () => {
-      globalThis.removeEventListener('xyo:plugin-ready', listener)
-    }
-  })
-
-  return clientState
-}
-
-/** @deprecated - use useClientFromWallet instead */
-export const useClient = useClientFromWallet

package/src/hooks/client/useGatewayFromWallet.ts

@@ -1,30 +0,0 @@
-import { isDefined, isNull } from '@xylabs/sdk-js'
-import type { GatewayName } from '@xyo-network/xl1-sdk'
-
-import type { GatewayFromWallet } from '../../types/index.ts'
-import { useClientFromWallet } from './useClientFromWallet.ts'
-
-export const useGatewayFromWallet = (gatewayName?: GatewayName, timeout?: number): GatewayFromWallet => {
-  const {
-    client, isLoading, error, timedout,
-  } = useClientFromWallet(timeout)
-
-  const resolveGateway = () => {
-    // null client means we do not have to wait for timedout
-    if (isNull(client)) return null
-    if (timedout && !isLoading && isDefined(gatewayName)) {
-      return null
-    }
-    return client?.gateways?.[gatewayName!]
-  }
-
-  return {
-    gateway: gatewayName ? resolveGateway() : undefined,
-    isLoading,
-    error,
-    timedout,
-  }
-}
-
-/** @deprecated - useGatewayFromWallet */
-export const useGateway = useGatewayFromWallet

package/src/hooks/helpers/getXyoClient.ts

@@ -1,46 +0,0 @@
-import { isUndefined } from '@xylabs/sdk-js'
-import type { XyoClient } from '@xyo-network/xl1-sdk'
-
-const CLIENT_LISTENER_TIMEOUT = 500
-
-const hasXyoClient = () => {
-  return 'client' in globalThis.xyo
-}
-
-export const listenForClientInjection = (onClientReady: () => void, timeout: number, onTimeout: () => void) => {
-  let resolved = false
-  const listener: EventListener = () => {
-    onClientReady()
-    resolved = true
-  }
-  globalThis.addEventListener('xyo:plugin-ready', listener)
-  setTimeout(() => {
-    if (!resolved) {
-      globalThis.removeEventListener('xyo:plugin-ready', listener)
-      onTimeout()
-    }
-  }, timeout)
-}
-
-type ReturnType = XyoClient | undefined | null
-
-export async function getXyoClient(timeout = CLIENT_LISTENER_TIMEOUT): Promise<ReturnType> {
-  // if no xyo object, we can bail early
-  if (isUndefined(globalThis.xyo)) {
-    return null
-  }
-  return hasXyoClient()
-    ? globalThis.xyo.client
-    // listen for the XyoWallet to be injected
-    : await new Promise<ReturnType>((resolve) => {
-        listenForClientInjection(
-          () => {
-            resolve(globalThis.xyo.client)
-          },
-          timeout,
-          () => {
-            resolve(null)
-          },
-        )
-      })
-}

package/src/hooks/helpers/index.ts

@@ -1 +0,0 @@
-export * from './getXyoClient.ts'

package/src/hooks/index.ts

@@ -1,2 +0,0 @@
-export * from './client/index.ts'
-export * from './helpers/index.ts'

package/src/index.ts

@@ -1,2 +0,0 @@
-export * from './hooks/index.ts'
-export * from './types/index.ts'

package/src/types/GatewayFromWallet.ts

@@ -1,8 +0,0 @@
-import type { XyoGatewayRunner } from '@xyo-network/xl1-sdk'
-
-export type GatewayFromWallet = {
-  error?: Error | null
-  gateway: XyoGatewayRunner | null | undefined
-  isLoading: boolean
-  timedout: boolean
-}

package/src/types/index.ts

@@ -1 +0,0 @@
-export * from './GatewayFromWallet.ts'