@phantom/react-native-sdk 0.1.4 → 0.1.6

package/README.md

@@ -99,7 +99,6 @@ export default function App() {
           redirectUrl: "mywalletapp://phantom-auth-callback",
         },
         appName: "My Wallet App", // Optional branding
-        debug: false, // Optional debug logging
       }}
     >
       <YourAppContent />
@@ -193,7 +192,7 @@ interface PhantomSDKConfig {
   organizationId: string; // Your Phantom organization ID
   scheme: string; // Custom URL scheme for your app
   embeddedWalletType: "user-wallet" | "app-wallet";
-  addressTypes: AddressType[]; // e.g., [AddressType.solana]
+  addressTypes: [AddressType, ...AddressType[]]; // e.g., [AddressType.solana]
   apiBaseUrl: string; // e.g., "https://api.phantom.app/v1/wallets"
   solanaProvider: "web3js" | "kit"; // Solana provider to use
   authOptions?: {
@@ -202,7 +201,7 @@ interface PhantomSDKConfig {
   };
   appName?: string; // Optional app name for branding
   appLogo?: string; // Optional app logo URL for branding
-  debug?: boolean; // Enable debug logging (optional)
+  autoConnect?: boolean; // Auto-connect to existing session on SDK instantiation (default: true)
 }
 ```
 
@@ -421,19 +420,40 @@ adb shell am start -W -a android.intent.action.VIEW -d "myapp://phantom-auth-cal
    - Verify URL scheme configuration
    - Check intent filters (Android) or URL schemes (iOS)
 
-### Debug Mode
+### Debug Configuration
 
-Enable debug logging in development:
+The React Native SDK supports separate debug configuration for better performance and dynamic control:
 
 ```typescript
-<PhantomProvider
-  config={{
-    ...config,
-    debug: true  // Enable debug logging
-  }}
->
-  <App />
-</PhantomProvider>
+import { PhantomProvider, type PhantomSDKConfig, type PhantomDebugConfig } from "@phantom/react-native-sdk";
+
+function App() {
+  // SDK configuration - static, won't change when debug settings change
+  const config: PhantomSDKConfig = {
+    organizationId: "your-org-id",
+    scheme: "mywalletapp",
+    // ... other config
+  };
+
+  // Debug configuration - separate to avoid SDK reinstantiation
+  const debugConfig: PhantomDebugConfig = {
+    enabled: true, // Enable debug logging
+  };
+
+  return (
+    <PhantomProvider config={config} debugConfig={debugConfig}>
+      <App />
+    </PhantomProvider>
+  );
+}
+```
+
+**PhantomDebugConfig Interface:**
+
+```typescript
+interface PhantomDebugConfig {
+  enabled?: boolean; // Enable debug logging (default: false)
+}
 ```
 
 ## Support

package/dist/index.d.ts

@@ -6,11 +6,15 @@ export { ConnectResult, SignAndSendTransactionParams, SignMessageParams, SignMes
 export { AddressType } from '@phantom/client';
 export { NetworkId } from '@phantom/constants';
 
+interface PhantomDebugConfig {
+    /** Enable debug logging */
+    enabled?: boolean;
+}
 interface PhantomSDKConfig extends EmbeddedProviderConfig {
     /** Custom URL scheme for your app (e.g., "myapp") */
     scheme: string;
-    /** Enable debug logging */
-    debug?: boolean;
+    /** Enable auto-connect to existing sessions (default: true) */
+    autoConnect?: boolean;
 }
 interface ConnectOptions {
     /** OAuth provider to use */
@@ -22,19 +26,20 @@ interface ConnectOptions {
 }
 
 interface PhantomContextValue {
-    sdk: EmbeddedProvider;
+    sdk: EmbeddedProvider | null;
     isConnected: boolean;
+    isConnecting: boolean;
+    connectError: Error | null;
     addresses: WalletAddress[];
     walletId: string | null;
-    error: Error | null;
-    updateConnectionState: () => void;
     setWalletId: (walletId: string | null) => void;
 }
 interface PhantomProviderProps {
     children: ReactNode;
     config: PhantomSDKConfig;
+    debugConfig?: PhantomDebugConfig;
 }
-declare function PhantomProvider({ children, config }: PhantomProviderProps): react_jsx_runtime.JSX.Element;
+declare function PhantomProvider({ children, config, debugConfig }: PhantomProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Hook to access the Phantom context
  * Must be used within a PhantomProvider
@@ -57,7 +62,6 @@ declare function useAccounts(): {
     addresses: _phantom_embedded_provider_core.WalletAddress[];
     isConnected: boolean;
     walletId: string | null;
-    error: Error | null;
 };
 
 declare function useSignMessage(): {
@@ -72,4 +76,4 @@ declare function useSignAndSendTransaction(): {
     error: Error | null;
 };
 
-export { ConnectOptions, PhantomProvider, PhantomSDKConfig, useAccounts, useConnect, useDisconnect, usePhantom, useSignAndSendTransaction, useSignMessage };
+export { ConnectOptions, PhantomDebugConfig, PhantomProvider, PhantomSDKConfig, useAccounts, useConnect, useDisconnect, usePhantom, useSignAndSendTransaction, useSignMessage };

package/dist/index.js

@@ -418,30 +418,31 @@ var ReactNativeStamper = class {
 var import_react_native2 = require("react-native");
 var import_jsx_runtime = require("react/jsx-runtime");
 var PhantomContext = (0, import_react.createContext)(void 0);
-function PhantomProvider({ children, config }) {
-  const sdk = (0, import_react.useMemo)(() => {
+function PhantomProvider({ children, config, debugConfig }) {
+  const [isConnected, setIsConnected] = (0, import_react.useState)(false);
+  const [isConnecting, setIsConnecting] = (0, import_react.useState)(false);
+  const [connectError, setConnectError] = (0, import_react.useState)(null);
+  const [addresses, setAddresses] = (0, import_react.useState)([]);
+  const [walletId, setWalletId] = (0, import_react.useState)(null);
+  const [sdk, setSdk] = (0, import_react.useState)(null);
+  const memoizedConfig = (0, import_react.useMemo)(() => {
     const redirectUrl = config.authOptions?.redirectUrl || `${config.scheme}://phantom-auth-callback`;
-    const embeddedConfig = {
-      apiBaseUrl: config.apiBaseUrl,
-      organizationId: config.organizationId,
+    return {
+      ...config,
       authOptions: {
-        ...config.authOptions,
+        ...config.authOptions || {},
         redirectUrl
-      },
-      embeddedWalletType: config.embeddedWalletType,
-      addressTypes: config.addressTypes,
-      solanaProvider: config.solanaProvider || "web3js",
-      appName: config.appName,
-      appLogo: config.appLogo
-      // Optional app logo URL
+      }
     };
+  }, [config]);
+  (0, import_react.useEffect)(() => {
     const storage = new ExpoSecureStorage();
     const authProvider = new ExpoAuthProvider();
     const urlParamsAccessor = new ExpoURLParamsAccessor();
-    const logger = new ExpoLogger(config.debug);
+    const logger = new ExpoLogger(debugConfig?.enabled || false);
     const stamper = new ReactNativeStamper({
-      keyPrefix: `phantom-rn-${config.organizationId}`,
-      organizationId: config.organizationId
+      keyPrefix: `phantom-rn-${memoizedConfig.organizationId}`,
+      organizationId: memoizedConfig.organizationId
     });
     const platform = {
       storage,
@@ -450,56 +451,74 @@ function PhantomProvider({ children, config }) {
       stamper,
       name: `${import_react_native2.Platform.OS}-${import_react_native2.Platform.Version}`
     };
-    return new import_embedded_provider_core.EmbeddedProvider(embeddedConfig, platform, logger);
-  }, [config]);
-  const [isConnected, setIsConnected] = (0, import_react.useState)(false);
-  const [addresses, setAddresses] = (0, import_react.useState)([]);
-  const [walletId, setWalletId] = (0, import_react.useState)(null);
-  const [error, setError] = (0, import_react.useState)(null);
-  const updateConnectionState = (0, import_react.useCallback)(() => {
-    try {
-      const connected = sdk.isConnected();
-      setIsConnected(connected);
-      if (connected) {
-        const addrs = sdk.getAddresses();
-        setAddresses(addrs);
-      } else {
-        setAddresses([]);
-        setWalletId(null);
-      }
-    } catch (err) {
-      console.error("[PhantomProvider] Error updating connection state", err);
-      setError(err);
+    const sdkInstance = new import_embedded_provider_core.EmbeddedProvider(memoizedConfig, platform, logger);
+    const handleConnectStart = () => {
+      setIsConnecting(true);
+      setConnectError(null);
+    };
+    const handleConnect = async () => {
       try {
-        sdk.disconnect();
-        setIsConnected(false);
-        setAddresses([]);
-        setWalletId(null);
-      } catch (disconnectErr) {
-        console.error("[PhantomProvider] Error disconnecting after error", disconnectErr);
+        setIsConnected(true);
+        setIsConnecting(false);
+        const addrs = await sdkInstance.getAddresses();
+        setAddresses(addrs);
+      } catch (err) {
+        console.error("Error connecting:", err);
+        try {
+          await sdkInstance.disconnect();
+        } catch (err2) {
+          console.error("Error disconnecting:", err2);
+        }
       }
-    }
-  }, [sdk]);
+    };
+    const handleConnectError = (errorData) => {
+      setIsConnecting(false);
+      setConnectError(new Error(errorData.error || "Connection failed"));
+    };
+    const handleDisconnect = () => {
+      setIsConnected(false);
+      setIsConnecting(false);
+      setConnectError(null);
+      setAddresses([]);
+      setWalletId(null);
+    };
+    sdkInstance.on("connect_start", handleConnectStart);
+    sdkInstance.on("connect", handleConnect);
+    sdkInstance.on("connect_error", handleConnectError);
+    sdkInstance.on("disconnect", handleDisconnect);
+    setSdk(sdkInstance);
+    return () => {
+      sdkInstance.off("connect_start", handleConnectStart);
+      sdkInstance.off("connect", handleConnect);
+      sdkInstance.off("connect_error", handleConnectError);
+      sdkInstance.off("disconnect", handleDisconnect);
+    };
+  }, [memoizedConfig, debugConfig]);
   (0, import_react.useEffect)(() => {
-    updateConnectionState();
-  }, [updateConnectionState]);
+    if (!sdk)
+      return;
+    if (config.autoConnect !== false) {
+      sdk.autoConnect().catch(() => {
+      });
+    }
+  }, [sdk, config.autoConnect]);
   const value = (0, import_react.useMemo)(
     () => ({
       sdk,
       isConnected,
+      isConnecting,
+      connectError,
       addresses,
       walletId,
-      error,
-      updateConnectionState,
       setWalletId
     }),
     [
       sdk,
       isConnected,
+      isConnecting,
+      connectError,
       addresses,
       walletId,
-      error,
-      updateConnectionState,
       setWalletId
     ]
   );
