@phantom/browser-sdk 1.0.0-beta.13 → 1.0.0-beta.15

package/README.md

@@ -93,24 +93,36 @@ const ethResult = await sdk.ethereum.sendTransaction({
 
 ### 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:
 
 ```typescript
-// Default: Show provider selection screen
+// Connect with current provider (no switching)
 const result = await sdk.connect();
 
-// Google authentication (skips provider selection)
+// Connect with injected provider (Phantom extension)
+// Automatically switches to injected provider if not already using it
 const result = await sdk.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
 const result = await sdk.connect({
-  authOptions: {
-    provider: "apple",
-  },
+  provider: "google",
+});
+
+// Connect with Apple authentication (embedded provider)
+// Automatically switches to embedded provider if not already using it
+const result = await sdk.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
+const result = await sdk.connect({
+  provider: "phantom",
 });
 ```
 
@@ -315,7 +327,7 @@ Connect to wallet and get addresses for configured AddressTypes.
 
 ```typescript
 const result = await sdk.connect();
-// Returns: { walletId?: string, addresses: WalletAddress[] }
+// Returns: { addresses: WalletAddress[] }
 // addresses only includes types from addressTypes config
 ```
 
@@ -344,15 +356,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)

package/dist/index.d.ts

@@ -52,14 +52,33 @@ declare const DebugCategory: {
     readonly SESSION: "Session";
 };
 
+/**
+ * Phantom extension app.login API types
+ */
+interface PhantomAppLoginOptions {
+    publicKey: string;
+    appId: string;
+    sessionId: string;
+}
+interface PhantomAppLoginResult {
+    walletId: string;
+    organizationId: string;
+    accountDerivationIndex?: number;
+    expiresInMs?: number;
+}
+interface PhantomApp {
+    login(options: PhantomAppLoginOptions): Promise<PhantomAppLoginResult>;
+}
 declare global {
     interface Window {
         phantom?: {
             solana?: unknown;
             ethereum?: unknown;
-        };
+            app?: PhantomApp;
+        } | undefined;
     }
 }
+
 interface InjectedProviderConfig {
     addressTypes: AddressType[];
 }
@@ -105,9 +124,6 @@ interface ProviderPreference {
     type: "injected" | "embedded";
     embeddedWalletType?: "app-wallet" | "user-wallet";
 }
-interface SwitchProviderOptions {
-    embeddedWalletType?: "app-wallet" | "user-wallet" | (string & Record<never, never>);
-}
 
 /**
  * Browser SDK with chain-specific API
@@ -141,10 +157,6 @@ declare class BrowserSDK {
      * Disconnect from the wallet
      */
     disconnect(): Promise<void>;
-    /**
-     * Switch between provider types (injected vs embedded)
-     */
-    switchProvider(type: "injected" | "embedded", options?: SwitchProviderOptions): Promise<void>;
     /**
      * Check if the SDK is connected to a wallet
      */
@@ -157,10 +169,6 @@ declare class BrowserSDK {
      * Get information about the current provider
      */
     getCurrentProviderInfo(): ProviderPreference | null;
-    /**
-     * Get the wallet ID (for embedded wallets)
-     */
-    getWalletId(): string | null;
     /**
      * Check if Phantom extension is installed
      */
@@ -178,7 +186,7 @@ declare class BrowserSDK {
     /**
      * Attempt auto-connection using existing session
      * Should be called after setting up event listeners
-     * Only works with embedded providers
+     * Tries embedded provider first, then injected provider as fallback
      */
     autoConnect(): Promise<void>;
     /**