@xyo-network/react-chain-client 1.20.8

package/dist/browser/hooks/client/helpers/findCaveat.d.ts

@@ -0,0 +1,3 @@
+import type { CaveatTypes, ParentCapability, XyoPermissions } from '@xyo-network/xl1-sdk';
+export declare const findCaveat: (permissions: XyoPermissions, targetCapability: ParentCapability, targetCaveatType: CaveatTypes) => Promise<{}>;
+//# sourceMappingURL=findCaveat.d.ts.map

package/dist/browser/hooks/client/helpers/findCaveat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findCaveat.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/client/helpers/findCaveat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAC9C,MAAM,sBAAsB,CAAA;AAE7B,eAAO,MAAM,UAAU,GACrB,aAAa,cAAc,EAC3B,kBAAkB,gBAAgB,EAClC,kBAAkB,WAAW,gBAW9B,CAAA"}

package/dist/browser/hooks/client/helpers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './findCaveat.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/hooks/client/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/client/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA"}

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

@@ -0,0 +1,5 @@
+export * from './helpers/index.ts';
+export * from './permissions/index.ts';
+export * from './useClientFromWallet.ts';
+export * from './useGatewayFromWallet.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,2BAA2B,CAAA"}

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

@@ -0,0 +1,3 @@
+export * from './usePermissions.ts';
+export * from './usePermissionsAccounts.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/hooks/client/permissions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/client/permissions/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,6BAA6B,CAAA"}

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

@@ -0,0 +1,7 @@
+export declare const usePermissions: () => {
+    permissions: import("@xyo-network/xl1-protocol").XyoPermissions | undefined;
+    isLoading: boolean;
+    error: Error | null;
+    timedout: boolean;
+};
+//# sourceMappingURL=usePermissions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePermissions.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/client/permissions/usePermissions.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc;;;;;CAW1B,CAAA"}

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

@@ -0,0 +1,2 @@
+export declare const useAccountPermissions: () => [readonly string[] | undefined, Error | undefined, import("@xylabs/react-promise").UsePromiseState | undefined];
+//# sourceMappingURL=usePermissionsAccounts.d.ts.map

package/dist/browser/hooks/client/permissions/usePermissionsAccounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePermissionsAccounts.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/client/permissions/usePermissionsAccounts.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,qBAAqB,uHAejC,CAAA"}

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

@@ -0,0 +1,12 @@
+import type { XyoClient } from '@xyo-network/xl1-sdk';
+interface ClientState {
+    client?: XyoClient | null;
+    error: Error | null;
+    isLoading: boolean;
+    timedout: boolean;
+}
+export declare const useClientFromWallet: (timeout?: number) => ClientState;
+/** @deprecated - use useClientFromWallet instead */
+export declare const useClient: (timeout?: number) => ClientState;
+export {};
+//# sourceMappingURL=useClientFromWallet.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,6 @@
+import type { GatewayName } from '@xyo-network/xl1-sdk';
+import type { GatewayFromWallet } from '../../types/index.ts';
+export declare const useGatewayFromWallet: (gatewayName?: GatewayName, timeout?: number) => GatewayFromWallet;
+/** @deprecated - useGatewayFromWallet */
+export declare const useGateway: (gatewayName?: GatewayName, timeout?: number) => GatewayFromWallet;
+//# sourceMappingURL=useGatewayFromWallet.d.ts.map

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

@@ -0,0 +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"}

package/dist/browser/hooks/helpers/getXyoClient.d.ts

@@ -0,0 +1,6 @@
+import type { XyoClient } from '@xyo-network/xl1-sdk';
+export declare const listenForClientInjection: (onClientReady: () => void, timeout: number, onTimeout: () => void) => void;
+type ReturnType = XyoClient | undefined | null;
+export declare function getXyoClient(timeout?: number): Promise<ReturnType>;
+export {};
+//# sourceMappingURL=getXyoClient.d.ts.map

