@phantom/browser-sdk 1.0.0-beta.9 → 1.0.0

package/README.md

@@ -15,11 +15,11 @@ import { BrowserSDK, AddressType } from "@phantom/browser-sdk";
 
 // Connect to Phantom browser extension
 const sdk = new BrowserSDK({
-  providerType: "injected",
+  providers: ["injected"], // Only allow browser extension
   addressTypes: [AddressType.solana, AddressType.ethereum],
 });
 
-const { addresses } = await sdk.connect();
+const { addresses } = await sdk.connect({ provider: "injected" });
 console.log("Connected addresses:", addresses);
 
 // Chain-specific operations
@@ -35,19 +35,19 @@ const solanaResult = await sdk.solana.signAndSendTransaction(mySolanaTransaction
 const ethResult = await sdk.ethereum.sendTransaction(myEthTransaction);
 ```
 
-### Embedded Provider
+### Embedded Provider (Multiple Auth Methods)
 
 ```typescript
 import { BrowserSDK, AddressType } from "@phantom/browser-sdk";
 
-// Create embedded non-custodial wallet
+// Create embedded non-custodial wallet with multiple auth providers
 const sdk = new BrowserSDK({
-  providerType: "embedded",
+  providers: ["google", "apple", "phantom"], // Allow Google, Apple, and Phantom Login
   addressTypes: [AddressType.solana, AddressType.ethereum],
   appId: "your-app-id", // Get your app ID from phantom.com/portal
 });
 
-const { addresses } = await sdk.connect();
+const { addresses } = await sdk.connect({ provider: "phantom" });
 console.log("Addresses:", addresses);
 
 // Use chain-specific APIs
@@ -72,14 +72,15 @@ After instantiating the SDK, use `sdk.connect()` to establish a connection to th
 ```typescript
 import { BrowserSDK, AddressType } from "@phantom/browser-sdk";
 
-// 1. Create SDK instance
+// 1. Create SDK instance with allowed providers
 const sdk = new BrowserSDK({
-  providerType: "injected",
+  providers: ["google", "apple", "phantom", "injected"], // Allowed auth providers
   addressTypes: [AddressType.solana, AddressType.ethereum],
+  appId: "your-app-id", // Required when using embedded providers
 });
 
-// 2. Connect to wallet
-const { addresses } = await sdk.connect();
+// 2. Connect to wallet (provider parameter must be in allowed providers list)
+const { addresses } = await sdk.connect({ provider: "google" });
 console.log("Connected addresses:", addresses);
 
 // 3. Use chain-specific methods
@@ -93,24 +94,38 @@ const ethResult = await sdk.ethereum.sendTransaction({
 
 ### Connection Options
 
-For embedded user-wallets, you can specify authentication providers:
+The `connect()` method requires a `provider` parameter and automatically switches between providers based on the authentication method you specify:
 
 ```typescript
-// Default: Show provider selection screen
-const result = await sdk.connect();
+// Connect with injected provider (Phantom extension)
+// Automatically switches to injected provider if not already using it
+const result = await sdk.connect({
+  provider: "injected",
+});
 
-// Google authentication (skips provider selection)
+// Connect with Google authentication (embedded provider)
+// Automatically switches to embedded provider if not already using it
 const result = await sdk.connect({
-  authOptions: {
-    provider: "google",
-  },
+  provider: "google",
 });
 
-// Apple authentication (skips provider selection)
+// Connect with Apple authentication (embedded provider)
+// Automatically switches to embedded provider if not already using it
 const result = await sdk.connect({
-  authOptions: {
-    provider: "apple",
-  },
+  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
+const result = await sdk.connect({
+  provider: "phantom",
+});
+
+// Connect with JWT authentication (embedded provider)
+const result = await sdk.connect({
+  provider: "jwt",
+  jwtToken: "your-jwt-token",
 });
 ```
 
@@ -168,39 +183,65 @@ const accounts = await sdk.ethereum.getAccounts();
 const isConnected = sdk.ethereum.isConnected();
 ```
 
-## Provider Types
+## Authentication Providers
+
+The SDK supports multiple authentication providers that you configure via the `providers` array:
 
-### Injected Provider
+### Available Providers
 
-Uses the Phantom browser extension installed by the user. No additional configuration needed.
+- **`"injected"`** - Phantom browser extension
+- **`"google"`** - Google OAuth
+- **`"apple"`** - Apple ID
+- **`"phantom"`** - Phantom Login
+- **`"deeplink"`** - Deeplink to Phantom mobile app (only renders on mobile devices)
+
+### Configuration Examples
+
+**Injected Provider Only (Browser Extension)**
 
 ```typescript
 const sdk = new BrowserSDK({
-  providerType: "injected",
+  providers: ["injected"], // Only allow browser extension
   addressTypes: [AddressType.solana, AddressType.ethereum],
 });
 ```
 
-### Embedded Provider
-
-Creates a non-custodial wallet embedded in your application. Requires API configuration.
+**Multiple Authentication Methods**
 
 ```typescript
 const sdk = new BrowserSDK({
-  providerType: "embedded",
+  providers: ["google", "apple", "phantom", "injected", "deeplink"], // Allow all methods
   addressTypes: [AddressType.solana, AddressType.ethereum],
-  appId: "your-app-id", // Get your app ID from phantom.com/portal
+  appId: "your-app-id", // Required for embedded providers (google, apple, phantom, deeplink)
   authOptions: {
-    authUrl: "https://connect.phantom.app/login", // optional, defaults to "https://connect.phantom.app/login"
+    authUrl: "https://connect.phantom.app/login", // optional
     redirectUrl: "https://yourapp.com/callback", // optional, defaults to current page
   },
-  autoConnect: true, // optional, auto-connect to existing session (default: true for embedded)
+  autoConnect: true, // optional, auto-connect to existing session (default: true when embedded providers are used)
+});
+```
+
+**Mobile Deeplink Support**
+
+The `"deeplink"` provider enables a button that opens the Phantom mobile app on mobile devices. This button only appears on mobile devices when the Phantom browser extension is not installed. When clicked, it redirects users to the Phantom mobile app to complete authentication.
+
+```typescript
+const sdk = new BrowserSDK({
+  providers: ["google", "apple", "phantom", "deeplink"], // Include deeplink for mobile support
+  addressTypes: [AddressType.solana, AddressType.ethereum],
+  appId: "your-app-id", // Required for deeplink
+  authOptions: {
+    authUrl: "https://connect.phantom.app/login",
+    redirectUrl: "https://yourapp.com/callback",
+  },
 });
 ```
 
 ### Embedded Wallet Type
 
-#### User Wallet (`'user-wallet'`)
+When using embedded providers (google, apple, phantom, etc.), you can specify the wallet type:
+
+#### User Wallet (`'user-wallet'`) - Default
 
 - **Uses Phantom authentication** - user logs in with existing Phantom account
 - **Potentially funded** - brings in user's existing wallet balance
@@ -209,9 +250,10 @@ const sdk = new BrowserSDK({
 
 ```typescript
 const sdk = new BrowserSDK({
-  providerType: "embedded",
+  providers: ["google", "apple", "phantom"],
   appId: "your-app-id",
   addressTypes: [AddressType.solana, AddressType.ethereum],
+  embeddedWalletType: "user-wallet", // default, can be omitted
 });
 ```
 
@@ -222,17 +264,16 @@ const sdk = new BrowserSDK({
 | `AddressType.solana`   | Solana Mainnet, Devnet, Testnet       |
 | `AddressType.ethereum` | Ethereum, Polygon, Arbitrum, and more |
 
-
 ### Auto-Connect Feature
 
 The SDK can automatically reconnect to existing sessions when instantiated, providing a seamless user experience.
 
 ```typescript
 const sdk = new BrowserSDK({
-  providerType: "embedded",
+  providers: ["google", "apple", "phantom"],
   appId: "your-app-id",
   addressTypes: [AddressType.solana],
-  autoConnect: true, // Default: true for embedded, false for injected
+  autoConnect: true, // Default: true when embedded providers are used, false for injected-only
 });
 
 // SDK will automatically check for existing valid session and connect in background
@@ -244,7 +285,7 @@ if (sdk.isConnected()) {
   const addresses = await sdk.getAddresses();
 } else {
   // First time or session expired, need to connect manually
-  await sdk.connect();
+  await sdk.connect({ provider: "google" });
 }
 ```
 
@@ -252,14 +293,14 @@ if (sdk.isConnected()) {
 
 ```typescript
 const sdk = new BrowserSDK({
-  providerType: "embedded",
+  providers: ["google", "apple", "phantom"],
   appId: "your-app-id",
   addressTypes: [AddressType.solana],
   autoConnect: false, // Disable auto-connect
 });
 
 // Now you must manually call connect() every time
-await sdk.connect();
+await sdk.connect({ provider: "google" });
 ```
 
 ## API Reference
@@ -274,26 +315,33 @@ new BrowserSDK(config: BrowserSDKConfig)
 
 ```typescript
 interface BrowserSDKConfig {
-  providerType: "injected" | "embedded";
+  // List of allowed authentication providers (REQUIRED)
+  providers: AuthProviderType[]; // e.g., ["google", "apple", "phantom", "injected", "deeplink"]
+
   addressTypes?: [AddressType, ...AddressType[]]; // Networks to enable (e.g., [AddressType.solana])
 
-  // Required for embedded provider only
-  appId?: string; // Your app ID from phantom.com/portal (required for embedded provider)
-  
+  // Required when using embedded providers (google, apple, phantom)
+  appId?: string; // Your app ID from phantom.com/portal
+
   // Optional configuration
   apiBaseUrl?: string; // Phantom API base URL (optional, has default)
   authOptions?: {
     authUrl?: string; // Custom auth URL (optional, defaults to "https://connect.phantom.app/login")
     redirectUrl?: string; // Custom redirect URL after authentication (optional)
   };
-  embeddedWalletType?: "user-wallet"; // Wallet type (optional, defaults to "user-wallet", currently the only supported type)
-  autoConnect?: boolean; // Enable auto-connect to existing sessions (optional, defaults to true for embedded)
+  embeddedWalletType?: "user-wallet"; // Wallet type (optional, defaults to "user-wallet")
+  autoConnect?: boolean; // Auto-connect to existing session (default: true when embedded providers used)
 }
+
+// Valid provider types
+type AuthProviderType = "google" | "apple" | "phantom" | "injected" | "deeplink";
 ```
 
 ### Extension Detection
 
-For injected provider usage, you can check if the Phantom extension is installed:
+#### waitForPhantomExtension
+
+Check if the Phantom extension is installed:
 
 ```typescript
 import { waitForPhantomExtension } from "@phantom/browser-sdk";
@@ -307,15 +355,47 @@ if (isAvailable) {
 }
 ```
 
+#### isPhantomLoginAvailable
+
+Check if Phantom Login is available (requires extension to be installed and support the `phantom_login` feature):
+
+```typescript
+import { isPhantomLoginAvailable } from "@phantom/browser-sdk";
+
+const isAvailable = await isPhantomLoginAvailable();
+
+if (isAvailable) {
+  console.log("Phantom Login is available!");
+  // Can use provider: "phantom" in connect()
+} else {
+  console.log("Phantom Login is not available");
+}
+```
+
 ### Core Methods
 
-#### connect()
+#### connect(options)
 
 Connect to wallet and get addresses for configured AddressTypes.
 
+**Parameters:**
+
+- `options: AuthOptions` (required) - Authentication options
+  - `provider: "google" | "apple" | "jwt" | "phantom" | "injected"` (required) - Authentication provider to use
+  - `jwtToken?: string` (optional) - JWT token (required when `provider` is "jwt")
+  - `customAuthData?: Record<string, any>` (optional) - Custom authentication data
+
 ```typescript
-const result = await sdk.connect();
-// Returns: { walletId?: string, addresses: WalletAddress[] }
+// Connect with injected provider
+const result = await sdk.connect({ provider: "injected" });
+
+// Connect with Phantom authentication
+const result = await sdk.connect({ provider: "phantom" });
+
+// Connect with Google authentication
+const result = await sdk.connect({ provider: "google" });
+
+// Returns: { addresses: WalletAddress[], status: "pending" | "completed", provider: "google" | "apple" | "injected" ...  }
 // addresses only includes types from addressTypes config
 ```
 
@@ -344,15 +424,6 @@ Check if SDK is connected to a wallet.
 const connected = sdk.isConnected();
 ```
 
-#### getWalletId()
-
-Get the wallet ID (embedded wallets only).
-
-```typescript
-const walletId = sdk.getWalletId();
-// Returns string for embedded wallets, null for injected
-```
-
 ### Solana Chain Methods
 
 #### signMessage(message)
@@ -506,7 +577,7 @@ const result = await sdk.ethereum.sendTransaction({
 
 #### switchChain(chainId)
 
-Switch to a different Ethereum chain.
+Switch to a different Ethereum chain. Accepts a chain ID as a number or a hex string value.
 
 ```typescript
 await sdk.ethereum.switchChain(1); // Ethereum mainnet
@@ -514,6 +585,21 @@ await sdk.ethereum.switchChain(137); // Polygon
 await sdk.ethereum.switchChain(42161); // Arbitrum One
 ```
 
+**Supported EVM Networks:**
+
+| Network          | Chain ID   | Usage                   |
+| ---------------- | ---------- | ----------------------- |
+| Ethereum Mainnet | `1`        | `switchChain(1)`        |
+| Ethereum Sepolia | `11155111` | `switchChain(11155111)` |
+| Polygon Mainnet  | `137`      | `switchChain(137)`      |
+| Polygon Amoy     | `80002`    | `switchChain(80002)`    |
+| Base Mainnet     | `8453`     | `switchChain(8453)`     |
+| Base Sepolia     | `84532`    | `switchChain(84532)`    |
+| Arbitrum One     | `42161`    | `switchChain(42161)`    |
+| Arbitrum Sepolia | `421614`   | `switchChain(421614)`   |
+| Monad Mainnet    | `143`      | `switchChain(143)`      |
+| Monad Testnet    | `10143`    | `switchChain(10143)`    |
+
 #### getChainId()
 
 Get the current chain ID.
@@ -549,6 +635,184 @@ Attempt auto-connection using existing session. Should be called after setting u
 await sdk.autoConnect();
 ```
 
+### Wallet Discovery Methods
+
+The SDK can discover multiple injected wallets using Wallet Standard for Solana and EIP-6963 for Ethereum. This allows users to choose from any installed wallet that supports the configured address types.
+
+#### discoverWallets()
+
+Asynchronously discover all available injected wallets that support the configured address types. This method uses Wallet Standard (`navigator.wallets.getWallets()`) for Solana wallets and EIP-6963 events for Ethereum wallets.
+
+**Returns:** `Promise<InjectedWalletInfo[]>` - Array of discovered wallet information
+
+```typescript
+// Discover wallets asynchronously
+const wallets = await sdk.discoverWallets();
+
+console.log("Discovered wallets:", wallets);
+// Example output:
+// [
+//   {
+//     id: "backpack",
+//     name: "Backpack",
+//     icon: "https://backpack.app/icon.png",
+//     addressTypes: [AddressType.solana],
+//     chains: ["solana:mainnet", "solana:devnet"]
+//   },
+//   {
+//     id: "metamask-io",
+//     name: "MetaMask",
+//     icon: "https://metamask.io/icon.png",
+//     addressTypes: [AddressType.ethereum],
+//     chains: ["eip155:1", "eip155:5", "eip155:11155111"]
+//   }
+// ]
+```
+
+**Behavior:**
+
+- Automatically filters wallets based on `config.addressTypes`
+- If `addressTypes` is undefined or empty, discovers all wallets regardless of chain support
+- Registers discovered wallets in the internal registry for later retrieval
+- Discovery typically takes ~400ms (EIP-6963 timeout)
+- Returns empty array on error (errors are logged but not thrown)
+
+**Note:** Discovery happens automatically when the SDK is instantiated. This method is useful for manually triggering discovery or refreshing the wallet list.
+
+#### getDiscoveredWallets()
+
+Get all currently discovered wallets from the internal registry. This is a synchronous method that returns wallets that have already been discovered.
+
+**Returns:** `InjectedWalletInfo[]` - Array of discovered wallet information
+
+```typescript
+// Get already discovered wallets (synchronous)
+const wallets = sdk.getDiscoveredWallets();
+
+console.log("Available wallets:", wallets);
+// Returns wallets that match the configured addressTypes
+// Also includes Phantom if available and matches addressTypes
+```
+
+**Behavior:**
+
+- Returns wallets from the internal registry that match `config.addressTypes`
+- Includes Phantom wallet if `window.phantom` is available and matches configured address types
+- Returns empty array if no wallets are discovered or if an error occurs
+- This is a synchronous read operation - it does not trigger new discovery
+
+**Wallet Information Structure:**
+
+```typescript
+interface InjectedWalletInfo {
+  id: string; // Unique wallet identifier (e.g., "backpack", "metamask-io")
+  name: string; // Human-readable wallet name (e.g., "Backpack", "MetaMask")
+  icon?: string; // Wallet icon URL (optional)
+  addressTypes: AddressType[]; // Supported address types (e.g., [AddressType.solana])
+  chains?: string[]; // Supported chains in CAIP-2 format (e.g., ["solana:mainnet"])
+}
+```
+
+### Event Handlers
+
+The SDK provides typed event handlers that allow you to listen for connection state changes. This is especially useful for `autoConnect()` flows where you need to track the connection result.
+
+#### Available Events
+
+```typescript
+import { BrowserSDK, AddressType } from "@phantom/browser-sdk";
+import type {
+  ConnectEventData,
+  ConnectStartEventData,
+  ConnectErrorEventData,
+  DisconnectEventData,
+} from "@phantom/browser-sdk";
+
+const sdk = new BrowserSDK({
+  providers: ["google", "apple", "phantom"],
+  appId: "your-app-id",
+  addressTypes: [AddressType.solana],
+});
+
+// 1. connect_start - Fired when connection starts
+sdk.on("connect_start", (data: ConnectStartEventData) => {
+  console.log("Connection starting:", data.source); // "auto-connect" | "manual-connect"
+  console.log("Auth options:", data.authOptions?.provider); // "google" | "apple" | etc.
+});
+
+// 2. connect - Fired when connection succeeds (includes full ConnectResult)
+sdk.on("connect", (data: ConnectEventData) => {
+  console.log("Connected successfully!");
+  console.log("Provider type:", data.provider); // "google" | "apple" | "injected" ...
+  console.log("Wallet ID:", data.walletId); // only for embedded providers
+  console.log("Addresses:", data.addresses); // WalletAddress[]
+  console.log("Status:", data.status); // "pending" | "completed"
+  console.log("Source:", data.source); // "auto-connect" | "manual-connect" | "manual-existing" | "existing-session" | "manual"
+});
+
+// 3. connect_error - Fired when connection fails
+sdk.on("connect_error", (data: ConnectErrorEventData) => {
+  console.error("Connection failed:", data.error);
+  console.log("Source:", data.source); // "auto-connect" | "manual-connect"
+});
+
+// 4. disconnect - Fired when disconnected
+sdk.on("disconnect", (data: DisconnectEventData) => {
+  console.log("Disconnected from wallet");
+  console.log("Source:", data.source); // "manual"
+});
+
+// 5. error - General error handler
+sdk.on("error", (error: unknown) => {
+  console.error("SDK error:", error);
+});
+
+// Don't forget to remove listeners when done
+sdk.off("connect", handleConnect);
+```
+
+#### Event Types
+
+| Event           | Payload Type            | When Fired            | Key Data                                            |
+| --------------- | ----------------------- | --------------------- | --------------------------------------------------- |
+| `connect_start` | `ConnectStartEventData` | Connection initiated  | `source`, `authOptions`                             |
+| `connect`       | `ConnectEventData`      | Connection successful | `provider`, `addresses`, `status`, `source`, `user` |
+| `connect_error` | `ConnectErrorEventData` | Connection failed     | `error`, `source`                                   |
+| `disconnect`    | `DisconnectEventData`   | Disconnected          | `source`                                            |
+| `error`         | `unknown`               | General SDK errors    | Error details                                       |
+
+#### Using Events with autoConnect()
+
+Event handlers are especially useful with `autoConnect()` since it doesn't return a value:
+
+```typescript
+const sdk = new BrowserSDK({
+  providers: ["google", "apple", "phantom"],
+  appId: "your-app-id",
+  addressTypes: [AddressType.solana],
+  autoConnect: true,
+});
+
+// Set up event listeners BEFORE autoConnect
+sdk.on("connect", (data: ConnectEventData) => {
+  console.log("Auto-connected successfully!");
+  console.log("Provider type:", data.provider);
+  console.log("Addresses:", data.addresses);
+
+  // Update your UI state here
+  updateUIWithAddresses(data.addresses);
+});
+
+sdk.on("connect_error", (data: ConnectErrorEventData) => {
+  console.log("Auto-connect failed:", data.error);
+  // Show connect button to user
+  showConnectButton();
+});
+
+// Auto-connect will trigger events
+await sdk.autoConnect();
+```
+
 ### Auto-Confirm Methods (Injected Provider Only)
 
 The SDK provides auto-confirm functionality that allows automatic transaction confirmation for specified chains. This feature is only available when using the injected provider (Phantom browser extension).
@@ -606,33 +870,15 @@ console.log("Supported chains:", supportedChains.chains);
 
 #### Available NetworkId Values
 
+For a complete list of supported networks including Solana, Ethereum, Polygon, Base, Arbitrum, Monad, and more, see the [Network Support section in the main README](../../README.md#network-support).
+
 ```typescript
 import { NetworkId } from "@phantom/browser-sdk";
 
-// Solana networks
-NetworkId.SOLANA_MAINNET; // "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
-NetworkId.SOLANA_DEVNET; // "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1"
-NetworkId.SOLANA_TESTNET; // "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z"
-
-// Ethereum networks
-NetworkId.ETHEREUM_MAINNET; // "eip155:1"
-NetworkId.ETHEREUM_SEPOLIA; // "eip155:11155111"
-
-// Polygon networks
-NetworkId.POLYGON_MAINNET; // "eip155:137"
-NetworkId.POLYGON_AMOY; // "eip155:80002"
-
-// Arbitrum networks
-NetworkId.ARBITRUM_ONE; // "eip155:42161"
-NetworkId.ARBITRUM_SEPOLIA; // "eip155:421614"
-
-// Optimism networks
-NetworkId.OPTIMISM_MAINNET; // "eip155:10"
-NetworkId.OPTIMISM_GOERLI; // "eip155:420"
-
-// Base networks
-NetworkId.BASE_MAINNET; // "eip155:8453"
-NetworkId.BASE_SEPOLIA; // "eip155:84532"
+// Example: Use NetworkId for auto-confirm
+await sdk.enableAutoConfirm({
+  chains: [NetworkId.SOLANA_MAINNET, NetworkId.ETHEREUM_MAINNET],
+});
 ```
 
 **Important Notes:**
@@ -703,11 +949,12 @@ interface DebugMessage {
 ### Example: Debug Console Implementation
 
 ```typescript
-import { BrowserSDK, DebugLevel } from "@phantom/browser-sdk";
+import { BrowserSDK, DebugLevel, AddressType } from "@phantom/browser-sdk";
 
 const sdk = new BrowserSDK({
-  providerType: "embedded",
+  providers: ["google", "apple", "phantom"],
   appId: "your-app-id",
+  addressTypes: [AddressType.solana],
 });
 
 // Store debug messages
@@ -772,11 +1019,11 @@ import {
 import { BrowserSDK, AddressType } from "@phantom/browser-sdk";
 
 const sdk = new BrowserSDK({
-  providerType: "injected",
+  providers: ["injected"],
   addressTypes: [AddressType.solana],
 });
 
-await sdk.connect();
+await sdk.connect({ provider: "injected" });
 
 // Get recent blockhash
 const connection = new Connection("https://api.mainnet-beta.solana.com");
@@ -825,11 +1072,11 @@ import {
 import { BrowserSDK, AddressType } from "@phantom/browser-sdk";
 
 const sdk = new BrowserSDK({
-  providerType: "injected",
+  providers: ["injected"],
   addressTypes: [AddressType.solana],
 });
 
-await sdk.connect();
+await sdk.connect({ provider: "injected" });
 
 // Create transaction with @solana/kit
 const rpc = createSolanaRpc("https://api.mainnet-beta.solana.com");
@@ -855,11 +1102,11 @@ console.log("Transaction signature:", result.hash);
 import { BrowserSDK, AddressType } from "@phantom/browser-sdk";
 
 const sdk = new BrowserSDK({
-  providerType: "injected",
+  providers: ["injected"],
   addressTypes: [AddressType.ethereum],
 });
 
-await sdk.connect();
+await sdk.connect({ provider: "injected" });
 
 // Simple ETH transfer
 const result = await sdk.ethereum.sendTransaction({
@@ -889,9 +1136,9 @@ import { parseEther, parseGwei, encodeFunctionData } from "viem";
 import { BrowserSDK, AddressType } from "@phantom/browser-sdk";
 
 const sdk = new BrowserSDK({
-  providerType: "embedded",
+  providers: ["google", "apple", "phantom"],
+  appId: "your-app-id",
   addressTypes: [AddressType.ethereum],
-  // ... config
 });
 
 // Simple transfer with viem utilities