@phantom/react-sdk 1.0.0-beta.14 → 1.0.0-beta.16

package/README.md

@@ -136,26 +136,39 @@ function WalletExample() {
 
 ### Connection Options
 
-For embedded user-wallets, you can specify authentication providers:
+The `connect()` method automatically switches between providers based on the authentication method you specify:
 
 ```tsx
 const { connect } = useConnect();
 
-// Default: Show provider selection screen
+// Connect with current provider (no switching)
 await connect();
 
-// Google authentication (skips provider selection)
+// Connect with injected provider (Phantom extension)
+// Automatically switches to injected provider if not already using it
 await connect({
-  authOptions: {
-    provider: "google",
-  },
+  provider: "injected",
 });
 
-// Apple authentication (skips provider selection)
+// Connect with Google authentication (embedded provider)
+// Automatically switches to embedded provider if not already using it
 await connect({
-  authOptions: {
-    provider: "apple",
-  },
+  provider: "google",
+});
+
+// Connect with Apple authentication (embedded provider)
+// Automatically switches to embedded provider if not already using it
+await connect({
+  provider: "apple",
+});
+
+
+
+// Connect with Phantom authentication (embedded provider)
+// Uses Phantom extension or mobile app for authentication
+// Automatically switches to embedded provider if not already using it
+await connect({
+  provider: "phantom",
 });
 ```
 
@@ -305,6 +318,33 @@ function ExtensionStatus() {
 }
 ```
 
+#### useIsPhantomLoginAvailable
+
+Check if Phantom Login is available (requires extension installed and `phantom_login` feature support):
+
+```tsx
+import { useIsPhantomLoginAvailable } from "@phantom/react-sdk";
+
+function PhantomLoginButton() {
+  const { isLoading, isAvailable } = useIsPhantomLoginAvailable();
+  const { connect } = useConnect();
+
+  if (isLoading) {
+    return <div>Checking Phantom Login availability...</div>;
+  }
+
+  if (!isAvailable) {
+    return null; // Don't show button if Phantom Login is not available
+  }
+
+  return (
+    <button onClick={() => connect({ provider: "phantom" })}>
+      Login with Phantom
+    </button>
+  );
+}
+```
+
 ### Chain-Specific Hooks
 
 #### useSolana
@@ -733,16 +773,17 @@ function EthereumExample() {
 
 Quick reference of all available hooks:
 
-| Hook                      | Purpose                                 | Returns                                             |
-| ------------------------- | --------------------------------------- | --------------------------------------------------- |
-| `useConnect`              | Connect to wallet                       | `{ connect, isConnecting, error }`                  |
-| `useAccounts`             | Get wallet addresses                    | `WalletAddress[]` or `null`                         |
-| `useIsExtensionInstalled` | Check extension status                  | `{ isLoading, isInstalled }`                        |
-| `useDisconnect`           | Disconnect from wallet                  | `{ disconnect, isDisconnecting }`                   |
-| `useAutoConfirm`          | Auto-confirm management (injected only) | `{ enable, disable, status, supportedChains, ... }` |
-| `useSolana`               | Solana chain operations                 | `{ signMessage, signAndSendTransaction, ... }`      |
-| `useEthereum`             | Ethereum chain operations               | `{ signPersonalMessage, sendTransaction, ... }`     |
-| `usePhantom`              | Get provider context                    | `{ isConnected, isReady }`                          |
+| Hook                          | Purpose                                 | Returns                                             |
+| ----------------------------- | --------------------------------------- | --------------------------------------------------- |
+| `useConnect`                  | Connect to wallet                       | `{ connect, isConnecting, error }`                  |
+| `useAccounts`                 | Get wallet addresses                    | `WalletAddress[]` or `null`                         |
+| `useIsExtensionInstalled`     | Check extension status                  | `{ isLoading, isInstalled }`                        |
+| `useIsPhantomLoginAvailable`  | Check Phantom Login availability        | `{ isLoading, isAvailable }`                        |
+| `useDisconnect`               | Disconnect from wallet                  | `{ disconnect, isDisconnecting }`                   |
+| `useAutoConfirm`              | Auto-confirm management (injected only) | `{ enable, disable, status, supportedChains, ... }` |
+| `useSolana`                   | Solana chain operations                 | `{ signMessage, signAndSendTransaction, ... }`      |
+| `useEthereum`                 | Ethereum chain operations               | `{ signPersonalMessage, sendTransaction, ... }`     |
+| `usePhantom`                  | Get provider context                    | `{ isConnected, isReady }`                          |
 
 ## Configuration Reference
 

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { BrowserSDKConfig, DebugConfig, AuthOptions, BrowserSDK, WalletAddress, AutoConfirmEnableParams, AutoConfirmResult, AutoConfirmSupportedChainsResult } from '@phantom/browser-sdk';
-export { AddressType, AutoConfirmEnableParams, AutoConfirmResult, AutoConfirmSupportedChainsResult, DebugLevel, DebugMessage, NetworkId, SignedTransaction, WalletAddress, debug } from '@phantom/browser-sdk';
+import { BrowserSDKConfig, DebugConfig, AuthOptions, BrowserSDK, WalletAddress, ConnectResult, AutoConfirmEnableParams, AutoConfirmResult, AutoConfirmSupportedChainsResult } from '@phantom/browser-sdk';
+export { AddressType, AutoConfirmEnableParams, AutoConfirmResult, AutoConfirmSupportedChainsResult, ConnectErrorEventData, ConnectEventData, ConnectStartEventData, DebugLevel, DebugMessage, DisconnectEventData, EmbeddedProviderEvent, EmbeddedProviderEventMap, EventCallback, NetworkId, SignedTransaction, WalletAddress, debug } from '@phantom/browser-sdk';
 import * as _phantom_embedded_provider_core from '@phantom/embedded-provider-core';
 import { ISolanaChain, IEthereumChain } from '@phantom/chain-interfaces';
 export { EthTransactionRequest, IEthereumChain, ISolanaChain } from '@phantom/chain-interfaces';
@@ -23,6 +23,7 @@ interface PhantomContextValue {
     currentProviderType: "injected" | "embedded" | null;
     isPhantomAvailable: boolean;
     isClient: boolean;
+    user: ConnectResult | null;
 }
 interface PhantomProviderProps {
     children: ReactNode;
@@ -57,6 +58,15 @@ declare function useIsExtensionInstalled(): {
     isInstalled: boolean;
 };
 
+/**
+ * React hook to check if Phantom Login is available
+ * Checks if extension is installed and supports phantom_login feature
+ */
+declare function useIsPhantomLoginAvailable(): {
+    isLoading: boolean;
+    isAvailable: boolean;
+};
+
 interface UseAutoConfirmResult {
     enable: (params: AutoConfirmEnableParams) => Promise<AutoConfirmResult>;
     disable: () => Promise<void>;
@@ -90,4 +100,4 @@ declare function useEthereum(): {
 
 type ProviderType = "injected" | "embedded";
 
-export { ConnectOptions, PhantomDebugConfig, PhantomProvider, PhantomProviderProps, PhantomSDKConfig, ProviderType, useAccounts, useAutoConfirm, useConnect, useDisconnect, useEthereum, useIsExtensionInstalled, usePhantom, useSolana };
+export { ConnectOptions, PhantomDebugConfig, PhantomProvider, PhantomProviderProps, PhantomSDKConfig, ProviderType, useAccounts, useAutoConfirm, useConnect, useDisconnect, useEthereum, useIsExtensionInstalled, useIsPhantomLoginAvailable, usePhantom, useSolana };

package/dist/index.js

@@ -30,17 +30,18 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
-  AddressType: () => import_browser_sdk3.AddressType,
-  DebugLevel: () => import_browser_sdk3.DebugLevel,
-  NetworkId: () => import_browser_sdk3.NetworkId,
+  AddressType: () => import_browser_sdk4.AddressType,
+  DebugLevel: () => import_browser_sdk4.DebugLevel,
+  NetworkId: () => import_browser_sdk4.NetworkId,
   PhantomProvider: () => PhantomProvider,
-  debug: () => import_browser_sdk3.debug,
+  debug: () => import_browser_sdk4.debug,
   useAccounts: () => useAccounts,
   useAutoConfirm: () => useAutoConfirm,
   useConnect: () => useConnect,
   useDisconnect: () => useDisconnect,
   useEthereum: () => useEthereum,
   useIsExtensionInstalled: () => useIsExtensionInstalled,
+  useIsPhantomLoginAvailable: () => useIsPhantomLoginAvailable,
   usePhantom: () => usePhantom,
   useSolana: () => useSolana
 });
@@ -63,6 +64,7 @@ function PhantomProvider({ children, config, debugConfig }) {
     memoizedConfig.providerType || null
   );
   const [isPhantomAvailable, setIsPhantomAvailable] = (0, import_react.useState)(false);
+  const [user, setUser] = (0, import_react.useState)(null);
   (0, import_react.useEffect)(() => {
     setIsClient(true);
   }, []);
@@ -79,12 +81,12 @@ function PhantomProvider({ children, config, debugConfig }) {
       setIsConnecting(true);
       setConnectError(null);
     };
-    const handleConnect = async () => {
+    const handleConnect = async (data) => {
       try {
         setIsConnected(true);
         setIsConnecting(false);
-        const providerInfo = sdk.getCurrentProviderInfo();
-        setCurrentProviderType(providerInfo?.type || null);
+        setUser(data);
+        setCurrentProviderType(data.providerType || null);
         const addrs = await sdk.getAddresses();
         setAddresses(addrs);
       } catch (err) {
@@ -100,12 +102,14 @@ function PhantomProvider({ children, config, debugConfig }) {
       setIsConnecting(false);
       setIsConnected(false);
       setConnectError(new Error(errorData.error || "Connection failed"));
+      setAddresses([]);
     };
     const handleDisconnect = () => {
       setIsConnected(false);
       setIsConnecting(false);
       setConnectError(null);
       setAddresses([]);
+      setUser(null);
     };
     sdk.on("connect_start", handleConnectStart);
     sdk.on("connect", handleConnect);
@@ -150,9 +154,10 @@ function PhantomProvider({ children, config, debugConfig }) {
       addresses,
       currentProviderType,
       isPhantomAvailable,
-      isClient
+      isClient,
+      user
     }),
-    [sdk, isConnected, isConnecting, connectError, addresses, currentProviderType, isPhantomAvailable, isClient]
+    [sdk, isConnected, isConnecting, connectError, addresses, currentProviderType, isPhantomAvailable, isClient, user]
   );
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(PhantomContext.Provider, { value, children });
 }
@@ -259,6 +264,39 @@ function useIsExtensionInstalled() {
   return { isLoading, isInstalled };
 }
 
+// src/hooks/useIsPhantomLoginAvailable.ts
+var React2 = __toESM(require("react"));
+var import_browser_sdk3 = require("@phantom/browser-sdk");
+function useIsPhantomLoginAvailable() {
+  const [isLoading, setIsLoading] = React2.useState(true);
+  const [isAvailable, setIsAvailable] = React2.useState(false);
+  React2.useEffect(() => {
+    let isMounted = true;
+    const checkPhantomLogin = async () => {
+      try {
+        setIsLoading(true);
+        const result = await (0, import_browser_sdk3.isPhantomLoginAvailable)(3e3);
+        if (isMounted) {
+          setIsAvailable(result);
+        }
+      } catch (error) {
+        if (isMounted) {
+          setIsAvailable(false);
+        }
+      } finally {
+        if (isMounted) {
+          setIsLoading(false);
+        }
+      }
+    };
+    checkPhantomLogin();
+    return () => {
+      isMounted = false;
+    };
+  }, []);
+  return { isLoading, isAvailable };
+}
+
 // src/hooks/useAutoConfirm.ts
 var import_react4 = require("react");
 function useAutoConfirm() {
@@ -390,4 +428,4 @@ function useEthereum() {
 }
 
 // src/index.ts
-var import_browser_sdk3 = require("@phantom/browser-sdk");
+var import_browser_sdk4 = require("@phantom/browser-sdk");

package/dist/index.mjs

@@ -15,6 +15,7 @@ function PhantomProvider({ children, config, debugConfig }) {
     memoizedConfig.providerType || null
   );
   const [isPhantomAvailable, setIsPhantomAvailable] = useState(false);
+  const [user, setUser] = useState(null);
   useEffect(() => {
     setIsClient(true);
   }, []);
@@ -31,12 +32,12 @@ function PhantomProvider({ children, config, debugConfig }) {
       setIsConnecting(true);
       setConnectError(null);
     };
-    const handleConnect = async () => {
+    const handleConnect = async (data) => {
       try {
         setIsConnected(true);
         setIsConnecting(false);
-        const providerInfo = sdk.getCurrentProviderInfo();
-        setCurrentProviderType(providerInfo?.type || null);
+        setUser(data);
+        setCurrentProviderType(data.providerType || null);
         const addrs = await sdk.getAddresses();
         setAddresses(addrs);
       } catch (err) {
@@ -52,12 +53,14 @@ function PhantomProvider({ children, config, debugConfig }) {
       setIsConnecting(false);
       setIsConnected(false);
       setConnectError(new Error(errorData.error || "Connection failed"));
+      setAddresses([]);
     };
     const handleDisconnect = () => {
       setIsConnected(false);
       setIsConnecting(false);
       setConnectError(null);
       setAddresses([]);
+      setUser(null);
     };
     sdk.on("connect_start", handleConnectStart);
     sdk.on("connect", handleConnect);
@@ -102,9 +105,10 @@ function PhantomProvider({ children, config, debugConfig }) {
       addresses,
       currentProviderType,
       isPhantomAvailable,
-      isClient
+      isClient,
+      user
     }),
-    [sdk, isConnected, isConnecting, connectError, addresses, currentProviderType, isPhantomAvailable, isClient]
+    [sdk, isConnected, isConnecting, connectError, addresses, currentProviderType, isPhantomAvailable, isClient, user]
   );
   return /* @__PURE__ */ jsx(PhantomContext.Provider, { value, children });
 }
@@ -211,14 +215,47 @@ function useIsExtensionInstalled() {
   return { isLoading, isInstalled };
 }
 
+// src/hooks/useIsPhantomLoginAvailable.ts
+import * as React2 from "react";
+import { isPhantomLoginAvailable } from "@phantom/browser-sdk";
+function useIsPhantomLoginAvailable() {
+  const [isLoading, setIsLoading] = React2.useState(true);
+  const [isAvailable, setIsAvailable] = React2.useState(false);
+  React2.useEffect(() => {
+    let isMounted = true;
+    const checkPhantomLogin = async () => {
+      try {
+        setIsLoading(true);
+        const result = await isPhantomLoginAvailable(3e3);
+        if (isMounted) {
+          setIsAvailable(result);
+        }
+      } catch (error) {
+        if (isMounted) {
+          setIsAvailable(false);
+        }
+      } finally {
+        if (isMounted) {
+          setIsLoading(false);
+        }
+      }
+    };
+    checkPhantomLogin();
+    return () => {
+      isMounted = false;
+    };
+  }, []);
+  return { isLoading, isAvailable };
+}
+
 // src/hooks/useAutoConfirm.ts
-import { useCallback as useCallback3, useState as useState4, useEffect as useEffect3 } from "react";
+import { useCallback as useCallback3, useState as useState5, useEffect as useEffect4 } from "react";
 function useAutoConfirm() {
   const { sdk, currentProviderType } = usePhantom();
-  const [status, setStatus] = useState4(null);
-  const [supportedChains, setSupportedChains] = useState4(null);
-  const [isLoading, setIsLoading] = useState4(false);
-  const [error, setError] = useState4(null);
+  const [status, setStatus] = useState5(null);
+  const [supportedChains, setSupportedChains] = useState5(null);
+  const [isLoading, setIsLoading] = useState5(false);
+  const [error, setError] = useState5(null);
   const isInjected = currentProviderType === "injected";
   const enable = useCallback3(
     async (params) => {
@@ -285,7 +322,7 @@ function useAutoConfirm() {
       setIsLoading(false);
     }
   }, [sdk, isInjected]);
-  useEffect3(() => {
+  useEffect4(() => {
     if (sdk && isInjected) {
       refetch();
     } else {
@@ -355,6 +392,7 @@ export {
   useDisconnect,
   useEthereum,
   useIsExtensionInstalled,
+  useIsPhantomLoginAvailable,
   usePhantom,
   useSolana
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phantom/react-sdk",
-  "version": "1.0.0-beta.14",
+  "version": "1.0.0-beta.16",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -26,7 +26,7 @@
     "prettier": "prettier --write \"src/**/*.{ts,tsx}\""
   },
   "dependencies": {
-    "@phantom/browser-sdk": "^1.0.0-beta.14",
+    "@phantom/browser-sdk": "^1.0.0-beta.16",
     "@phantom/chain-interfaces": "^1.0.0-beta.7",
     "@phantom/constants": "^1.0.0-beta.7"
   },