package/dist/browser/hooks/helpers/getXyoClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getXyoClient.d.ts","sourceRoot":"","sources":["../../../../src/hooks/helpers/getXyoClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAQrD,eAAO,MAAM,wBAAwB,GAAI,eAAe,MAAM,IAAI,EAAE,SAAS,MAAM,EAAE,WAAW,MAAM,IAAI,SAazG,CAAA;AAED,KAAK,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAAA;AAE9C,wBAAsB,YAAY,CAAC,OAAO,SAA0B,GAAG,OAAO,CAAC,UAAU,CAAC,CAmBzF"}

package/dist/browser/hooks/helpers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './getXyoClient.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/hooks/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA"}

package/dist/browser/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export * from './client/index.ts';
+export * from './helpers/index.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA"}

package/dist/browser/index.d.ts

@@ -0,0 +1,3 @@
+export * from './hooks/index.ts';
+export * from './types/index.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA"}

package/dist/browser/index.mjs

@@ -0,0 +1,209 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/hooks/client/helpers/findCaveat.ts
+import { isDefined } from "@xylabs/sdk-js";
+var findCaveat = /* @__PURE__ */ __name(async (permissions, targetCapability, targetCaveatType) => {
+  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;
+}, "findCaveat");
+
+// src/hooks/client/useClientFromWallet.ts
+import { isNull } from "@xylabs/sdk-js";
+import { useCallback, useEffect, useSyncExternalStore } from "react";
+
+// src/hooks/helpers/getXyoClient.ts
+import { isUndefined } from "@xylabs/sdk-js";
+var CLIENT_LISTENER_TIMEOUT = 500;
+var hasXyoClient = /* @__PURE__ */ __name(() => {
+  return "client" in globalThis.xyo;
+}, "hasXyoClient");
+var listenForClientInjection = /* @__PURE__ */ __name((onClientReady, timeout, onTimeout) => {
+  let resolved = false;
+  const listener = /* @__PURE__ */ __name(() => {
+    onClientReady();
+    resolved = true;
+  }, "listener");
+  globalThis.addEventListener("xyo:plugin-ready", listener);
+  setTimeout(() => {
+    if (!resolved) {
+      globalThis.removeEventListener("xyo:plugin-ready", listener);
+      onTimeout();
+    }
+  }, timeout);
+}, "listenForClientInjection");
+async function getXyoClient(timeout = CLIENT_LISTENER_TIMEOUT) {
+  if (isUndefined(globalThis.xyo)) {
+    return null;
+  }
+  return hasXyoClient() ? globalThis.xyo.client : await new Promise((resolve) => {
+    listenForClientInjection(() => {
+      resolve(globalThis.xyo.client);
+    }, timeout, () => {
+      resolve(null);
+    });
+  });
+}
+__name(getXyoClient, "getXyoClient");
+
+// src/hooks/client/useClientFromWallet.ts
+var currentState = {
+  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);
+  useEffect(() => {
+    let listener = /* @__PURE__ */ __name(() => {
+      updateState({
+        client: globalThis.xyo?.client,
+        isLoading: false,
+        error: null
+      });
+      emitChange();
+    }, "listener");
+    if (clientState.timedout && isNull(clientState.client) && !clientState.isLoading) {
+      globalThis.addEventListener("xyo:plugin-ready", listener);
+    }
+    return () => {
+      globalThis.removeEventListener("xyo:plugin-ready", listener);
+    };
+  });
+  return clientState;
+}, "useClientFromWallet");
+var useClient = useClientFromWallet;
+
+// src/hooks/client/permissions/usePermissions.ts
+var usePermissions = /* @__PURE__ */ __name(() => {
+  const { client, isLoading, error, timedout } = useClientFromWallet();
+  const permissions = client?.permissions;
+  return {
+    permissions,
+    isLoading,
+    error,
+    timedout
+  };
+}, "usePermissions");
+
+// src/hooks/client/permissions/usePermissionsAccounts.ts
+import { usePromise } from "@xylabs/react-promise";
+import { isArray, isDefined as isDefined2, isDefinedNotNull, isString } from "@xylabs/sdk-js";
+var validateRestrictedAccounts = /* @__PURE__ */ __name((restrictedAccounts) => {
+  if (isDefined2(restrictedAccounts)) {
+    if (isArray(restrictedAccounts) && restrictedAccounts.every(isString)) {
+      return restrictedAccounts;
+    }
+    throw new Error(`Unrecognized format for restrictReturnedAccounts caveat found on permissions.  
+
+      Should be an array of strings: ${JSON.stringify(restrictedAccounts)}`);
+  }
+  return [];
+}, "validateRestrictedAccounts");
+var useAccountPermissions = /* @__PURE__ */ __name(() => {
+  const { permissions, error } = usePermissions();
+  return usePromise(async () => {
+    if (isDefinedNotNull(error)) throw error;
+    if (isDefined2(permissions)) {
+      const restrictedAccounts = await findCaveat(
+        permissions,
+        // TODO - extract to constant in protocol package
+        "xyoWallet_getAccounts",
+        "restrictReturnedAccounts"
+      );
+      return validateRestrictedAccounts(restrictedAccounts);
+    }
+  }, [
+    permissions
+  ]);
+}, "useAccountPermissions");
+
+// src/hooks/client/useGatewayFromWallet.ts
+import { isDefined as isDefined3, isNull as isNull2 } 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;
+    }
+    return client?.gateways?.[gatewayName];
+  }, "resolveGateway");
+  return {
+    gateway: gatewayName ? resolveGateway() : void 0,
+    isLoading,
+    error,
+    timedout
+  };
+}, "useGatewayFromWallet");
+var useGateway = useGatewayFromWallet;
+export {
+  findCaveat,
+  getXyoClient,
+  listenForClientInjection,
+  useAccountPermissions,
+  useClient,
+  useClientFromWallet,
+  useGateway,
+  useGatewayFromWallet,
+  usePermissions
+};
+//# sourceMappingURL=index.mjs.map

