@aurum-sdk/hooks 0.1.0

package/README.md

@@ -0,0 +1,196 @@
+# @aurum-sdk/hooks
+
+React hooks for Aurum SDK
+
+**Looking for the core SDK? Check out @aurum-sdk/core on [github](https://github.com/aurum-sdk/aurum/packages/sdk) or [npm](https://www.npmjs.com/package/@aurum-sdk/core)**
+
+## Installation
+
+```bash
+pnpm add @aurum-sdk/hooks @aurum-sdk/core
+```
+
+## Quick Start
+
+### 1. Setup Provider
+
+Wrap your app with `AurumProvider`
+
+```tsx
+import { Aurum } from '@aurum-sdk/core';
+import { AurumProvider } from '@aurum-sdk/hooks';
+
+const aurum = new Aurum({
+  brand: { appName: 'Your App Name' },
+  wallets: {
+    email: { projectId: 'cdp-project-id' },
+    walletConnect: { projectId: 'reown-project-id' },
+  },
+});
+
+function App() {
+  return (
+    <AurumProvider aurum={aurum}>
+      <YourApp />
+    </AurumProvider>
+  );
+}
+```
+
+### 2. Use Hooks
+
+```tsx
+import { useAccount, useConnect, useDisconnect } from '@aurum-sdk/hooks';
+
+function WalletButton() {
+  const { publicAddress, isConnected, isInitializing } = useAccount();
+  const { connect, isPending } = useConnect();
+  const { disconnect } = useDisconnect();
+
+  if (isInitializing) return <div>Loading...</div>;
+
+  if (!isConnected) {
+    return (
+      <button onClick={() => connect()} disabled={isPending}>
+        {isPending ? 'Connecting...' : 'Connect Wallet'}
+      </button>
+    );
+  }
+
+  return (
+    <div>
+      <p>{publicAddress}</p>
+      <button onClick={disconnect}>Disconnect</button>
+    </div>
+  );
+}
+```
+
+## Available Hooks
+
+### `useAurum`
+
+Access the raw Aurum SDK instance.
+
+```tsx
+const { aurum, isReady } = useAurum();
+```
+
+| Return    | Type      | Description                               |
+| --------- | --------- | ----------------------------------------- |
+| `aurum`   | `Aurum`   | The Aurum SDK instance                    |
+| `isReady` | `boolean` | Whether the SDK has finished initializing |
+
+### `useAccount`
+
+Access connected user information.
+
+```tsx
+const { publicAddress, walletName, walletId, email, isConnected, isInitializing } = useAccount();
+```
+
+| Return           | Type                      | Description                            |
+| ---------------- | ------------------------- | -------------------------------------- |
+| `publicAddress`  | `string \| undefined`     | The connected wallet address           |
+| `walletName`     | `WalletName \| undefined` | Name of the connected wallet           |
+| `walletId`       | `WalletId \| undefined`   | ID of the connected wallet             |
+| `email`          | `string \| undefined`     | Email address when logged in via email |
+| `isConnected`    | `boolean`                 | Whether a wallet is connected          |
+| `isInitializing` | `boolean`                 | Whether the SDK is initializing        |
+
+### `useConnect`
+
+Connect to a wallet via modal, direct connection, or headless flows.
+
+```tsx
+const { connect, emailAuthStart, emailAuthVerify, getWalletConnectSession, isPending, error } = useConnect();
+
+// Open wallet selection modal
+await connect();
+
+// Or connect directly to a specific wallet (skips modal)
+import { WalletId } from '@aurum-sdk/types';
+await connect(WalletId.MetaMask);
+```
+
+| Return                    | Type                                                                                               | Description                                                   |
+| ------------------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
+| `connect`                 | `(walletId?: WalletId) => Promise<string>`                                                         | Opens wallet modal, or connects directly if walletId provided |
+| `emailAuthStart`          | `(email: string) => Promise<{ flowId: string }>`                                                   | Sends OTP to email for Coinbase Embedded Wallet               |
+| `emailAuthVerify`         | `(flowId: string, otp: string) => Promise<{ address: string, email: string, isNewUser: boolean }>` | Verifies OTP and completes connection                         |
+| `getWalletConnectSession` | `() => Promise<{ uri: string, waitForConnection: () => Promise<string> }>`                         | Gets WalletConnect URI for custom QR display                  |
+| `isPending`               | `boolean`                                                                                          | Whether connection is in progress                             |
+| `error`                   | `Error \| null`                                                                                    | Error from last connection attempt                            |
+
+**Note:** `WalletId.Email` and `WalletId.WalletConnect` cannot be used with `connect(walletId)` — use the headless methods below instead.
+
+> **ConnectWidget Compatibility:** Do not use `useConnect()` with `<ConnectWidget>`. Use `useAccount()` to react to connection state changes instead.
+
+#### Headless Email Authentication
+
+Two-step flow for Coinbase Embedded Wallet:
+
+```tsx
+const { emailAuthStart, emailAuthVerify, isPending, error } = useConnect();
+
+// Step 1: Send OTP
+const { flowId } = await emailAuthStart('user@example.com');
+
+// Step 2: User enters OTP from their email
+const otp = await promptUserForOTP();
+
+// Step 3: Verify and connect
+const { address, email } = await emailAuthVerify(flowId, otp);
+```
+
+#### Headless WalletConnect
+
+For custom QR code displays:
+
+```tsx
+const { getWalletConnectSession, isPending, error } = useConnect();
+
+const { uri, waitForConnection } = await getWalletConnectSession();
+
+// Display your own QR code
+renderQRCode(uri);
+
+// Wait for user to scan and approve
+const address = await waitForConnection();
+```
+
+### `useDisconnect`
+
+Disconnect the current wallet.
+
+```tsx
+const { disconnect } = useDisconnect();
+
+await disconnect();
+```
+
+| Return       | Type                  | Description                    |
+| ------------ | --------------------- | ------------------------------ |
+| `disconnect` | `() => Promise<void>` | Disconnects the current wallet |
+
+### `useChain`
+
+Access chain information and switch chains.
+
+```tsx
+import { sepolia } from 'viem/chains';
+
+const { chainId, switchChain, error } = useChain();
+
+await switchChain(sepolia.id, sepolia);
+```
+
+| Return        | Type                                 | Description                    |
+| ------------- | ------------------------------------ | ------------------------------ |
+| `chainId`     | `number \| null`                     | Current chain ID               |
+| `switchChain` | `(chainId, chain?) => Promise<void>` | Switch to a different chain    |
+| `error`       | `Error \| null`                      | Error from last switch attempt |
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,135 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import * as _aurum_sdk_core from '@aurum-sdk/core';
+import { Aurum } from '@aurum-sdk/core';
+import * as _aurum_sdk_types from '@aurum-sdk/types';
+import { WalletId, WalletConnectSessionResult, WalletName } from '@aurum-sdk/types';
+import { Chain } from 'viem';
+
+interface AurumProviderProps {
+    aurum: Aurum;
+    children: ReactNode;
+}
+declare function AurumProvider({ aurum, children }: AurumProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Access the raw Aurum SDK instance.
+ *
+ * @example
+ * ```tsx
+ * const { aurum, isReady } = useAurum();
+ *
+ * if (isReady) {
+ *   const chainId = await aurum.getChainId();
+ * }
+ * ```
+ */
+declare function useAurum(): {
+    aurum: _aurum_sdk_core.Aurum;
+    isReady: boolean;
+};
+
+/**
+ * Access connected user information.
+ *
+ * @example
+ * ```tsx
+ * const { publicAddress, walletName, isConnected, isInitializing } = useAccount();
+ *
+ * if (isInitializing) return <div>Loading...</div>;
+ *
+ * if (isConnected) {
+ *   return <div>Connected: {publicAddress}</div>;
+ * }
+ * ```
+ */
+declare function useAccount(): {
+    publicAddress: string | undefined;
+    walletName: _aurum_sdk_types.WalletName | undefined;
+    walletId: _aurum_sdk_types.WalletId | undefined;
+    email: string | undefined;
+    isConnected: boolean;
+    isInitializing: boolean;
+};
+
+/**
+ * Connect to a wallet.
+ *
+ * @example
+ * ```tsx
+ * const { connect, emailAuthStart, emailAuthVerify, getWalletConnectSession, isPending, error } = useConnect();
+ *
+ * // Open wallet selection modal
+ * await connect();
+ *
+ * // Or connect directly to a specific wallet
+ * await connect(WalletId.MetaMask);
+ *
+ * // Or use headless email auth
+ * const { flowId } = await emailAuthStart('user@example.com');
+ * const { address, email } = await emailAuthVerify(flowId, '123456');
+ *
+ * // Or use headless WalletConnect
+ * const { uri, waitForConnection } = await getWalletConnectSession();
+ * // Display your own QR code with `uri`
+ * const address = await waitForConnection();
+ * ```
+ */
+declare function useConnect(): {
+    connect: (walletId?: WalletId) => Promise<`0x${string}`>;
+    emailAuthStart: (email: string) => Promise<_aurum_sdk_types.EmailAuthStartResult>;
+    emailAuthVerify: (flowId: string, otp: string) => Promise<_aurum_sdk_types.EmailAuthVerifyResult>;
+    getWalletConnectSession: () => Promise<WalletConnectSessionResult>;
+    isPending: boolean;
+    error: Error | null;
+};
+
+/**
+ * Disconnect the current wallet.
+ *
+ * @example
+ * ```tsx
+ * const { disconnect } = useDisconnect();
+ *
+ * return <button onClick={disconnect}>Disconnect</button>;
+ * ```
+ */
+declare function useDisconnect(): {
+    disconnect: () => Promise<void>;
+};
+
+/**
+ * Access chain information and switch chains.
+ *
+ * @example
+ * ```tsx
+ * import { sepolia } from 'viem/chains';
+ *
+ * const { chainId, switchChain, error } = useChain();
+ *
+ * return (
+ *   <div>
+ *     <p>Chain ID: {chainId}</p>
+ *     <button onClick={() => switchChain(sepolia.id, sepolia)}>
+ *       Switch to Sepolia
+ *     </button>
+ *   </div>
+ * );
+ * ```
+ */
+declare function useChain(): {
+    chainId: number | null;
+    switchChain: (targetChainId: number | string | `0x${string}`, chain?: Chain) => Promise<void>;
+    error: Error | null;
+};
+
+interface AccountState {
+    publicAddress: string | undefined;
+    walletName: WalletName | undefined;
+    walletId: WalletId | undefined;
+    email: string | undefined;
+    isConnected: boolean;
+    isInitializing: boolean;
+}
+
+export { type AccountState, AurumProvider, useAccount, useAurum, useChain, useConnect, useDisconnect };

package/dist/index.d.ts

@@ -0,0 +1,135 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import * as _aurum_sdk_core from '@aurum-sdk/core';
+import { Aurum } from '@aurum-sdk/core';
+import * as _aurum_sdk_types from '@aurum-sdk/types';
+import { WalletId, WalletConnectSessionResult, WalletName } from '@aurum-sdk/types';
+import { Chain } from 'viem';
+
+interface AurumProviderProps {
+    aurum: Aurum;
+    children: ReactNode;
+}
+declare function AurumProvider({ aurum, children }: AurumProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Access the raw Aurum SDK instance.
+ *
+ * @example
+ * ```tsx
+ * const { aurum, isReady } = useAurum();
+ *
+ * if (isReady) {
+ *   const chainId = await aurum.getChainId();
+ * }
+ * ```
+ */
+declare function useAurum(): {
+    aurum: _aurum_sdk_core.Aurum;
+    isReady: boolean;
+};
+
+/**
+ * Access connected user information.
+ *
+ * @example
+ * ```tsx
+ * const { publicAddress, walletName, isConnected, isInitializing } = useAccount();
+ *
+ * if (isInitializing) return <div>Loading...</div>;
+ *
+ * if (isConnected) {
+ *   return <div>Connected: {publicAddress}</div>;
+ * }
+ * ```
+ */
+declare function useAccount(): {
+    publicAddress: string | undefined;
+    walletName: _aurum_sdk_types.WalletName | undefined;
+    walletId: _aurum_sdk_types.WalletId | undefined;
+    email: string | undefined;
+    isConnected: boolean;
+    isInitializing: boolean;
+};
+
+/**
+ * Connect to a wallet.
+ *
+ * @example
+ * ```tsx
+ * const { connect, emailAuthStart, emailAuthVerify, getWalletConnectSession, isPending, error } = useConnect();
+ *
+ * // Open wallet selection modal
+ * await connect();
+ *
+ * // Or connect directly to a specific wallet
+ * await connect(WalletId.MetaMask);
+ *
+ * // Or use headless email auth
+ * const { flowId } = await emailAuthStart('user@example.com');
+ * const { address, email } = await emailAuthVerify(flowId, '123456');
+ *
+ * // Or use headless WalletConnect
+ * const { uri, waitForConnection } = await getWalletConnectSession();
+ * // Display your own QR code with `uri`
+ * const address = await waitForConnection();
+ * ```
+ */
+declare function useConnect(): {
+    connect: (walletId?: WalletId) => Promise<`0x${string}`>;
+    emailAuthStart: (email: string) => Promise<_aurum_sdk_types.EmailAuthStartResult>;
+    emailAuthVerify: (flowId: string, otp: string) => Promise<_aurum_sdk_types.EmailAuthVerifyResult>;
+    getWalletConnectSession: () => Promise<WalletConnectSessionResult>;
+    isPending: boolean;
+    error: Error | null;
+};
+
+/**
+ * Disconnect the current wallet.
+ *
+ * @example
+ * ```tsx
+ * const { disconnect } = useDisconnect();
+ *
+ * return <button onClick={disconnect}>Disconnect</button>;
+ * ```
+ */
+declare function useDisconnect(): {
+    disconnect: () => Promise<void>;
+};
+
+/**
+ * Access chain information and switch chains.
+ *
+ * @example
+ * ```tsx
+ * import { sepolia } from 'viem/chains';
+ *
+ * const { chainId, switchChain, error } = useChain();
+ *
+ * return (
+ *   <div>
+ *     <p>Chain ID: {chainId}</p>
+ *     <button onClick={() => switchChain(sepolia.id, sepolia)}>
+ *       Switch to Sepolia
+ *     </button>
+ *   </div>
+ * );
+ * ```
+ */
+declare function useChain(): {
+    chainId: number | null;
+    switchChain: (targetChainId: number | string | `0x${string}`, chain?: Chain) => Promise<void>;
+    error: Error | null;
+};
+
+interface AccountState {
+    publicAddress: string | undefined;
+    walletName: WalletName | undefined;
+    walletId: WalletId | undefined;
+    email: string | undefined;
+    isConnected: boolean;
+    isInitializing: boolean;
+}
+
+export { type AccountState, AurumProvider, useAccount, useAurum, useChain, useConnect, useDisconnect };

package/dist/index.js

@@ -0,0 +1,251 @@
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/AurumProvider.tsx
+var initialAccountState = {
+  publicAddress: void 0,
+  walletName: void 0,
+  walletId: void 0,
+  email: void 0,
+  isConnected: false,
+  isInitializing: true
+};
+var AurumContext = react.createContext(null);
+function useAurumContext() {
+  const context = react.useContext(AurumContext);
+  if (!context) {
+    throw new Error("useAurumContext must be used within a AurumProvider");
+  }
+  return context;
+}
+function AurumProvider({ aurum, children }) {
+  const [isReady, setIsReady] = react.useState(false);
+  const accountStateRef = react.useRef(initialAccountState);
+  const listenersRef = react.useRef(/* @__PURE__ */ new Set());
+  const notifyListeners = react.useCallback(() => {
+    listenersRef.current.forEach((listener) => listener());
+  }, []);
+  const syncState = react.useCallback(async () => {
+    try {
+      const userInfo = await aurum.getUserInfo();
+      const isConnected = await aurum.isConnected();
+      const newState = {
+        publicAddress: userInfo?.publicAddress,
+        walletName: userInfo?.walletName,
+        walletId: userInfo?.walletId,
+        email: userInfo?.email,
+        isConnected,
+        isInitializing: false
+      };
+      accountStateRef.current = newState;
+      notifyListeners();
+    } catch {
+      accountStateRef.current = {
+        ...initialAccountState,
+        isInitializing: false
+      };
+      notifyListeners();
+    }
+  }, [aurum, notifyListeners]);
+  react.useEffect(() => {
+    let mounted = true;
+    const initialize = async () => {
+      await aurum.whenReady();
+      if (!mounted) return;
+      setIsReady(true);
+      await syncState();
+    };
+    initialize();
+    const handleAccountsChanged = () => {
+      if (mounted) syncState();
+    };
+    const handleChainChanged = () => {
+      if (mounted) syncState();
+    };
+    aurum.rpcProvider?.on?.("accountsChanged", handleAccountsChanged);
+    aurum.rpcProvider?.on?.("chainChanged", handleChainChanged);
+    return () => {
+      mounted = false;
+      aurum.rpcProvider?.removeListener?.("accountsChanged", handleAccountsChanged);
+      aurum.rpcProvider?.removeListener?.("chainChanged", handleChainChanged);
+    };
+  }, [aurum, syncState]);
+  const subscribe = react.useCallback((callback) => {
+    listenersRef.current.add(callback);
+    return () => {
+      listenersRef.current.delete(callback);
+    };
+  }, []);
+  const getSnapshot = react.useCallback(() => {
+    return accountStateRef.current;
+  }, []);
+  const getServerSnapshot = react.useCallback(() => {
+    return initialAccountState;
+  }, []);
+  const contextValue = react.useMemo(
+    () => ({
+      aurum,
+      isReady,
+      subscribe,
+      getSnapshot,
+      getServerSnapshot
+    }),
+    [aurum, isReady, subscribe, getSnapshot, getServerSnapshot]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(AurumContext.Provider, { value: contextValue, children });
+}
+
+// src/hooks/useAurum.ts
+function useAurum() {
+  const { aurum, isReady } = useAurumContext();
+  return { aurum, isReady };
+}
+function useAccount() {
+  const { subscribe, getSnapshot, getServerSnapshot } = useAurumContext();
+  const account = react.useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+  return {
+    publicAddress: account.publicAddress,
+    walletName: account.walletName,
+    walletId: account.walletId,
+    email: account.email,
+    isConnected: account.isConnected,
+    isInitializing: account.isInitializing
+  };
+}
+function useConnect() {
+  const { aurum } = useAurumContext();
+  const [isPending, setIsPending] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const connect = react.useCallback(
+    async (walletId) => {
+      setIsPending(true);
+      setError(null);
+      try {
+        const address = await aurum.connect(walletId);
+        return address;
+      } catch (err) {
+        const error2 = err instanceof Error ? err : new Error("User rejected connection");
+        setError(error2);
+        throw error2;
+      } finally {
+        setIsPending(false);
+      }
+    },
+    [aurum]
+  );
+  const emailAuthStart = react.useCallback(
+    async (email) => {
+      setIsPending(true);
+      setError(null);
+      try {
+        const result = await aurum.emailAuthStart(email);
+        return result;
+      } catch (err) {
+        const error2 = err instanceof Error ? err : new Error("Failed to start email auth");
+        setError(error2);
+        throw error2;
+      } finally {
+        setIsPending(false);
+      }
+    },
+    [aurum]
+  );
+  const emailAuthVerify = react.useCallback(
+    async (flowId, otp) => {
+      setIsPending(true);
+      setError(null);
+      try {
+        const result = await aurum.emailAuthVerify(flowId, otp);
+        return result;
+      } catch (err) {
+        const error2 = err instanceof Error ? err : new Error("Failed to verify email");
+        setError(error2);
+        throw error2;
+      } finally {
+        setIsPending(false);
+      }
+    },
+    [aurum]
+  );
+  const getWalletConnectSession = react.useCallback(async () => {
+    setIsPending(true);
+    setError(null);
+    try {
+      const result = await aurum.getWalletConnectSession();
+      return result;
+    } catch (err) {
+      const error2 = err instanceof Error ? err : new Error("Failed to get WalletConnect session");
+      setError(error2);
+      throw error2;
+    } finally {
+      setIsPending(false);
+    }
+  }, [aurum]);
+  return {
+    connect,
+    emailAuthStart,
+    emailAuthVerify,
+    getWalletConnectSession,
+    isPending,
+    error
+  };
+}
+function useDisconnect() {
+  const { aurum } = useAurumContext();
+  const disconnect = react.useCallback(async () => {
+    await aurum.disconnect();
+  }, [aurum]);
+  return { disconnect };
+}
+function useChain() {
+  const { aurum, isReady } = useAurumContext();
+  const [chainId, setChainId] = react.useState(null);
+  const [error, setError] = react.useState(null);
+  react.useEffect(() => {
+    if (!isReady) return;
+    const fetchChainId = async () => {
+      try {
+        const id = await aurum.getChainId();
+        setChainId(id);
+      } catch {
+        setChainId(null);
+      }
+    };
+    fetchChainId();
+    const handleChainChanged = (newChainId) => {
+      setChainId(Number(newChainId));
+    };
+    aurum.rpcProvider?.on?.("chainChanged", handleChainChanged);
+    return () => {
+      aurum.rpcProvider?.removeListener?.("chainChanged", handleChainChanged);
+    };
+  }, [aurum, isReady]);
+  const switchChain = react.useCallback(
+    async (targetChainId, chain) => {
+      if (!targetChainId) {
+        throw new Error("chainId is required");
+      }
+      setError(null);
+      try {
+        await aurum.switchChain(targetChainId, chain);
+      } catch (err) {
+        const error2 = err instanceof Error ? err : new Error("Failed to switch chain");
+        setError(error2);
+        throw error2;
+      }
+    },
+    [aurum]
+  );
+  return { chainId, switchChain, error };
+}
+
+exports.AurumProvider = AurumProvider;
+exports.useAccount = useAccount;
+exports.useAurum = useAurum;
+exports.useChain = useChain;
+exports.useConnect = useConnect;
+exports.useDisconnect = useDisconnect;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/AurumContext.ts","../src/AurumProvider.tsx","../src/hooks/useAurum.ts","../src/hooks/useAccount.ts","../src/hooks/useConnect.ts","../src/hooks/useDisconnect.ts","../src/hooks/useChain.ts"],"names":["createContext","useContext","useState","useRef","useCallback","useEffect","useMemo","useSyncExternalStore","error"],"mappings":"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","file":"index.js","sourcesContent":["'use client';\n\nimport { createContext, useContext } from 'react';\nimport type { Aurum } from '@aurum-sdk/core';\nimport type { WalletId, WalletName } from '@aurum-sdk/types';\n\nexport interface AccountState {\n  publicAddress: string | undefined;\n  walletName: WalletName | undefined;\n  walletId: WalletId | undefined;\n  email: string | undefined;\n  isConnected: boolean;\n  isInitializing: boolean;\n}\n\ninterface AurumContextValue {\n  aurum: Aurum;\n  isReady: boolean;\n  subscribe: (callback: () => void) => () => void;\n  getSnapshot: () => AccountState;\n  getServerSnapshot: () => AccountState;\n}\n\nexport const initialAccountState: AccountState = {\n  publicAddress: undefined,\n  walletName: undefined,\n  walletId: undefined,\n  email: undefined,\n  isConnected: false,\n  isInitializing: true,\n};\n\nexport const AurumContext = createContext<AurumContextValue | null>(null);\n\nexport function useAurumContext(): AurumContextValue {\n  const context = useContext(AurumContext);\n  if (!context) {\n    throw new Error('useAurumContext must be used within a AurumProvider');\n  }\n  return context;\n}\n","'use client';\n\nimport { useRef, useEffect, useCallback, useState, useMemo, type ReactNode } from 'react';\nimport { AurumContext, initialAccountState, type AccountState } from '@src/AurumContext';\nimport type { Aurum } from '@aurum-sdk/core';\n\ninterface AurumProviderProps {\n  aurum: Aurum;\n  children: ReactNode;\n}\n\nexport function AurumProvider({ aurum, children }: AurumProviderProps) {\n  const [isReady, setIsReady] = useState(false);\n  const accountStateRef = useRef<AccountState>(initialAccountState);\n  const listenersRef = useRef<Set<() => void>>(new Set());\n\n  // Notify all subscribers of state changes\n  const notifyListeners = useCallback(() => {\n    listenersRef.current.forEach((listener) => listener());\n  }, []);\n\n  // Sync state from SDK\n  const syncState = useCallback(async () => {\n    try {\n      const userInfo = await aurum.getUserInfo();\n      const isConnected = await aurum.isConnected();\n\n      const newState: AccountState = {\n        publicAddress: userInfo?.publicAddress,\n        walletName: userInfo?.walletName,\n        walletId: userInfo?.walletId,\n        email: userInfo?.email,\n        isConnected,\n        isInitializing: false,\n      };\n\n      accountStateRef.current = newState;\n      notifyListeners();\n    } catch {\n      accountStateRef.current = {\n        ...initialAccountState,\n        isInitializing: false,\n      };\n      notifyListeners();\n    }\n  }, [aurum, notifyListeners]);\n\n  // Initialize SDK and set up event listeners\n  useEffect(() => {\n    let mounted = true;\n\n    const initialize = async () => {\n      await aurum.whenReady();\n      if (!mounted) return;\n\n      setIsReady(true);\n      await syncState();\n    };\n\n    initialize();\n\n    // Subscribe to provider events for account changes\n    const handleAccountsChanged = () => {\n      if (mounted) syncState();\n    };\n\n    const handleChainChanged = () => {\n      if (mounted) syncState();\n    };\n\n    aurum.rpcProvider?.on?.('accountsChanged', handleAccountsChanged);\n    aurum.rpcProvider?.on?.('chainChanged', handleChainChanged);\n\n    return () => {\n      mounted = false;\n      aurum.rpcProvider?.removeListener?.('accountsChanged', handleAccountsChanged);\n      aurum.rpcProvider?.removeListener?.('chainChanged', handleChainChanged);\n    };\n  }, [aurum, syncState]);\n\n  // Subscribe function for useSyncExternalStore\n  const subscribe = useCallback((callback: () => void) => {\n    listenersRef.current.add(callback);\n    return () => {\n      listenersRef.current.delete(callback);\n    };\n  }, []);\n\n  // Get current snapshot for useSyncExternalStore\n  const getSnapshot = useCallback(() => {\n    return accountStateRef.current;\n  }, []);\n\n  // Server snapshot - always returns initial state\n  const getServerSnapshot = useCallback(() => {\n    return initialAccountState;\n  }, []);\n\n  const contextValue = useMemo(\n    () => ({\n      aurum,\n      isReady,\n      subscribe,\n      getSnapshot,\n      getServerSnapshot,\n    }),\n    [aurum, isReady, subscribe, getSnapshot, getServerSnapshot],\n  );\n\n  return <AurumContext.Provider value={contextValue}>{children}</AurumContext.Provider>;\n}\n","'use client';\n\nimport { useAurumContext } from '@src/AurumContext';\n\n/**\n * Access the raw Aurum SDK instance.\n *\n * @example\n * ```tsx\n * const { aurum, isReady } = useAurum();\n *\n * if (isReady) {\n *   const chainId = await aurum.getChainId();\n * }\n * ```\n */\nexport function useAurum() {\n  const { aurum, isReady } = useAurumContext();\n  return { aurum, isReady };\n}\n","'use client';\n\nimport { useSyncExternalStore } from 'react';\nimport { useAurumContext } from '@src/AurumContext';\n\n/**\n * Access connected user information.\n *\n * @example\n * ```tsx\n * const { publicAddress, walletName, isConnected, isInitializing } = useAccount();\n *\n * if (isInitializing) return <div>Loading...</div>;\n *\n * if (isConnected) {\n *   return <div>Connected: {publicAddress}</div>;\n * }\n * ```\n */\nexport function useAccount() {\n  const { subscribe, getSnapshot, getServerSnapshot } = useAurumContext();\n\n  const account = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n\n  return {\n    publicAddress: account.publicAddress,\n    walletName: account.walletName,\n    walletId: account.walletId,\n    email: account.email,\n    isConnected: account.isConnected,\n    isInitializing: account.isInitializing,\n  };\n}\n","'use client';\n\nimport { useState, useCallback } from 'react';\nimport { useAurumContext } from '@src/AurumContext';\nimport type { WalletId, WalletConnectSessionResult } from '@aurum-sdk/types';\n\n/**\n * Connect to a wallet.\n *\n * @example\n * ```tsx\n * const { connect, emailAuthStart, emailAuthVerify, getWalletConnectSession, isPending, error } = useConnect();\n *\n * // Open wallet selection modal\n * await connect();\n *\n * // Or connect directly to a specific wallet\n * await connect(WalletId.MetaMask);\n *\n * // Or use headless email auth\n * const { flowId } = await emailAuthStart('user@example.com');\n * const { address, email } = await emailAuthVerify(flowId, '123456');\n *\n * // Or use headless WalletConnect\n * const { uri, waitForConnection } = await getWalletConnectSession();\n * // Display your own QR code with `uri`\n * const address = await waitForConnection();\n * ```\n */\nexport function useConnect() {\n  const { aurum } = useAurumContext();\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const connect = useCallback(\n    async (walletId?: WalletId) => {\n      setIsPending(true);\n      setError(null);\n\n      try {\n        const address = await aurum.connect(walletId);\n        return address;\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('User rejected connection');\n        setError(error);\n        throw error;\n      } finally {\n        setIsPending(false);\n      }\n    },\n    [aurum],\n  );\n\n  const emailAuthStart = useCallback(\n    async (email: string) => {\n      setIsPending(true);\n      setError(null);\n\n      try {\n        const result = await aurum.emailAuthStart(email);\n        return result;\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('Failed to start email auth');\n        setError(error);\n        throw error;\n      } finally {\n        setIsPending(false);\n      }\n    },\n    [aurum],\n  );\n\n  const emailAuthVerify = useCallback(\n    async (flowId: string, otp: string) => {\n      setIsPending(true);\n      setError(null);\n\n      try {\n        const result = await aurum.emailAuthVerify(flowId, otp);\n        return result;\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('Failed to verify email');\n        setError(error);\n        throw error;\n      } finally {\n        setIsPending(false);\n      }\n    },\n    [aurum],\n  );\n\n  const getWalletConnectSession = useCallback(async (): Promise<WalletConnectSessionResult> => {\n    setIsPending(true);\n    setError(null);\n\n    try {\n      const result = await aurum.getWalletConnectSession();\n      return result;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error('Failed to get WalletConnect session');\n      setError(error);\n      throw error;\n    } finally {\n      setIsPending(false);\n    }\n  }, [aurum]);\n\n  return {\n    connect,\n    emailAuthStart,\n    emailAuthVerify,\n    getWalletConnectSession,\n    isPending,\n    error,\n  };\n}\n","'use client';\n\nimport { useCallback } from 'react';\nimport { useAurumContext } from '@src/AurumContext';\n\n/**\n * Disconnect the current wallet.\n *\n * @example\n * ```tsx\n * const { disconnect } = useDisconnect();\n *\n * return <button onClick={disconnect}>Disconnect</button>;\n * ```\n */\nexport function useDisconnect() {\n  const { aurum } = useAurumContext();\n\n  const disconnect = useCallback(async () => {\n    await aurum.disconnect();\n  }, [aurum]);\n\n  return { disconnect };\n}\n","'use client';\n\nimport { useState, useCallback, useEffect } from 'react';\nimport type { Chain } from 'viem';\nimport { useAurumContext } from '@src/AurumContext';\n\n/**\n * Access chain information and switch chains.\n *\n * @example\n * ```tsx\n * import { sepolia } from 'viem/chains';\n *\n * const { chainId, switchChain, error } = useChain();\n *\n * return (\n *   <div>\n *     <p>Chain ID: {chainId}</p>\n *     <button onClick={() => switchChain(sepolia.id, sepolia)}>\n *       Switch to Sepolia\n *     </button>\n *   </div>\n * );\n * ```\n */\nexport function useChain() {\n  const { aurum, isReady } = useAurumContext();\n  const [chainId, setChainId] = useState<number | null>(null);\n  const [error, setError] = useState<Error | null>(null);\n\n  // Fetch initial chain ID when ready\n  useEffect(() => {\n    if (!isReady) return;\n\n    const fetchChainId = async () => {\n      try {\n        const id = await aurum.getChainId();\n        setChainId(id);\n      } catch {\n        // Not connected or error fetching chain ID\n        setChainId(null);\n      }\n    };\n\n    fetchChainId();\n\n    // Listen for chain changes\n    const handleChainChanged = (newChainId: number | string) => {\n      setChainId(Number(newChainId));\n    };\n\n    aurum.rpcProvider?.on?.('chainChanged', handleChainChanged);\n\n    return () => {\n      aurum.rpcProvider?.removeListener?.('chainChanged', handleChainChanged);\n    };\n  }, [aurum, isReady]);\n\n  const switchChain = useCallback(\n    async (targetChainId: number | string | `0x${string}`, chain?: Chain) => {\n      if (!targetChainId) {\n        throw new Error('chainId is required');\n      }\n      setError(null);\n\n      try {\n        await aurum.switchChain(targetChainId as `0x${string}` | string | number, chain);\n        // Chain ID will be updated via the chainChanged event listener\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('Failed to switch chain');\n        setError(error);\n        throw error;\n      }\n    },\n    [aurum],\n  );\n\n  return { chainId, switchChain, error };\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,244 @@
+import { createContext, useState, useRef, useCallback, useEffect, useMemo, useSyncExternalStore, useContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// src/AurumProvider.tsx
+var initialAccountState = {
+  publicAddress: void 0,
+  walletName: void 0,
+  walletId: void 0,
+  email: void 0,
+  isConnected: false,
+  isInitializing: true
+};
+var AurumContext = createContext(null);
+function useAurumContext() {
+  const context = useContext(AurumContext);
+  if (!context) {
+    throw new Error("useAurumContext must be used within a AurumProvider");
+  }
+  return context;
+}
+function AurumProvider({ aurum, children }) {
+  const [isReady, setIsReady] = useState(false);
+  const accountStateRef = useRef(initialAccountState);
+  const listenersRef = useRef(/* @__PURE__ */ new Set());
+  const notifyListeners = useCallback(() => {
+    listenersRef.current.forEach((listener) => listener());
+  }, []);
+  const syncState = useCallback(async () => {
+    try {
+      const userInfo = await aurum.getUserInfo();
+      const isConnected = await aurum.isConnected();
+      const newState = {
+        publicAddress: userInfo?.publicAddress,
+        walletName: userInfo?.walletName,
+        walletId: userInfo?.walletId,
+        email: userInfo?.email,
+        isConnected,
+        isInitializing: false
+      };
+      accountStateRef.current = newState;
+      notifyListeners();
+    } catch {
+      accountStateRef.current = {
+        ...initialAccountState,
+        isInitializing: false
+      };
+      notifyListeners();
+    }
+  }, [aurum, notifyListeners]);
+  useEffect(() => {
+    let mounted = true;
+    const initialize = async () => {
+      await aurum.whenReady();
+      if (!mounted) return;
+      setIsReady(true);
+      await syncState();
+    };
+    initialize();
+    const handleAccountsChanged = () => {
+      if (mounted) syncState();
+    };
+    const handleChainChanged = () => {
+      if (mounted) syncState();
+    };
+    aurum.rpcProvider?.on?.("accountsChanged", handleAccountsChanged);
+    aurum.rpcProvider?.on?.("chainChanged", handleChainChanged);
+    return () => {
+      mounted = false;
+      aurum.rpcProvider?.removeListener?.("accountsChanged", handleAccountsChanged);
+      aurum.rpcProvider?.removeListener?.("chainChanged", handleChainChanged);
+    };
+  }, [aurum, syncState]);
+  const subscribe = useCallback((callback) => {
+    listenersRef.current.add(callback);
+    return () => {
+      listenersRef.current.delete(callback);
+    };
+  }, []);
+  const getSnapshot = useCallback(() => {
+    return accountStateRef.current;
+  }, []);
+  const getServerSnapshot = useCallback(() => {
+    return initialAccountState;
+  }, []);
+  const contextValue = useMemo(
+    () => ({
+      aurum,
+      isReady,
+      subscribe,
+      getSnapshot,
+      getServerSnapshot
+    }),
+    [aurum, isReady, subscribe, getSnapshot, getServerSnapshot]
+  );
+  return /* @__PURE__ */ jsx(AurumContext.Provider, { value: contextValue, children });
+}
+
+// src/hooks/useAurum.ts
+function useAurum() {
+  const { aurum, isReady } = useAurumContext();
+  return { aurum, isReady };
+}
+function useAccount() {
+  const { subscribe, getSnapshot, getServerSnapshot } = useAurumContext();
+  const account = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+  return {
+    publicAddress: account.publicAddress,
+    walletName: account.walletName,
+    walletId: account.walletId,
+    email: account.email,
+    isConnected: account.isConnected,
+    isInitializing: account.isInitializing
+  };
+}
+function useConnect() {
+  const { aurum } = useAurumContext();
+  const [isPending, setIsPending] = useState(false);
+  const [error, setError] = useState(null);
+  const connect = useCallback(
+    async (walletId) => {
+      setIsPending(true);
+      setError(null);
+      try {
+        const address = await aurum.connect(walletId);
+        return address;
+      } catch (err) {
+        const error2 = err instanceof Error ? err : new Error("User rejected connection");
+        setError(error2);
+        throw error2;
+      } finally {
+        setIsPending(false);
+      }
+    },
+    [aurum]
+  );
+  const emailAuthStart = useCallback(
+    async (email) => {
+      setIsPending(true);
+      setError(null);
+      try {
+        const result = await aurum.emailAuthStart(email);
+        return result;
+      } catch (err) {
+        const error2 = err instanceof Error ? err : new Error("Failed to start email auth");
+        setError(error2);
+        throw error2;
+      } finally {
+        setIsPending(false);
+      }
+    },
+    [aurum]
+  );
+  const emailAuthVerify = useCallback(
+    async (flowId, otp) => {
+      setIsPending(true);
+      setError(null);
+      try {
+        const result = await aurum.emailAuthVerify(flowId, otp);
+        return result;
+      } catch (err) {
+        const error2 = err instanceof Error ? err : new Error("Failed to verify email");
+        setError(error2);
+        throw error2;
+      } finally {
+        setIsPending(false);
+      }
+    },
+    [aurum]
+  );
+  const getWalletConnectSession = useCallback(async () => {
+    setIsPending(true);
+    setError(null);
+    try {
+      const result = await aurum.getWalletConnectSession();
+      return result;
+    } catch (err) {
+      const error2 = err instanceof Error ? err : new Error("Failed to get WalletConnect session");
+      setError(error2);
+      throw error2;
+    } finally {
+      setIsPending(false);
+    }
+  }, [aurum]);
+  return {
+    connect,
+    emailAuthStart,
+    emailAuthVerify,
+    getWalletConnectSession,
+    isPending,
+    error
+  };
+}
+function useDisconnect() {
+  const { aurum } = useAurumContext();
+  const disconnect = useCallback(async () => {
+    await aurum.disconnect();
+  }, [aurum]);
+  return { disconnect };
+}
+function useChain() {
+  const { aurum, isReady } = useAurumContext();
+  const [chainId, setChainId] = useState(null);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    if (!isReady) return;
+    const fetchChainId = async () => {
+      try {
+        const id = await aurum.getChainId();
+        setChainId(id);
+      } catch {
+        setChainId(null);
+      }
+    };
+    fetchChainId();
+    const handleChainChanged = (newChainId) => {
+      setChainId(Number(newChainId));
+    };
+    aurum.rpcProvider?.on?.("chainChanged", handleChainChanged);
+    return () => {
+      aurum.rpcProvider?.removeListener?.("chainChanged", handleChainChanged);
+    };
+  }, [aurum, isReady]);
+  const switchChain = useCallback(
+    async (targetChainId, chain) => {
+      if (!targetChainId) {
+        throw new Error("chainId is required");
+      }
+      setError(null);
+      try {
+        await aurum.switchChain(targetChainId, chain);
+      } catch (err) {
+        const error2 = err instanceof Error ? err : new Error("Failed to switch chain");
+        setError(error2);
+        throw error2;
+      }
+    },
+    [aurum]
+  );
+  return { chainId, switchChain, error };
+}
+
+export { AurumProvider, useAccount, useAurum, useChain, useConnect, useDisconnect };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/AurumContext.ts","../src/AurumProvider.tsx","../src/hooks/useAurum.ts","../src/hooks/useAccount.ts","../src/hooks/useConnect.ts","../src/hooks/useDisconnect.ts","../src/hooks/useChain.ts"],"names":["useState","useCallback","error","useEffect"],"mappings":"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","file":"index.mjs","sourcesContent":["'use client';\n\nimport { createContext, useContext } from 'react';\nimport type { Aurum } from '@aurum-sdk/core';\nimport type { WalletId, WalletName } from '@aurum-sdk/types';\n\nexport interface AccountState {\n  publicAddress: string | undefined;\n  walletName: WalletName | undefined;\n  walletId: WalletId | undefined;\n  email: string | undefined;\n  isConnected: boolean;\n  isInitializing: boolean;\n}\n\ninterface AurumContextValue {\n  aurum: Aurum;\n  isReady: boolean;\n  subscribe: (callback: () => void) => () => void;\n  getSnapshot: () => AccountState;\n  getServerSnapshot: () => AccountState;\n}\n\nexport const initialAccountState: AccountState = {\n  publicAddress: undefined,\n  walletName: undefined,\n  walletId: undefined,\n  email: undefined,\n  isConnected: false,\n  isInitializing: true,\n};\n\nexport const AurumContext = createContext<AurumContextValue | null>(null);\n\nexport function useAurumContext(): AurumContextValue {\n  const context = useContext(AurumContext);\n  if (!context) {\n    throw new Error('useAurumContext must be used within a AurumProvider');\n  }\n  return context;\n}\n","'use client';\n\nimport { useRef, useEffect, useCallback, useState, useMemo, type ReactNode } from 'react';\nimport { AurumContext, initialAccountState, type AccountState } from '@src/AurumContext';\nimport type { Aurum } from '@aurum-sdk/core';\n\ninterface AurumProviderProps {\n  aurum: Aurum;\n  children: ReactNode;\n}\n\nexport function AurumProvider({ aurum, children }: AurumProviderProps) {\n  const [isReady, setIsReady] = useState(false);\n  const accountStateRef = useRef<AccountState>(initialAccountState);\n  const listenersRef = useRef<Set<() => void>>(new Set());\n\n  // Notify all subscribers of state changes\n  const notifyListeners = useCallback(() => {\n    listenersRef.current.forEach((listener) => listener());\n  }, []);\n\n  // Sync state from SDK\n  const syncState = useCallback(async () => {\n    try {\n      const userInfo = await aurum.getUserInfo();\n      const isConnected = await aurum.isConnected();\n\n      const newState: AccountState = {\n        publicAddress: userInfo?.publicAddress,\n        walletName: userInfo?.walletName,\n        walletId: userInfo?.walletId,\n        email: userInfo?.email,\n        isConnected,\n        isInitializing: false,\n      };\n\n      accountStateRef.current = newState;\n      notifyListeners();\n    } catch {\n      accountStateRef.current = {\n        ...initialAccountState,\n        isInitializing: false,\n      };\n      notifyListeners();\n    }\n  }, [aurum, notifyListeners]);\n\n  // Initialize SDK and set up event listeners\n  useEffect(() => {\n    let mounted = true;\n\n    const initialize = async () => {\n      await aurum.whenReady();\n      if (!mounted) return;\n\n      setIsReady(true);\n      await syncState();\n    };\n\n    initialize();\n\n    // Subscribe to provider events for account changes\n    const handleAccountsChanged = () => {\n      if (mounted) syncState();\n    };\n\n    const handleChainChanged = () => {\n      if (mounted) syncState();\n    };\n\n    aurum.rpcProvider?.on?.('accountsChanged', handleAccountsChanged);\n    aurum.rpcProvider?.on?.('chainChanged', handleChainChanged);\n\n    return () => {\n      mounted = false;\n      aurum.rpcProvider?.removeListener?.('accountsChanged', handleAccountsChanged);\n      aurum.rpcProvider?.removeListener?.('chainChanged', handleChainChanged);\n    };\n  }, [aurum, syncState]);\n\n  // Subscribe function for useSyncExternalStore\n  const subscribe = useCallback((callback: () => void) => {\n    listenersRef.current.add(callback);\n    return () => {\n      listenersRef.current.delete(callback);\n    };\n  }, []);\n\n  // Get current snapshot for useSyncExternalStore\n  const getSnapshot = useCallback(() => {\n    return accountStateRef.current;\n  }, []);\n\n  // Server snapshot - always returns initial state\n  const getServerSnapshot = useCallback(() => {\n    return initialAccountState;\n  }, []);\n\n  const contextValue = useMemo(\n    () => ({\n      aurum,\n      isReady,\n      subscribe,\n      getSnapshot,\n      getServerSnapshot,\n    }),\n    [aurum, isReady, subscribe, getSnapshot, getServerSnapshot],\n  );\n\n  return <AurumContext.Provider value={contextValue}>{children}</AurumContext.Provider>;\n}\n","'use client';\n\nimport { useAurumContext } from '@src/AurumContext';\n\n/**\n * Access the raw Aurum SDK instance.\n *\n * @example\n * ```tsx\n * const { aurum, isReady } = useAurum();\n *\n * if (isReady) {\n *   const chainId = await aurum.getChainId();\n * }\n * ```\n */\nexport function useAurum() {\n  const { aurum, isReady } = useAurumContext();\n  return { aurum, isReady };\n}\n","'use client';\n\nimport { useSyncExternalStore } from 'react';\nimport { useAurumContext } from '@src/AurumContext';\n\n/**\n * Access connected user information.\n *\n * @example\n * ```tsx\n * const { publicAddress, walletName, isConnected, isInitializing } = useAccount();\n *\n * if (isInitializing) return <div>Loading...</div>;\n *\n * if (isConnected) {\n *   return <div>Connected: {publicAddress}</div>;\n * }\n * ```\n */\nexport function useAccount() {\n  const { subscribe, getSnapshot, getServerSnapshot } = useAurumContext();\n\n  const account = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n\n  return {\n    publicAddress: account.publicAddress,\n    walletName: account.walletName,\n    walletId: account.walletId,\n    email: account.email,\n    isConnected: account.isConnected,\n    isInitializing: account.isInitializing,\n  };\n}\n","'use client';\n\nimport { useState, useCallback } from 'react';\nimport { useAurumContext } from '@src/AurumContext';\nimport type { WalletId, WalletConnectSessionResult } from '@aurum-sdk/types';\n\n/**\n * Connect to a wallet.\n *\n * @example\n * ```tsx\n * const { connect, emailAuthStart, emailAuthVerify, getWalletConnectSession, isPending, error } = useConnect();\n *\n * // Open wallet selection modal\n * await connect();\n *\n * // Or connect directly to a specific wallet\n * await connect(WalletId.MetaMask);\n *\n * // Or use headless email auth\n * const { flowId } = await emailAuthStart('user@example.com');\n * const { address, email } = await emailAuthVerify(flowId, '123456');\n *\n * // Or use headless WalletConnect\n * const { uri, waitForConnection } = await getWalletConnectSession();\n * // Display your own QR code with `uri`\n * const address = await waitForConnection();\n * ```\n */\nexport function useConnect() {\n  const { aurum } = useAurumContext();\n\n  const [isPending, setIsPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const connect = useCallback(\n    async (walletId?: WalletId) => {\n      setIsPending(true);\n      setError(null);\n\n      try {\n        const address = await aurum.connect(walletId);\n        return address;\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('User rejected connection');\n        setError(error);\n        throw error;\n      } finally {\n        setIsPending(false);\n      }\n    },\n    [aurum],\n  );\n\n  const emailAuthStart = useCallback(\n    async (email: string) => {\n      setIsPending(true);\n      setError(null);\n\n      try {\n        const result = await aurum.emailAuthStart(email);\n        return result;\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('Failed to start email auth');\n        setError(error);\n        throw error;\n      } finally {\n        setIsPending(false);\n      }\n    },\n    [aurum],\n  );\n\n  const emailAuthVerify = useCallback(\n    async (flowId: string, otp: string) => {\n      setIsPending(true);\n      setError(null);\n\n      try {\n        const result = await aurum.emailAuthVerify(flowId, otp);\n        return result;\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('Failed to verify email');\n        setError(error);\n        throw error;\n      } finally {\n        setIsPending(false);\n      }\n    },\n    [aurum],\n  );\n\n  const getWalletConnectSession = useCallback(async (): Promise<WalletConnectSessionResult> => {\n    setIsPending(true);\n    setError(null);\n\n    try {\n      const result = await aurum.getWalletConnectSession();\n      return result;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error('Failed to get WalletConnect session');\n      setError(error);\n      throw error;\n    } finally {\n      setIsPending(false);\n    }\n  }, [aurum]);\n\n  return {\n    connect,\n    emailAuthStart,\n    emailAuthVerify,\n    getWalletConnectSession,\n    isPending,\n    error,\n  };\n}\n","'use client';\n\nimport { useCallback } from 'react';\nimport { useAurumContext } from '@src/AurumContext';\n\n/**\n * Disconnect the current wallet.\n *\n * @example\n * ```tsx\n * const { disconnect } = useDisconnect();\n *\n * return <button onClick={disconnect}>Disconnect</button>;\n * ```\n */\nexport function useDisconnect() {\n  const { aurum } = useAurumContext();\n\n  const disconnect = useCallback(async () => {\n    await aurum.disconnect();\n  }, [aurum]);\n\n  return { disconnect };\n}\n","'use client';\n\nimport { useState, useCallback, useEffect } from 'react';\nimport type { Chain } from 'viem';\nimport { useAurumContext } from '@src/AurumContext';\n\n/**\n * Access chain information and switch chains.\n *\n * @example\n * ```tsx\n * import { sepolia } from 'viem/chains';\n *\n * const { chainId, switchChain, error } = useChain();\n *\n * return (\n *   <div>\n *     <p>Chain ID: {chainId}</p>\n *     <button onClick={() => switchChain(sepolia.id, sepolia)}>\n *       Switch to Sepolia\n *     </button>\n *   </div>\n * );\n * ```\n */\nexport function useChain() {\n  const { aurum, isReady } = useAurumContext();\n  const [chainId, setChainId] = useState<number | null>(null);\n  const [error, setError] = useState<Error | null>(null);\n\n  // Fetch initial chain ID when ready\n  useEffect(() => {\n    if (!isReady) return;\n\n    const fetchChainId = async () => {\n      try {\n        const id = await aurum.getChainId();\n        setChainId(id);\n      } catch {\n        // Not connected or error fetching chain ID\n        setChainId(null);\n      }\n    };\n\n    fetchChainId();\n\n    // Listen for chain changes\n    const handleChainChanged = (newChainId: number | string) => {\n      setChainId(Number(newChainId));\n    };\n\n    aurum.rpcProvider?.on?.('chainChanged', handleChainChanged);\n\n    return () => {\n      aurum.rpcProvider?.removeListener?.('chainChanged', handleChainChanged);\n    };\n  }, [aurum, isReady]);\n\n  const switchChain = useCallback(\n    async (targetChainId: number | string | `0x${string}`, chain?: Chain) => {\n      if (!targetChainId) {\n        throw new Error('chainId is required');\n      }\n      setError(null);\n\n      try {\n        await aurum.switchChain(targetChainId as `0x${string}` | string | number, chain);\n        // Chain ID will be updated via the chainChanged event listener\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error('Failed to switch chain');\n        setError(error);\n        throw error;\n      }\n    },\n    [aurum],\n  );\n\n  return { chainId, switchChain, error };\n}\n"]}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@aurum-sdk/hooks",
+  "version": "0.1.0",
+  "description": "React hooks for Aurum SDK",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=18.0.0",
+    "pnpm": ">=8.0.0"
+  },
+  "packageManager": "pnpm@8.15.0",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "pnpm build"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "viem": ">=2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "viem": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@aurum-sdk/core": "workspace:^",
+    "@aurum-sdk/types": "workspace:^"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "^18.0.0",
+    "@vitest/coverage-v8": "^2.1.0",
+    "jsdom": "^25.0.0",
+    "react": "^19.2.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "viem": "^2.42.1",
+    "vitest": "^2.1.0"
+  },
+  "keywords": [
+    "react",
+    "hooks",
+    "wallet",
+    "ethereum",
+    "web3",
+    "aurum"
+  ],
+  "author": "Hunter Cote",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aurum-sdk/aurum.git",
+    "directory": "packages/hooks"
+  },
+  "homepage": "https://github.com/aurum-sdk/aurum#readme"
+}