@@ -516,46 +535,36 @@ function usePhantom() {
 // src/hooks/useConnect.ts
 var import_react2 = require("react");
 function useConnect() {
-  const { sdk, updateConnectionState, setWalletId } = usePhantom();
-  const [isConnecting, setIsConnecting] = (0, import_react2.useState)(false);
-  const [error, setError] = (0, import_react2.useState)(null);
+  const { sdk, isConnecting, connectError, setWalletId } = usePhantom();
   const connect = (0, import_react2.useCallback)(
     async (options) => {
       if (!sdk) {
         throw new Error("SDK not initialized");
       }
-      setIsConnecting(true);
-      setError(null);
       try {
         const result = await sdk.connect(options);
-        if (result.status === "completed") {
-          if (result.walletId) {
-            setWalletId(result.walletId);
-          }
-          updateConnectionState();
+        if (result.status === "completed" && result.walletId) {
+          setWalletId(result.walletId);
         }
         return result;
       } catch (err) {
-        const error2 = err;
-        setError(error2);
-        throw error2;
-      } finally {
-        setIsConnecting(false);
+        const error = err;
+        throw error;
       }
     },
-    [sdk, updateConnectionState, setWalletId]
+    [sdk, setWalletId]
   );
   return {
     connect,
     isConnecting,
-    error
+    error: connectError
   };
 }
 
 // src/hooks/useDisconnect.ts
 var import_react3 = require("react");
 function useDisconnect() {
-  const { sdk, updateConnectionState } = usePhantom();
+  const { sdk } = usePhantom();
   const [isDisconnecting, setIsDisconnecting] = (0, import_react3.useState)(false);
   const [error, setError] = (0, import_react3.useState)(null);
   const disconnect = (0, import_react3.useCallback)(async () => {
@@ -566,7 +575,6 @@ function useDisconnect() {
     setError(null);
     try {
       await sdk.disconnect();
-      updateConnectionState();
     } catch (err) {
       const error2 = err;
       setError(error2);
@@ -574,7 +582,7 @@ function useDisconnect() {
     } finally {
       setIsDisconnecting(false);
     }
-  }, [sdk, updateConnectionState]);
+  }, [sdk]);
   return {
     disconnect,
     isDisconnecting,
@@ -584,12 +592,11 @@ function useDisconnect() {
 
 // src/hooks/useAccounts.ts
 function useAccounts() {
-  const { addresses, isConnected, walletId, error } = usePhantom();
+  const { addresses, isConnected, walletId } = usePhantom();
   return {
     addresses,
     isConnected,
-    walletId,
-    error
+    walletId
   };
 }
 

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // src/PhantomProvider.tsx
-import { createContext, useContext, useState, useEffect, useCallback, useMemo } from "react";
+import { createContext, useContext, useState, useEffect, useMemo } from "react";
 import { EmbeddedProvider } from "@phantom/embedded-provider-core";
 
 // src/providers/embedded/storage.ts
@@ -374,30 +374,31 @@ var ReactNativeStamper = class {
 import { Platform } from "react-native";
 import { jsx } from "react/jsx-runtime";
 var PhantomContext = createContext(void 0);
-function PhantomProvider({ children, config }) {
-  const sdk = useMemo(() => {
+function PhantomProvider({ children, config, debugConfig }) {
+  const [isConnected, setIsConnected] = useState(false);
+  const [isConnecting, setIsConnecting] = useState(false);
+  const [connectError, setConnectError] = useState(null);
+  const [addresses, setAddresses] = useState([]);
+  const [walletId, setWalletId] = useState(null);
+  const [sdk, setSdk] = useState(null);
+  const memoizedConfig = useMemo(() => {
     const redirectUrl = config.authOptions?.redirectUrl || `${config.scheme}://phantom-auth-callback`;
-    const embeddedConfig = {
-      apiBaseUrl: config.apiBaseUrl,
-      organizationId: config.organizationId,
+    return {
+      ...config,
       authOptions: {
-        ...config.authOptions,
+        ...config.authOptions || {},
         redirectUrl
-      },
-      embeddedWalletType: config.embeddedWalletType,
-      addressTypes: config.addressTypes,
-      solanaProvider: config.solanaProvider || "web3js",
-      appName: config.appName,
-      appLogo: config.appLogo
-      // Optional app logo URL
+      }
     };
+  }, [config]);
+  useEffect(() => {
     const storage = new ExpoSecureStorage();
     const authProvider = new ExpoAuthProvider();
     const urlParamsAccessor = new ExpoURLParamsAccessor();
-    const logger = new ExpoLogger(config.debug);
+    const logger = new ExpoLogger(debugConfig?.enabled || false);
     const stamper = new ReactNativeStamper({
-      keyPrefix: `phantom-rn-${config.organizationId}`,
-      organizationId: config.organizationId
+      keyPrefix: `phantom-rn-${memoizedConfig.organizationId}`,
+      organizationId: memoizedConfig.organizationId
     });
     const platform = {
       storage,
@@ -406,56 +407,74 @@ function PhantomProvider({ children, config }) {
       stamper,
       name: `${Platform.OS}-${Platform.Version}`
     };
-    return new EmbeddedProvider(embeddedConfig, platform, logger);
-  }, [config]);
-  const [isConnected, setIsConnected] = useState(false);
-  const [addresses, setAddresses] = useState([]);
-  const [walletId, setWalletId] = useState(null);
-  const [error, setError] = useState(null);
-  const updateConnectionState = useCallback(() => {
-    try {
-      const connected = sdk.isConnected();
-      setIsConnected(connected);
-      if (connected) {
-        const addrs = sdk.getAddresses();
-        setAddresses(addrs);
-      } else {
-        setAddresses([]);
-        setWalletId(null);
-      }
-    } catch (err) {
-      console.error("[PhantomProvider] Error updating connection state", err);
-      setError(err);
+    const sdkInstance = new EmbeddedProvider(memoizedConfig, platform, logger);
+    const handleConnectStart = () => {
+      setIsConnecting(true);
+      setConnectError(null);
+    };
+    const handleConnect = async () => {
       try {
-        sdk.disconnect();
-        setIsConnected(false);
-        setAddresses([]);
-        setWalletId(null);
-      } catch (disconnectErr) {
-        console.error("[PhantomProvider] Error disconnecting after error", disconnectErr);
+        setIsConnected(true);
+        setIsConnecting(false);
+        const addrs = await sdkInstance.getAddresses();
+        setAddresses(addrs);
+      } catch (err) {
+        console.error("Error connecting:", err);
+        try {
+          await sdkInstance.disconnect();
+        } catch (err2) {
+          console.error("Error disconnecting:", err2);
+        }
       }
-    }
-  }, [sdk]);
+    };
+    const handleConnectError = (errorData) => {
+      setIsConnecting(false);
+      setConnectError(new Error(errorData.error || "Connection failed"));
+    };
+    const handleDisconnect = () => {
+      setIsConnected(false);
+      setIsConnecting(false);
+      setConnectError(null);
+      setAddresses([]);
+      setWalletId(null);
+    };
+    sdkInstance.on("connect_start", handleConnectStart);
+    sdkInstance.on("connect", handleConnect);
+    sdkInstance.on("connect_error", handleConnectError);
+    sdkInstance.on("disconnect", handleDisconnect);
+    setSdk(sdkInstance);
+    return () => {
+      sdkInstance.off("connect_start", handleConnectStart);
+      sdkInstance.off("connect", handleConnect);
+      sdkInstance.off("connect_error", handleConnectError);
+      sdkInstance.off("disconnect", handleDisconnect);
+    };
+  }, [memoizedConfig, debugConfig]);
   useEffect(() => {
-    updateConnectionState();
-  }, [updateConnectionState]);
+    if (!sdk)
+      return;
+    if (config.autoConnect !== false) {
+      sdk.autoConnect().catch(() => {
+      });
+    }
+  }, [sdk, config.autoConnect]);
   const value = useMemo(
     () => ({
       sdk,
       isConnected,
+      isConnecting,
+      connectError,
       addresses,
       walletId,
-      error,
-      updateConnectionState,
       setWalletId
     }),
     [
       sdk,
       isConnected,
+      isConnecting,
+      connectError,
       addresses,
       walletId,
-      error,
-      updateConnectionState,
       setWalletId
     ]
   );
@@ -470,51 +489,41 @@ function usePhantom() {
 }
 
 // src/hooks/useConnect.ts
-import { useState as useState2, useCallback as useCallback2 } from "react";
+import { useCallback } from "react";
 function useConnect() {
-  const { sdk, updateConnectionState, setWalletId } = usePhantom();
-  const [isConnecting, setIsConnecting] = useState2(false);
-  const [error, setError] = useState2(null);
-  const connect = useCallback2(
+  const { sdk, isConnecting, connectError, setWalletId } = usePhantom();
+  const connect = useCallback(
     async (options) => {
       if (!sdk) {
         throw new Error("SDK not initialized");
       }
-      setIsConnecting(true);
-      setError(null);
       try {
         const result = await sdk.connect(options);
-        if (result.status === "completed") {
-          if (result.walletId) {
-            setWalletId(result.walletId);
-          }
-          updateConnectionState();
+        if (result.status === "completed" && result.walletId) {
+          setWalletId(result.walletId);
         }
         return result;
       } catch (err) {
-        const error2 = err;
-        setError(error2);
-        throw error2;
-      } finally {
-        setIsConnecting(false);
+        const error = err;
+        throw error;
       }
     },
-    [sdk, updateConnectionState, setWalletId]
+    [sdk, setWalletId]
   );
   return {
     connect,
     isConnecting,
-    error
+    error: connectError
   };
 }
 
 // src/hooks/useDisconnect.ts
-import { useState as useState3, useCallback as useCallback3 } from "react";
+import { useState as useState2, useCallback as useCallback2 } from "react";
 function useDisconnect() {
-  const { sdk, updateConnectionState } = usePhantom();
-  const [isDisconnecting, setIsDisconnecting] = useState3(false);
-  const [error, setError] = useState3(null);
-  const disconnect = useCallback3(async () => {
+  const { sdk } = usePhantom();
+  const [isDisconnecting, setIsDisconnecting] = useState2(false);
+  const [error, setError] = useState2(null);
+  const disconnect = useCallback2(async () => {
     if (!sdk) {
       throw new Error("SDK not initialized");
     }
@@ -522,7 +531,6 @@ function useDisconnect() {
     setError(null);
     try {
       await sdk.disconnect();
-      updateConnectionState();
     } catch (err) {
       const error2 = err;
       setError(error2);
@@ -530,7 +538,7 @@ function useDisconnect() {
     } finally {
       setIsDisconnecting(false);
     }
-  }, [sdk, updateConnectionState]);
+  }, [sdk]);
   return {
     disconnect,
     isDisconnecting,
@@ -540,22 +548,21 @@ function useDisconnect() {
 
 // src/hooks/useAccounts.ts
 function useAccounts() {
-  const { addresses, isConnected, walletId, error } = usePhantom();
+  const { addresses, isConnected, walletId } = usePhantom();
   return {
     addresses,
     isConnected,
-    walletId,
-    error
+    walletId
   };
 }
 
 // src/hooks/useSignMessage.ts
-import { useState as useState4, useCallback as useCallback4 } from "react";
+import { useState as useState3, useCallback as useCallback3 } from "react";
 function useSignMessage() {
   const { sdk } = usePhantom();
-  const [isSigning, setIsSigning] = useState4(false);
-  const [error, setError] = useState4(null);
-  const signMessage = useCallback4(
+  const [isSigning, setIsSigning] = useState3(false);
+  const [error, setError] = useState3(null);
+  const signMessage = useCallback3(
     async (params) => {
       if (!sdk) {
         throw new Error("SDK not initialized");
@@ -583,12 +590,12 @@ function useSignMessage() {
 }
 
 // src/hooks/useSignAndSendTransaction.ts
-import { useState as useState5, useCallback as useCallback5 } from "react";
+import { useState as useState4, useCallback as useCallback4 } from "react";
 function useSignAndSendTransaction() {
   const { sdk } = usePhantom();
-  const [isSigning, setIsSigning] = useState5(false);
-  const [error, setError] = useState5(null);
-  const signAndSendTransaction = useCallback5(
+  const [isSigning, setIsSigning] = useState4(false);
+  const [error, setError] = useState4(null);
+  const signAndSendTransaction = useCallback4(
     async (params) => {
       if (!sdk) {
         throw new Error("SDK not initialized");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phantom/react-native-sdk",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Phantom Wallet SDK for React Native and Expo applications",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -50,7 +50,7 @@
     "@phantom/client": "^0.1.8",
     "@phantom/constants": "^0.0.3",
     "@phantom/crypto": "^0.1.2",
-    "@phantom/embedded-provider-core": "^0.1.5",
+    "@phantom/embedded-provider-core": "^0.1.7",
     "@phantom/sdk-types": "^0.1.4",
     "@types/bs58": "^5.0.0",
     "bs58": "^6.0.0",