package/dist/browser/index.mjs.map

@@ -0,0 +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"]}

package/dist/browser/types/GatewayFromWallet.d.ts

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

package/dist/browser/types/GatewayFromWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GatewayFromWallet.d.ts","sourceRoot":"","sources":["../../../src/types/GatewayFromWallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAA;IACpB,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAA;IAC5C,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA"}

package/dist/browser/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './GatewayFromWallet.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@xyo-network/react-chain-client",
+  "version": "1.20.8",
+  "description": "XYO Layer One React SDK - Client/Wallet Hooks",
+  "homepage": "https://xylabs.com",
+  "bugs": {
+    "url": "git+https://github.com/xylabs/xyo-chain/issues",
+    "email": "support@xylabs.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xylabs/xyo-chain.git"
+  },
+  "license": "LGPL-3.0-only",
+  "author": {
+    "name": "XY Labs Development Team",
+    "email": "support@xylabs.com",
+    "url": "https://xylabs.com"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "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.*"
+  ],
+  "dependencies": {
+    "@xylabs/react-promise": "~7.1.17"
+  },
+  "devDependencies": {
+    "@types/react": "~19.2.14",
+    "@xylabs/sdk-js": "~5.0.86",
+    "@xylabs/ts-scripts-yarn3": "~7.4.25",
+    "@xylabs/tsconfig": "~7.4.25",
+    "@xylabs/tsconfig-dom": "~7.4.25",
+    "@xylabs/tsconfig-react": "~7.4.25",
+    "@xyo-network/react-chain-model": "~1.20.10",
+    "@xyo-network/sdk-js": "~5.3.16",
+    "@xyo-network/xl1-sdk": "~1.25.27",
+    "axios": "^1.13.6",
+    "ethers": "^6.16.0",
+    "react": "~19.2.4",
+    "typescript": "~5.9.3",
+    "zod": "~4.3.6"
+  },
+  "peerDependencies": {
+    "@xylabs/sdk-js": "^5",
+    "@xyo-network/xl1-sdk": "^1",
+    "react": "^19"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/global.d.ts

@@ -0,0 +1,9 @@
+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

@@ -0,0 +1,20 @@
+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

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

package/src/hooks/client/index.ts

@@ -0,0 +1,4 @@
+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

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

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

@@ -0,0 +1,14 @@
+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

@@ -0,0 +1,38 @@
+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

@@ -0,0 +1,98 @@
+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

@@ -0,0 +1,30 @@
+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

@@ -0,0 +1,46 @@
+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

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

package/src/hooks/index.ts

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

package/src/index.ts

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

package/src/types/GatewayFromWallet.ts

@@ -0,0 +1,8 @@
+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

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